PHPStan compliance pass on rector classes
### Problem/Motivation Improves PHPStan compliance across rector classes by fixing phpdoc annotations, adding type-narrowing assertions to refactor() methods, and narrowing return types from mixed to ?Node or more specific union types. ### Work items - Commit(s): [db3329e16a](https://github.com/palantirnet/drupal-rector/commit/db3329e16ae4), [090669224d](https://github.com/palantirnet/drupal-rector/commit/090669224de3), [d2ac5401c3](https://github.com/palantirnet/drupal-rector/commit/d2ac5401c36b), [c94fdae6d2](https://github.com/palantirnet/drupal-rector/commit/c94fdae6d2a6), [e26cc8ec7e](https://github.com/palantirnet/drupal-rector/commit/e26cc8ec7ea4), [d2a17a830c](https://github.com/palantirnet/drupal-rector/commit/d2a17a830c45), [dc0375a739](https://github.com/palantirnet/drupal-rector/commit/dc0375a73950) - Pull request(s): [PR #324](https://github.com/palantirnet/drupal-rector/pull/324) ### Credit - Implemented by: @bbrala --- *Filed retroactively as part of the Drupal 12 rector coverage effort. Closed as fixed; credit to be applied to the contributors listed above.* *AI was used extensively to build this fix and to file this issue. See [Dries Buytaert: AI-generated Rector rules for Drupal](https://dri.es/ai-generated-rector-rules-for-drupal) and [Björn Brala: Drupal Rector rules are config, not code. Mostly.](https://www.linkedin.com/pulse/drupal-rector-rules-config-code-mostly-bj%C3%B6rn-brala-vfpwe/).*
issue