Установка

Требования

• Один из Vue 3 (v3.4+), React (v18+), Svelte (v5.29+) или Angular (v21.2+)
• Node.js (v18+) или Bun

Пакеты

Пакет	Описание
urcolor	Только движок цвета, под именем без скоупа. Реэкспортирует @urcolor/core
@urcolor/core	Логика цвета и утилиты доступности
@urcolor/shared	Независимое от фреймворка поведение, WebGL-рендеринг и сэмплеры сетки, общее для всех биндингов
@urcolor/vue	Компоненты и composables для Vue 3
@urcolor/react	Компоненты и хуки для React
@urcolor/svelte	Компоненты Svelte 5 и хуки на рунах
@urcolor/angular	Директивы Angular и signal-хранилища
@urcolor/relative	Подключаемый синтаксис относительных цветов CSS Color 5
@urcolor/i18n	Многоязычные названия цветов и подписи каналов

Установка

Vue

bun

bun add @urcolor/vue

npm

npm install @urcolor/vue

pnpm

pnpm add @urcolor/vue

yarn

yarn add @urcolor/vue

React

bun

bun add @urcolor/react

npm

npm install @urcolor/react

pnpm

pnpm add @urcolor/react

yarn

yarn add @urcolor/react

Svelte

bun

bun add @urcolor/svelte

npm

npm install @urcolor/svelte

pnpm

pnpm add @urcolor/svelte

yarn

yarn add @urcolor/svelte

Angular

bun

bun add @urcolor/angular

npm

npm install @urcolor/angular

pnpm

pnpm add @urcolor/angular

yarn

yarn add @urcolor/angular

Каждый фреймворк-пакет зависит от @urcolor/core и @urcolor/shared, поэтому оба ставятся вместе с ним. Пакет для Vue дополнительно тянет Reka UI, пакет для React — Base UI; у пакетов для Svelte и Angular других рантайм-зависимостей нет.

Только ядро

Если нужны только утилиты работы с цветом, без привязки к фреймворку, поставьте urcolor — имя того же движка без скоупа:

bun

bun add urcolor

npm

npm install urcolor

pnpm

pnpm add urcolor

yarn

yarn add urcolor

import { Color } from "urcolor";

Собственного кода в urcolor нет: он реэкспортирует @urcolor/core и зависит от него в том же диапазоне версий, что и пакеты фреймворков, поэтому копия движка и класс Color в любом случае будут одни. Выбирайте имя, которое удобнее: @urcolor/core и так установлен вместе с любым фреймворк-пакетом, а смешивать оба имени в одном проекте безопасно.

Дополнительные пакеты

@urcolor/relative добавляет синтаксис относительных цветов CSS Color 5, а @urcolor/i18n — многоязычные названия цветов:

bun

bun add @urcolor/relative @urcolor/i18n

npm

npm install @urcolor/relative @urcolor/i18n

pnpm

pnpm add @urcolor/relative @urcolor/i18n

yarn

yarn add @urcolor/relative @urcolor/i18n