# Lisp sculpt ## What this builds A studio where a small language and a few sliders describe a 3D form, rendered live. The language is a tiny Lisp (or a prefix form of the same tree) with math and a handful of signed-distance primitives. Fixture programs produce a golden render. When the mesh option is on, the extracted isosurface is watertight. The language and the fixtures are original. Read `spekkr.inputs.json` first. `title` labels the editor. `language` is the spelling. `resolution` is the extract grid. `mesh` and `sliders` change what is written and shown. ## Out of scope - A general programming environment or a package manager. - Network or a public sketch gallery in the checks. - A physically printed sculpture in the checks. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Fixture programs - `fixtures/orb.lisp` and `fixtures/twist.lisp` (and prefix twins if that language is on) render at the default camera to the goldens `orb-fixture` and `twisted-fixture`. - A slider listed in a program, set to a documented value, changes a measure of the field or the mesh (for example the orb's bounding radius) to the value in `fixtures/sculpt-measures.json`, within 0.02 units. Accept when: both fixture renders match the goldens, and the listed slider measure matches. ### R2. Mesh - If `mesh` is on, the extract at resolution 128 of the orb fixture is a single closed solid: a mesh library reports it watertight, with no self-intersections above a tiny tolerance in `design.md`. - The bounding box of that mesh matches the file within 0.05 units. Accept when: the mesh is watertight and the box matches, when the option is on. ### R3. Files - One command runs both languages' fixtures, the slider measure, the mesh check, and writes the four screenshots (the fourth is the mesh or a second camera if mesh is off). - No network. Accept when: the command passes at resolution 64 and 128, for both languages. ### 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 Fixture programs produce golden renders in both spellings of the language. A slider changes a documented measure. When the mesh option is on, the extracted orb is watertight and its bounding box matches a file. No network and no physical print. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to write a form, how to export a mesh, and how to run the checks.