Unit conversion configuration for KosConfigProperty instances.

Defines how configuration property values should be converted between backend storage units (typically SI) and regional display units. The converter enables automatic unit conversion based on device region while maintaining precision.

Example: Temperature Conversion

const temperatureConverter: ConfigPropConverter = {
measure: 'temperature',
from: { unit: 'kelvin', system: 'si' }, // Backend storage
to: { system: 'auto' } // Auto-detect regional display
};

Example: Volume Conversion with Specific Units

const volumeConverter: ConfigPropConverter = {
measure: 'volume',
from: { unit: 'liter' }, // Backend in liters
to: { unit: 'fluid-ounce', system: 'imperial' } // Force US fluid ounces
};
interface ConfigPropConverter {
    measure?: string;
    from?: UnitConverter;
    to?: UnitConverter;
}

Properties

Properties

measure?: string

The physical measure being converted (temperature, volume, pressure, etc.). This helps the system understand what type of conversion to perform.

from?: UnitConverter

Source unit configuration (typically backend storage units). Defines the unit system and specific unit that values are stored in.

to?: UnitConverter

Target unit configuration (display units). Defines how values should be displayed to users, including regional preferences.