Files
solidcraft/crates/doc/src/format/pending
jyvikoandClaude Opus 5.5 7c8132e2d6 Repair Part (body.repair, #8371): rebuild refused faces, sew gaps, patch holes
A new undoable feature (`repair`, one pending format file) and command with input and
output schemas. In order:

- A cylinder, cone, sphere or torus face SMLib refuses on its own is rebuilt on a NURBS
  form of its surface laid on arcs from where the face starts
  (`form::surface_on_own_arcs`), with SMLib's own trims: the import's quarter-grid form of
  a face round most of a turn closes on itself, which SmTorus::IsNurbSurfaceTorus does not
  recognise. Geometry unchanged.
- Free edges that pair up within `gap` are sewn by SMLib's stitch; GlueEdgesGeneral gives
  each glued edge its own tolerance (at least twice its gap), the body's and the other
  edges' stay. The result is checked against the input's own SMLib check, the
  tolerance-bound tests (#5, #6, #59, #82) exempt.
- Loops of free edges left are holes: offered as surface.patch, and with patch_holes made
  (flat only when the loop is planar and every face around it is a plane, else G1) and
  sewn in.

The reply reports what changed face by face; nothing to do is refused with why.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 00:29:59 -04:00
..

Pending design-format changes

One file per change to what a design file saves that no release has shipped yet. Adding a file here is the whole format bump: never edit FORMAT, JSON_STEPS or another change's file.

  • Name it after the change, lowercase with dashes: placed-plane-origins.rs.

  • Start it with a //! note: what is saved, what an older design gets without it, and what the last release does with a design that has it (it refuses the newer format number).

  • If older designs must be rewritten as they open, add the step to the same file:

    //! …the note…
    use serde_json::Value;
    
    pub fn step(v: &mut Value) -> crate::Result<()> {
        // rewrite the design's JSON here
        Ok(())
    }
    

    Steps run in file-name order, after the steps of every older format.

While this folder has a change in it, the build writes the next format number (the last folded one + 1, which no release reads), and lists the changes a file has in its format_pending field, so a later build applies only the steps that file is missing. At release time scripts/fold-format-pending.sh moves these files into ../v<N>/, which fixes that number for good. See crates/doc/src/format.rs and CONTRIBUTING.md.