# Fidget clicker ## What this builds A small clicker designed to print in one piece: a rotor, teeth, and a body, with a documented as-printed gap. A kinematic sweep of the click travel checks that teeth interfere as intended at the click, and clear at the rest, without welding the rotor to the body. Renders are written. The tactile feel of the click is out of scope. Read `spekkr.inputs.json` first. `length` sizes the body. `gap` is the print-in-place clearance. `teeth` is the count. `cap` and `lanyard` add features. `tool` is the modeller. ## Out of scope - The tactile feel of a click, or a physical print. - A spring made of metal. - A branded fidget toy's exact geometry. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Gaps and kinematics - At rest, the rotor is clear of the body by `gap` within 0.05 mm, on a minimum-distance check, so the print does not weld. - A sweep of one click (the angle in `design.md`) finds a tooth interference band (overlap or a gap under 0.05 mm) at the click, and a clearance at mid-travel, as in the file. - The cap, if on, does not collide with the rotor through the sweep, except at the intended shaft journal with clearance `gap`. Accept when: the rest gap, the click interference, and the mid-travel clearance match the file. ### R2. Files and frames - A single print-in-place mesh (and a logical exploded view for a render), watertight as a union with intended gaps as voids. - Renders: closed rest, mid-click, a logical explode, and a section through the teeth. - One command builds, sweeps, and writes the renders. No print, no feel test. Accept when: the command passes for both tools, and a zero-gap input is refused or fails the weld check. ### R3. Inputs - Numeric inputs are read from `spekkr.inputs.json` and must stay inside the ranges in the Inputs table in `design.md`. - A value outside a range is refused before modelling, with a message that names the key. - Options add or remove the features in that table. The `tool` swap selects CadQuery or OpenSCAD; both must meet the same numbers. Accept when: default and one out-of-range value are handled as above, and a second legal input set still matches the formulas in `design.md`. ### R4. Checks and report - One command builds the model at the defaults and at the person's inputs, measures it against `design.md`, and writes a short report. - A model broken on purpose, for example a wall thinner than `wall`, must fail the report. - The command exports the files this spec asks for (STL, and STEP when the tool can). No physical print is required. Accept when: the report says pass at the defaults and at the person's inputs, and fail on a deliberately broken model. ## Verification Print-in-place gaps and tooth interference or clearance are measured, and a kinematic sweep of the click travel is checked against a file. Renders are written. Tactile feel is not a CI check. No physical print is required. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to export the piece, how the gap is meant to print, and that feel is not a check.