cards-lite рисует игральные карты кодом. Один вызов возвращает SVG-строку — в Node во время сборки или в браузере, — поэтому статический сайт получает hero-иллюстрацию без единого скрипта на странице. Это небольшая библиотека, которая строит процедурные иллюстрации игральных карт: seed задаёт раскладку, рубашки и эмблемы фигур, brand — цвета. Без зависимостей, 8.7 KB в gzip.
Что она рисует
- Раскладки — веер, ряд, каскад, стопка, ворох и пара для блэкджека, заливкой или линиями. Веер и каскад карт, как и любая раскладка с перекрытием, оставляют открытым индекс в левом верхнем углу каждой карты;
pileиstack— намеренные исключения: спрятать то, что лежит снизу, и есть их мотив. - Одна карта или вся колода —
Cards.card()рисует одну карту в рамке 5:7,Cards.deck()— все 52 лица на одном листе. - Именованные руки — пресеты покерных комбинаций и блэкджека: от
royal-flushдоhigh-card, плюсblackjackиdouble-down. Пресет — это данные, а не оценщик: библиотека умеет собрать фулл-хаус, но никогда не распознаёт его. - Рубашки и фигуры — рубашки покрыты треугольной, шестиугольной или восьмиугольной решёткой из соседних библиотек; на фигурных картах вместо персонажа — геометрическая эмблема по сиду.
Как подключить
Установка — npm install cards-lite. Обычный <script> получает глобальный Cards, Node и сборщики — module.exports. Во время сборки Cards.hand({ seed: 'example.com', brand: '#7c5cff' }) возвращает разметку для вставки на страницу; в браузере Cards.init('#hero-art', { seed: 42, preset: 'royal-flush', motion: 'deal' }) рисует в элемент, а set() перерисовывает его с новыми параметрами. У SVG есть viewBox, но нет собственного размера — его задаёт CSS. Сид может быть строкой (подойдёт доменное имя) или числом: у каждой страницы своя рука, а один и тот же сид всегда даёт одни и те же байты.
Цвет и параметры
Вы передаёте от одного до трёх цветов бренда, и получается четырёхцветная колода в цветах бренда: червы, бубны и трефы берут оттенки бренда, пики остаются чёрными, а лицо карты — бумажным в обеих темах: карта с лицом цвета бренда перестаёт читаться как карта. Любую роль можно закрепить любым CSS-цветом, включая custom property, — так встроенная рука следует за переключателем светлой и тёмной темы без скрипта. Cards.palette() возвращает вычисленные цвета, чтобы использовать их на странице.
title даёт картинке доступное имя; без него SVG помечен aria-hidden. motion: 'deal' добавляет однократную CSS-раздачу; при prefers-reduced-motion: reduce каждая карта просто остаётся на своём месте.
Лицензия и стабильность
Для одного сида и набора параметров вывод побайтово одинаков, а сид не зависит от бренда: смените цвета — ни одна карта не сдвинется. В пределах минорной версии вывод не меняется; любое его изменение — минорный релиз со строкой в changelog, поэтому при рендере во время сборки фиксируйте точную версию. Вывод нигде не называет библиотеку — каждый id, класс и keyframe является токеном по сиду. Лицензия MIT, автор — 301ST, для spintax.net.