SolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.
fix(#271): document name?, body_name? and targets? on the commands that accept them
bherbruck87bb2f37f874
diff --git a/crates/engine/src/cmd/features.rs b/crates/engine/src/cmd/features.rsindex 8a373f203f..cec986e0f0 100644--- a/crates/engine/src/cmd/features.rs+++ b/crates/engine/src/cmd/features.rs@@ -21,12 +21,12 @@ pub static COMMANDS: &[CommandSpec] = &[CommandSpec::new("solid.sweep", "Sweep", sweep).at("SOLID", "CREATE").icon("sweep")- .params("sketch: profile sketch; profiles?; path_sketch: sketch; path: [curve ids in order]; operation?"),- CommandSpec::new("solid.loft", "Loft", loft).at("SOLID", "CREATE").icon("loft").params("sections: [{sketch, profiles?} | {sketch, point: id} (an apex)] (2 or more, in order); operation?"),- CommandSpec::new("solid.box", "Box", prim_box).at("SOLID", "CREATE").icon("box").params("length, width, height: expr; corner?: [x,y,z] | center?: [x,y,z] (numbers in mm or length expressions; default: the origin); operation?"),- CommandSpec::new("solid.cylinder", "Cylinder", prim_cylinder).at("SOLID", "CREATE").icon("cylinder").params("radius | diameter, height: expr; base?: [x,y,z] (centre of the bottom: numbers in mm or length expressions; default: the origin); axis?: X|Y|Z|[x,y,z] (default Z); operation?"),- CommandSpec::new("solid.sphere", "Sphere", prim_sphere).at("SOLID", "CREATE").icon("sphere").params("radius | diameter: expr; center?: [x,y,z] (numbers in mm or length expressions; default: the origin); operation?"),- CommandSpec::new("solid.torus", "Torus", prim_torus).at("SOLID", "CREATE").icon("torus").params("major, minor: expr (radii); center?: [x,y,z] (numbers in mm or length expressions; default: the origin); operation?"),+ .params("sketch: profile sketch; profiles?; path_sketch: sketch; path: [curve ids in order]; operation?, targets?, name?, body_name?"),+ CommandSpec::new("solid.loft", "Loft", loft).at("SOLID", "CREATE").icon("loft").params("sections: [{sketch, profiles?} | {sketch, point: id} (an apex)] (2 or more, in order); operation?, targets?, name?, body_name?"),+ CommandSpec::new("solid.box", "Box", prim_box).at("SOLID", "CREATE").icon("box").params("length, width, height: expr; corner?: [x,y,z] | center?: [x,y,z] (numbers in mm or length expressions; default: the origin); operation?, name?, body_name?"),+ CommandSpec::new("solid.cylinder", "Cylinder", prim_cylinder).at("SOLID", "CREATE").icon("cylinder").params("radius | diameter, height: expr; base?: [x,y,z] (centre of the bottom: numbers in mm or length expressions; default: the origin); axis?: X|Y|Z|[x,y,z] (default Z); operation?, name?, body_name?"),+ CommandSpec::new("solid.sphere", "Sphere", prim_sphere).at("SOLID", "CREATE").icon("sphere").params("radius | diameter: expr; center?: [x,y,z] (numbers in mm or length expressions; default: the origin); operation?, name?, body_name?"),+ CommandSpec::new("solid.torus", "Torus", prim_torus).at("SOLID", "CREATE").icon("torus").params("major, minor: expr (radii); center?: [x,y,z] (numbers in mm or length expressions; default: the origin); operation?, name?, body_name?"),CommandSpec::new("solid.fillet", "Fillet", fillet).at("SOLID", "MODIFY").icon("fillet")diff --git a/crates/engine/src/cmd/sheet.rs b/crates/engine/src/cmd/sheet.rsindex 443a0a5170..be7fe0ebb9 100644--- a/crates/engine/src/cmd/sheet.rs+++ b/crates/engine/src/cmd/sheet.rs@@ -16,7 +16,7 @@ pub static COMMANDS: &[CommandSpec] = &[CommandSpec::new("sheet.flange", "Flange", flange).at("SHEET METAL", "CREATE").icon("flange").params("base: sketch + profiles? (rule?, flip?) | contour: sketch + curves (open chain of lines) + distance (rule?, flip?, reverse?) | \edge: edges: [[x,y,z] on top/bottom edges] + height (to the outer face), angle? (default 90 deg), radius? (default: rule), \- position?: inside|outside|middle, flip?, body?; type?: base|edge|contour (default from the inputs)",+ position?: inside|outside|middle, flip?, body?; type?: base|edge|contour (default from the inputs); name?, body_name? (the new body)",),CommandSpec::new("sheet.hem", "Hem", hem).at("SHEET METAL", "CREATE")diff --git a/crates/engine/src/tests.rs b/crates/engine/src/tests.rsindex 64617c23a0..6627f257ad 100644--- a/crates/engine/src/tests.rs+++ b/crates/engine/src/tests.rs@@ -2430,3 +2430,22 @@ fn params_docs_list_working_parameters() {assert!(params("sheet.flange").contains("body_name"), "sheet.flange: {}", params("sheet.flange"));assert!(params("solid.loft").contains("targets"), "solid.loft: {}", params("solid.loft"));}++/// Every body-creating feature documents the keys `add_feature` reads for all of them (`name`,+/// `body_name`), and those that take `targets` say so (#271).+#[test]+fn feature_params_docs_list_shared_keys() {+ let mut s = Session::default();+ let cmds = run(&mut s, "engine.commands", json!({}));+ let params =+ |id: &str| cmds.as_array().unwrap().iter().find(|c| c["id"] == id).and_then(|c| c["params"].as_str()).unwrap_or_default().to_string();+ let with_targets = ["solid.extrude", "solid.revolve", "solid.sweep", "solid.loft", "solid.pipe", "solid.coil"];+ let without_targets = ["solid.box", "solid.cylinder", "solid.sphere", "solid.torus", "sheet.flange"];+ for id in with_targets.iter().chain(&without_targets) {+ let doc = params(id);+ assert!(doc.contains("name?") && doc.contains("body_name?"), "{id}: {doc}");+ }+ for id in with_targets {+ assert!(params(id).contains("targets?"), "{id}: {}", params(id));+ }+}