wip

src/Column.php

@@ -96,6 +96,9 @@ public function validate(): bool
 
     /**
      * Get if column is acceptable for filter.
+     * 
+     * @param  array<int, string>  $only
+     * @param  array<int, string>  $except
      */
     public function accepted(array $only = [], array $except = []): bool
     {

src/Concerns/ConditionallySearchingWildcard.php

@@ -21,7 +21,7 @@ trait ConditionallySearchingWildcard
     /**
      * Set wildcard search variants.
      *
-     * @param  array  $searchVariants
+     * @param  array<int, string>  $searchVariants
      *
      * @return $this
      */

src/Contracts/Filter/Filter.php

@@ -11,6 +11,7 @@ interface Filter
      * Apply search queries.
      *
      * @param  \Illuminate\Database\Eloquent\Builder|\Illuminate\Database\Query\Builder  $query
+     * @param  array<int, string>  $keywords
      *
      * @return \Illuminate\Database\Eloquent\Builder|\Illuminate\Database\Query\Builder
      */

src/Contracts/Keyword.php

@@ -18,11 +18,15 @@ public function getValue(): string;
 
     /**
      * Get searchable strings.
+     * 
+     * @return array<int, string>
      */
     public function all(): array;
 
     /**
      * Handle resolving keyword for filter.
+     * 
+     * @return array<int, string>
      */
     public function handle(Filter $filter): array;
 }

src/Filters/FieldSearch.php

@@ -28,6 +28,7 @@ public function __construct($column)
      * Apply generic field search queries.
      *
      * @param  \Illuminate\Database\Eloquent\Builder|\Illuminate\Database\Query\Builder  $query
+     * @param  array<int, string>  $keywords
      *
      * @return \Illuminate\Database\Eloquent\Builder|\Illuminate\Database\Query\Builder
      */

src/Filters/JsonFieldSearch.php

@@ -28,6 +28,7 @@ public function __construct($path)
      * Apply JSON field search queries.
      *
      * @param  \Illuminate\Database\Eloquent\Builder|\Illuminate\Database\Query\Builder  $query
+     * @param  array<int, string>  $keywords
      *
      * @return \Illuminate\Database\Eloquent\Builder|\Illuminate\Database\Query\Builder
      */

src/Filters/MorphRelationSearch.php

@@ -32,6 +32,7 @@ class MorphRelationSearch extends SearchFilter implements RequiresEloquent
      * Construct new Morph Related Search.
      *
      * @param  \Illuminate\Database\Query\Expression|string  $column
+     * @param  array<int, string>  $types
      */
     public function __construct(string $relation, $column, array $types = [])
     {
@@ -44,6 +45,7 @@ public function __construct(string $relation, $column, array $types = [])
      * Apply relation search queries.
      *
      * @param  \Illuminate\Database\Eloquent\Builder  $query
+     * @param  array<int, string>  $keywords
      *
      * @return \Illuminate\Database\Eloquent\Builder
      */

src/Filters/PrimaryKeySearch.php

@@ -28,6 +28,7 @@ public function __construct(?int $maxPrimaryKeySize = null)
      * Apply primary key field search queries.
      *
      * @param  \Illuminate\Database\Eloquent\Builder  $query
+     * @param  array<int, string>  $keywords
      *
      * @return \Illuminate\Database\Eloquent\Builder
      */

src/Filters/RelationSearch.php

@@ -36,6 +36,7 @@ public function __construct(string $relation, $column)
      * Apply relation search queries.
      *
      * @param  \Illuminate\Database\Eloquent\Builder  $query
+     * @param  array<int, string>  $keywords
      *
      * @return \Illuminate\Database\Eloquent\Builder
      */

src/Keyword.php

@@ -23,7 +23,7 @@ class Keyword implements KeywordContract
     /**
      * List default search variations.
      *
-     * @var string[]
+     * @var array<int, string>
      */
     public static $defaultSearchVariations = ['{keyword}', '{keyword}%', '%{keyword}', '%{keyword}%'];
 
@@ -53,6 +53,8 @@ public function validate(): bool
 
     /**
      * Get searchable strings.
+     * 
+     * @return array<int, string>
      */
     public function all(): array
     {
@@ -67,6 +69,8 @@ public function all(): array
 
     /**
      * Handle resolving keyword for filter.
+     * 
+     * @return array<int, string>
      */
     public function handle(Contracts\Filter\Filter $filter): array
     {
@@ -94,6 +98,8 @@ public function __toString()
 
     /**
      * Convert basic string to searchable result.
+     * 
+     * @return array<int, string>
      */
     public static function searchable(
         string $text,

src/Searchable.php

@@ -28,6 +28,8 @@ class Searchable
 
     /**
      * Construct a new Search Query.
+     * 
+     * @param  array<int, string|\Laravie\QueryFilter\Contracts\Filter>  $fields
      */
     public function __construct(?string $keyword, array $fields = [])
     {
@@ -66,8 +68,8 @@ public function apply($query)
         $likeOperator = like_operator(connection_type($query));
 
         /**
-         * @var \Illuminate\Support\Collection $filters
-         * @var \Illuminate\Support\Collection $fields
+         * @var \Illuminate\Support\Collection<int, \Laravie\QueryFilter\Contracts\Filter> $filters
+         * @var \Illuminate\Support\Collection<int, string> $fields
          */
         [$filters, $fields] = Collection::make($this->fields)->partition(static function ($field) {
             return $field instanceof Contracts\Filter\Filter;

src/Taxonomy.php

@@ -13,14 +13,14 @@ class Taxonomy
     /**
      * Taxonomy columns.
      *
-     * @var array
+     * @var array<int, string|\Laravie\QueryFilter\Contracts\Filter>
      */
     protected $fields = [];
 
     /**
      * Taxonomy rules.
      *
-     * @var array<string,callable>
+     * @var array<string, \Closure|callable>
      */
     protected $rules = [];
 
@@ -33,6 +33,9 @@ class Taxonomy
 
     /**
      * Construct a new Matches Query.
+     * 
+     * @param  array<string, \Closure|callable>  $rules
+     * @param  array<int, string|\Laravie\QueryFilter\Contracts\Filter>  $fields
      */
     public function __construct(?string $terms, array $rules = [], array $fields = [])
     {

src/Terms.php

@@ -18,12 +18,14 @@ class Terms implements Countable
     /**
      * Tagged conditions.
      *
-     * @var array
+     * @var array<int, string>
      */
     protected $tagged = [];
 
     /**
      * Construct a new Condition value object.
+     * 
+     * @param  array<int, string>  $tagged
      */
     public function __construct(string $basic, array $tagged)
     {
@@ -34,6 +36,8 @@ public function __construct(string $basic, array $tagged)
     /**
      * Parse rules from keyword.
      *
+     * @param  array<int, string>  $rules
+     * 
      * @return static
      */
     public static function parse(string $term, array $rules)
@@ -74,6 +78,8 @@ public function basic(): string
 
     /**
      * Get tagged conditions.
+     * 
+     * @return array<int, string> 
      */
     public function tagged(): array
     {