cakephp · josbeir · Feb 21, 2026 · Feb 21, 2026 · Feb 21, 2026 · Feb 22, 2026
diff --git a/src/AttributeResolver/Enum/AttributeTargetType.php b/src/AttributeResolver/Enum/AttributeTargetType.php
@@ -31,7 +31,7 @@ enum AttributeTargetType: string
     /**
      * Attribute attached to a class
      */
-    case CLASS_TYPE = 'class';
+    case CLASS_ = 'class';
 
     /**
      * Attribute attached to a method

diff --git a/src/AttributeResolver/Enum/DeclaringClassType.php b/src/AttributeResolver/Enum/DeclaringClassType.php
@@ -0,0 +1,43 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
+ * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ *
+ * Licensed under The MIT License
+ * For full copyright and license information, please see the LICENSE.txt
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ * @link          https://cakephp.org CakePHP(tm) Project
+ * @since         6.0.0
+ * @license       https://opensource.org/licenses/mit-license.php MIT License
+ */
+namespace Cake\AttributeResolver\Enum;
+
+/**
+ * Enum representing the declaring class kind for an attribute target.
+ */
+enum DeclaringClassType: string
+{
+    /**
+     * Declaring type is a class.
+     */
+    case CLASS_ = 'class';
+
+    /**
+     * Declaring type is an interface.
+     */
+    case INTERFACE = 'interface';
+
+    /**
+     * Declaring type is a trait.
+     */
+    case TRAIT = 'trait';
+
+    /**
+     * Declaring type is an enum.
+     */
+    case ENUM = 'enum';
+}
diff --git a/src/AttributeResolver/Enum/MethodVisibility.php b/src/AttributeResolver/Enum/MethodVisibility.php
@@ -0,0 +1,38 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
+ * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ *
+ * Licensed under The MIT License
+ * For full copyright and license information, please see the LICENSE.txt
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ * @link          https://cakephp.org CakePHP(tm) Project
+ * @since         6.0.0
+ * @license       https://opensource.org/licenses/mit-license.php MIT License
+ */
+namespace Cake\AttributeResolver\Enum;
+
+/**
+ * Enum representing method visibility levels.
+ */
+enum MethodVisibility: string
+{
+    /**
+     * Public visibility.
+     */
+    case PUBLIC = 'public';
+
+    /**
+     * Protected visibility.
+     */
+    case PROTECTED = 'protected';
+
+    /**
+     * Private visibility.
+     */
+    case PRIVATE = 'private';
+}
diff --git a/src/AttributeResolver/Parser.php b/src/AttributeResolver/Parser.php
@@ -17,6 +17,8 @@
 namespace Cake\AttributeResolver;
 
 use Cake\AttributeResolver\Enum\AttributeTargetType;
+use Cake\AttributeResolver\Enum\DeclaringClassType;
+use Cake\AttributeResolver\Enum\MethodVisibility;
 use Cake\AttributeResolver\ValueObject\AttributeInfo;
 use Cake\AttributeResolver\ValueObject\AttributeTarget;
 use Generator;
@@ -245,6 +247,8 @@ protected function parseClass(
     ): Generator {
         $className = $reflection->getName();
         $startLine = $reflection->getStartLine();
+        $isDeclaringClassAbstract = $reflection->isAbstract();
+        $declaringClassType = $this->getDeclaringClassType($reflection);
 
         // Parse class-level attributes
         yield from $this->parseAttributes(
@@ -253,33 +257,86 @@ protected function parseClass(
             $filePath,
             $startLine === false ? 0 : $startLine,
             $fileTime,
-            new AttributeTarget(AttributeTargetType::CLASS_TYPE, $className),
+            new AttributeTarget(
+                AttributeTargetType::CLASS_,
+                $className,
+                null,
+                $isDeclaringClassAbstract,
+                $declaringClassType,
+            ),
             $pluginName,
         );
 
         // Parse method attributes
         foreach ($reflection->getMethods() as $method) {
-            yield from $this->parseMethod($method, $filePath, $fileTime, $className, $pluginName);
+            yield from $this->parseMethod(
+                $method,
+                $filePath,
+                $fileTime,
+                $className,
+                $isDeclaringClassAbstract,
+                $declaringClassType,
+                $pluginName,
+            );
         }
 
         // Parse property attributes
         foreach ($reflection->getProperties() as $property) {
-            yield from $this->parseProperty($property, $filePath, $fileTime, $className, $pluginName);
+            yield from $this->parseProperty(
+                $property,
+                $filePath,
+                $fileTime,
+                $className,
+                $isDeclaringClassAbstract,
+                $declaringClassType,
+                $pluginName,
+            );
         }
 
         // Parse constant attributes
         foreach ($reflection->getReflectionConstants() as $constant) {
-            yield from $this->parseConstant($constant, $filePath, $fileTime, $className, $pluginName);
+            yield from $this->parseConstant(
+                $constant,
+                $filePath,
+                $fileTime,
+                $className,
+                $isDeclaringClassAbstract,
+                $declaringClassType,
+                $pluginName,
+            );
         }
     }
 
+    /**
+     * Detect declaring class kind from reflection.
+     *
+     * @param \ReflectionClass<object> $reflection Class reflection
+     * @return \Cake\AttributeResolver\Enum\DeclaringClassType
+     */
+    protected function getDeclaringClassType(ReflectionClass $reflection): DeclaringClassType
+    {
+        if ($reflection->isInterface()) {
+            return DeclaringClassType::INTERFACE;
+        }
+        if ($reflection->isTrait()) {
+            return DeclaringClassType::TRAIT;
+        }
+        if ($reflection->isEnum()) {
+            return DeclaringClassType::ENUM;
+        }
+
+        return DeclaringClassType::CLASS_;
+    }
+
     /**
      * Parse method attributes.
      *
      * @param \ReflectionMethod $method Method reflection
      * @param string $filePath File path
      * @param int $fileTime File modification time
      * @param string $className Declaring class name
+     * @param bool $isDeclaringClassAbstract Whether the declaring class is abstract
+     * @param \Cake\AttributeResolver\Enum\DeclaringClassType $declaringClassType Declaring class kind
      * @param string|null $pluginName Plugin name
      * @return \Generator<\Cake\AttributeResolver\ValueObject\AttributeInfo>
      */
@@ -288,13 +345,20 @@ protected function parseMethod(
         string $filePath,
         int $fileTime,
         string $className,
+        bool $isDeclaringClassAbstract,
+        DeclaringClassType $declaringClassType,
         ?string $pluginName,
     ): Generator {
         $startLine = $method->getStartLine();
+        $methodDeclaringClass = $method->getDeclaringClass()->getName();
+        $methodVisibility = $this->getMethodVisibility($method);
         $target = new AttributeTarget(
             AttributeTargetType::METHOD,
             $method->getName(),
-            $className,
+            $methodDeclaringClass,
+            $isDeclaringClassAbstract,
+            $declaringClassType,
+            $methodVisibility,
         );
 
         yield from $this->parseAttributes(
@@ -312,20 +376,43 @@ protected function parseMethod(
                 $parameter,
                 $filePath,
                 $fileTime,
-                $className,
+                $methodDeclaringClass,
                 $method->getName(),
+                $isDeclaringClassAbstract,
+                $declaringClassType,
+                $methodVisibility,
                 $pluginName,
             );
         }
     }
 
+    /**
+     * Detect method visibility from reflection metadata.
+     *
+     * @param \ReflectionMethod $method Method reflection
+     * @return \Cake\AttributeResolver\Enum\MethodVisibility
+     */
+    protected function getMethodVisibility(ReflectionMethod $method): MethodVisibility
+    {
+        if ($method->isPrivate()) {
+            return MethodVisibility::PRIVATE;
+        }
+        if ($method->isProtected()) {
+            return MethodVisibility::PROTECTED;
+        }
+
+        return MethodVisibility::PUBLIC;
+    }
+
     /**
      * Parse property attributes.
      *
      * @param \ReflectionProperty $property Property reflection
      * @param string $filePath File path
      * @param int $fileTime File modification time
      * @param string $className Declaring class name
+     * @param bool $isDeclaringClassAbstract Whether the declaring class is abstract
+     * @param \Cake\AttributeResolver\Enum\DeclaringClassType $declaringClassType Declaring class kind
      * @param string|null $pluginName Plugin name
      * @return \Generator<\Cake\AttributeResolver\ValueObject\AttributeInfo>
      */
@@ -334,12 +421,16 @@ protected function parseProperty(
         string $filePath,
         int $fileTime,
         string $className,
+        bool $isDeclaringClassAbstract,
+        DeclaringClassType $declaringClassType,
         ?string $pluginName,
     ): Generator {
         $target = new AttributeTarget(
             AttributeTargetType::PROPERTY,
             $property->getName(),
             $className,
+            $isDeclaringClassAbstract,
+            $declaringClassType,
         );
 
         yield from $this->parseAttributes(
@@ -361,6 +452,9 @@ protected function parseProperty(
      * @param int $fileTime File modification time
      * @param string $className Declaring class name
      * @param string $methodName Method name
+     * @param bool $isDeclaringClassAbstract Whether the declaring class is abstract
+     * @param \Cake\AttributeResolver\Enum\DeclaringClassType $declaringClassType Declaring class kind
+     * @param \Cake\AttributeResolver\Enum\MethodVisibility $methodVisibility Method visibility
      * @param string|null $pluginName Plugin name
      * @return \Generator<\Cake\AttributeResolver\ValueObject\AttributeInfo>
      */
@@ -370,6 +464,9 @@ protected function parseParameter(
         int $fileTime,
         string $className,
         string $methodName,
+        bool $isDeclaringClassAbstract,
+        DeclaringClassType $declaringClassType,
+        MethodVisibility $methodVisibility,
         ?string $pluginName,
     ): Generator {
         $declaringFunction = $parameter->getDeclaringFunction();
@@ -379,6 +476,9 @@ protected function parseParameter(
             AttributeTargetType::PARAMETER,
             $parameter->getName(),
             $className . '::' . $methodName,
+            $isDeclaringClassAbstract,
+            $declaringClassType,
+            $methodVisibility,
         );
 
         yield from $this->parseAttributes(
@@ -399,6 +499,8 @@ protected function parseParameter(
      * @param string $filePath File path
      * @param int $fileTime File modification time
      * @param string $className Declaring class name
+     * @param bool $isDeclaringClassAbstract Whether the declaring class is abstract
+     * @param \Cake\AttributeResolver\Enum\DeclaringClassType $declaringClassType Declaring class kind
      * @param string|null $pluginName Plugin name
      * @return \Generator<\Cake\AttributeResolver\ValueObject\AttributeInfo>
      */
@@ -407,12 +509,16 @@ protected function parseConstant(
         string $filePath,
         int $fileTime,
         string $className,
+        bool $isDeclaringClassAbstract,
+        DeclaringClassType $declaringClassType,
         ?string $pluginName,
     ): Generator {
         $target = new AttributeTarget(
             AttributeTargetType::CONSTANT,
             $constant->getName(),
             $className,
+            $isDeclaringClassAbstract,
+            $declaringClassType,
         );
 
         yield from $this->parseAttributes(

diff --git a/src/AttributeResolver/README.md b/src/AttributeResolver/README.md
@@ -72,7 +72,7 @@ $adminRoutes = AttributeResolver::withAttribute(Route::class)
 
 // Filter by target type
 $classAttributes = AttributeResolver::withAttribute(MyAttribute::class)
-    ->withTargetType(AttributeTargetType::CLASS_TYPE);
+    ->withTargetType(AttributeTargetType::CLASS_);
 
 // Filter by plugin
 $pluginCommands = AttributeResolver::withAttribute(ConsoleCommand::class)