fix: new interface, deprecating old broken one

[Becheler]

#297
#286

Before submitting

• This PR targets the develop branch.
• I searched for an existing PR or issue covering the same change.
• My contribution is licensed under the Boost Software License 1.0.

Type of change

• Bug fix
• New feature or API addition
• Refactor (no behavior change)
• Documentation
• Build, CI, or tooling
• Other (specify below)

Does this PR introduce a breaking change?

• Yes (describe migration impact below)
• No

What this PR does

Motivation

Testing

Checklist

• Existing tests pass (b2 in the test/ directory).
• New behavior is covered by a test, or this is a docs / build / refactor change.
• Documentation was updated if user-facing behavior changed.
• No new compiler warnings on the platforms I built against.

[github-actions]

Boost dependency footprint vs develop (auto-generated).
PR run 32878598983 vs develop run 32758786340 (f586064be6).

Header-inclusion weights (graph files pulling each direct dependency in):

Dependency	develop	PR	Δ
property_map	79	80	+1

Transitive Boost modules: 66 → 66 (0)

[codecov]

Codecov Report

❌ Patch coverage is 75.60976% with 10 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
include/boost/graph/maximum_adjacency_search.hpp	75.60%	10 Missing ⚠️

❌ Your patch check has failed because the patch coverage (75.60%) is below the target coverage (100.00%). You can increase the patch coverage or adjust the target coverage.

📢 Thoughts on this report? Let us know!

🚀 New features to boost your workflow:

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

[github-actions]

Compiler-warning counts vs develop (auto-generated).
PR run 32878599000 vs develop run 32758786083 (f586064be6).

Job	Baseline	After	Delta
macos (clang, 14)	607	627	+20
macos (clang, 17)	570	590	+20
macos (clang, 20)	570	590	+20
ubuntu (clang-19, 14)	607	627	+20
ubuntu (clang-19, 17)	570	590	+20
ubuntu (clang-19, 20)	570	590	+20
ubuntu (clang-19, 23)	570	590	+20
ubuntu (gcc-14, 14)	768	800	+32
ubuntu (gcc-14, 17)	904	936	+32
ubuntu (gcc-14, 20)	904	936	+32
ubuntu (gcc-14, 23)	904	936	+32
windows_msvc_14_3 (msvc-14.3)	938	974	+36