Merge pull request #4 from flavorly/feature-refactor-to-query-builder

Feature: Datatables refactor to query builder

Author: nikuscs

src/Commands/VanillaComponentsCommand.php

@@ -4,13 +4,30 @@
 
 use Closure;
 
-// From Filament
 trait EvaluatesClosures
 {
+    /**
+     * The identifier used to inject the component into the evaluation closure.
+     *
+     * @var string
+     */
     protected string $evaluationIdentifier;
 
+    /**
+     * The parameters that should be removed from the evaluation closure.
+     *
+     * @var array
+     */
     protected array $evaluationParametersToRemove = [];
 
+    /**
+     * Stolen from Filament, evaluate the closure with given params, and exclude some.
+     *
+     * @param $value
+     * @param  array  $parameters
+     * @param  array  $exceptParameters
+     * @return mixed
+     */
     protected function evaluate($value, array $parameters = [], array $exceptParameters = [])
     {
         $this->evaluationParametersToRemove = $exceptParameters;
@@ -29,11 +46,23 @@ protected function evaluate($value, array $parameters = [], array $exceptParamet
         return $value;
     }
 
+    /**
+     * Get the default params that should be always injected
+     *
+     * @return array
+     */
     protected function getDefaultEvaluationParameters(): array
     {
         return [];
     }
 
+    /**
+     * Resolve the given evaluation parameter.
+     *
+     * @param  string  $parameter
+     * @param  Closure  $value
+     * @return mixed|null
+     */
     protected function resolveEvaluationParameter(string $parameter, Closure $value)
     {
         if ($this->isEvaluationParameterRemoved($parameter)) {
@@ -43,6 +72,12 @@ protected function resolveEvaluationParameter(string $parameter, Closure $value)
         return $value();
     }
 
+    /**
+     * Determine if the given evaluation parameter should be removed.
+     *
+     * @param  string  $parameter
+     * @return bool
+     */
     protected function isEvaluationParameterRemoved(string $parameter): bool
     {
         return in_array($parameter, $this->evaluationParametersToRemove);

src/Core/Concerns/EvaluatesClosures.php

@@ -4,6 +4,12 @@
 
 trait Makable
 {
+    /**
+     * Quick static constructor.
+     *
+     * @param  array  $args
+     * @return static
+     */
     public static function make(array $args = []): static
     {
         return new static(...$args);