Make hydrators persistent with owned EntityFactory

[alganet]

Hydrators are now long-lived objects that own their EntityFactory instead of receiving it as a parameter on every call. The mapper derives its entityFactory and style from the hydrator, inverting the previous dependency direction.

• Add entityFactory property to Hydrator interface
• Split hydrate() (returns root entity) from hydrateAll() (returns full graph)
• Remove $hydrator property and hydrateFrom() from Collection
• Remove defaultHydrator()/resolveHydrator() from AbstractMapper
• Mapper constructor now takes Hydrator instead of EntityFactory

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.97%. Comparing base (f95b89c) to head (0194fc2).

Additional details and impacted files

@@            Coverage Diff            @@
##             master      #28   +/-   ##
=========================================
  Coverage     97.96%   97.97%           
- Complexity      290      291    +1     
=========================================
  Files            17       17           
  Lines           590      592    +2     
=========================================
+ Hits            578      580    +2     
  Misses           12       12           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

This PR refactors hydration so hydrators are long-lived objects that own their EntityFactory, and mappers derive entityFactory/style from the hydrator (inverting the prior dependency direction).

Changes:

• Make Hydrator expose an entityFactory and split hydrate() (root entity) from hydrateAll() (full graph).
• Update AbstractMapper to accept a Hydrator and remove per-collection hydrator overrides (Collection::$hydrator, hydrateFrom(), defaultHydrator(), resolveHydrator()).
• Update hydrator implementations and tests to use the new API and construction pattern (new Nested(new EntityFactory(...))).

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/Hydrator.php	Updates hydrator contract: persistent entityFactory, adds hydrateAll() and narrows hydrate() to root entity.
src/Hydrators/Base.php	Introduces owned EntityFactory and default hydrate() implementation delegating to hydrateAll().
src/Hydrators/Nested.php	Adapts nested hydrator to use owned EntityFactory and implement hydrateAll().
src/Hydrators/PrestyledAssoc.php	Adapts pre-styled assoc hydrator to use owned EntityFactory and implement hydrateAll().
src/AbstractMapper.php	Mapper now takes a Hydrator; exposes derived entityFactory/style; removes default/collection hydrator resolution.
src/Collections/Collection.php	Removes per-collection hydrator state and hydrateFrom() override.
tests/InMemoryMapper.php	Switches to hydrateAll() via mapper-owned hydrator; removes default hydrator override.
tests/Hydrators/NestedTest.php	Updates tests for hydrateAll() and adds coverage for new hydrate() root-entity behavior.
tests/Hydrators/PrestyledAssocTest.php	Updates tests to construct hydrator with an EntityFactory and call hydrateAll().
tests/AbstractMapperTest.php	Updates to construct mappers with a hydrator and validates style derivation via hydrator’s factory.
tests/Collections/CollectionTest.php	Removes hydrateFrom() test and updates mapper construction to pass a hydrator.
tests/Styles/Sakila/SakilaIntegrationTest.php	Updates integration test to pass Hydrator (Nested) into InMemoryMapper.
tests/Styles/Plural/PluralIntegrationTest.php	Updates integration test to pass Hydrator (Nested) into InMemoryMapper.
tests/Styles/NorthWind/NorthWindIntegrationTest.php	Updates integration test to pass Hydrator (Nested) into InMemoryMapper.
tests/Styles/CakePHP/CakePHPIntegrationTest.php	Updates integration test to pass Hydrator (Nested) into InMemoryMapper.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.