Fix model column helper Psalm contract

Author: jturbide

CHANGELOG.md

@@ -136,6 +136,8 @@ release notes.
   send-time network behavior.
 - Replaced internal references to deprecated Phalcon events interfaces with
   their `Phalcon\Contracts\Events` equivalents.
+- Relaxed `modelHasColumn()` PHPDoc to match its nullable string contract so
+  Psalm accepts the controller trait implementation.
 
 ## 3.0.3 - 2026-06-10
 

src/Mvc/Controller/Traits/Interfaces/ModelInterface.php

@@ -79,8 +79,8 @@ public function loadModel(?string $modelName = null): \Phalcon\Mvc\ModelInterfac
      * strategy and cache.
      *
      * @param string $column Database column or mapped model attribute.
-     * @param class-string<\Phalcon\Mvc\ModelInterface>|null $modelName Optional
-     *     model override; defaults to the current controller model.
+     * @param string|null $modelName Optional model override; defaults to the
+     *     current controller model. Non-model strings should return false.
      */
     public function modelHasColumn(string $column, ?string $modelName = null): bool;
 }

src/Mvc/Controller/Traits/Model.php

@@ -188,8 +188,8 @@ public function loadModel(?string $modelName = null): ModelInterface
      * runtime failure.
      *
      * @param string $column Database column name or mapped model attribute name.
-     * @param class-string<ModelInterface>|null $modelName Optional model class;
-     *     defaults to the current controller model.
+     * @param string|null $modelName Optional model class; defaults to the
+     *     current controller model. Non-model strings return false.
      *
      * @return bool True when the model column map contains the raw column or
      *     mapped attribute name.