refactor: Update documentation for ServiceMap and related classes to enhance clarity for Yii Application static analysis. (#49)

terabytesoftw · web-flow · commit fea324ebebb1 · 2025-06-18T07:09:09.000-04:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -16,6 +16,7 @@
 - Bug #46: Update `README.md` to enhance clarity and structure of `docs/installation.md`, `docs/configuration.md` and `docs/examples.md` (@terabytesoftw)
 - Enh #47: Add `ActiveRecordGetAttributeDynamicMethodReturnTypeExtension` to provide precise type inference for `getAttribute()` method calls based on PHPDoc annotations (@terabytesoftw)
 - Bug #48: Update `PHPStan` configuration paths and create new config files for improved structure and clarity (@terabytesoftw)
+- Bug #49: Update documentation for `ServiceMap` and related classes to enhance clarity for Yii Application static analysis (@terabytesoftw)
 
 ## 0.2.3 June 09, 2025
 
diff --git a/src/StubFilesExtension.php b/src/StubFilesExtension.php
@@ -26,7 +26,7 @@
  * - Resolves stub file paths relative to the extension directory.
  * - Supports web, console, and base application contexts.
  *
- * @see ServiceMap for component/service class resolution.
+ * @see ServiceMap for service and component map for Yii Application static analysis.
  *
  * @copyright Copyright (C) 2023 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
@@ -42,7 +42,7 @@ final class StubFilesExtension implements \PHPStan\PhpDoc\StubFilesExtension
     private const DEFAULT_STUB = 'ApplicationWeb.stub';
 
     /**
-     * @param ServiceMap $serviceMap Service map for determining an application type
+     * @param ServiceMap $serviceMap Service and component map for Yii Application static analysis.
      */
     public function __construct(private readonly ServiceMap $serviceMap) {}
 
diff --git a/src/method/BehaviorMethodsClassReflectionExtension.php b/src/method/BehaviorMethodsClassReflectionExtension.php
@@ -41,7 +41,7 @@ final class BehaviorMethodsClassReflectionExtension implements MethodsClassRefle
      * Creates a new instance of the {@see BehaviorMethodsClassReflectionExtension} class.
      *
      * @param ReflectionProvider $reflectionProvider Reflection provider for class and property lookups.
-     * @param ServiceMap $serviceMap Service map for resolving component classes by ID.
+     * @param ServiceMap $serviceMap Service and component map for Yii Application static analysis.
      */
     public function __construct(
         private readonly ReflectionProvider $reflectionProvider,
diff --git a/src/property/ApplicationPropertiesClassReflectionExtension.php b/src/property/ApplicationPropertiesClassReflectionExtension.php
@@ -75,7 +75,7 @@ final class ApplicationPropertiesClassReflectionExtension implements PropertiesC
      * @param AnnotationsPropertiesClassReflectionExtension $annotationsProperties Extension for handling
      * annotation-based properties.
      * @param ReflectionProvider $reflectionProvider Reflection provider for class and property lookups.
-     * @param ServiceMap $serviceMap Service map for resolving component classes by ID.
+     * @param ServiceMap $serviceMap Service and component map for Yii Application static analysis.
      */
     public function __construct(
         private readonly AnnotationsPropertiesClassReflectionExtension $annotationsProperties,
diff --git a/src/property/BehaviorPropertiesClassReflectionExtension.php b/src/property/BehaviorPropertiesClassReflectionExtension.php
@@ -45,7 +45,7 @@ final class BehaviorPropertiesClassReflectionExtension implements PropertiesClas
      * @param AnnotationsPropertiesClassReflectionExtension $annotationsProperties Extension for handling
      * annotation-based properties.
      * @param ReflectionProvider $reflectionProvider Reflection provider for class and property lookups.
-     * @param ServiceMap $serviceMap Service map for resolving component classes by ID.
+     * @param ServiceMap $serviceMap Service and component map for Yii Application static analysis.
      */
     public function __construct(
         private readonly AnnotationsPropertiesClassReflectionExtension $annotationsProperties,
diff --git a/src/property/UserPropertiesClassReflectionExtension.php b/src/property/UserPropertiesClassReflectionExtension.php
@@ -55,7 +55,7 @@ final class UserPropertiesClassReflectionExtension implements PropertiesClassRef
      * @param AnnotationsPropertiesClassReflectionExtension $annotationsProperties Extension for handling
      * annotation-based properties.
      * @param ReflectionProvider $reflectionProvider Reflection provider for class and property lookups.
-     * @param ServiceMap $serviceMap Service map for resolving component classes by ID.
+     * @param ServiceMap $serviceMap Service and component map for Yii Application static analysis.
      */
     public function __construct(
         private readonly AnnotationsPropertiesClassReflectionExtension $annotationsProperties,
diff --git a/src/type/ActiveQueryDynamicMethodReturnTypeExtension.php b/src/type/ActiveQueryDynamicMethodReturnTypeExtension.php
@@ -48,7 +48,7 @@
  * - Integration with PHPStan type combinators and file type mapper for accurate analysis.
  * - Support for union, array, and generic object types in method return values.
  *
- * @see ActiveQuery for query API details.
+ * @see ActiveQuery for Active Query API details.
  * @see DynamicMethodReturnTypeExtension for PHPStan dynamic return type extension contract.
  *
  * @copyright Copyright (C) 2023 Terabytesoftw.
@@ -107,7 +107,7 @@ public function getClass(): string
      * - For {@see ActiveQuery::one()}: a union of the model type and null.
      * - For other methods: the result of {@see handleDefaultCase()}.
      *
-     * @param MethodReflection $methodReflection Reflection for the called method.
+     * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.
      * @param MethodCall $methodCall AST node for the method call expression.
      * @param Scope $scope PHPStan analysis scope for type resolution.
      *
@@ -383,7 +383,7 @@ private function getArrayTypeFromModelProperties(Type $modelType): Type
      * This method is used internally by the dynamic return type extension to support accurate type inference for
      * {@see ActiveQuery::asArray()} calls during static analysis.
      *
-     * @param MethodCall $methodCall AST node for the {@see asArray()} method call.
+     * @param MethodCall $methodCall AST node for the method call expression.
      * @param Scope $scope PHPStan analysis scope for type resolution.
      *
      * @return Type Type of the first argument if present, or {@see ConstantBooleanType} `true` if not provided.
@@ -413,7 +413,7 @@ private function getAsArrayArgument(MethodCall $methodCall, Scope $scope): Type
      * This method enables precise type inference for chained {@see asArray()} calls, ensuring that the correct type is
      * propagated for subsequent method calls on the {@see ActiveQuery} instance during static analysis.
      *
-     * @param MethodCall $methodCall AST node for the {@see asArray()} method call.
+     * @param MethodCall $methodCall AST node for the method call expression.
      * @param Scope $scope PHPStan analysis scope for type resolution.
      * @param Type $modelType Model type extracted from the generic {@see ActiveQuery} instance.
      *
@@ -450,7 +450,7 @@ private function handleAsArray(MethodCall $methodCall, Scope $scope, Type $model
      * This ensures that fluent interface methods maintain correct generic type propagation for static analysis and IDE
      * support.
      *
-     * @param MethodReflection $methodReflection Reflection for the called method.
+     * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.
      * @param Type $calledOnType Type on which the method is called.
      * @param Type $modelType Model type extracted from the generic {@see ActiveQuery} instance.
      *
diff --git a/src/type/ActiveRecordDynamicMethodReturnTypeExtension.php b/src/type/ActiveRecordDynamicMethodReturnTypeExtension.php
@@ -36,8 +36,8 @@
  * - Exception handling for invalid or missing arguments in relation method calls.
  * - Returns a generic {@see ActiveQuery} type with the related model class as type parameter.
  *
- * @see ActiveQuery for query API details.
- * @see ActiveRecord for relation method definitions.
+ * @see ActiveQuery for Active Query API details.
+ * @see ActiveRecord for Active Record API details.
  * @see DynamicMethodReturnTypeExtension for PHPStan dynamic return type extension contract.
  *
  * @copyright Copyright (C) 2023 Terabytesoftw.
@@ -71,7 +71,7 @@ public function getClass(): string
      * Determines the correct return type for {@see ActiveRecord::hasOne()} and {@see ActiveRecord::hasMany()} relation
      * methods by inspecting the first argument which should be a constant string representing the related model class.
      *
-     * @param MethodReflection $methodReflection Reflection instance for the called relation method.
+     * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.
      * @param MethodCall $methodCall AST node for the method call expression.
      * @param Scope $scope PHPStan analysis scope for type resolution.
      *
diff --git a/src/type/ActiveRecordDynamicStaticMethodReturnTypeExtension.php b/src/type/ActiveRecordDynamicStaticMethodReturnTypeExtension.php
@@ -41,8 +41,8 @@
  * - Nullability handling for methods like {@see ActiveRecord::findOne()}.
  * - Support for custom {@see ActiveQuery} subclasses and generic parameter propagation.
  *
- * @see ActiveQuery for query API details.
- * @see ActiveRecord for ActiveRecord API details.
+ * @see ActiveQuery for Active Query API details.
+ * @see ActiveRecord for Active Record API details.
  * @see DynamicStaticMethodReturnTypeExtension for PHPStan dynamic static method return type extension contract.
  *
  * @copyright Copyright (C) 2023 Terabytesoftw.
@@ -88,7 +88,7 @@ public function getClass(): string
      * accurate autocompletion and static analysis for methods such as {@see ActiveRecord::findOne()},
      * {@see ActiveRecord::findAll()}, and custom query builders.
      *
-     * @param MethodReflection $methodReflection Reflection instance for the static method.
+     * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.
      *
      * @return bool `true` if the static method is supported for dynamic return type inference; `false` otherwise.
      */
@@ -156,7 +156,7 @@ public function isStaticMethodSupported(MethodReflection $methodReflection): boo
      * This method ensures that static analysis and IDEs reflect the actual runtime behavior of static
      * {@see ActiveRecord} methods, supporting precise type checks and developer productivity.
      *
-     * @param MethodReflection $methodReflection Reflection instance for the static method.
+     * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.
      * @param StaticCall $methodCall AST node for the static method call expression.
      * @param Scope $scope PHPStan analysis scope for type resolution.
      *
diff --git a/src/type/ActiveRecordGetAttributeDynamicMethodReturnTypeExtension.php b/src/type/ActiveRecordGetAttributeDynamicMethodReturnTypeExtension.php
@@ -39,7 +39,7 @@
  * - Integration with PHPStan file type mapper for accurate PHPDoc parsing.
  * - PHPDoc property tag extraction from model classes and behaviors.
  *
- * @see ActiveRecord for ActiveRecord API details.
+ * @see ActiveRecord for Active Record API details.
  * @see DynamicMethodReturnTypeExtension for PHPStan dynamic return type extension contract.
  * @see ServiceMap for service and component map for Yii Application static analysis.
  *
diff --git a/src/type/ContainerDynamicMethodReturnTypeExtension.php b/src/type/ContainerDynamicMethodReturnTypeExtension.php
@@ -29,7 +29,7 @@
  * - Uses {@see ServiceMap} to resolve component class names.
  *
  * @see DynamicMethodReturnTypeExtension for PHPStan dynamic return type extension contract.
- * @see ServiceMap for component/service class resolution.
+ * @see ServiceMap for service and component map for Yii Application static analysis.
  *
  * @copyright Copyright (C) 2023 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
@@ -40,7 +40,7 @@ final class ContainerDynamicMethodReturnTypeExtension implements DynamicMethodRe
      * Creates a new instance of the {@see ContainerDynamicMethodReturnTypeExtension} class.
      *
      * @param ReflectionProvider $reflectionProvider Reflection provider for class and property lookups.
-     * @param ServiceMap $serviceMap Service map for resolving component classes by ID.
+     * @param ServiceMap $serviceMap Service and component map for Yii Application static analysis.
      */
     public function __construct(
         private readonly ReflectionProvider $reflectionProvider,
@@ -80,7 +80,7 @@ public function getClass(): string
      * Falls back to the default method signature return type for unsupported or invalid calls, ensuring compatibility
      * with PHPStan static analysis and IDE autocompletion.
      *
-     * @param MethodReflection $methodReflection Reflection for the called method.
+     * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.
      * @param MethodCall $methodCall AST node for the method call expression.
      * @param Scope $scope PHPStan analysis scope for type resolution.
      *
diff --git a/src/type/HeaderCollectionDynamicMethodReturnTypeExtension.php b/src/type/HeaderCollectionDynamicMethodReturnTypeExtension.php
@@ -107,7 +107,7 @@ public function getTypeFromMethodCall(
      * method, maintaining strict compatibility and accurate type inference for header value retrieval in Yii HTTP
      * handling.
      *
-     * @param MethodReflection $methodReflection Reflection instance for the method.
+     * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.
      *
      * @return bool `true` if the method is {@see HeaderCollection::get()}; `false` otherwise.
      */
diff --git a/tests/stub/Category.php b/tests/stub/Category.php
@@ -13,7 +13,7 @@
  * relationships for hierarchical data structures.
  *
  * This class is used in type inference and static analysis tests to validate property access, rule definitions, and
- * table mapping in Yii2 Active Record extensions.
+ * table mapping in Yii Active Record extensions.
  *
  * Key features.
  * - Explicit table name mapping for database operations.
diff --git a/tests/stub/MyActiveRecord.php b/tests/stub/MyActiveRecord.php
@@ -15,7 +15,7 @@
  * This class is used in type inference and static analysis tests to validate PHPStan's ability to correctly infer
  * return types for ActiveRecord queries, relations, and chained method calls.
  *
- * @property bool $flag Boolean property for test assertions.
+ * @property bool $flag
  *
  * @copyright Copyright (C) 2023 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
diff --git a/tests/stub/Post.php b/tests/stub/Post.php
@@ -7,8 +7,30 @@
 use yii\db\ActiveRecord;
 
 /**
+ * Active Record model for testing post-data and dynamic query return types.
+ *
+ * Provides a simple Active Record implementation with string properties for post-content management, demonstrating
+ * custom query class integration and type-safe database operations for blog-like content scenarios.
+ *
+ * This class is used in type inference and static analysis tests to validate PHPStan's ability to correctly infer
+ * return types for custom ActiveQuery implementations and chained method calls on post-related queries.
+ *
+ * The model demonstrates the use of custom query classes through the {@see PostQuery} implementation, enabling
+ * specialized query methods and maintaining type safety across database operations.
+ *
+ * Key features:
+ * - Custom query class integration with {@see PostQuery}.
+ * - Property validation for post-content (title and content).
+ * - Static analysis validation for custom query return types.
+ * - String property definitions for post-data.
+ * - Table mapping with post table.
+ * - Type-safe query method implementation.
+ *
  * @property string $title
  * @property string $content
+ *
+ * @copyright Copyright (C) 2023 Terabytesoftw.
+ * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
 final class Post extends ActiveRecord
 {
diff --git a/tests/stub/PostQuery.php b/tests/stub/PostQuery.php
@@ -7,13 +7,35 @@
 use yii\db\ActiveQuery;
 
 /**
+ * Active Query class for performing database queries on {@see Post} models.
+ *
+ * Provides specialized query methods for {@see Post} entities, enabling type-safe database operations and query
+ * building with method chaining.
+ *
+ * This class extends the base ActiveQuery functionality with Post-specific filtering and search capabilities.
+ *
+ * The query class maintains type safety through generic templates, ensuring that query results are typed as {@see Post}
+ * objects and that chained method calls preserve the correct return types for static analysis tools.
+ *
+ * This implementation demonstrates custom ActiveQuery extension patterns in Yii2, providing domain-specific query
+ * methods while maintaining compatibility with the base ActiveQuery interface and fluent query building.
+ *
+ * Key features:
+ * - Generic type safety with template parameters for {@see Post} models.
+ * - Method chaining with preserved return types for fluent interface.
+ * - Post-specific query filtering methods.
+ * - Type-safe query result handling.
+ *
  * @template T of Post
  * @extends ActiveQuery<T>
+ *
+ * @copyright Copyright (C) 2023 Terabytesoftw.
+ * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
 final class PostQuery extends ActiveQuery
 {
     /**
-     * @return PostQuery<T>
+     * @phpstan-return PostQuery<T>
      */
     public function published(): self
     {
diff --git a/tests/stub/User.php b/tests/stub/User.php
@@ -8,7 +8,7 @@
 use yii\web\IdentityInterface;
 
 /**
- * User ActiveRecord model for testing property and rule definitions.
+ * Active Record User model for testing property and rule definitions.
  *
  * Provides a minimal {@see ActiveRecord} subclass with explicit property declarations and validation rules for static
  * analysis and type inference tests.

Original file line number	Diff line number	Diff line change
`@@ -41,7 +41,7 @@ final class BehaviorMethodsClassReflectionExtension implements MethodsClassRefle`
`41`	`41`	`* Creates a new instance of the {@see BehaviorMethodsClassReflectionExtension} class.`
`42`	`42`	`*`
`43`	`43`	`* @param ReflectionProvider $reflectionProvider Reflection provider for class and property lookups.`
`44`		`- * @param ServiceMap $serviceMap Service map for resolving component classes by ID.`
	`44`	`+ * @param ServiceMap $serviceMap Service and component map for Yii Application static analysis.`
`45`	`45`	`*/`
`46`	`46`	`public function __construct(`
`47`	`47`	`private readonly ReflectionProvider $reflectionProvider,`
Original file line number	Diff line number	Diff line change
`@@ -48,7 +48,7 @@`
`48`	`48`	`* - Integration with PHPStan type combinators and file type mapper for accurate analysis.`
`49`	`49`	`* - Support for union, array, and generic object types in method return values.`
`50`	`50`	`*`
`51`		`- * @see ActiveQuery for query API details.`
	`51`	`+ * @see ActiveQuery for Active Query API details.`
`52`	`52`	`* @see DynamicMethodReturnTypeExtension for PHPStan dynamic return type extension contract.`
`53`	`53`	`*`
`54`	`54`	`* @copyright Copyright (C) 2023 Terabytesoftw.`
`@@ -107,7 +107,7 @@ public function getClass(): string`
`107`	`107`	`* - For {@see ActiveQuery::one()}: a union of the model type and null.`
`108`	`108`	`* - For other methods: the result of {@see handleDefaultCase()}.`
`109`	`109`	`*`
`110`		`- * @param MethodReflection $methodReflection Reflection for the called method.`
	`110`	`+ * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.`
`111`	`111`	`* @param MethodCall $methodCall AST node for the method call expression.`
`112`	`112`	`* @param Scope $scope PHPStan analysis scope for type resolution.`
`113`	`113`	`*`
`@@ -383,7 +383,7 @@ private function getArrayTypeFromModelProperties(Type $modelType): Type`
`383`	`383`	`* This method is used internally by the dynamic return type extension to support accurate type inference for`
`384`	`384`	`* {@see ActiveQuery::asArray()} calls during static analysis.`
`385`	`385`	`*`
`386`		`- * @param MethodCall $methodCall AST node for the {@see asArray()} method call.`
	`386`	`+ * @param MethodCall $methodCall AST node for the method call expression.`
`387`	`387`	`* @param Scope $scope PHPStan analysis scope for type resolution.`
`388`	`388`	`*`
`389`	`389`	* @return Type Type of the first argument if present, or {@see ConstantBooleanType} `true` if not provided.
`@@ -413,7 +413,7 @@ private function getAsArrayArgument(MethodCall $methodCall, Scope $scope): Type`
`413`	`413`	`* This method enables precise type inference for chained {@see asArray()} calls, ensuring that the correct type is`
`414`	`414`	`* propagated for subsequent method calls on the {@see ActiveQuery} instance during static analysis.`
`415`	`415`	`*`
`416`		`- * @param MethodCall $methodCall AST node for the {@see asArray()} method call.`
	`416`	`+ * @param MethodCall $methodCall AST node for the method call expression.`
`417`	`417`	`* @param Scope $scope PHPStan analysis scope for type resolution.`
`418`	`418`	`* @param Type $modelType Model type extracted from the generic {@see ActiveQuery} instance.`
`419`	`419`	`*`
`@@ -450,7 +450,7 @@ private function handleAsArray(MethodCall $methodCall, Scope $scope, Type $model`
`450`	`450`	`* This ensures that fluent interface methods maintain correct generic type propagation for static analysis and IDE`
`451`	`451`	`* support.`
`452`	`452`	`*`
`453`		`- * @param MethodReflection $methodReflection Reflection for the called method.`
	`453`	`+ * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.`
`454`	`454`	`* @param Type $calledOnType Type on which the method is called.`
`455`	`455`	`* @param Type $modelType Model type extracted from the generic {@see ActiveQuery} instance.`
`456`	`456`	`*`
Original file line number	Diff line number	Diff line change
`@@ -36,8 +36,8 @@`
`36`	`36`	`* - Exception handling for invalid or missing arguments in relation method calls.`
`37`	`37`	`* - Returns a generic {@see ActiveQuery} type with the related model class as type parameter.`
`38`	`38`	`*`
`39`		`- * @see ActiveQuery for query API details.`
`40`		`- * @see ActiveRecord for relation method definitions.`
	`39`	`+ * @see ActiveQuery for Active Query API details.`
	`40`	`+ * @see ActiveRecord for Active Record API details.`
`41`	`41`	`* @see DynamicMethodReturnTypeExtension for PHPStan dynamic return type extension contract.`
`42`	`42`	`*`
`43`	`43`	`* @copyright Copyright (C) 2023 Terabytesoftw.`
`@@ -71,7 +71,7 @@ public function getClass(): string`
`71`	`71`	`* Determines the correct return type for {@see ActiveRecord::hasOne()} and {@see ActiveRecord::hasMany()} relation`
`72`	`72`	`* methods by inspecting the first argument which should be a constant string representing the related model class.`
`73`	`73`	`*`
`74`		`- * @param MethodReflection $methodReflection Reflection instance for the called relation method.`
	`74`	`+ * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.`
`75`	`75`	`* @param MethodCall $methodCall AST node for the method call expression.`
`76`	`76`	`* @param Scope $scope PHPStan analysis scope for type resolution.`
`77`	`77`	`*`
Original file line number	Diff line number	Diff line change
`@@ -41,8 +41,8 @@`
`41`	`41`	`* - Nullability handling for methods like {@see ActiveRecord::findOne()}.`
`42`	`42`	`* - Support for custom {@see ActiveQuery} subclasses and generic parameter propagation.`
`43`	`43`	`*`
`44`		`- * @see ActiveQuery for query API details.`
`45`		`- * @see ActiveRecord for ActiveRecord API details.`
	`44`	`+ * @see ActiveQuery for Active Query API details.`
	`45`	`+ * @see ActiveRecord for Active Record API details.`
`46`	`46`	`* @see DynamicStaticMethodReturnTypeExtension for PHPStan dynamic static method return type extension contract.`
`47`	`47`	`*`
`48`	`48`	`* @copyright Copyright (C) 2023 Terabytesoftw.`
`@@ -88,7 +88,7 @@ public function getClass(): string`
`88`	`88`	`* accurate autocompletion and static analysis for methods such as {@see ActiveRecord::findOne()},`
`89`	`89`	`* {@see ActiveRecord::findAll()}, and custom query builders.`
`90`	`90`	`*`
`91`		`- * @param MethodReflection $methodReflection Reflection instance for the static method.`
	`91`	`+ * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.`
`92`	`92`	`*`
`93`	`93`	* @return bool `true` if the static method is supported for dynamic return type inference; `false` otherwise.
`94`	`94`	`*/`
`@@ -156,7 +156,7 @@ public function isStaticMethodSupported(MethodReflection $methodReflection): boo`
`156`	`156`	`* This method ensures that static analysis and IDEs reflect the actual runtime behavior of static`
`157`	`157`	`* {@see ActiveRecord} methods, supporting precise type checks and developer productivity.`
`158`	`158`	`*`
`159`		`- * @param MethodReflection $methodReflection Reflection instance for the static method.`
	`159`	`+ * @param MethodReflection $methodReflection Reflection instance for the method being analyzed.`
`160`	`160`	`* @param StaticCall $methodCall AST node for the static method call expression.`
`161`	`161`	`* @param Scope $scope PHPStan analysis scope for type resolution.`
`162`	`162`	`*`
Original file line number	Diff line number	Diff line change
`@@ -39,7 +39,7 @@`
`39`	`39`	`* - Integration with PHPStan file type mapper for accurate PHPDoc parsing.`
`40`	`40`	`* - PHPDoc property tag extraction from model classes and behaviors.`
`41`	`41`	`*`
`42`		`- * @see ActiveRecord for ActiveRecord API details.`
	`42`	`+ * @see ActiveRecord for Active Record API details.`
`43`	`43`	`* @see DynamicMethodReturnTypeExtension for PHPStan dynamic return type extension contract.`
`44`	`44`	`* @see ServiceMap for service and component map for Yii Application static analysis.`
`45`	`45`	`*`