editorial: CI for roleInfo.js (#2625)

Adds github actions and scripts to enable automatic checking and updating of roleInfo.js

- common/script/buildRoleInfo.js
  - currently very hacky way of running aria.js using linkedom (see #2501 for plans on removing hackery)
- roleInfo.yml: updates roleInfo.js on pushes to main
  - standard nodejs setup
  - installs linkedom and runs buildRoleInfo.js to update roleInfo
- roleInfoCheck.yml: checks PRs if they introduce changes to roleInfo.js
   - similar to roleInfo.yml but only reports on git diff (no commit)

Part of  #2501

Author: pkra

.github/workflows/roleInfo.yml

@@ -0,0 +1,26 @@
+name: roleInfo update
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  roleInfo:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.head_ref }}
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "latest"
+      - run: npm i linkedom
+      - run: node ./common/script/buildRoleInfo.js > ./common/script/roleInfo.js
+      - run: git config user.name "github-actions[bot]"
+      - run: git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+      - run: git add ./common/script/roleInfo.js
+      - run: |
+         git diff-index --quiet HEAD ./common/script/roleInfo.js || git commit -m'chore: update roleInfo.js'
+      - run: git push

.github/workflows/roleInfoCheck.yml

@@ -0,0 +1,22 @@
+name: roleInfo PR check
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  roleInfo:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.head_ref }}
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "latest"
+      - run: npm i linkedom [email protected]
+      - run: node ./common/script/buildRoleInfo.js > ./common/script/roleInfo.js
+      - run: npx prettier --write --print-width 200 ./common/script/roleInfo.js
+      - run: git diff --exit-code

common/script/buildRoleInfo.js

@@ -0,0 +1,22 @@
+import * as fs from "node:fs";
+import { parseHTML } from 'linkedom';
+
+const { document } = parseHTML(
+    fs.readFileSync("../aria/index.html").toString()
+);
+
+// mock functions for aria.js
+let updateReferences = () => {};
+document.URL = "";
+
+const script = fs.readFileSync("./common/script/aria.js").toString();
+
+
+const scriptWithoutRespecUI = script.substring(0, script.indexOf("require(")); // TODO: HACK remove everything past "require(" (NOTE: if we went only with this SSG approach, we could remove that end of aria.js and this hack)
+
+// HACK call ariaAttributeReferences() and log out roleInfo with prefix
+const scriptAddition =
+    'ariaAttributeReferences();console.log("/* This file is generated - do not modify */ var roleInfo = "+JSON.stringify(roleInfo, null, 2));';
+
+// HACK: eval!
+eval(scriptWithoutRespecUI + scriptAddition);