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

package/file.d.ts

@@ -1,18 +1,71 @@
 import { IFile } from '@libs-ui/interfaces-types';
+/** Kiểm tra file có phải là ảnh không (image/*). */
 export declare const isTypeImage: (file: File | Blob) => boolean;
+/** Kiểm tra file có phải là video không (video/*). */
 export declare const isTypeVideo: (file: File | Blob) => boolean;
+/** Kiểm tra file có phải là audio không (audio/*). */
 export declare const isTypeAudio: (file: File | Blob) => boolean;
+/** Kiểm tra giá trị có phải là đối tượng File không. */
 export declare const isTypeFile: (file: File) => boolean;
+/** Danh sách extension/MIME type của file Excel. */
 export declare const ExcelExtList: string[];
+/** Danh sách extension/MIME type của tài liệu (Word, Excel, PDF, JSON...). */
 export declare const DocumentExtList: string[];
+/**
+ * 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)
+ */
 export declare const isIncludeDocumentExtList: (ext: string, listExt?: Array<string>) => boolean;
+/** Danh sách extension/MIME type của ảnh. */
 export declare const ImageExtList: string[];
+/**
+ * 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)
+ */
 export declare const isIncludeImageExtList: (ext: string, listExt?: Array<string>) => boolean;
+/** Danh sách extension/MIME type của video. */
 export declare const VideoExtList: string[];
+/**
+ * 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
+ */
 export declare const isIncludeVideoExtList: (ext: string, listExt?: Array<string>) => boolean;
+/** Danh sách extension/MIME type của audio. */
 export declare const AudioExtList: string[];
+/**
+ * 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
+ */
 export declare const isIncludeAudioExtList: (ext: string, listExt?: Array<string>) => boolean;
+/**
+ * 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
+ */
 export declare const getFileExtension: (file: IFile | File) => string | undefined;
+/**
+ * Đị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")
+ */
 export declare const getLabelBySizeFile: (size: number, toFixed?: number) => string;
+/**
+ * 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
+ */
 export declare const convertBlobToFile: (blob: Blob, fileName?: string) => File;
+/**
+ * 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
+ */
 export declare const convertUrlToFile: (url: string, fileName?: string) => Promise<File | undefined>;

package/format-number.d.ts

@@ -1,2 +1,30 @@
+/**
+ * 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"
+ */
 export declare const formatNumber: (value: string | number) => string;
-export declare const viewDataNumberByLanguage: (value: string | number, acceptNegativeValue: boolean | undefined, parseFixed?: number, ignoreFormatSeparator?: boolean, ignoreParseFloat?: boolean) => any;
+/**
+ * Đị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"
+ */
+export declare const viewDataNumberByLanguage: (value: string | number, acceptNegativeValue: boolean | undefined, parseFixed?: number, ignoreFormatSeparator?: boolean, ignoreParseFloat?: boolean, lang?: string) => any;

package/format-text.d.ts

@@ -1,11 +1,82 @@
 import { ITextFormatOptions } from '@libs-ui/interfaces-types';
+/**
+ * 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
+ */
 export declare const highlightByKeyword: (value: string | undefined, search: string | undefined, ignoreHighlight?: boolean, classHightLight?: string) => string;
+/**
+ * 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
+ */
 export declare const formatTextCompare: (text: string, options?: ITextFormatOptions) => string;
+/**
+ * Đị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'
+ */
 export declare const fullNameFormat: (value: string) => string;
+/**
+ * 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'
+ */
 export declare const capitalize: (text: string, options?: ITextFormatOptions) => string;
+/**
+ * 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'
+ */
 export declare const firstLetterToUpperCase: (text: string, options?: ITextFormatOptions) => string;
+/**
+ * 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
+ */
 export declare const uppercaseByPosition: (text: string, position: number, options?: ITextFormatOptions) => string;
+/**
+ * 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;'
+ */
 export declare const escapeHtml: (str: string) => string;
+/**
+ * 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>'
+ */
 export declare const decodeEscapeHtml: (str: string) => string;
+/**
+ * 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')
+ */
 export declare const deleteUnicode: (str: string) => string;
+/**
+ * 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 '
+ */
 export declare const removeEmoji: (text: string) => string;

package/function-check-embed-frame.d.ts

@@ -1,2 +1,24 @@
+/**
+ * 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);
+ */
 export declare const updateFunctionCheckEmbedFrame: (functionCustom: () => boolean) => void;
+/**
+ * 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ý
+ * }
+ */
 export declare const isEmbedFrame: () => boolean;

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@libs-ui/utils",
-  "version": "0.2.355-9",
+  "version": "0.2.356-0",
   "peerDependencies": {
     "@angular/common": ">=18.0.0",
     "@angular/core": ">=18.0.0",
     "crypto-es": "^2.1.0",
     "dayjs": "1.11.5",
-    "@libs-ui/interfaces-types": "0.2.355-9",
+    "@libs-ui/interfaces-types": "0.2.356-0",
     "rxjs": "~7.8.0"
   },
   "sideEffects": false,

package/pattern.d.ts

@@ -1,20 +1,100 @@
+/**
+ * Returns regex for email validation
+ * @returns {RegExp}
+ */
 export declare const patternEmail: () => RegExp;
-export declare const patterProtocolUrl: () => RegExp;
+/**
+ * Returns regex for protocol in URL (http, https, ftp)
+ * @returns {RegExp}
+ */
+export declare const patternProtocolUrl: () => RegExp;
+/**
+ * Returns regex for full URL validation
+ * @returns {RegExp}
+ */
 export declare const patternUrl: () => RegExp;
+/**
+ * Returns regex for host part of URL
+ * @returns {RegExp}
+ */
 export declare const patternHostUrl: () => RegExp;
+/**
+ * Returns regex for domain validation
+ * @returns {RegExp}
+ */
 export declare const patternDomain: () => RegExp;
+/**
+ * Returns regex for Vietnamese mobile phone validation
+ * @returns {RegExp}
+ */
 export declare const patternMobilePhone: () => RegExp;
+/**
+ * Returns regex for general phone number validation
+ * @returns {RegExp}
+ */
 export declare const patternPhone: () => RegExp;
+/**
+ * Returns regex for digits
+ * @returns {RegExp}
+ */
 export declare const patternNumber: () => RegExp;
+/**
+ * Returns regex for encoded URI characters
+ * @returns {RegExp}
+ */
 export declare const patternEncodeUri: () => RegExp;
+/**
+ * Returns regex for standard name (alphanumeric and spaces)
+ * @returns {RegExp}
+ */
 export declare const patternName: () => RegExp;
+/**
+ * Returns regex for UTF-8 name (including Vietnamese characters)
+ * @returns {RegExp}
+ */
 export declare const patternNameUtf8: () => RegExp;
+/**
+ * Returns regex for special characters in name
+ * @returns {RegExp}
+ */
 export declare const patternNameSpecial: () => RegExp;
+/**
+ * Returns regex for profile name
+ * @returns {RegExp}
+ */
 export declare const patternNameProfile: () => RegExp;
+/**
+ * Returns regex for emojis
+ * @returns {RegExp}
+ */
 export declare const patternEmoji: () => RegExp;
+/**
+ * Returns regex for matching field replacement markers (e.g. {{field}})
+ * @returns {RegExp}
+ */
 export declare const patternRuleFieldReplace: () => RegExp;
+/**
+ * Returns regex for extracting field name from replacement markers
+ * @returns {RegExp}
+ */
 export declare const patternGetFieldByRuleFieldReplace: () => RegExp;
+/**
+ * Returns regex for PEM format validation
+ * @returns {RegExp}
+ */
 export declare const patternPem: () => RegExp;
+/**
+ * Returns regex for tax ID validation
+ * @returns {RegExp}
+ */
 export declare const patternTax: () => RegExp;
+/**
+ * Returns regex for key validation (identical to tax regex)
+ * @returns {RegExp}
+ */
 export declare const patternKey: () => RegExp;
+/**
+ * Returns regex for account validation (must contain @)
+ * @returns {RegExp}
+ */
 export declare const patternAccount: () => RegExp;

package/trace.d.ts

@@ -1 +1,8 @@
+/**
+ * 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).
+ */
 export declare const traceStack: () => string[];

package/two-way-signal-object.d.ts

@@ -11,7 +11,20 @@
  * @returns Dữ liệu đã được chuyển đổi theo kiểu T
  */
 export declare const convertObjectToSignal: <T = any>(data: any, cloneDeepIfNotSignal?: boolean, isSignalPrimitiveType?: boolean, acceptConvertObjectInnerWritableSignal?: boolean, seen?: WeakMap<object, any>) => T;
+/**
+ * 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.
+ */
 export declare const convertSignalToObject: <T = any>(data: any, isCloneDeep?: boolean, seen?: WeakMap<object, any>, options?: {
     convertWhenFirstItemArrayNotIsSignal?: boolean;
 }) => T;
+/**
+ * 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.
+ */
 export declare const unwrapSignal: (data: any) => any;

package/uri.d.ts

@@ -1,5 +1,25 @@
 import { TYPE_OBJECT } from '@libs-ui/interfaces-types';
 export declare const ENCODE_URI_PATTERN: RegExp;
+/**
+ * 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ã.
+ */
 export declare const decodeURI: (value: string) => string;
+/**
+ * Mã hóa chuỗi URI.
+ *
+ * @param value Chuỗi cần mã hóa.
+ * @returns Chuỗi đã được mã hóa.
+ */
 export declare const encodeURI: (value: string) => string;
+/**
+ * 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.
+ */
 export declare const endCodeUrl: (params: TYPE_OBJECT, isBody: boolean) => string;

package/url-search-params.d.ts

@@ -1,25 +1,92 @@
+/**
+ * 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ố.
+ */
 export declare class UtilsUrlSearchParams {
     private static instance;
     private 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: string);
+    /**
+     * Lấy instance duy nhất (Singleton) của UtilsUrlSearchParams.
+     * @returns {UtilsUrlSearchParams} Instance của lớp.
+     */
     static getInstance(): UtilsUrlSearchParams;
+    /**
+     * 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: {
         [key in string]: string;
     }): string;
+    /**
+     * 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: Array<{
         key: string;
         value: string;
     }>): string;
+    /**
+     * 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ả.
+     */
     private buildParams;
+    /**
+     * 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: string, value: string): void;
+    /**
+     * 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: string): string | undefined;
+    /**
+     * 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: string): boolean;
+    /**
+     * Xóa một tham số khỏi danh sách.
+     * @param key Tên tham số cần xóa.
+     */
     delete(key: string): void;
+    /**
+     * @returns {number} Số lượng tham số hiện có.
+     */
     length(): number;
+    /**
+     * 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?: Array<{
         key: string;
         value: string;
     }>): string;
+    /**
+     * 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(): Record<string, string>;
+    /**
+     * 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: string, param2: string): boolean;
 }

package/url.d.ts

@@ -1 +1,10 @@
+/**
+ * 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'
+ */
 export declare const normalizeUrl: (rawUrl: string) => string;

package/uuid.d.ts

@@ -1 +1,7 @@
+/**
+ * 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).
+ */
 export declare const uuid: () => string;

package/xss-filter.d.ts

@@ -1,3 +1,16 @@
 export type TYPE_FUNCTION_XSS = (data: string) => Promise<string>;
+/**
+ * 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.
+ */
 export declare const updateFunctionXssFilter: (functionCustom: TYPE_FUNCTION_XSS) => void;
+/**
+ * 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.
+ */
 export declare const xssFilter: TYPE_FUNCTION_XSS;