docs: overhaul types #2042

Job	Run time
Build & verify package	14s
Verify dev env	9s
Check types using supported type checkers	18s
Run doctests & render changelog	19s
Tests on pypy-3.10	21s
Tests & Mypy on 3.12	1m 6s
Tests & Mypy on 3.13	1m 5s
Tests & Mypy on 3.9	41s
Tests & Mypy on 3.14	1m 11s
Tests & Mypy on 3.10	1m 5s
Tests & Mypy on 3.11	59s
Combine & check coverage	9s
required-checks-pass	3s
	7m 40s

Provide feedback