ci: Migrate from CircleCI to GitHub Actions

.github/actions/run-xvfb/action.yml

@@ -0,0 +1,13 @@
+name: 'Run with Xvfb'
+description: 'Run a command under Xvfb with a preconfigured screen size'
+
+inputs:
+  run:
+    description: 'Command to execute'
+    required: true
+
+runs:
+  using: 'composite'
+  steps:
+    - run: xvfb-run --auto-servernum --server-args="-screen 0 1280x1024x24" ${{ inputs.run }}
+      shell: bash

.github/actions/setup-chrome/action.yml

@@ -0,0 +1,19 @@
+name: 'Setup Chrome'
+description: 'Install Chrome and set CHROME_BIN environment variable'
+
+inputs:
+  chrome-version:
+    description: 'Chrome version to install'
+    default: '135.0.7049.95'
+
+runs:
+  using: 'composite'
+  steps:
+    - uses: browser-actions/setup-chrome@v2
+      id: setup-chrome
+      with:
+        chrome-version: ${{ inputs.chrome-version }}
+
+    - name: Set Chrome binary path
+      run: echo "CHROME_BIN=${{ steps.setup-chrome.outputs.chrome-path }}" >> $GITHUB_ENV
+      shell: bash

.github/actions/setup-image-env/action.yml

@@ -0,0 +1,26 @@
+name: 'Setup Image Environment'
+description: 'Setup Python, uv, and install Kaleido/plotly with required fonts'
+
+inputs:
+  python-version:
+    description: 'Python version to use'
+    default: '3.12'
+  uv-version:
+    description: 'uv version to use'
+    default: '0.11.2'
+
+runs:
+  using: 'composite'
+  steps:
+    - uses: actions/setup-python@v6
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: ${{ inputs.uv-version }}
+
+    - name: Install Kaleido, plotly.io and required fonts
+      run: .github/scripts/env_image.sh
+      shell: bash

.github/actions/setup-workspace/action.yml

@@ -0,0 +1,26 @@
+name: 'Setup Workspace'
+description: 'Setup Node.js, install dependencies, and download build artifacts'
+
+inputs:
+  node-version:
+    description: 'Node.js version to use'
+    default: '18.20.4'
+
+runs:
+  using: 'composite'
+  steps:
+    - uses: actions/setup-node@v6
+      with:
+        node-version: ${{ inputs.node-version }}
+        cache: 'npm'
+
+    - name: Install dependencies
+      run: npm ci
+      shell: bash
+      env:
+        NODE_OPTIONS: '--max-old-space-size=4096'
+
+    - uses: actions/download-artifact@v8
+      with:
+        name: build-output
+        path: .

.github/scripts/env_build.sh

@@ -0,0 +1,6 @@
+#!/bin/sh
+export NODE_OPTIONS='--max-old-space-size=4096' && \
+echo "node version: $(node --version)" && \
+echo "npm version: $(npm --version)" && \
+npm ci && \
+npm ls --prod --all

.github/scripts/env_image.sh

@@ -0,0 +1,19 @@
+#!/bin/sh
+set -e
+# install required fonts
+sudo apt-get install fonts-liberation2 fonts-open-sans fonts-noto-cjk fonts-noto-color-emoji
+
+# install additional fonts (committed in .github/fonts/)
+sudo cp -r .github/fonts/ /usr/share/
+sudo apt install fontconfig
+sudo fc-cache -f
+
+# install Kaleido & Plotly
+uv pip install --system kaleido==1.2 plotly==6.6.0 --no-progress
+
+# install numpy i.e. to convert arrays to typed arrays
+uv pip install --system numpy==2.4.3
+
+# verify version of python and versions of installed python packages
+python --version
+uv pip freeze --system

.github/scripts/split_files.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+// Replacement for `circleci tests split`
+// Reads lines from stdin and emits only those where index % SHARD_TOTAL == SHARD_INDEX
+// Environment variables SHARD_INDEX and SHARD_TOTAL must be set.
+
+import { readFileSync } from 'fs';
+
+const lines = readFileSync('/dev/stdin', 'utf8').trim().split('\n').filter(Boolean);
+const index = parseInt(process.env.SHARD_INDEX);
+const total = parseInt(process.env.SHARD_TOTAL);
+
+if (isNaN(index) || isNaN(total) || total <= 0) {
+    console.error('SHARD_INDEX and SHARD_TOTAL environment variables must be set to valid integers');
+    process.exit(1);
+}
+
+lines.forEach((line, i) => {
+    if (i % total === index) console.log(line);
+});

.github/scripts/test.sh

@@ -0,0 +1,154 @@
+#!/bin/bash
+
+# GitHub Actions version of .circleci/test.sh
+# Replaces `circleci tests split` with split_files.mjs
+
+set +e
+set +o pipefail
+
+ROOT=$(dirname $0)/../..
+SPLIT="$ROOT/.github/scripts/split_files.mjs"
+EXIT_STATE=0
+MAX_AUTO_RETRY=0
+
+log () {
+    echo -e "\n$1"
+}
+
+# inspired by https://unix.stackexchange.com/a/82602
+retry () {
+    local n=1
+
+    until [ $n -ge $MAX_AUTO_RETRY ]; do
+        "$@" --failFast && break
+        log "run $n of $MAX_AUTO_RETRY failed, trying again ..."
+        n=$[$n+1]
+    done
+
+    if [ $n -eq $MAX_AUTO_RETRY ]; then
+        log "one last time, w/o failing fast"
+        "$@" && n=0
+    fi
+
+    if [ $n -eq $MAX_AUTO_RETRY ]; then
+        log "all $n runs failed, moving on."
+        EXIT_STATE=1
+    fi
+}
+
+# Ensure output directories exist (not present in fresh GHA checkout)
+mkdir -p build/test_images
+
+case $1 in
+
+    no-gl-jasmine)
+        SUITE=$(ls -1 $ROOT/test/jasmine/tests/* | sort | node "$SPLIT")
+        MAX_AUTO_RETRY=2
+        retry npm run test-jasmine -- $SUITE --skip-tags=gl,noCI,flaky || EXIT_STATE=$?
+
+        exit $EXIT_STATE
+        ;;
+
+    webgl-jasmine)
+        SHARDS=($(node $ROOT/tasks/shard_jasmine_tests.js --limit=5 --tag=gl | node "$SPLIT"))
+        for s in ${SHARDS[@]}; do
+            MAX_AUTO_RETRY=2
+            retry npm run test-jasmine -- "$s" --tags=gl --skip-tags=noCI --doNotFailOnEmptyTestSuite
+        done
+
+        exit $EXIT_STATE
+        ;;
+
+    virtual-webgl-jasmine)
+        SHARDS=($(node $ROOT/tasks/shard_jasmine_tests.js --limit=5 --tag=gl | node "$SPLIT"))
+        for s in ${SHARDS[@]}; do
+            MAX_AUTO_RETRY=2
+            retry ./node_modules/karma/bin/karma start test/jasmine/karma.conf.js --virtualWebgl --tags=gl --skip-tags=noCI,noVirtualWebgl --doNotFailOnEmptyTestSuite -- "$s"
+        done
+
+        exit $EXIT_STATE
+        ;;
+
+    flaky-no-gl-jasmine)
+        SHARDS=($(node $ROOT/tasks/shard_jasmine_tests.js --limit=1 --tag=flaky | node "$SPLIT"))
+
+        for s in ${SHARDS[@]}; do
+            MAX_AUTO_RETRY=5
+            retry npm run test-jasmine -- "$s" --tags=flaky --skip-tags=noCI
+        done
+
+        exit $EXIT_STATE
+        ;;
+
+    bundle-jasmine)
+        npm run test-bundle || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    mathjax-firefox)
+        ./node_modules/karma/bin/karma start test/jasmine/karma.conf.js --FF --bundleTest=mathjax --nowatch || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    mathjax-firefox)
+        ./node_modules/karma/bin/karma start test/jasmine/karma.conf.js --FF --bundleTest=mathjax --nowatch &&
+        ./node_modules/karma/bin/karma start test/jasmine/karma.conf.js --FF --bundleTest=mathjax --mathjax3 --nowatch &&
+        ./node_modules/karma/bin/karma start test/jasmine/karma.conf.js --FF --bundleTest=mathjax_config --mathjax3 --nowatch &&
+        ./node_modules/karma/bin/karma start test/jasmine/karma.conf.js --FF --bundleTest=mathjax_config --nowatch || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    make-baselines-virtual-webgl)
+        SUITE=$({\
+                  find $ROOT/test/image/mocks/gl*     -type f -printf "%f\n"; \
+                  find $ROOT/test/image/mocks/map* -type f -printf "%f\n"; \
+                } | sed 's/\.json$//1' | sort | node "$SPLIT")
+        python test/image/make_baseline.py virtual-webgl $SUITE || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    make-baselines-mathjax3)
+        MATHJAX3_MOCKS=$(jq -r '.compare_mathjax3 | join(" ")' test/image/compare_pixels_collections.json)
+        python test/image/make_baseline.py mathjax3 $MATHJAX3_MOCKS || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    make-baselines-b64)
+        SUITE=$(find $ROOT/test/image/mocks/ -type f -printf "%f\n" | sed 's/\.json$//1' | sort | node "$SPLIT")
+        python test/image/make_baseline.py b64 $SUITE || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    make-baselines)
+        SUITE=$(find $ROOT/test/image/mocks/ -type f -printf "%f\n" | sed 's/\.json$//1' | sort | node "$SPLIT")
+        python test/image/make_baseline.py $SUITE || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    make-exports)
+        python test/image/make_exports.py || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    test-image)
+        node test/image/compare_pixels_test.mjs || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    test-image-mathjax3)
+        node test/image/compare_pixels_test.mjs mathjax3 || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    test-image-virtual-webgl)
+        node test/image/compare_pixels_test.mjs virtual-webgl || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+    source-syntax)
+        npm run lint        || EXIT_STATE=$?
+        npm run test-syntax || EXIT_STATE=$?
+        exit $EXIT_STATE
+        ;;
+
+esac