dice-lite

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

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

dice-lite рисует кодом бросок кубиков на столе. Один вызов возвращает SVG-строку — в Node во время сборки или в браузере, — поэтому статический сайт получает иллюстрацию без единого скрипта на странице: например, игральные кости для hero-блока. Пространство вариантов задают две ручки: seed бросает кубики (сколько их, где они лежат, что показывают), brand красит стол. Это процедурный бросок кубиков в SVG без зависимостей, около 9 KB после минификации и gzip.

Что она рисует

  • Настоящие кубы — каждый кубик — скруглённый куб, спроецированный из собственной ориентации по сиду: три видимые грани, точно спроецированные точки, противоположные грани в сумме дают семь по построению, все углы граней скруглены.
  • Два материала — paper, классический белый кубик, или glass: кубики из матового стекла, сквозь которые видны соседние.
  • От двух до пяти кубиков — dice добавляет кубики, не сдвигая те, что уже брошены.
  • Именованные результаты — lucky7, snake, boxcars, matched, mixed. Результат вроде «счастливой семёрки» только расставляет значения; ничего не подсчитывается. values закрепляет точные верхние грани.
  • Один кубик как иконка — Dice.die({ value: 5 }).

Как подключить

Установка — npm install @spintax/dice-lite. Один ES5-файл работает как CommonJS, как ESM-импорт по умолчанию и как обычный <script> (глобальный Dice); типы — в dice.d.ts. Во время сборки Dice.toss({ seed: 'hero' }) возвращает разметку для вставки; в браузере Dice.init('#hero', { seed: 'spintax.net' }) рисует в элемент, а set() перерисовывает его. motion: 'roll' добавляет однократное «оседание» кубиков с учётом prefers-reduced-motion. Одинаковые сид и параметры всегда дают одинаковые байты.

Стол

Цвета бренда превращаются в стол — это палитра стола в цветах бренда: первый хроматический цвет становится сукном, цвет золотистого тона окрашивает латунную отделку, а точки на кубиках остаются почти чёрными при любом бренде. Край стола по умолчанию — тёмная окантовка; rail: 'brand', 'felt' или любой цвет меняют её. При theme: 'light' стол по умолчанию рисуется линиями, потому что залитое сукно на белой странице превращается в пастельное пятно. Если закрепить felt и rail как 'transparent', останется только решётка, сквозь которую видна страница. В картинке нет фиксированных путей: каждая координата вычисляется из сида. Dice.palette() возвращает вычисленные цвета.

Лицензия и стабильность

MIT. Версия — это контракт: в пределах минорной версии одинаковые сид и параметры дают одинаковые байты, а любое изменение вывода — минорный релиз с записью в changelog. Сделано в 301 для spintax.net.