openlogi-core 0.7.0

//! Semantic standalone-light commands — pure data, no I/O.
//!
//! The driver that encodes [`LightCommand`] into a device-specific raw HID
//! report (e.g. Litra) lives in `openlogi_hid::write::litra`.

use serde::{Deserialize, Serialize};

use crate::config::LightSettings;
use crate::device::LightCapabilities;

/// A semantic command accepted by the standalone-light layer.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum LightCommand {
    /// Turn the light on or off.
    Power(bool),
    /// Set normalized brightness from 0 to 100 percent.
    BrightnessPercent(u8),
    /// Set colour temperature in Kelvin.
    TemperatureKelvin(u16),
    /// Set brightness in the native unit advertised by the selected model.
    /// This is primarily a diagnostic/CLI convenience; persisted settings
    /// remain normalized percentages.
    BrightnessNative(u16),
}

/// Expand protocol-neutral saved settings into only the controls advertised
/// by a standalone light. Unsupported controls are omitted rather than sent
/// speculatively, which keeps power-only and brightness-only drivers usable.
#[must_use]
pub fn commands_for_light_settings(
    settings: LightSettings,
    capabilities: LightCapabilities,
) -> Vec<LightCommand> {
    let mut commands = Vec::new();
    if capabilities.power {
        commands.push(LightCommand::Power(settings.enabled));
    }
    if capabilities.brightness.is_some() {
        commands.push(LightCommand::BrightnessPercent(settings.brightness_percent));
    }
    if capabilities.temperature.is_some()
        && let Some(kelvin) = settings.temperature_kelvin
    {
        commands.push(LightCommand::TemperatureKelvin(kelvin));
    }
    commands
}

#[cfg(test)]
mod tests {
    use super::{LightCommand, commands_for_light_settings};
    use crate::config::LightSettings;
    use crate::device::{LightCapabilities, LightValueRange, LightValueUnit};

    #[test]
    fn light_settings_expand_only_to_advertised_controls() {
        let Ok(brightness) = LightValueRange::new(0, 100, 1, LightValueUnit::Percent) else {
            panic!("valid brightness fixture");
        };
        let settings = LightSettings::new(false, 37, Some(4600));
        let commands = commands_for_light_settings(
            settings,
            LightCapabilities {
                brightness: Some(brightness),
                ..LightCapabilities::default()
            },
        );

        assert_eq!(commands, vec![LightCommand::BrightnessPercent(37)]);
    }
}