Update Vite toolchain and fix workspace source resolution for local dev

.github/workflows/docs.yml

@@ -26,9 +26,13 @@ jobs:
       - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v4
         with:
-          version: 10
+          run_install: false
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24.14.1'
+          cache: 'pnpm'
       - run: |
-          pnpm install
+          pnpm install --frozen-lockfile
           pnpm build
           pnpm docs:build
       - uses: actions/upload-pages-artifact@v3
@@ -44,4 +48,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v4

.github/workflows/test.yml

@@ -21,12 +21,11 @@ jobs:
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
         with:
-          version: 10
           run_install: false
 
       - uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24.14.1'
           cache: 'pnpm'
 
       - uses: astral-sh/setup-uv@v4
@@ -89,4 +88,4 @@ jobs:
           pnpm test:integration
 
           # Clean up server
-          kill "$SERVER_PID" || true
+          kill "$SERVER_PID" || true

.gitignore

@@ -6,6 +6,8 @@ node_modules/
 dist/
 build/
 *.tsbuildinfo
+packages/zarrextra/src/*.d.ts
+packages/zarrextra/src/*.d.ts.map
 
 # Testing
 coverage/

README.md

@@ -16,16 +16,20 @@ This monorepo contains:
 
 ### Prerequisites
 
-- Node.js >= 20
-- pnpm >= 10
+- [Volta](https://volta.sh/) for managing the pinned Node.js and pnpm versions
 - Python >= 3.12 (for generating test fixtures)
 - [uv](https://github.com/astral-sh/uv) (Python package manager)
 
+If you prefer not to use Volta, use Node.js >= 20.19 (or 22.12+) and pnpm >= 10.
+
 ### Installation
 
 ```bash
-# Install pnpm globally if you haven't already
-npm install -g pnpm
+# Install Volta once
+curl https://get.volta.sh | bash
+
+# Restart your shell so Volta is on PATH
+volta install node@24.14.1 pnpm@10.33.0
 
 # Install dependencies
 pnpm install

package.json

@@ -8,7 +8,9 @@
     "type": "git",
     "url": "https://github.com/Taylor-CCB-Group/SpatialData.js.git"
   },
+  "packageManager": "pnpm@10.33.0",
   "scripts": {
+    "clean": "rm -rf packages/*/dist packages/vis/demo/dist packages/zarrextra/src/*.d.ts packages/zarrextra/src/*.d.ts.map",
     "build": "pnpm -r --filter='!docs' run build",
     "test": "pnpm -r --filter='!docs' run test",
     "test:unit": "vitest run --exclude tests/integration/**",
@@ -37,7 +39,11 @@
     "typescript": "catalog:"
   },
   "engines": {
-    "node": ">=20",
+    "node": ">=20.19",
     "pnpm": ">=10"
+  },
+  "volta": {
+    "node": "24.14.1",
+    "pnpm": "10.33.0"
   }
 }

packages/layers/vite.config.ts

@@ -1,5 +1,5 @@
 import { resolve } from 'node:path';
-import { defineConfig } from 'vite';
+import { defineConfig } from 'vitest/config';
 import dts from 'vite-plugin-dts';
 
 export default defineConfig({

packages/react/tsconfig.json

@@ -15,12 +15,13 @@
     "baseUrl": ".",
     "paths": {
       "@spatialdata/core": ["../core/src/index.ts"],
-      "@spatialdata/core/*": ["../core/src/*"]
+      "@spatialdata/core/*": ["../core/src/*"],
+      "@spatialdata/zarrextra": ["../zarrextra/src/index.ts"],
+      "@spatialdata/zarrextra/*": ["../zarrextra/src/*"]
     },
     "types": ["react", "react-dom"]
   },
   "include": ["src", "vite.config.ts"],
   "exclude": ["dist", "node_modules"]
 }
 
-

packages/vis/demo/tsconfig.json

@@ -13,6 +13,7 @@
     "isolatedModules": true,
     "noEmit": true,
     "jsx": "react-jsx",
+    "baseUrl": ".",
 
     /* Linting */
     "strict": true,
@@ -21,7 +22,12 @@
     "noFallthroughCasesInSwitch": true,
 
     "paths": {
-      "@spatialdata/vis": ["../src"]
+      "@spatialdata/avivatorish": ["../../avivatorish/src/index.ts"],
+      "@spatialdata/core": ["../../core/src/index.ts"],
+      "@spatialdata/layers": ["../../layers/src/index.ts"],
+      "@spatialdata/react": ["../../react/src/index.ts"],
+      "@spatialdata/vis": ["../src/index.ts"],
+      "@spatialdata/zarrextra": ["../../zarrextra/src/index.ts"]
     }
   },
   "include": ["src"]

packages/vis/tsconfig.json

@@ -17,12 +17,13 @@
       "@spatialdata/core": ["../core/src/index.ts"],
       "@spatialdata/core/*": ["../core/src/*"],
       "@spatialdata/react": ["../react/src/index.ts"],
-      "@spatialdata/react/*": ["../react/src/*"]
+      "@spatialdata/react/*": ["../react/src/*"],
+      "@spatialdata/zarrextra": ["../zarrextra/src/index.ts"],
+      "@spatialdata/zarrextra/*": ["../zarrextra/src/*"]
     },
     "types": ["react", "react-dom"]
   },
   "include": ["src", "vite.config.ts"],
   "exclude": ["dist", "node_modules"]
 }
 
-

packages/vis/vite.config.demo.ts

@@ -1,15 +1,25 @@
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
 import path from 'node:path';
+import { createRequire } from 'node:module';
+import { createWorkspaceSourceAliases } from '../../vite.config.base';
 
 // https://vitejs.dev/config/
+const workspaceRoot = path.resolve(__dirname, '../..');
+const require = createRequire(import.meta.url);
+const reactRoot = path.dirname(require.resolve('react/package.json'));
+const reactDomRoot = path.dirname(require.resolve('react-dom/package.json'));
+
 export default defineConfig({
   root: path.resolve(__dirname, 'demo'),
   plugins: [react()],
   resolve: {
     alias: {
-      '@spatialdata/vis': path.resolve(__dirname, 'src'),
+      ...createWorkspaceSourceAliases(workspaceRoot),
+      react: reactRoot,
+      'react-dom': reactDomRoot,
     },
+    dedupe: ['react', 'react-dom'],
   },
   server: {
     open: true,