# Hand
The fanned hand of cards shared by the match HUD and the off-ice events: arcs and overlaps the cards to the width given, hover lift, number-key hints, NEED ENERGY strip on unaffordable cards, click-to-play and drag payloads (`hand|<index>`). `Hand.needsTarget` / `Hand.defaultTarget` decide when a card needs a line slot (equipment, or a skater with the line full).
# Card
The signature card face of card_designs.png as a widget tree: kind-coloured enamel frame (`Core.KIND_COLOR` family: crimson player, orange action, steel equipment, gold buff, purple business, cyan goalie), gold-foil rim with frosted edge, cyan hex cost gem, rarity gem, kind tab, illustration, name banner, SKATE/SHOT/DEF hex pips and position for players, rules text and kind emblem. Options cover hover lift, selection glow, dimming, locked overlay, badges, drag payload and entrance. Also `Card.mini` roster tiles for the hub. Used by the hand, collection, reward, shop, deck viewer and title.
# Theme
The shared look of every ROGUE ICE screen: palette (from `game.Core`), Anton / Archivo Black / Bricolage Grotesque type helpers, navy-glass panels with gold-foil trim, foil buttons and the big END SHIFT style button, hex cost gems, rarity gems, segmented and glossy meters, stat tiles, entrance / idle animation presets and a vector icon set (skate, shield, puck, money, fans, hype, intents, trophy, lock…). Every builder returns a plain widget node. Required by every module in `game.ui`.
# Core
The shared contract of ROGUE ICE, a hockey roguelite deckbuilder. Every part of the game requires `game.Core` and talks to the others only through it.
- **Constants**: `PALETTE`, `FONTS`, `KIND_COLOR`, `RARITY_COLOR`, `HOME` (Frostbite HC), `RINK` dimensions, `ZONE_X` (puck lane to world X), `ANCHORS` (scene entity names), `SHOTS` (named camera poses), `SETS` (where the office set sits), `PHASES`, `MATCH_STEPS`, `COMMANDS`, `EVENTS`, `RULES`, `EVENT_TYPES`, `NODE_TYPES`, `CARDS` (+ `Core.card(id)`), `GOALIES`, `TEAMS` (+ `Core.team(id)`), `SPONSORS`, `ACHIEVEMENTS`, `ART_DIRECTION`.
- **State**: `Core.state()` is the live game; `game.rules.Director` is its only writer and calls `Core.touch()` (bumps `state.version`) after each change. `Core.reset()` restores a fresh state in place.
- **Bus**: `Core.on(name, fn, tag?)`, `Core.off(name, tag)`, `Core.offAll(tag)`, `Core.emit(name, payload)`, `Core.cmd(name, payload)` (= emit `"cmd."..name`). Tagged subscriptions replace themselves, so reloaded components never double-subscribe.
- **Live positions**: `Core.live.puck`, `Core.live.skaters`, `Core.live.focus`, written by the 3D match presentation.
- **Random**: `Core.seed(n)`, `Core.random()`, `Core.randomIndex(n)`, `Core.shuffle(list)` — one seeded stream per run.
- **Helpers**: `Core.rgba(hex, a)`, `Core.rgb(hex)`, `Core.money(n)`, `Core.compact(n)`.
The full contract (state shape, who writes what) is `/zero/source/design/spec.md`.
# Art
Maps art keys to the generated illustrations in `/zero/source/game/art/`: card art (`Core.CARDS[i].art`), goalies, team crests (`crest_<teamId>`, `crest_frostbite`), season-map node icons (`icon_<nodeType>`), the logo (`logo_cut` keyed out of `logo`) and event backdrops / monitor feeds. Returns the texture path, or nil when an illustration has not been generated. Used by `game.ui.Card`, `Hub`, `Match`, `Event`.