@libs-ui/utils 0.2.355-9 → 0.2.356-0

package/fesm2022/libs-ui-utils.mjs

@@ -157,6 +157,26 @@ const isReturnAsIsObject = (obj) => {
 const isSafeToProcess = (obj) => {
     return !isDangerousObject(obj);
 };
+/**
+ * Kiểm tra xem giá trị có phải là kiểu dữ liệu nguyên thủy (Primitive) không.
+ * Bao gồm: string, number, boolean, symbol, bigint, null, undefined.
+ * @param value Giá trị cần kiểm tra
+ * @returns true nếu là kiểu nguyên thủy
+ */
+const isPrimitiveType = (value) => {
+    return value === null || value === undefined || ['string', 'number', 'boolean', 'symbol', 'bigint'].includes(typeof value);
+};
+
+const ERROR_MESSAGE_EMPTY_VALID = 'i18n_valid_empty_message';
+const ERROR_MESSAGE_PATTEN_VALID = 'i18n_valid_pattern_message';
+const ERROR_MESSAGE_MIN_VALID = 'i18n_message_error_input_min_value';
+const ERROR_MESSAGE_MAX_VALID = 'i18n_message_error_input_max_value';
+const ERROR_MESSAGE_MIN_LENGTH = 'i18n_message_error_input_min_length';
+const ERROR_MESSAGE_MAX_LENGTH = 'i18n_message_error_input_max_length';
+const CHARACTER_DATA_EMPTY = '__';
+const DEFAULT_START_PAGE_0 = 'defaultStartPage0';
+const COMMUNICATE_MICRO_PREFIX_TYPE = '3RD_INTEGRATE_MICRO_SITE_';
+const COMMUNICATE_MICRO_KEY_GET_ALL_MESSAGE = 'MICRO_SITES_ALL_MESSAGE';
 
 let key$1 = '12~@#loqwsxacva(3rdhaq12';
 /**
@@ -172,6 +192,12 @@ const setKeyCrypto = (value) => {
 const keyStore$1 = () => {
     return key$1;
 };
+/**
+ * Mã hóa dữ liệu dạng chuỗi bằng thuật toán AES-CBC.
+ * Yêu cầu key mã hóa đã được thiết lập qua setKeyCrypto.
+ * @param plainData Chuỗi văn bản thuần túy cần mã hóa
+ * @returns Chuỗi kết quả đã được mã hóa (Base64 string)
+ */
 const encrypt = (plainData) => {
     if (!keyStore$1()) {
         throw Error('lỗi chưa setup key mã hóa');
@@ -183,6 +209,12 @@ const encrypt = (plainData) => {
     const options = { iv: iv, mode: mode, padding: padding };
     return CryptoES.AES.encrypt(plainData, key, options).toString();
 };
+/**
+ * Giải mã dữ liệu đã được mã hóa bằng AES-CBC.
+ * Yêu cầu cùng một key mã hóa đã dùng để encrypt.
+ * @param encryptedData Chuỗi dữ liệu đã mã hóa
+ * @returns Chuỗi văn bản thuần túy sau khi giải mã (UTF-8)
+ */
 const decrypt = (encryptedData) => {
     if (!keyStore$1()) {
         throw Error('lỗi chưa setup key mã hóa');
@@ -194,6 +226,11 @@ const decrypt = (encryptedData) => {
     const options = { iv: iv, mode: mode, padding: padding };
     return CryptoES.AES.decrypt(encryptedData, key, options).toString(CryptoES.enc.Utf8);
 };
+/**
+ * Tạo mã hash MD5 từ chuỗi văn bản.
+ * @param plainData Chuỗi văn bản cần hash
+ * @returns Chuỗi mã hash MD5 (32 ký tự hex)
+ */
 const md5 = (plainData) => {
     return CryptoES.MD5(plainData).toString();
 };
@@ -212,6 +249,12 @@ const setKeyCrypto3rd = (value) => {
 const keyStore = () => {
     return key;
 };
+/**
+ * Mã hóa dữ liệu dạng chuỗi bằng thuật toán AES-CBC.
+ * Yêu cầu key mã hóa đã được thiết lập qua setKeyCrypto3rd.
+ * @param plainData Chuỗi văn bản thuần túy cần mã hóa
+ * @returns Chuỗi kết quả đã được mã hóa (Base64 string)
+ */
 const encrypt3rd = (plainData) => {
     if (!keyStore()) {
         throw Error('lỗi chưa setup key mã hóa');
@@ -223,6 +266,12 @@ const encrypt3rd = (plainData) => {
     const options = { iv: iv, mode: mode, padding: padding };
     return CryptoES.AES.encrypt(plainData, key, options).toString();
 };
+/**
+ * Giải mã dữ liệu đã được mã hóa bằng AES-CBC.
+ * Yêu cầu cùng một key mã hóa đã dùng để encrypt.
+ * @param encryptedData Chuỗi dữ liệu đã mã hóa
+ * @returns Chuỗi văn bản thuần túy sau khi giải mã (UTF-8)
+ */
 const decrypt3rd = (encryptedData) => {
     if (!keyStore()) {
         throw Error('lỗi chưa setup key mã hóa');
@@ -236,36 +285,66 @@ const decrypt3rd = (encryptedData) => {
 };
 
 //NOTE: Do là function truyền từ bên ngoài vào nên sẽ không có unit test
+/**
+ * Hàm kiểm tra mặc định — phát hiện ứng dụng đang chạy trong iframe/embed frame
+ * bằng cách so sánh `window.parent` với `window.top`.
+ * Có thể bị ghi đè bởi `updateFunctionCheckEmbedFrame` cho môi trường tùy chỉnh.
+ */
 let functionCheck = () => {
     return window.parent !== window.top;
 };
+/**
+ * Ghi đè hàm kiểm tra embed frame bằng một hàm logic tùy chỉnh.
+ * Hữu ích trong môi trường Micro-frontend hoặc khi cần mock cho testing.
+ *
+ * @param functionCustom Hàm trả về `true` nếu app đang chạy trong iframe/embed frame
+ * @example
+ * // Micro-frontend: luôn coi là embed
+ * updateFunctionCheckEmbedFrame(() => true);
+ *
+ * // Testing: luôn coi là không embed
+ * updateFunctionCheckEmbedFrame(() => false);
+ */
 const updateFunctionCheckEmbedFrame = (functionCustom) => {
     functionCheck = functionCustom;
 };
+/**
+ * Kiểm tra ứng dụng hiện tại có đang được nhúng trong iframe/embed frame hay không.
+ * Sử dụng hàm logic đang được đăng ký (mặc định hoặc custom).
+ *
+ * @returns `true` nếu app đang chạy trong iframe/embed, `false` nếu đang chạy standalone
+ * @example
+ * if (isEmbedFrame()) {
+ *   // Ẩn header, sidebar vì đã có container bên ngoài quản lý
+ * }
+ */
 const isEmbedFrame = () => {
     return functionCheck();
 };
 
-const ERROR_MESSAGE_EMPTY_VALID = 'i18n_valid_empty_message';
-const ERROR_MESSAGE_PATTEN_VALID = 'i18n_valid_pattern_message';
-const ERROR_MESSAGE_MIN_VALID = 'i18n_message_error_input_min_value';
-const ERROR_MESSAGE_MAX_VALID = 'i18n_message_error_input_max_value';
-const ERROR_MESSAGE_MIN_LENGTH = 'i18n_message_error_input_min_length';
-const ERROR_MESSAGE_MAX_LENGTH = 'i18n_message_error_input_max_length';
-const CHARACTER_DATA_EMPTY = '__';
-const DEFAULT_START_PAGE_0 = 'defaultStartPage0';
-const COMMUNICATE_MICRO_PREFIX_TYPE = '3RD_INTEGRATE_MICRO_SITE_';
-const COMMUNICATE_MICRO_KEY_GET_ALL_MESSAGE = 'MICRO_SITES_ALL_MESSAGE';
-
-/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Cấu hình các key global cho truyền thông micro
+ */
 class UtilsCommunicateMicroKeyGlobal {
+    /** Key sự kiện cho modal */
     static KEY_MESSAGE_MODAL = 'LIBS_UI_MODEL_EVENT';
+    /** Bỏ qua cập nhật thời gian live event modal */
     static IGNORE_INTERVAL_UPDATE_TIME_LIVE_EVENT_MODAL = false;
 }
+/**
+ * Tiện ích hỗ trợ truyền thông giữa các cửa sổ, iframes (Cross-document communication)
+ * Sử dụng Window.postMessage kèm theo mã hóa/giải mã dữ liệu tự động.
+ */
 class UtilsCommunicateMicro {
     static initdEvent;
     static subs = new Map();
     static allMessageSub = new Subject();
+    /**
+     * Khởi tạo trình lắng nghe sự kiện 'message' trên window hiện tại.
+     * Cần được gọi một lần duy nhất tại Root Component (AppComponent).
+     * @param currentWindow Đối tượng window hiện tại
+     * @param destroyRef Reference để tự động unsubscribe khi component bị hủy
+     */
     static initEvent(currentWindow, destroyRef) {
         if (this.initdEvent) {
             return;
@@ -311,6 +390,11 @@ class UtilsCommunicateMicro {
             UtilsCache.ClearAll();
         });
     }
+    /**
+     * Gửi message tới cửa sổ cha (Parent) hoặc top window.
+     * Thường dùng khi app chạy trong Iframe.
+     * @param data Dữ liệu cần gửi ({type: string, response: any})
+     */
     static PostMessageToParent(data) {
         data = this.convertData(data);
         try {
@@ -324,6 +408,10 @@ class UtilsCommunicateMicro {
             console.log(error);
         }
     }
+    /**
+     * Gửi message tới tất cả các iframe con có trong trang.
+     * @param data Dữ liệu cần gửi ({type: string, response: any})
+     */
     static PostMessageToChildren(data) {
         data = this.convertData(data);
         const iframes = document.querySelectorAll('iframe');
@@ -331,6 +419,10 @@ class UtilsCommunicateMicro {
             iframe?.contentWindow?.postMessage(data, '*');
         });
     }
+    /**
+     * Gửi message tới cửa sổ đã mở cửa sổ hiện tại (Window Opener).
+     * @param data Dữ liệu cần gửi ({type: string, response: any})
+     */
     static PostMessageToOpener(data) {
         if (!window.opener) {
             return;
@@ -363,6 +455,11 @@ class UtilsCommunicateMicro {
             return data;
         }
     }
+    /**
+     * Đăng ký lắng nghe các message theo type cụ thể. Trả về một RxJS Subject.
+     * @param messageType Type của message hoặc danh sách các types cần lắng nghe
+     * @returns Subject sẽ phát ra message event khi nhận được dữ liệu hợp lệ
+     */
     static GetMessage(messageType) {
         if (!this.initdEvent) {
             throw Error('chưa khơi tạo hàm lắng nghe sự kiện, gọi UtilsCommunicateMicro.initEvent(window) tại root component');
@@ -483,6 +580,12 @@ class UtilsLanguageConstants {
     }
 }
 
+/**
+ * Tạo một chuỗi định danh duy nhất (Unique ID) dựa trên thời gian (timestamp) và các ký tự ngẫu nhiên.
+ * Chuỗi kết quả được xáo trộn và băm bằng MD5, trả về một chuỗi 32 ký tự alphanumeric.
+ *
+ * @returns {string} Chuỗi định danh duy nhất (MD5 hash).
+ */
 const uuid = () => {
     const timestamp = performance.now() * 1000;
     const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*()_+-=[]{}|;:,.<>?/~';
@@ -502,6 +605,10 @@ const uuid = () => {
 
 /* eslint-disable no-async-promise-executor */
 /* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Tiện ích quản lý Cache, hỗ trợ cả LocalStorage (đồng bộ) và IndexedDB (bất đồng bộ)
+ * Tự động mã hóa dữ liệu và xử lý thời gian hết hạn
+ */
 class UtilsCache {
     static CACHE_EXPIRE_TIME_DEFAULT = 5 * 60;
     static CACHE_EXPIRE_NONE = -1;
@@ -515,6 +622,10 @@ class UtilsCache {
     static itemIndexByKey = 'key';
     static dbVersion = 1;
     static db = null;
+    /**
+     * Khởi tạo cấu hình cho Cache
+     * @param config Cấu hình khởi tạo (tên DB, key ngôn ngữ, event clear...)
+     */
     static init(config) {
         if (this.initdEvent) {
             return;
@@ -533,12 +644,20 @@ class UtilsCache {
             this.languageKeyCache = config.languageKeyCache;
         }
     }
+    /**
+     * Lưu ngôn ngữ hiện tại vào cache
+     * @param lang Mã ngôn ngữ (vi, en, ...)
+     */
     static setLang(lang) {
         if (!UtilsLanguageConstants.isSupported(lang)) {
             throw Error(`Language not support ${lang}`);
         }
         this.Set(this.languageKeyCache, lang, this.CACHE_EXPIRE_NONE);
     }
+    /**
+     * Lấy ngôn ngữ từ cache
+     * @returns Mã ngôn ngữ
+     */
     static getLang() {
         return this.Get(this.languageKeyCache, UtilsLanguageConstants.defaultLang());
     }
@@ -636,6 +755,13 @@ class UtilsCache {
             },
         };
     }
+    /**
+     * Lấy giá trị từ IndexedDB theo key (bất đồng bộ)
+     * @param key Khóa cache
+     * @param default_value Giá trị mặc định nếu không tìm thấy
+     * @param isKeyMD5 Nếu true, key đã là MD5. Nếu false (mặc định), sẽ tự động MD5 key.
+     * @returns Promise chứa giá trị đã giải mã
+     */
     static async GetAsync(key, default_value, isKeyMD5 = false) {
         key = isKeyMD5 ? key : md5(key);
         return new Promise(async (resolve) => {
@@ -664,6 +790,12 @@ class UtilsCache {
             };
         });
     }
+    /**
+     * Lấy giá trị từ LocalStorage theo key (đồng bộ)
+     * @param key Khóa cache
+     * @param default_value Giá trị mặc định nếu không tìm thấy
+     * @returns Giá trị đã giải mã hoặc giá trị mặc định
+     */
     static Get(key, default_value) {
         // support cho những file không thể inject UtilsCache
         if (!key) {
@@ -692,6 +824,14 @@ class UtilsCache {
     static GetDefaultValueBySpecificKey(key, default_value) {
         return default_value;
     }
+    /**
+     * Lưu giá trị vào IndexedDB (bất đồng bộ)
+     * @param key Khóa cache
+     * @param value Giá trị cần lưu
+     * @param expireTimeBySecond Thời gian hết hạn (giây). Mặc định 5 phút. Dùng CACHE_EXPIRE_NONE để vĩnh viễn.
+     * @param isKeyMD5 Nếu true, key đã là MD5.
+     * @returns Promise chứa thông tin kết quả
+     */
     static async SetAsync(key, value, expireTimeBySecond = this.CACHE_EXPIRE_TIME_DEFAULT, isKeyMD5 = false) {
         // support inject UtilsCache
         return new Promise(async (resolve) => {
@@ -723,6 +863,13 @@ class UtilsCache {
             }
         });
     }
+    /**
+     * Lưu giá trị vào LocalStorage (đồng bộ)
+     * @param key Khóa cache
+     * @param value Giá trị cần lưu
+     * @param expireTimeBySecond Thời gian hết hạn (giây). Mặc định 5 phút.
+     * @returns true nếu thành công
+     */
     static Set(key, value, expireTimeBySecond = this.CACHE_EXPIRE_TIME_DEFAULT) {
         // support cho những file không inject UtilsCache
         const currentMillisecond = expireTimeBySecond === this.CACHE_EXPIRE_NONE ? this.CACHE_EXPIRE_NONE : new Date().valueOf() / 1000 + expireTimeBySecond;
@@ -739,6 +886,11 @@ class UtilsCache {
             return false;
         }
     }
+    /**
+     * Xóa một key trong IndexedDB
+     * @param key Khóa cần xóa
+     * @param isMD5 Nếu true, key đã được MD5.
+     */
     static async ClearAsync(key, isMD5 = false) {
         return new Promise(async (resolve) => {
             const objectStore = await this.getObjectStore();
@@ -755,12 +907,19 @@ class UtilsCache {
             };
         });
     }
+    /**
+     * Xóa một key trong LocalStorage
+     * @param key Khóa cần xóa
+     */
     static Clear(key) {
         if (key.includes('kc-callback-')) {
             return;
         }
         this.LocalStorage.removeItem(key);
     }
+    /**
+     * Xóa toàn bộ dữ liệu trong IndexedDB
+     */
     static ClearAllAsync() {
         return new Promise(async (resolve) => {
             const objectStore = await this.getObjectStore();
@@ -778,6 +937,9 @@ class UtilsCache {
             };
         });
     }
+    /**
+     * Xóa toàn bộ dữ liệu trong LocalStorage (kiểm soát các key đặc biệt)
+     */
     static ClearAll() {
         if (isEmbedFrame()) {
             const data = {
@@ -821,6 +983,11 @@ class UtilsCache {
             this.Set(key, value, this.CACHE_EXPIRE_NONE);
         });
     }
+    /**
+     * Xóa tất cả các khóa bắt đầu bằng tiền tố nhất định trong IndexedDB
+     * @param keyCacheStartWith Tiền tố khóa
+     * @param isKeyMD5 Nếu true, tiền tố đã được MD5.
+     */
     static DeleteKeyStartWithAsync(keyCacheStartWith, isKeyMD5 = false) {
         return new Promise(async (resolve) => {
             const objectStore = await this.getObjectStore();
@@ -847,6 +1014,11 @@ class UtilsCache {
             };
         });
     }
+    /**
+     * Xóa tất cả các khóa bắt đầu bằng tiền tố nhất định trong LocalStorage
+     * @param keyCache Tiền tố khóa
+     * @param isMD5 Nếu true, tiền tố sẽ được MD5 trước khi so sánh.
+     */
     static DeleteKeyStartWith(keyCache, isMD5 = false) {
         keyCache = isMD5 ? md5(keyCache) : keyCache;
         const keys = Object.keys(this.LocalStorage);
@@ -859,6 +1031,10 @@ class UtilsCache {
             }
         });
     }
+    /**
+     * Xóa hoàn toàn cơ sở dữ liệu IndexedDB
+     * @param dbName Tên DB, mặc định theo cấu hình.
+     */
     static DeleteDatabaseIndexDB(dbName) {
         return new Promise((resolve) => {
             dbName = (dbName || this.dbName);
@@ -887,14 +1063,26 @@ dayjs.extend(timezone);
 dayjs.extend(customParseFormat);
 let timeZoneSetup = 'Asia/Ho_Chi_Minh';
 let patternCheckTimeUTC = undefined;
+/**
+ * Thiết lập múi giờ mặc định cho hệ thống (mặc định là Asia/Ho_Chi_Minh).
+ * @param localeZone Tên múi giờ (ví dụ: 'America/New_York')
+ */
 const setDefaultTimeZone = (localeZone = timeZoneSetup) => {
     timeZoneSetup = localeZone;
     dayjs.tz.setDefault(localeZone);
 };
+/**
+ * Thiết lập pattern Regex để nhận diện và chuẩn hóa các chuỗi thời gian UTC đặc biệt.
+ * @param pattern Regex pattern dùng để kiểm tra và replace chuỗi thời gian
+ */
 const setPatternCheckTimeUTC = (pattern) => {
     patternCheckTimeUTC = pattern;
 };
 let functionFormatDate = undefined;
+/**
+ * Cung cấp một hàm format tùy chỉnh ghi đè lên logic mặc định của formatDate.
+ * @param functionCustom Hàm format tùy chỉnh
+ */
 const updateFunctionFormatDate = (functionCustom) => {
     functionFormatDate = functionCustom;
 };
@@ -1212,6 +1400,14 @@ const convertObjectToSignal = (data, cloneDeepIfNotSignal = true, isSignalPrimit
     }
     return data;
 };
+/**
+ * Chuyển đổi một đối tượng signal (có thể lồng nhau) thành đối tượng plain object/array/map/set.
+ * @param data Dữ liệu signal hoặc đối tượng chứa signal cần chuyển đổi.
+ * @param isCloneDeep Có thực hiện sao chép sâu dữ liệu trong quá trình chuyển đổi hay không. Mặc định là true.
+ * @param seen Dùng nội bộ để tránh lặp vô hạn (WeakMap).
+ * @param options Tùy chọn chuyển đổi (ví dụ: convertWhenFirstItemArrayNotIsSignal).
+ * @returns Đối tượng plain object đã được "giải nén" mọi signal bên trong.
+ */
 const convertSignalToObject = (data, isCloneDeep = true, seen = new WeakMap(), options) => {
     let ignoreCheckSeenHasDataAfterWhile = false;
     while (isSignal(data) && !seen.has(data)) {
@@ -1276,6 +1472,11 @@ const convertSignalToObject = (data, isCloneDeep = true, seen = new WeakMap(), o
     }
     return result;
 };
+/**
+ * Unwrap một giá trị cho đến khi không còn là signal nữa.
+ * @param data Giá trị (có thể là lồng nhiều cấp signal) cần unwrap.
+ * @returns Giá trị cuối cùng bên trong signal.
+ */
 const unwrapSignal = (data) => {
     while (isSignal(data)) {
         data = data();
@@ -1930,13 +2131,24 @@ const generateInterface = (obj, interfaceName) => {
 
 let parser = null;
 let bowserParser = null;
+/**
+ * Lấy thông tin thiết bị và trình duyệt (Sử dụng thư viện Bowser).
+ * @returns Đối tượng Parser chứa thông tin OS, Browser, Platform...
+ */
 const getDeviceInfo = () => {
     if (!bowserParser) {
         bowserParser = Bowser.getParser(window.navigator.userAgent);
     }
     return bowserParser;
 };
+/**
+ * Kiểm tra xem thiết bị hiện tại có hỗ trợ cảm ứng (Touch) không.
+ * @returns true nếu là thiết bị cảm ứng
+ */
 const isTouchDevice = () => ('onpointerdown' in navigator && navigator.maxTouchPoints > 0) || 'ontouchstart' in window || (window.matchMedia?.('(pointer: coarse)').matches ?? false);
+/**
+ * Xác định tên sự kiện click phù hợp cho thiết bị (click cho desktop, pointerdown cho touch).
+ */
 const getEventNameHandleClick = (() => {
     if (isTouchDevice()) {
         return 'pointerdown';
@@ -1944,12 +2156,22 @@ const getEventNameHandleClick = (() => {
     const deviceInfo = getDeviceInfo();
     return deviceInfo.isPlatform('desktop') ? 'click' : 'touchstart';
 })();
+/**
+ * Chuyển đổi một chuỗi HTML thành đối tượng Document.
+ * @param htmlStr Chuỗi HTML cần parse
+ * @returns Đối tượng Document tương ứng
+ */
 const getDocumentByString = (htmlStr) => {
     if (!parser) {
         parser = new DOMParser();
     }
     return parser.parseFromString(htmlStr, 'text/html');
 };
+/**
+ * Sao chép các thuộc tính cơ bản của IBoundingClientRect.
+ * @param rect Đối tượng IBoundingClientRect gốc
+ * @returns Đối tượng IBoundingClientRect đã được copy
+ */
 const cloneIBoundingClientRect = (rect) => {
     return {
         top: rect['top'],
@@ -1959,13 +2181,28 @@ const cloneIBoundingClientRect = (rect) => {
         bottom: rect['bottom'],
     };
 };
+/**
+ * Gán nhiều thuộc tính CSS style cho một Element.
+ * @param el Phần tử HTML cần gán style
+ * @param styles Đối tượng chứa các style (ví dụ: { color: 'red', display: 'block' })
+ */
 const setStylesElement = (el, styles) => {
     Object.keys(styles).forEach((key) => set(el, `style.${key}`, styles[key]));
 };
+/**
+ * Lấy kích thước Viewport hiển thị của cửa sổ trình duyệt.
+ * @param win Đối tượng Window (mặc định là window)
+ * @returns Đối tượng chứa width và height
+ */
 const getViewport = (win = window) => {
     const doc = win.document.documentElement, body = win.document.getElementsByTagName('body')[0], w = win.innerWidth || doc.clientWidth || body.clientWidth, h = win.innerHeight || doc.clientHeight || body.clientHeight;
     return { width: w, height: h };
 };
+/**
+ * Thiết lập vị trí con trỏ (caret) cho thẻ Input hoặc Textarea.
+ * @param element Thẻ input hoặc textarea
+ * @param position Vị trí cần đặt con trỏ
+ */
 const setCaretPosition = (element, position) => {
     if (!element || !element.setSelectionRange) {
         return;
@@ -1973,6 +2210,14 @@ const setCaretPosition = (element, position) => {
     element.focus();
     element.setSelectionRange(position, position);
 };
+/**
+ * Kiểm tra xem một phần tử có đang hiển thị trong vùng nhìn thấy (viewport) của một container không.
+ * @param container Element cha chứa vùng scroll
+ * @param element Element cần kiểm tra
+ * @param elementScroll (Tùy chọn) Element đại diện cho vùng scroll nếu khác container
+ * @param maxTopLeft (Tùy chọn) Offset bổ sung để kiểm tra
+ * @returns true nếu nằm trong vùng nhìn thấy
+ */
 const checkViewInScreen = (container, element, elementScroll, maxTopLeft) => {
     if (!container || !element) {
         return false;
@@ -2000,6 +2245,13 @@ const checkViewInScreen = (container, element, elementScroll, maxTopLeft) => {
     }
     return false;
 };
+/**
+ * Kiểm tra xem tọa độ chuột hiện tại có nằm trong vùng của một Element không.
+ * @param mousePosition Đối tượng chứa clientX, clientY
+ * @param element Element cần kiểm tra
+ * @param rect (Tùy chọn) Bounding rect đã có sẵn để tối ưu hiệu năng
+ * @returns true nếu chuột đang đè lên phần tử
+ */
 const checkMouseOverInContainer = (mousePosition, element, rect) => {
     if (!element && !rect) {
         return false;
@@ -2014,6 +2266,11 @@ const checkMouseOverInContainer = (mousePosition, element, rect) => {
     }
     return false;
 };
+/**
+ * Tạo sự kiện Kéo-Thả (Drag) nâng cao dựa trên RxJS cho một Element.
+ * @param config Cấu hình sự kiện (element, các hàm callback, destroyRef)
+ * @returns Observable phát ra sự kiện mousemove trong quá trình kéo
+ */
 const getDragEventByElement = (config) => {
     let timer;
     const addClass = () => {
@@ -2050,20 +2307,37 @@ const getDragEventByElement = (config) => {
     return mouseDown.pipe(mergeMap((e) => (config.isStartWithMouseDownEvent ? mousemove.pipe(startWith(e)) : mousemove)), takeUntilDestroyed(config.destroyRef), finalize(removeClass));
 };
 
+/**
+ * Tiện ích xử lý tham số truy vấn trên URL (URL Search Parameters).
+ * Cung cấp các phương thức để parse, thêm, xóa, lấy giá trị và so sánh các tham số.
+ */
 class UtilsUrlSearchParams {
     static instance;
     params;
+    /**
+     * Khởi tạo UtilsUrlSearchParams từ một chuỗi query string.
+     * @param paramString Chuỗi tham số (ví dụ: "?id=1&name=test" hoặc đơn giản là "id=1&name=test").
+     */
     constructor(paramString) {
         this.params = new Array();
         this.params.length = 0;
         this.params.push(...this.buildParams(paramString));
     }
+    /**
+     * Lấy instance duy nhất (Singleton) của UtilsUrlSearchParams.
+     * @returns {UtilsUrlSearchParams} Instance của lớp.
+     */
     static getInstance() {
         if (!this.instance) {
             this.instance = new UtilsUrlSearchParams('');
         }
         return this.instance;
     }
+    /**
+     * Chuyển đổi một đối tượng key-value thành chuỗi query string.
+     * @param params Đối tượng chứa các tham số (ví dụ: { id: "1", name: "test" }).
+     * @returns {string} Chuỗi query string đã được sắp xếp theo key (ví dụ: "id=1&name=test").
+     */
     static toStringParamObject(params) {
         const paramsArr = Object.keys(params).map((key) => {
             return {
@@ -2073,6 +2347,12 @@ class UtilsUrlSearchParams {
         });
         return UtilsUrlSearchParams.ToString(paramsArr);
     }
+    /**
+     * Chuyển đổi mảng các cặp key-value thành chuỗi query string.
+     * Các tham số sẽ được sắp xếp theo thứ tự bảng chữ cái của key.
+     * @param params Mảng các đối tượng { key, value }.
+     * @returns {string} Chuỗi query string.
+     */
     static ToString(params) {
         let paramsStr = '';
         params
@@ -2083,6 +2363,12 @@ class UtilsUrlSearchParams {
         });
         return paramsStr;
     }
+    /**
+     * Phân tích chuỗi query string thành mảng các cặp key-value.
+     * Tự động decode các giá trị và xử lý các trường hợp URL lỗi (nhiều dấu ?).
+     * @param paramString Chuỗi cần phân tích.
+     * @returns {Array<{ key: string; value: string }>} Mảng kết quả.
+     */
     buildParams(paramString) {
         const paramsBuild = new Array();
         if (!paramString) {
@@ -2108,6 +2394,11 @@ class UtilsUrlSearchParams {
         }
         return paramsBuild;
     }
+    /**
+     * Thêm hoặc cập nhật giá trị của một tham số.
+     * @param key Tên tham số.
+     * @param value Giá trị tham số.
+     */
     set(key, value) {
         const paramByKey = this.params.find((param) => param.key === key);
         if (!paramByKey) {
@@ -2116,25 +2407,51 @@ class UtilsUrlSearchParams {
         }
         paramByKey['value'] = value;
     }
+    /**
+     * Lấy giá trị của một tham số theo key.
+     * @param key Tên tham số cần lấy.
+     * @returns {string | undefined} Giá trị của tham số hoặc undefined nếu không tìm thấy.
+     */
     get(key) {
         return this.params.find((param) => param.key === key)?.value;
     }
+    /**
+     * Kiểm tra xem một tham số có tồn tại hay không.
+     * @param key Tên tham số cần kiểm tra.
+     * @returns {boolean} True nếu tồn tại.
+     */
     has(key) {
         return this.params.some((param) => param.key === key);
     }
+    /**
+     * Xóa một tham số khỏi danh sách.
+     * @param key Tên tham số cần xóa.
+     */
     delete(key) {
         const index = this.params.findIndex((param) => param.key === key);
         if (index >= 0) {
             this.params.splice(index, 1);
         }
     }
+    /**
+     * @returns {number} Số lượng tham số hiện có.
+     */
     length() {
         return this.params.length;
     }
+    /**
+     * Chuyển đổi các tham số hiện tại (hoặc mảng truyền vào) thành chuỗi query string.
+     * @param params (Tùy chọn) Mảng tham số cần convert. Nếu không truyền sẽ dùng params nội bộ.
+     * @returns {string} Chuỗi query string.
+     */
     toString(params) {
         params = params || this.params;
         return UtilsUrlSearchParams.ToString(params);
     }
+    /**
+     * Chuyển đổi danh sách tham số hiện tại thành một đối tượng plain object.
+     * @returns {Record<string, string>} Đối tượng key-value.
+     */
     getParamObject() {
         const params = {};
         this.params.forEach((item) => {
@@ -2142,6 +2459,13 @@ class UtilsUrlSearchParams {
         });
         return params;
     }
+    /**
+     * So sánh hai chuỗi query string xem chúng có chứa cùng tập tham số và giá trị hay không.
+     * Thứ tự các tham số trong chuỗi ban đầu không quan trọng.
+     * @param param1 Chuỗi thứ nhất.
+     * @param param2 Chuỗi thứ hai.
+     * @returns {boolean} True nếu giống nhau.
+     */
     compareParams(param1, param2) {
         const params1 = this.toString(this.buildParams(param1));
         const params2 = this.toString(this.buildParams(param2));
@@ -2151,9 +2475,20 @@ class UtilsUrlSearchParams {
 
 const step = 20;
 const percent = 0.05;
+/**
+ * Lấy cụ thể một shade hoặc tint của màu dựa trên bước (step)
+ * @param color Mã màu HEX (3 hoặc 6 ký tự)
+ * @param stepNumber Bước màu cần lấy (5, 10, 15... 100)
+ * @returns Đối tượng chứa thông tin bước màu và mã HEX light/dark
+ */
 const colorStepContrastFromOrigin = (color, stepNumber) => {
     return colorContrastFromOrigin(color).find((item) => item.step === stepNumber);
 };
+/**
+ * Tạo ra danh sách các sắc độ (shades & tints) từ một màu gốc
+ * @param color Mã màu HEX
+ * @returns Mảng các đối tượng chứa step, label, light hex và dark hex
+ */
 const colorContrastFromOrigin = (color) => {
     const parsedColorsArray = parseColorValues(color);
     const colors = [];
@@ -2206,6 +2541,11 @@ const rgbShade = (rgb, i) => {
 const rgbTint = (rgb, i) => {
     return { red: rgb.red + (255 - rgb.red) * i * percent, green: rgb.green + (255 - rgb.green) * i * percent, blue: rgb.blue + (255 - rgb.blue) * i * percent };
 };
+/**
+ * Chuyển đổi đối tượng RGB sang mã HEX (không có dấu #)
+ * @param rgb Đối tượng chứa red, green, blue
+ * @returns Chuỗi HEX 6 ký tự
+ */
 const rgbToHex = (rgb) => {
     return intToHex(rgb.red) + intToHex(rgb.green) + intToHex(rgb.blue);
 };
@@ -2222,6 +2562,9 @@ const pad = (number, length) => {
     }
     return str;
 };
+/**
+ * Danh sách các mã màu định nghĩa sẵn để sử dụng trong getColorById
+ */
 const listColorDefine = [
     '#E62222',
     '#B81B1B',
@@ -2269,6 +2612,12 @@ const listColorDefine = [
     '#1A1A1A',
     '#4D4D4D',
 ];
+/**
+ * Lấy một màu định nghĩa sẵn dựa trên chuỗi đầu vào (như ID người dùng, tên...)
+ * Màu trả về là duy nhất và cố định cho cùng một chuỗi đầu vào.
+ * @param str Chuỗi để hash lấy màu
+ * @returns Mã màu HEX từ listColorDefine
+ */
 const getColorById = (str) => {
     let hashString = 0;
     if (!str) {
@@ -2281,6 +2630,12 @@ const getColorById = (str) => {
     }
     return listColorDefine[Math.abs(hashString) % listColorDefine.length];
 };
+/**
+ * Loại bỏ các thuộc tính màu sắc (color, background...) "gần trắng" khỏi chuỗi style CSS
+ * Giúp tránh việc hiển thị chữ trắng trên nền trắng khi merge style lung tung.
+ * @param style Chuỗi style CSS (ví dụ: "color: #fff; font-size: 14px;")
+ * @returns Chuỗi style đã được làm sạch
+ */
 const detectAndCleanNearWhiteColors = (style) => {
     if (!style)
         return style;
@@ -2307,6 +2662,12 @@ const detectAndCleanNearWhiteColors = (style) => {
         .map(([k, v]) => `${k}: ${v}`)
         .join('; ');
 };
+/**
+ * Kiểm tra một màu có phải là "gần trắng" hay không
+ * Dựa trên luminance > 0.95 và saturation < 0.1
+ * @param color Mã màu (HEX, RGB, RGBA hoặc tên màu CSS)
+ * @returns true nếu màu gần trắng
+ */
 const isNearWhite = (color) => {
     if (!color)
         return false;
@@ -2505,6 +2866,17 @@ const getKeyCacheByArrayObject = (keyCache, argumentsValue) => {
     return `${keyCacheMD5}-${md5(`${keyCacheMD5}-${keyCachePlus}`)}`;
 };
 
+/**
+ * Chuẩn hóa chuỗi số theo locale hiện tại về dạng số thực (parseable).
+ * - Với **EN**: Xóa dấu phẩy (`,`) — dấu phân tách hàng nghìn.
+ * - Với **VI**: Xóa dấu chấm (`.`) và đổi dấu phẩy (`,`) thành dấu chấm (`.`).
+ *
+ * @param value Chuỗi hoặc số cần chuẩn hóa
+ * @returns Chuỗi số đã được chuẩn hóa (không dấu phân cách locale)
+ * @example
+ * // EN: "1,234,567" → "1234567"
+ * // VI: "1.234.567,89" → "1234567.89"
+ */
 const formatNumber = (value) => {
     const lang = UtilsCache.getLang();
     if (lang === UtilsLanguageConstants.EN) {
@@ -2512,9 +2884,26 @@ const formatNumber = (value) => {
     }
     return `${value}`.replace(/[.]/g, '').replace(/[,]/g, '.');
 };
+/**
+ * Định dạng và hiển thị số theo ngôn ngữ (VI/EN) với các tùy chọn linh hoạt.
+ * Xử lý số âm, phần thập phân, làm tròn và dấu phân cách hàng nghìn.
+ *
+ * @param value Giá trị số hoặc chuỗi số đầu vào
+ * @param acceptNegativeValue Có chấp nhận số âm không (false → trả về 0 nếu value <= 0)
+ * @param parseFixed Số chữ số thập phân muốn giữ lại (mặc định: 1)
+ * @param ignoreFormatSeparator Bỏ qua bước chuẩn hóa dấu phân cách (khi value đã là số thuần)
+ * @param ignoreParseFloat Bỏ qua bước làm tròn (giữ nguyên phần thập phân)
+ * @param lang Ngôn ngữ hiển thị ('vi' hoặc 'en'), mặc định lấy từ cache
+ * @returns Chuỗi số đã format theo locale (vd: "1.234.567,89" hoặc "1,234,567.89")
+ * @example
+ * // VI, 2 chữ số thập phân
+ * viewDataNumberByLanguage(1234567.891, true, 2) → "1.234.567,89"
+ * // EN, 2 chữ số thập phân
+ * viewDataNumberByLanguage(1234567.891, true, 2, false, false, 'en') → "1,234,567.89"
+ */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-const viewDataNumberByLanguage = (value, acceptNegativeValue, parseFixed = 1, ignoreFormatSeparator = false, ignoreParseFloat = false) => {
-    const lang = UtilsCache.getLang();
+const viewDataNumberByLanguage = (value, acceptNegativeValue, parseFixed = 1, ignoreFormatSeparator = false, ignoreParseFloat = false, lang) => {
+    lang = lang || UtilsCache.getLang();
     if (!`${value}`.trim()) {
         return '';
     }
@@ -2569,63 +2958,143 @@ const viewDataNumberByLanguage = (value, acceptNegativeValue, parseFixed = 1, ig
 };
 
 /* eslint-disable no-useless-escape */
+/**
+ * Returns regex for email validation
+ * @returns {RegExp}
+ */
 const patternEmail = () => {
     return /^[A-z0-9]+[A-z0-9\_\.\+\-]*[A-z0-9]@[A-z0-9]+[A-z0-9\_\.\+\-]*[A-z0-9]\.[A-z0-9]+[A-z0-9\_\.\+\-]*[A-z0-9]$/;
 };
-const patterProtocolUrl = () => {
+/**
+ * Returns regex for protocol in URL (http, https, ftp)
+ * @returns {RegExp}
+ */
+const patternProtocolUrl = () => {
     return /(http|https|ftp):/;
 };
+/**
+ * Returns regex for full URL validation
+ * @returns {RegExp}
+ */
 const patternUrl = () => {
     return /^(http|https|ftp):(\/){2}[^\s]+[.]{1}[^\s]+$/;
 };
+/**
+ * Returns regex for host part of URL
+ * @returns {RegExp}
+ */
 const patternHostUrl = () => {
     return /^((https|http|ftp):[/]{2}[^/\s]+)/;
 };
+/**
+ * Returns regex for domain validation
+ * @returns {RegExp}
+ */
 const patternDomain = () => {
-    return /^([a-zA-Z0-9])(([a-z0-9-]{1,61})?[a-z0-9]{1})?(\.[a-z0-9](([a-z0-9-]{1,61})?[a-z0-9]{1})?)?(\.[a-zA-Z]{2,4})+$/;
+    return /^([a-zA-Z0-9])(([a-z0-9-]{1,61})?[a-z0-9]{1})?(\.[a-z0-9](([a-z0-9-]{1,61})?[a-z0-9]{1})?)?(\.[a-zA-Z]{2,})+$/;
 };
+/**
+ * Returns regex for Vietnamese mobile phone validation
+ * @returns {RegExp}
+ */
 const patternMobilePhone = () => {
     return /^(\+?84|0|84)([0-9]{9})$/;
 };
+/**
+ * Returns regex for general phone number validation
+ * @returns {RegExp}
+ */
 const patternPhone = () => {
     return /^(\+?84|[0-9]|84)([0-9]{2,9})$/;
 };
+/**
+ * Returns regex for digits
+ * @returns {RegExp}
+ */
 const patternNumber = () => {
     return /\d+/g;
 };
+/**
+ * Returns regex for encoded URI characters
+ * @returns {RegExp}
+ */
 const patternEncodeUri = () => {
     return /%([0-9A-F]{2})/g;
 };
+/**
+ * Returns regex for standard name (alphanumeric and spaces)
+ * @returns {RegExp}
+ */
 const patternName = () => {
     return /^\w+[A-Za-z\s\d]+$/;
 };
+/**
+ * Returns regex for UTF-8 name (including Vietnamese characters)
+ * @returns {RegExp}
+ */
 const patternNameUtf8 = () => {
     return /^[ àáảãạăắằẵặẳâầấậẫẩđèéẻẽẹêềếểễệìíỉĩịòóỏõọôồốổỗộơờớởỡợùúủũụưừứửữựỳýỷỹÀÁẢÃẠĂẮẰẴẶẲÂẦẤẬẪẨĐÈÉẺẼẸÊỀẾỂỄỆÌÍỈĨỊÒÓỎÕỌÔỒỐỔỖỘƠỜỚỞỠỢÙÚỦŨỤƯỪỨỬỮỰỲÝỶỸA-Za-z0-9]+$/;
 };
+/**
+ * Returns regex for special characters in name
+ * @returns {RegExp}
+ */
 const patternNameSpecial = () => {
     return /[~!@#$%^&*()-+=<>,?\/\\:;"']/;
 };
+/**
+ * Returns regex for profile name
+ * @returns {RegExp}
+ */
 const patternNameProfile = () => {
     return /([\w\W\d\s]+)+/;
 };
+/**
+ * Returns regex for emojis
+ * @returns {RegExp}
+ */
 const patternEmoji = () => {
     return /(\u00a9|\u00ae|[\u2000-\u3300]|\ud83c[\ud000-\udfff]|\ud83d[\ud000-\udfff]|\ud83e[\ud000-\udfff])/g;
 };
+/**
+ * Returns regex for matching field replacement markers (e.g. {{field}})
+ * @returns {RegExp}
+ */
 const patternRuleFieldReplace = () => {
     return /[{]{2}[a-zA-Z_-]+[}]{2}/g;
 };
+/**
+ * Returns regex for extracting field name from replacement markers
+ * @returns {RegExp}
+ */
 const patternGetFieldByRuleFieldReplace = () => {
     return /[a-zA-Z_-]+/g;
 };
+/**
+ * Returns regex for PEM format validation
+ * @returns {RegExp}
+ */
 const patternPem = () => {
     return /^(0|1):([0-9]{1,2}):(\{\{path-api\}\}):([a-zA-Z0-9\/]+)$/g;
 };
+/**
+ * Returns regex for tax ID validation
+ * @returns {RegExp}
+ */
 const patternTax = () => {
     return /^([0-9]){10}(-[0-9]{3})?$/;
 };
+/**
+ * Returns regex for key validation (identical to tax regex)
+ * @returns {RegExp}
+ */
 const patternKey = () => {
     return /^([0-9]){10}(-[0-9]{3})?$/;
 };
+/**
+ * Returns regex for account validation (must contain @)
+ * @returns {RegExp}
+ */
 const patternAccount = () => {
     return /^(?=.*@)[a-z0-9@._-]{2,63}$/;
 };
@@ -2633,14 +3102,33 @@ const patternAccount = () => {
 let functionXssFilter = async (value) => {
     return value;
 };
+/**
+ * Cập nhật hàm lọc XSS.
+ * Cho phép ghi đè hàm xử lý XSS mặc định (trả về nguyên gốc) bằng một implementation bảo mật do project cung cấp (ví dụ: dùng DOMPurify).
+ *
+ * @param functionCustom Hàm xử lý XSS tùy chỉnh cần cập nhật.
+ */
 const updateFunctionXssFilter = (functionCustom) => {
     functionXssFilter = functionCustom;
 };
+/**
+ * Lọc dữ liệu thông qua hàm lọc XSS đã được định cấu hình.
+ * Theo mặc định, hàm này sẽ trả lại chuỗi ban đầu. Nếu bạn đã cung cấp một custom filter qua `updateFunctionXssFilter`, hàm đó sẽ được sử dụng.
+ *
+ * @param data Chuỗi dữ liệu đầu vào.
+ * @returns {Promise<string>} Promise chứa kết quả đã được lọc XSS.
+ */
 const xssFilter = async (data) => {
     return await functionXssFilter(data);
 };
 
 const ENCODE_URI_PATTERN = /%([0-9A-F]{2})/g;
+/**
+ * Giải mã chuỗi URI một cách an toàn.
+ *
+ * @param value Chuỗi cần giải mã.
+ * @returns Chuỗi đã được giải mã.
+ */
 const decodeURI = (value) => {
     return decodeURIComponent(value
         .split('')
@@ -2649,11 +3137,25 @@ const decodeURI = (value) => {
     })
         .join(''));
 };
+/**
+ * Mã hóa chuỗi URI.
+ *
+ * @param value Chuỗi cần mã hóa.
+ * @returns Chuỗi đã được mã hóa.
+ */
 const encodeURI = (value) => {
     return encodeURIComponent(value).replace(ENCODE_URI_PATTERN, (match, p1) => {
         return String.fromCharCode(parseInt(p1, 16));
     });
 };
+/**
+ * Chuyển đổi đối tượng parameters thành chuỗi query string hoặc body string.
+ * Tự động loại bỏ các giá trị rỗng, null, hoặc undefined.
+ *
+ * @param params Đối tượng chứa các tham số.
+ * @param isBody Nếu true, trả về chuỗi không có dấu '?' ở đầu.
+ * @returns Chuỗi tham số đã được mã hóa.
+ */
 const endCodeUrl = (params, isBody) => {
     params = omitBy(params, (param) => param === '' || isNil(param));
     let res = '';
@@ -2663,12 +3165,27 @@ const endCodeUrl = (params, isBody) => {
     return res === '' ? '' : `${isBody ? '' : '?'}${res.substring(1)}`;
 };
 
+/**
+ * Mã hóa chuỗi thành Base64 (có hỗ trợ ký tự đặc biệt qua encodeURI)
+ * @param value Chuỗi cần mã hóa
+ * @returns Chuỗi đã mã hóa Base64
+ */
 const base64Encode = (value) => {
     return btoa(encodeURI(value));
 };
+/**
+ * Giải mã chuỗi Base64 (có hỗ trợ ký tự đặc biệt qua decodeURI)
+ * @param value Chuỗi Base64 cần giải mã
+ * @returns Chuỗi đã giải mã
+ */
 const base64Decode = (value) => {
     return decodeURI(atob(value));
 };
+/**
+ * Chuyển đổi dữ liệu Base64 thành Blob
+ * @param dataBase64 Dữ liệu Base64 (có thể bao gồm marker ;base64,)
+ * @returns Blob tương ứng
+ */
 const convertBase64ToBlob = (dataBase64) => {
     const BASE64_MARKER = ';base64,';
     if (dataBase64.indexOf(BASE64_MARKER) === -1) {
@@ -2689,12 +3206,22 @@ const convertBase64ToBlob = (dataBase64) => {
     const blob = new Blob([uInt8Array], { type: contentType });
     return blob;
 };
+/**
+ * Chuyển đổi File thành Base64 string hoặc Object URL tùy loại file
+ * @param file Đối tượng File cần chuyển đổi
+ * @returns Nếu là ảnh, trả về Base64 string. Ngược lại trả về Object URL.
+ */
 const convertFileToBase64_ObjectUrl = async (file) => {
     if (!file.type.match(/image.*/)) {
         return URL.createObjectURL(file);
     }
     return await convertFileToBase64(file);
 };
+/**
+ * Chuyển đổi File thành Base64 string
+ * @param file Đối tượng File cần chuyển đổi
+ * @returns Promise chứa chuỗi Base64
+ */
 const convertFileToBase64 = (file) => {
     return new Promise((resolve) => {
         const reader = new FileReader();
@@ -2705,6 +3232,13 @@ const convertFileToBase64 = (file) => {
     });
 };
 
+/**
+ * Tải file từ URL bằng XMLHttpRequest.
+ * Khác với `downloadFileByUrl`, hàm này sử dụng XHR để tải file, hữu ích hơn
+ * trong các trường hợp cần header tùy chỉnh hoặc gọi API nội bộ.
+ * @param fileUrl URL của file cần tải
+ * @param filename Tên file sẽ được lưu về máy
+ */
 const downloadFileByUrlUseXmlRequest = (fileUrl, filename) => {
     const xmlRequest = new XMLHttpRequest();
     xmlRequest.open('GET', fileUrl, true);
@@ -2719,6 +3253,13 @@ const downloadFileByUrlUseXmlRequest = (fileUrl, filename) => {
     };
     xmlRequest.send();
 };
+/**
+ * Tải file từ URL bằng cách tạo thẻ `<a>` ảo và kích hoạt sự kiện click.
+ * Hỗ trợ chế độ mở file trên tab mới (onlyOpen) hoặc tải xuống thực sự.
+ * @param fileUrl URL trực tiếp của file hoặc Blob URL
+ * @param filename Tên file sẽ được lưu khi tải về
+ * @param onlyOpen Nếu `true`, chỉ mở file trong tab mới thay vì tải về
+ */
 const downloadFileByUrl = async (fileUrl, filename, onlyOpen) => {
     const downloadFileElement = document.createElement('a');
     if (!onlyOpen) {
@@ -2734,6 +3275,13 @@ const downloadFileByUrl = async (fileUrl, filename, onlyOpen) => {
     downloadFileElement.click();
     downloadFileElement.remove();
 };
+/**
+ * Tải ảnh từ một phần tử `<img>` dựa trên thuộc tính `src` (hỗ trợ Base64 Data URL).
+ * Thường dùng để cho phép người dùng lưu ảnh barcode, QR code về máy.
+ * @param imageElement Phần tử `<img>` cần lấy ảnh
+ * @param typeFileDownload Loại MIME của file (mặc định: 'image/png')
+ * @param nameFile Tên file sẽ được lưu (mặc định: 'barcode')
+ */
 const downloadImageFromELement = (imageElement, typeFileDownload, nameFile) => {
     const parentElement = imageElement?.src;
     const blobData = convertBase64ToBlob(parentElement);
@@ -2750,11 +3298,17 @@ const LINK_IMAGE_ERROR_TOKEN_INJECT = new InjectionToken('LINK_IMAGE_ERROR_TOKEN
 const PROCESS_BAR_STANDARD_CONFIG_DEFAULT_TOKEN_INJECT = new InjectionToken('PROCESS_BAR_STANDARD_CONFIG_DEFAULT_TOKEN_INJECT');
 const PROCESS_BAR_STEPS_CONFIG_DEFAULT_TOKEN_INJECT = new InjectionToken('PROCESS_BAR_STEPS_CONFIG_DEFAULT_TOKEN_INJECT');
 
+/** Kiểm tra file có phải là ảnh không (image/*). */
 const isTypeImage = (file) => (file.type.match(/image.*/) ? true : false);
+/** Kiểm tra file có phải là video không (video/*). */
 const isTypeVideo = (file) => (file.type.match(/video.*/) ? true : false);
+/** Kiểm tra file có phải là audio không (audio/*). */
 const isTypeAudio = (file) => (file.type.match(/audio.*/) ? true : false);
+/** Kiểm tra giá trị có phải là đối tượng File không. */
 const isTypeFile = (file) => (file instanceof File || Object.prototype.toString.call(file) === '[object File]' ? true : false);
+/** Danh sách extension/MIME type của file Excel. */
 const ExcelExtList = ['xls', 'xlsx', 'application/vnd.ms-excel', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'];
+/** Danh sách extension/MIME type của tài liệu (Word, Excel, PDF, JSON...). */
 const DocumentExtList = [
     'doc',
     'docx',
@@ -2775,13 +3329,40 @@ const DocumentExtList = [
     'application/json',
     'application/xml',
 ];
+/**
+ * Kiểm tra extension có thuộc danh sách tài liệu được chấp nhận không.
+ * @param ext Extension hoặc MIME type cần kiểm tra
+ * @param listExt Danh sách tùy chỉnh (mặc định là DocumentExtList)
+ */
 const isIncludeDocumentExtList = (ext, listExt = DocumentExtList) => listExt.includes(ext) || listExt.includes(`application/${ext}`);
+/** Danh sách extension/MIME type của ảnh. */
 const ImageExtList = ['gif', 'jpg', 'jpeg', 'png', 'image/gif', 'image/jpeg', 'image/jpeg', 'image/png', 'webp'];
+/**
+ * Kiểm tra extension có thuộc danh sách ảnh không.
+ * @param ext Extension hoặc MIME type cần kiểm tra
+ * @param listExt Danh sách tùy chỉnh (mặc định là ImageExtList)
+ */
 const isIncludeImageExtList = (ext, listExt = ImageExtList) => listExt.includes(ext);
+/** Danh sách extension/MIME type của video. */
 const VideoExtList = ['mp4', 'mov', 'mpg', 'avi', 'wmv', 'video/mp4', 'video/quicktime', 'video/mpeg', 'video/x-msvideo', 'video/x-ms-wmv'];
+/**
+ * Kiểm tra extension có thuộc danh sách video không.
+ * @param ext Extension hoặc MIME type cần kiểm tra
+ */
 const isIncludeVideoExtList = (ext, listExt = VideoExtList) => listExt.includes(ext);
+/** Danh sách extension/MIME type của audio. */
 const AudioExtList = ['mp3', 'wav', 'ogg', 'aac', 'm4a', 'flac', 'wma', 'audio/mpeg', 'audio/wav', 'audio/ogg', 'audio/aac', 'audio/mp4', 'audio/flac', 'audio/x-ms-wma'];
+/**
+ * Kiểm tra extension có thuộc danh sách audio không.
+ * @param ext Extension hoặc MIME type cần kiểm tra
+ */
 const isIncludeAudioExtList = (ext, listExt = AudioExtList) => listExt.includes(ext);
+/**
+ * Lấy phần mở rộng (extension) của một file.
+ * Hỗ trợ cả đối tượng File gốc của Browser và IFile (interface nội bộ).
+ * @param file Đối tượng File hoặc IFile
+ * @returns Extension dạng chữ thường (vd: "jpg", "pdf") hoặc undefined
+ */
 const getFileExtension = (file) => {
     if (file instanceof File && file.type) {
         return (file.type.split('/').pop() || '').toLowerCase();
@@ -2805,17 +3386,37 @@ const getFileExtension = (file) => {
     }
     return (dots.pop() || '').toLowerCase();
 };
+/**
+ * Định dạng kích thước file dạng chuỗi dễ đọc (KB hoặc MB).
+ * @param size Kích thước file tính bằng byte
+ * @param toFixed Số chữ số thập phân (mặc định: 2)
+ * @returns Chuỗi định dạng (vd: " 1.50 MB", " 512.00 KB")
+ */
 const getLabelBySizeFile = (size, toFixed = 2) => {
     if (size < 1024 * 1024) {
         return ` ${(size / 1024).toFixed(toFixed)} KB`;
     }
     return ` ${(size / (1024 * 1024)).toFixed(toFixed)} MB`;
 };
+/**
+ * Chuyển đổi đối tượng Blob thành File.
+ * Tự động xác định phần mở rộng từ MIME type của Blob.
+ * @param blob Đối tượng Blob cần chuyển
+ * @param fileName Tên file mong muốn (mặc định: UUID ngẫu nhiên)
+ * @returns Đối tượng File tương ứng
+ */
 const convertBlobToFile = (blob, fileName) => {
     const type = blob.type.split('/')[1];
     const name = fileName ? `${fileName.split('.')[0]}.${type}` : `${uuid()}.${type}`;
     return new File([blob], name, { type: blob.type, lastModified: Date.now() });
 };
+/**
+ * Tải file từ URL và chuyển về đối tượng File.
+ * Sử dụng XHR + FileReader để đọc nội dung, sau đó chuyển Base64 → Blob → File.
+ * @param url URL của file cần tải
+ * @param fileName Tên file mong muốn (mặc định: timestamp)
+ * @returns Promise trả về File hoặc undefined nếu thất bại
+ */
 const convertUrlToFile = (url, fileName) => {
     return new Promise((resolve, reject) => {
         const xhr = new XMLHttpRequest();
@@ -2837,6 +3438,16 @@ const convertUrlToFile = (url, fileName) => {
     });
 };
 
+/**
+ * Highlight một từ khóa tìm kiếm bên trong chuỗi văn bản bằng cách bọc vào thẻ `<span>`.
+ * Hỗ trợ tìm kiếm không phân biệt dấu (Unicode-insensitive) và không phân biệt hoa/thường.
+ *
+ * @param value Chuỗi văn bản gốc cần highlight
+ * @param search Từ khóa cần tìm và highlight
+ * @param ignoreHighlight Nếu `true`, bỏ qua highlight và trả về chuỗi gốc
+ * @param classHightLight Class CSS áp dụng cho span highlight (mặc định: 'bg-[#19344a] text-white')
+ * @returns Chuỗi HTML đã được inject thẻ `<span>` quanh từ khóa
+ */
 const highlightByKeyword = (value, search, ignoreHighlight, classHightLight) => {
     if (!value) {
         return CHARACTER_DATA_EMPTY;
@@ -2877,6 +3488,14 @@ const getValueReplace = (search, value) => {
     }
     return Array.from(keys);
 };
+/**
+ * Chuẩn hóa chuỗi văn bản theo chuẩn Unicode NFC và áp dụng các tùy chọn format.
+ * Thường dùng để so sánh chuỗi nhất quán, không phụ thuộc vào cách gõ có dấu.
+ *
+ * @param text Chuỗi cần chuẩn hóa
+ * @param options Các tùy chọn transform (trim, removeEmoji, removeUnicode...)
+ * @returns Chuỗi đã chuẩn hóa
+ */
 const formatTextCompare = (text, options) => {
     if (!text) {
         return text;
@@ -2884,12 +3503,25 @@ const formatTextCompare = (text, options) => {
     text = text.normalize('NFC');
     return formatByOptions(text, options);
 };
+/**
+ * Định dạng họ tên đầy đủ: viết hoa chữ cái đầu mỗi từ, xóa khoảng trắng thừa và emoji.
+ * @param value Chuỗi họ tên cần format
+ * @returns Chuỗi đã được chuẩn hóa
+ * @example fullNameFormat('  nguyễn văn a  ') → 'Nguyễn Văn A'
+ */
 const fullNameFormat = (value) => {
     if (!value) {
         return value;
     }
     return capitalize(value, { lowercaseOtherCharacter: true, trim: true, removeMultipleSpace: true, removeEmoji: true });
 };
+/**
+ * Viết hoa chữ cái đầu tiên của mỗi từ trong chuỗi.
+ * @param text Chuỗi cần capitalize
+ * @param options Tùy chọn xử lý trước (lowercase, trim, removeEmoji...)
+ * @returns Chuỗi đã được capitalize theo từng từ
+ * @example capitalize('hello world') → 'Hello World'
+ */
 const capitalize = (text, options) => {
     if (!text) {
         return text;
@@ -2900,12 +3532,26 @@ const capitalize = (text, options) => {
         .map((word) => firstLetterToUpperCase(word))
         .join(' ');
 };
+/**
+ * Viết hoa chữ cái đầu tiên của chuỗi.
+ * @param text Chuỗi cần xử lý
+ * @param options Tùy chọn format bổ sung
+ * @returns Chuỗi với chữ cái đầu tiên được viết hoa
+ * @example firstLetterToUpperCase('hello') → 'Hello'
+ */
 const firstLetterToUpperCase = (text, options) => {
     if (!text) {
         return text;
     }
     return uppercaseByPosition(text, 0, options);
 };
+/**
+ * Viết hoa một ký tự tại vị trí bất kỳ trong chuỗi.
+ * @param text Chuỗi cần xử lý
+ * @param position Vị trí ký tự cần viết hoa (0-indexed)
+ * @param options Tùy chọn format bổ sung
+ * @returns Chuỗi với ký tự tại vị trí được viết hoa
+ */
 const uppercaseByPosition = (text, position, options) => {
     if (!text) {
         return text;
@@ -2938,12 +3584,25 @@ const formatByOptions = (text, options) => {
     }
     return text;
 };
+/**
+ * Escape các ký tự đặc biệt HTML thành HTML entities để tránh XSS.
+ * @param str Chuỗi cần escape
+ * @returns Chuỗi an toàn (& → &amp;, < → &lt;, > → &gt;, " → &quot;, ' → &#039;)
+ * @example escapeHtml('<script>') → '&lt;script&gt;'
+ */
 const escapeHtml = (str) => {
     if (!str || typeof str !== 'string') {
         return str;
     }
     return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#039;');
 };
+/**
+ * Giải mã chuỗi HTML entities về dạng ký tự gốc.
+ * Sử dụng thẻ textarea để giải mã an toàn, hỗ trợ multi-level encoding.
+ * @param str Chuỗi HTML encoded cần giải mã
+ * @returns Chuỗi gốc sau khi decode
+ * @example decodeEscapeHtml('&lt;b&gt;') → '<b>'
+ */
 const decodeEscapeHtml = (str) => {
     const htmlTag = document.createElement('textarea');
     htmlTag.innerHTML = str;
@@ -2958,9 +3617,15 @@ const decodeEscapeHtml = (str) => {
     }
     return str;
 };
+/**
+ * Xóa dấu tiếng Việt khỏi chuỗi, chuyển tất cả ký tự có dấu về dạng Latin cơ bản.
+ * Hỗ trợ cả chữ thường lẫn hoa.
+ * @param str Chuỗi tiếng Việt cần xóa dấu
+ * @returns Chuỗi đã xóa dấu (vd: 'Nguyễn Văn An' → 'Nguyen Van An')
+ */
 const deleteUnicode = (str) => {
     str = str.replace(/à|á|ạ|ả|ã|â|ầ|ấ|ậ|ẩ|ẫ|ă|ằ|ắ|ặ|ẳ|ẵ/g, 'a');
-    str = str.replace(/è|é|ẹ|ẻ|ẽ|ê|ề|ế|ệ|ể|ễ|ễ/g, 'e');
+    str = str.replace(/è|é|ẹ|ẻ|ẽ|ê|ề|ế|ệ|ể|ễ|ễ/g, 'e');
     str = str.replace(/ì|í|ị|ỉ|ĩ/g, 'i');
     str = str.replace(/ò|ó|ọ|ỏ|õ|ô|ồ|ố|ộ|ổ|ỗ|ơ|ờ|ớ|ợ|ở|ỡ/g, 'o');
     str = str.replace(/ù|ú|ụ|ủ|ũ|ư|ừ|ứ|ự|ử|ữ/g, 'u');
@@ -2977,6 +3642,13 @@ const deleteUnicode = (str) => {
     str = str.replace(/\u02C6|\u0306|\u031B/g, ''); // ˆ ̆ ̛  Â, Ê, Ă, Ơ, Ư
     return str.normalize('NFC');
 };
+/**
+ * Xóa tất cả emoji khỏi chuỗi văn bản.
+ * Sử dụng pattern regex từ `patternEmoji()` để nhận diện toàn bộ emoji Unicode.
+ * @param text Chuỗi cần xóa emoji
+ * @returns Chuỗi đã được xóa emoji
+ * @example removeEmoji('Hello 😀 World 🎉') → 'Hello  World '
+ */
 const removeEmoji = (text) => {
     if (!text || !text.trim()) {
         return text;
@@ -3199,12 +3871,24 @@ const createUniqueRandomIntGenerator = (min, max) => {
     };
 };
 
+/**
+ * Thêm tất cả phần tử trong mảng vào một Set
+ * @param setStore Đối tượng Set mục tiêu
+ * @param data Mảng các phần tử cần thêm
+ * @returns Set sau khi đã thêm dữ liệu
+ */
 const addArrayToSet = (setStore, data) => {
     for (const value of data) {
         setStore.add(value);
     }
     return setStore;
 };
+/**
+ * Chuyển đổi Set sang Array, có hỗ trợ mapping function
+ * @param data Đối tượng Set cần chuyển đổi
+ * @param functionMap Hàm mapping tùy chọn để biến đổi từng phần tử
+ * @returns Mảng kết quả
+ */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const convertSetToArray = (data, functionMap) => {
     if (functionMap) {
@@ -3214,9 +3898,11 @@ const convertSetToArray = (data, functionMap) => {
 };
 
 /**
- * Tính dung lượng (ước tính) của 1 object trong bộ nhớ (bytes, KB, MB)
- * @param obj - Bất kỳ kiểu dữ liệu nào (object, array, map, set, primitive,...)
- * @param formatted - Nếu true, trả về chuỗi có đơn vị (vd: "2.35 KB")
+ * Tính toán dung lượng (ước tính) của một đối tượng trong bộ nhớ.
+ * Hàm sử dụng JSON.stringify và Blob để tính toán kích thước thực tế theo byte.
+ *
+ * @param obj Đối tượng cần tính dung lượng (Object, Array, Primitive...)
+ * @returns Chuỗi mô tả dung lượng đã được format (ví dụ: "100 bytes", "2.50 KB", "1.20 MB"). Trả về "N/A" nếu không thể serialize.
  */
 const getObjectSize = (obj) => {
     try {
@@ -3236,6 +3922,15 @@ const getObjectSize = (obj) => {
     }
 };
 
+/**
+ * Chuẩn hóa một URL bằng cách loại bỏ các dấu gạch chéo kép (//) trong pathname.
+ *
+ * @param rawUrl - URL cần chuẩn hóa.
+ * @returns URL đã được chuẩn hóa dưới dạng chuỗi.
+ *
+ * @example
+ * normalizeUrl('https://example.com//path//to//file') // => 'https://example.com/path/to/file'
+ */
 const normalizeUrl = (rawUrl) => {
     const url = new URL(rawUrl);
     url.pathname = url.pathname.replace(/\/{2,}/g, '/');
@@ -3265,6 +3960,13 @@ const ignorePatterns = [
     /vite/,
     /node_modules/,
 ];
+/**
+ * Trả về danh sách tên các hàm trong stack trace hiện tại.
+ * Đã lọc bỏ các hàm nội bộ của Angular, RxJS, Zone.js và các thư viện hệ thống.
+ * Hữu ích cho việc logging hoặc debugging để biết source gọi đến function hiện tại.
+ *
+ * @returns {string[]} Mảng chứa tên các hàm theo thứ tự từ gốc đến ngọn (ngược callback stack).
+ */
 const traceStack = () => {
     const stack = new Error().stack;
     if (!stack)
@@ -3296,5 +3998,5 @@ const traceStack = () => {
  * Generated bundle index. Do not edit.
  */
 
-export { AudioExtList, CHARACTER_DATA_EMPTY, COMMUNICATE_MICRO_KEY_GET_ALL_MESSAGE, COMMUNICATE_MICRO_PREFIX_TYPE, DEFAULT_START_PAGE_0, DocumentExtList, ENCODE_URI_PATTERN, ERROR_MESSAGE_EMPTY_VALID, ERROR_MESSAGE_MAX_LENGTH, ERROR_MESSAGE_MAX_VALID, ERROR_MESSAGE_MIN_LENGTH, ERROR_MESSAGE_MIN_VALID, ERROR_MESSAGE_PATTEN_VALID, ExcelExtList, ImageExtList, LINK_IMAGE_ERROR_TOKEN_INJECT, PROCESS_BAR_STANDARD_CONFIG_DEFAULT_TOKEN_INJECT, PROCESS_BAR_STEPS_CONFIG_DEFAULT_TOKEN_INJECT, UtilsCache, UtilsCommunicateMicro, UtilsCommunicateMicroKeyGlobal, UtilsHttpParamsRequest, UtilsHttpParamsRequestInstance, UtilsKeyCodeConstant, UtilsLanguageConstants, UtilsUrlSearchParams, VideoExtList, addArrayToSet, base64Decode, base64Encode, capitalize, checkMouseOverInContainer, checkViewInScreen, cloneDeep, cloneIBoundingClientRect, colorContrastFromOrigin, colorStepContrastFromOrigin, convertBase64ToBlob, convertBlobToFile, convertFileToBase64, convertFileToBase64_ObjectUrl, convertObjectToSignal, convertSetToArray, convertSignalToObject, convertUrlToFile, createUniqueRandomIntGenerator, decodeEscapeHtml, decodeURI, decrypt, decrypt3rd, deleteUnicode, detectAndCleanNearWhiteColors, downloadFileByUrl, downloadFileByUrlUseXmlRequest, downloadImageFromELement, encodeURI, encrypt, encrypt3rd, endCodeUrl, escapeHtml, firstLetterToUpperCase, formatDate, formatNumber, formatTextCompare, fullNameFormat, generateInterface, get, getColorById, getDayjs, getDeviceInfo, getDocumentByString, getDragEventByElement, getEventNameHandleClick, getFileExtension, getKeyCacheByArrayObject, getLabelBySizeFile, getObjectSize, getSmartAxisScale, getViewport, groupBy, hasDangerousConstructorName, highlightByKeyword, isArray, isAsyncObject, isBrowserAPIObject, isBrowserGlobalObject, isBuiltInObject, isDOMObject, isDangerousObject, isDayjsObject, isDifferenceDay, isDifferenceMonth, isDifferenceYear, isEmbedFrame, isEmpty, isEqual, isFalsy, isFile, isFrameworkObject, isIncludeAudioExtList, isIncludeDocumentExtList, isIncludeImageExtList, isIncludeVideoExtList, isMap, isNearWhite, isNil, isRegExp, isReturnAsIsObject, isSafeToProcess, isSet, isSkippableObject, isSpecialObject, isTouchDevice, isTruthy, isTypeAudio, isTypeFile, isTypeImage, isTypeVideo, keyBy, listColorDefine, md5, normalizeUrl, omitBy, patterProtocolUrl, patternAccount, patternDomain, patternEmail, patternEmoji, patternEncodeUri, patternGetFieldByRuleFieldReplace, patternHostUrl, patternKey, patternMobilePhone, patternName, patternNameProfile, patternNameSpecial, patternNameUtf8, patternNumber, patternPem, patternPhone, patternRuleFieldReplace, patternTax, patternUrl, protectString, range, removeEmoji, revealString, rgbToHex, set, setCaretPosition, setDefaultTimeZone, setKeyCrypto, setKeyCrypto3rd, setPatternCheckTimeUTC, setStylesElement, traceStack, uniqBy, unwrapSignal, updateFunctionCheckEmbedFrame, updateFunctionFormatDate, updateFunctionXssFilter, uppercaseByPosition, uuid, viewDataNumberByLanguage, xssFilter };
+export { AudioExtList, CHARACTER_DATA_EMPTY, COMMUNICATE_MICRO_KEY_GET_ALL_MESSAGE, COMMUNICATE_MICRO_PREFIX_TYPE, DEFAULT_START_PAGE_0, DocumentExtList, ENCODE_URI_PATTERN, ERROR_MESSAGE_EMPTY_VALID, ERROR_MESSAGE_MAX_LENGTH, ERROR_MESSAGE_MAX_VALID, ERROR_MESSAGE_MIN_LENGTH, ERROR_MESSAGE_MIN_VALID, ERROR_MESSAGE_PATTEN_VALID, ExcelExtList, ImageExtList, LINK_IMAGE_ERROR_TOKEN_INJECT, PROCESS_BAR_STANDARD_CONFIG_DEFAULT_TOKEN_INJECT, PROCESS_BAR_STEPS_CONFIG_DEFAULT_TOKEN_INJECT, UtilsCache, UtilsCommunicateMicro, UtilsCommunicateMicroKeyGlobal, UtilsHttpParamsRequest, UtilsHttpParamsRequestInstance, UtilsKeyCodeConstant, UtilsLanguageConstants, UtilsUrlSearchParams, VideoExtList, addArrayToSet, base64Decode, base64Encode, capitalize, checkMouseOverInContainer, checkViewInScreen, cloneDeep, cloneIBoundingClientRect, colorContrastFromOrigin, colorStepContrastFromOrigin, convertBase64ToBlob, convertBlobToFile, convertFileToBase64, convertFileToBase64_ObjectUrl, convertObjectToSignal, convertSetToArray, convertSignalToObject, convertUrlToFile, createUniqueRandomIntGenerator, decodeEscapeHtml, decodeURI, decrypt, decrypt3rd, deleteUnicode, detectAndCleanNearWhiteColors, downloadFileByUrl, downloadFileByUrlUseXmlRequest, downloadImageFromELement, encodeURI, encrypt, encrypt3rd, endCodeUrl, escapeHtml, firstLetterToUpperCase, formatDate, formatNumber, formatTextCompare, fullNameFormat, generateInterface, get, getColorById, getDayjs, getDeviceInfo, getDocumentByString, getDragEventByElement, getEventNameHandleClick, getFileExtension, getKeyCacheByArrayObject, getLabelBySizeFile, getObjectSize, getSmartAxisScale, getViewport, groupBy, hasDangerousConstructorName, highlightByKeyword, isArray, isAsyncObject, isBrowserAPIObject, isBrowserGlobalObject, isBuiltInObject, isDOMObject, isDangerousObject, isDayjsObject, isDifferenceDay, isDifferenceMonth, isDifferenceYear, isEmbedFrame, isEmpty, isEqual, isFalsy, isFile, isFrameworkObject, isIncludeAudioExtList, isIncludeDocumentExtList, isIncludeImageExtList, isIncludeVideoExtList, isMap, isNearWhite, isNil, isPrimitiveType, isRegExp, isReturnAsIsObject, isSafeToProcess, isSet, isSkippableObject, isSpecialObject, isTouchDevice, isTruthy, isTypeAudio, isTypeFile, isTypeImage, isTypeVideo, keyBy, listColorDefine, md5, normalizeUrl, omitBy, patternAccount, patternDomain, patternEmail, patternEmoji, patternEncodeUri, patternGetFieldByRuleFieldReplace, patternHostUrl, patternKey, patternMobilePhone, patternName, patternNameProfile, patternNameSpecial, patternNameUtf8, patternNumber, patternPem, patternPhone, patternProtocolUrl, patternRuleFieldReplace, patternTax, patternUrl, protectString, range, removeEmoji, revealString, rgbToHex, set, setCaretPosition, setDefaultTimeZone, setKeyCrypto, setKeyCrypto3rd, setPatternCheckTimeUTC, setStylesElement, traceStack, uniqBy, unwrapSignal, updateFunctionCheckEmbedFrame, updateFunctionFormatDate, updateFunctionXssFilter, uppercaseByPosition, uuid, viewDataNumberByLanguage, xssFilter };
 //# sourceMappingURL=libs-ui-utils.mjs.map