ci: Build docs in CI (#157)

* ci: Build docs in CI

* `devtools::document()` (GitHub Actions)

* chore: use-public-rspm: true

* fix: fix CI workflow triggers

* fix: use branch name for concurrency group

* chore: use Config/Needs/website

* ci: Only one of push/pull_request runs

* fix: config/needs/website syntax

* chore: d3scatter from jcheng5/d3scatter

* chore: fully clean site

* chore: update to jsdoc2md v9

* fix: widgets.Rmd

* refactor: Revert to jsdoc2md 4.0.1

* fix: use github actor for committer

* ci(docs): Automated site build

* Trigger CI; Add trailing blank line

* ci: handle no changes gracefully

* chore: undo all changes to filter.js

* ci(docs): Automated site build

---------

Co-authored-by: gadenbuie <gadenbuie@users.noreply.github.com>

Author: gadenbuie

.github/workflows/build-docs.yml

@@ -0,0 +1,59 @@
+name: Build Docs
+
+on:
+  workflow_dispatch:
+  push:
+    branches: ["main", "docs**"]
+  pull_request:
+
+permissions:
+  contents: write
+
+concurrency:
+  group: build-site-${{ github.ref_name }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    if: github.event_name != 'pull_request' || !startsWith(github.head_ref, 'docs')
+    
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      
+    - name: Set up Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: 22 # jsdoc2md 4.0.1 doesn't work with node 23
+        
+    - name: Install dependencies
+      run: npm install
+
+    - name: Install pandoc
+      uses: r-lib/actions/setup-pandoc@v2
+
+    - name: Setup R
+      uses: r-lib/actions/setup-r@v2
+      with:
+        use-public-rspm: true
+    
+    - name: Install R Dependencies
+      uses: r-lib/actions/setup-r-dependencies@v2
+      with:
+        cache-version: 2
+        extra-packages: |
+          local::.
+        needs: |
+          website
+      
+    - name: Render docs website
+      working-directory: docs
+      run: source build-site.sh
+
+    - name: Commit changes
+      run: |
+        git config --global user.name "$GITHUB_ACTOR"
+        git config --global user.email "$GITHUB_ACTOR@users.noreply.github.com"
+        git add docs/ && git commit -m "ci(docs): Automated site build" || echo "No doc changes"
+        git push || echo "No doc updates to push"

DESCRIPTION

@@ -45,7 +45,8 @@ Suggests:
     testthat (>= 2.1.0),
     sass,
     bslib
+Config/Needs/website: jcheng5/d3scatter, DT, leaflet, rmarkdown
 URL: https://rstudio.github.io/crosstalk/, https://github.com/rstudio/crosstalk
 BugReports: https://github.com/rstudio/crosstalk/issues
-RoxygenNote: 7.2.3
+RoxygenNote: 7.3.2
 Encoding: UTF-8