Feature/Add PaginatedResult interface with required methods and tests

[othercodes]

No description provided.

[Copilot]

Pull Request Overview

This PR introduces a PaginatedResult interface for domain-level pagination with comprehensive test coverage. The interface defines a contract for paginated collections without web/URL concerns, focusing on pure business pagination logic.

• Adds PaginatedResult interface with 9 essential pagination methods
• Includes comprehensive contract tests validating interface structure, method signatures, and return types
• Provides clear documentation for domain-driven pagination functionality

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
src/Contracts/PaginatedResult.php	New interface defining pagination contract with 9 methods for items, metadata, and state checks
tests/PaginatedResultContractTest.php	Comprehensive test suite validating interface existence, methods, return types, and namespace

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Pull Request Overview

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

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud