Add docs build job to CI and PyPI publish workflow on release

- Add a docs job to test.yml: installs .[doc] extras, runs make -C docs html,
  and uploads the built HTML as a GitHub Actions artifact
- Add publish.yml: triggers on GitHub release (published event), builds a
  source distribution and wheel with python -m build, then publishes to PyPI
  using pypa/gh-action-pypi-publish with OIDC trusted publishing (no API
  token secret required; configure the pypi environment in repository settings)

Assisted-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: majamassarini

.github/workflows/publish.yml

@@ -0,0 +1,49 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Python 3.14
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.14"
+
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+
+    - name: Build source distribution and wheel
+      run: python -m build
+
+    - name: Upload distribution artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+
+    steps:
+    - name: Download distribution artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: dist
+        path: dist/
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/test.yml

@@ -42,3 +42,29 @@ jobs:
       with:
         name: coverage-report
         path: htmlcov/
+
+  docs:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Python 3.14
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.14"
+
+    - name: Install doc dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install ".[doc]"
+
+    - name: Build documentation
+      run: make -C docs html
+
+    - name: Upload documentation
+      uses: actions/upload-artifact@v4
+      with:
+        name: documentation
+        path: docs/build/html/