Tracker v9.2

[ibgreen]

Goal: Production WebGPU support

• Target Date: Q4 2024 - "fast follow" to v9.1 and v9.0

Bugs

• https://github.com/visgl/luma.gl/issues?q=is%3Aissue+is%3Aopen+milestone%3Av9.2

General

• TypeScript v5.6, all "strict" TypeScript options are now applied to all luma.gl modules.
• Website tooling upgrades
• Improved GitHub issue templates
• All examples run on WebGPU
• Documentation improvements (TBD)

Modules

@luma.gl/core

• Texture class refactors completed.
• Move readPixels*() to CommandEncoder and update all usage
• Orthogonalized CommandEncoder/CommandBuffer API @ibgreen

@luma.gl/core/shadertypes

• Update shader module type system to handle arrays and structs
  • Update shader types to handle structs and arrays
  • Re-implement offset generation for plain types using the new shadertypes
  • Implement offset generation for arrays and structs
  • Support multiple lights in lighting module (Leverage new support for "struct / array" uniform type decls in shader modules).

@luma.gl/engine

• AsyncTexture - mipmap generation for WebGPU - P0 @ibgreen
  feat(engine): Programmatic mipmap generation for WebGPU #2272
• ShaderPassRenderer - work on WebGPU and WebGL - P0 @ibgreen

@luma.gl/shadertools

• Fix fp64 under Apple M1 P0 - fp64 shader emulation not working under Apple M1 Max #1764
• Port remaining shader modules to WGSL P0
• Implement simple WebGPU support for constant attributes (generate repeated buffers)
• Define module conventions for WGSL (more limited, cannot inject varyings etc, performance wise too ). Also see common extensions for wgsl #2246

@luma.gl/effects

• All postprocessing effects ported to WGSL (in progress) P0

@luma.gl/gltf

• PBR lighting now supported on WebGPU (in progress)
• glTF now supported on WebGPU (in progress)
• Tracker: v9 glTF support #1847

@luma.gl/webgl

• Remove webgl-texture-utils.ts P0

@luma.gl/webgpu

• Add WebGPU validation code to all Device Resource classes P2

Docs

• api guide shaderlayout - probably needs a pass to align with latest API
• api guide bindings - likely needs a pass
• engine BufferTransform / TextureTransform docs - @donmccurdy
• engine Model docs have never been good - arguably the most important page in the docs
• gltf @luma.gl/gltf module docs - @felixpalmer
• tutorials - need to be ported to v9 (currently marked as outdated

Tests

• Restore all luma.gl render tests (update golden images?) - P2 - @Pessimistress ?
• Tests: Port all classic webgl test suites to core classes - P2

Deprecations

• Remove Model.updateModuleSettings.
• Remove device.setGLParameters & Co
• ...

Website / Examples

• Website: (<DeviceTabs /> issue - Switching to WebGPU tab in one example should not persist when switching to non-WebGPU enabled example
• Examples: Fix api/cubemap projection angles in WebGPU
• Examples: Port showcase/instancing
  • Use dirlight module
  • Implement cube picking
• Examples: Port showcase/persistence
• Examples: Restore glfx example (so that we can test / showcase postprocessing modules) - P1 - TBD