@open-slot-ui/core

The headless core of open-ui — a biased, themeable UI library for slot games. This package is the M + C: all state, logic, layout and theming, with zero runtime dependencies. It renders nothing on its own; pair it with a view binding such as @open-slot-ui/pixi.

pnpm add @open-slot-ui/core

What's inside

• Signal — a tiny observable value (the reactive primitive everything is built on).
• Control state-machines — every button/toggle/value is an FSM; interactability is derived from state, never a stored boolean.
• OpenUI façade — the narrow, typed surface a host talks to (ui.spin.busy(), ui.balance.set(…), ui.bus.on(…), ui.setLocale(…)).
• Theme tokens — semantic design tokens with safe fallbacks (default, midnight, neon, light). A bad token degrades, never throws.
• Layout — anchor + offset + scale (+ rotation) resolved against a reference resolution, with per-device responsive overrides.
• UISpec — one typed, string-literal config object validated without ever throwing (a bad value is reported and ignored — see the never-reject boundary in the Charter).
• Introspection — window.__OPENUI__ reports every control's state, interactability and bounds, so end-to-end tests never read a pixel.
• BlockSpec — the 36-kind vocabulary the info window's rules, paytable and settings are written in (headings, tables, symbol tables, reel grids, tabs, accordions, columns, meters, timelines, galleries…). parseBlocks reads the same tree from XML or JSON, renderBlocksHtml + BLOCK_CSS render it, validateSpec checks it and auditRules proves it actually explains every declared game mode.

Usage

You normally don't construct core directly — a renderer like @open-slot-ui/pixi builds it from your UISpec via mountHud. Reach for @open-slot-ui/core directly when you're writing your own renderer (DOM, Canvas, another engine) against the same headless model.

import { OpenUI, defaultTheme } from '@open-slot-ui/core';

See the main README and the Charter for the full doctrine.

License

MIT © schmooky and the open-ui contributors.