Add typing fixes, import cleanup, and staticmethod

Update type hints and imports across several modules: splash.py now uses union return types (QPixmap | None, QSplashScreen | None) to reflect possible None returns; processor_utils.py adds from __future__ import annotations, imports import_module and replaces importlib.import_module calls for clearer imports; display.py marks BBoxColors.get_all_display_names as @staticmethod. These changes improve typing clarity and minor API correctness.

Author: C-Achard

dlclivegui/gui/misc/splash.py

@@ -19,7 +19,7 @@ class SplashConfig:
     bg_color = Qt.black  # Fallback background color when image is missing
 
 
-def build_splash_pixmap(cfg: SplashConfig) -> QPixmap:
+def build_splash_pixmap(cfg: SplashConfig) -> QPixmap | None:
     """
     Build a splash pixmap from config. If the image is invalid, returns a filled pixmap
     with fallback size and background color.
@@ -35,7 +35,7 @@ def build_splash_pixmap(cfg: SplashConfig) -> QPixmap:
     return None
 
 
-def show_splash(cfg: SplashConfig) -> QSplashScreen:
+def show_splash(cfg: SplashConfig) -> QSplashScreen | None:
     """
     Create and show the splash screen from config. Returns the QSplashScreen instance.
     The caller is responsible for closing it.

dlclivegui/processors/processor_utils.py

@@ -1,8 +1,11 @@
+from __future__ import annotations
+
 import importlib.util
 import inspect
 import logging
 import pkgutil
 import sys
+from importlib import import_module
 from importlib.resources import as_file, files
 from pathlib import Path
 
@@ -45,7 +48,7 @@ def scan_processor_package(package_name: str = "dlclivegui.processors") -> dict[
     all_processors: dict[str, dict] = {}
 
     try:
-        pkg = importlib.import_module(package_name)
+        pkg = import_module(package_name)
     except Exception:
         logger.exception(f"Could not import package '{package_name}'")
         return all_processors
@@ -55,7 +58,7 @@ def scan_processor_package(package_name: str = "dlclivegui.processors") -> dict[
         if ispkg:
             continue
         try:
-            mod = importlib.import_module(mod_name)
+            mod = import_module(mod_name)
 
             # Prefer module-level registry function if present
             if hasattr(mod, "get_available_processors"):

dlclivegui/utils/display.py

@@ -18,6 +18,7 @@ class BBoxColors(enum.Enum):
     WHITE = (255, 255, 255)
     BLACK = (0, 0, 0)
 
+    @staticmethod
     def get_all_display_names() -> list[str]:
         return [color.name.capitalize() for color in BBoxColors]