docs: clarify phpdoc for collection resolvers

[magicsunday]

M# Sweep — Verify compliance for this milestone

Summary

• Expand PHPDoc for the collection factory and interface to describe JSON input, mapping context, and resulting values.
• Document the CollectionDocBlockTypeResolver constructor and its resolve contract for collection wrappers.
• Clarify ClassResolver PHPDoc expectations for consumers invoking runtime class resolution.

Testing

• composer ci:test:php:lint

---

Codex Task