Merge pull request #8 from aporat/analysis-MPvEyj

Apply fixes from StyleCI

Author: aporat

src/Contracts/Filter.php

@@ -7,8 +7,9 @@ interface Filter
     /**
      * Apply the filter to the given value.
      *
-     * @param  mixed  $value  The value to filter
-     * @param  array<string, mixed>  $options  Optional configuration for the filter
+     * @param mixed                $value   The value to filter
+     * @param array<string, mixed> $options Optional configuration for the filter
+     *
      * @return mixed The filtered value
      */
     public function apply(mixed $value, array $options = []): mixed;

src/FilterVar.php

@@ -19,7 +19,7 @@ class FilterVar
     /**
      * Create a new FilterVar instance.
      *
-     * @param  array<string, mixed>  $config  Configuration array, optionally containing 'custom_filters'
+     * @param array<string, mixed> $config Configuration array, optionally containing 'custom_filters'
      */
     public function __construct(array $config = [])
     {
@@ -35,47 +35,49 @@ protected function getDefaultFilters(): array
     {
         return [
             'Capitalize' => Filters\Capitalize::class,
-            'Cast' => Filters\Cast::class,
-            'Escape' => Filters\EscapeHTML::class,
+            'Cast'       => Filters\Cast::class,
+            'Escape'     => Filters\EscapeHTML::class,
             'FormatDate' => Filters\FormatDate::class,
-            'Lowercase' => Filters\Lowercase::class,
-            'Uppercase' => Filters\Uppercase::class,
-            'Trim' => Filters\Trim::class,
-            'StripTags' => Filters\StripTags::class,
-            'Digit' => Filters\Digit::class,
-            'FilterIf' => Filters\FilterIf::class,
+            'Lowercase'  => Filters\Lowercase::class,
+            'Uppercase'  => Filters\Uppercase::class,
+            'Trim'       => Filters\Trim::class,
+            'StripTags'  => Filters\StripTags::class,
+            'Digit'      => Filters\Digit::class,
+            'FilterIf'   => Filters\FilterIf::class,
         ];
     }
 
     /**
      * Apply a single filter to a value.
      *
-     * @param  array{0: string, 1?: array<string, mixed>}  $rule  Filter name and optional options
-     * @param  mixed  $value  The value to filter
-     * @return mixed The filtered value
+     * @param array{0: string, 1?: array<string, mixed>} $rule  Filter name and optional options
+     * @param mixed                                      $value The value to filter
      *
      * @throws InvalidArgumentException If the filter name is not registered
+     *
+     * @return mixed The filtered value
      */
     protected function applyFilter(array $rule, mixed $value): mixed
     {
         $name = $rule[0];
         $options = $rule[1] ?? [];
 
-        if (! isset($this->filters[$name])) {
+        if (!isset($this->filters[$name])) {
             throw new InvalidArgumentException("No filter registered for the name '$name'.");
         }
 
         /** @var Filter $filter */
-        $filter = new $this->filters[$name];
+        $filter = new $this->filters[$name]();
 
         return $filter->apply($value, $options);
     }
 
     /**
      * Apply a chain of filters to a value based on a rule string.
      *
-     * @param  string  $ruleString  Filter rules (e.g., "trim|uppercase")
-     * @param  mixed  $value  The value to filter
+     * @param string $ruleString Filter rules (e.g., "trim|uppercase")
+     * @param mixed  $value      The value to filter
+     *
      * @return mixed The filtered value
      */
     public function filterValue(string $ruleString, mixed $value): mixed

src/Filters/Capitalize.php

@@ -12,13 +12,14 @@ class Capitalize implements Filter
      * This filter converts the input to lowercase first, then applies title case
      * capitalization using multibyte-safe functions. Non-string inputs are returned unchanged.
      *
-     * @param  mixed  $value  The value to capitalize
-     * @param  array<string, mixed>  $options  Optional filter options (currently unused)
+     * @param mixed                $value   The value to capitalize
+     * @param array<string, mixed> $options Optional filter options (currently unused)
+     *
      * @return mixed The capitalized string or original value if not a string
      */
     public function apply(mixed $value, array $options = []): mixed
     {
-        if (! is_string($value)) {
+        if (!is_string($value)) {
             return $value;
         }
 

src/Filters/Cast.php

@@ -15,11 +15,12 @@ class Cast implements Filter
      * Supported types: int, integer, float, real, double, string, bool, boolean, object,
      * array, collection. If an unsupported type is provided, an exception is thrown.
      *
-     * @param  mixed  $value  The value to cast
-     * @param  array  $options  Options array where the first element specifies the target type
-     * @return mixed The value cast to the specified type
+     * @param mixed $value   The value to cast
+     * @param array $options Options array where the first element specifies the target type
      *
      * @throws InvalidArgumentException If the type is invalid or not provided
+     *
+     * @return mixed The value cast to the specified type
      */
     public function apply(mixed $value, array $options = []): mixed
     {

src/Filters/Digit.php

@@ -14,8 +14,9 @@ class Digit implements Filter
      * inputs are implicitly converted to strings by preg_replace, and an empty string
      * is returned if no digits are present or if the input is null.
      *
-     * @param  mixed  $value  The value to filter (typically a string)
-     * @param  array<string, mixed>  $options  Optional filter options (currently unused)
+     * @param mixed                $value   The value to filter (typically a string)
+     * @param array<string, mixed> $options Optional filter options (currently unused)
+     *
      * @return string The filtered value containing only digits
      */
     public function apply(mixed $value, array $options = []): string

src/Filters/EscapeHTML.php

@@ -13,8 +13,9 @@ class EscapeHTML implements Filter
      * using htmlspecialchars. If the input is a string, it’s escaped; non-string inputs
      * are returned unchanged.
      *
-     * @param  mixed  $value  The value to escape (typically a string)
-     * @param  array<string, mixed>  $options  Optional filter options (currently unused)
+     * @param mixed                $value   The value to escape (typically a string)
+     * @param array<string, mixed> $options Optional filter options (currently unused)
+     *
      * @return mixed The escaped string or original value if not a string
      */
     public function apply(mixed $value, array $options = []): mixed

src/Filters/FilterIf.php

@@ -15,8 +15,9 @@ class FilterIf implements Filter
      *
      * Example: If $value = ['status' => 'active'], $options = ['status', 'active'], returns true.
      *
-     * @param  mixed  $value  The input value (expected to be an array)
-     * @param  array<int, mixed>  $options  Array where $options[0] is the key and $options[1] is the expected value
+     * @param mixed             $value   The input value (expected to be an array)
+     * @param array<int, mixed> $options Array where $options[0] is the key and $options[1] is the expected value
+     *
      * @return mixed Returns bool (true if condition matches, false otherwise)
      */
     public function apply(mixed $value, array $options = []): mixed

src/Filters/FormatDate.php

@@ -19,16 +19,17 @@ class FormatDate implements Filter
      *
      * Example: $value = "2023-01-15", $options = ["Y-m-d", "d/m/Y"] => "15/01/2023"
      *
-     * @param  mixed  $value  The date string to reformat
-     * @param  array<int, string>  $options  Array with [0 => current format, 1 => target format]
-     * @return mixed The reformatted date string or original value if empty
+     * @param mixed              $value   The date string to reformat
+     * @param array<int, string> $options Array with [0 => current format, 1 => target format]
      *
      * @throws InvalidArgumentException If $options doesn’t contain exactly two formats
-     * @throws InvalidFormatException If the date cannot be parsed
+     * @throws InvalidFormatException   If the date cannot be parsed
+     *
+     * @return mixed The reformatted date string or original value if empty
      */
     public function apply(mixed $value, array $options = []): mixed
     {
-        if (! $value) {
+        if (!$value) {
             return $value;
         }
         if (count($options) != 2) {

src/Filters/Lowercase.php

@@ -13,8 +13,9 @@ class Lowercase implements Filter
      * mb_strtolower with UTF-8 encoding. If the input is not a string, it is returned
      * unchanged.
      *
-     * @param  mixed  $value  The value to convert (typically a string)
-     * @param  array<string, mixed>  $options  Optional filter options (currently unused)
+     * @param mixed                $value   The value to convert (typically a string)
+     * @param array<string, mixed> $options Optional filter options (currently unused)
+     *
      * @return mixed The lowercase string or original value if not a string
      */
     public function apply(mixed $value, array $options = []): mixed

src/Filters/StripTags.php

@@ -12,8 +12,9 @@ class StripTags implements Filter
      * This filter uses strip_tags to eliminate all HTML and PHP tags from the input string,
      * leaving only plain text. If the input is not a string, it is returned unchanged.
      *
-     * @param  mixed  $value  The value to process (typically a string)
-     * @param  array<string, mixed>  $options  Optional filter options (currently unused)
+     * @param mixed                $value   The value to process (typically a string)
+     * @param array<string, mixed> $options Optional filter options (currently unused)
+     *
      * @return mixed The tag-stripped string or original value if not a string
      */
     public function apply(mixed $value, array $options = []): mixed