Generated PHP API documentation

The hand-written API reference focuses on the stable public surface and common workflows.

A complete reference generated from PHPDoc is built automatically with phpDocumentor from the current src/ tree:

The documentation workflow uses a pinned phpDocumentor release and verifies its SHA-256 checksum before execution. Pull requests that change source or documentation build the site without deploying it; only pushes to main publish GitHub Pages.