Log inGet started
World

First Light: Goura

Branchmain
Branchesmain
Commite917faa950

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.

BuilderWhat 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.