feature: add enableGPUCanvas param to allow GPU Canvas content to render for WebGL2 React variant

[zplata]

• Adds the new enableGPUCanvas param for the React runtime. Applicable for the "@rive-app/react-webgl2" builds.
• Because the React runtime defaults the useOffscreenRenderer to true, which is not compatible with the deferred renderer for GPU canvas, we make it false IF the user opts in with enableGPUCanvas: true

[Copilot]

🟢 Approval recommended

The implementation and coverage support the intended behavior, with only non-blocking documentation and warning-text corrections remaining.

Pull request overview

Adds GPU Canvas support for the WebGL2 React runtime while resolving its incompatibility with the offscreen renderer.

Changes:

• Adds and forwards enableGPUCanvas.
• Resolves renderer defaults for GPU Canvas and imported files.
• Adds tests, cleanup safeguards, dependency updates, and a Storybook example.

File summaries

File	Description
src/hooks/useRive.tsx	Resolves renderer mode and safely cleans up instances.
src/hooks/useRiveFile.ts	Re-imports files when GPU Canvas mode changes.
src/components/Rive.tsx	Exposes the new component prop.
src/types.ts	Documents renderer option behavior.
src/utils.ts	Exports defaults and adds safe teardown.
test/useRiveGpuCanvas.test.tsx	Tests renderer-mode resolution.
examples/src/components/GPUCanvasDeferred.tsx	Demonstrates GPU Canvas scenarios.
examples/src/components/GPUCanvasDeferred.stories.ts	Registers the example story.
examples/.storybook/main.ts	Configures WebGL2 for Storybook.
package.json	Updates Rive runtime dependencies.
package-lock.json	Locks updated runtime versions.

Review details

• Files reviewed: 10/13 changed files
• Comments generated: 3
• Review effort level: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[bodymovin]

LGTM