Enhance port handling in Address and Ports classes.

[gustavofreze]

No description provided.

[Copilot]

Pull request overview

This PR extends the container address port model to distinguish between container-internal exposed ports and host-mapped ports by reading NetworkSettings.Ports from docker inspect, surfacing host ports via the Ports contract, and documenting/testing the new behavior.

Changes:

• Parse host port bindings from docker inspect (NetworkSettings.Ports) and store them alongside exposed ports.
• Extend the Ports contract + implementation with hostPorts() and firstHostPort().
• Add unit tests and README examples covering host port mappings, multiple mappings, and null bindings.

Reviewed changes

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

Show a summary per file

File	Description
tests/Unit/Mocks/InspectResponseFixture.php	Adds NetworkSettings.Ports to fixtures so tests can simulate host port bindings.
tests/Unit/GenericDockerContainerTest.php	Adds unit coverage for host port parsing and new Ports API.
src/Internal/Containers/ContainerInspection.php	Extracts host-mapped ports from inspect payload and wires them into Address.
src/Internal/Containers/Address/Ports.php	Stores exposed vs host-mapped ports separately and exposes new accessors.
src/Contracts/Ports.php	Public contract update to include host port access methods.
README.md	Documents how to access container vs host ports after start.