Rename isPublicUse() to isGloballyReachable() - #107

Greptile Summary

This PR renames isPublicUse() to isGloballyReachable() across the interface, concrete implementations, docs, and tests to align with official IANA special-purpose address registry wording. The deprecated isPublicUse() is kept as a thin delegation alias in all three concrete classes.

• IpInterface.php gains a @deprecated-annotated isPublicUse() declaration and the newly named isGloballyReachable() declaration; all three concrete classes (IPv4, IPv6, Multi) delegate the old method to the new one.
• Test data provider constants (PUBLIC_USE_V4, PUBLIC_USE_V6, PUBLIC_USE) are renamed in the test-internal IpDataProviderInterface and the test methods are updated to exercise isGloballyReachable(); the darsyn/ip-doctrine companion repo has no usages of either method.

Confidence Score: 5/5

Safe to merge — the rename is a straightforward delegation refactor with no logic changes; the deprecated alias correctly calls through to the new method in all three concrete classes.

Every concrete class delegates isPublicUse() to isGloballyReachable(), carrying the original implementation unchanged. The darsyn/ip-doctrine companion repo has no usages of either method, so there is no cross-repo breakage risk. The only gap is the missing deprecated-alias row in the API reference doc, which is a documentation cosmetic rather than a behavioral defect.

docs/10-api.md — the deprecated isPublicUse() alias is absent from the reference table, which may confuse upgrading consumers.

Important Files Changed

Sequence Diagram

sequenceDiagram
    participant Caller
    participant IpInterface
    participant IPv4/IPv6/Multi

    Note over IpInterface: isPublicUse() @deprecated<br/>isGloballyReachable()

    Caller->>IPv4/IPv6/Multi: isPublicUse()
    IPv4/IPv6/Multi->>IPv4/IPv6/Multi: isGloballyReachable()
    IPv4/IPv6/Multi-->>Caller: bool

    Caller->>IPv4/IPv6/Multi: isGloballyReachable()
    IPv4/IPv6/Multi-->>Caller: bool

    Note over IPv4/IPv6/Multi: Multi: embedded → IPv4::isGloballyReachable()<br/>non-embedded → IPv6::isGloballyReachable()

_{Reviews (2): Last reviewed commit: "feature: ✨ rename isPublicUse() to isGlo..." | Re-trigger Greptile}