feat(patterns): merge pattern styles and add mode support

Consolidate legacy pattern ids into meteor, particles, sparkle, chase,
and colour_cycle with n6/mode style selection; add pattern_modes helper,
self-contained tests/all.py, and preset mode alias on wire.

Co-authored-by: Cursor <cursoragent@cursor.com>

src/patterns/colour_cycle.py

@@ -1,11 +1,24 @@
 import utime
 
+from patterns.pattern_modes import style_mode
+
+_LEGACY = {"rainbow": 1, "gradient_scroll": 0}
+
 
 class ColourCycle:
     def __init__(self, driver):
         self.driver = driver
 
-    def _render(self, colors, phase, brightness):
+    def _wheel(self, pos):
+        if pos < 85:
+            return (pos * 3, 255 - pos * 3, 0)
+        if pos < 170:
+            pos -= 85
+            return (255 - pos * 3, 0, pos * 3)
+        pos -= 170
+        return (0, pos * 3, 255 - pos * 3)
+
+    def _render_gradient(self, colors, phase, brightness):
         num_leds = self.driver.num_leds
         color_count = len(colors)
         if num_leds <= 0 or color_count <= 0:
@@ -15,14 +28,11 @@ class ColourCycle:
             return
 
         full_span = color_count * 256
-        # Match rainbow behaviour: phase is 0..255 and maps to one full-strip shift.
         phase_shift = (phase * full_span) // 256
         for i in range(num_leds):
-            # Position around the colour loop, shifted by phase.
             pos = ((i * full_span) // num_leds + phase_shift) % full_span
             idx = pos // 256
             frac = pos & 255
-
             c1 = colors[idx]
             c2 = colors[(idx + 1) % color_count]
             blended = (
@@ -33,23 +43,55 @@ class ColourCycle:
             self.driver.n[i] = self.driver.apply_brightness(blended, brightness)
         self.driver.n.write()
 
-    def run(self, preset):
-        colors = preset.c if preset.c else [(255, 255, 255)]
-        phase = self.driver.step % 256
-        step_amount = max(1, int(preset.n1))
+    def _render_rainbow(self, phase, brightness):
+        num_leds = self.driver.num_leds
+        for i in range(num_leds):
+            rc_index = (i * 256 // max(1, num_leds)) + phase
+            self.driver.n[i] = self.driver.apply_brightness(
+                self._wheel(rc_index & 255), brightness
+            )
+        self.driver.n.write()
 
+    def run(self, preset):
+        """Scroll gradient (n6=0) or fixed spectrum wheel (n6=1, legacy rainbow).
+
+        n1: step rate
+        n6: 0 gradient scroll, 1 rainbow wheel
+        """
+        mode = style_mode(preset, 0, _LEGACY)
+        step_amount = max(1, int(preset.n1) if int(preset.n1) > 0 else 1)
+        phase = self.driver.step % 256
+
+        if mode == 1:
+            if not preset.a:
+                self._render_rainbow(phase, preset.b)
+                self.driver.step = (phase + step_amount) % 256
+                yield
+                return
+            last_update = utime.ticks_ms()
+            while True:
+                delay_ms = max(1, int(preset.d))
+                now = utime.ticks_ms()
+                if utime.ticks_diff(now, last_update) >= delay_ms:
+                    self._render_rainbow(phase, preset.b)
+                    phase = (phase + step_amount) % 256
+                    self.driver.step = phase
+                    last_update = utime.ticks_add(last_update, delay_ms)
+                yield
+
+        colors = preset.c if preset.c else [(255, 0, 0), (0, 0, 255)]
         if not preset.a:
-            self._render(colors, phase, preset.b)
+            self._render_gradient(colors, phase, preset.b)
             self.driver.step = (phase + step_amount) % 256
             yield
             return
 
         last_update = utime.ticks_ms()
         while True:
-            current_time = utime.ticks_ms()
             delay_ms = max(1, int(preset.d))
-            if utime.ticks_diff(current_time, last_update) >= delay_ms:
-                self._render(colors, phase, preset.b)
+            now = utime.ticks_ms()
+            if utime.ticks_diff(now, last_update) >= delay_ms:
+                self._render_gradient(colors, phase, preset.b)
                 phase = (phase + step_amount) % 256
                 self.driver.step = phase
                 last_update = utime.ticks_add(last_update, delay_ms)