feat: add GRAYSCALE_8 and GRAYSCALE_16

Author: g4bri3lDev

README.md

@@ -86,7 +86,7 @@ See [`packages/javascript/README.md`](packages/javascript/README.md) for detaile
 ## Features
 
 - **9 Dithering Algorithms**: NONE, BURKES, ORDERED, FLOYD_STEINBERG, ATKINSON, STUCKI, SIERRA, SIERRA_LITE, JARVIS_JUDICE_NINKE
-- **6 Color Schemes**: MONO, BWR, BWY, BWRY, BWGBRY (Spectra 6), GRAYSCALE_4
+- **8 Color Schemes**: MONO, BWR, BWY, BWRY, BWGBRY (Spectra 6), GRAYSCALE_4, GRAYSCALE_8, GRAYSCALE_16
 - **Multiple Languages**: Python and JavaScript/TypeScript implementations
 - **Universal**: Works in Python, Node.js, and browser environments
 - **Type-Safe**: Full type coverage in both languages

packages/python/README.md

@@ -24,7 +24,7 @@ pip install epaper-dithering
 
 - **Perceptually Correct**: Uses linear RGB color space with gamma correction for accurate error diffusion
 - **8 Dithering Algorithms**: From simple ordered dithering to high-quality Jarvis-Judice-Ninke
-- **6 Color Schemes**: Support for mono, 3-color, 4-color, and 6-color e-paper displays
+- **8 Color Schemes**: Support for mono, 3-color, 4-color, 6-color, and grayscale e-paper displays
 - **Tone Mapping**: Dynamic range compression maps image luminance to the display's actual range for smoother dithering
 - **Serpentine Scanning**: Reduces directional artifacts in error diffusion (enabled by default)
 - **RGBA Support**: Automatic compositing on white background for transparent images
@@ -52,7 +52,9 @@ dithered.save("output.png")
 - **BWY** - Black, white, yellow (3-color)
 - **BWRY** - Black, white, red, yellow (4-color)
 - **BWGBRY** - Black, white, green, blue, red, yellow (6-color Spectra)
-- **GRAYSCALE_4** - 4-level grayscale
+- **GRAYSCALE_4** - 4-level grayscale (2-bit)
+- **GRAYSCALE_8** - 8-level grayscale (3-bit, e.g. Inkplate 10)
+- **GRAYSCALE_16** - 16-level grayscale (4-bit, e.g. Waveshare 6" HD)
 
 ## Dithering Algorithms
 

packages/python/src/epaper_dithering/palettes.py

@@ -104,6 +104,49 @@ class ColorScheme(Enum):
         ),
     )
 
+    # NOTE: Values 6 and 7 are placeholders pending firmware assignment.
+    GRAYSCALE_8 = (
+        6,
+        ColorPalette(
+            colors={
+                "black": (0, 0, 0),
+                "gray1": (36, 36, 36),
+                "gray2": (73, 73, 73),
+                "gray3": (109, 109, 109),
+                "gray4": (146, 146, 146),
+                "gray5": (182, 182, 182),
+                "gray6": (219, 219, 219),
+                "white": (255, 255, 255),
+            },
+            accent="black",
+        ),
+    )
+
+    GRAYSCALE_16 = (
+        7,
+        ColorPalette(
+            colors={
+                "black": (0, 0, 0),
+                "gray1": (17, 17, 17),
+                "gray2": (34, 34, 34),
+                "gray3": (51, 51, 51),
+                "gray4": (68, 68, 68),
+                "gray5": (85, 85, 85),
+                "gray6": (102, 102, 102),
+                "gray7": (119, 119, 119),
+                "gray8": (136, 136, 136),
+                "gray9": (153, 153, 153),
+                "gray10": (170, 170, 170),
+                "gray11": (187, 187, 187),
+                "gray12": (204, 204, 204),
+                "gray13": (221, 221, 221),
+                "gray14": (238, 238, 238),
+                "white": (255, 255, 255),
+            },
+            accent="black",
+        ),
+    )
+
     def __init__(self, value: int, palette: ColorPalette):
         self._value_ = value  # type: ignore[assignment]
         self.palette = palette
@@ -123,7 +166,7 @@ def from_value(cls, value: int) -> ColorScheme:
         """Get ColorScheme from firmware int value.
 
         Args:
-            value: Firmware color scheme value (0-5)
+            value: Firmware color scheme value (0-7)
 
         Returns:
             Matching ColorScheme

packages/python/tests/test_palettes.py

@@ -16,6 +16,8 @@ def test_scheme_has_correct_palette(self):
         assert ColorScheme.BWRY.color_count == 4
         assert ColorScheme.BWGBRY.color_count == 6
         assert ColorScheme.GRAYSCALE_4.color_count == 4
+        assert ColorScheme.GRAYSCALE_8.color_count == 8
+        assert ColorScheme.GRAYSCALE_16.color_count == 16
 
     def test_palette_colors_valid(self):
         """Test all palette colors are valid RGB tuples."""