Introduce Materialization class and optimize pipeline operations.

[gustavofreze]

No description provided.

[Copilot]

Pull request overview

Introduces a Materialization cache for eager pipelines to support deferred evaluation and reuse of computed results across terminal calls, while updating docs and tests to reflect the intended “fused pass” execution model.

Changes:

• Added Internal\Materialization and refactored EagerPipeline to rely on it for cached terminal access.
• Expanded/adjusted complexity and evaluation-strategy documentation (Collectible, Pipeline, README).
• Added test coverage for multi-predicate filtering and reducing over chained operations (eager + lazy).

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
tests/LazyCollectionTest.php	Adds tests for multiple filter predicates and reduce over chained ops (lazy).
tests/EagerCollectionTest.php	Adds tests for multiple filter predicates and reduce over chained ops (eager).
src/Internal/Pipeline.php	Updates complexity documentation for pipeline operations.
src/Internal/Operations/Transforming/Segment.php	Inlines trailing-buffer slicing logic (removes private helper).
src/Internal/Operations/Transforming/Filter.php	Simplifies predicate compilation logic.
src/Internal/Materialization.php	New cached materialization helper for eager evaluation.
src/Internal/EagerPipeline.php	Refactors eager pipeline to use Materialization.
src/Collection.php	Routes some terminal operations directly through pipeline->process(); simplifies iterator.
src/Collectible.php	Updates interface docs with revised complexity/evaluation model.
composer.json	Updates dev dependency PHPUnit version.
README.md	Reformats docs and updates evaluation strategy explanation.
Makefile	Adds show-outdated target and includes it in help output.