cards-lite

Процедурные иллюстрации игральных карт в виде SVG-строки — раскладки по сиду, четырёхцветная колода в цветах бренда, пресеты покерных комбинаций и блэкджека, без зависимостей.

Доступно в: npm GitHub Сайт проекта

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.