First Light: Goura
README.md
flscr
Every authored screen of First Light: Goura, as a widget tree.
local Scr = require("game.screens.flscr")
Each builder is pure: it takes the view model Screens.component assembles
and returns a tree. It registers nothing, shows nothing and reads no game
state, so a card can be built, measured and looked at without a run.
| Builder | What it draws |
|---|---|
Scr.title(vm) | The crest mark, the name, the narrated opening line as text, Begin / How to play. |
Scr.howto(vm) | The four actions with keyboard, pad and touch prompts side by side, and the failance rule. |
Scr.paused(vm) | The run held where it stands, with the ledger and Resume / Start over / Title. |
Scr.ending(vm) | The lane at dawn, the headline, the line, the ledger, Again / Title. vm.won picks the warm resolution or the cold one. |
Scr.hud(vm) | The play HUD: the light rising, how far up the lane she is, the six calls, the three failances. |
Scr.top(vm) | The band above the play: the open answer window and whatever is being said, stacked. |
Scr.alert(vm) | The full-frame pulse and word for the moment the eagle sees her. |
Scr.ledgerStrip(l, w) | Answered / failance / up the lane, as three figures. Shared by the pause card and both end cards. |
Scr.crest() Scr.horizon(w) Scr.callMark(s) Scr.failMark(b) | The art, as SVG strings. |
Scr.padLabel(button) | A pad button's printed legend, resolved against whatever pad is connected. |
Scr.forShape(w, h, build) | Build a tree as it would stand on a screen of a given shape. |
How it lays out
Three families carry the typography, each with one job: Anton for the game's name and the headlines, EB Garamond for everything a player reads as prose, Berkeley Mono for the digits that must not jitter as they count.
Every length is a fraction of the LIVE screen's short side, and then a
card's whole scale is trimmed until it stands inside the screen's height.
A dense card keeps its full size in a 3:4 portrait frame; the same card on a
wide monitor, where the short side is the height, comes down proportionally
rather than running off the bottom. Scr.forShape(w, h, build) states a screen
other than the live one, which is how a card is checked at a second shape on an
engine running at one.
The HUD is held clear of the touch overlay: the overlay claims the lower-left stick region below 40% of the screen height, and the right-edge button band below 45% of it, so the HUD is a narrow strip in the top-left corner sized to end above both. Its three columns are named by marks rather than words for the same reason — a centred call band has to pass beside it in a portrait frame.
Consumed by
Screens.component, which holds the state, the focus ring and the input.