# Design This file fixes the parts that are easy to get wrong. The language and tools are up to you, as long as the numbers here hold. ## Colouring For each letter of the guess, left to right: if it matches the secret in that position, mark `exact`. Else if that letter still has unmatched occurrences in the secret (not already consumed by `exact` or earlier `present` marks), mark `present`. Else `absent`. The machine-checked colouring cases, including double letters, are `fixtures/colouring.json`. Tests compare to that file, not to a re-typed example. ## Fixture run (standard list, day 2026-01-15, hard off) The eleven guesses are `fixtures/run-2026-01-15.txt`, one word per line. After the eleventh, no unused consistent word remains. The share file is the authority for the card. Marks in the share text: `exact` is `#`, `present` is `o`, `absent` is `.`. ## Screenshot tolerance 8 levels, 98% of pixels. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Title | Last as long as you can | Shown above the grid. | | `day` | Puzzle day | 2026-01-15 | A calendar date. The checks use this fixture day, never 'today' alone. | | `hard` | Hard notes | off | A later guess must reuse every hint already given, in the anti-word sense described in design.md. | | `keyboard` | On-screen keyboard | on | Letter keys that pick up the hint colours. | | `list` | Word list | standard | standard is the full original list. short is a 200-word fixture list for faster tests. | ## Acceptance at the defaults The numbers, names and fixture paths already in this file are the authority. Where a later table or a shipped fixture file disagrees with prose, the table or the fixture wins. | Fixture | Role | | --- | --- | | `design.md` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/colouring.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/day-2026-01-15.txt` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/run-2026-01-15.txt` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `fixtures/share-2026-01-15.txt` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `spekkr.inputs.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | Golden frames are compared at 1400 by 1000 CSS pixels unless a requirement names another size. Tolerance, unless a tighter figure is given above: 8 levels, 98% of pixels, with motion, cursors and clocks frozen as this file says. A build's goldens are of that build; they do not have to match a shipped reference preview pixel-for-pixel if the tool or the type is different, but they do have to match this file's layout, counts and copy. ## Screenshots These pictures are headless-Chrome captures of the working reference in `reference/preview.html`, at the default inputs. They are not drawings of a product that has not been built. The first picture is the one Spekkr shows on the spec's card. A build may ship its own goldens; those goldens are of that build and do not have to match these frames pixel-for-pixel. | File | What it shows | | --- | --- | | `shots/board.png` | Guess four of a daily five-letter, played to last as long as possible. | ## How to verify 1. Run the checks at the default inputs, without a network. 2. Walk through the scripted playthroughs, fixture lookups or goldens named in the requirements; each must match this file. 3. Repeat once at the person's inputs when they differ from the defaults. 4. Colouring and dictionary tests cover exact, present, absent, and double letters. A known puzzle day is a fixture, never wall-clock 'today'. A scripted run lasts the documented number of guesses, and its share text matches a file byte for byte. The word lists are original. No network.