ggsql 0.4.0

//! Facet property resolution
//!
//! Validates facet properties and applies data-aware defaults.

use crate::plot::types::validate_parameter;
use crate::plot::ParameterValue;
use crate::DataFrame;
use std::collections::HashMap;

use super::types::Facet;

/// Context for facet resolution with data-derived information
pub struct FacetDataContext {
    /// Number of unique values in the first facet variable
    pub num_levels: usize,
    /// Unique values for each facet variable (as strings for label formatting)
    pub unique_values: HashMap<String, Vec<String>>,
}

impl FacetDataContext {
    /// Create context from a DataFrame and facet variables
    ///
    /// Extracts unique values from each facet variable for label resolution.
    pub fn from_dataframe(df: &DataFrame, variables: &[String]) -> Self {
        use crate::array_util::value_to_string;
        use arrow::array::Array;
        use std::collections::HashSet;

        let mut unique_values = HashMap::new();
        let mut num_levels = 1;

        for (i, var) in variables.iter().enumerate() {
            if let Ok(col) = df.column(var) {
                // Collect unique values manually
                let mut seen = HashSet::new();
                let mut values = Vec::new();
                for j in 0..col.len() {
                    if col.is_null(j) {
                        continue;
                    }
                    let s = value_to_string(col, j);
                    if seen.insert(s.clone()) {
                        values.push(s);
                    }
                }

                if i == 0 {
                    num_levels = values.len().max(1);
                }
                unique_values.insert(var.clone(), values);
            }
        }

        Self {
            num_levels,
            unique_values,
        }
    }
}

/// Compute smart default ncol for wrap facets based on number of levels
///
/// Returns an optimal column count that creates a balanced grid:
/// - n ≤ 3: ncol = n (single row)
/// - n ≤ 6: ncol = 3
/// - n ≤ 12: ncol = 4
/// - n > 12: ncol = 5
fn compute_default_ncol(num_levels: usize) -> i64 {
    if num_levels <= 3 {
        num_levels as i64
    } else if num_levels <= 6 {
        3
    } else if num_levels <= 12 {
        4
    } else {
        5
    }
}

/// Resolve and validate facet properties
///
/// This function:
/// 1. Skips if already resolved
/// 2. Validates all properties are allowed for this layout
/// 3. Validates property values using constraints from `default_properties()`
/// 4. Validates `free` property against position aesthetic names (coord-dependent)
/// 5. Validates ncol/nrow mutual exclusivity
/// 6. Normalizes the `free` property to a boolean vector (position-indexed)
/// 7. Applies defaults for missing properties:
///    - `ncol` (wrap only): computed from `context.num_levels`
/// 8. Sets `resolved = true`
///
/// # Arguments
///
/// * `facet` - The facet to resolve
/// * `context` - Data context with unique values
/// * `position_names` - Valid position aesthetic names (e.g., ["x", "y"] or ["angle", "radius"])
pub fn resolve_properties(
    facet: &mut Facet,
    context: &FacetDataContext,
    position_names: &[&str],
) -> Result<(), String> {
    // Skip if already resolved
    if facet.resolved {
        return Ok(());
    }

    let defaults = facet.layout.default_properties();

    // Step 1: Validate all properties are allowed and validate their values
    for (key, value) in facet.properties.iter() {
        if let Some(param) = defaults.iter().find(|p| p.name == key) {
            // Skip validation for 'free' - it has coord-dependent allowed values
            if key != "free" {
                validate_parameter(key, value, &param.constraint)?;
            }
        } else {
            // Special error messages for ncol/nrow on grid facets
            if key == "ncol" {
                return Err(
                    "Setting 'ncol' is only allowed for 1 dimensional facets, not 2 dimensional facets".to_string(),
                );
            }
            if key == "nrow" {
                return Err(
                    "Setting 'nrow' is only allowed for 1 dimensional facets, not 2 dimensional facets".to_string(),
                );
            }
            let allowed: Vec<&str> = defaults.iter().map(|p| p.name).collect();
            return Err(format!(
                "FACET setting should be {}, not '{}'",
                crate::or_list_quoted(&allowed, '\''),
                key
            ));
        }
    }

    // Step 2: Validate free property against coord-dependent position names
    validate_free_property(facet, position_names)?;

    // Step 3: Validate ncol/nrow mutual exclusivity
    validate_layout_exclusivity(facet)?;

    // Step 4: Normalize free property to boolean vector
    normalize_free_property(facet, position_names);

    // Step 5: Apply defaults for missing properties
    apply_defaults(facet, context);

    // Mark as resolved
    facet.resolved = true;

    Ok(())
}

/// Validate free property value
///
/// Accepts:
/// - `null` (ParameterValue::Null) - shared scales (default when absent)
/// - A valid position aesthetic name (string) - independent scale for that axis only
/// - An array of valid position aesthetic names - independent scales for specified axes
///
/// # Arguments
///
/// * `facet` - The facet to validate
/// * `position_names` - Valid position aesthetic names (e.g., ["x", "y"] or ["angle", "radius"])
fn validate_free_property(facet: &Facet, position_names: &[&str]) -> Result<(), String> {
    if let Some(value) = facet.properties.get("free") {
        match value {
            ParameterValue::Null => {
                // Explicit null means shared scales (same as default)
                Ok(())
            }
            ParameterValue::String(s) => {
                if !position_names.contains(&s.as_str()) {
                    return Err(format!(
                        "invalid 'free' value '{}'. Expected one of: {} (or null)",
                        s,
                        crate::or_list_quoted(position_names, '\'')
                    ));
                }
                Ok(())
            }
            ParameterValue::Array(arr) => {
                // Validate each element is a valid position name
                if arr.is_empty() {
                    return Err("invalid 'free' array: cannot be empty".to_string());
                }
                if arr.len() > position_names.len() {
                    return Err(format!(
                        "invalid 'free' array: too many elements ({} given, max {})",
                        arr.len(),
                        position_names.len()
                    ));
                }

                let mut seen = std::collections::HashSet::new();
                for elem in arr {
                    match elem {
                        crate::plot::ArrayElement::String(s) => {
                            if !position_names.contains(&s.as_str()) {
                                return Err(format!(
                                    "invalid 'free' array element '{}'. Expected one of: {}",
                                    s,
                                    crate::or_list_quoted(position_names, '\'')
                                ));
                            }
                            if !seen.insert(s.clone()) {
                                return Err(format!(
                                    "invalid 'free' array: duplicate element '{}'",
                                    s
                                ));
                            }
                        }
                        _ => {
                            return Err(format!(
                                "invalid 'free' array: elements must be strings. Expected: {}",
                                crate::or_list_quoted(position_names, '\'')
                            ));
                        }
                    }
                }
                Ok(())
            }
            _ => Err(format!(
                "'free' must be null, a string ({}), or an array of position names",
                crate::or_list_quoted(position_names, '\'')
            )),
        }
    } else {
        Ok(())
    }
}

/// Normalize free property to a boolean vector
///
/// Transforms user-provided values to a boolean vector (position-indexed):
/// - User writes: `free => 'x'` → stored as: `free => [true, false]`
/// - User writes: `free => 'angle'` → stored as: `free => [true, false]`
/// - User writes: `free => ['x', 'y']` → stored as: `free => [true, true]`
/// - User writes: `free => null` or absent → stored as: `free => [false, false]`
///
/// This allows the writer to use the vector directly without any parsing.
fn normalize_free_property(facet: &mut Facet, position_names: &[&str]) {
    let mut free_vec = vec![false; position_names.len()];

    if let Some(value) = facet.properties.get("free") {
        match value {
            ParameterValue::String(s) => {
                // Single string -> set that position to true
                if let Some(idx) = position_names.iter().position(|n| *n == s.as_str()) {
                    free_vec[idx] = true;
                }
            }
            ParameterValue::Array(arr) => {
                // Array -> set each position to true
                for elem in arr {
                    if let crate::plot::ArrayElement::String(s) = elem {
                        if let Some(idx) = position_names.iter().position(|n| *n == s.as_str()) {
                            free_vec[idx] = true;
                        }
                    }
                }
            }
            ParameterValue::Null => {
                // Explicit null -> all false (already initialized)
            }
            _ => {
                // Invalid type - should have been caught by validation
            }
        }
    }

    // Store as boolean array
    let bool_array: Vec<crate::plot::ArrayElement> = free_vec
        .iter()
        .map(|&b| crate::plot::ArrayElement::Boolean(b))
        .collect();
    facet
        .properties
        .insert("free".to_string(), ParameterValue::Array(bool_array));
}

/// Validate ncol and nrow mutual exclusivity
///
/// They cannot both be specified at the same time.
/// Type and range validation is handled by the constraint system.
fn validate_layout_exclusivity(facet: &Facet) -> Result<(), String> {
    let has_ncol = facet.properties.contains_key("ncol");
    let has_nrow = facet.properties.contains_key("nrow");

    if has_ncol && has_nrow {
        return Err(
            "'ncol' and 'nrow' cannot both be specified. Use one or the other.".to_string(),
        );
    }

    Ok(())
}

/// Apply default values for missing properties
fn apply_defaults(facet: &mut Facet, context: &FacetDataContext) {
    // Note: absence of 'free' property means fixed/shared scales (default)
    // No need to insert a default value

    // Handle ncol/nrow for wrap facets
    if facet.is_wrap() {
        let has_ncol = facet.properties.contains_key("ncol");
        let has_nrow = facet.properties.contains_key("nrow");

        if has_nrow && !has_ncol {
            // User provided nrow: compute ncol from it
            if let Some(ParameterValue::Number(nrow)) = facet.properties.get("nrow") {
                let nrow_val = *nrow as usize;
                let ncol = ((context.num_levels as f64) / (nrow_val as f64)).ceil() as i64;
                facet
                    .properties
                    .insert("ncol".to_string(), ParameterValue::Number(ncol as f64));
                facet.properties.remove("nrow");
            }
        } else if !has_ncol && !has_nrow {
            // Neither provided: apply default ncol
            let default_cols = compute_default_ncol(context.num_levels);
            facet.properties.insert(
                "ncol".to_string(),
                ParameterValue::Number(default_cols as f64),
            );
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::df;
    use crate::plot::facet::FacetLayout;

    /// Default position names for cartesian coords
    const CARTESIAN: &[&str] = &["x", "y"];
    /// Position names for polar coords
    const POLAR: &[&str] = &["angle", "radius"];

    fn make_wrap_facet() -> Facet {
        Facet::new(FacetLayout::Wrap {
            variables: vec!["category".to_string()],
        })
    }

    fn make_grid_facet() -> Facet {
        Facet::new(FacetLayout::Grid {
            row: vec!["row_var".to_string()],
            column: vec!["col_var".to_string()],
        })
    }

    fn make_context(num_levels: usize) -> FacetDataContext {
        FacetDataContext {
            num_levels,
            unique_values: HashMap::new(),
        }
    }

    /// Helper to extract boolean values from normalized free property
    fn get_free_bools(facet: &Facet) -> Option<Vec<bool>> {
        facet.properties.get("free").and_then(|v| {
            if let ParameterValue::Array(arr) = v {
                Some(
                    arr.iter()
                        .map(|e| matches!(e, crate::plot::ArrayElement::Boolean(true)))
                        .collect(),
                )
            } else {
                None
            }
        })
    }

    #[test]
    fn test_compute_default_ncol() {
        assert_eq!(compute_default_ncol(1), 1);
        assert_eq!(compute_default_ncol(2), 2);
        assert_eq!(compute_default_ncol(3), 3);
        assert_eq!(compute_default_ncol(4), 3);
        assert_eq!(compute_default_ncol(6), 3);
        assert_eq!(compute_default_ncol(7), 4);
        assert_eq!(compute_default_ncol(12), 4);
        assert_eq!(compute_default_ncol(13), 5);
        assert_eq!(compute_default_ncol(100), 5);
    }

    #[test]
    fn test_resolve_applies_defaults() {
        let mut facet = make_wrap_facet();
        let context = make_context(5);

        resolve_properties(&mut facet, &context, CARTESIAN).unwrap();

        assert!(facet.resolved);
        // After resolution, free is normalized to boolean array (all false = fixed)
        assert_eq!(get_free_bools(&facet), Some(vec![false, false]));
        assert_eq!(
            facet.properties.get("ncol"),
            Some(&ParameterValue::Number(3.0))
        );
    }

    #[test]
    fn test_resolve_preserves_user_values() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::Array(vec![
                crate::plot::ArrayElement::String("x".to_string()),
                crate::plot::ArrayElement::String("y".to_string()),
            ]),
        );
        facet
            .properties
            .insert("ncol".to_string(), ParameterValue::Number(2.0));

        let context = make_context(10);
        resolve_properties(&mut facet, &context, CARTESIAN).unwrap();

        // free => ['x', 'y'] is normalized to [true, true]
        assert_eq!(get_free_bools(&facet), Some(vec![true, true]));
        assert_eq!(
            facet.properties.get("ncol"),
            Some(&ParameterValue::Number(2.0))
        );
    }

    #[test]
    fn test_resolve_skips_if_already_resolved() {
        let mut facet = make_wrap_facet();
        facet.resolved = true;

        let context = make_context(5);
        resolve_properties(&mut facet, &context, CARTESIAN).unwrap();

        // Should not have applied defaults since it was already resolved
        assert!(!facet.properties.contains_key("ncol"));
    }

    #[test]
    fn test_error_columns_is_unknown_property() {
        // "columns" is Vega-Lite's name, we use "ncol"
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("columns".to_string(), ParameterValue::Number(4.0));

        let context = make_context(10);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("not 'columns'"));
    }

    #[test]
    fn test_error_ncol_on_grid() {
        let mut facet = make_grid_facet();
        facet
            .properties
            .insert("ncol".to_string(), ParameterValue::Number(3.0));

        let context = make_context(10);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("ncol"));
        assert!(err.contains("1 dimensional"));
    }

    #[test]
    fn test_error_unknown_property() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("unknown".to_string(), ParameterValue::Number(1.0));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("not 'unknown'"));
    }

    #[test]
    fn test_error_invalid_free_value() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::String("invalid".to_string()),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("invalid"));
        assert!(err.contains("free"));
    }

    #[test]
    fn test_error_negative_ncol() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("ncol".to_string(), ParameterValue::Number(-1.0));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("ncol"));
        assert!(err.contains(">= 1")); // count constraint: >= 1
    }

    #[test]
    fn test_error_non_integer_ncol() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("ncol".to_string(), ParameterValue::Number(2.5));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("ncol"));
        assert!(err.contains("whole number")); // count constraint checks for whole numbers
    }

    #[test]
    fn test_grid_no_ncol_default() {
        let mut facet = make_grid_facet();
        let context = make_context(10);

        resolve_properties(&mut facet, &context, CARTESIAN).unwrap();

        // Grid facets should not get ncol default
        assert!(!facet.properties.contains_key("ncol"));
        // After resolution, free is normalized to boolean array (all false = fixed)
        assert_eq!(get_free_bools(&facet), Some(vec![false, false]));
        assert!(facet.resolved);
    }

    #[test]
    fn test_context_from_dataframe() {
        let df = df! {
            "category" => vec!["A", "B", "C", "A", "B", "C"],
            "value" => vec![1i32, 2, 3, 4, 5, 6],
        }
        .unwrap();

        let context = FacetDataContext::from_dataframe(&df, &["category".to_string()]);
        assert_eq!(context.num_levels, 3);
    }

    #[test]
    fn test_context_from_dataframe_missing_column() {
        let df = df! {
            "other" => vec![1i32, 2, 3],
        }
        .unwrap();

        let context = FacetDataContext::from_dataframe(&df, &["missing".to_string()]);
        assert_eq!(context.num_levels, 1); // Falls back to 1
    }

    #[test]
    fn test_context_from_dataframe_empty_variables() {
        let df = df! {
            "x" => vec![1i32, 2, 3],
        }
        .unwrap();

        let context = FacetDataContext::from_dataframe(&df, &[]);
        assert_eq!(context.num_levels, 1);
    }

    // ========================================
    // Missing Property Tests
    // ========================================

    #[test]
    fn test_missing_property_repeat_valid() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "missing".to_string(),
            ParameterValue::String("repeat".to_string()),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);
        assert!(result.is_ok());
    }

    #[test]
    fn test_missing_property_null_valid() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "missing".to_string(),
            ParameterValue::String("null".to_string()),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);
        assert!(result.is_ok());
    }

    #[test]
    fn test_error_invalid_missing_value() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "missing".to_string(),
            ParameterValue::String("invalid".to_string()),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("invalid"));
        assert!(err.contains("missing"));
    }

    #[test]
    fn test_error_missing_not_string() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("missing".to_string(), ParameterValue::Number(1.0));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("missing"));
        assert!(err.contains("String")); // type error uses capitalized type names
    }

    #[test]
    fn test_missing_allowed_on_grid_facet() {
        let mut facet = make_grid_facet();
        facet.properties.insert(
            "missing".to_string(),
            ParameterValue::String("repeat".to_string()),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);
        assert!(result.is_ok());
    }

    // ========================================
    // Free Property Tests - Cartesian
    // ========================================

    #[test]
    fn test_free_property_x_valid() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("free".to_string(), ParameterValue::String("x".to_string()));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);
        assert!(result.is_ok());
        // x is first position -> [true, false]
        assert_eq!(get_free_bools(&facet), Some(vec![true, false]));
    }

    #[test]
    fn test_free_property_y_valid() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("free".to_string(), ParameterValue::String("y".to_string()));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);
        assert!(result.is_ok());
        // y is second position -> [false, true]
        assert_eq!(get_free_bools(&facet), Some(vec![false, true]));
    }

    #[test]
    fn test_free_property_array_valid() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::Array(vec![
                crate::plot::ArrayElement::String("x".to_string()),
                crate::plot::ArrayElement::String("y".to_string()),
            ]),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);
        assert!(result.is_ok());
        // Both -> [true, true]
        assert_eq!(get_free_bools(&facet), Some(vec![true, true]));
    }

    #[test]
    fn test_free_property_array_reversed_valid() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::Array(vec![
                crate::plot::ArrayElement::String("y".to_string()),
                crate::plot::ArrayElement::String("x".to_string()),
            ]),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);
        assert!(result.is_ok());
        // Order doesn't matter, both are set -> [true, true]
        assert_eq!(get_free_bools(&facet), Some(vec![true, true]));
    }

    #[test]
    fn test_free_property_null_valid() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("free".to_string(), ParameterValue::Null);

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);
        assert!(result.is_ok());
        // Explicit null -> [false, false]
        assert_eq!(get_free_bools(&facet), Some(vec![false, false]));
    }

    #[test]
    fn test_free_property_single_element_array_valid() {
        // Single element arrays are now valid (e.g., free => ['x'])
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::Array(vec![crate::plot::ArrayElement::String("x".to_string())]),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);
        assert!(result.is_ok());
        // Single element -> [true, false]
        assert_eq!(get_free_bools(&facet), Some(vec![true, false]));
    }

    #[test]
    fn test_error_free_array_invalid_element() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::Array(vec![
                crate::plot::ArrayElement::String("x".to_string()),
                crate::plot::ArrayElement::String("z".to_string()),
            ]),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("free"));
        assert!(err.contains("'z'"));
    }

    #[test]
    fn test_error_free_wrong_type() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("free".to_string(), ParameterValue::Number(1.0));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("free"));
    }

    #[test]
    fn test_error_free_duplicate_element() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::Array(vec![
                crate::plot::ArrayElement::String("x".to_string()),
                crate::plot::ArrayElement::String("x".to_string()),
            ]),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("duplicate"));
    }

    // ========================================
    // Free Property Tests - Polar
    // ========================================

    #[test]
    fn test_free_property_angle_valid() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::String("angle".to_string()),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, POLAR);
        assert!(result.is_ok());
        // angle is first position -> [true, false]
        assert_eq!(get_free_bools(&facet), Some(vec![true, false]));
    }

    #[test]
    fn test_free_property_radius_valid() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::String("radius".to_string()),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, POLAR);
        assert!(result.is_ok());
        // radius is second position -> [false, true]
        assert_eq!(get_free_bools(&facet), Some(vec![false, true]));
    }

    #[test]
    fn test_free_property_polar_array_valid() {
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::Array(vec![
                crate::plot::ArrayElement::String("angle".to_string()),
                crate::plot::ArrayElement::String("radius".to_string()),
            ]),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, POLAR);
        assert!(result.is_ok());
        // Both -> [true, true]
        assert_eq!(get_free_bools(&facet), Some(vec![true, true]));
    }

    #[test]
    fn test_error_cartesian_names_in_polar() {
        // x/y should not be valid for polar coords
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("free".to_string(), ParameterValue::String("x".to_string()));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, POLAR);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("'x'"));
        assert!(err.contains("angle") || err.contains("radius"));
    }

    #[test]
    fn test_error_polar_names_in_cartesian() {
        // angle/radius should not be valid for cartesian coords
        let mut facet = make_wrap_facet();
        facet.properties.insert(
            "free".to_string(),
            ParameterValue::String("angle".to_string()),
        );

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("'angle'"));
        assert!(err.contains("'x'") || err.contains("'y'"));
    }

    // ========================================
    // nrow Property Tests
    // ========================================

    #[test]
    fn test_nrow_computes_ncol() {
        // 10 levels, nrow=2 -> ncol=5
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("nrow".to_string(), ParameterValue::Number(2.0));

        let context = make_context(10);
        resolve_properties(&mut facet, &context, CARTESIAN).unwrap();

        // nrow should be removed and ncol computed
        assert!(!facet.properties.contains_key("nrow"));
        assert_eq!(
            facet.properties.get("ncol"),
            Some(&ParameterValue::Number(5.0))
        );
    }

    #[test]
    fn test_nrow_with_remainder() {
        // 10 levels, nrow=3 -> ncol=ceil(10/3)=4
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("nrow".to_string(), ParameterValue::Number(3.0));

        let context = make_context(10);
        resolve_properties(&mut facet, &context, CARTESIAN).unwrap();

        assert!(!facet.properties.contains_key("nrow"));
        assert_eq!(
            facet.properties.get("ncol"),
            Some(&ParameterValue::Number(4.0))
        );
    }

    #[test]
    fn test_nrow_larger_than_num_levels() {
        // 3 levels, nrow=10 -> ncol=ceil(3/10)=1
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("nrow".to_string(), ParameterValue::Number(10.0));

        let context = make_context(3);
        resolve_properties(&mut facet, &context, CARTESIAN).unwrap();

        assert!(!facet.properties.contains_key("nrow"));
        assert_eq!(
            facet.properties.get("ncol"),
            Some(&ParameterValue::Number(1.0))
        );
    }

    #[test]
    fn test_nrow_equals_num_levels() {
        // 5 levels, nrow=5 -> ncol=ceil(5/5)=1
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("nrow".to_string(), ParameterValue::Number(5.0));

        let context = make_context(5);
        resolve_properties(&mut facet, &context, CARTESIAN).unwrap();

        assert!(!facet.properties.contains_key("nrow"));
        assert_eq!(
            facet.properties.get("ncol"),
            Some(&ParameterValue::Number(1.0))
        );
    }

    #[test]
    fn test_error_ncol_and_nrow_both_provided() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("ncol".to_string(), ParameterValue::Number(3.0));
        facet
            .properties
            .insert("nrow".to_string(), ParameterValue::Number(2.0));

        let context = make_context(10);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("ncol"));
        assert!(err.contains("nrow"));
        assert!(err.contains("cannot both be specified"));
    }

    #[test]
    fn test_error_negative_nrow() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("nrow".to_string(), ParameterValue::Number(-1.0));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("nrow"));
        assert!(err.contains(">= 1")); // count constraint: >= 1
    }

    #[test]
    fn test_error_non_integer_nrow() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("nrow".to_string(), ParameterValue::Number(2.5));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("nrow"));
        assert!(err.contains("whole number")); // count constraint checks for whole numbers
    }

    #[test]
    fn test_error_nrow_on_grid() {
        let mut facet = make_grid_facet();
        facet
            .properties
            .insert("nrow".to_string(), ParameterValue::Number(2.0));

        let context = make_context(10);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("nrow"));
        assert!(err.contains("1 dimensional"));
    }

    #[test]
    fn test_nrow_not_string() {
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("nrow".to_string(), ParameterValue::String("2".to_string()));

        let context = make_context(5);
        let result = resolve_properties(&mut facet, &context, CARTESIAN);

        assert!(result.is_err());
        let err = result.unwrap_err();
        assert!(err.contains("nrow"));
        assert!(err.contains("Number")); // type error uses capitalized type names
    }

    #[test]
    fn test_user_ncol_preserved() {
        // Existing behavior: user-provided ncol should be preserved
        let mut facet = make_wrap_facet();
        facet
            .properties
            .insert("ncol".to_string(), ParameterValue::Number(2.0));

        let context = make_context(10);
        resolve_properties(&mut facet, &context, CARTESIAN).unwrap();

        // User's ncol should be preserved, not overwritten
        assert_eq!(
            facet.properties.get("ncol"),
            Some(&ParameterValue::Number(2.0))
        );
    }
}