ENH: generalize signature of cached functions (#192)

* DOC: set `bibtex_use_mathjax = True`
* DOC: update PyPI URLs
* DX: remove `poethepoet` from environment
* DX: switch to `ty` as type checker and fix issues
* DX: use Poe the Poet executor options
* ENH: accept any keyword argument for `DynamicsConfigurator`
* ENH: extend value type of dict
* ENH: generalize function signatures
* FIX: add missing dependency groups
* FIX: generalize `subexpressions` signature
* MAINT: implement updates from formatters
* MAINT: remove `nbmake` from environment
* MAINT: update bibliography style
* MAINT: upgrade lock files and dev config
* MAINT: upgrade lock files and GitHub workflows

Author: pre-commit-ci[bot]

.cspell.json

@@ -25,6 +25,7 @@
     "*particle*.*ml",
     ".editorconfig",
     ".envrc",
+    ".github/dependabot.yml",
     ".gitignore",
     ".pre-commit-config.yaml",
     ".prettierignore",
@@ -38,7 +39,6 @@
   "ignoreWords": [
     "Jpsi",
     "Kallen",
-    "MAINT",
     "PyPI",
     "absl",
     "arange",
@@ -87,7 +87,6 @@
     "maxdepth",
     "maxsplit",
     "meshgrid",
-    "mypy",
     "mystnb",
     "nanmax",
     "nansum",
@@ -171,7 +170,6 @@
     "NumPy",
     "PyPA",
     "pyplot",
-    "pyright",
     "pytest",
     "QRules",
     "recoupling",

.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+
+multi-ecosystem-groups:
+  lock:
+    assignees: [redeboer]
+    commit-message: { prefix: MAINT }
+    schedule: { interval: quarterly }
+
+updates:
+  - package-ecosystem: github-actions
+    directory: "/"
+    labels: [⬆️ Lock]
+    multi-ecosystem-group: lock
+    patterns: ["*"]
+  - package-ecosystem: uv
+    directory: "/"
+    labels: [⬆️ Lock]
+    multi-ecosystem-group: lock
+    patterns: ["*"]

.github/workflows/cd.yml

@@ -9,9 +9,9 @@ on:
 jobs:
   milestone:
     if: startsWith(github.ref, 'refs/tags')
-    uses: ComPWA/actions/.github/workflows/close-milestone.yml@v3
+    uses: ComPWA/actions/.github/workflows/close-milestone.yml@v4
   package-name:
-    uses: ComPWA/actions/.github/workflows/get-pypi-name.yml@v3
+    uses: ComPWA/actions/.github/workflows/get-pypi-name.yml@v4
   pypi:
     environment:
       name: PyPI
@@ -24,9 +24,9 @@ jobs:
       id-token: write
     runs-on: ubuntu-24.04
     steps:
-      - uses: ComPWA/actions/build-pypi-distribution@v3
+      - uses: ComPWA/actions/build-pypi-distribution@v4
       - uses: pypa/gh-action-pypi-publish@release/v1
   push:
     if: startsWith(github.ref, 'refs/tags') && !github.event.release.prerelease
     secrets: inherit
-    uses: ComPWA/actions/.github/workflows/push-to-version-branches.yml@v3
+    uses: ComPWA/actions/.github/workflows/push-to-version-branches.yml@v4

.github/workflows/ci.yml

@@ -17,32 +17,24 @@ on:
       - epic/*
       - "[0-9]+.[0-9]+.x"
   workflow_dispatch:
-    inputs:
-      specific-pip-packages:
-        description: Run CI with specific pip packages
-        required: false
-        type: string
 
 jobs:
   doc:
-    uses: ComPWA/actions/.github/workflows/ci-docs.yml@v3.0
+    uses: ComPWA/actions/.github/workflows/ci-docs.yml@v4.0
     permissions:
       pages: write
       id-token: write
     with:
       apt-packages: graphviz
       gh-pages: true
-      specific-pip-packages: ${{ inputs.specific-pip-packages }}
-  pytest:
-    uses: ComPWA/actions/.github/workflows/pytest.yml@v3.0
-    with:
-      coverage-target: ampform_dpd
-      macos-python-version: "3.10"
-      specific-pip-packages: ${{ inputs.specific-pip-packages }}
-    secrets:
-      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
   style:
-    if: inputs.specific-pip-packages == ''
     secrets:
       token: ${{ secrets.PAT }}
-    uses: ComPWA/actions/.github/workflows/pre-commit.yml@v3.0
+    uses: ComPWA/actions/.github/workflows/style.yml@v4.0
+  test:
+    uses: ComPWA/actions/.github/workflows/test.yml@v4.0
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+    with:
+      coverage-python-version: "3.13"
+      macos-python-version: "3.10"

.github/workflows/clean-caches.yml

@@ -14,9 +14,9 @@ on:
 jobs:
   cleanup:
     name: Remove caches
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-slim
     steps:
-      - uses: ComPWA/actions/clean-caches@v3
+      - uses: ComPWA/actions/clean-caches@v4
         with:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           ref: ${{ inputs.ref }}

.github/workflows/lock.yml

@@ -17,6 +17,6 @@ on:
 
 jobs:
   lock:
-    uses: ComPWA/actions/.github/workflows/lock.yml@v3
+    uses: ComPWA/actions/.github/workflows/lock.yml@v4
     secrets:
       token: ${{ secrets.PAT }}

.github/workflows/pr-linting.yml

@@ -11,4 +11,4 @@ on:
 
 jobs:
   lint-pr:
-    uses: ComPWA/actions/.github/workflows/pr-linting.yml@v3
+    uses: ComPWA/actions/.github/workflows/pr-linting.yml@v4

.github/workflows/release-drafter.yml

@@ -9,7 +9,7 @@ on:
 
 jobs:
   update_release_draft:
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-slim
     steps:
       - uses: release-drafter/release-drafter@v6
         env:

.gitignore

@@ -19,7 +19,6 @@ __pycache__/
 .coverage
 .coverage.*
 .ipynb_checkpoints/
-.mypy*/
 .pytest_cache/
 .virtual_documents/
 *.pyc

.pre-commit-config.yaml

@@ -1,10 +1,8 @@
 ci:
   autofix_commit_msg: "MAINT: implement pre-commit autofixes"
   autoupdate_commit_msg: "MAINT: upgrade lock files"
-  autoupdate_schedule: quarterly
   skip:
-    - mypy
-    - pyright
+    - ty
     - uv-lock
 
 repos:
@@ -14,21 +12,23 @@ repos:
       - id: check-useless-excludes
 
   - repo: https://github.com/ComPWA/policy
-    rev: 0.7.3
+    rev: 0.8.3
     hooks:
       - id: check-dev-files
         args:
           - --doc-apt-packages=graphviz
           - --github-pages
           - --repo-name=ampform-dpd
           - --repo-title=AmpForm-DPD
+          - --type-checker=ty
       - id: colab-toc-visible
       - id: fix-nbformat-version
       - id: remove-empty-tags
       - id: set-nb-display-name
+      - id: strip-nb-whitespace
 
   - repo: https://github.com/kynan/nbstripout
-    rev: 0.8.1
+    rev: 0.9.0
     hooks:
       - id: nbstripout
         args:
@@ -56,7 +56,7 @@ repos:
             metadata.vscode
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.0
+    rev: v0.15.1
     hooks:
       - id: ruff-check
         args: [--fix]
@@ -80,7 +80,7 @@ repos:
       - id: trailing-whitespace
 
   - repo: https://github.com/ComPWA/prettier-pre-commit
-    rev: v3.4.2
+    rev: v3.8.1
     hooks:
       - id: prettier
 
@@ -97,12 +97,12 @@ repos:
           - --in-place
 
   - repo: https://github.com/streetsidesoftware/cspell-cli
-    rev: v9.2.0
+    rev: v9.6.0
     hooks:
       - id: cspell
 
   - repo: https://github.com/editorconfig-checker/editorconfig-checker.python
-    rev: 3.4.0
+    rev: 3.6.0
     hooks:
       - id: editorconfig-checker
         name: editorconfig
@@ -114,20 +114,16 @@ repos:
 
   - repo: local
     hooks:
-      - id: mypy
-        name: mypy
-        entry: mypy
-        language: system
+      - id: ty
+        name: ty
+        entry: ty check
+        args: [--no-progress, --output-format=concise]
+        pass_filenames: false
         require_serial: true
-        types:
-          - python
-
-  - repo: https://github.com/ComPWA/pyright-pre-commit
-    rev: v1.1.406
-    hooks:
-      - id: pyright
+        language: system
+        types_or: [python, pyi, jupyter]
 
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.9.3
+    rev: 0.10.3
     hooks:
       - id: uv-lock