Add scripts for regenerating API docs and stubs, and update website sidebar for RayGeo API reference

Author: knipknap

.github/workflows/website.yml

@@ -28,6 +28,12 @@ jobs:
         with:
           fetch-depth: 0 # Fetch all history for versioning
 
+      - name: Checkout raygeo source
+        uses: actions/checkout@v6
+        with:
+          repository: barebaric/raygeo
+          path: external/raygeo
+
       - name: Set up Pixi
         uses: prefix-dev/setup-pixi@v0.9.4
         with:

.gitignore

@@ -27,6 +27,7 @@ debian/.debhelper
 website/node_modules/
 website/.docusaurus/
 website/build/
+website/docs/developer/raygeo-api/
 
 .mac_env
 rayforge/private_addons

pixi.toml

@@ -154,6 +154,13 @@ cmd = "cargo check --manifest-path external/raygeo/Cargo.toml"
 [tasks.raygeo-test]
 cmd = "cargo test --manifest-path external/raygeo/crates/raygeo/Cargo.toml && pytest -v external/raygeo/tests/"
 
+[tasks.raygeo-clean-stubs]
+cmd = "rm -rf external/raygeo/raygeo-stubs website/docs/developer/raygeo-api/*.md"
+
+[tasks.raygeo-gen-stubs]
+cmd = "mkdir -p external/raygeo/raygeo-stubs && python3 -c 'import raygeo; raygeo.generate_stubs(\"external/raygeo/raygeo-stubs\")'"
+depends-on = ["raygeo-clean-stubs", "raygeo-build"]
+
 [tasks.build-deb]
 # Builds a binary .deb package for local installation and testing.
 cmd = "bash scripts/build-deb.sh"
@@ -171,11 +178,18 @@ pyright = ">=1.1.409,<2"
 
 # Tasks for developing and generating the website
 [feature.website.tasks]
+site-gen-api = "python3 scripts/update_api_docs.py"
 site-install = { cmd = "npm install", cwd = "website" }
-site-serve = { cmd = "npm start", cwd = "website" }
-site-build = { cmd = "npm run build", cwd = "website" }
+site-serve = { cmd = "npm start", cwd = "website", depends-on = ["update-api-docs"] }
+site-build = { cmd = "npm run build", cwd = "website", depends-on = ["site-gen-api"] }
 site-deploy = "bash scripts/deploy_website.sh"
 
+[tasks.update-stubs]
+cmd = "python3 scripts/update_stubs.py"
+
+[tasks.update-api-docs]
+cmd = "python3 scripts/update_api_docs.py"
+
 # Tasks for video processing
 [feature.video-tools.tasks]
 process-audio = "python3 scripts/media/process_audio.py"