Modify function to append dummy clear value if not provided (#1231)

closes
RaspberryPiFoundation/digital-editor-issues#610

Tested using -
```
_ish.colourRead = lambda: [100, 150, 200, 128]

sh = SenseHat()

# TEST 1: Full colour tuple
rgba = sh.colour.colour
assert isinstance(rgba, tuple), "colour should return a tuple"
assert len(rgba) == 4, "colour should return a 4-tuple (R, G, B, Clear)"
assert rgba == (100, 150, 200, 128), f"Unexpected colour values: {rgba}"

# TEST 2: Individual colour components
assert sh.colour.red == 100, f"Red value incorrect: {sh.colour.red}"
assert sh.colour.green == 150, f"Green value incorrect: {sh.colour.green}"
assert sh.colour.blue == 200, f"Blue value incorrect: {sh.colour.blue}"
assert sh.colour.clear == 128, f"Clear value incorrect: {sh.colour.clear}"

# TEST 3: Aliases
assert sh.colour.color == sh.colour.colour, "color alias not matching colour"
assert sh.colour.color_raw == sh.colour.colour_raw, "color_raw alias not matching colour_raw"

# TEST 4: Raw colour data
raw = sh.colour.colour_raw
assert isinstance(raw, tuple), "colour_raw should return a tuple"
assert raw == (100, 150, 200, 128), f"Unexpected raw values: {raw}"

print("✅ All tests passed successfully!")
```

Author: jamiebenstead

CHANGELOG.md

@@ -15,6 +15,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Enabled `hyphens: auto` globally (with exceptions) to prevent overflow with longer words (#1215)
 - Removed fixed size from `ProjectBar` to prevent overflow when text wraps (#1221)
 - Added missing translation strings (#1222)
+- Changed `colour_raw` to now correctly return a 4-tuple (R, G, B, Clear) in simulation
 
 ## Changed
 

public/shims/sense_hat/sense_hat_blob.py

@@ -673,7 +673,14 @@ def max_raw(self):
 
     @property
     def colour_raw(self):
-        return _ish.colourRead()
+      """
+      Ensure a 4 length tuple is returned even if simulation only provides 3 values
+      """
+      data = _ish.colourRead()
+      if len(data) == 3:
+        data.append(256)  # Append dummy Clear value
+      return tuple(data)
+
 
     @property
     def red_raw(self):
@@ -1507,7 +1514,7 @@ def get_compass(self):
         # but the emulator cannot do fusionPose as we derive everything from the orientation.
         # Therefore, we a shortcut and read directly from our internal module that applies compass tilt compensation algorithm
         # and returns the heading in radians.
-        
+
         deg = math.degrees(_ish.headingRead())
 
         return deg + 360 if deg < 0 else deg