# Module knobs ## What this builds A family of knobs for a modular-synth shaft, modelled as code. The bore and an optional D-flat follow a stated standard, listed in this spec (not a vague appeal to a brand). A press-fit allowance is applied. A few sizes are rendered. No physical press or a real module is required. The product name does not use a trademarked format name in the id. Read `spekkr.inputs.json` first. `diameter` and `height` size the skirt. `bore` and `press` size the hole. `standard` chooses the shaft table. `dflat` and `pointer` add features. `tool` is the modeller. ## Out of scope - A real pot shaft in the checks, or a press-fit feel test. - A trademarked format name in the id. - A physical print or a shop of branded knobs. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Bore and D-flat - For `6mm-d`, the shaft is 6.0 mm, and the D-flat is 0.5 mm off a 6.0 mm circle, as in `design.md`. For `quarter-inch`, the table in the same file is used. - The modelled bore is `shaft - press` on the round, and the flat is offset accordingly, each within 0.03 mm. - A family of three diameters (12, 16, 20, or the input plus two neighbours) is built and measured. Accept when: each standard's bore and flat match the table, with the allowance, for the family of sizes. ### R2. Files and frames - Meshes watertight. Renders: the family, a bore section, a D-flat close-up, and a knob on a modelled shaft (the shaft is a check solid, not a bought part). - One command builds, measures, and writes the renders. No press, no print. Accept when: the command passes for both tools and both standards, and a zero-allowance / wrong-flat fixture fails the table. ### 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 Shaft bore and D-flat dimensions are measured against a stated standard table, with a press-fit allowance applied. A family of sizes is rendered. No physical press and no real module are required. The id does not use a trademarked format name. ## 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 a size, how the shaft table is written, and that a press-fit feel is not a check.