# 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. ## Neighbour facing A tile's edge `e` faces a neighbour's edge `(e + 3) modulo 6`. Axial coordinates and the six neighbour deltas are in `fixtures/hex-math.json`. ## Levels `packs/intro.json` holds H0 (unsolved start of the first puzzle) and H1–H8 with solutions in `fixtures/hex-solutions/`. `full` adds H9–H40. H1's solution is the authority for the solved frame. ## Screenshot tolerance 8 levels, 98% of pixels, 1600 by 1000. ## Inputs | Key | Label | Default | Notes | | --- | --- | --- | --- | | `title` | Title | Turn until it flows | Shown above the board. | | `size` | Board radius | 3 | A hex radius from 2 to 5, in tiles, not counting the centre. | | `flow` | Show flow | on | Connected pipes fill with a colour once the network is solved. | | `hints` | Mark a wrong tile | off | A control marks one tile that is not in a documented solution orientation. | | `pack` | Level pack | intro | intro is eight levels. full is forty. | ## 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 | | --- | --- | | `fixtures/hex-math.json` | A shipped fixture. The build may move it, but then `design.md` must name the new path. | | `packs/intro.json` | 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` | A size-3 hex pipes mid-solve, source and sink marked, some tiles already flowing. | ## 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. Rotation mechanics and hex neighbour facing are unit-tested. A known solved grid is connected from source to sink; a known unsolved one is not. Every intro level ships a solution the checker accepts. A golden board screenshot is checked. No network.