Enable PYI checks.

colour/adaptation/cmccat2000.py

@@ -22,7 +22,7 @@
 
 from __future__ import annotations
 
-from typing import NamedTuple
+from dataclasses import dataclass
 
 import numpy as np
 
@@ -31,6 +31,7 @@
 from colour.hints import ArrayLike, Literal, NDArrayFloat
 from colour.utilities import (
     CanonicalMapping,
+    MixinDataclassIterable,
     as_float_array,
     from_range_100,
     to_domain_100,
@@ -61,7 +62,8 @@
 """
 
 
-class InductionFactors_CMCCAT2000(NamedTuple):
+@dataclass(frozen=True)
+class InductionFactors_CMCCAT2000(MixinDataclassIterable):
     """
     *CMCCAT2000* chromatic adaptation model induction factors.
 

colour/adaptation/fairchild2020.py

@@ -17,7 +17,7 @@
 
 from __future__ import annotations
 
-from collections import namedtuple
+from dataclasses import dataclass
 
 import numpy as np
 
@@ -26,6 +26,7 @@
 from colour.hints import ArrayLike, Literal, NDArrayFloat
 from colour.utilities import (
     CanonicalMapping,
+    MixinDataclassIterable,
     as_float_array,
     from_range_1,
     row_as_diagonal,
@@ -49,9 +50,8 @@
 ]
 
 
-class Coefficients_DegreeOfAdaptation_vK20(
-    namedtuple("Coefficients_DegreeOfAdaptation_vK20", ("D_n", "D_r", "D_p"))
-):
+@dataclass(frozen=True)
+class Coefficients_DegreeOfAdaptation_vK20(MixinDataclassIterable):
     """
     *Von Kries 2020* (*vK20*) degree of adaptation coefficients.
 
@@ -69,6 +69,10 @@ class Coefficients_DegreeOfAdaptation_vK20(
     :cite:`Fairchild2020`
     """
 
+    D_n: float
+    D_r: float
+    D_p: float
+
 
 CONDITIONS_DEGREE_OF_ADAPTATION_VK20: CanonicalMapping = CanonicalMapping(
     {
@@ -200,7 +204,7 @@ def matrix_chromatic_adaptation_vk20(
 
     M = CHROMATIC_ADAPTATION_TRANSFORMS[transform]
 
-    D_n, D_r, D_p = coefficients
+    D_n, D_r, D_p = coefficients.values
 
     LMS_n = vecmul(M, XYZ_n)
     LMS_r = vecmul(M, XYZ_r)

colour/algebra/common.py

@@ -18,6 +18,7 @@
     Callable,
     Literal,
     NDArrayFloat,
+    Self,
     Tuple,
     cast,
 )
@@ -202,7 +203,7 @@ def __init__(
         self._mode = optional(mode, get_sdiv_mode())
         self._previous_mode = get_sdiv_mode()
 
-    def __enter__(self) -> sdiv_mode:
+    def __enter__(self) -> Self:
         """
         Set the *Colour* safe division function mode upon entering the context
         manager.
@@ -411,7 +412,7 @@ def __init__(self, enable: bool) -> None:
         self._enable = enable
         self._previous_state = is_spow_enabled()
 
-    def __enter__(self) -> spow_enable:
+    def __enter__(self) -> Self:
         """
         Set the *Colour* safe / symmetrical power function enabled state
         upon entering the context manager.

colour/appearance/cam16.py

@@ -20,7 +20,6 @@
 
 from __future__ import annotations
 
-from collections import namedtuple
 from dataclasses import astuple, dataclass, field
 
 import numpy as np
@@ -54,6 +53,7 @@
 from colour.utilities import (
     CanonicalMapping,
     MixinDataclassArithmetic,
+    MixinDataclassIterable,
     as_float,
     as_float_array,
     from_range_100,
@@ -89,7 +89,8 @@
 """Inverse adaptation matrix :math:`M^{-1}_{16}`."""
 
 
-class InductionFactors_CAM16(namedtuple("InductionFactors_CAM16", ("F", "c", "N_c"))):
+@dataclass(frozen=True)
+class InductionFactors_CAM16(MixinDataclassIterable):
     """
     *CAM16* colour appearance model induction factors.
 
@@ -112,6 +113,10 @@ class InductionFactors_CAM16(namedtuple("InductionFactors_CAM16", ("F", "c", "N_
     :cite:`Li2017`
     """
 
+    F: float
+    c: float
+    N_c: float
+
 
 VIEWING_CONDITIONS_CAM16: CanonicalMapping = CanonicalMapping(
     VIEWING_CONDITIONS_CIECAM02

colour/appearance/ciecam02.py

@@ -32,7 +32,6 @@
 
 from __future__ import annotations
 
-from collections import namedtuple
 from dataclasses import astuple, dataclass, field
 
 import numpy as np
@@ -51,6 +50,7 @@
 from colour.utilities import (
     CanonicalMapping,
     MixinDataclassArithmetic,
+    MixinDataclassIterable,
     as_float,
     as_float_array,
     as_int_array,
@@ -117,9 +117,8 @@
 """Inverse CAT02 chromatic adaptation transform."""
 
 
-class InductionFactors_CIECAM02(
-    namedtuple("InductionFactors_CIECAM02", ("F", "c", "N_c"))
-):
+@dataclass(frozen=True)
+class InductionFactors_CIECAM02(MixinDataclassIterable):
     """
     *CIECAM02* colour appearance model induction factors.
 
@@ -138,6 +137,10 @@ class InductionFactors_CIECAM02(
     :cite:`Wikipedia2007a`
     """
 
+    F: float
+    c: float
+    N_c: float
+
 
 VIEWING_CONDITIONS_CIECAM02: CanonicalMapping = CanonicalMapping(
     {

colour/appearance/ciecam16.py

@@ -20,7 +20,6 @@
 
 from __future__ import annotations
 
-from collections import namedtuple
 from dataclasses import astuple, dataclass, field
 
 import numpy as np
@@ -53,6 +52,7 @@
 from colour.utilities import (
     CanonicalMapping,
     MixinDataclassArithmetic,
+    MixinDataclassIterable,
     as_float,
     as_float_array,
     from_range_100,
@@ -84,9 +84,8 @@
 ]
 
 
-class InductionFactors_CIECAM16(
-    namedtuple("InductionFactors_CIECAM16", ("F", "c", "N_c"))
-):
+@dataclass(frozen=True)
+class InductionFactors_CIECAM16(MixinDataclassIterable):
     """
     *CIECAM16* colour appearance model induction factors.
 
@@ -109,6 +108,10 @@ class InductionFactors_CIECAM16(
     :cite:`CIEDivision12022`
     """
 
+    F: float
+    c: float
+    N_c: float
+
 
 VIEWING_CONDITIONS_CIECAM16: CanonicalMapping = CanonicalMapping(
     VIEWING_CONDITIONS_CIECAM02

colour/appearance/hellwig2022.py

@@ -24,7 +24,6 @@
 
 from __future__ import annotations
 
-from collections import namedtuple
 from dataclasses import astuple, dataclass, field
 
 import numpy as np
@@ -53,6 +52,7 @@
 from colour.utilities import (
     CanonicalMapping,
     MixinDataclassArithmetic,
+    MixinDataclassIterable,
     as_float,
     as_float_array,
     from_range_100,
@@ -91,9 +91,8 @@
 ]
 
 
-class InductionFactors_Hellwig2022(
-    namedtuple("InductionFactors_Hellwig2022", ("F", "c", "N_c"))
-):
+@dataclass(frozen=True)
+class InductionFactors_Hellwig2022(MixinDataclassIterable):
     """
     *Hellwig and Fairchild (2022)* colour appearance model induction factors.
 
@@ -116,6 +115,10 @@ class InductionFactors_Hellwig2022(
     :cite:`Fairchild2022`, :cite:`Hellwig2022`
     """
 
+    F: float
+    c: float
+    N_c: float
+
 
 VIEWING_CONDITIONS_HELLWIG2022: CanonicalMapping = CanonicalMapping(
     VIEWING_CONDITIONS_CIECAM02

colour/appearance/hunt.py

@@ -19,7 +19,6 @@
 
 from __future__ import annotations
 
-from collections import namedtuple
 from dataclasses import dataclass, field
 
 import numpy as np
@@ -29,6 +28,7 @@
 from colour.utilities import (
     CanonicalMapping,
     MixinDataclassArithmetic,
+    MixinDataclassIterable,
     as_float,
     as_float_array,
     from_range_degrees,
@@ -79,9 +79,8 @@
 ]
 
 
-class InductionFactors_Hunt(
-    namedtuple("InductionFactors_Hunt", ("N_c", "N_b", "N_cb", "N_bb"))
-):
+@dataclass(frozen=True)
+class InductionFactors_Hunt(MixinDataclassIterable):
     """
     *Hunt* colour appearance model induction factors.
 
@@ -105,19 +104,10 @@ class InductionFactors_Hunt(
     :cite:`Fairchild2013u`, :cite:`Hunt2004b`
     """
 
-    def __new__(
-        cls,
-        N_c: float,
-        N_b: float,
-        N_cb: float | None = None,
-        N_bb: float | None = None,
-    ) -> InductionFactors_Hunt:
-        """
-        Return a new instance of the
-        :class:`colour.appearance.InductionFactors_Hunt` class.
-        """
-
-        return super().__new__(cls, N_c, N_b, N_cb, N_bb)
+    N_c: float
+    N_b: float
+    N_cb: float | None = field(default_factory=lambda: None)
+    N_bb: float | None = field(default_factory=lambda: None)
 
 
 VIEWING_CONDITIONS_HUNT: CanonicalMapping = CanonicalMapping(

colour/appearance/kim2009.py

@@ -21,7 +21,6 @@
 
 from __future__ import annotations
 
-from collections import namedtuple
 from dataclasses import astuple, dataclass, field
 
 import numpy as np
@@ -42,6 +41,7 @@
 from colour.utilities import (
     CanonicalMapping,
     MixinDataclassArithmetic,
+    MixinDataclassIterable,
     as_float,
     as_float_array,
     from_range_100,
@@ -72,9 +72,8 @@
 ]
 
 
-class InductionFactors_Kim2009(
-    namedtuple("InductionFactors_Kim2009", ("F", "c", "N_c"))
-):
+@dataclass(frozen=True)
+class InductionFactors_Kim2009(MixinDataclassIterable):
     """
     *Kim, Weyrich and Kautz (2009)* colour appearance model induction factors.
 
@@ -102,6 +101,10 @@ class InductionFactors_Kim2009(
     :cite:`Kim2009`
     """
 
+    F: float
+    c: float
+    N_c: float
+
 
 VIEWING_CONDITIONS_KIM2009: CanonicalMapping = CanonicalMapping(
     VIEWING_CONDITIONS_CIECAM02
@@ -116,7 +119,8 @@ class InductionFactors_Kim2009(
 """
 
 
-class MediaParameters_Kim2009(namedtuple("MediaParameters_Kim2009", ("E",))):
+@dataclass(frozen=True)
+class MediaParameters_Kim2009:
     """
     *Kim, Weyrich and Kautz (2009)* colour appearance model media parameters.
 
@@ -130,13 +134,7 @@ class MediaParameters_Kim2009(namedtuple("MediaParameters_Kim2009", ("E",))):
     :cite:`Kim2009`
     """
 
-    def __new__(cls, E: float) -> MediaParameters_Kim2009:
-        """
-        Return a new instance of the
-        :class:`colour.appearance.MediaParameters_Kim2009` class.
-        """
-
-        return super().__new__(cls, E)
+    E: float
 
 
 MEDIA_PARAMETERS_KIM2009: CanonicalMapping = CanonicalMapping(