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.