phx-node/dist/module/helpers-service/colorHelpers.service.d.ts

PHX NODE

export declare class PHXColorHelpers {
    /**
     * Chuẩn hóa mã màu hex về định dạng `#RRGGBB`.
     *
     * Nếu giá trị đầu vào rỗng, bẩn hoặc sai định dạng, hàm sẽ trả về màu fallback an toàn.
     *
     * @param {string} value Giá trị màu đầu vào.
     * @returns {string} Mã màu hex hợp lệ ở dạng in hoa.
     * @memberof PHXColorHelpers
     */
    normalizeHexColor(value: string): string;
    /**
     * Chuyển mã màu hex sang các thành phần màu RGB.
     *
     * Hàm sẽ tự chuẩn hóa màu đầu vào trước khi tách thành `r`, `g`, `b`.
     *
     * @param {string} hex Mã màu hex đầu vào.
     * @returns {{ r: number; g: number; b: number }} Object chứa 3 thành phần màu RGB.
     * @memberof PHXColorHelpers
     */
    hexToRgb(hex: string): {
        r: number;
        g: number;
        b: number;
    };
    /**
     * Làm nhạt màu hex đầu vào theo một tỉ lệ xác định.
     *
     * Giá trị `amount` được giới hạn trong khoảng từ `0` đến `1`:
     * - `0`: giữ nguyên màu gốc
     * - `1`: tiến hoàn toàn về màu trắng
     *
     * @param {string} hex Mã màu gốc.
     * @param {number} amount Tỉ lệ làm nhạt màu.
     * @returns {string} Mã màu hex sau khi làm nhạt.
     * @memberof PHXColorHelpers
     */
    tintHex(hex: string, amount: number): string;
    /**
     * Chuyển các thành phần màu RGB sang mã màu hex.
     *
     * Hàm này chỉ phục vụ nội bộ cho các phép biến đổi màu.
     *
     * @private
     * @param {number} r Giá trị kênh đỏ.
     * @param {number} g Giá trị kênh xanh lá.
     * @param {number} b Giá trị kênh xanh dương.
     * @returns {string} Mã màu hex tương ứng.
     * @memberof PHXColorHelpers
     */
    private rgbToHex;
}