[Backport #1971 to 5.x] Annotation validation refactoring

[github-actions]

Automated backport of #1971 to branch 5.x.

Do not modify this pull request.

Summary

Refactor annotation validation.

• allows to override the logger used during validation to capture all validation logging separately
• simplify the recursive logic
• validation is now always run completely, not aborted on error
• Validation version can now be overridden

Type of Change

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Enhancement (improvement to existing functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update
• Refactor (no functional changes)
• Chore (maintenance, dependencies, CI)

Related Issues

Test Plan

• Unit tests added/updated
• Integration tests added/updated
• Manual testing performed

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my code
• I have commented my code where necessary
• I have updated the documentation accordingly
• My changes generate no new warnings
• New and existing tests pass locally
• Any dependent changes have been merged and published

[github-actions]

Please cherry-pick the changes locally and resolve any conflicts.

git fetch origin backport-1971-to-5.x
git worktree add --checkout .worktree/backport-1971-to-5.x backport-1971-to-5.x
cd .worktree/backport-1971-to-5.x
git reset --hard HEAD^
git cherry-pick -x e7fa8bb8b25f554381d8d06c74d7c485e9f3644a
git push --force-with-lease