M0: engine command registry, file formats, view math and CPU renderer

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

crates/engine/src/params.rs

@@ -0,0 +1,79 @@
+//! Helpers to read hostile JSON parameters.
+
+use serde_json::Value;
+use solvecraft_geom::{Vec2, Vec3};
+
+use crate::{EngineError, Result};
+
+pub fn bad(cmd: &str, msg: impl Into<String>) -> EngineError {
+    EngineError::BadParams { cmd: cmd.to_string(), msg: msg.into() }
+}
+
+pub fn finite(x: f64) -> Option<f64> {
+    (x.is_finite() && x.abs() < 1e9).then_some(x)
+}
+
+pub fn num(p: &Value, k: &str) -> Option<f64> {
+    p.get(k).and_then(Value::as_f64).and_then(finite)
+}
+
+pub fn str_<'a>(p: &'a Value, k: &str) -> Option<&'a str> {
+    p.get(k).and_then(Value::as_str)
+}
+
+pub fn bool_(p: &Value, k: &str) -> Option<bool> {
+    p.get(k).and_then(Value::as_bool)
+}
+
+pub fn vec2(v: &Value) -> Option<Vec2> {
+    match v {
+        Value::Array(a) if a.len() == 2 => Some(Vec2::new(finite(a.first()?.as_f64()?)?, finite(a.get(1)?.as_f64()?)?)),
+        Value::Object(o) => Some(Vec2::new(finite(o.get("x")?.as_f64()?)?, finite(o.get("y")?.as_f64()?)?)),
+        _ => None,
+    }
+}
+
+pub fn vec3(v: &Value) -> Option<Vec3> {
+    match v {
+        Value::Array(a) if a.len() == 3 => Some(Vec3::new(finite(a.first()?.as_f64()?)?, finite(a.get(1)?.as_f64()?)?, finite(a.get(2)?.as_f64()?)?)),
+        Value::Object(o) => Some(Vec3::new(finite(o.get("x")?.as_f64()?)?, finite(o.get("y")?.as_f64()?)?, finite(o.get("z")?.as_f64()?)?)),
+        _ => None,
+    }
+}
+
+pub fn req_vec2(cmd: &str, p: &Value, k: &str) -> Result<Vec2> {
+    p.get(k).and_then(vec2).ok_or_else(|| bad(cmd, format!("`{k}` must be a point [x, y]")))
+}
+
+pub fn req_vec3(cmd: &str, p: &Value, k: &str) -> Result<Vec3> {
+    p.get(k).and_then(vec3).ok_or_else(|| bad(cmd, format!("`{k}` must be a point [x, y, z]")))
+}
+
+pub fn vec2_list(cmd: &str, p: &Value, k: &str, max: usize) -> Result<Vec<Vec2>> {
+    let a = p.get(k).and_then(Value::as_array).ok_or_else(|| bad(cmd, format!("`{k}` must be a list of points")))?;
+    if a.len() > max {
+        return Err(bad(cmd, format!("`{k}` has too many points")));
+    }
+    a.iter().map(|v| vec2(v).ok_or_else(|| bad(cmd, format!("`{k}` must contain [x, y] points")))).collect()
+}
+
+/// An expression parameter: a number (mm or degrees by context) or an expression string.
+pub fn expr(p: &Value, k: &str) -> Option<String> {
+    match p.get(k)? {
+        Value::Number(n) => n.as_f64().and_then(finite).map(|v| format!("{v}")),
+        Value::String(s) if !s.trim().is_empty() && s.len() <= 4096 => Some(s.trim().to_string()),
+        _ => None,
+    }
+}
+
+pub fn req_expr(cmd: &str, p: &Value, k: &str) -> Result<String> {
+    expr(p, k).ok_or_else(|| bad(cmd, format!("`{k}` must be a number or an expression")))
+}
+
+pub fn string_list(p: &Value, k: &str) -> Vec<String> {
+    match p.get(k) {
+        Some(Value::Array(a)) => a.iter().take(10_000).filter_map(|v| v.as_str().map(str::to_string)).collect(),
+        Some(Value::String(s)) => vec![s.clone()],
+        _ => Vec::new(),
+    }
+}