Skip overridden methods in DocblockReturnArrayFromDirectArrayInstanceRector

[Copilot]

DocblockReturnArrayFromDirectArrayInstanceRector was adding @return docblocks to methods overriding parent/interface methods, creating conflicting documentation.

interface FooInterface {
    /** @return int[] */
    public function getCodes(): iterable;
}

class Foo implements FooInterface {
    public function getCodes(): iterable {
        return [200, 201];
    }
    // Rector was incorrectly adding: @return array{200, 201}
    // Should inherit parent's @return int[] instead
}

Changes

• Added ParentClassMethodTypeOverrideGuard dependency to detect overridden methods
• Skip docblock generation when hasParentClassMethod() returns true
• Follows pattern used in AddParamArrayDocblockFromDimFetchAccessRector and similar rectors

Child methods now properly inherit parent documentation per LSP principles.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.