# Week, huh ## What this builds A one-week calendar with a dry caption, as if the week itself were a character. The date is injectable, so tests freeze it. A frozen date must render the documented weekday and caption. A golden image is taken. The captions are original. This is a calendar toy, not a scheduler. Read `spekkr.inputs.json` first. `title` is above the week. `date` is the frozen day (the week is the one containing it, starting Monday). `voice` chooses the caption table. `caption` and `weekend` change the chrome. ## Out of scope - A live holiday API or a personal calendar account. - Network in the checks. - A booking or a reminder service. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Frozen dates - `2026-01-15` is a Thursday. The week is Monday 12 to Sunday 18 January 2026. The weekday labels match that. - The caption for that Thursday, `dry` voice, is the exact string in `fixtures/captions-dry.json`. A second date in the file (a Saturday) matches too. - The week starts on Monday, not Sunday, in this version. Accept when: both fixture dates show the documented weekday and caption, and the week bounds match. ### R2. Frames and files - Goldens: the week of 2026-01-15, a close caption, a weekend mark, and another fixture date. - One command runs the date table and writes the frames. No network. The clock is the frozen date, not wall time. Accept when: the command passes for both voices, and the frames match the goldens. ### R3. Inputs - The build reads `spekkr.inputs.json`. Settings label the UI, options turn features on or off, and a swap must be one of its choices. - A value outside a stated range, or a swap that is not one of its choices, is refused before the app starts its checks, with a message that names the key. Accept when: the default inputs render, an illegal swap is refused by name, and changing a visible setting (for example the title) shows up in a later check. ### R4. Checks and report - One command runs every acceptance check at the defaults and at the person's inputs, including golden frames where a requirement asks for them. - Checks do not need a network, a paid API, or physical hardware. Accept when: the command passes at the defaults, and a deliberately broken fixture or a wrong price fails it. ## Verification Frozen dates render the documented weekday and caption, including a mid-week day and a weekend day. A golden image is taken. The date is injected, not wall-clock today. No network and no personal calendar. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to pin a date, how to edit a caption, and how to run the checks.