Skip to content

Установка

Требования

Требуется 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')