v0.3.0: Cookbook — `examples/` dir with starter designs

[digispark-bot]

Goal

"Start me from the bracket template" beats "describe a bracket from scratch." Provide ~5-10 working build123d examples that demonstrate partsmith's common use cases.

Concrete deliverable

examples/ directory in the partsmith repo with one .py file per pattern. Each file is a self-contained, runnable build123d script with comments explaining each section. Suggested seed (revisit after real-print iteration):

examples/
  README.md              — overview + how to use these
  01_basic_box.py        — Hello-world; just a box with rounded edges
  02_mounting_bracket.py — Right-angle bracket with screw holes
  03_pegboard_mount.py   — Generic mount with adjustable pegboard hole pattern
  04_enclosure_box.py    — Parametric box with lid + standoffs
  05_hinge.py            — Print-in-place hinge with clearance
  06_threaded_insert_hole.py — Heat-set insert sizing for M3
  07_snap_fit.py         — Cantilever snap with parametric deflection
  08_french_cleat_mount.py — French-cleat-style wall mount (matches the Woodpeckers wall mount pattern)
  09_woodpeckers_wall_mount.py — The actual Woodpeckers mount from the first real workload
  10_text_label.py       — Embossed text on a face

Format conventions

• Each file has a result = ... final assignment so it runs as-is via partsmith_create_model
• Top of file: 5-line docstring explaining what it makes and when to use it
• Inline comments on every meaningful step
• Parametric: dimensions at top as named constants so users can tweak

Out of scope

• Photorealistic renders / marketing material — those live in docs/
• Cookbook expansion based on hypothetical use cases — only add what real designs have demanded
• Cookbook-as-MCP-tool (e.g. partsmith_load_example) — defer until v0.3.0: Persistent design store (save/load build123d source) #2-v0.3.0: Versioned designs with diff support #3 design persistence ships; for now copy/paste

Why this matters

The blank-page problem is real. Even with good helpers (#1), starting from result = Box(...) and a vague mental model is slower than starting from a working bracket and tweaking 3 parameters.

Tracked in ROADMAP.md under Theme 1.

[digispark-bot]

Moved to backlog (2026-06-10).

Deferred indefinitely — no target release. Rationale: the cookbook's own scope guard says "only add what real designs have demanded," and partsmith currently has exactly one real design (the Woodpeckers wall mount). Writing 8-10 speculative example files before more real prints exist risks producing templates nobody reaches for.

Re-prioritize when: after 3-4 more real print designs, when a repeated "I keep re-deriving this from scratch" pattern is clear. At that point write cookbook entries for those specific patterns, grounded in actual friction.

Lowest-regret partial if picked up sooner: just examples/09_woodpeckers_wall_mount.py (the one design that genuinely exists) + examples/README.md, and let the rest accumulate organically.

Helpers (#1, shipped v0.2.5) and versioned designs (#3, shipped v0.2.7) already cover most of the blank-page pain this would have addressed — you can now load any saved design as a starting point and tweak parameters.