// deck.gl // SPDX-License-Identifier: MIT // Copyright (c) vis.gl contributors import {getVitestConfig} from '@vis.gl/dev-tools'; import {TestUserConfig} from 'vitest/config'; import {playwright} from '@vitest/browser-playwright'; const renderTestDeviceValue = process.env.RENDER_TEST_DEVICE; const renderTestDevice = renderTestDeviceValue === 'null' ? undefined : renderTestDeviceValue; if (renderTestDevice && renderTestDevice !== 'webgl' && renderTestDevice !== 'webgpu') { throw new Error(`Invalid RENDER_TEST_DEVICE: ${renderTestDevice}`); } const chromiumLaunchArgs = ['--use-angle=swiftshader', '--enable-unsafe-swiftshader']; const chromiumGpuLaunchArgs = renderTestDevice === 'webgl' ? chromiumLaunchArgs : [ ...chromiumLaunchArgs, '--enable-unsafe-webgpu', '--ignore-gpu-blocklist', '--enable-gpu', '--enable-features=Vulkan', '--use-vulkan=swiftshader' ]; const renderTestDefine = { 'import.meta.env.RENDER_TEST_DEVICE': JSON.stringify(renderTestDevice ?? null) }; const headlessPlaywright = playwright({ launchOptions: { args: chromiumGpuLaunchArgs } }); const browserPlaywright = playwright({ launchOptions: { args: chromiumLaunchArgs }, contextOptions: { viewport: {width: 1280, height: 720}, deviceScaleFactor: 1 } }); // Playwright provider with viewport configured for render tests const renderPlaywright = playwright({ launchOptions: { args: chromiumGpuLaunchArgs }, contextOptions: { viewport: {width: 1024, height: 768} } }); import {resolve} from 'path'; import {browserCommands} from './test/setup/browser-commands'; const rootDir = import.meta.dirname; // These prototypes require locally linked, unpublished luma.gl peers. const includePrivateModules = process.env.DECK_GL_PRIVATE_MODULES === 'true'; const privateNodeTests = includePrivateModules ? ['modules/proposals/test/effects/**/*.node.spec.ts', 'modules/proposals/test/layers/**/*.node.spec.ts'] : []; const privateBrowserTests = includePrivateModules ? ['modules/proposals/test/effects/**/*.spec.ts', 'modules/proposals/test/layers/**/*.spec.ts'] : []; // Tests that were commented out or never imported in the original test suite // These need to be fixed before being included const excludedTests = [ 'test/modules/carto/index.spec.ts', 'test/modules/layers/path-tesselator.spec.ts', 'test/modules/layers/polygon-tesselation.spec.ts', 'test/modules/widgets/geocoders.spec.ts', // Mask tests were commented out on master (luma.gl v9 uniforms API change) 'test/modules/extensions/mask/mask.spec.ts', 'test/modules/extensions/mask/mask-pass.spec.ts', // Commented out on master - Transform not exported from @luma.gl/engine 'test/modules/layers/path-layer/path-layer-vertex.spec.ts', // Commented out on master - collision-filter extension test 'test/modules/extensions/collision-filter/collision-filter.spec.ts' ]; // Match aliases from .ocularrc.js // Note: Order matters for Vite - more specific paths must come before less specific ones const aliases = { '@deck.gl/proposals/layers/path-layer': resolve(rootDir, 'modules/proposals/src/layers/path-layer/path-layer.ts'), '@deck.gl/proposals/layers/polygon-layer': resolve(rootDir, 'modules/proposals/src/layers/polygon-layer/polygon-layer.ts'), '@deck.gl/proposals/layers/solid-polygon-layer': resolve(rootDir, 'modules/proposals/src/layers/solid-polygon-layer/solid-polygon-layer.ts'), '@deck.gl/proposals/layers/text-layer': resolve(rootDir, 'modules/proposals/src/layers/text-layer/text-layer.ts'), '@deck.gl/proposals/effects/query': resolve(rootDir, 'modules/proposals/src/effects/query'), '@deck.gl/proposals/layers': resolve(rootDir, 'modules/proposals/src/layers'), '@deck.gl/proposals/effects': resolve(rootDir, 'modules/proposals/src/effects'), // Explicit vitest entry point (must come before @deck.gl/test-utils) '@deck.gl/test-utils/vitest': resolve(rootDir, 'modules/test-utils/src/vitest.ts'), '@deck.gl/aggregation-layers': resolve(rootDir, 'modules/aggregation-layers/src'), '@deck.gl/arcgis': resolve(rootDir, 'modules/arcgis/src'), '@deck.gl/carto': resolve(rootDir, 'modules/carto/src'), '@deck.gl/core/sql': resolve(rootDir, 'modules/core/src/arrow/upstream-math/sql-parser.ts'), '@deck.gl/core/arrow': resolve(rootDir, 'modules/core/src/arrow/upstream-luma/arrow-converter.ts'), '@deck.gl/core': resolve(rootDir, 'modules/core/src'), '@deck.gl/extensions': resolve(rootDir, 'modules/extensions/src'), '@deck.gl/geo-layers': resolve(rootDir, 'modules/geo-layers/src'), '@deck.gl/google-maps': resolve(rootDir, 'modules/google-maps/src'), '@deck.gl/json': resolve(rootDir, 'modules/json/src'), '@deck.gl/jupyter-widget': resolve(rootDir, 'modules/jupyter-widget/src'), '@deck.gl/layers': resolve(rootDir, 'modules/layers/src'), '@deck.gl/mapbox': resolve(rootDir, 'modules/mapbox/src'), '@deck.gl/maplibre': resolve(rootDir, 'modules/maplibre/src'), '@deck.gl/mesh-layers': resolve(rootDir, 'modules/mesh-layers/src'), '@deck.gl/react/legacy': resolve(rootDir, 'modules/react/src/legacy'), '@deck.gl/react': resolve(rootDir, 'modules/react/src'), '@deck.gl/test-utils': resolve(rootDir, 'modules/test-utils/src'), '@deck.gl/widgets': resolve(rootDir, 'modules/widgets/src'), 'deck.gl': resolve(rootDir, 'modules/main/src'), 'deck.gl-test': resolve(rootDir, 'test') }; // Linked private luma.gl peers must share resource classes and Arrow types with deck.gl. const linkedPeerDedupe = ['@luma.gl/core', '@luma.gl/engine', '@luma.gl/graph', '@luma.gl/shaders', 'apache-arrow']; // Browser aliases - redirect @deck.gl/test-utils to vitest entry for backwards compatibility // until all tests are migrated to import from @deck.gl/test-utils/vitest explicitly const browserAliases = { ...aliases, '@deck.gl/test-utils': resolve(rootDir, 'modules/test-utils/src/vitest.ts') }; // Shared coverage configuration const coverageConfig: TestUserConfig["coverage"] = { provider: 'v8' as const, reporter: ['text', 'lcov'], include: ['modules/*/src/**/*.ts'], exclude: ['modules/test-utils/**', '**/node_modules/**', ...(includePrivateModules ? [] : ['modules/proposals/**'])] }; // Pre-bundle dependencies to avoid Vite reloading during tests // This prevents flaky tests caused by runtime dependency discovery const optimizeDepsConfig = { include: [ // Preact JSX runtime discovered at runtime 'preact/jsx-dev-runtime', 'preact/jsx-runtime', // Vitest browser dependencies 'vitest/browser', // luma.gl WebGL dependencies '@luma.gl/core', '@luma.gl/engine', '@luma.gl/core/webgl', '@luma.gl/shaders', '@luma.gl/engine/effects', '@luma.gl/graph/gpu-graph', 'maplibre-gl-v4', 'maplibre-gl-v5', // loaders.gl dependencies '@loaders.gl/core/scan', '@math.gl/sql/arrow', '@math.gl/sql/parser', '@loaders.gl/core/polyfills', '@loaders.gl/core', '@loaders.gl/images', 'd3-hexbin', // React renderer dependencies, used by the @deck.gl/react browser tests 'react', 'react-dom/client', 'react/jsx-dev-runtime', 'react/jsx-runtime', 'react-reconciler', 'react-reconciler/constants.js', 'its-fine', 'client-only', 'fast-check', 'mapbox-gl', 'maplibre-gl' ], // MapLibre v6 is native ESM. Add future ESM-only major aliases here. exclude: ['maplibre-gl-v6'] }; // Server configuration for serving test data files with correct MIME types // Without this, binary files like .mvt may be served incorrectly const serverConfig = { fs: { // Allow serving files from test/data directory allow: [rootDir] } }; // Include binary file extensions as static assets // This ensures Vite serves them with correct MIME types const assetsIncludeConfig = [ '**/*.mvt', // Mapbox Vector Tiles '**/*.pbf', // Protocol Buffers '**/*.glb', // glTF Binary '**/*.gltf', // glTF '**/*.bin', // Binary data '**/*.terrain' // Terrain files ]; const projects = [ // Node project - simple smoke tests (*.node.spec.ts only) // Used by test-fast for quick validation { extends: true, resolve: {alias: aliases, dedupe: includePrivateModules ? linkedPeerDedupe : []}, test: { name: 'node', environment: 'node', include: ['test/modules/**/*.node.spec.ts', ...privateNodeTests], globals: false, testTimeout: 30000, setupFiles: ['./test/setup/vitest-node-setup.ts'], // Unique sequence order for running multiple projects together sequence: {groupOrder: 1} }, }, // React project - the React renderer's unit tests (`*.test.ts(x)`) in jsdom, plus its type // tests (`*.test-d.ts(x)`). Each file is isolated because these tests mock modules. The // renderer's browser tests are `*.spec.tsx` files in the headless project. { extends: true, resolve: {alias: aliases}, test: { name: 'react', environment: 'jsdom', include: ['test/modules/react/fiber/**/*.test.{ts,tsx}'], globals: false, testTimeout: 30000, typecheck: { enabled: true, include: ['test/modules/react/fiber/**/*.test-d.{ts,tsx}'], tsconfig: './test/modules/react/fiber/tsconfig.json' }, sequence: {groupOrder: 1} } }, // Scripts project - codemod and build tool tests // Used by test-scripts { extends: true, test: { name: 'scripts', environment: 'node', include: ['scripts/**/*.spec.ts'], globals: false, testTimeout: 30000, // Unique sequence order for running multiple projects together sequence: {groupOrder: 0} } }, // Tape compatibility project - verifies the legacy @deck.gl/test-utils entry point { extends: true, resolve: {alias: aliases}, test: { name: 'tape-compat', environment: 'node', include: ['test/smoke/**/*.tape.spec.js'], globals: false, testTimeout: 30000, setupFiles: ['./test/setup/vitest-node-setup.ts'], sequence: {groupOrder: 0} } }, // Headless project - unit tests in headless browser // Used by test-headless and test-ci { extends: true, define: {...renderTestDefine}, resolve: {alias: browserAliases, dedupe: includePrivateModules ? linkedPeerDedupe : []}, optimizeDeps: optimizeDepsConfig, assetsInclude: assetsIncludeConfig, server: serverConfig, test: { name: 'headless', // Temporarily exclude the full interaction suite from required // automated runs. These browser-input tests have become flaky across // headless and render, so keep them in `browser` only for manual // debugging until the shared interaction harness is reworked. include: ['test/modules/**/*.spec.ts', 'test/modules/react/**/*.spec.tsx', ...privateBrowserTests], exclude: [ ...excludedTests, 'test/modules/**/*.node.spec.ts', 'modules/proposals/test/effects/**/*.node.spec.ts', 'modules/proposals/test/layers/**/*.node.spec.ts' ], globals: false, testTimeout: 30000, // Disable isolation and file parallelism to avoid: // 1. Re-initializing WebGL/luma.gl for each test file (1090s -> 2s import time) // 2. WebGL context contention when running many tests in parallel isolate: false, fileParallelism: false, setupFiles: ['./test/setup/vitest-browser-setup.ts'], browser: { enabled: true, provider: headlessPlaywright, instances: [{browser: 'chromium'}], headless: true, screenshotFailures: false, commands: browserCommands }, // Unique sequence order for running multiple projects together sequence: {groupOrder: 2} } }, // Browser project - headed browser for debugging unit and interaction tests locally. // Render/golden-image comparisons use the separate `render` project below. // Used by test-browser { extends: true, resolve: {alias: browserAliases, dedupe: includePrivateModules ? linkedPeerDedupe : []}, optimizeDeps: optimizeDepsConfig, assetsInclude: assetsIncludeConfig, server: serverConfig, test: { name: 'browser', include: ['test/modules/**/*.spec.ts', 'test/modules/react/**/*.spec.tsx', 'test/interaction/**/*.spec.ts', ...privateBrowserTests], exclude: [...excludedTests, 'test/modules/**/*.node.spec.ts', 'modules/proposals/test/effects/**/*.node.spec.ts', 'modules/proposals/test/layers/**/*.node.spec.ts'], globals: false, testTimeout: 30000, isolate: false, fileParallelism: false, setupFiles: ['./test/setup/vitest-browser-setup.ts'], browser: { enabled: true, provider: browserPlaywright, instances: [{browser: 'chromium'}], headless: false, ui: false, screenshotFailures: false, commands: browserCommands }, // Unique sequence order for running multiple projects together sequence: {groupOrder: 3} } }, // Render project - visual regression and interaction tests (separate from headless for easier debugging) // Used by test-render { extends: true, define: renderTestDefine, resolve: {alias: browserAliases}, optimizeDeps: optimizeDepsConfig, assetsInclude: assetsIncludeConfig, server: serverConfig, test: { name: 'render', // Temporarily exclude the full interaction suite from required // automated runs. Keep render focused on visual regression until the // flaky browser-input specs are stabilized in a later pass. include: ['test/render/**/*.spec.ts'], globals: false, testTimeout: 300000, // Render tests need longer timeout isolate: false, fileParallelism: false, setupFiles: ['./test/setup/vitest-browser-setup.ts'], browser: { enabled: true, provider: renderPlaywright, instances: [ { browser: 'chromium', viewport: {width: 1024, height: 768} } ], headless: true, screenshotFailures: false, commands: browserCommands }, // Unique sequence order for running multiple projects together sequence: {groupOrder: 4} } } ]; export default getVitestConfig({ coverage: coverageConfig, projects: Object.fromEntries(projects.map(project => [project.test.name, project])) });