Version 2.0.2: Validation Support for Electrical Conductivity and Wireless Signal Strength

✨ NEW FEATURES:

• Enhanced ScaleUnitValidationUtilities: Added comprehensive validation support for two additional scale types
  • ElectricalConductivity: Validates all electrical conductivity units (S/m, mS/cm, µS/cm, mho/cm, Ω⁻¹·m⁻¹, etc.)
  • WirelessSignalStrength: Validates all wireless signal strength units (dBm, dBW, dBµW, RSSI, W, %, etc.)
• Type-Safe Validation: ScaleUnitValidationUtilities.IsValid() now supports all 12 scale types
• Comprehensive Test Coverage: Added extensive unit tests for both new validation types
  • Tests for valid and invalid unit codes
  • Tests for type/code mismatch scenarios
  • Tests for null and empty code handling

🔧 IMPROVEMENTS:

• Complete validation coverage across all scale types in the library
• Better error handling with InvalidScaleUnitException for invalid units
• Improved API consistency for validation methods

📖 USAGE EXAMPLES:

Electrical Conductivity Validation:

// Using IsValid with ScaleUnit object
var ecUnit = new ElectricalConductivityUnit(ScaleTypes.ElectricalConductivity, "SIEMENS_PER_METER");
bool isValid = ScaleUnitValidationUtilities.IsValid(ecUnit); // Returns true

// Using IsValid with type and code
bool isValid = ScaleUnitValidationUtilities.IsValid(
    ScaleTypes.ElectricalConductivity, 
    ElectricalConductivityUnitCodes.MillisiemensPerCentimeter
); // Returns true

// Using Validate (throws exception if invalid)
ScaleUnitValidationUtilities.Validate(ecUnit); // Does not throw

Wireless Signal Strength Validation:

// Using IsValid with ScaleUnit object
var wirelessUnit = new WirelessSignalStrengthUnit(ScaleTypes.WirelessSignalStrength, "DBM");
bool isValid = ScaleUnitValidationUtilities.IsValid(wirelessUnit); // Returns true

// Using IsValid with type and code
bool isValid = ScaleUnitValidationUtilities.IsValid(
    ScaleTypes.WirelessSignalStrength, 
    WirelessSignalStrengthUnitCodes.RSSI
); // Returns true

// Using Validate (throws exception if invalid)
ScaleUnitValidationUtilities.Validate(wirelessUnit); // Does not throw

Error Handling:

var invalidUnit = new ElectricalConductivityUnit(ScaleTypes.ElectricalConductivity, "INVALID_CODE");
try 
{
    ScaleUnitValidationUtilities.Validate(invalidUnit);
}
catch (InvalidScaleUnitException ex) 
{
    Console.WriteLine($"Invalid unit: {ex.Type} - {ex.Code}");
    // Output: "Invalid unit: ElectricalConductivity - INVALID_CODE"
}

Version 2.0.1: GenericScaleUnit for JSON Serialization/Deserialization

✨ NEW FEATURES:

• GenericScaleUnit Class: Introduced new GenericScaleUnit class for improved JSON serialization and deserialization
  • Enables dynamic unit type handling in JSON scenarios
  • Supports all scale types (Weight, Length, Volume, Temperature, Speed, Velocity, Angle, Voltage, Illuminance, Concentration, WirelessSignalStrength, ElectricalConductivity)
  • Seamless integration with existing ScaleUnit hierarchy
  • Ideal for API responses and data transfer objects requiring flexible unit representation

🔧 IMPROVEMENTS:

• Enhanced JSON compatibility across the library
• Better support for dynamic unit type scenarios

Version 2.0.0: MAJOR RELEASE - Breaking Changes and Symbol Display Enhancements

⚠️ BREAKING CHANGES - MAJOR VERSION UPDATE:

• API Method Renamed: GetAvailableUnits() → GetAvailableUnitCodes() in all *ConversionTreeUtilities classes
  • Old method name is no longer available
  • GetAvailableUnitCodes() returns string[] (unit codes only)
  • New GetAvailableUnits() returns strongly-typed ScaleUnit arrays with metadata
• Return Type Changed: GetAvailableUnits() now returns ScaleUnit-derived types instead of string[]
  • Migration required for existing code using GetAvailableUnits()
  • See Migration Guide below for step-by-step instructions

✨ NEW FEATURES:

• Rich Unit Objects: New GetAvailableUnits() method returns strongly-typed unit classes:
  • WeightUnit[], LengthUnit[], VolumeUnit[], TemperatureUnit[]
  • SpeedUnit[], VelocityUnit[], AngleUnit[], VoltageUnit[]
  • IlluminanceUnit[], ConcentrationUnit[], WirelessSignalStrengthUnit[], ElectricalConductivityUnit[]
• Enhanced Metadata: Each unit object includes Type, Code, and Symbol properties
• Symbol Support: Added ScaleUnitDto.Symbol property for API responses with proper Unicode encoding
• ConversionTree.Code Property: Added missing Code property for better API consistency

🐛 BUG FIXES - Unicode Symbol Display:

• Fixed all Unicode character encoding issues across the library:
  • µ (micro): Microgram, Microvolt, Microwatt, Microsiemens, etc.
  • ℥ (apothecary ounce): Weight units
  • ℧ (mho): Electrical conductivity units
  • Ω (omega/ohm): Electrical conductivity units
  • ° (degree): Angle units
  • π (pi): Angle units (radians)
  • ∟ (right angle): Angle units (was showing as ?)
  • ² (superscript 2): Square units (m², ft², in²)
  • ³ (superscript 3): Cubic units (m³, ft³, in³)
• Fixed missing symbols in IlluminanceUnitCodes: mlx, klx, lm/m², lm/ft², lm/in²
• Fixed missing symbols in VelocityUnitCodes: cm/s, mm/s, in/s, yd/s, c, M
• Fixed typo: Footcandle → FootCandle in IlluminanceUnitCodes
• All source files re-saved with UTF-8 BOM encoding

🔧 IMPROVEMENTS:

• Enhanced web application UTF-8 encoding in Program.cs and _Layout.cshtml
• Added JavaScriptEncoder.UnsafeRelaxedJsonEscaping for proper JSON serialization
• Comprehensive XML documentation for all GetSymbol() methods
• Improved IntelliSense support with rich unit metadata
• Better type safety throughout the library
• Consistent API patterns across all conversion utilities

📖 MIGRATION GUIDE - Upgrading from 1.x to 2.0:

Before (1.x):

string[] units = WeightConversionTreeUtilities.GetAvailableUnits();
// Returns: ["KILOGRAM", "GRAM", "POUND", ...]

After (2.0):

// Option 1: Get unit codes (same as before)
string[] unitCodes = WeightConversionTreeUtilities.GetAvailableUnitCodes();
// Returns: ["KILOGRAM", "GRAM", "POUND", ...]

// Option 2: Get rich unit objects (NEW!)
WeightUnit[] units = WeightConversionTreeUtilities.GetAvailableUnits();
// Each unit has: Type (ScaleTypes.Weight), Code ("KILOGRAM"), Symbol ("kg")

// Access unit properties:
foreach (var unit in units)
{
    Console.WriteLine($"{unit.Code}: {unit.Symbol} ({unit.Type})");
}

Quick Migration Steps:

1. Find all calls to GetAvailableUnits() in your code
2. If you only need unit codes (strings), rename to GetAvailableUnitCodes()
3. If you want unit metadata, keep GetAvailableUnits() and update variable types
4. Recompile and test your application

Web Application Note:

• Restart your application after updating
• Clear browser cache (Ctrl+Shift+Delete) for proper symbol display
• Unicode symbols (µ, ℥, ℧, Ω, °, ², ³, ∟) now display correctly

For detailed upgrade assistance, visit: https://gitlab.com/iot93/back-end/commons/uom