Improve documented types for filter() and correct language in doc-b…

…lock descriptions

Signed-off-by: George Steel <[email protected]>

src/AllowList.php

@@ -57,7 +57,7 @@ public function getStrict()
     }
 
     /**
-     * Set the list of items to white-list.
+     * Set the list of items to allow
      *
      * @param array|Traversable $list
      */
@@ -71,7 +71,7 @@ public function setList($list = []): void
     }
 
     /**
-     * Get the list of items to white-list
+     * Get the list of items to allow
      *
      * @return array
      */
@@ -83,7 +83,11 @@ public function getList()
     /**
      * {@inheritDoc}
      *
-     * Will return $value if its present in the white-list. If $value is rejected then it will return null.
+     * Will return $value if its present in the allow-list. If $value is rejected then it will return null.
+     *
+     * @template T
+     * @param T $value
+     * @return T|null
      */
     public function filter(mixed $value): mixed
     {