Prepare PHPStan

.gitattributes

@@ -12,7 +12,7 @@
 /js-tests export-ignore
 /phpstan.neon.dist export-ignore
 /phpunit.xml.dist export-ignore
-/public/build/assets/ linguist-generated
+/public/build/assets/** linguist-generated
 /tests export-ignore
 /yarn.lock export-ignore linguist-generated
 /vite.config.js export-ignore

.github/workflows/back-end.yml

@@ -135,9 +135,12 @@ jobs:
             name: "Search for $this->$this typo 🐌"
             run: |
                 ! git grep --line-number -e '\$this\s*->\s*\$this' -- ':!:*/back-end\.yml'
+        -
+            name: "Install orchestra/testbench"
+            run: "composer require --dev orchestra/testbench"
         -
             name: "Perform static analysis"
-            run: "true TODO || composer exec -- phpstan analyze --level=5 src/"
+            run: "composer exec -- phpstan || true 'Annotate only'"
 
     coding_standards:
         name: "4️⃣ Coding Standards"

.github/workflows/reusable-integrity.yml

@@ -119,7 +119,7 @@ jobs:
                 wget --secure-protocol=TLSv1_3 --max-redirect=1 --retry-on-host-error --retry-connrefused --tries=3 \
                     --no-verbose --output-document="${{ runner.temp }}/cloc/cloc" "${RELEASE_ASSET_URL}"
                 {
-                    git ls-files -- ':!:LICENSE' ':!:package-lock.json' >"${{ runner.temp }}/cloc/include-list"
+                    git ls-files -- ':!:LICENSE' ':!:yarn.lock' >"${{ runner.temp }}/cloc/include-list"
                     echo '```'
                     perl "${{ runner.temp }}/cloc/cloc" --hide-rate \
                         --list-file="${{ runner.temp }}/cloc/include-list" \

phpstan.neon.dist

@@ -1,14 +1,35 @@
 includes:
     - vendor/nunomaduro/larastan/extension.neon
+#    - phpstan-baseline.neon
 parameters:
     databaseMigrationsPath:
         - database/migrations/
         - vendor/orchestra/testbench-core/laravel/migrations/
+    scanFiles:
+        - tests/phpstan/FieldWithRoute.php
+        - tests/phpstan/MetaDataModel.php
     paths:
         - src/
         - config/
-        - database/
+# TODO
+#        - database/
         - routes/
     level: 5
+    checkAlwaysTrueCheckTypeFunctionCall: true
+    checkAlwaysTrueInstanceof: true
+    checkAlwaysTrueStrictComparison: true
+    checkAlwaysTrueLooseComparison: true
+    checkClassCaseSensitivity: false
+    checkDynamicProperties: true
+    checkExplicitMixed: false
+    checkImplicitMixed: false
+    checkExplicitMixedMissingReturn: true
+    checkFunctionNameCase: true
+    checkInternalClassCaseSensitivity: true
     ignoreErrors:
         - '#^Unsafe usage of new static#'
+        # --- TODO-s ---
+        # X vs. X contract
+        - '#but returns Illuminate\\Contracts\\#'
+        # SoftDeletes
+        - '#(\$forceDeleting|::withTrashed|::onlyTrashed|::trashed|::restore)#'

src/Fields/BelongsTo.php

@@ -6,6 +6,11 @@
 use Illuminate\Database\Eloquent\Relations\BelongsTo as EloquentRelation;
 use Illuminate\Http\Request;
 
+/**
+ * @template TRelation of \Illuminate\Database\Eloquent\Relations\BelongsTo
+ *
+ * @extends \Cone\Root\Fields\Relation<TRelation>
+ */
 class BelongsTo extends Relation
 {
     /**

src/Fields/BelongsToMany.php

@@ -9,6 +9,11 @@
 use Illuminate\Http\Request;
 use Illuminate\Support\Arr;
 
+/**
+ * @template TRelation of \Illuminate\Database\Eloquent\Relations\BelongsToMany
+ *
+ * @extends \Cone\Root\Fields\Relation<TRelation>
+ */
 class BelongsToMany extends Relation
 {
     use ResolvesFields;

src/Fields/Fields.php

@@ -61,6 +61,7 @@ public function registerRoutes(Request $request, Router $router): void
         $router->prefix('fields')->group(function (Router $router) use ($request): void {
             $this->each(static function (Field $field) use ($request, $router): void {
                 if (in_array(RegistersRoutes::class, class_uses_recursive($field))) {
+                    /** @var \Tests\FieldWithRoute $field */
                     $field->registerRoutes($request, $router);
                 }
             });

src/Fields/File.php

@@ -1,4 +1,4 @@
 <?php
 
 namespace Cone\Root\Fields;
 
@@ -158,7 +158,9 @@
             call_user_func_array($this->storageResolver, [$request, $medium, $path]);
         }
 
-        $request->user()->uploads()->save($medium);
+        /** @var \Illuminate\Foundation\Auth\User&\Cone\Root\Interfaces\Models\User $user */
+        $user = $request->user();
+        $user->uploads()->save($medium);
 
         MoveFile::withChain($medium->convertible() ? [new PerformConversions($medium)] : [])
             ->dispatch($medium, $path, false);
@@ -224,6 +226,8 @@
      */
     public function toOption(Request $request, Model $model, Model $related): array
     {
+        /** @var \Cone\Root\Models\Medium $related */
+
         $option = parent::toOption($request, $model, $related);
 
         $name = sprintf(
@@ -235,6 +239,8 @@
 
         $option['attrs']->merge(['name' => $name]);
 
+        /** @var \Cone\Root\Models\Medium $related */
+
         return array_merge($option, [
             'fileName' => $related->file_name,
             'isImage' => $related->isImage,

src/Fields/HasMany.php

@@ -6,6 +6,9 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany as EloquentRelation;
 
+/**
+ * @extends \Cone\Root\Fields\HasOneOrMany<\Illuminate\Database\Eloquent\Relations\HasMany>
+ */
 class HasMany extends HasOneOrMany
 {
     /**

src/Fields/HasOne.php

@@ -5,6 +5,9 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasOne as EloquentRelation;
 
+/**
+ * @extends \Cone\Root\Fields\HasOneOrMany<\Illuminate\Database\Eloquent\Relations\HasOne>
+ */
 class HasOne extends HasOneOrMany
 {
     /**

src/Fields/HasOneOrMany.php

@@ -7,6 +7,11 @@
 use Illuminate\Http\Request;
 use Illuminate\Support\Arr;
 
+/**
+ * @template TRelation of \Illuminate\Database\Eloquent\Relations\HasOneOrMany
+ *
+ * @extends \Cone\Root\Fields\Relation<TRelation>
+ */
 abstract class HasOneOrMany extends Relation
 {
     /**

src/Fields/Meta.php

@@ -1,4 +1,4 @@
 <?php
 
 namespace Cone\Root\Fields;
 
@@ -8,6 +8,9 @@
 use Illuminate\Database\Eloquent\Relations\MorphOne as EloquentRelation;
 use Illuminate\Http\Request;
 
+/**
+ * @extends \Cone\Root\Fields\MorphOne<\Illuminate\Database\Eloquent\Relations\MorphOne>
+ */
 class Meta extends MorphOne
 {
     /**
@@ -21,6 +24,8 @@
     public function __construct(string $label, string $modelAttribute = null, Closure|string $relation = null)
     {
         $relation ??= function (Model $model): EloquentRelation {
+            /** @phpstan-var \Tests\MetaDataModel $model */
+
             $related = $model->metaData()->getRelated();
 
             return $model->metaData()

src/Fields/MorphMany.php

@@ -5,6 +5,9 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\MorphMany as EloquentRelation;
 
+/**
+ * @extends \Cone\Root\Fields\MorphOneOrMany<\Illuminate\Database\Eloquent\Relations\MorphMany>
+ */
 class MorphMany extends MorphOneOrMany
 {
     /**

src/Fields/MorphOne.php

@@ -5,6 +5,11 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\MorphOne as EloquentRelation;
 
+/**
+ * @template TRelation of \Illuminate\Database\Eloquent\Relations\MorphOne
+ *
+ * @extends \Cone\Root\Fields\MorphOneOrMany<TRelation>
+ */
 class MorphOne extends MorphOneOrMany
 {
     /**

src/Fields/MorphOneOrMany.php

@@ -5,6 +5,11 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\MorphOneOrMany as EloquentRelation;
 
+/**
+ * @template TRelation of \Illuminate\Database\Eloquent\Relations\MorphOneOrMany
+ *
+ * @extends \Cone\Root\Fields\HasOneOrMany<TRelation>
+ */
 abstract class MorphOneOrMany extends HasOneOrMany
 {
     /**

src/Fields/MorphTo.php

@@ -5,6 +5,9 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\MorphTo as EloquentRelation;
 
+/**
+ * @extends \Cone\Root\Fields\BelongsTo<\Illuminate\Database\Eloquent\Relations\MorphTo>
+ */
 class MorphTo extends BelongsTo
 {
     /**

src/Fields/MorphToMany.php

@@ -5,6 +5,9 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\MorphToMany as EloquentRelation;
 
+/**
+ * @extends \Cone\Root\Fields\BelongsToMany<\Illuminate\Database\Eloquent\Relations\MorphToMany>
+ */
 class MorphToMany extends BelongsToMany
 {
     /**

src/Fields/Relation.php

@@ -10,6 +10,9 @@
 use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 
+/**
+ * @template TRelation of \Illuminate\Database\Eloquent\Relations\Relation
+ */
 abstract class Relation extends Field
 {
     /**
@@ -67,6 +70,8 @@ public static function scopeQuery(Closure $callback): void
 
     /**
      * Get the relation instance.
+     *
+     * @phpstan-return TRelation
      */
     public function getRelation(Model $model): EloquentRelation
     {

src/Fields/Slug.php

@@ -5,6 +5,7 @@
 use Closure;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Http\Request;
 use Illuminate\Support\Str;
 use Illuminate\Validation\Rule;

src/Http/Controllers/ActionController.php

@@ -13,6 +13,7 @@ class ActionController extends Controller
      */
     public function __invoke(Request $request): Response
     {
+        /** @var \Cone\Root\Actions\Action $action */
         $action = $request->route('action');
 
         Gate::allowIf($action->authorized($request));

src/Http/Controllers/MediaController.php

@@ -13,8 +13,10 @@
      */
     public function __invoke(Request $request): JsonResponse
     {
+        /** @var \Cone\Root\Resources\Resource $resource */
         $resource = $request->route('_resource');
 
+        /** @var \Cone\Root\Fields\Media $field */
         $field = $request->route('field');
 
         // Gate::allowIf($field->authorized($request, $model));
@@ -23,10 +25,10 @@
             ? $resource->resolveRouteBinding($request, $request->input('model'))
             : $resource->getModelInstance();
 
         return match ($request->method()) {
             'GET' => new JsonResponse($field->paginate($request, $model)),
             'POST' => new JsonResponse($field->upload($request, $model), JsonResponse::HTTP_CREATED),
             'DELETE' => new JsonResponse(['deleted' => $field->prune($request, $model, $request->input('ids', []))]),
         };
     }
 }

src/Http/Controllers/RepeaterController.php

@@ -12,8 +12,10 @@ class RepeaterController extends Controller
      */
     public function __invoke(Request $request): JsonResponse
     {
+        /** @var \Cone\Root\Resources\Resource $resource */
         $resource = $request->route('_resource');
 
+        /** @var \Cone\Root\Fields\Repeater $field */
         $field = $request->route('field');
 
         // Gate::allowIf($field->authorized($request, $model));

src/Http/Controllers/WidgetController.php

@@ -13,6 +13,7 @@ class WidgetController extends Controller
      */
     public function __invoke(Request $request): Response
     {
+        /** @var \Cone\Root\Widgets\Widget $widget */
         $widget = $request->route('rootWidget');
 
         Gate::allowIf($widget->authorized($request));

src/Models/Medium.php

@@ -152,6 +152,8 @@ public function user(): BelongsTo
 
     /**
      * Determine if the file is image.
+     *
+     * @return \Illuminate\Database\Eloquent\Casts\Attribute<bool, never>
      */
     protected function isImage(): Attribute
     {
@@ -164,6 +166,8 @@ protected function isImage(): Attribute
 
     /**
      * Get the conversion URLs.
+     *
+     * @return \Illuminate\Database\Eloquent\Casts\Attribute<array<string, string>, never>
      */
     protected function urls(): Attribute
     {
@@ -182,6 +186,8 @@ function (array $urls, string $conversion): array {
 
     /**
      * Get the formatted size attribute.
+     *
+     * @return \Illuminate\Database\Eloquent\Casts\Attribute<string, never>
      */
     protected function formattedSize(): Attribute
     {
@@ -202,6 +208,8 @@ protected function formattedSize(): Attribute
 
     /**
      * Get the dimensions attribute.
+     *
+     * @return \Illuminate\Database\Eloquent\Casts\Attribute<string|null, never>
      */
     protected function dimensions(): Attribute
     {

src/Models/Notification.php

@@ -54,6 +54,8 @@ public static function getProxiedInterface(): string
 
     /**
      * Get the subject attribute.
+     *
+     * @return \Illuminate\Database\Eloquent\Casts\Attribute<string|null, never>
      */
     protected function subject(): Attribute
     {
@@ -64,6 +66,8 @@ protected function subject(): Attribute
 
     /**
      * Get the formatted created at attribute.
+     *
+     * @return \Illuminate\Database\Eloquent\Casts\Attribute<string|null, never>
      */
     protected function formattedCreatedAt(): Attribute
     {
@@ -74,6 +78,8 @@ protected function formattedCreatedAt(): Attribute
 
     /**
      * Get the formatted created at attribute.
+     *
+     * @return \Illuminate\Database\Eloquent\Casts\Attribute<bool, never>
      */
     protected function isRead(): Attribute
     {
@@ -84,6 +90,8 @@ protected function isRead(): Attribute
 
     /**
      * Get the URL attribute.
+     *
+     * @return \Illuminate\Database\Eloquent\Casts\Attribute<string|null, never>
      */
     protected function url(): Attribute
     {

src/Navigation/Item.php

@@ -6,6 +6,12 @@
 use Cone\Root\Traits\Makeable;
 use Illuminate\Support\Facades\URL;
 
+/**
+ * @property string $url
+ * @property string $label
+ * @property string $icon
+ * @property string $group
+ */
 class Item
 {
     use HasAttributes;

src/RootServiceProvider.php

@@ -122,7 +122,10 @@ protected function registerRoutes(): void
         });
 
         $this->app['router']->bind('resourceModel', function (string $id, Route $route): Model {
-            return $route->parameter('resource')->resolveRouteBinding($this->app['request'], $id);
+            /** @var \Cone\Root\Resources\Resource $resource */
+            $resource = $route->parameter('resource');
+
+            return $resource->resolveRouteBinding($this->app['request'], $id);
         });
 
         $this->app['router']