feat: add py.typed marker and fix strict mypy errors

Author: g4bri3lDev

packages/python/pyproject.toml

@@ -23,6 +23,7 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Topic :: Multimedia :: Graphics",
+    "Typing :: Typed",
 ]
 
 dependencies = [

packages/python/src/epaper_dithering/algorithms.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
+from typing import cast
 
 import numpy as np
 from PIL import Image
@@ -195,7 +196,7 @@ def error_diffusion_dither(
         if tone_compression == "auto":
             pixels_linear = auto_compress_dynamic_range(pixels_linear, palette_linear)
         else:
-            pixels_linear = compress_dynamic_range(pixels_linear, palette_linear, tone_compression)
+            pixels_linear = compress_dynamic_range(pixels_linear, palette_linear, cast(float, tone_compression))
 
     # Pre-compute palette LAB components for scalar per-pixel matching
     palette_L, palette_a, palette_b, palette_C = precompute_palette_lab(palette_linear)
@@ -485,7 +486,7 @@ def direct_palette_map(
         if tone_compression == "auto":
             pixels_linear = auto_compress_dynamic_range(pixels_linear, palette_linear)
         else:
-            pixels_linear = compress_dynamic_range(pixels_linear, palette_linear, tone_compression)
+            pixels_linear = compress_dynamic_range(pixels_linear, palette_linear, cast(float, tone_compression))
 
     # Find closest palette color for ALL pixels at once using LAB
     output_pixels = find_closest_palette_color_lab(pixels_linear, palette_linear)
@@ -555,7 +556,7 @@ def ordered_dither(
         if tone_compression == "auto":
             pixels_linear = auto_compress_dynamic_range(pixels_linear, palette_linear)
         else:
-            pixels_linear = compress_dynamic_range(pixels_linear, palette_linear, tone_compression)
+            pixels_linear = compress_dynamic_range(pixels_linear, palette_linear, cast(float, tone_compression))
 
     # ===== VECTORIZED ORDERED DITHERING =====
 

packages/python/src/epaper_dithering/color_space_lab.py

@@ -143,7 +143,7 @@ def find_closest_palette_color_lab(
 def _lab_f(t: float) -> float:
     """CIE LAB nonlinear function (scalar version)."""
     if t > _EPSILON:
-        return t ** (1.0 / 3.0)
+        return float(t ** (1.0 / 3.0))
     return (_KAPPA * t + 16.0) / 116.0
 
 

packages/python/src/epaper_dithering/py.typed

@@ -9,6 +9,8 @@
 
 from __future__ import annotations
 
+from typing import cast
+
 import numpy as np
 
 # ITU-R BT.709 luminance coefficients (same as sRGB)
@@ -83,7 +85,7 @@ def compress_dynamic_range(
         result[near_black, 1] = black_level
         result[near_black, 2] = black_level
 
-    return np.clip(result, 0.0, 1.0)
+    return cast(np.ndarray, np.clip(result, 0.0, 1.0))
 
 
 def auto_compress_dynamic_range(
@@ -153,4 +155,4 @@ def auto_compress_dynamic_range(
         result[near_black, 1] = black_Y
         result[near_black, 2] = black_Y
 
-    return np.clip(result, 0.0, 1.0)
+    return cast(np.ndarray, np.clip(result, 0.0, 1.0))