Examples: Add volumetric fire, enhances the VolumetricLightingModel (#2235)

* Update three.js

* Update

* Add jsdoc

* Update patch and delete jsdoc

* Update declarations

* Ignore example

Author: Methuselah96

examples-testing/index.js

@@ -70,6 +70,7 @@ const exceptionList = [
     'webgpu_tsl_editor',
     'webgpu_tsl_transpiler',
     'webgpu_video_frame',
+    'webgpu_volume_fire',
     'webxr_ar_camera_access',
     'webxr_vr_handinput_cubes',
     'webxr_vr_handinput_profiles',

jsdoc-testing/changes.patch

@@ -368,6 +368,49 @@ index fb546510b..1257d8f69 100644
 +export const clusteredLights: (maxLights?: number, tileSize?: number, zSlices?: number, maxLightsPerCluster?: number) => ClusteredLightsNode;
 +
 +export default ClusteredLightsNode;
+diff --git a/jsdoc-testing/jsdoc/examples/jsm/tsl/math/curlNoise.d.ts b/jsdoc-testing/jsdoc/examples/jsm/tsl/math/curlNoise.d.ts
+index a6101efb7..5bbb73bfc 100644
+--- a/jsdoc-testing/jsdoc/examples/jsm/tsl/math/curlNoise.d.ts
++++ b/jsdoc-testing/jsdoc/examples/jsm/tsl/math/curlNoise.d.ts
+@@ -1,3 +1,5 @@
++import { Node, Vector3, Vector4 } from 'three/webgpu';
++
+ /**
+  * Permutation polynomial for noise generation.
+  *
+@@ -6,7 +8,7 @@
+  * @param {Node<vec4>} x - Input vector.
+  * @return {Node<vec4>} Permuted vector.
+  */
+-export const permute: () => void;
++export const permute: (x: Node<'vec4'> | Vector4) => Node<'vec4'>;
+ /**
+  * 3D Simplex noise implementation in TSL.
+  *
+@@ -15,7 +17,7 @@ export const permute: () => void;
+  * @param {Node<vec3>} v - Input coordinate vector.
+  * @return {Node<float>} Simplex noise value.
+  */
+-export const snoise: () => void;
++export const snoise: (v: Node<'vec3'> | Vector3) => Node<'float'>;
+ /**
+  * 3D Simplex noise vector. Returns a vec3 containing three independent noise samples.
+  *
+@@ -24,7 +26,7 @@ export const snoise: () => void;
+  * @param {Node<vec3>} x - Input coordinate vector.
+  * @return {Node<vec3>} Vector of three noise values.
+  */
+-export const snoiseVec3: () => void;
++export const snoiseVec3: (x: Node<'vec3'> | Vector3) => Node<'vec3'>;
+ /**
+  * 3D Curl noise in TSL. Generates a divergence-free vector field from simplex noise.
+  *
+@@ -33,4 +35,4 @@ export const snoiseVec3: () => void;
+  * @param {Node<vec3>} p - Input coordinate vector.
+  * @return {Node<vec3>} Curl noise vector.
+  */
+-export const curlNoise: () => void;
++export const curlNoise: (p: Node<'vec3'> | Vector3) => Node<'vec3'>;
 diff --git a/jsdoc-testing/jsdoc/examples/jsm/tsl/utils/GroundedSkybox.d.ts b/jsdoc-testing/jsdoc/examples/jsm/tsl/utils/GroundedSkybox.d.ts
 index e49e7c2b6..0135575bb 100644
 --- a/jsdoc-testing/jsdoc/examples/jsm/tsl/utils/GroundedSkybox.d.ts

jsdoc-testing/declarations.js

@@ -9,6 +9,7 @@ const files = [
     'examples/jsm/lighting/LightProbeGrid',
     'examples/jsm/misc/TileCreasedNormalsPlugin',
     'examples/jsm/tsl/lighting/ClusteredLightsNode',
+    'examples/jsm/tsl/math/curlNoise',
     'examples/jsm/tsl/utils/GroundedSkybox',
     'examples/jsm/webxr/WebGLXRFallback',
     'src/animation/tracks/BooleanKeyframeTrack',

three.js

@@ -0,0 +1,38 @@
+import { Node, Vector3, Vector4 } from "three/webgpu";
+
+/**
+ * Permutation polynomial for noise generation.
+ *
+ * @tsl
+ * @function
+ * @param {Node<vec4>} x - Input vector.
+ * @return {Node<vec4>} Permuted vector.
+ */
+export const permute: (x: Node<"vec4"> | Vector4) => Node<"vec4">;
+/**
+ * 3D Simplex noise implementation in TSL.
+ *
+ * @tsl
+ * @function
+ * @param {Node<vec3>} v - Input coordinate vector.
+ * @return {Node<float>} Simplex noise value.
+ */
+export const snoise: (v: Node<"vec3"> | Vector3) => Node<"float">;
+/**
+ * 3D Simplex noise vector. Returns a vec3 containing three independent noise samples.
+ *
+ * @tsl
+ * @function
+ * @param {Node<vec3>} x - Input coordinate vector.
+ * @return {Node<vec3>} Vector of three noise values.
+ */
+export const snoiseVec3: (x: Node<"vec3"> | Vector3) => Node<"vec3">;
+/**
+ * 3D Curl noise in TSL. Generates a divergence-free vector field from simplex noise.
+ *
+ * @tsl
+ * @function
+ * @param {Node<vec3>} p - Input coordinate vector.
+ * @return {Node<vec3>} Curl noise vector.
+ */
+export const curlNoise: (p: Node<"vec3"> | Vector3) => Node<"vec3">;