Improve rendering pipeline

.github/workflows/checks.yml

@@ -0,0 +1,95 @@
+# This workflow performs basic checks:
+#
+#   1. run a preparation step to install and cache node modules
+#   2. once prep succeeds, lint and test run in parallel
+#
+# The checks only run on non-draft Pull Requests. They don't run on the main
+# branch prior to deploy. It's recommended to use branch protection to avoid
+# pushes straight to 'main'.
+
+name: Checks
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+      - ready_for_review
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  prep:
+    if: github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Use Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version-file: '.nvmrc'
+
+      - name: restore lerna
+        uses: actions/cache@v5
+        with:
+          path: '**/node_modules'
+          key: ${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
+
+      - name: Install
+        run: npm install
+
+  lint:
+    needs: prep
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Use Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version-file: '.nvmrc'
+
+      - name: restore lerna
+        uses: actions/cache@v5
+        with:
+          path: '**/node_modules'
+          key: ${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
+
+      - name: Install
+        run: npm install
+
+      - name: Lint
+        run: npm run lint
+
+  test:
+    needs: prep
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Use Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version-file: '.nvmrc'
+
+      - name: restore lerna
+        uses: actions/cache@v5
+        with:
+          path: '**/node_modules'
+          key: ${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
+
+      - name: Install
+        run: npm install
+
+      - name: Test
+        run: npm run test

.github/workflows/docs.yml

@@ -0,0 +1,78 @@
+name: Deploy Docs
+
+on:
+  push:
+    tags:
+      - "v*"
+      - "!v*-alpha*"
+      - "!v*-beta*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+env:
+  VITE_MAPTILER_KEY: ${{ secrets.MAPTILER_KEY }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Use Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version-file: '.nvmrc'
+          cache: npm
+
+      - name: Install
+        run: npm i
+
+      - name: Build packages
+        run: npm run build -- --scope '@developmentseed/*'
+
+      - name: Build examples
+        run: |
+          mkdir -p dist/examples
+          for dir in examples/*/; do
+            example=$(basename "$dir")
+            if [[ "$example" == "_shared" ]]; then
+              continue
+            fi
+
+            echo "Building example: $example"
+            cd $dir
+            cp .env.example .env
+            export VITE_BASE_URL=https://deck.gl-healpix.ds.io/examples/$example
+            npm run build
+            cd ../..
+            echo "Copying example: $example"
+            mkdir -p "dist/examples/${example}"
+            cp -r "${dir}dist/." "dist/examples/${example}/"
+          done
+
+      - name: Copy 404.html
+        run: cp examples/_shared/404.html dist/404.html
+
+      - uses: actions/upload-pages-artifact@v4
+        with:
+          path: dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5

.gitignore

@@ -36,3 +36,5 @@ yarn-error.log*
 
 # Auto-generated for GPU readback tests (`npm run gen:gpu-shaders`)
 test/gpu/shader-chunks.gen.mjs
+
+docs/superpowers/plans

README.md

@@ -12,7 +12,7 @@ https://github.com/user-attachments/assets/4166d5d5-65e3-4309-a63a-0a2d0cdf275d
 
 | Package | Description |
 | -------- | ----------- |
-| [`@developmentseed/deck.gl-healpix`](./packages/deck.gl-healpix/) | deck.gl layer for rendering [HEALPix](https://healpix.sourceforge.io/) cells on a map, with GPU-side colormaps and multi-frame animation. |
+| [`@developmentseed/deck.gl-healpix`](./packages/deck.gl-healpix/) | deck.gl layer for rendering [HEALPix](https://healpix.sourceforge.io/) cells on a map, with a GPU color pipeline (filter / rescale / colorMap), multi-frame animation, and pluggable fragment-shader hooks for custom GLSL. |
 
 Each package has its own **README** with installation, API usage, and examples—start there for day-to-day integration work.