docs: Add @typegpu/geometry docs with interactive previews

[reczkok]

Adds a guide for @typegpu/geometry, covering mesh creation, composition and the different ways to evaluate and update geometry

• primitives, parametric surfaces + custom geometry
• transform, concat and custom vertex attributes
• bake into buffers, evaluate in vertex shaders or update through compute
• interactive previews for subdivisions, surface parameters, vertex colors and deformation
• smooth, flat and wireframe shading to inspect the results

Stacks on #3014

[github-actions]

pkg.pr.new

packages
Ready to be installed by your favorite package manager ⬇️

https://pkg.pr.new/software-mansion/TypeGPU/typegpu@24626f1d7e0599cd5b0d194bc994fe5045b47085

https://pkg.pr.new/software-mansion/TypeGPU/@typegpu/cli@24626f1d7e0599cd5b0d194bc994fe5045b47085

https://pkg.pr.new/software-mansion/TypeGPU/@typegpu/gl@24626f1d7e0599cd5b0d194bc994fe5045b47085

benchmark
view benchmark

commit
view commit

[github-actions]

Bundle size comparison (import * as ... in PR vs import * as ... in target):

🟢 Decreased	➖ Unchanged	🔴 Increased	❔ Unknown
0	325	0	0

No notable changes.

If you wish to run a comparison for other, slower bundlers, run the 'Tree-shake test' from the GitHub Actions menu.

[github-actions]

Resolution Time Benchmark

---
config:
  themeVariables:
    xyChart:
      plotColorPalette: "#E63946, #3B82F6, #059669"
---
xychart
  title "Random Branching (🔴 PR | 🔵 main | 🟢 release)"
  x-axis "max depth" [1, 2, 3, 4, 5, 6, 7, 8]
  y-axis "time (ms)"
  line [1.03, 2.04, 4.38, 6.99, 8.69, 12.63, 24.51, 25.73]
  line [0.98, 1.94, 4.37, 7.07, 7.47, 12.93, 24.61, 26.20]
  line [0.99, 2.03, 4.12, 6.77, 8.41, 10.85, 24.47, 24.76]

Loading

---
config:
  themeVariables:
    xyChart:
      plotColorPalette: "#E63946, #3B82F6, #059669"
---
xychart
  title "Linear Recursion (🔴 PR | 🔵 main | 🟢 release)"
  x-axis "max depth" [1, 2, 3, 4, 5, 6, 7, 8]
  y-axis "time (ms)"
  line [0.32, 0.58, 0.75, 0.89, 1.19, 1.24, 1.45, 1.62]
  line [0.28, 0.48, 0.69, 0.83, 1.13, 1.24, 1.43, 1.56]
  line [0.30, 0.53, 0.75, 0.85, 1.21, 1.24, 1.42, 1.59]

Loading

---
config:
  themeVariables:
    xyChart:
      plotColorPalette: "#E63946, #3B82F6, #059669"
---
xychart
  title "Full Tree (🔴 PR | 🔵 main | 🟢 release)"
  x-axis "max depth" [1, 2, 3, 4, 5, 6, 7, 8]
  y-axis "time (ms)"
  line [0.86, 2.20, 4.21, 8.00, 12.89, 27.68, 59.20, 118.98]
  line [0.90, 2.25, 3.59, 7.48, 13.17, 27.79, 56.86, 114.25]
  line [0.93, 2.29, 3.59, 7.48, 12.91, 27.93, 56.92, 117.80]

Loading