Update README, CHANGELOG and sample for post-review API changes

Author: kevbite

CHANGELOG.md

@@ -39,6 +39,22 @@ rather than deprecated, so consuming code must be updated.
   request types, preventing accidental round-tripping of read-only fields.
 - Posting state is now done through intent methods or `UpdateState(...)` rather than mutating
   and re-posting a response object.
+- **`SetColor`/`SetEffect`/`SetPalette` with no `segmentId` now target the *selected* segments**
+  (the WLED `"seg":{…}` object form) instead of segment 0. The state `seg` field is modelled as
+  a `SegmentPayload` union that serialises as either an object (selected segments) or an array
+  (id-targeted).
+- **Transition values (`transition`/`tt`) widened from `byte` to `ushort`** to support the
+  documented `0–65535` range (~109 minutes) instead of clamping at 25.5 s.
+- **`ColorTemperature.Kelvin` range widened to `1000–20000 K`** to match the docs' forward-
+  compatible guidance, with a new `ColorTemperature.KelvinUnchecked(int)` escape hatch for
+  values outside that range.
+
+### Added
+
+- **Ranged-random effect/palette selection** via `Selector.RandomInRange(from, to)`
+  (the WLED `"from~tor"` token).
+- **Typed device-configuration fields** for `id.mdns`, `if.mqtt` (`en`/`broker`/`port`/`user`/`cid`)
+  and `def` (`on`/`bri`/`ps`), while preserving all other keys through `JsonExtensionData`.
 
 ### Removed
 

README.md

@@ -51,13 +51,19 @@ await client.TurnOff();
 await client.Toggle();
 
 await client.SetBrightness(200);
-await client.SetColor(RgbColor.FromHex("FFAA00"));
-await client.SetEffect(9);    // by effect id
-await client.SetPalette(11);  // by palette id
+await client.SetColor(RgbColor.FromHex("FFAA00"));   // selected segments
+await client.SetColor(RgbColor.FromHex("FFAA00"), segmentId: 1);
+await client.SetEffect(9);                            // by effect id
+await client.SetPalette(11);                          // by palette id
+await client.SetEffect(Selector.Random);             // random effect
+await client.SetPalette(Selector.RandomInRange(5, 10)); // random palette in a range
 
 await client.Reboot();
 ```
 
+With no `segmentId`, `SetColor`/`SetEffect`/`SetPalette` target the currently *selected*
+segments (the WLED `"seg":{…}` object form); pass a `segmentId` to target one segment.
+
 ### Reading data
 
 ```csharp
@@ -76,6 +82,7 @@ Build a sparse update that only sends the fields you set:
 await client.UpdateState(update => update
     .TurnOn()
     .Brightness(128)
+    .Transition(TimeSpan.FromSeconds(2))   // crossfade, up to ~109 minutes
     .Segment(0, segment => segment
         .Effect(0)
         .Color(RgbColor.FromHex("0066FF"))

samples/BasicConsole/Program.cs

@@ -7,9 +7,9 @@
 
 await client.TurnOn();
 await client.SetBrightness(200);
-await client.SetColor(RgbColor.FromHex("FFAA00"));   // warm orange
+await client.SetColor(RgbColor.FromHex("FFAA00"));   // warm orange, selected segments
 await client.SetEffect(9);                            // "Rainbow"
-await client.SetPalette(11);                          // "Rainbow"
+await client.SetPalette(Selector.RandomInRange(5, 10)); // random palette in a range
 
 // --- Reading state ---------------------------------------------------------
 
@@ -24,6 +24,7 @@
 await client.UpdateState(update => update
     .TurnOn()
     .Brightness(128)
+    .Transition(TimeSpan.FromSeconds(2))
     .Segment(0, segment => segment
         .Effect(0)
         .Color(RgbColor.FromHex("0066FF"))));