# hollow <!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. --> TODO: describe this module.

# hud What is on the glass while the crypt is being fought through, built as one tree from the metrics and a view of `Hollow.state`. Stacked down the screen, because the filmed frame is portrait: | Where | What | |---|---| | under the top edge | the Bellwarden's bar, with the two phase marks cut into it, while `Hollow.state.boss.engaged` | | below that | the chamber's name, announced when one is entered and fading out | | above the instruments | the caption band — the speaker and the written form of whatever `Hollow.say` just spoke — and the pickup toast | | across the bottom | the health orb, the three ability pips, and the flasks / gold / relic slots | ```lua local Hud = require("presentation.hud") ui.updateScreen("hollow.hud", Hud.build(T.metrics(touch), view)) ``` Two things it deliberately does not do. It carries **no `animation`**: its tree is rebuilt every frame, and a keyframe animation on a node re-declared each frame has nothing stable to run against — what moves here moves because a number moved, and the fades are computed as opacities from the slice's own clock. And its `chrome` flag is false during the opening, when the only thing on the glass should be what is being said.

# cards The five full-screen cards of HOLLOWBELL: the title, the how-to-play handbill, the pause card, and the two endings. A card is a pure function of three things — the metrics, the focused row and the device in the player's hand — so the same three always draw the same picture. Every row it draws carries `onClick`, which is what a mouse click and a finger tap fire; the focus ring says which row a pad's Confirm would fire. ```lua local Cards = require("presentation.cards") local ctx = { m = T.metrics(touch), focus = Focus.id(), surface = "gamepad", pad = padLabel, anim = true } ui.updateScreen("hollow.card", Cards.title(ctx)) ``` | Call | Rows | Notes | |---|---|---| | `title(ctx)` | `play`, `howto` | The bell hangs over the wordmark and sways on its own clock. | | `howto(ctx)` | `back` | Names each control **for the device in hand** — `ctx.surface` picks the column, and `ctx.pad` resolves a pad button to the glyph that pad prints. | | `pause(ctx)` | `resume`, `restart`, `quit` | Carries the run so far. | | `death(ctx)` / `victory(ctx)` | `restart`, `quit` | Each shows the written form of the line spoken over it, so the line survives a muted player or a failed generation. | `ctx.anim` is true on the build a card OPENS with and false on every rebuild after it: re-declaring a keyframe animation on a node restarts it, so the entrance rides the opening build alone and the rows settle where they land.

# lamplighter The Lamplighter's hands: move, strike, cleave, flare, flask, pause. Composes with nothing else; a card stands it down through the menu map.

# theme The look of every HOLLOWBELL screen, and the numbers it lays out by. Two things live here: - **The palette and the type ramp** — wet-stone ink, bone, parchment, ember, verdigris, blood and gold, plus the two bundled font families the game sets in (`anton` for display, `ebgaramond` for anything read as a sentence). No host-OS font is named, so the browser build draws what the native one draws. - **`metrics()`** — the proportions of the screen as it is *right now*. It reads `ui.screenSize()` on every call and returns `w`, `h`, the unit `u` (which tracks the short edge), the paddings, the card measure, the type sizes and the bottom inset the engine's touch overlay needs. Nothing in the slice writes a pixel position chosen for one shape. ```lua local T = require("presentation.theme") local m = T.metrics(surfaceClass == "touch") { type = "vertical", style = T.panelStyle(m), children = { T.menuRow(m, "resume", "Resume", nil, focused, true), } } ``` Also here: `label` / `paragraph` / `capsStyle` for type, `cardBackdrop` and `panelStyle` for card chrome, `menuRow` for a focusable choice, and `riseIn` / `emberPulse` for motion.

# menu Card navigation while a screen is up: title, how-to-play, pause, death, victory. Stands the player group down.

# attack The 'Strike' control.

# cleave The 'Cleave' control.

# flare The 'Flare' control.

# flask The 'Flask' control.

# move The 'Move' control.

# pause The 'Pause' control.

# back The 'Back' control.

# confirm The 'Confirm' control.

# navigate The 'Navigate' control.