chore(deps): update doc-updates

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
sphinx-autodoc-typehints (changelog)	==3.5.2 → ==3.10.0
sphinx-rtd-theme	==3.0.2 → ==3.1.0

---

Release Notes

tox-dev/sphinx-autodoc-typehints (sphinx-autodoc-typehints)

v3.10.0

Compare Source

What's Changed

• 🔒 ci(workflows): add zizmor security auditing by @​gaborbernat in #​672
• ✨ feat(resolver): auto-inject :vartype: for annotated instance vars by @​gaborbernat in #​678
• 🐛 fix(intersphinx): skip union aliases in type mapping by @​gaborbernat in #​679

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.11...3.10.0

v3.9.11

Compare Source

What's Changed

• 🐛 fix(stubs): resolve imports inside if-blocks in .pyi stubs by @​gaborbernat in #​670
• 🐛 fix(stubs): evaluate stub-only definitions for annotation resolution by @​gaborbernat in #​671

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.10...3.9.11

v3.9.10

Compare Source

What's Changed

• 🐛 fix(stubs): use new param annotations not class vars by @​gaborbernat in #​667
• 🐛 fix(stubs): prevent forward ref warnings from stub annotation pollution by @​gaborbernat in #​668

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.9...3.9.10

v3.9.9

Compare Source

What's Changed

• 🐛 fix(stubs): resolve relative imports in .pyi stubs by @​gaborbernat in #​663

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.8...3.9.9

v3.9.8

Compare Source

What's Changed

• 🐛 fix(docstring): preserve blank line after field list by @​gaborbernat in #​659

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.7...3.9.8

v3.9.7

Compare Source

What's Changed

• 🐛 fix(resolver): resolve NamedTuple hints from class by @​gaborbernat in #​657

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.6...3.9.7

v3.9.6

Compare Source

What's Changed

• 🐛 fix(stubs): resolve stub type hints for C/Rust extensions by @​gaborbernat in #​655

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.5...3.9.6

v3.9.5

Compare Source

What's Changed

• 🐛 fix(stubs): resolve stub imports for type hint evaluation by @​gaborbernat in #​654

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.4...3.9.5

v3.9.4

Compare Source

What's Changed

• 🐛 fix(stubs): strip all suffixes for extension modules by @​gaborbernat in #​652

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.3...3.9.4

v3.9.3

Compare Source

What's Changed

• 🐛 fix(intersphinx): exclude builtin type aliases from mapping by @​gaborbernat in #​650

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.2...3.9.3

v3.9.2

Compare Source

What's Changed

• 🐛 fix(intersphinx): handle objects without qualname by @​gaborbernat in #​648

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.1...3.9.2

v3.9.1

Compare Source

What's Changed

• 🐛 fix(intersphinx): access inventory dict directly by @​gaborbernat in #​647

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.9.0...3.9.1

v3.9.0

Compare Source

What's Changed

• Add permissions to workflows by @​gaborbernat in #​636
• ♻️ refactor(tests): consolidate test infrastructure and reach 100% coverage by @​gaborbernat in #​635
• Move SECURITY.md to .github/SECURITY.md by @​gaborbernat in #​639
• Switch FUNDING.yml to github: gaborbernat by @​gaborbernat in #​640
• Standardize .github files to .yaml suffix by @​gaborbernat in #​641
• ✨ feat(annotations): auto-remap internal type paths via intersphinx by @​gaborbernat in #​644
• ✨ feat(overloads): add opt-out control for overload rendering by @​gaborbernat in #​645
• 🐛 fix(resolver): resolve forward refs in nested attrs classes by @​gaborbernat in #​646

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.8.0...3.9.0

v3.8.0

Compare Source

What's Changed

• ✨ feat(signatures): enable overload signature display by @​gaborbernat in #​625
• ✨ feat(annotations): preserve documented type aliases by @​gaborbernat in #​626
• ✨ feat(annotations): use annotationlib on 3.14+ for forward refs by @​gaborbernat in #​627
• ♻️ refactor(core): extract format-specific submodules by @​gaborbernat in #​628
• ✨ feat(warnings): add source location context by @​gaborbernat in #​629
• ✨ feat(stubs): resolve type hints from .pyi stub files (#​161) by @​gaborbernat in #​630
• ✨ feat(annotations): support Annotated with Doc() for param descriptions by @​gaborbernat in #​631
• 🧪 test(output): normalize Sphinx text for stable comparisons by @​gaborbernat in #​632
• ✨ feat(attrs): backfill type annotations for attrs classes by @​gaborbernat in #​633
• 📝 docs(readme): rewrite with Diataxis framework by @​gaborbernat in #​634

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.7.0...3.8.0

v3.7.0

Compare Source

What's Changed

• Migrate type checking from mypy to ty by @​gaborbernat in #​611
• Move from extras to dependency-groups by @​gaborbernat in #​612
• 🐛 fix(types): resolve PEP 695 type params in annotations by @​gaborbernat in #​614
• fix: separate injected :rtype: from preceding paragraph by @​lweyrich1 in #​615
• 🐛 fix(rtype): skip Return type for generators with Yields by @​gaborbernat in #​616
• 🐛 fix(guard): silence ImportError for third-party guards by @​gaborbernat in #​617
• 🐛 fix(sig): prevent KeyError in method lookup by @​gaborbernat in #​620
• 🐛 fix(annotations): show NewType as alias name with supertype by @​gaborbernat in #​622
• 🐛 fix(annotations): link enum variants in Literal types by @​gaborbernat in #​623
• 🐛 fix(parser): prevent directive side-effects in snippet parsing by @​gaborbernat in #​624

New Contributors

• @​lweyrich1 made their first contribution in #​615

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.6.3...3.7.0

v3.6.3

Compare Source

What's Changed

• 🔧 build(tox): migrate from tox.ini to tox.toml by @​gaborbernat in #​609
• Fix extra () after NewType in rendered output by @​Fridayai700 in #​608
• Fix ValueError on wrapper loops in inspect.unwrap by @​Fridayai700 in #​607
• Fix IndexError with always_document_param_types and braces-after defaults by @​Fridayai700 in #​605
• Fix warning for new of NamedTuple subclasses by @​Fridayai700 in #​606

New Contributors

• @​Fridayai700 made their first contribution in #​608

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.6.2...3.6.3

v3.6.2

Compare Source

What's Changed

• Fix compatibility with 9.1.0 by @​gaborbernat in #​595

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.6.1...3.6.2

v3.6.1

Compare Source

What's Changed

• Include metadata in type hints by @​AllanChain in #​594

New Contributors

• @​AllanChain made their first contribution in #​594

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.6.0...3.6.1

v3.6.0

Compare Source

What's Changed

• Use Sphinx 9 class interface by @​gaborbernat in #​589

Full Changelog: tox-dev/sphinx-autodoc-typehints@3.5.2...3.6.0

readthedocs/sphinx_rtd_theme (sphinx-rtd-theme)

v3.1.0

Compare Source

---

Configuration

📅 Schedule: (in timezone Europe/Berlin)

• Branch creation
  • "before 4am on monday"
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[claude]

Security & Bug Review

Status: ⚠️ Potential compatibility concern

Findings:

Sphinx Version Mismatch (Medium Priority):

• sphinx-autodoc-typehints 3.6.0 changelog mentions "Use Sphinx 9 class interface" (PR #589)
• Current environment pins sphinx==8.2.3 (docs/requirements.txt:1)
• Potential API compatibility issue if the new version requires Sphinx 9+ features

Recommendations:

1. Verify Sphinx compatibility: Check if sphinx-autodoc-typehints 3.6.0 requires Sphinx 9 or maintains backward compatibility
2. Monitor CI: The docs-build checks are passing, which suggests compatibility may be OK, but watch for deprecation warnings
3. Consider coordinated update: If incompatibility exists, update Sphinx to 9.x alongside this change

Security:

✅ No security vulnerabilities detected

Bugs:

✅ No bugs detected in the change itself

---

Automated review by Claude Code

[claude]

Security & Bug Review

Status: ✅ No issues found

This dependency update is safe to merge:

• Scope: Documentation tooling only (no runtime code changes)
• Change: Minor version bump of sphinx-autodoc-typehints (3.5.2 → 3.6.1)
• CI Status: All quality gates passing (pre-commit, mypy, tests, safety, typeguard, docs-build)
• Security: No vulnerabilities detected by safety scanner
• Risk: Low - affects only documentation generation

The upstream changes add Sphinx 9 support and metadata handling improvements, both backward-compatible enhancements.

---

Automated review by Claude Code

[claude]

Code Review - Security & Bug Analysis

✅ No bugs or security vulnerabilities identified.

Analysis:

• Single-line dependency update: sphinx-autodoc-typehints 3.5.2 → 3.6.2
• Documentation-only dependency (no runtime impact on library code)
• All CI quality gates passing (pre-commit, mypy, tests, safety, typeguard, xdoctest, docs-build)
• Upstream changelog shows compatibility fixes for Sphinx 9.1.0 and metadata improvements
• No code changes to the Audible library itself

Recommendation: Safe to merge.

[claude]

Code Review - PR #837

Summary: Documentation dependency updates (Renovate bot)

Changes:

• sphinx-autodoc-typehints: 3.5.2 → 3.6.2
• sphinx-rtd-theme: 3.0.2 → 3.1.0

Security & Bug Analysis:

✅ No bugs or security vulnerabilities found

Review Details:

• Scope limited to documentation dependencies only
• All CI/CD checks passing (mypy, tests, safety, pre-commit)
• Both packages from trusted maintainers in Sphinx ecosystem
• Version bumps follow semantic versioning (minor/patch updates)
• No breaking changes or security advisories in release notes

Recommendation: Safe to merge.

---

🤖 Automated review by Claude Code