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"));
}
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);
}
}
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"}})
);
}
}