docs: Remove "experimental" tag from examples that no longer use unstable APIs (#2232)

iwoplaza · web-flow · commit 52e09afa8043 · 2026-03-03T14:02:51.000+01:00
diff --git a/apps/typegpu-docs/src/components/ExampleCard.tsx b/apps/typegpu-docs/src/components/ExampleCard.tsx
@@ -22,12 +22,12 @@ export function ExampleCard({ example }: { example: Example }) {
       </div>
       <div className="p-3">
         <h3 className="mb-2 font-semibold text-black text-lg">{example.metadata.title}</h3>
-        {example.metadata.tags && example.metadata.tags.length > 0 && (
+        {((example.metadata.tags && example.metadata.tags.length > 0) || example.metadata.dev) && (
           <div className="flex flex-wrap gap-1">
             {example.metadata.dev && (
               <span className="rounded-full bg-rose-700 px-2 py-1 text-white text-xs">DEV</span>
             )}
-            {example.metadata.tags.map((tag: string) => (
+            {(example.metadata.tags ?? []).map((tag: string) => (
               <span
                 key={tag}
                 className="rounded-full bg-indigo-100 px-2 py-1 text-indigo-800 text-xs"
diff --git a/apps/typegpu-docs/src/examples/algorithms/matrix-next/meta.json b/apps/typegpu-docs/src/examples/algorithms/matrix-next/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Matrix Multiplication (next)",
   "category": "algorithms",
-  "tags": ["experimental", "compute", "timestamp query"]
+  "tags": ["compute", "timestamp query"]
 }
diff --git a/apps/typegpu-docs/src/examples/algorithms/mnist-inference/meta.json b/apps/typegpu-docs/src/examples/algorithms/mnist-inference/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "MNIST Inference",
   "category": "algorithms",
-  "tags": ["ai", "compute", "inference", "timestamp query", "subgroups", "experimental"]
+  "tags": ["ai", "compute", "inference", "timestamp query", "subgroups"]
 }
diff --git a/apps/typegpu-docs/src/examples/algorithms/probability/meta.json b/apps/typegpu-docs/src/examples/algorithms/probability/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Probability Distribution Plot",
   "category": "algorithms",
-  "tags": ["experimental", "ecosystem", "@typegpu/noise"]
+  "tags": ["ecosystem", "@typegpu/noise"]
 }
diff --git a/apps/typegpu-docs/src/examples/rendering/box-raytracing/meta.json b/apps/typegpu-docs/src/examples/rendering/box-raytracing/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Box Raytracing",
   "category": "rendering",
-  "tags": ["experimental", "3d", "raytracing"]
+  "tags": ["3d", "raytracing"]
 }
diff --git a/apps/typegpu-docs/src/examples/rendering/caustics/meta.json b/apps/typegpu-docs/src/examples/rendering/caustics/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Caustics",
   "category": "rendering",
-  "tags": ["experimental", "fragment shader"]
+  "tags": ["fragment shader"]
 }
diff --git a/apps/typegpu-docs/src/examples/rendering/perlin-noise/meta.json b/apps/typegpu-docs/src/examples/rendering/perlin-noise/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Perlin Noise",
   "category": "rendering",
-  "tags": ["experimental"]
+  "tags": ["noise"]
 }
diff --git a/apps/typegpu-docs/src/examples/rendering/phong-reflection/meta.json b/apps/typegpu-docs/src/examples/rendering/phong-reflection/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Phong Reflection Model",
   "category": "rendering",
-  "tags": ["experimental", "3d"]
+  "tags": ["3d"]
 }
diff --git a/apps/typegpu-docs/src/examples/rendering/ray-marching/meta.json b/apps/typegpu-docs/src/examples/rendering/ray-marching/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Ray Marching",
   "category": "rendering",
-  "tags": ["experimental", "fragment shader", "shadows", "sdf", "ray marching", "sphere tracing"]
+  "tags": ["fragment shader", "shadows", "sdf", "ray marching", "sphere tracing"]
 }
diff --git a/apps/typegpu-docs/src/examples/rendering/smoky-triangle/meta.json b/apps/typegpu-docs/src/examples/rendering/smoky-triangle/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Smoky Triangle",
-  "category": "simple",
-  "tags": ["experimental"]
+  "category": "rendering",
+  "tags": ["noise"]
 }
diff --git a/apps/typegpu-docs/src/examples/rendering/xor-dev-centrifuge-2/index.ts b/apps/typegpu-docs/src/examples/rendering/xor-dev-centrifuge-2/index.ts
@@ -14,10 +14,6 @@ import tgpu, { d } from 'typegpu';
 import { abs, atan2, cos, gt, length, normalize, select, sign, tanh } from 'typegpu/std';
 import { defineControls } from '../../common/defineControls.ts';
 
-// NOTE: Some APIs are still unstable (are being finalized based on feedback), but
-//       we can still access them if we know what we're doing.
-//       They're going to be moved into `tgpu.` and `root.` in a future version.
-
 /**
  * For some reason, tanh in WebGPU breaks down hard outside
  * of the <10, -10> range.
diff --git a/apps/typegpu-docs/src/examples/rendering/xor-dev-centrifuge-2/meta.json b/apps/typegpu-docs/src/examples/rendering/xor-dev-centrifuge-2/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "XorDev \"Centrifuge 2\"",
   "category": "rendering",
-  "tags": ["experimental", "fragment shader"]
+  "tags": ["fragment shader"]
 }
diff --git a/apps/typegpu-docs/src/examples/rendering/xor-dev-runner/index.ts b/apps/typegpu-docs/src/examples/rendering/xor-dev-runner/index.ts
@@ -17,10 +17,6 @@ import { abs, add, cos, max, min, mul, select, sign, sin, sub, tanh } from 'type
 import { defineControls } from '../../common/defineControls.ts';
 import { Camera, setupFirstPersonCamera } from '../../common/setup-first-person-camera.ts';
 
-// NOTE: Some APIs are still unstable (are being finalized based on feedback), but
-//       we can still access them if we know what we're doing.
-//       They're going to be moved into `tgpu.` and `root.` in a future version.
-
 /**
  * For some reason, tanh in WebGPU breaks down hard outside
  * of the <10, -10> range.
diff --git a/apps/typegpu-docs/src/examples/rendering/xor-dev-runner/meta.json b/apps/typegpu-docs/src/examples/rendering/xor-dev-runner/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "XorDev \"Runner\"",
   "category": "rendering",
-  "tags": ["experimental", "fragment shader", "fractal"]
+  "tags": ["fragment shader", "fractal"]
 }
diff --git a/apps/typegpu-docs/src/examples/simple/increment/meta.json b/apps/typegpu-docs/src/examples/simple/increment/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Increment",
   "category": "simple",
-  "tags": ["compute", "experimental"]
+  "tags": ["compute"]
 }
diff --git a/apps/typegpu-docs/src/examples/simple/oklab/meta.json b/apps/typegpu-docs/src/examples/simple/oklab/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Oklab (Color Space)",
   "category": "simple",
-  "tags": ["experimental"]
+  "tags": []
 }
diff --git a/apps/typegpu-docs/src/examples/simple/square/meta.json b/apps/typegpu-docs/src/examples/simple/square/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Square",
   "category": "simple",
-  "tags": ["experimental", "index buffer"]
+  "tags": ["index buffer"]
 }
diff --git a/apps/typegpu-docs/src/examples/simple/triangle-next/meta.json b/apps/typegpu-docs/src/examples/simple/triangle-next/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Triangle (next)",
   "category": "simple",
-  "tags": ["experimental"]
+  "tags": []
 }
diff --git a/apps/typegpu-docs/src/examples/simple/triangle/meta.json b/apps/typegpu-docs/src/examples/simple/triangle/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Triangle",
   "category": "simple",
-  "tags": ["experimental"]
+  "tags": []
 }
diff --git a/apps/typegpu-docs/src/examples/simple/vaporrave/meta.json b/apps/typegpu-docs/src/examples/simple/vaporrave/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Vaporrave",
-  "category": "rendering",
-  "tags": ["experimental", "sdf", "ray marching"]
+  "category": "simple",
+  "tags": ["sdf", "ray marching"]
 }
diff --git a/apps/typegpu-docs/src/examples/simulation/boids/meta.json b/apps/typegpu-docs/src/examples/simulation/boids/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Boids",
   "category": "simulation",
-  "tags": ["experimental", "compute", "instancing", "double buffering"]
+  "tags": ["compute", "instancing", "double buffering"]
 }
diff --git a/apps/typegpu-docs/src/examples/simulation/confetti/meta.json b/apps/typegpu-docs/src/examples/simulation/confetti/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Confetti",
   "category": "simulation",
-  "tags": ["experimental", "compute", "instancing"]
+  "tags": ["compute", "instancing"]
 }
diff --git a/apps/typegpu-docs/src/examples/simulation/fluid-double-buffering/meta.json b/apps/typegpu-docs/src/examples/simulation/fluid-double-buffering/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Fluid (double-buffering)",
   "category": "simulation",
-  "tags": ["experimental", "compute", "cellular automata", "double buffering"]
+  "tags": ["compute", "cellular automata", "double buffering"]
 }
diff --git a/apps/typegpu-docs/src/examples/simulation/fluid-with-atomics/meta.json b/apps/typegpu-docs/src/examples/simulation/fluid-with-atomics/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Fluid (with atomics)",
   "category": "simulation",
-  "tags": ["experimental", "compute", "cellular automata", "atomic operations"]
+  "tags": ["compute", "cellular automata", "atomic operations"]
 }
diff --git a/apps/typegpu-docs/src/examples/tests/copy-error/meta.json b/apps/typegpu-docs/src/examples/tests/copy-error/meta.json
@@ -1,6 +1,6 @@
 {
   "title": "Struct Copying Test",
   "category": "tests",
-  "tags": ["experimental"],
+  "tags": [],
   "dev": true
 }
diff --git a/apps/typegpu-docs/src/examples/tests/dispatch/meta.json b/apps/typegpu-docs/src/examples/tests/dispatch/meta.json
@@ -1,6 +1,6 @@
 {
   "title": "Dispatch Tests",
   "category": "tests",
-  "tags": ["experimental"],
+  "tags": [],
   "dev": true
 }
diff --git a/apps/typegpu-docs/src/examples/tests/prefix-scan/meta.json b/apps/typegpu-docs/src/examples/tests/prefix-scan/meta.json
@@ -1,6 +1,6 @@
 {
   "title": "Prefix Scan Tests",
   "category": "tests",
-  "tags": ["experimental"],
+  "tags": [],
   "dev": true
 }
diff --git a/apps/typegpu-docs/src/examples/threejs/attractors/meta.json b/apps/typegpu-docs/src/examples/threejs/attractors/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Three.js - tsl / compute / attractors / particles",
   "category": "threejs",
-  "tags": ["experimental", "three.js"]
+  "tags": ["three.js"]
 }
diff --git a/apps/typegpu-docs/src/examples/threejs/compute-cloth/meta.json b/apps/typegpu-docs/src/examples/threejs/compute-cloth/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Three.js - compute / cloth",
   "category": "threejs",
-  "tags": ["experimental", "three.js"]
+  "tags": ["three.js"]
 }
diff --git a/apps/typegpu-docs/src/examples/threejs/compute-geometry/meta.json b/apps/typegpu-docs/src/examples/threejs/compute-geometry/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Three.js - compute / geometry",
   "category": "threejs",
-  "tags": ["experimental"]
+  "tags": ["three.js"]
 }
diff --git a/apps/typegpu-docs/src/examples/threejs/compute-particles-snow/meta.json b/apps/typegpu-docs/src/examples/threejs/compute-particles-snow/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Three.js - compute / particles / snow",
   "category": "threejs",
-  "tags": ["experimental"]
+  "tags": ["three.js"]
 }
diff --git a/apps/typegpu-docs/src/examples/threejs/compute-particles/meta.json b/apps/typegpu-docs/src/examples/threejs/compute-particles/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Three.js - compute / particles",
   "category": "threejs",
-  "tags": ["experimental"]
+  "tags": ["three.js"]
 }
diff --git a/apps/typegpu-docs/src/examples/threejs/simple/meta.json b/apps/typegpu-docs/src/examples/threejs/simple/meta.json
@@ -1,5 +1,5 @@
 {
   "title": "Three.js - Simple",
   "category": "threejs",
-  "tags": ["experimental", "three.js"]
+  "tags": ["three.js"]
 }
diff --git a/apps/typegpu-docs/src/examples/threejs/test-mismatched-types/meta.json b/apps/typegpu-docs/src/examples/threejs/test-mismatched-types/meta.json
@@ -2,5 +2,5 @@
   "title": "Three.js - Test Mismatched Types",
   "category": "threejs",
   "dev": true,
-  "tags": ["experimental", "three.js"]
+  "tags": ["three.js"]
 }
diff --git a/apps/typegpu-docs/src/examples/threejs/test-reused-functions/meta.json b/apps/typegpu-docs/src/examples/threejs/test-reused-functions/meta.json
@@ -2,5 +2,5 @@
   "title": "Three.js - Test Reused Functions",
   "category": "threejs",
   "dev": true,
-  "tags": ["experimental", "three.js"]
+  "tags": ["three.js"]
 }

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Matrix Multiplication (next)",`
`3`	`3`	`"category": "algorithms",`
`4`		`- "tags": ["experimental", "compute", "timestamp query"]`
	`4`	`+ "tags": ["compute", "timestamp query"]`
`5`	`5`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "MNIST Inference",`
`3`	`3`	`"category": "algorithms",`
`4`		`- "tags": ["ai", "compute", "inference", "timestamp query", "subgroups", "experimental"]`
	`4`	`+ "tags": ["ai", "compute", "inference", "timestamp query", "subgroups"]`
`5`	`5`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Probability Distribution Plot",`
`3`	`3`	`"category": "algorithms",`
`4`		`- "tags": ["experimental", "ecosystem", "@typegpu/noise"]`
	`4`	`+ "tags": ["ecosystem", "@typegpu/noise"]`
`5`	`5`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Box Raytracing",`
`3`	`3`	`"category": "rendering",`
`4`		`- "tags": ["experimental", "3d", "raytracing"]`
	`4`	`+ "tags": ["3d", "raytracing"]`
`5`	`5`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Caustics",`
`3`	`3`	`"category": "rendering",`
`4`		`- "tags": ["experimental", "fragment shader"]`
	`4`	`+ "tags": ["fragment shader"]`
`5`	`5`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Perlin Noise",`
`3`	`3`	`"category": "rendering",`
`4`		`- "tags": ["experimental"]`
	`4`	`+ "tags": ["noise"]`
`5`	`5`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Phong Reflection Model",`
`3`	`3`	`"category": "rendering",`
`4`		`- "tags": ["experimental", "3d"]`
	`4`	`+ "tags": ["3d"]`
`5`	`5`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Ray Marching",`
`3`	`3`	`"category": "rendering",`
`4`		`- "tags": ["experimental", "fragment shader", "shadows", "sdf", "ray marching", "sphere tracing"]`
	`4`	`+ "tags": ["fragment shader", "shadows", "sdf", "ray marching", "sphere tracing"]`
`5`	`5`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"title": "Smoky Triangle",`
`3`		`- "category": "simple",`
`4`		`- "tags": ["experimental"]`
	`3`	`+ "category": "rendering",`
	`4`	`+ "tags": ["noise"]`
`5`	`5`	`}`