#7805: Ensure all references to mode are Literals, not str. (#7807)

Author: Julian-O

stubs/Pillow/PIL/Image.pyi

@@ -105,7 +105,7 @@ class Image:
     format: ClassVar[str | None]
     format_description: ClassVar[str | None]
     im: Any
-    mode: str
+    mode: _Mode
     palette: Any
     info: dict[Any, Any]
     readonly: int
@@ -132,7 +132,7 @@ class Image:
     def verify(self) -> None: ...
     def convert(
         self,
-        mode: str | None = ...,
+        mode: _Mode | None = ...,
         matrix: _ConversionMatrix | None = ...,
         dither: int | None = ...,
         palette: Literal[0, 1] = ...,
@@ -149,7 +149,7 @@ class Image:
     def copy(self) -> Image: ...
     __copy__ = copy
     def crop(self, box: _Box | None = ...) -> Image: ...
-    def draft(self, mode: str, size: _Size) -> None: ...
+    def draft(self, mode: _Mode, size: _Size) -> None: ...
     def filter(self, filter: Filter | Callable[[], Filter]) -> Image: ...
     def getbands(self) -> tuple[str, ...]: ...
     def getbbox(self) -> tuple[int, int, int, int] | None: ...
@@ -165,10 +165,10 @@ class Image:
     def entropy(self, mask: Image | None = ..., extrema: tuple[int, int] | tuple[float, float] | None = ...) -> float: ...
     def paste(self, im: Image, box: tuple[float, float] | _Box | None = ..., mask: Image | None = ...) -> None: ...
     def alpha_composite(self, im: Image, dest: tuple[int, int] = ..., source: tuple[int, int] = ...) -> None: ...
-    def point(self, lut, mode: str | None = ...) -> Image: ...
+    def point(self, lut, mode: _Mode | None = ...) -> Image: ...
     def putalpha(self, alpha: Image | int) -> None: ...
     def putdata(self, data: Sequence[int], scale: float = ..., offset: float = ...) -> None: ...
-    def putpalette(self, data: ImagePalette | bytes | Iterable[int] | SupportsBytes, rawmode: str | None = ...) -> None: ...
+    def putpalette(self, data: ImagePalette | bytes | Iterable[int] | SupportsBytes, rawmode: _Mode | None = ...) -> None: ...
     def putpixel(self, xy: tuple[int, int], value: _Color | list[float]) -> None: ...
     def remap_palette(self, dest_map: Iterable[int], source_palette: Sequence[int] | None = ...) -> Image: ...
     def resize(
@@ -233,7 +233,7 @@ def alpha_composite(im1: Image, im2: Image) -> Image: ...
 def blend(im1: Image, im2: Image, alpha: float) -> Image: ...
 def composite(image1: Image, image2: Image, mask: Image) -> Image: ...
 def eval(image: Image, *args) -> Image: ...
-def merge(mode: str, bands: Sequence[Image]) -> Image: ...
+def merge(mode: _Mode, bands: Sequence[Image]) -> Image: ...
 def register_open(id: str, factory, accept=...) -> None: ...
 def register_mime(id: str, mimetype: str) -> None: ...
 def register_save(id: str, driver) -> None: ...
@@ -245,8 +245,8 @@ def register_decoder(name: str, decoder) -> None: ...
 def register_encoder(name: str, encoder) -> None: ...
 def effect_mandelbrot(size: tuple[int, int], extent: tuple[float, float, float, float], quality: int) -> Image: ...
 def effect_noise(size: tuple[int, int], sigma: float) -> Image: ...
-def linear_gradient(mode: str) -> Image: ...
-def radial_gradient(mode: str) -> Image: ...
+def linear_gradient(mode: _Mode) -> Image: ...
+def radial_gradient(mode: _Mode) -> Image: ...
 
 class Exif(MutableMapping[int, Any]):
     def load(self, data: bytes) -> None: ...