# Documentation requirements for heterodyne-analysis
# Research-grade documentation dependencies

# Core Sphinx and extensions
sphinx>=8.2.3
sphinx-rtd-theme>=3.0.0
sphinx-autodoc-typehints>=2.5.0
sphinx-copybutton>=0.5.2
sphinx-design>=0.6.0
sphinx-tabs>=3.4.0
sphinx-autobuild>=2024.10.1
sphinx-autoapi>=3.4.0

# Mathematical and scientific documentation
myst-parser>=4.0.0
numpydoc>=1.8.0
linkify-it-py>=2.0.0
sphinxext-opengraph>=0.9.0

# Enhanced documentation features
sphinx-gallery>=0.18.0
nbsphinx>=0.9.0
jupyter>=1.1.0
ipython>=8.28.0
myst-nb>=1.1.0

# Documentation quality and validation
sphinx-external-toc>=0.3.0
sphinx-togglebutton>=0.3.0
sphinx-proof>=0.1.3

# Research-specific extensions
sphinxcontrib-bibtex>=2.6.0
sphinxcontrib-mermaid>=0.9.0
sphinxcontrib-plantuml>=0.27

# Scientific computing dependencies for docs
numpy>=2.3.3
scipy>=1.16.2
matplotlib>=3.10.6
h5py>=3.12.0

# Performance and optimization (for documentation examples)
numba>=0.60.0
psutil>=6.0.0
joblib>=1.4.0

# Optional robust optimization (graceful degradation if not available)
cvxpy>=1.5.0; python_version >= "3.12"

# Documentation testing and validation
pytest>=8.4.0
pytest-cov>=6.0.0
coverage>=7.6.0

# Code quality tools (for documentation examples)
black>=25.9.0
isort>=6.1.0
ruff>=0.13.2
