footing 0.1.12

Feature-gated foundations for Rust backend services
Documentation
use serde_json::{Value, json};

use super::RedocDocsError;

pub(super) fn resolve(mut overrides: Value, preset: bool) -> Result<Value, RedocDocsError> {
    if !overrides.is_object() {
        return Err(RedocDocsError::InvalidOptions("the root must be an object"));
    }
    if overrides
        .get("theme")
        .is_some_and(|theme| !theme.is_object())
    {
        return Err(RedocDocsError::InvalidOptions("theme must be an object"));
    }
    // Normalize preset aliases so explicit legacy false/zero values win too.
    if let Some(object) = overrides.as_object_mut() {
        for (legacy, canonical) in [
            ("untrustedSpec", "sanitize"),
            ("hideDownloadButton", "hideDownloadButtons"),
            ("schemaExpansionLevel", "schemasExpansionLevel"),
            ("jsonSampleExpandLevel", "jsonSamplesExpandLevel"),
        ] {
            if let Some(value) = object.remove(legacy) {
                object.entry(canonical).or_insert(value);
            }
        }
        // ReDoc 2.x's JavaScript || alias fallback treats numeric zero as absent.
        // Its supported string form preserves a zero JSON sample depth.
        if object.get("jsonSamplesExpandLevel").and_then(Value::as_f64) == Some(0.0) {
            object.insert("jsonSamplesExpandLevel".to_owned(), json!("0"));
        }
    }
    let mut options = if preset {
        json!({
            "disableSearch": false,
            "hideDownloadButtons": false,
            "sanitize": true,
            "schemasExpansionLevel": 1,
            "jsonSamplesExpandLevel": 2,
            "theme": {
                "typography": {
                    "fontFamily": "system-ui, sans-serif",
                    "headings": { "fontFamily": "system-ui, sans-serif" },
                    "code": { "fontFamily": "ui-monospace, monospace" }
                }
            }
        })
    } else {
        json!({})
    };
    merge(&mut options, overrides);
    Ok(options)
}

fn merge(target: &mut Value, overrides: Value) {
    match (target, overrides) {
        (Value::Object(target), Value::Object(overrides)) => {
            for (key, value) in overrides {
                merge(target.entry(key).or_insert(Value::Null), value);
            }
        }
        (target, value) => *target = value,
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn integer_and_float_zero_preserve_json_sample_depth() {
        for zero in [json!(0), json!(0.0), json!(-0.0)] {
            let options = resolve(json!({"jsonSamplesExpandLevel": zero}), true).unwrap();
            assert_eq!(options["jsonSamplesExpandLevel"], "0");
        }
    }

    #[test]
    fn objects_merge_but_arrays_scalars_and_null_replace() {
        let mut value = json!({"theme": {"fonts": ["a", "b"], "size": 12, "color": "blue"}});
        merge(&mut value, json!({"theme": {"fonts": ["c"], "size": null}}));
        assert_eq!(
            value,
            json!({"theme": {"fonts": ["c"], "size": null, "color": "blue"}})
        );
    }
}