Merge pull request 'refactor/texte-verbessern' (#11) from refactor/texte-verbessern into master

Reviewed-on: #11

README

@@ -1,16 +0,0 @@
-# Farbmodelle und Farbsystemumwandler
-
-## Zielstellung
-
-Es existieren schon einige Projekte, die sich der Umwandlung von Farben kümmern. Doch aktuell gibt es kein Projekt, das für *PHP 8* geschrieben wurde.
-Deshalb soll das Projekt alle aktuell genutzten Farbmodelle Darstellen und ineinander umwandeln können.
-
-## Hinweise zu den Modell-Klassen
-
-Die Modelle müssen mit den Informationen gefüllt werden. Ein nicht geändertes Modell hat immer die Farbe Weiß.
-Die Werte sind immer reelle Zahlen von '0.0' bis '1.0'. Dadurch sind die Modele vom eigentlichen Einsatz unabhängig.
-Die Klassen haben keinen Alphakanal.
-
-## Hinweise zu den Transformer-Klassen
-
-Das Vorgehen der Umwandlung nimmt die Informationen von [Wikipedia - Liste der Farbräume](https://de.wikipedia.org/wiki/Liste_der_Farbr%C3%A4ume) auf.

README.md

@@ -0,0 +1,38 @@
+# Farbmodelle und Farbsystemumwandler
+
+## Zielstellung
+
+Es existieren schon einige Projekte, die sich der Umwandlung von Farben kümmern. Doch aktuell gibt es kein Projekt, das für *PHP 8* geschrieben wurde.
+Deshalb soll das Projekt alle aktuell genutzten Farbmodelle Darstellen und ineinander umwandeln können.
+
+## Hinweise zu den Modell-Klassen
+
+Die Modelle müssen mit den Informationen gefüllt werden. Ein nicht geändertes Modell hat immer die Farbe Weiß.
+Die Werte sind immer reelle Zahlen von '0.0' bis '1.0'. Dadurch sind die Modele vom eigentlichen Einsatz unabhängig.
+Die Klassen haben keinen Alphakanal.
+
+### Natürliche Modelle
+
+Die Modelle werden auch in der 'natürlichen' Darstellung bereitgestellt.
+
+#### CyanMagentaYellowKey
+
+Alle Werte werden in der Prozent-Schreibweise zur Verfügung gestellt.
+
+#### HueSaturationValue
+
+*Hue* wird als Gradzahl und die anderen Werte als Prozent-Schreibweise zur Verfügung gestellt.
+
+#### RedGreenBlue
+
+Die Werte werden als Hexadecimal Zahlen und in der Webschreibweise zur Verfügung gestellt.
+
+## Hinweise zu den Transformer-Klassen
+
+Das Vorgehen der Umwandlung nimmt die Informationen von 
+[Wikipedia - Liste der Farbräume](https://de.wikipedia.org/wiki/Liste_der_Farbr%C3%A4ume)
+und [Die Chemie-Schule - HSV-Farbraum](https://www.chemie-schule.de/KnowHow/HSV-Farbraum) auf.
+
+### Transformation natürlicher Modelle
+
+Die Klassen benötigen natürliche Modelle und geben auch nur solche raus.

codeception.dist.yml

@@ -0,0 +1,14 @@
+paths:
+    tests: tests
+    output: tests/_output
+    data: tests/_data
+    support: tests/_support
+    envs: tests/_envs
+actor_suffix: Tester
+extensions:
+    enabled:
+        - Codeception\Extension\RunFailed
+coverage:
+    enabled: true
+    include:
+        - src/*

composer.json

@@ -16,15 +16,19 @@
     },
     "autoload-dev": {
         "psr-4": {
-            "TorstenHettstedtUnitTests\\Colors\\" : "tests/unit"
+            "TorstenHettstedt\\Colors\\Tests\\Unit\\" : "tests/unit",
+            "TorstenHettstedt\\Colors\\Tests\\Helper\\" : "tests/_support/Helper"
         }
     },
     "require": {
-        "php": "^8.0"
+        "php": "^8.0",
+        "phpunit/php-code-coverage": "^9.2",
+        "jetbrains/phpstorm-attributes": "^1.0.0"
     },
     "require-dev": {
         "codeception/codeception": "^4.1.18",
         "codeception/module-phpbrowser": "^1.0.0",
-        "codeception/module-asserts": "^1.0.0"
+        "codeception/module-asserts": "^1.3.1",
+        "phpstan/phpstan" : "^1.4.7"
     }
-}
+}

phpstan.neon

@@ -0,0 +1,6 @@
+parameters:
+	level: 6
+	paths:
+		- src
+		- tests/unit
+		- tests/_support/Helper

resources/uml/Klassen-Aufbau.puml

@@ -0,0 +1,77 @@
+@startuml
+'https://plantuml.com/class-diagram
+
+namespace NaturallyColorModels {
+    class CyanMagentaYellowKey
+    class HueSaturationValue
+    class RedGreenBlue
+}
+
+namespace ColorModels {
+    abstract AbstractColorModel
+    class CyanMagentaYellowKey
+    class HueSaturationValue
+    class RedGreenBlue
+    CyanMagentaYellowKey --|> AbstractColorModel
+    HueSaturationValue --|> AbstractColorModel
+    RedGreenBlue --|> AbstractColorModel
+}
+NaturallyColorModels.CyanMagentaYellowKey o-- ColorModels.CyanMagentaYellowKey
+NaturallyColorModels.HueSaturationValue o-- ColorModels.HueSaturationValue
+NaturallyColorModels.RedGreenBlue o-- ColorModels.RedGreenBlue
+
+namespace NaturallyTransformer {
+    interface ColorModelTransformInterface {
+        + toRedGreenBlue(): NaturallyColorModels.RedGreenBlue
+        + toCyanMagentaYellowKey(): NaturallyColorModels.CyanMagentaYellowKey
+        + toHueSaturationValue(): NaturallyColorModels.HueSaturationValue
+    }
+    class CyanMagentaYellowKeyTransformer
+    class HueSaturationValueTransformer
+    class RedGreenBlueTransformer
+
+    NaturallyTransformer.ColorModelTransformInterface o-- Transformer.ColorModelTransformInterface
+
+    NaturallyTransformer.ColorModelTransformInterface <|-- NaturallyTransformer.CyanMagentaYellowKeyTransformer
+    NaturallyTransformer.ColorModelTransformInterface <|-- NaturallyTransformer.HueSaturationValueTransformer
+    NaturallyTransformer.ColorModelTransformInterface <|-- NaturallyTransformer.RedGreenBlueTransformer
+    NaturallyTransformer.RedGreenBlueTransformer o-- NaturallyColorModels.RedGreenBlue
+    NaturallyTransformer.CyanMagentaYellowKeyTransformer o-- NaturallyColorModels.CyanMagentaYellowKey
+    NaturallyTransformer.HueSaturationValueTransformer o-- NaturallyColorModels.HueSaturationValue
+}
+
+namespace Transformer {
+    interface ColorModelTransformInterface {
+        + toRedGreenBlue(): ColorModels.RedGreenBlue
+        + toCyanMagentaYellowKey(): ColorModels.CyanMagentaYellowKey
+        + toHueSaturationValue(): ColorModels.HueSaturationValue
+    }
+    class CyanMagentaYellowKeyTransformer
+    class HueSaturationValueTransformer
+    class RedGreenBlueTransformer
+    Transformer.ColorModelTransformInterface <|-- Transformer.CyanMagentaYellowKeyTransformer
+    Transformer.ColorModelTransformInterface <|-- Transformer.HueSaturationValueTransformer
+    Transformer.ColorModelTransformInterface <|-- Transformer.RedGreenBlueTransformer
+    namespace Utilities {
+        abstract AbstractHueSaturationValueToUtility
+        class CyanMagentaYellowKeyToHueSaturationValue
+        class HueSaturationValueToCyanMagentaYellowKey
+        class HueSaturationValueToRedGreenBlue
+        class RedGreenBlueToHueSaturationValue
+        Transformer.Utilities.CyanMagentaYellowKeyToHueSaturationValue --|> Transformer.Utilities.AbstractHueSaturationValueToUtility
+        Transformer.Utilities.HueSaturationValueToCyanMagentaYellowKey --|> Transformer.Utilities.AbstractHueSaturationValueToUtility
+        Transformer.Utilities.HueSaturationValueToRedGreenBlue --|> Transformer.Utilities.AbstractHueSaturationValueToUtility
+        Transformer.Utilities.RedGreenBlueToHueSaturationValue --|> Transformer.Utilities.AbstractHueSaturationValueToUtility
+    }
+    CyanMagentaYellowKeyTransformer o-- Transformer.Utilities.CyanMagentaYellowKeyToHueSaturationValue
+    CyanMagentaYellowKeyTransformer o-- Transformer.Utilities.HueSaturationValueToRedGreenBlue
+
+    HueSaturationValueTransformer o-- Transformer.Utilities.HueSaturationValueToRedGreenBlue
+    HueSaturationValueTransformer o-- Transformer.Utilities.HueSaturationValueToCyanMagentaYellowKey
+
+    RedGreenBlueTransformer o-- Transformer.Utilities.RedGreenBlueToHueSaturationValue
+    RedGreenBlueTransformer o-- Transformer.Utilities.HueSaturationValueToCyanMagentaYellowKey
+}
+ColorModels.AbstractColorModel --o Transformer.ColorModelTransformInterface
+
+@enduml

src/ColorModels/AbstractColorModel.php

@@ -8,7 +8,7 @@ use InvalidArgumentException;
 abstract class AbstractColorModel
 {
 
-    protected function checkValue(float $value)
+    protected function checkValue(float $value): void
     {
         if ($value > 1.0) {
             throw new InvalidArgumentException('Ein Wert größer als 1 ist nicht definierbar.');

src/ColorModels/CyanMagentaYellowKey.php

@@ -9,11 +9,11 @@ namespace TorstenHettstedt\Colors\ColorModels;
  */
 class CyanMagentaYellowKey extends AbstractColorModel
 {
-    /** @var float : Definition des Cyan-Anteil */
+    /** @var float : Definition des Cyan-Anteils */
     protected float $cyan = 0.0;
-    /** @var float : Definition des Magenta-Anteil */
+    /** @var float : Definition des Magenta-Anteils */
     protected float $magenta = 0.0;
-    /** @var float : Definition des Gelbanteil */
+    /** @var float : Definition des Gelbanteiles */
     protected float $yellow = 0.0;
     /** @var float : Definition des Schwarzanteil */
     protected float $key = 0.0;

src/ColorModels/HueSaturationValue.php

@@ -9,7 +9,7 @@ namespace TorstenHettstedt\Colors\ColorModels;
  */
 class HueSaturationValue extends AbstractColorModel
 {
-    /** @var float : Definition des Farbton als Anteil eines Vollkreises '$Hue * π' */
+    /** @var float : Definition des Farbtones als Anteil eines Vollkreises '$Hue * π' */
     protected float $hue = 0.0;
     /** @var float : Definition der Sättigung der Farbe */
     protected float $saturation = 0.0;

src/ColorModels/RedGreenBlue.php

@@ -8,11 +8,11 @@ namespace TorstenHettstedt\Colors\ColorModels;
  */
 class RedGreenBlue extends AbstractColorModel
 {
-    /** @var float : Definition des Rotanteil */
+    /** @var float : Definition des Rot-Anteils */
     protected float $red = 1.0;
-    /** @var float : Definition des Grünanteil */
+    /** @var float : Definition des Grün-Anteils */
     protected float $green = 1.0;
-    /** @var float : Definition des Grünanteil */
+    /** @var float : Definition des Blau-Anteils */
     protected float $blue = 1.0;
 
     /**

src/NaturallyColorModels/CyanMagentaYellowKey.php

@@ -0,0 +1,109 @@
+<?php
+
+
+namespace TorstenHettstedt\Colors\NaturallyColorModels;
+
+use JetBrains\PhpStorm\Pure;
+use TorstenHettstedt\Colors\ColorModels\CyanMagentaYellowKey as PureCyanMagentaYellowKey;
+
+/**
+ * Definition des allgemeinen CMYK-Farbraumes. Die Werte für die eigenschaften sind reelle Zahlen von 0 bis einschließlich 1.
+ * Ohne Änderung der Eigenschaften wird die Farbe *weiß* dargestellt.
+ */
+class CyanMagentaYellowKey
+{
+    /** @var PureCyanMagentaYellowKey : Standard-Color-Modell */
+    protected PureCyanMagentaYellowKey $pureColor;
+    protected Helper\PercentValues     $percentValuesHelper;
+
+    #[Pure] public function __construct()
+    {
+        $this->pureColor = new PureCyanMagentaYellowKey();
+        $this->percentValuesHelper = new Helper\PercentValues();
+    }
+
+    /**
+     * @return PureCyanMagentaYellowKey
+     */
+    public function getPureColor(): PureCyanMagentaYellowKey
+    {
+        return $this->pureColor;
+    }
+
+    /**
+     * @return int
+     */
+    #[Pure] public function getCyan(): int
+    {
+        return $this->percentValuesHelper->asPercentValue($this->pureColor->getCyan());
+    }
+
+    /**
+     * @param int $cyan
+     * @return CyanMagentaYellowKey
+     */
+    public function setCyan(int $cyan): CyanMagentaYellowKey
+    {
+        $this->percentValuesHelper->checkPercentValue($cyan);
+        $this->pureColor->setCyan($this->percentValuesHelper->fromPercentValue($cyan));
+        return $this;
+    }
+
+    /**
+     * @return int
+     */
+    #[Pure] public function getMagenta(): int
+    {
+        return $this->percentValuesHelper->asPercentValue($this->pureColor->getMagenta());
+    }
+
+    /**
+     * @param int $magenta
+     * @return CyanMagentaYellowKey
+     */
+    public function setMagenta(int $magenta): CyanMagentaYellowKey
+    {
+        $this->percentValuesHelper->checkPercentValue($magenta);
+        $this->pureColor->setMagenta($this->percentValuesHelper->fromPercentValue($magenta));
+        return $this;
+    }
+
+    /**
+     * @return int
+     */
+    #[Pure] public function getYellow(): int
+    {
+        return $this->percentValuesHelper->asPercentValue($this->pureColor->getYellow());
+    }
+
+    /**
+     * @param int $yellow
+     * @return CyanMagentaYellowKey
+     */
+    public function setYellow(int $yellow): CyanMagentaYellowKey
+    {
+        $this->percentValuesHelper->checkPercentValue($yellow);
+        $this->pureColor->setYellow($this->percentValuesHelper->fromPercentValue($yellow));
+        return $this;
+    }
+
+    /**
+     * @return int
+     */
+    #[Pure] public function getKey(): int
+    {
+        return $this->percentValuesHelper->asPercentValue($this->pureColor->getKey());
+    }
+
+    /**
+     * @param int $key
+     * @return CyanMagentaYellowKey
+     */
+    public function setKey(int $key): CyanMagentaYellowKey
+    {
+        $this->percentValuesHelper->checkPercentValue($key);
+        $this->pureColor->setKey($this->percentValuesHelper->fromPercentValue($key));
+        return $this;
+    }
+
+}

src/NaturallyColorModels/Helper/GradValues.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace TorstenHettstedt\Colors\NaturallyColorModels\Helper;
+
+
+use InvalidArgumentException;
+
+class GradValues
+{
+
+    public function asGradValue(float $value): int
+    {
+        return intval(round($value * 360, 0, PHP_ROUND_HALF_UP));
+    }
+
+    public function fromGradValue(int $value): float
+    {
+        return $value / 360.0;
+    }
+
+    public function checkGradValue(int $value): void
+    {
+        if ($value > 360) {
+            throw new InvalidArgumentException('Ein Wert größer als 360° ist nicht definierbar.');
+        }
+        if ($value < 0) {
+            throw new InvalidArgumentException('Ein Wert kleiner als 0° ist nicht definierbar.');
+        }
+    }
+
+}

src/NaturallyColorModels/Helper/HexadecimalValues.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace TorstenHettstedt\Colors\NaturallyColorModels\Helper;
+
+
+use InvalidArgumentException;
+
+class HexadecimalValues
+{
+
+    public function asHexadecimalValue(float $value): int
+    {
+        return intval($value * 0xFF);
+    }
+
+    public function fromHexadecimalValue(int $value): float
+    {
+        return $value / 0xFF;
+    }
+
+    public function checkHexadecimalValue(int $value): void
+    {
+        if ($value > 0xFF) {
+            throw new InvalidArgumentException('Ein Wert größer als "0xFF" ist nicht definierbar.');
+        }
+        if ($value < 0) {
+            throw new InvalidArgumentException('Ein Wert kleiner als "0x00" ist nicht definierbar.');
+        }
+    }
+
+}

src/NaturallyColorModels/Helper/PercentValues.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace TorstenHettstedt\Colors\NaturallyColorModels\Helper;
+
+
+use InvalidArgumentException;
+
+class PercentValues
+{
+
+    public function asPercentValue(float $value): int
+    {
+        return intval(round($value * 100, 0, PHP_ROUND_HALF_UP));
+    }
+
+    public function fromPercentValue(int $value): float
+    {
+        return $value / 100.0;
+    }
+
+    public function checkPercentValue(int $value): void
+    {
+        if ($value > 100) {
+            throw new InvalidArgumentException('Ein Wert größer als 100% ist nicht definierbar.');
+        }
+        if ($value < 0) {
+            throw new InvalidArgumentException('Ein Wert kleiner als 0% ist nicht definierbar.');
+        }
+    }
+
+}

src/NaturallyColorModels/HueSaturationValue.php

@@ -0,0 +1,94 @@
+<?php
+
+
+namespace TorstenHettstedt\Colors\NaturallyColorModels;
+
+
+use JetBrains\PhpStorm\Pure;
+use TorstenHettstedt\Colors\ColorModels\HueSaturationValue as PureHueSaturationValue;
+
+/**
+ * Definition des allgemeinen HSV-Farbraumes. Die Werte für die Eigenschaften sind reelle Zahlen von 0 bis einschließlich 1.
+ * Ohne Änderung der Eigenschaften wird die Farbe *weiß* dargestellt.
+ */
+class HueSaturationValue
+{
+    /** @var PureHueSaturationValue : Standard-Color-Modell */
+    protected PureHueSaturationValue $pureColor;
+    protected Helper\PercentValues $percentValuesHelper;
+    protected Helper\GradValues    $gradValuesHelper;
+
+    #[Pure] public function __construct()
+    {
+        $this->pureColor = new PureHueSaturationValue();
+        $this->percentValuesHelper = new Helper\PercentValues();
+        $this->gradValuesHelper = new Helper\GradValues();
+    }
+
+    /**
+     * @return PureHueSaturationValue
+     */
+    public function getPureColor(): PureHueSaturationValue
+    {
+        return $this->pureColor;
+    }
+
+    /**
+     * @return int
+     */
+    #[Pure] public function getHue(): int
+    {
+        return $this->gradValuesHelper->asGradValue($this->pureColor->getHue());
+    }
+
+    /**
+     * @param int $hue
+     * @return HueSaturationValue
+     */
+    public function setHue(int $hue): HueSaturationValue
+    {
+        $this->gradValuesHelper->checkGradValue($hue);
+        $this->pureColor->setHue($this->gradValuesHelper->fromGradValue($hue));
+        return $this;
+    }
+
+    /**
+     * @return int
+     */
+    #[Pure] public function getSaturation(): int
+    {
+        return $this->percentValuesHelper->asPercentValue($this->pureColor->getSaturation());
+    }
+
+    /**
+     * @param int $saturation
+     * @return HueSaturationValue
+     */
+    public function setSaturation(int $saturation): HueSaturationValue
+    {
+        $this->percentValuesHelper->checkPercentValue($saturation);
+        $this->pureColor->setSaturation($this->percentValuesHelper->fromPercentValue($saturation));
+        return $this;
+    }
+
+    /**
+     * @return int
+     */
+    #[Pure] public function getValue(): int
+    {
+        return $this->percentValuesHelper->asPercentValue($this->pureColor->getValue());
+    }
+
+    /**
+     * @param int $value
+     * @return HueSaturationValue
+     */
+    public function setValue(int $value): HueSaturationValue
+    {
+        $this->percentValuesHelper->checkPercentValue($value);
+        $this->pureColor->setValue($this->percentValuesHelper->fromPercentValue($value));
+        return $this;
+    }
+
+
+}

src/NaturallyColorModels/RedGreenBlue.php

@@ -0,0 +1,94 @@
+<?php
+
+namespace TorstenHettstedt\Colors\NaturallyColorModels;
+
+use JetBrains\PhpStorm\Pure;
+use TorstenHettstedt\Colors\ColorModels\RedGreenBlue as PureRedGreenBlue;
+
+/**
+ * Definition des allgemeinen RGB-Farbraumes. Die Werte für die eigenschaften sind reelle Zahlen von 0 bis einschließlich 1.
+ * Ohne Änderung der Eigenschaften wird die Farbe *weiß* dargestellt.
+ */
+class RedGreenBlue
+{
+    /** @var PureRedGreenBlue : Standard-Color-Modell */
+    protected PureRedGreenBlue         $pureColor;
+    protected Helper\HexadecimalValues $hexadecimalValuesHelper;
+
+    #[Pure] public function __construct()
+    {
+        $this->pureColor = new PureRedGreenBlue();
+        $this->hexadecimalValuesHelper = new Helper\HexadecimalValues();
+    }
+
+    /**
+     * @return PureRedGreenBlue
+     */
+    public function getPureColor(): PureRedGreenBlue
+    {
+        return $this->pureColor;
+    }
+
+    /**
+     * @return int
+     */
+    #[Pure] public function getRed(): int
+    {
+        return $this->hexadecimalValuesHelper->asHexadecimalValue($this->pureColor->getRed());
+    }
+
+    /**
+     * @param int $red
+     * @return RedGreenBlue
+     */
+    public function setRed(int $red): RedGreenBlue
+    {
+        $this->hexadecimalValuesHelper->checkHexadecimalValue($red);
+        $this->pureColor->setRed($this->hexadecimalValuesHelper->fromHexadecimalValue($red));
+        return $this;
+    }
+
+    /**
+     * @return int
+     */
+    #[Pure] public function getGreen(): int
+    {
+        return $this->hexadecimalValuesHelper->asHexadecimalValue($this->pureColor->getGreen());
+    }
+
+    /**
+     * @param int $green
+     * @return RedGreenBlue
+     */
+    public function setGreen(int $green): RedGreenBlue
+    {
+        $this->hexadecimalValuesHelper->checkHexadecimalValue($green);
+        $this->pureColor->setGreen($this->hexadecimalValuesHelper->fromHexadecimalValue($green));
+        return $this;
+    }
+
+    /**
+     * @return int
+     */
+    #[Pure] public function getBlue(): int
+    {
+        return $this->hexadecimalValuesHelper->asHexadecimalValue($this->pureColor->getBlue());
+    }
+
+    /**
+     * @param int $blue
+     * @return RedGreenBlue
+     */
+    public function setBlue(int $blue): RedGreenBlue
+    {
+        $this->hexadecimalValuesHelper->checkHexadecimalValue($blue);
+        $this->pureColor->setBlue($this->hexadecimalValuesHelper->fromHexadecimalValue($blue));
+        return $this;
+    }
+
+    #[Pure] public function asHtmlNotation(): string
+    {
+        return sprintf('#%X%X%X', $this->getRed(), $this->getGreen(), $this->getBlue());
+    }
+
+}

src/NaturallyTransformer/AbstractNaturallyTransformer.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace TorstenHettstedt\Colors\NaturallyTransformer;
+
+use TorstenHettstedt\Colors\NaturallyColorModels\CyanMagentaYellowKey;
+use TorstenHettstedt\Colors\NaturallyColorModels\Helper\GradValues;
+use TorstenHettstedt\Colors\NaturallyColorModels\Helper\HexadecimalValues;
+use TorstenHettstedt\Colors\NaturallyColorModels\Helper\PercentValues;
+use TorstenHettstedt\Colors\NaturallyColorModels\HueSaturationValue;
+use TorstenHettstedt\Colors\NaturallyColorModels\RedGreenBlue;
+use TorstenHettstedt\Colors\Transformer\ColorModelTransformInterface as PureTransformer;
+
+class AbstractNaturallyTransformer implements ColorModelTransformInterface
+{
+
+
+    protected PureTransformer $transformer;
+
+
+    public function toRedGreenBlue(): RedGreenBlue
+    {
+        $hex_helper = new HexadecimalValues();
+        $convert_color = $this->transformer->toRedGreenBlue();
+        $naturally_color = new RedGreenBlue();
+        $naturally_color->setRed($hex_helper->asHexadecimalValue($convert_color->getRed()));
+        $naturally_color->setGreen($hex_helper->asHexadecimalValue($convert_color->getGreen()));
+        $naturally_color->setBlue($hex_helper->asHexadecimalValue($convert_color->getBlue()));
+        return $naturally_color;
+    }
+
+    public function toCyanMagentaYellowKey(): CyanMagentaYellowKey
+    {
+        $percent_helper = new PercentValues();
+        $convert_color = $this->transformer->toCyanMagentaYellowKey();
+        $naturally_color = new CyanMagentaYellowKey();
+        $naturally_color->setCyan($percent_helper->asPercentValue($convert_color->getCyan()));
+        $naturally_color->setYellow($percent_helper->asPercentValue($convert_color->getYellow()));
+        $naturally_color->setMagenta($percent_helper->asPercentValue($convert_color->getMagenta()));
+        $naturally_color->setKey($percent_helper->asPercentValue($convert_color->getKey()));
+        return $naturally_color;
+    }
+
+    public function toHueSaturationValue(): HueSaturationValue
+    {
+        $percent_helper = new PercentValues();
+        $grad_helper = new GradValues();
+        $convert_color = $this->transformer->toHueSaturationValue();
+        $naturally_color = new HueSaturationValue();
+        $naturally_color->setHue($grad_helper->asGradValue($convert_color->getHue()));
+        $naturally_color->setSaturation($percent_helper->asPercentValue($convert_color->getSaturation()));
+        $naturally_color->setValue($percent_helper->asPercentValue($convert_color->getValue()));
+        return $naturally_color;
+    }
+}

src/NaturallyTransformer/ColorModelTransformInterface.php

@@ -0,0 +1,18 @@
+<?php
+
+
+namespace TorstenHettstedt\Colors\NaturallyTransformer;
+
+
+use TorstenHettstedt\Colors\NaturallyColorModels\CyanMagentaYellowKey;
+use TorstenHettstedt\Colors\NaturallyColorModels\HueSaturationValue;
+use TorstenHettstedt\Colors\NaturallyColorModels\RedGreenBlue;
+
+interface ColorModelTransformInterface
+{
+    public function toRedGreenBlue(): RedGreenBlue;
+
+    public function toCyanMagentaYellowKey(): CyanMagentaYellowKey;
+
+    public function toHueSaturationValue(): HueSaturationValue;
+}

src/NaturallyTransformer/CyanMagentaYellowKeyTransformer.php

@@ -0,0 +1,21 @@
+<?php
+
+
+namespace TorstenHettstedt\Colors\NaturallyTransformer;
+
+
+use JetBrains\PhpStorm\Pure;
+use TorstenHettstedt\Colors\NaturallyColorModels\CyanMagentaYellowKey;
+use TorstenHettstedt\Colors\Transformer\CyanMagentaYellowKeyTransformer as PureTransformer;
+
+class CyanMagentaYellowKeyTransformer extends AbstractNaturallyTransformer
+{
+
+    /**
+     * @param CyanMagentaYellowKey $color
+     */
+    #[Pure] public function __construct(CyanMagentaYellowKey $color)
+    {
+        $this->transformer = new PureTransformer($color->getPureColor());
+    }
+}

src/NaturallyTransformer/HueSaturationValueTransformer.php

@@ -0,0 +1,21 @@
+<?php
+
+
+namespace TorstenHettstedt\Colors\NaturallyTransformer;
+
+
+use JetBrains\PhpStorm\Pure;
+use TorstenHettstedt\Colors\NaturallyColorModels\HueSaturationValue;
+use TorstenHettstedt\Colors\Transformer\HueSaturationValueTransformer as PureTransformer;
+
+class HueSaturationValueTransformer extends AbstractNaturallyTransformer
+{
+
+    /**
+     * @param HueSaturationValue $color
+     */
+    #[Pure] public function __construct(HueSaturationValue $color)
+    {
+        $this->transformer = new PureTransformer($color->getPureColor());
+    }
+}

src/NaturallyTransformer/RedGreenBlueTransformer.php

@@ -0,0 +1,21 @@
+<?php
+
+
+namespace TorstenHettstedt\Colors\NaturallyTransformer;
+
+
+use JetBrains\PhpStorm\Pure;
+use TorstenHettstedt\Colors\NaturallyColorModels\RedGreenBlue;
+use TorstenHettstedt\Colors\Transformer\RedGreenBlueTransformer as PureTransformer;
+
+class RedGreenBlueTransformer extends AbstractNaturallyTransformer
+{
+
+    /**
+     * @param RedGreenBlue $color
+     */
+    #[Pure] public function __construct(RedGreenBlue $color)
+    {
+        $this->transformer = new PureTransformer($color->getPureColor());
+    }
+}

src/Transformer/Utilities/AbstractHueSaturationValueToUtility.php

@@ -0,0 +1,61 @@
+<?php
+
+
+namespace TorstenHettstedt\Colors\Transformer\Utilities;
+
+
+use TorstenHettstedt\Colors\ColorModels\HueSaturationValue;
+
+abstract class AbstractHueSaturationValueToUtility
+{
+    /** @var float : Größe des Intervals in 1/100 Grad */
+    protected const INTERVAL = 60.0 * 100.0;
+
+    // Daten für HSV
+    /** @var float : Definition des Farbtones als Anteil eines Vollkreises '$Hue * π' */
+    protected float $hue;
+    /** @var float : Anteil am Vollkreis in 1/100 Grad  */
+    protected float $hueAsPercentGrad;
+    /** @var float : Definition der Sättigung der Farbe */
+    protected float $saturation;
+    /** @var float : Definition der Helligkeit der Farbe */
+    protected float $value;
+
+    /**
+     * HueSaturationValueToRedGreenBlue constructor.
+     * @param HueSaturationValue $from_color
+     * @noinspection PhpPureAttributeCanBeAddedInspection
+     */
+    public function __construct(HueSaturationValue $from_color)
+    {
+        $this->hue = $from_color->getHue();
+        $this->hueAsPercentGrad = intval($this->hue * self::INTERVAL * 6.0);
+        $this->saturation = $from_color->getSaturation();
+        $this->value = $from_color->getValue();
+    }
+
+
+    protected function processConvert(): void
+    {
+        if ($this->saturation > 0.0) {
+            $this->splitColor();
+        }
+    }
+
+    abstract protected function splitColor(): void;
+
+    /**
+     * @param bool $reciprocal
+     *
+     * @return float
+     */
+    protected function calcColorValue(bool $reciprocal = false): float
+    {
+        // Rest-Anteil am Vollkreis des aktuellen Intervals als Wert '[0,1]'
+        $remainder_grad = $this->hueAsPercentGrad % self::INTERVAL;
+        // Rest-Anteil am Vollkreis des aktuellen Intervals als Wert '[0,1]'
+        $remainder = $remainder_grad / self::INTERVAL;
+        return $this->saturation * ($reciprocal ? (1 - $remainder) : $remainder);
+    }
+
+}

src/Transformer/Utilities/CyanMagentaYellowKeyToHueSaturationValue.php

@@ -2,6 +2,7 @@
 
 namespace TorstenHettstedt\Colors\Transformer\Utilities;
 
+use JetBrains\PhpStorm\Pure;
 use TorstenHettstedt\Colors\ColorModels\CyanMagentaYellowKey;
 use TorstenHettstedt\Colors\ColorModels\HueSaturationValue;
 
@@ -14,11 +15,11 @@ class CyanMagentaYellowKeyToHueSaturationValue
     const PROPERTY_KEY = 'key';
 
     // Daten für CMYK
-    /** @var float : Definition des Cyan-Anteil */
+    /** @var float : Definition des Cyan-Anteils */
     protected float $cyan;
-    /** @var float : Definition des Magenta-Anteil */
+    /** @var float : Definition des Magenta-Anteils */
     protected float $magenta;
-    /** @var float : Definition des Gelbanteil */
+    /** @var float : Definition des Gelbanteils */
     protected float $yellow;
     /** @var float : Definition des Schwarzanteil */
     protected float $key;
@@ -29,7 +30,7 @@ class CyanMagentaYellowKeyToHueSaturationValue
     protected float $minCmyProperty;
 
     // Daten für HSV
-    /** @var float : Definition des Farbton als Anteil eines Vollkreises '$Hue * π' */
+    /** @var float : Definition des Farbtones als Anteil eines Vollkreises '$Hue * π' */
     protected float $hue = 0.0;
     /** @var float : Definition der Sättigung der Farbe */
     protected float $saturation = 0.0;
@@ -72,9 +73,12 @@ class CyanMagentaYellowKeyToHueSaturationValue
             ->setValue($this->value);
     }
 
+    #[Pure]
     protected function buildHueAmount(): float
     {
-        if ($this->maxCmyProperty === 0.0) {
+        // Wenn beide Werte gleich sind, ist die Endfarbe Grau.
+        // Damit wird auch in {@sse hueAmount()} eine Division durch '0' verhindert.
+        if ($this->maxCmyProperty === $this->minCmyProperty) {
             return 0.0;
         }
 
@@ -91,30 +95,32 @@ class CyanMagentaYellowKeyToHueSaturationValue
      */
     private function hueAmount(string $property): float
     {
-        static $amount_share = 2.0;
-
+        // Wertebereich: [0.0, 1.0]
         $divisor = $this->maxCmyProperty - $this->minCmyProperty;
+        // Wertebereich: [1.0, 5.0]
+        $amount = 0.0;
+        // Wertebereich: [-1.0, +1.0]
+        $dividend = 0.0;
 
         switch ($property) {
             case self::PROPERTY_YELLOW:
-                $amount = 0; // 0.167
+                $amount = 1.0; // 0.167
                 $dividend = $this->cyan - $this->magenta;
                 break;
             case self::PROPERTY_CYAN:
-                $amount = 1; // 0.500
+                $amount = 3.0; // 0.500
                 $dividend = $this->magenta -$this->yellow;
                 break;
             case self::PROPERTY_MAGENTA:
-                $amount = 2; // 0.833
+                $amount = 5.0; // 0.833
                 $dividend = $this->yellow - $this->cyan;
                 break;
-            default:
-                return 0;
         }
 
-        $start_amount = ($amount * $amount_share) + 1.0;
+        // Wertebereich: [-1.0, +1.0]
         $expansion_amount = $dividend / $divisor;
-        return ($start_amount + $expansion_amount) / 6.0;
+        // Wertebereich: [+0.0, +6.0]
+        return ($amount + $expansion_amount) / 6.0;
     }
 
 }

src/Transformer/Utilities/HueSaturationValueToCyanMagentaYellowKey.php

@@ -5,46 +5,19 @@ namespace TorstenHettstedt\Colors\Transformer\Utilities;
 
 
 use TorstenHettstedt\Colors\ColorModels\CyanMagentaYellowKey;
-use TorstenHettstedt\Colors\ColorModels\HueSaturationValue;
 
-class HueSaturationValueToCyanMagentaYellowKey
+class HueSaturationValueToCyanMagentaYellowKey extends AbstractHueSaturationValueToUtility
 {
-    /** @var int : Größe des Intervals in 1/100 Grad */
-    protected const INTERVAL = 60.0 * 100.0;
-
-    // Daten für HSV
-    /** @var float : Definition des Farbton als Anteil eines Vollkreises '$Hue * π' */
-    protected float $hue;
-    /** @var float : Anteil am Vollkreis in 1/100 Grad  */
-    protected float $hueAsPercentGrad;
-    /** @var float : Definition der Sättigung der Farbe */
-    protected float $saturation;
-    /** @var float : Definition der Helligkeit der Farbe */
-    protected float $value;
-
     // Daten für CMYK
-    /** @var float : Definition des Cyan-Anteil */
+    /** @var float : Definition des Cyan-Anteils */
     protected float $cyan = 0.0;
-    /** @var float : Definition des Magenta-Anteil */
+    /** @var float : Definition des Magenta-Anteils */
     protected float $magenta = 0.0;
-    /** @var float : Definition des Gelbanteil */
+    /** @var float : Definition des Gelbanteils */
     protected float $yellow = 0.0;
     /** @var float : Definition des Schwarzanteil */
     protected float $key = 0.0;
 
-    /**
-     * HueSaturationValueToRedGreenBlue constructor.
-     * @param HueSaturationValue $from_color
-     * @noinspection PhpPureAttributeCanBeAddedInspection
-     */
-    public function __construct(HueSaturationValue $from_color)
-    {
-        $this->hue = $from_color->getHue();
-        $this->hueAsPercentGrad = intval($this->hue * self::INTERVAL * 6);
-        $this->saturation = $from_color->getSaturation();
-        $this->value = $from_color->getValue();
-    }
-
     public function convert(): CyanMagentaYellowKey
     {
         $this->processConvert();
@@ -60,51 +33,40 @@ class HueSaturationValueToCyanMagentaYellowKey
     protected function processConvert(): void
     {
         $this->key = 1 - $this->value;
-        if ($this->saturation !== 0.0) {
-            $this->splitColor();
-        }
+        parent::processConvert();
     }
 
     protected function splitColor(): void
     {
         // ID des zu nutzenden Interval
-        $interval_id = intdiv($this->hueAsPercentGrad , self::INTERVAL);
+        $interval_id = $this->hueAsPercentGrad / self::INTERVAL;
 
-        switch ($interval_id) {
+        switch ((int)$interval_id) {
             case 1: // Yellow
-                $this->cyan = $this->calcRemainder();
+                $this->cyan = $this->calcColorValue();
                 $this->yellow = $this->saturation;
                 break;
             case 2:
                 $this->cyan = $this->saturation;
-                $this->yellow = $this->calcRemainder(true);
+                $this->yellow = $this->calcColorValue(true);
                 break;
             case 3: // Cyan
                 $this->cyan = $this->saturation;
-                $this->magenta = $this->calcRemainder();
+                $this->magenta = $this->calcColorValue();
                 break;
             case 4:
-                $this->cyan = $this->calcRemainder(true);
+                $this->cyan = $this->calcColorValue(true);
                 $this->magenta = $this->saturation;
                 break;
             case 5: // Magenta
                 $this->magenta = $this->saturation;
-                $this->yellow = $this->calcRemainder();
+                $this->yellow = $this->calcColorValue();
                 break;
             default:
-                $this->magenta = $this->calcRemainder(true);
+                $this->magenta = $this->calcColorValue(true);
                 $this->yellow = $this->saturation;
                 break;
         }
     }
 
-    protected function calcRemainder($reciprocal = false): float
-    {
-        // Rest-Anteil am Vollkreis des aktuellen Intervals als Wert '[0,1]'
-        $remainder_grad = $this->hueAsPercentGrad % self::INTERVAL;
-        // Rest-Anteil am Vollkreis des aktuellen Intervals als Wert '[0,1]'
-        $remainder = $remainder_grad / self::INTERVAL;
-        return $this->saturation * ($reciprocal ? (1 - $remainder) : $remainder);
-    }
-
 }

src/Transformer/Utilities/HueSaturationValueToRedGreenBlue.php

@@ -4,41 +4,17 @@
 namespace TorstenHettstedt\Colors\Transformer\Utilities;
 
 
-use TorstenHettstedt\Colors\ColorModels\HueSaturationValue;
 use TorstenHettstedt\Colors\ColorModels\RedGreenBlue;
 
-class HueSaturationValueToRedGreenBlue
+class HueSaturationValueToRedGreenBlue extends AbstractHueSaturationValueToUtility
 {
-    /** @var int : Größe des Intervals in 1/100 Grad */
-    protected const INTERVAL = 60 * 100;
-
-    // Daten für HSV
-    /** @var float : Definition des Farbton als Anteil eines Vollkreises '$Hue * π' */
-    protected float $hue;
-    /** @var float : Definition der Sättigung der Farbe */
-    protected float $saturation;
-    /** @var float : Definition der Helligkeit der Farbe */
-    protected float $value;
-
     // Daten für RGB
-    /** @var float : Definition des Rotanteil */
+    /** @var float : Definition des Rotanteils */
     protected float $red = 1.0;
-    /** @var float : Definition des Grünanteil */
+    /** @var float : Definition des Grünanteils */
     protected float $green = 1.0;
-    /** @var float : Definition des Blauanteil */
-    protected float $blu = 1.0;
-
-    /**
-     * HueSaturationValueToRedGreenBlue constructor.
-     * @param HueSaturationValue $from_color
-     * @noinspection PhpPureAttributeCanBeAddedInspection
-     */
-    public function __construct(HueSaturationValue $from_color)
-    {
-        $this->hue = $from_color->getHue();
-        $this->saturation = $from_color->getSaturation();
-        $this->value = $from_color->getValue();
-    }
+    /** @var float : Definition des Blauanteils */
+    protected float $blue = 1.0;
 
     public function convert(): RedGreenBlue
     {
@@ -47,65 +23,56 @@ class HueSaturationValueToRedGreenBlue
         return (new RedGreenBlue())
             ->setRed($this->red)
             ->setGreen($this->green)
-            ->setBlue($this->blu);
+            ->setBlue($this->blue);
     }
 
 
     protected function processConvert(): void
     {
-        if ($this->saturation === 0.0) {
-            $this->red = $this->green = $this->blu = $this->value;
-        } else {
-            $this->splitColor();
-        }
+        $this->red = $this->green = $this->blue = $this->value;
+        parent::processConvert();
     }
 
     protected function splitColor(): void
     {
-        // Anteil am Vollkreis in 1/100 Grad
-        $percent_grad = intval($this->hue * 360 * 100);
         // ID des zu nutzenden Interval
-        $interval_id = intdiv($percent_grad , self::INTERVAL);
-        // Rest-Anteil am Vollkreis des aktuellen Intervals als Wert '[0,1]'
-        $remainder = (($percent_grad % self::INTERVAL) / self::INTERVAL);
-        $help_values = [
-            $this->value,
-            $this->value * ( 1 - $this->saturation),
-            $this->value * ( 1 - $this->saturation * $remainder),
-            $this->value * ( 1 - $this->saturation * (1 - $remainder)),
-        ];
-        switch ($interval_id) {
+        $interval_id = $this->hueAsPercentGrad / self::INTERVAL;
+        // der Wert der entgegen gesetzten Farbe
+        $opposite_color_value = $this->value * ( 1 - $this->saturation);
+
+        switch ((int)$interval_id) {
             case 1:
-                $this->red = $help_values[2];
-                $this->green = $help_values[0];
-                $this->blu = $help_values[1];
+                $this->red = $this->calcColorValue();
+                $this->blue = $opposite_color_value;
                 break;
-            case 2:
-                $this->red = $help_values[1];
-                $this->green = $help_values[0];
-                $this->blu = $help_values[3];
+            case 2: // Green
+                $this->red = $opposite_color_value;
+                $this->blue = $this->calcColorValue(true);
                 break;
             case 3:
-                $this->red = $help_values[1];
-                $this->green = $help_values[2];
-                $this->blu = $help_values[0];
+                $this->red = $opposite_color_value;
+                $this->green = $this->calcColorValue();
                 break;
-            case 4:
-                $this->red = $help_values[3];
-                $this->green = $help_values[1];
-                $this->blu = $help_values[0];
+            case 4: // Blue
+                $this->red = $this->calcColorValue(true);
+                $this->green = $opposite_color_value;
                 break;
             case 5:
-                $this->red = $help_values[0];
-                $this->green = $help_values[1];
-                $this->blu = $help_values[2];
+                $this->green = $opposite_color_value;
+                $this->blue = $this->calcColorValue();
                 break;
-            default:
-                $this->red = $help_values[0];
-                $this->green = $help_values[3];
-                $this->blu = $help_values[1];
+            default: // Red
+                $this->green = $this->calcColorValue(true);
+                $this->blue = $opposite_color_value;
                 break;
         }
     }
 
+    protected function calcColorValue($reciprocal = false): float
+    {
+        $color_value = $this->value;
+        $color_value *= 1 - parent::calcColorValue($reciprocal);
+        return $color_value;
+    }
+
 }

src/Transformer/Utilities/RedGreenBlueToHueSaturationValue.php

@@ -2,6 +2,7 @@
 
 namespace TorstenHettstedt\Colors\Transformer\Utilities;
 
+use JetBrains\PhpStorm\Pure;
 use TorstenHettstedt\Colors\ColorModels\HueSaturationValue;
 use TorstenHettstedt\Colors\ColorModels\RedGreenBlue;
 
@@ -12,11 +13,11 @@ class RedGreenBlueToHueSaturationValue
     const PROPERTY_BLUE  = 'blue';
 
     // Daten für RGB
-    /** @var float : Definition des Rotanteil */
+    /** @var float : Definition des Rot-Anteils */
     protected float $red;
-    /** @var float : Definition des Grünanteil */
+    /** @var float : Definition des Grün-Anteils */
     protected float $green;
-    /** @var float : Definition des Blauanteil */
+    /** @var float : Definition des Blau-Anteils */
     protected float $blu;
 
     /** @var float : Der größte RGB-Farbwert */
@@ -25,7 +26,7 @@ class RedGreenBlueToHueSaturationValue
     protected float $minRgbProperty;
 
     // Daten für HSV
-    /** @var float : Definition des Farbton als Anteil eines Vollkreises '$Hue * π' */
+    /** @var float : Definition des Farbtones als Anteil eines Vollkreises '$Hue * π' */
     protected float $hue = 0.0;
     /** @var float : Definition der Sättigung der Farbe */
     protected float $saturation = 0.0;
@@ -58,10 +59,6 @@ class RedGreenBlueToHueSaturationValue
         while($this->hue < 0.0) {
             $this->hue += 1.0;
         }
-
-        while($this->hue > 1.0) {
-            $this->hue -= 1.0;
-        }
     }
 
     public function convert(): HueSaturationValue
@@ -74,8 +71,11 @@ class RedGreenBlueToHueSaturationValue
             ->setValue($this->value);
     }
 
+    #[Pure]
     protected function buildHueAmount(): float
     {
+        // Wenn beide Werte gleich sind, ist die Endfarbe Grau.
+        // Damit wird auch in {@sse hueAmount()} eine Division durch '0' verhindert.
         if ($this->maxRgbProperty === $this->minRgbProperty) {
             return 0.0;
         }
@@ -105,30 +105,31 @@ class RedGreenBlueToHueSaturationValue
      */
     private function hueAmount(string $property): float
     {
-        static $amount_share = 2.0;
-
+        // Wertebereich: [0.0, 1.0]
         $divisor = $this->maxRgbProperty - $this->minRgbProperty;
+        // Wertebereich: [1.0, 5.0]
+        $amount = 0.0;
+        // Wertebereich: [-1.0, +1.0]
+        $dividend = 0.0;
 
         switch ($property) {
             case self::PROPERTY_RED:
-                $amount = 0; // 0.0
                 $dividend = $this->green - $this->blu;
                 break;
             case self::PROPERTY_GREEN:
-                $amount = 1; // 0.333
+                $amount = 2.0; // 0.333
                 $dividend = $this->blu -$this->red;
                 break;
             case self::PROPERTY_BLUE:
-                $amount = 2; // 0.999
+                $amount = 4.0; // 0.999
                 $dividend = $this->red - $this->green;
                 break;
-            default:
-                return 0;
         }
 
-        $start_amount = $amount * $amount_share;
+        // Wertebereich: [-1.0, +1.0]
         $expansion_amount = $dividend / $divisor;
-        return ($start_amount + $expansion_amount) / 6.0;
+        // Wertebereich: [-1.0, +5.0]
+        return ($amount + $expansion_amount) / 6.0;
     }
 
 }

tests/_support/Helper/ValidColorValuesProvider.php

@@ -1,7 +1,7 @@
 <?php
 
 
-namespace TorstenHettstedtUnitTests\Colors\Transformer;
+namespace TorstenHettstedt\Colors\Tests\Helper;
 
 
 class ValidColorValuesProvider
@@ -11,6 +11,9 @@ class ValidColorValuesProvider
     const RGB  = 'rgb';
     const HSV  = 'hsv';
 
+    /**
+     * @var array<string, array<array<string, float>>>
+     */
     protected array $definitions = [
         'weiß'    => [
             self::CMYK => [
@@ -30,6 +33,42 @@ class ValidColorValuesProvider
                 'value'      => 1.0,
             ],
         ],
+        'hellgrau' => [
+            self::CMYK => [
+                'cyan'    => 0.0,
+                'magenta' => 0.0,
+                'yellow'  => 0.0,
+                'key'     => 2.0 / 3.0,
+            ],
+            self::RGB  => [
+                'red'   => 1.0 / 3.0,
+                'green' => 1.0 / 3.0,
+                'blue'  => 1.0 / 3.0,
+            ],
+            self::HSV  => [
+                'hue'        => 0.0,
+                'saturation' => 0.0,
+                'value'      => 1.0 / 3.0,
+            ],
+        ],
+        'dunkelgrau' => [
+            self::CMYK => [
+                'cyan'    => 0.0,
+                'magenta' => 0.0,
+                'yellow'  => 0.0,
+                'key'     => 1.0 / 3.0,
+            ],
+            self::RGB  => [
+                'red'   => 2.0 / 3.0,
+                'green' => 2.0 / 3.0,
+                'blue'  => 2.0 / 3.0,
+            ],
+            self::HSV  => [
+                'hue'        => 0.0,
+                'saturation' => 0.0,
+                'value'      => 2.0 / 3.0,
+            ],
+        ],
         'schwarz' => [
             self::CMYK => [
                 'cyan'    => 0.0,
@@ -156,6 +195,24 @@ class ValidColorValuesProvider
                 'value'      => 1.0,
             ],
         ],
+        'dunkellachs' => [
+            self::CMYK => [
+                'cyan'    => 0.0,
+                'magenta' => 0.54,
+                'yellow'  => 0.72,
+                'key'     => 0.30,
+            ],
+            self::RGB  => [
+                'red'   => 0.7,
+                'green' => 0.3216,
+                'blue'  => 0.1961,
+            ],
+            self::HSV  => [
+                'hue'        => 0.0417,
+                'saturation' => 0.72,
+                'value'      => 0.70,
+            ],
+        ],
         'gold'    => [
             self::CMYK => [
                 'cyan'    => 0.0,
@@ -174,6 +231,42 @@ class ValidColorValuesProvider
                 'value'      => 0.87,
             ],
         ],
+        'grasgrün' => [
+            self::CMYK => [
+                'cyan'    => 0.495,
+                'magenta' => 0.0,
+                'yellow'  => 1.0,
+                'key'     => 0.51,
+            ],
+            self::RGB  => [
+                'red'   => 0.247,
+                'green' => 0.490,
+                'blue'  => 0.0,
+            ],
+            self::HSV  => [
+                'hue'        => 0.2492,
+                'saturation' => 1.00,
+                'value'      => 0.49,
+            ],
+        ],
+        'aquamarin' => [
+            self::CMYK => [
+                'cyan'    => 0.501,
+                'magenta' => 0.0,
+                'yellow'  => 0.168,
+                'key'     => 0.00,
+            ],
+            self::RGB  => [
+                'red'   => 0.49804,
+                'green' => 1.0,
+                'blue'  => 0.83285,
+            ],
+            self::HSV  => [
+                'hue'        => 0.4445,
+                'saturation' => 0.50196,
+                'value'      => 1.0,
+            ],
+        ],
         'violet'  => [
             self::CMYK => [
                 'cyan'    => 0.191,
@@ -192,8 +285,31 @@ class ValidColorValuesProvider
                 'value'      => 0.71,
             ],
         ],
+        'pflaume'  => [
+            self::CMYK => [
+                'cyan'    => 0.0,
+                'magenta' => 0.2755,
+                'yellow'  => 0.0,
+                'key'     => 0.1335,
+            ],
+            self::RGB  => [
+                'red'   => 0.8667,
+                'green' => 0.6274,
+                'blue'  => 0.8667,
+            ],
+            self::HSV  => [
+                'hue'        => 0.83333,
+                'saturation' => 0.27601,
+                'value'      => 0.86666,
+            ],
+        ],
     ];
 
+    /**
+     * @param array<string> $order
+     *
+     * @return array<string, array<array<string, float>>>
+     */
     public function getValidColorValues(array $order): array
     {
         $values = [];

tests/_support/Helper/ValidNaturallyColorValuesProvider.php

@@ -0,0 +1,128 @@
+<?php
+
+
+namespace TorstenHettstedt\Colors\Tests\Helper;
+
+
+class ValidNaturallyColorValuesProvider
+{
+
+    const CMYK = 'cmyk';
+    const RGB  = 'rgb';
+    const HSV  = 'hsv';
+
+    /**
+     * @var array<string, array<array<string, float>>>
+     */
+    protected array $definitions = [
+        'weiß'    => [
+            self::CMYK => [
+                'cyan'    => 0,
+                'magenta' => 0,
+                'yellow'  => 0,
+                'key'     => 0,
+            ],
+            self::RGB  => [
+                'red'   => 0xFF,
+                'green' => 0xFF,
+                'blue'  => 0xFF,
+            ],
+            self::HSV  => [
+                'hue'        =>   0,
+                'saturation' =>   0,
+                'value'      => 100,
+            ],
+        ],
+        'hellgrau' => [
+            self::CMYK => [
+                'cyan'    =>  0,
+                'magenta' =>  0,
+                'yellow'  =>  0,
+                'key'     => 67,
+            ],
+            self::RGB  => [
+                'red'   => 0x55,
+                'green' => 0x55,
+                'blue'  => 0x55,
+            ],
+            self::HSV  => [
+                'hue'        =>  0,
+                'saturation' =>  0,
+                'value'      => 33,
+            ],
+        ],
+        'dunkelgrau' => [
+            self::CMYK => [
+                'cyan'    =>  0,
+                'magenta' =>  0,
+                'yellow'  =>  0,
+                'key'     => 33,
+            ],
+            self::RGB  => [
+                'red'   => 0xAA,
+                'green' => 0xAA,
+                'blue'  => 0xAA,
+            ],
+            self::HSV  => [
+                'hue'        =>  0,
+                'saturation' =>  0,
+                'value'      => 67,
+            ],
+        ],
+        'schwarz' => [
+            self::CMYK => [
+                'cyan'    =>   0,
+                'magenta' =>   0,
+                'yellow'  =>   0,
+                'key'     => 100,
+            ],
+            self::RGB  => [
+                'red'   => 0,
+                'green' => 0,
+                'blue'  => 0,
+            ],
+            self::HSV  => [
+                'hue'        => 0,
+                'saturation' => 0,
+                'value'      => 0,
+            ],
+        ],
+        'aquamarin' => [
+            self::CMYK => [
+                'cyan'    => 50,
+                'magenta' =>  0,
+                'yellow'  => 17,
+                'key'     =>  0,
+            ],
+            self::RGB  => [
+                'red'   => 0x7F,
+                'green' => 0xFF,
+                'blue'  => 0xD4,
+            ],
+            self::HSV  => [
+                'hue'        => 160,
+                'saturation' =>  50,
+                'value'      => 100,
+            ],
+        ],
+    ];
+
+    /**
+     * @param string $pure_color
+     * @param string $test_color
+     *
+     * @return array<string, array<array<string, float>>>
+     */
+    public function getValidColorValues(string $pure_color, string $test_color): array
+    {
+        $values = [];
+        $pure_values = (new ValidColorValuesProvider())->getValidColorValues([$pure_color]);
+        foreach ($this->definitions as $color => $definition) {
+            $values[$color] = [
+                $pure_values[$color][0],
+                $definition[$test_color]
+            ];
+        }
+        return $values;
+    }
+}

tests/unit/ColorModels/AbstractColorModelUnit.php

@@ -1,14 +1,14 @@
 <?php /** @noinspection PhpArrayShapeAttributeCanBeAddedInspection */
 
 
-namespace TorstenHettstedtUnitTests\Colors\ColorModels;
+namespace TorstenHettstedt\Colors\Tests\Unit\ColorModels;
 
 use Codeception\Test\Unit;
 
 abstract class AbstractColorModelUnit extends Unit
 {
 
-    abstract public function testConstruct();
+    abstract public function testConstruct(): void;
 
     /**
      * @return float[][]

tests/unit/ColorModels/CyanMagentaYellowKeyTest.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace TorstenHettstedtUnitTests\Colors\ColorModels;
+namespace TorstenHettstedt\Colors\Tests\Unit\ColorModels;
 
 use InvalidArgumentException;
 use TorstenHettstedt\Colors\ColorModels\CyanMagentaYellowKey;
@@ -8,7 +8,7 @@ use TorstenHettstedt\Colors\ColorModels\CyanMagentaYellowKey;
 class CyanMagentaYellowKeyTest extends AbstractColorModelUnit
 {
 
-    public function testConstruct()
+    public function testConstruct(): void
     {
         $color = new CyanMagentaYellowKey();
 
@@ -23,7 +23,7 @@ class CyanMagentaYellowKeyTest extends AbstractColorModelUnit
      *
      * @dataProvider validValueProvider
      */
-    public function testSetCyanWithValidValue(float $value)
+    public function testSetCyanWithValidValue(float $value): void
     {
         $color = new CyanMagentaYellowKey();
 
@@ -36,7 +36,7 @@ class CyanMagentaYellowKeyTest extends AbstractColorModelUnit
      *
      * @dataProvider validValueProvider
      */
-    public function testSetMagentaWithValidValue(float $value)
+    public function testSetMagentaWithValidValue(float $value): void
     {
         $color = new CyanMagentaYellowKey();
 
@@ -49,7 +49,7 @@ class CyanMagentaYellowKeyTest extends AbstractColorModelUnit
      *
      * @dataProvider validValueProvider
      */
-    public function testSetYellowWithValidValue(float $value)
+    public function testSetYellowWithValidValue(float $value): void
     {
         $color = new CyanMagentaYellowKey();
 
@@ -62,7 +62,7 @@ class CyanMagentaYellowKeyTest extends AbstractColorModelUnit
      *
      * @dataProvider validValueProvider
      */
-    public function testSetKeyWithValidValue(float $value)
+    public function testSetKeyWithValidValue(float $value): void
     {
         $color = new CyanMagentaYellowKey();
 
@@ -75,7 +75,7 @@ class CyanMagentaYellowKeyTest extends AbstractColorModelUnit
      *
      * @dataProvider invalidValueProvider
      */
-    public function testSetCyanWithInvalidValue(float $value)
+    public function testSetCyanWithInvalidValue(float $value): void
     {
         $color = new CyanMagentaYellowKey();
 
@@ -88,7 +88,7 @@ class CyanMagentaYellowKeyTest extends AbstractColorModelUnit
      *
      * @dataProvider invalidValueProvider
      */
-    public function testSetMagentaWithInvalidValue(float $value)
+    public function testSetMagentaWithInvalidValue(float $value): void
     {
         $color = new CyanMagentaYellowKey();
 
@@ -101,7 +101,7 @@ class CyanMagentaYellowKeyTest extends AbstractColorModelUnit
      *
      * @dataProvider invalidValueProvider
      */
-    public function testSetYellowWithInvalidValue(float $value)
+    public function testSetYellowWithInvalidValue(float $value): void
     {
         $color = new CyanMagentaYellowKey();
 
@@ -114,7 +114,7 @@ class CyanMagentaYellowKeyTest extends AbstractColorModelUnit
      *
      * @dataProvider invalidValueProvider
      */
-    public function testSetKeyWithInvalidValue(float $value)
+    public function testSetKeyWithInvalidValue(float $value): void
     {
         $color = new CyanMagentaYellowKey();
 

tests/unit/ColorModels/HueSaturationValueTest.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace TorstenHettstedtUnitTests\Colors\ColorModels;
+namespace TorstenHettstedt\Colors\Tests\Unit\ColorModels;
 
 use InvalidArgumentException;
 use TorstenHettstedt\Colors\ColorModels\HueSaturationValue;
@@ -8,7 +8,7 @@ use TorstenHettstedt\Colors\ColorModels\HueSaturationValue;
 class HueSaturationValueTest extends AbstractColorModelUnit
 {
 
-    public function testConstruct()
+    public function testConstruct(): void
     {
         $color = new HueSaturationValue();
 
@@ -22,7 +22,7 @@ class HueSaturationValueTest extends AbstractColorModelUnit
      *
      * @dataProvider validValueProvider
      */
-    public function testSetHueWithValidValue(float $value)
+    public function testSetHueWithValidValue(float $value): void
     {
         $color = new HueSaturationValue();
 
@@ -35,7 +35,7 @@ class HueSaturationValueTest extends AbstractColorModelUnit
      *
      * @dataProvider invalidValueProvider
      */
-    public function testSetHueWithInvalidValue(float $value)
+    public function testSetHueWithInvalidValue(float $value): void
     {
         $color = new HueSaturationValue();
 
@@ -48,7 +48,7 @@ class HueSaturationValueTest extends AbstractColorModelUnit
      *
      * @dataProvider validValueProvider
      */
-    public function testSetSaturationWithValidValue(float $value)
+    public function testSetSaturationWithValidValue(float $value): void
     {
         $color = new HueSaturationValue();
 
@@ -61,7 +61,7 @@ class HueSaturationValueTest extends AbstractColorModelUnit
      *
      * @dataProvider invalidValueProvider
      */
-    public function testSetSaturationWithInvalidValue(float $value)
+    public function testSetSaturationWithInvalidValue(float $value): void
     {
         $color = new HueSaturationValue();
 
@@ -74,7 +74,7 @@ class HueSaturationValueTest extends AbstractColorModelUnit
      *
      * @dataProvider validValueProvider
      */
-    public function testSetValueWithValidValue(float $value)
+    public function testSetValueWithValidValue(float $value): void
     {
         $color = new HueSaturationValue();
 
@@ -87,7 +87,7 @@ class HueSaturationValueTest extends AbstractColorModelUnit
      *
      * @dataProvider invalidValueProvider
      */
-    public function testSetValueWithInvalidValue(float $value)
+    public function testSetValueWithInvalidValue(float $value): void
     {
         $color = new HueSaturationValue();
 

tests/unit/ColorModels/RedGreenBlueTest.php

@@ -1,6 +1,6 @@
-<?php /** @noinspection PhpArrayShapeAttributeCanBeAddedInspection */
+<?php
 
-namespace TorstenHettstedtUnitTests\Colors\ColorModels;
+namespace TorstenHettstedt\Colors\Tests\Unit\ColorModels;
 
 use InvalidArgumentException;
 use TorstenHettstedt\Colors\ColorModels\RedGreenBlue;
@@ -8,7 +8,7 @@ use TorstenHettstedt\Colors\ColorModels\RedGreenBlue;
 class RedGreenBlueTest extends AbstractColorModelUnit
 {
 
-    public function testConstruct()
+    public function testConstruct(): void
     {
         $color = new RedGreenBlue();
 
@@ -22,7 +22,7 @@ class RedGreenBlueTest extends AbstractColorModelUnit
      *
      * @dataProvider validValueProvider
      */
-    public function testSetRedWithValidValue(float $value)
+    public function testSetRedWithValidValue(float $value): void
     {
         $color = new RedGreenBlue();
 
@@ -35,7 +35,7 @@ class RedGreenBlueTest extends AbstractColorModelUnit
      *
      * @dataProvider invalidValueProvider
      */
-    public function testSetRedWithInvalidValue(float $value)
+    public function testSetRedWithInvalidValue(float $value): void
     {
         $color = new RedGreenBlue();
 
@@ -47,7 +47,7 @@ class RedGreenBlueTest extends AbstractColorModelUnit
      *
      * @dataProvider validValueProvider
      */
-    public function testSetGreenWithValidValue(float $value)
+    public function testSetGreenWithValidValue(float $value): void
     {
         $color = new RedGreenBlue();
 
@@ -60,7 +60,7 @@ class RedGreenBlueTest extends AbstractColorModelUnit
      *
      * @dataProvider invalidValueProvider
      */
-    public function testSetGreenWithInvalidValue(float $value)
+    public function testSetGreenWithInvalidValue(float $value): void
     {
         $color = new RedGreenBlue();
 
@@ -73,7 +73,7 @@ class RedGreenBlueTest extends AbstractColorModelUnit
      *
      * @dataProvider validValueProvider
      */
-    public function testSetBlueWithValidValue(float $value)
+    public function testSetBlueWithValidValue(float $value): void
     {
         $color = new RedGreenBlue();
 
@@ -86,7 +86,7 @@ class RedGreenBlueTest extends AbstractColorModelUnit
      *
      * @dataProvider invalidValueProvider
      */
-    public function testSetBlueWithInvalidValue(float $value)
+    public function testSetBlueWithInvalidValue(float $value): void
     {
         $color = new RedGreenBlue();
 

tests/unit/NaturallyColorModels/AbstractColorModelUnit.php

@@ -0,0 +1,82 @@
+<?php /** @noinspection PhpArrayShapeAttributeCanBeAddedInspection */
+
+
+namespace TorstenHettstedt\Colors\Tests\Unit\NaturallyColorModels;
+
+use Codeception\Test\Unit;
+
+abstract class AbstractColorModelUnit extends Unit
+{
+
+    abstract public function testConstruct(): void;
+
+    /**
+     * @return int[][]
+     */
+    public function invalidPercentValueProvider(): array
+    {
+        return [
+            'zu klein' => [-1],
+            'zu gross' => [101],
+        ];
+    }
+
+    /**
+     * @return int[][]
+     */
+    public function validPercentValueProvider(): array
+    {
+        return [
+            'niedrigster Wert' => [0],
+            'mittlerer Wert' => [45],
+            'maximaler Wert' => [100],
+        ];
+    }
+
+    /**
+     * @return int[][]
+     */
+    public function invalidGradValueProvider(): array
+    {
+        return [
+            'zu klein' => [-1],
+            'zu gross' => [361],
+        ];
+    }
+
+    /**
+     * @return int[][]
+     */
+    public function validGradValueProvider(): array
+    {
+        return [
+            'niedrigster Wert' => [0],
+            'mittlerer Wert' => [45],
+            'maximaler Wert' => [360],
+        ];
+    }
+
+    /**
+     * @return int[][]
+     */
+    public function invalidHexadecimalValueProvider(): array
+    {
+        return [
+            'zu klein' => [-0x1],
+            'zu gross' => [0x100],
+        ];
+    }
+
+    /**
+     * @return int[][]
+     */
+    public function validHexadecimalValueProvider(): array
+    {
+        return [
+            'niedrigster Wert' => [0x0],
+            'mittlerer Wert' => [0xD9],
+            'maximaler Wert' => [0xFF],
+        ];
+    }
+
+}

tests/unit/NaturallyColorModels/CyanMagentaYellowKeyTest.php

@@ -0,0 +1,143 @@
+<?php
+
+namespace TorstenHettstedt\Colors\Tests\Unit\NaturallyColorModels;
+
+use InvalidArgumentException;
+use TorstenHettstedt\Colors\NaturallyColorModels\CyanMagentaYellowKey;
+
+class CyanMagentaYellowKeyTest extends AbstractColorModelUnit
+{
+
+    public function testConstruct(): void
+    {
+        $color = new CyanMagentaYellowKey();
+
+        $this->assertIsInt($color->getCyan());
+        $this->assertEquals(0, $color->getCyan());
+        $this->assertIsInt($color->getMagenta());
+        $this->assertEquals(0, $color->getMagenta());
+        $this->assertIsInt($color->getCyan());
+        $this->assertEquals(0, $color->getYellow());
+        $this->assertIsInt($color->getKey());
+        $this->assertEquals(0, $color->getKey());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider validPercentValueProvider
+     */
+    public function testSetCyanWithValidValue(int $value): void
+    {
+        $color = new CyanMagentaYellowKey();
+
+        $color->setCyan($value);
+        $this->assertEquals($value, $color->getCyan());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider validPercentValueProvider
+     */
+    public function testSetMagentaWithValidValue(int $value): void
+    {
+        $color = new CyanMagentaYellowKey();
+
+        $color->setMagenta($value);
+        $this->assertEquals($value, $color->getMagenta());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider validPercentValueProvider
+     */
+    public function testSetYellowWithValidValue(int $value): void
+    {
+        $color = new CyanMagentaYellowKey();
+
+        $color->setYellow($value);
+        $this->assertEquals($value, $color->getYellow());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider validPercentValueProvider
+     */
+    public function testSetKeyWithValidValue(int $value): void
+    {
+        $color = new CyanMagentaYellowKey();
+
+        $color->setKey($value);
+        $this->assertEquals($value, $color->getKey());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider invalidPercentValueProvider
+     */
+    public function testSetCyanWithInvalidValue(int $value): void
+    {
+        $color = new CyanMagentaYellowKey();
+
+        $this->expectException(InvalidArgumentException::class);
+        $color->setCyan($value);
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider invalidPercentValueProvider
+     */
+    public function testSetMagentaWithInvalidValue(int $value): void
+    {
+        $color = new CyanMagentaYellowKey();
+
+        $this->expectException(InvalidArgumentException::class);
+        $color->setMagenta($value);
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider invalidPercentValueProvider
+     */
+    public function testSetYellowWithInvalidValue(int $value): void
+    {
+        $color = new CyanMagentaYellowKey();
+
+        $this->expectException(InvalidArgumentException::class);
+        $color->setYellow($value);
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider invalidPercentValueProvider
+     */
+    public function testSetKeyWithInvalidValue(int $value): void
+    {
+        $color = new CyanMagentaYellowKey();
+
+        $this->expectException(InvalidArgumentException::class);
+        $color->setKey($value);
+    }
+
+    public function testGetPureColor(): void
+    {
+        $naturally_color = new CyanMagentaYellowKey();
+        $naturally_color
+            ->setCyan(12)
+            ->setMagenta(28)
+            ->setYellow(37)
+            ->setKey(56);
+        $pure_color = $naturally_color->getPureColor();
+        $this->assertEquals(0.12, $pure_color->getCyan());
+        $this->assertEquals(0.28, $pure_color->getMagenta());
+        $this->assertEquals(0.37, $pure_color->getYellow());
+        $this->assertEquals(0.56, $pure_color->getKey());
+    }
+}

tests/unit/NaturallyColorModels/HueSaturationValueTest.php

@@ -0,0 +1,113 @@
+<?php
+
+namespace TorstenHettstedt\Colors\Tests\Unit\NaturallyColorModels;
+
+use InvalidArgumentException;
+use TorstenHettstedt\Colors\NaturallyColorModels\HueSaturationValue;
+
+class HueSaturationValueTest extends AbstractColorModelUnit
+{
+
+    public function testConstruct(): void
+    {
+        $color = new HueSaturationValue();
+
+        $this->assertIsInt($color->getHue());
+        $this->assertEquals(0, $color->getHue());
+        $this->assertIsInt($color->getSaturation());
+        $this->assertEquals(0, $color->getSaturation());
+        $this->assertIsInt($color->getValue());
+        $this->assertEquals(100, $color->getValue());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider validGradValueProvider
+     */
+    public function testSetHueWithValidValue(int $value): void
+    {
+        $color = new HueSaturationValue();
+
+        $color->setHue($value);
+        $this->assertEquals($value, $color->getHue());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider invalidGradValueProvider
+     */
+    public function testSetHueWithInvalidValue(int $value): void
+    {
+        $color = new HueSaturationValue();
+
+        $this->expectException(InvalidArgumentException::class);
+        $color->setHue($value);
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider validPercentValueProvider
+     */
+    public function testSetSaturationWithValidValue(int $value): void
+    {
+        $color = new HueSaturationValue();
+
+        $color->setSaturation($value);
+        $this->assertEquals($value, $color->getSaturation());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider invalidPercentValueProvider
+     */
+    public function testSetSaturationWithInvalidValue(int $value): void
+    {
+        $color = new HueSaturationValue();
+
+        $this->expectException(InvalidArgumentException::class);
+        $color->setSaturation($value);
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider validPercentValueProvider
+     */
+    public function testSetValueWithValidValue(int $value): void
+    {
+        $color = new HueSaturationValue();
+
+        $color->setValue($value);
+        $this->assertEquals($value, $color->getValue());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider invalidPercentValueProvider
+     */
+    public function testSetValueWithInvalidValue(int $value): void
+    {
+        $color = new HueSaturationValue();
+
+        $this->expectException(InvalidArgumentException::class);
+        $color->setValue($value);
+    }
+
+    public function testGetPureColor(): void
+    {
+        $naturally_color = new HueSaturationValue();
+        $naturally_color
+            ->setHue(45)
+            ->setSaturation(28)
+            ->setValue(56);
+        $pure_color = $naturally_color->getPureColor();
+        $this->assertEquals(0.125, $pure_color->getHue());
+        $this->assertEquals(0.28, $pure_color->getSaturation());
+        $this->assertEquals(0.56, $pure_color->getValue());
+    }
+}

tests/unit/NaturallyColorModels/RedGreenBlueTest.php

@@ -0,0 +1,122 @@
+<?php
+
+namespace TorstenHettstedt\Colors\Tests\Unit\NaturallyColorModels;
+
+use InvalidArgumentException;
+use TorstenHettstedt\Colors\NaturallyColorModels\RedGreenBlue;
+
+class RedGreenBlueTest extends AbstractColorModelUnit
+{
+
+    public function testConstruct(): void
+    {
+        $color = new RedGreenBlue();
+
+        $this->assertEquals(0xFF, $color->getRed());
+        $this->assertEquals(0xFF, $color->getGreen());
+        $this->assertEquals(0xFF, $color->getBlue());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider validHexadecimalValueProvider
+     */
+    public function testSetRedWithValidValue(int $value): void
+    {
+        $color = new RedGreenBlue();
+
+        $color->setRed($value);
+        $this->assertEquals($value, $color->getRed());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider invalidHexadecimalValueProvider
+     */
+    public function testSetRedWithInvalidValue(int $value): void
+    {
+        $color = new RedGreenBlue();
+
+        $this->expectException(InvalidArgumentException::class);
+        $color->setRed($value);
+    }
+    /**
+     * @param int $value
+     *
+     * @dataProvider validHexadecimalValueProvider
+     */
+    public function testSetGreenWithValidValue(int $value): void
+    {
+        $color = new RedGreenBlue();
+
+        $color->setGreen($value);
+        $this->assertEquals($value, $color->getGreen());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider invalidHexadecimalValueProvider
+     */
+    public function testSetGreenWithInvalidValue(int $value): void
+    {
+        $color = new RedGreenBlue();
+
+        $this->expectException(InvalidArgumentException::class);
+        $color->setGreen($value);
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider validHexadecimalValueProvider
+     */
+    public function testSetBlueWithValidValue(int $value): void
+    {
+        $color = new RedGreenBlue();
+
+        $color->setBlue($value);
+        $this->assertEquals($value, $color->getBlue());
+    }
+
+    /**
+     * @param int $value
+     *
+     * @dataProvider invalidHexadecimalValueProvider
+     */
+    public function testSetBlueWithInvalidValue(int $value): void
+    {
+        $color = new RedGreenBlue();
+
+        $this->expectException(InvalidArgumentException::class);
+        $color->setBlue($value);
+    }
+
+    public function testHtmlNotation(): void
+    {
+        $color = new RedGreenBlue();
+        $color->setRed(0xA1);
+        $color->setGreen(0xB2);
+        $color->setBlue(0xC3);
+
+        $html = $color->asHtmlNotation();
+
+        $this->assertIsString($html);
+        $this->assertEquals('#A1B2C3', $html);
+    }
+
+    public function testGetPureColor(): void
+    {
+        $naturally_color = new RedGreenBlue();
+        $naturally_color
+            ->setRed(0x33)
+            ->setBlue(0x66)
+            ->setGreen(0x99);
+        $pure_color = $naturally_color->getPureColor();
+        $this->assertEquals(0.2, $pure_color->getRed());
+        $this->assertEquals(0.4, $pure_color->getBlue());
+        $this->assertEquals(0.6, $pure_color->getGreen());
+    }
+}

tests/unit/NaturallyTransformer/CyanMagentaYellowKeyTransformerTest.php

@@ -0,0 +1,121 @@
+<?php
+
+namespace TorstenHettstedt\Colors\Tests\Unit\NaturallyTransformer;
+
+use Codeception\Test\Unit;
+use Exception;
+use TorstenHettstedt\Colors\NaturallyColorModels\CyanMagentaYellowKey;
+use TorstenHettstedt\Colors\Tests\Helper\ValidNaturallyColorValuesProvider;
+use TorstenHettstedt\Colors\NaturallyTransformer\CyanMagentaYellowKeyTransformer;
+
+class CyanMagentaYellowKeyTransformerTest extends Unit
+{
+
+    protected CyanMagentaYellowKey $color;
+
+    /**
+     * @return array<string, array<array<string, float>>>
+     */
+    public function validRgbValuesProvider(): array
+    {
+        return (new ValidNaturallyColorValuesProvider())->getValidColorValues(
+            ValidNaturallyColorValuesProvider::CMYK,
+            ValidNaturallyColorValuesProvider::RGB
+        );
+    }
+
+    /**
+     * @return array<string, array<array<string, float>>>
+     */
+    public function validHsvValuesProvider(): array
+    {
+        return (new ValidNaturallyColorValuesProvider())->getValidColorValues(
+            ValidNaturallyColorValuesProvider::CMYK,
+            ValidNaturallyColorValuesProvider::HSV
+        );
+    }
+
+    /**
+     * @return array<string, array<array<string, float>>>
+     */
+    public function validCmykValuesProvider(): array
+    {
+        return (new ValidNaturallyColorValuesProvider())->getValidColorValues(
+            ValidNaturallyColorValuesProvider::CMYK,
+            ValidNaturallyColorValuesProvider::CMYK
+        );
+    }
+
+    /**
+     * @param array<string, float> $pure_color
+     * @param array<string, float> $rgb
+     *
+     * @dataProvider validRgbValuesProvider
+     *
+     * @throws Exception
+     */
+    public function testToRedGreenBlue(array $pure_color, array $rgb): void
+    {
+        $this->color = $this->make(CyanMagentaYellowKey::class, [
+            'getPureColor' => $this->make(\TorstenHettstedt\Colors\ColorModels\CyanMagentaYellowKey::class, $pure_color)
+        ]);
+
+        $transformer = new CyanMagentaYellowKeyTransformer($this->color);
+
+        $color = $transformer->toRedGreenBlue();
+
+        $this->assertEquals($rgb['red'], $color->getRed());
+        $this->assertEquals($rgb['green'], $color->getGreen());
+        $this->assertEquals($rgb['blue'], $color->getBlue());
+
+    }
+
+    /**
+     * @param array<string, float> $pure_color
+     * @param array<string, float> $cmyk
+     *
+     * @dataProvider validCmykValuesProvider
+     *
+     * @throws Exception
+     */
+    public function testToCyanMagentaYellowKey(array $pure_color, array $cmyk): void
+    {
+
+        $this->color = $this->make(CyanMagentaYellowKey::class, [
+            'getPureColor' => $this->make(\TorstenHettstedt\Colors\ColorModels\CyanMagentaYellowKey::class, $pure_color)
+        ]);
+
+        $transformer = new CyanMagentaYellowKeyTransformer($this->color);
+
+        $color = $transformer->toCyanMagentaYellowKey();
+
+        $this->assertEquals($cmyk['cyan'], $color->getCyan());
+        $this->assertEquals($cmyk['magenta'], $color->getMagenta());
+        $this->assertEquals($cmyk['yellow'], $color->getYellow());
+        $this->assertEquals($cmyk['key'], $color->getKey());
+    }
+
+    /**
+     * @param array<string, float> $pure_color
+     * @param array<string, float> $hsv
+     *
+     * @throws Exception
+     *
+     * @dataProvider validHsvValuesProvider
+     *
+     */
+    public function testToHueSaturationValue(array $pure_color, array $hsv): void
+    {
+        $this->color = $this->make(CyanMagentaYellowKey::class, [
+            'getPureColor' => $this->make(\TorstenHettstedt\Colors\ColorModels\CyanMagentaYellowKey::class, $pure_color)
+        ]);
+
+        $transformer = new CyanMagentaYellowKeyTransformer($this->color);
+
+        $color = $transformer->toHueSaturationValue();
+
+        $this->assertEquals($hsv['hue'], $color->getHue());
+        $this->assertEquals($hsv['saturation'], $color->getSaturation());
+        $this->assertEquals($hsv['value'], $color->getValue());
+    }
+}

tests/unit/NaturallyTransformer/HueSaturationValueTransformerTest.php

@@ -0,0 +1,118 @@
+<?php
+
+namespace TorstenHettstedt\Colors\Tests\Unit\NaturallyTransformer;
+
+use Codeception\Test\Unit;
+use Exception;
+use TorstenHettstedt\Colors\NaturallyColorModels\HueSaturationValue;
+use TorstenHettstedt\Colors\Tests\Helper\ValidNaturallyColorValuesProvider;
+use TorstenHettstedt\Colors\NaturallyTransformer\HueSaturationValueTransformer;
+
+class HueSaturationValueTransformerTest extends Unit
+{
+
+    protected HueSaturationValue $color;
+
+    /**
+     * @return array<string, array<array<string, float>>>
+     */
+    public function validCmykValuesProvider(): array
+    {
+        return (new ValidNaturallyColorValuesProvider())->getValidColorValues(
+            ValidNaturallyColorValuesProvider::HSV,
+            ValidNaturallyColorValuesProvider::CMYK,
+        );
+    }
+
+    /**
+     * @return array<string, array<array<string, float>>>
+     */
+    public function validRgbValuesProvider(): array
+    {
+        return (new ValidNaturallyColorValuesProvider())->getValidColorValues(
+            ValidNaturallyColorValuesProvider::HSV,
+            ValidNaturallyColorValuesProvider::RGB,
+        );
+    }
+
+    /**
+     * @return array<string, array<array<string, float>>>
+     */
+    public function validHsvValuesProvider(): array
+    {
+        return (new ValidNaturallyColorValuesProvider())->getValidColorValues(
+            ValidNaturallyColorValuesProvider::HSV,
+            ValidNaturallyColorValuesProvider::HSV,
+        );
+    }
+
+    /**
+     * @param array<string, float> $pure_color
+     * @param array<string, float> $rgb
+     *
+     * @dataProvider validRgbValuesProvider
+     *
+     * @throws Exception
+     */
+    public function testToRedGreenBlue(array $pure_color, array $rgb): void
+    {
+        $this->color = $this->make(HueSaturationValue::class, [
+            'getPureColor' => $this->make(\TorstenHettstedt\Colors\ColorModels\HueSaturationValue::class, $pure_color)
+        ]);
+
+        $transformer = new HueSaturationValueTransformer($this->color);
+
+        $color = $transformer->toRedGreenBlue();
+
+        $this->assertEquals($rgb['red'], $color->getRed());
+        $this->assertEquals($rgb['green'], $color->getGreen());
+        $this->assertEquals($rgb['blue'], $color->getBlue());
+
+    }
+
+    /**
+     * @param array<string, float> $pure_color
+     * @param array<string, float> $cmyk
+     *
+     * @throws Exception
+     * @dataProvider validCmykValuesProvider
+     *
+     */
+    public function testToCyanMagentaYellowKey(array $pure_color, array $cmyk): void
+    {
+        $this->color = $this->make(HueSaturationValue::class, [
+            'getPureColor' => $this->make(\TorstenHettstedt\Colors\ColorModels\HueSaturationValue::class, $pure_color)
+        ]);
+
+        $transformer = new HueSaturationValueTransformer($this->color);
+
+        $color = $transformer->toCyanMagentaYellowKey();
+
+        $this->assertEquals($cmyk['cyan'], $color->getCyan());
+        $this->assertEquals($cmyk['magenta'], $color->getMagenta());
+        $this->assertEquals($cmyk['yellow'], $color->getYellow());
+        $this->assertEquals($cmyk['key'], $color->getKey());
+    }
+
+    /**
+     * @param array<string, float> $pure_color
+     * @param array<string, float> $hsv
+     *
+     * @throws Exception
+     * @dataProvider validHsvValuesProvider
+     */
+    public function testToHueSaturationValue(array $pure_color, array $hsv): void
+    {
+        $this->color = $this->make(HueSaturationValue::class, [
+            'getPureColor' => $this->make(\TorstenHettstedt\Colors\ColorModels\HueSaturationValue::class, $pure_color)
+        ]);
+
+        $transformer = new HueSaturationValueTransformer($this->color);
+
+        $color = $transformer->toHueSaturationValue();
+
+        $this->assertEquals($hsv['hue'], $color->getHue());
+        $this->assertEquals($hsv['saturation'], $color->getSaturation());
+        $this->assertEquals($hsv['value'], $color->getValue());
+    }
+}

tests/unit/NaturallyTransformer/RedGreenBlueTransformerTest.php

@@ -0,0 +1,118 @@
+<?php
+
+namespace TorstenHettstedt\Colors\Tests\Unit\NaturallyTransformer;
+
+use Codeception\Test\Unit;
+use Exception;
+use TorstenHettstedt\Colors\NaturallyColorModels\RedGreenBlue;
+use TorstenHettstedt\Colors\Tests\Helper\ValidNaturallyColorValuesProvider;
+use TorstenHettstedt\Colors\NaturallyTransformer\RedGreenBlueTransformer;
+
+class RedGreenBlueTransformerTest extends Unit
+{
+
+    protected RedGreenBlue $color;
+
+    /**
+     * @return array<string, array<array<string, float>>>
+     */
+    public function validCmykValuesProvider(): array
+    {
+        return (new ValidNaturallyColorValuesProvider())->getValidColorValues(
+            ValidNaturallyColorValuesProvider::RGB,
+            ValidNaturallyColorValuesProvider::CMYK,
+        );
+    }
+
+    /**
+     * @return array<string, array<array<string, float>>>
+     */
+    public function validHsvValuesProvider(): array
+    {
+        return (new ValidNaturallyColorValuesProvider())->getValidColorValues(
+            ValidNaturallyColorValuesProvider::RGB,
+            ValidNaturallyColorValuesProvider::HSV,
+        );
+    }
+
+    /**
+     * @return array<string, array<array<string, float>>>
+     */
+    public function validRgbValuesProvider(): array
+    {
+        return (new ValidNaturallyColorValuesProvider())->getValidColorValues(
+            ValidNaturallyColorValuesProvider::RGB,
+            ValidNaturallyColorValuesProvider::RGB,
+        );
+    }
+
+    /**
+     * @param array<string, float> $pure_color
+     * @param array<string, float> $rgb
+     *
+     * @dataProvider validRgbValuesProvider
+     *
+     * @throws Exception
+     */
+    public function testToRedGreenBlue(array $pure_color, array $rgb): void
+    {
+        $this->color = $this->make(RedGreenBlue::class, [
+            'getPureColor' => $this->make(\TorstenHettstedt\Colors\ColorModels\RedGreenBlue::class, $pure_color)
+        ]);
+
+        $transformer = new RedGreenBlueTransformer($this->color);
+
+        $color = $transformer->toRedGreenBlue();
+
+        $this->assertEquals($rgb['red'], $color->getRed());
+        $this->assertEquals($rgb['green'], $color->getGreen());
+        $this->assertEquals($rgb['blue'], $color->getBlue());
+
+    }
+
+    /**
+     * @param array<string, float> $pure_color
+     * @param array<string, float> $cmyk
+     *
+     * @throws Exception
+     * @dataProvider validCmykValuesProvider
+     *
+     */
+    public function testToCyanMagentaYellowKey(array $pure_color, array $cmyk): void
+    {
+        $this->color = $this->make(RedGreenBlue::class, [
+            'getPureColor' => $this->make(\TorstenHettstedt\Colors\ColorModels\RedGreenBlue::class, $pure_color)
+        ]);
+
+        $transformer = new RedGreenBlueTransformer($this->color);
+
+        $color = $transformer->toCyanMagentaYellowKey();
+
+        $this->assertEquals($cmyk['cyan'], $color->getCyan());
+        $this->assertEquals($cmyk['magenta'], $color->getMagenta());
+        $this->assertEquals($cmyk['yellow'], $color->getYellow());
+        $this->assertEquals($cmyk['key'], $color->getKey());
+    }
+
+    /**
+     * @param array<string, float> $pure_color
+     * @param array<string, float> $hsv
+     *
+     * @throws Exception
+     * @dataProvider validHsvValuesProvider
+     */
+    public function testToHueSaturationValue(array $pure_color, array $hsv): void
+    {
+        $this->color = $this->make(RedGreenBlue::class, [
+            'getPureColor' => $this->make(\TorstenHettstedt\Colors\ColorModels\RedGreenBlue::class, $pure_color)
+        ]);
+
+        $transformer = new RedGreenBlueTransformer($this->color);
+
+        $color = $transformer->toHueSaturationValue();
+
+        $this->assertEquals($hsv['hue'], $color->getHue());
+        $this->assertEquals($hsv['saturation'], $color->getSaturation());
+        $this->assertEquals($hsv['value'], $color->getValue());
+    }
+}

tests/unit/Transformer/CyanMagentaYellowKeyTransformerTest.php

@@ -1,10 +1,11 @@
-<?php /** @noinspection PhpArrayShapeAttributeCanBeAddedInspection */
+<?php
 
-namespace TorstenHettstedtUnitTests\Colors\Transformer;
+namespace TorstenHettstedt\Colors\Tests\Unit\Transformer;
 
 use Codeception\Test\Unit;
 use Exception;
 use TorstenHettstedt\Colors\ColorModels\CyanMagentaYellowKey;
+use TorstenHettstedt\Colors\Tests\Helper\ValidColorValuesProvider;
 use TorstenHettstedt\Colors\Transformer\CyanMagentaYellowKeyTransformer;
 
 class CyanMagentaYellowKeyTransformerTest extends Unit
@@ -15,7 +16,7 @@ class CyanMagentaYellowKeyTransformerTest extends Unit
     protected CyanMagentaYellowKey $color;
 
     /**
-     * @return float[][][]
+     * @return array<string, array<array<string, float>>>
      */
     public function validRgbValuesProvider(): array
     {
@@ -26,7 +27,7 @@ class CyanMagentaYellowKeyTransformerTest extends Unit
     }
 
     /**
-     * @return float[][][]
+     * @return array<string, array<array<string, float>>>
      */
     public function validHsvValuesProvider(): array
     {
@@ -37,14 +38,14 @@ class CyanMagentaYellowKeyTransformerTest extends Unit
     }
 
     /**
-     * @param array $cmyk
-     * @param array $rgb
+     * @param array<string, float> $cmyk
+     * @param array<string, float> $rgb
      *
      * @dataProvider validRgbValuesProvider
      *
      * @throws Exception
      */
-    public function testToRedGreenBlue(array $cmyk, array $rgb)
+    public function testToRedGreenBlue(array $cmyk, array $rgb): void
     {
         $this->color = $this->make(CyanMagentaYellowKey::class, $cmyk);
 
@@ -59,13 +60,13 @@ class CyanMagentaYellowKeyTransformerTest extends Unit
     }
 
     /**
-     * @param array $cmyk
+     * @param array<string, float> $cmyk
      *
      * @dataProvider validRgbValuesProvider
      *
      * @throws Exception
      */
-    public function testToCyanMagentaYellowKey(array $cmyk)
+    public function testToCyanMagentaYellowKey(array $cmyk): void
     {
 
         $this->color = $this->make(CyanMagentaYellowKey::class, $cmyk);
@@ -81,15 +82,15 @@ class CyanMagentaYellowKeyTransformerTest extends Unit
     }
 
     /**
-     * @param array $cmyk
-     * @param array $hsv
+     * @param array<string, float> $cmyk
+     * @param array<string, float> $hsv
      *
      * @throws Exception
      *
      * @dataProvider validHsvValuesProvider
      *
      */
-    public function testToHueSaturationValue(array $cmyk, array $hsv)
+    public function testToHueSaturationValue(array $cmyk, array $hsv): void
     {
         $this->color = $this->make(CyanMagentaYellowKey::class, $cmyk);
 

tests/unit/Transformer/HueSaturationValueTransformerTest.php

@@ -1,10 +1,11 @@
-<?php /** @noinspection PhpArrayShapeAttributeCanBeAddedInspection */
+<?php
 
-namespace TorstenHettstedtUnitTests\Colors\Transformer;
+namespace TorstenHettstedt\Colors\Tests\Unit\Transformer;
 
 use Codeception\Test\Unit;
 use Exception;
 use TorstenHettstedt\Colors\ColorModels\HueSaturationValue;
+use TorstenHettstedt\Colors\Tests\Helper\ValidColorValuesProvider;
 use TorstenHettstedt\Colors\Transformer\HueSaturationValueTransformer;
 
 class HueSaturationValueTransformerTest extends Unit
@@ -15,7 +16,7 @@ class HueSaturationValueTransformerTest extends Unit
     protected HueSaturationValue $color;
 
     /**
-     * @return float[][][]
+     * @return array<string, array<array<string, float>>>
      */
     public function validCmykValuesProvider(): array
     {
@@ -26,7 +27,7 @@ class HueSaturationValueTransformerTest extends Unit
     }
 
     /**
-     * @return float[][][]
+     * @return array<string, array<array<string, float>>>
      */
     public function validRgbValuesProvider(): array
     {
@@ -37,14 +38,14 @@ class HueSaturationValueTransformerTest extends Unit
     }
 
     /**
-     * @param array $hsv
-     * @param array $rgb
+     * @param array<string, float> $hsv
+     * @param array<string, float> $rgb
      *
      * @dataProvider validRgbValuesProvider
      *
      * @throws Exception
      */
-    public function testToRedGreenBlue(array $hsv, array $rgb)
+    public function testToRedGreenBlue(array $hsv, array $rgb): void
     {
         $this->color = $this->make(HueSaturationValue::class, $hsv);
 
@@ -59,14 +60,14 @@ class HueSaturationValueTransformerTest extends Unit
     }
 
     /**
-     * @param array $hsv
-     * @param array $cmyk
+     * @param array<string, float> $hsv
+     * @param array<string, float> $cmyk
      *
      * @throws Exception
      * @dataProvider validCmykValuesProvider
      *
      */
-    public function testToCyanMagentaYellowKey(array $hsv, array $cmyk)
+    public function testToCyanMagentaYellowKey(array $hsv, array $cmyk): void
     {
 
         $this->color = $this->make(HueSaturationValue::class, $hsv);
@@ -82,15 +83,12 @@ class HueSaturationValueTransformerTest extends Unit
     }
 
     /**
-     * @param array $hsv
-     * @param array $cmyk
+     * @param array<string, float> $hsv
      *
      * @throws Exception
-     *
      * @dataProvider validCmykValuesProvider
-     *
      */
-    public function testToHueSaturationValue(array $hsv, array $cmyk)
+    public function testToHueSaturationValue(array $hsv): void
     {
         $this->color = $this->make(HueSaturationValue::class, $hsv);
 

tests/unit/Transformer/RedGreenBlueTransformerTest.php

@@ -1,10 +1,11 @@
-<?php /** @noinspection PhpArrayShapeAttributeCanBeAddedInspection */
+<?php
 
-namespace TorstenHettstedtUnitTests\Colors\Transformer;
+namespace TorstenHettstedt\Colors\Tests\Unit\Transformer;
 
 use Codeception\Test\Unit;
 use Exception;
 use TorstenHettstedt\Colors\ColorModels\RedGreenBlue;
+use TorstenHettstedt\Colors\Tests\Helper\ValidColorValuesProvider;
 use TorstenHettstedt\Colors\Transformer\RedGreenBlueTransformer;
 
 class RedGreenBlueTransformerTest extends Unit
@@ -15,7 +16,7 @@ class RedGreenBlueTransformerTest extends Unit
     protected RedGreenBlue $color;
 
     /**
-     * @return float[][][]
+     * @return array<string, array<array<string, float>>>
      */
     public function validCmykValuesProvider(): array
     {
@@ -26,7 +27,7 @@ class RedGreenBlueTransformerTest extends Unit
     }
 
     /**
-     * @return float[][][]
+     * @return array<string, array<array<string, float>>>
      */
     public function validHsvValuesProvider(): array
     {
@@ -37,13 +38,13 @@ class RedGreenBlueTransformerTest extends Unit
     }
 
     /**
-     * @param array $rgb
+     * @param array<string, float> $rgb
      *
      * @dataProvider validCmykValuesProvider
      *
      * @throws Exception
      */
-    public function testToRedGreenBlue(array $rgb)
+    public function testToRedGreenBlue(array $rgb): void
     {
         $this->color = $this->make(RedGreenBlue::class, $rgb);
 
@@ -58,14 +59,14 @@ class RedGreenBlueTransformerTest extends Unit
     }
 
     /**
-     * @param array $rgb
-     * @param array $cmyk
+     * @param array<string, float> $rgb
+     * @param array<string, float> $cmyk
      *
      * @throws Exception
      * @dataProvider validCmykValuesProvider
      *
      */
-    public function testToCyanMagentaYellowKey(array $rgb, array $cmyk)
+    public function testToCyanMagentaYellowKey(array $rgb, array $cmyk): void
     {
 
         $this->color = $this->make(RedGreenBlue::class, $rgb);
@@ -81,13 +82,13 @@ class RedGreenBlueTransformerTest extends Unit
     }
 
     /**
-     * @param array $rgb
-     * @param array $hsv
+     * @param array<string, float> $rgb
+     * @param array<string, float> $hsv
      *
      * @throws Exception
      * @dataProvider validHsvValuesProvider
      */
-    public function testToHueSaturationValue(array $rgb, array $hsv)
+    public function testToHueSaturationValue(array $rgb, array $hsv): void
     {
         $this->color = $this->make(RedGreenBlue::class, $rgb);