# Fantasy map ## What this builds A map generator you can tweak: height, sea level, erosion, biomes, and optional names. A seed makes the world deterministic. Tests hash the landmask, and they look up the biome at documented cells. The pipeline is original, and the names are from a small shipped lexicon, not a live model. Read `spekkr.inputs.json` first. `title` sits in the margin. `seed` and `size` pin the world. `climate` chooses the biome table. `names` and `explain` change the chrome. ## Out of scope - A live language model for names. - A real-Earth projection or copyrighted cartography. - Network or a public map gallery in the checks. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Determinism - The same seed, size and climate produce the same height field and the same landmask. - The landmask of seed 19, size 256, sea level 0.42, is hashed in `fixtures/map-19.sha256`. - A second run must match that hash. Accept when: the landmask hash matches the file twice in a row. ### R2. Biomes and names - Biome at a cell is a function of height, moisture and `climate`, as in the table in `design.md`. - Cells listed in `fixtures/map-19-biomes.json` must have the stated biome. - If `names` is on, the set of names (not their pixel positions) is the list in the sibling file, from the shipped lexicon only. Accept when: every listed cell has the stated biome, and the name set matches when the option is on. ### R3. Frames and files - Goldens at height-only, after coasts, after biomes, and with names, all seed 19, temperate, 256. - One command runs the hash, biome, and name tests, and writes the frames. No network. Accept when: the command passes at size 128 and 256, for every climate (each climate has its own biome fixture). ### R4. 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. ## Verification A seeded world is deterministic: the landmask hash matches a shipped file, and biomes at documented cells match a fixture. Golden map images are taken at four pipeline stages. Names come from a shipped lexicon, not a live model. No network. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to generate a map, how to change a biome table, and how to run the checks.