[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/tgpu-gen@6a89b089b15813607016df42afac33a5dfb07666

https://pkg.pr.new/software-mansion/TypeGPU/typegpu@6a89b089b15813607016df42afac33a5dfb07666

https://pkg.pr.new/software-mansion/TypeGPU/@typegpu/cli@6a89b089b15813607016df42afac33a5dfb07666

https://pkg.pr.new/software-mansion/TypeGPU/@typegpu/color@6a89b089b15813607016df42afac33a5dfb07666

https://pkg.pr.new/software-mansion/TypeGPU/@typegpu/gl@6a89b089b15813607016df42afac33a5dfb07666

https://pkg.pr.new/software-mansion/TypeGPU/@typegpu/radiance-cascades@6a89b089b15813607016df42afac33a5dfb07666

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	355	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 [0.61, 1.21, 2.34, 3.97, 4.50, 7.40, 14.20, 15.48]
  line [0.57, 1.12, 2.33, 3.72, 3.65, 7.46, 14.25, 15.83]
  line [0.56, 1.04, 2.19, 3.87, 3.65, 6.23, 13.49, 13.18]

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.15, 0.30, 0.41, 0.50, 0.66, 0.68, 0.92, 0.95]
  line [0.15, 0.28, 0.38, 0.44, 0.60, 0.65, 0.75, 0.87]
  line [0.20, 0.30, 0.40, 0.50, 0.64, 0.59, 0.72, 0.81]

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.59, 1.37, 2.60, 3.96, 7.11, 14.97, 33.13, 67.91]
  line [0.61, 1.35, 2.23, 4.03, 7.74, 14.89, 32.09, 64.33]
  line [0.47, 1.25, 1.97, 3.85, 7.19, 14.05, 31.54, 61.30]

Loading

[pullfrog]

✅ No new issues found.

Reviewed changes

This run reviewed the full @typegpu/geometry docs PR against its stacked base feat/geometry-patches, including the interactive preview runtime and its regression test.

• Docs guide (typegpu-geometry.mdx) — 558-line guide covering primitives, parametric surfaces, triangular patches, custom geometry, combinators, baking/updating and lines/joins/caps; prose claims spot-checked against packages/typegpu-geometry/src.
• Preview viewer (viewer.ts, renderer.ts, shaders.ts, demos.ts) — shared-root WebGPU viewer with visibility/pause gating, per-schema pipeline caching, deferred resource cleanup and five demo scenes.
• React shell (MeshPreview.tsx) — param/shading/pause controls plus loading and error states.
• Docs nav (astro.config.mjs) — DEV-gated @typegpu/geometry sidebar entry with a dev badge.
• Regression test (mesh-preview.test.ts) — pins that a bake in flight at disposal submits before its uniforms are destroyed.

  ^{｜ View workflow run ｜ Using deepseek-v4.1-flash (free via Pullfrog for OSS) ｜ 𝕏}

[Copilot]

🟡 Changes recommended

The line-rendering example leaves its control points uninitialized, so it renders no visible line.

1 open issue

• Populate control-point buffer before drawing · New

What changed in this PR

Adds an @typegpu/geometry guide with interactive mesh previews, extending the documentation to cover the triangular patches introduced in #3014.

Changes:

• Documents primitives, composition, custom attributes, mesh evaluation and updates, and line rendering.
• Adds configurable previews with smooth, flat, and wireframe shading.
• Adds a disposal regression test and development-only sidebar navigation.

File	Description
apps/​typegpu-docs/​tests/​individual-example-tests/​mesh-preview.test.ts	Tests disposal while asynchronous baking is pending.
apps/​typegpu-docs/​src/​content/​docs/​ecosystem/​typegpu-geometry.mdx	Adds the geometry guide and embedded previews.
apps/​typegpu-docs/​src/​components/​geometry/​viewer.ts	Manages preview state, animation, baking, and cleanup.
apps/​typegpu-docs/​src/​components/​geometry/​shaders.ts	Defines lighting and shading modes.
apps/​typegpu-docs/​src/​components/​geometry/​renderer.ts	Handles render pipelines, camera updates, and depth textures.
apps/​typegpu-docs/​src/​components/​geometry/​MeshPreview.tsx	Adds preview controls and visibility handling.
apps/​typegpu-docs/​src/​components/​geometry/​demos.ts	Defines configurable geometry demonstrations.
apps/​typegpu-docs/​astro.config.mjs	Adds the development-only geometry sidebar entry.

_{Review effort: Balanced}

[pullfrog]

✅ No new issues found.

Reviewed changes

This run re-reviewed the delta since the prior pullfrog review: the branch was rebased onto the latest feat/geometry-patches tip and its preview code and guide snippets were migrated off the deprecated unstable command-encoder API.

• Stable encoder migration — viewer.ts and the two typegpu-geometry.mdx snippets now call the stable root.createCommandEncoder() instead of root['~unstable'].createCommandEncoder(). The unstable overload is deprecated in favour of the stable method, so the swap is equivalent, and no ~unstable usages remain in the PR.

  ^{｜ View workflow run ｜ Using deepseek-v4.1-flash (free via Pullfrog for OSS) ｜ 𝕏}