Merge FEATURE-readme-refresh: document the native v3 library

Refresh the README as a standalone v3 tutorial and reference while preserving its established structure. Replace obsolete API and dependency guidance, cover the current public capabilities, and align documentation checks with the native guide. Groundwork validation and documented snippet/runtime checks pass.

Author: etr