Update the comments of the method createQueryTo in ActiveRecordFactory so that the IDE can automatically identify the specific class of ActiveRecord

src/ActiveQuery.php

@@ -107,6 +107,15 @@ class ActiveQuery extends Query implements ActiveQueryInterface
     private array $joinWith = [];
     private ActiveRecordInterface|null $arInstance = null;
 
+    /**
+     * @param class-string $arClass
+     * @param ConnectionInterface $db
+     * @param ActiveRecordFactory|null $arFactory
+     * @param string $tableName
+     *
+     * @psalm-template T of ActiveRecordInterface
+     * @psalm-param class-string<T> $arClass
+     */
     final public function __construct(
         protected string $arClass,
         protected ConnectionInterface $db,

src/ActiveRecordFactory.php

@@ -20,7 +20,7 @@ public function __construct(private Factory $factory)
     /**
      * Allows you to create an active record instance through the factory.
      *
-     * @param string $arClass active record class.
+     * @param class-string<T> $arClass active record class.
      * @param string $tableName The name of the table associated with this ActiveRecord class, if its empty string the
      * name will be generated automatically by calling {@see getTableName()} in the active record class.
      * @param ConnectionInterface|null $db the database connection used for creating active record instances.
@@ -29,6 +29,11 @@ public function __construct(private Factory $factory)
      * @throws InvalidConfigException
      * @throws NotFoundException
      * @throws NotInstantiableException
+     * @return ActiveRecordInterface
+     *
+     * @psalm-template T of ActiveRecordInterface
+     * @psalm-param class-string<T> $arClass
+     * @psalm-return T
      */
     public function createAR(
         string $arClass,

src/BaseActiveRecord.php

@@ -320,12 +320,15 @@ public function hasAttribute($name): bool
      *
      * Call methods declared in {@see ActiveQuery} to further customize the relation.
      *
-     * @param string $class The class name of the related record
+     * @param class-string<T> $class The class name of the related record
      * @param array $link The primary-foreign key constraint. The keys of the array refer to the attributes of the
      * record associated with the `$class` model, while the values of the array refer to the corresponding attributes in
      * **this** AR class.
      *
      * @return ActiveQueryInterface The relational query object.
+     *
+     * @psalm-template T of ActiveRecordInterface
+     * @psalm-param class-string<T> $arClass
      */
     public function hasMany(string $class, array $link): ActiveQueryInterface
     {
@@ -356,18 +359,28 @@ public function hasMany(string $class, array $link): ActiveQueryInterface
      *
      * Call methods declared in {@see ActiveQuery} to further customize the relation.
      *
-     * @param string $class The class name of the related record.
+     * @param class-string<T> $class The class name of the related record.
      * @param array $link The primary-foreign key constraint. The keys of the array refer to the attributes of the
      * record associated with the `$class` model, while the values of the array refer to the corresponding attributes in
      * **this** AR class.
      *
      * @return ActiveQueryInterface The relational query object.
+     *
+     * @psalm-template T of ActiveRecordInterface
+     * @psalm-param class-string<T> $arClass
      */
     public function hasOne(string $class, array $link): ActiveQueryInterface
     {
         return $this->createRelationQuery($class, $link, false);
     }
 
+    /**
+     * @param class-string<T> $arClass
+     * @return ActiveQueryInterface
+     *
+     * @psalm-template T of ActiveRecordInterface
+     * @psalm-param class-string<T> $arClass
+     */
     public function instantiateQuery(string $arClass): ActiveQueryInterface
     {
         return new ActiveQuery($arClass, $this->db, $this->arFactory);
@@ -1114,11 +1127,14 @@ private function setRelationDependencies(
     /**
      * Creates a query instance for `has-one` or `has-many` relation.
      *
-     * @param string $arClass The class name of the related record.
+     * @param class-string<T> $arClass The class name of the related record.
      * @param array $link The primary-foreign key constraint.
      * @param bool $multiple Whether this query represents a relation to more than one record.
      *
      * @return ActiveQueryInterface The relational query object.
+     *
+     * @psalm-template T of ActiveRecordInterface
+     * @psalm-param class-string<T> $arClass
 
      * {@see hasOne()}
      * {@see hasMany()}