# Hand whiteboard ## What this builds An infinite canvas for boxes, rough lines, arrows, and text, in the spirit of a hand-drawn whiteboard. The lines are imperfect, but a seed makes the roughness repeatable. A fixture scene must round-trip through the file format. Create, move, arrow, and export are tested. This is an original tool, not a copy of someone else's board, and it does not use their file format as a required input. Read `spekkr.inputs.json` first. `title` is on an empty board. `roughness` and a seed (fixed in tests) shape the lines. `export` chooses the file format. `grid` and `arrows` change the chrome and whether arrow heads exist. ## Out of scope - A live multiplayer room in the checks (a later hook may add it). - Someone else's file format as a required import. - Network or a cloud document in the checks. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Create, move, arrow - A box, a line, a text, and (if `arrows` is on) an arrow can be created with documented default sizes. - A move of a box by (dx, dy) moves it, and any arrow attached to it keeps its attachment. - The fixture script `fixtures/board-ops.json` ends in the scene in `fixtures/board-scene.json`. Accept when: the scripted operations produce the scene file, including the attached arrow. ### R2. Round-trip and export - The json file of the fixture scene, loaded into a fresh board, produces the same scene (ids may be stable as in the file). - An svg export, when that format is on, contains a path or a line for every stroke, and a text for every text, and is well-formed XML. - A golden canvas shot of the loaded fixture, seed 4, roughness 0.8, matches `fixture-scene`. Accept when: the json round-trips, the svg parses and lists the stated elements, and the golden matches. ### R3. Files - One command runs the operations, the round-trip, the svg parse, and writes the four screenshots. No network. Roughness uses seed 4. Accept when: the command passes for every export format. ### 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 Create, move, arrow, and export are tested with a script that reaches a documented scene. That scene round-trips through the json format, and an svg export parses. A golden canvas shot is taken with a pinned roughness seed. No network and no third-party file format requirement. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to draw, how to export, and how to run the checks.