Установка
Требования
Требуется Node.js 18+. Никаких runtime- или peer-зависимостей — пакет полностью независим от фреймворков и работает в любом JS/TS-окружении (браузер, Node, edge-рантаймы).
Установка
bash
npm install color-value-toolsБыстрый старт
ts
import {
normalizeColor,
mixColors,
lighten,
darken,
saturate,
complement,
triadic,
wcagLevel,
bestTextColor,
colorDeltaE,
randomColor,
} from 'color-value-tools'
// Разобрать любой формат цвета
normalizeColor('#3498db')
// { type: 'hex', hex: '#3498db', r: 52, g: 152, b: 219, a: 1, h: 204, s: 70, l: 53, v: 86 }
// Изменить
lighten('#3498db', 15) // '#74b9e7'
darken('#3498db', 15) // '#1d6ea5'
saturate('#3498db', 20) // '#1b9df3'
// Гармонии
complement('#3498db') // '#db7633'
triadic('#3498db') // ['#3498db', '#db3398', '#98db33']
// WCAG-доступность
wcagLevel('#ffffff', '#3498db') // 'AA-large'
bestTextColor('#3498db') // '#000000'
// Перцептивное расстояние (CIEDE2000)
colorDeltaE('#ff0000', '#fe0000') // 0.2079
// Случайный цвет в диапазоне оттенка/насыщенности
randomColor({ hRange: [200, 260], sRange: [60, 80] })CommonJS:
js
const { normalizeColor, mixColors } = require('color-value-tools')