feat(test-utils): Add vitest entry + tape backward compat

[chrisgervang]

Summary

Add vitest support to @deck.gl/test-utils with a new /vitest entry point that uses vi.spyOn by default, enabling vitest users to call testLayer without manual spy factory setup.

No breaking changes - the default entry point remains backward compatible with existing tape/probe.gl tests.

Change List

• Add @deck.gl/test-utils/vitest entry point with vi.spyOn as default spy factory
• Refactor lifecycle-test.ts to accept pluggable SpyFactory
• Default entry continues to use @probe.gl/test-utils makeSpy (backward compat)
• Add smoke tests for both tape-compat and vitest entry paths
• Add vitest as optional peer dependency
• Add compat tests to CI workflow

---

🤖 Generated with Claude Code

---

Note

Medium Risk
Changes @deck.gl/test-utils public test helpers to support pluggable spy implementations (vitest/probe.gl) and adds new CI smoke tests; while largely backwards compatible, it alters lifecycle-test APIs and cleanup behavior that could affect downstream test setups.

Overview
Adds first-class vitest support to @deck.gl/test-utils via a new @deck.gl/test-utils/vitest export that defaults spying to vi.spyOn, while keeping the default entry point tape/probe.gl-compatible through a new tape wrapper.

Refactors lifecycle-test to require injected createSpy/resetSpy functions (instead of directly importing @probe.gl/test-utils), adds async cleanup in testLayerAsync to avoid WebGL teardown races, and introduces new smoke tests plus CI steps (test-tape-compat, test-vitest-smoke) to validate both entry paths.

Updates packaging to export the new entry, adds vitest as an optional peer dependency, and includes supporting config/typings and dependency lockfile updates.

^{Written by Cursor Bugbot for commit c337c4e. This will update automatically on new commits. Configure here.}

[chrisgervang]

Re: Cursor Bugbot comment about missing ./tape export - this is intentional. The default . entry already re-exports from tape.ts with backward compatibility (default spy factory from @probe.gl/test-utils). A separate ./tape export is unnecessary since:

• @deck.gl/test-utils → tape behavior (backward compat, uses makeSpy by default)
• @deck.gl/test-utils/vitest → vitest behavior (uses vi.spyOn by default)

Existing tape/probe.gl users continue using the default import with no changes needed.

[coveralls]

coverage: 91.011%. remained the same
when pulling c337c4e on chr/test-utils-vitest-entry
into aee311f on master.

[cursor]

Probe.gl peer dependency not optional for vitest users

Low Severity

@probe.gl/test-utils remains a required (non-optional) peer dependency, but the new ./vitest entry point is specifically designed to avoid importing probe.gl. Vitest-only users who don't need probe.gl will still receive peer dependency warnings from their package manager. @probe.gl/test-utils needs to be added to peerDependenciesMeta as optional, similar to how vitest is configured.

 

[chrisgervang]

This is intentional since that could be a breaking change to tape users on the next minor release

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

[cursor]

Duplicated cleanup logic across sync and async functions

Low Severity

cleanupAfterLayerTestsAsync duplicates nearly all logic from cleanupAfterLayerTests — the setLayers([]), finalize() calls, and the resource count comparison loop are copy-pasted. The only meaningful difference is the await new Promise(resolve => setTimeout(resolve, 0)) between setLayers and finalize. Extracting the shared resource-checking logic into a helper, or having the async version call the sync one after its await, would reduce the maintenance risk of these diverging over time.

Additional Locations (1)

• modules/test-utils/src/lifecycle-test.ts#L317-L337