@plastic-software/three 0.175.13 → 0.178.0

package/examples/jsm/math/ImprovedNoise.js

@@ -1,3 +1,7 @@
+import { MathUtils } from 'three';
+
+const { lerp } = MathUtils;
+
 const _p = [ 151, 160, 137, 91, 90, 15, 131, 13, 201, 95, 96, 53, 194, 233, 7, 225, 140, 36, 103, 30, 69, 142, 8, 99, 37, 240, 21, 10,
 	 23, 190, 6, 148, 247, 120, 234, 75, 0, 26, 197, 62, 94, 252, 219, 203, 117, 35, 11, 32, 57, 177, 33, 88, 237, 149, 56, 87,
 	 174, 20, 125, 136, 171, 168, 68, 175, 74, 165, 71, 134, 139, 48, 27, 166, 77, 146, 158, 231, 83, 111, 229, 122, 60, 211,
@@ -21,12 +25,6 @@ function fade( t ) {
 
 }
 
-function lerp( t, a, b ) {
-
-	return a + t * ( b - a );
-
-}
-
 function grad( hash, x, y, z ) {
 
 	const h = hash & 15;
@@ -40,6 +38,8 @@ function grad( hash, x, y, z ) {
  *
  * The code is based on [IMPROVED NOISE]{@link https://cs.nyu.edu/~perlin/noise/}
  * by Ken Perlin, 2002.
+ *
+ * @three_import import { ImprovedNoise } from 'three/addons/math/ImprovedNoise.js';
  */
 class ImprovedNoise {
 
@@ -67,14 +67,19 @@ class ImprovedNoise {
 
 		const A = _p[ X ] + Y, AA = _p[ A ] + Z, AB = _p[ A + 1 ] + Z, B = _p[ X + 1 ] + Y, BA = _p[ B ] + Z, BB = _p[ B + 1 ] + Z;
 
-		return lerp( w, lerp( v, lerp( u, grad( _p[ AA ], x, y, z ),
-			grad( _p[ BA ], xMinus1, y, z ) ),
-		lerp( u, grad( _p[ AB ], x, yMinus1, z ),
-			grad( _p[ BB ], xMinus1, yMinus1, z ) ) ),
-		lerp( v, lerp( u, grad( _p[ AA + 1 ], x, y, zMinus1 ),
-			grad( _p[ BA + 1 ], xMinus1, y, zMinus1 ) ),
-		lerp( u, grad( _p[ AB + 1 ], x, yMinus1, zMinus1 ),
-			grad( _p[ BB + 1 ], xMinus1, yMinus1, zMinus1 ) ) ) );
+		return lerp(
+			lerp(
+				lerp( grad( _p[ AA ], x, y, z ), grad( _p[ BA ], xMinus1, y, z ), u ),
+				lerp( grad( _p[ AB ], x, yMinus1, z ), grad( _p[ BB ], xMinus1, yMinus1, z ), u ),
+				v
+			),
+			lerp(
+				lerp( grad( _p[ AA + 1 ], x, y, zMinus1 ), grad( _p[ BA + 1 ], xMinus1, y, zMinus1 ), u ),
+				lerp( grad( _p[ AB + 1 ], x, yMinus1, zMinus1 ), grad( _p[ BB + 1 ], xMinus1, yMinus1, zMinus1 ), u ),
+				v
+			),
+			w
+		);
 
 	}
 

package/examples/jsm/math/Lut.js

@@ -12,6 +12,8 @@ import {
  * const lut = new Lut( 'rainbow', 512 );
  * const color = lut.getColor( 0.5 );
  * ```
+ *
+ * @three_import import { Lut } from 'three/addons/math/Lut.js';
  */
 class Lut {
 

package/examples/jsm/math/MeshSurfaceSampler.js

@@ -40,6 +40,8 @@ const _uva = new Vector2(), _uvb = new Vector2(), _uvc = new Vector2();
  *
  * scene.add( mesh );
  * ```
+ *
+ * @three_import import { MeshSurfaceSampler } from 'three/addons/math/MeshSurfaceSampler.js';
  */
 class MeshSurfaceSampler {
 

package/examples/jsm/math/OBB.js

@@ -39,6 +39,8 @@ const localRay = new Ray();
 
 /**
  * Represents an oriented bounding box (OBB) in 3D space.
+ *
+ * @three_import import { OBB } from 'three/addons/math/OBB.js';
  */
 class OBB {
 

package/examples/jsm/math/Octree.js

@@ -96,6 +96,8 @@ function lineToLineClosestPoints( line1, line2, target1 = null, target2 = null )
  * const octree = new Octree().fromGraphNode( scene );
  * const result = octree.capsuleIntersect( playerCollider ); // collision detection
  * ```
+ *
+ * @three_import import { Octree } from 'three/addons/math/Octree.js';
  */
 class Octree {
 
@@ -128,6 +130,23 @@ class Octree {
 		 */
 		this.layers = new Layers();
 
+		/**
+		 * The number of triangles a leaf can store before it is split.
+		 *
+		 * @type {number}
+		 * @default 8
+		 */
+		this.trianglesPerLeaf = 8;
+
+		/**
+		 * The maximum level of the Octree. It defines the maximum
+		 * hierarchical depth of the data structure.
+		 *
+		 * @type {number}
+		 * @default 16
+		 */
+		this.maxLevel = 16;
+
 		// private
 
 		this.subTrees = [];
@@ -229,7 +248,7 @@ class Octree {
 
 			const len = subTrees[ i ].triangles.length;
 
-			if ( len > 8 && level < 16 ) {
+			if ( len > this.trianglesPerLeaf && level < this.maxLevel ) {
 
 				subTrees[ i ].split( level + 1 );
 

package/examples/jsm/math/SimplexNoise.js

@@ -3,6 +3,8 @@
  *
  * The code is based on [Simplex noise demystified]{@link https://web.archive.org/web/20210210162332/http://staffwww.itn.liu.se/~stegu/simplexnoise/simplexnoise.pdf}
  * by Stefan Gustavson, 2005.
+ *
+ * @three_import import { SimplexNoise } from 'three/addons/math/SimplexNoise.js';
  */
 class SimplexNoise {
 

package/examples/jsm/misc/ConvexObjectBreaker.js

@@ -24,7 +24,9 @@ const _v1 = new Vector3();
  *
  * Note: This lib adds member variables to object's userData member (see prepareBreakableObject function)
  * Use with caution and read the code when using with other libs.
-*/
+ *
+ * @three_import import { ConvexObjectBreaker } from 'three/addons/misc/ConvexObjectBreaker.js';
+ */
 class ConvexObjectBreaker {
 
 	/**

package/examples/jsm/misc/GPUComputationRenderer.js

@@ -98,6 +98,8 @@ import { FullScreenQuad } from '../postprocessing/Pass.js';
  * gpuCompute.doRenderTarget( myFilter1, myRenderTarget );
  * gpuCompute.doRenderTarget( myFilter2, outputRenderTarget );
  * ```
+ *
+ * @three_import import { GPUComputationRenderer } from 'three/addons/misc/GPUComputationRenderer.js';
  */
 class GPUComputationRenderer {
 

package/examples/jsm/misc/Gyroscope.js

@@ -19,6 +19,7 @@ const _scaleWorld = new Vector3();
  * respect to the world.
  *
  * @augments Object3D
+ * @three_import import { Gyroscope } from 'three/addons/misc/Gyroscope.js';
  */
 class Gyroscope extends Object3D {
 

package/examples/jsm/misc/MD2Character.js

@@ -13,6 +13,8 @@ import { MD2Loader } from '../loaders/MD2Loader.js';
 /**
  * This class represents a management component for animated MD2
  * character assets.
+ *
+ * @three_import import { MD2Character } from 'three/addons/misc/MD2Character.js';
  */
 class MD2Character {
 

package/examples/jsm/misc/MD2CharacterComplex.js

@@ -13,6 +13,8 @@ import { MorphBlendMesh } from '../misc/MorphBlendMesh.js';
 /**
  * This class represents a management component for animated MD2
  * character assets. It provides a larger API compared to {@link MD2Character}.
+ *
+ * @three_import import { MD2CharacterComplex } from 'three/addons/misc/MD2CharacterComplex.js';
  */
 class MD2CharacterComplex {
 
@@ -78,12 +80,12 @@ class MD2CharacterComplex {
 		this.backAcceleration = 600;
 
 		/**
-		 * The character's front decceleration.
+		 * The character's front deceleration.
 		 *
 		 * @type {number}
 		 * @default 600
 		 */
-		this.frontDecceleration = 600;
+		this.frontDeceleration = 600;
 
 		/**
 		 * The character's angular speed.
@@ -684,7 +686,7 @@ class MD2CharacterComplex {
 			if ( this.speed > 0 ) {
 
 				const k = exponentialEaseOut( this.speed / this.maxSpeed );
-				this.speed = MathUtils.clamp( this.speed - k * delta * this.frontDecceleration, 0, this.maxSpeed );
+				this.speed = MathUtils.clamp( this.speed - k * delta * this.frontDeceleration, 0, this.maxSpeed );
 
 			} else {
 

package/examples/jsm/misc/MorphAnimMesh.js

@@ -10,6 +10,7 @@ import {
  * without any transitions or fading between animation changes.
  *
  * @augments Mesh
+ * @three_import import { MorphAnimMesh } from 'three/addons/misc/MorphAnimMesh.js';
  */
 class MorphAnimMesh extends Mesh {
 

package/examples/jsm/misc/MorphBlendMesh.js

@@ -10,6 +10,7 @@ import {
  * fading options.
  *
  * @augments Mesh
+ * @three_import import { MorphBlendMesh } from 'three/addons/misc/MorphBlendMesh.js';
  */
 class MorphBlendMesh extends Mesh {
 

package/examples/jsm/misc/ProgressiveLightMap.js

@@ -16,6 +16,8 @@ import { potpack } from '../libs/potpack.module.js';
  *
  * This class can only be used with {@link WebGLRenderer}.
  * When using {@link WebGPURenderer}, import from `ProgressiveLightMapGPU.js`.
+ *
+ * @three_import import { ProgressiveLightMap } from 'three/addons/misc/ProgressiveLightMap.js';
  */
 class ProgressiveLightMap {
 

package/examples/jsm/misc/ProgressiveLightMapGPU.js

@@ -18,6 +18,8 @@ import { potpack } from '../libs/potpack.module.js';
  *
  * This class can only be used with {@link WebGPURenderer}.
  * When using {@link WebGLRenderer}, import from `ProgressiveLightMap.js`.
+ *
+ * @three_import import { ProgressiveLightMap } from 'three/addons/misc/ProgressiveLightMapGPU.js';
  */
 class ProgressiveLightMap {
 

package/examples/jsm/misc/RollerCoaster.js

@@ -12,6 +12,7 @@ import {
  * A procedural roller coaster geometry.
  *
  * @augments BufferGeometry
+ * @three_import import { RollerCoasterGeometry } from 'three/addons/misc/RollerCoaster.js';
  */
 class RollerCoasterGeometry extends BufferGeometry {
 
@@ -237,6 +238,7 @@ class RollerCoasterGeometry extends BufferGeometry {
  * A procedural roller coaster lifters geometry.
  *
  * @augments BufferGeometry
+ * @three_import import { RollerCoasterLiftersGeometry } from 'three/addons/misc/RollerCoaster.js';
  */
 class RollerCoasterLiftersGeometry extends BufferGeometry {
 
@@ -424,6 +426,7 @@ class RollerCoasterLiftersGeometry extends BufferGeometry {
  * A procedural roller coaster shadow geometry.
  *
  * @augments BufferGeometry
+ * @three_import import { RollerCoasterShadowGeometry } from 'three/addons/misc/RollerCoaster.js';
  */
 class RollerCoasterShadowGeometry extends BufferGeometry {
 
@@ -507,6 +510,7 @@ class RollerCoasterShadowGeometry extends BufferGeometry {
  * A procedural sky geometry.
  *
  * @augments BufferGeometry
+ * @three_import import { SkyGeometry } from 'three/addons/misc/RollerCoaster.js';
  */
 class SkyGeometry extends BufferGeometry {
 
@@ -548,6 +552,7 @@ class SkyGeometry extends BufferGeometry {
  * A procedural trees geometry.
  *
  * @augments BufferGeometry
+ * @three_import import { TreesGeometry } from 'three/addons/misc/RollerCoaster.js';
  */
 class TreesGeometry extends BufferGeometry {
 

package/examples/jsm/misc/Timer.js

@@ -11,6 +11,8 @@
  * const timer = new Timer();
  * timer.connect( document ); // use Page Visibility API
  * ```
+ *
+ * @three_import import { Timer } from 'three/addons/misc/Timer.js';
  */
 class Timer {
 

package/examples/jsm/misc/TubePainter.js

@@ -21,6 +21,7 @@ import {
  *
  * @name TubePainter
  * @class
+ * @three_import import { TubePainter } from 'three/addons/misc/TubePainter.js';
  */
 function TubePainter() {
 

package/examples/jsm/misc/Volume.js

@@ -8,6 +8,8 @@ import { VolumeSlice } from '../misc/VolumeSlice.js';
 /**
  * This class had been written to handle the output of the {@link NRRDLoader}.
  * It contains a volume of data and information about it. For now it only handles 3 dimensional data.
+ *
+ * @three_import import { Volume } from 'three/addons/misc/Volume.js';
  */
 class Volume {
 

package/examples/jsm/misc/VolumeSlice.js

@@ -13,6 +13,7 @@ import {
  * This class has been made to hold a slice of a volume data.
  *
  * @see {@link Volume}
+ * @three_import import { VolumeSlice } from 'three/addons/misc/VolumeSlice.js';
  */
 class VolumeSlice {
 

package/examples/jsm/modifiers/CurveModifier.js

@@ -203,6 +203,8 @@ vec3 transformedNormal = normalMatrix * (basis * objectNormal);
  *
  * This module can only be used with {@link WebGLRenderer}. When using {@link WebGPURenderer},
  * import the class from `CurveModifierGPU.js`.
+ *
+ * @three_import import { Flow } from 'three/addons/modifiers/CurveModifier.js';
  */
 export class Flow {
 
@@ -296,6 +298,7 @@ const _matrix = new Matrix4();
  * This module can only be used with {@link WebGLRenderer}.
  *
  * @augments Flow
+ * @three_import import { InstancedFlow } from 'three/addons/modifiers/CurveModifier.js';
  */
 export class InstancedFlow extends Flow {
 

package/examples/jsm/modifiers/CurveModifierGPU.js

@@ -164,6 +164,8 @@ function modifyShader( material, uniforms, numberOfCurves ) {
  *
  * This module can only be used with {@link WebGPURenderer}. When using {@link WebGLRenderer},
  * import the class from `CurveModifier.js`.
+ *
+ * @three_import import { Flow } from 'three/addons/modifiers/CurveModifierGPU.js';
  */
 export class Flow {
 

package/examples/jsm/modifiers/EdgeSplitModifier.js

@@ -17,6 +17,8 @@ const _C = new Vector3();
  * const modifier = new EdgeSplitModifier();
  * geometry = modifier.modify( geometry, Math.PI * 0.4 );
  * ```
+ *
+ * @three_import import { EdgeSplitModifier } from 'three/addons/modifiers/EdgeSplitModifier.js';
  */
 class EdgeSplitModifier {
 

package/examples/jsm/modifiers/SimplifyModifier.js

@@ -21,6 +21,8 @@ const _cb = new Vector3(), _ab = new Vector3();
  * const modifier = new SimplifyModifier();
  * geometry = modifier.modify( geometry );
  * ```
+ *
+ * @three_import import { SimplifyModifier } from 'three/addons/modifiers/SimplifyModifier.js';
  */
 class SimplifyModifier {
 

package/examples/jsm/modifiers/TessellateModifier.js

@@ -14,6 +14,8 @@ import {
  * const modifier = new TessellateModifier( 8, 6 );
  * geometry = modifier.modify( geometry );
  * ```
+ *
+ * @three_import import { TessellateModifier } from 'three/addons/modifiers/TessellateModifier.js';
  */
 class TessellateModifier {
 

package/examples/jsm/objects/GroundedSkybox.js

@@ -15,6 +15,7 @@ import { Mesh, MeshBasicMaterial, SphereGeometry, Vector3 } from 'three';
  * ```
  *
  * @augments Mesh
+ * @three_import import { GroundedSkybox } from 'three/addons/objects/GroundedSkybox.js';
  */
 class GroundedSkybox extends Mesh {
 

package/examples/jsm/objects/Lensflare.js

@@ -33,6 +33,7 @@ import {
  * ```
  *
  * @augments Mesh
+ * @three_import import { Lensflare } from 'three/addons/objects/Lensflare.js';
  */
 class Lensflare extends Mesh {
 
@@ -338,6 +339,8 @@ class Lensflare extends Mesh {
 
 /**
  * Represents a single flare that can be added to a {@link Lensflare} container.
+ *
+ * @three_import import { LensflareElement } from 'three/addons/objects/Lensflare.js';
  */
 class LensflareElement {
 

package/examples/jsm/objects/LensflareMesh.js

@@ -36,6 +36,7 @@ import { texture, textureLoad, uv, ivec2, vec2, vec4, positionGeometry, referenc
  * ```
  *
  * @augments Mesh
+ * @three_import import { LensflareMesh } from 'three/addons/objects/LensflareMesh.js';
  */
 class LensflareMesh extends Mesh {
 

package/examples/jsm/objects/MarchingCubes.js

@@ -12,6 +12,8 @@ import {
  * A marching cubes implementation.
  *
  * Port of: {@link http://webglsamples.org/blob/blob.html}
+ *
+ * @three_import import { MarchingCubes } from 'three/addons/objects/MarchingCubes.js';
  */
 class MarchingCubes extends Mesh {
 

package/examples/jsm/objects/Reflector.js

@@ -32,6 +32,7 @@ import {
  * ```
  *
  * @augments Mesh
+ * @three_import import { Reflector } from 'three/addons/objects/Reflector.js';
  */
 class Reflector extends Mesh {
 

package/examples/jsm/objects/ReflectorForSSRPass.js

@@ -19,6 +19,7 @@ import {
  * A special version of {@link Reflector} for usage with {@link SSRPass}.
  *
  * @augments Mesh
+ * @three_import import { ReflectorForSSRPass } from 'three/addons/objects/ReflectorForSSRPass.js';
  */
 class ReflectorForSSRPass extends Mesh {
 

package/examples/jsm/objects/Refractor.js

@@ -33,6 +33,7 @@ import {
  * ```
  *
  * @augments Mesh
+ * @three_import import { Refractor } from 'three/addons/objects/Refractor.js';
  */
 class Refractor extends Mesh {
 

package/examples/jsm/objects/ShadowMesh.js

@@ -23,6 +23,7 @@ const _shadowMatrix = new Matrix4();
  * ```
  *
  * @augments Mesh
+ * @three_import import { ShadowMesh } from 'three/addons/objects/ShadowMesh.js';
  */
 class ShadowMesh extends Mesh {
 

package/examples/jsm/objects/Sky.js

@@ -27,7 +27,8 @@ import {
  * ```
  *
  * @augments Mesh
-*/
+ * @three_import import { Sky } from 'three/addons/objects/Sky.js';
+ */
 class Sky extends Mesh {
 
 	/**

package/examples/jsm/objects/SkyMesh.js

@@ -6,7 +6,7 @@ import {
 	NodeMaterial
 } from 'three/webgpu';
 
-import { Fn, float, vec3, acos, add, mul, clamp, cos, dot, exp, max, mix, modelViewProjection, normalize, positionWorld, pow, smoothstep, sub, varying, varyingProperty, vec4, uniform, cameraPosition } from 'three/tsl';
+import { Fn, float, vec3, acos, add, mul, clamp, cos, dot, exp, max, mix, modelViewProjection, normalize, positionWorld, pow, smoothstep, sub, varyingProperty, vec4, uniform, cameraPosition } from 'three/tsl';
 
 /**
  * Represents a skydome for scene backgrounds. Based on [A Practical Analytic Model for Daylight]{@link https://www.researchgate.net/publication/220720443_A_Practical_Analytic_Model_for_Daylight}
@@ -27,7 +27,8 @@ import { Fn, float, vec3, acos, add, mul, clamp, cos, dot, exp, max, mix, modelV
  * ```
  *
  * @augments Mesh
-*/
+ * @three_import import { SkyMesh } from 'three/addons/objects/SkyMesh.js';
+ */
 class SkyMesh extends Mesh {
 
 	/**
@@ -90,6 +91,14 @@ class SkyMesh extends Mesh {
 		 */
 		this.isSky = true;
 
+		// Varyings
+
+		const vSunDirection = varyingProperty( 'vec3' );
+		const vSunE = varyingProperty( 'float' );
+		const vSunfade = varyingProperty( 'float' );
+		const vBetaR = varyingProperty( 'vec3' );
+		const vBetaM = varyingProperty( 'vec3' );
+
 		const vertexNode = /*@__PURE__*/ Fn( () => {
 
 			// constants for atmospheric scattering
@@ -117,35 +126,35 @@ class SkyMesh extends Mesh {
 
 			// varying sun position
 
-			const vSunDirection = normalize( this.sunPosition );
-			varyingProperty( 'vec3', 'vSunDirection' ).assign( vSunDirection );
+			const sunDirection = normalize( this.sunPosition );
+			vSunDirection.assign( sunDirection );
 
 			// varying sun intensity
 
-			const angle = dot( vSunDirection, this.upUniform );
+			const angle = dot( sunDirection, this.upUniform );
 			const zenithAngleCos = clamp( angle, - 1, 1 );
 			const sunIntensity = EE.mul( max( 0.0, float( 1.0 ).sub( pow( e, cutoffAngle.sub( acos( zenithAngleCos ) ).div( steepness ).negate() ) ) ) );
-			varyingProperty( 'float', 'vSunE' ).assign( sunIntensity );
+			vSunE.assign( sunIntensity );
 
 			// varying sun fade
 
-			const vSunfade = float( 1.0 ).sub( clamp( float( 1.0 ).sub( exp( this.sunPosition.y.div( 450000.0 ) ) ), 0, 1 ) );
-			varyingProperty( 'float', 'vSunfade' ).assign( vSunfade );
+			const sunfade = float( 1.0 ).sub( clamp( float( 1.0 ).sub( exp( this.sunPosition.y.div( 450000.0 ) ) ), 0, 1 ) );
+			vSunfade.assign( sunfade );
 
 			// varying vBetaR
 
-			const rayleighCoefficient = this.rayleigh.sub( float( 1.0 ).mul( float( 1.0 ).sub( vSunfade ) ) );
+			const rayleighCoefficient = this.rayleigh.sub( float( 1.0 ).mul( float( 1.0 ).sub( sunfade ) ) );
 
 			// extinction (absorption + out scattering)
 			// rayleigh coefficients
-			varyingProperty( 'vec3', 'vBetaR' ).assign( totalRayleigh.mul( rayleighCoefficient ) );
+			vBetaR.assign( totalRayleigh.mul( rayleighCoefficient ) );
 
 			// varying vBetaM
 
 			const c = float( 0.2 ).mul( this.turbidity ).mul( 10E-18 );
 			const totalMie = float( 0.434 ).mul( c ).mul( MieConst );
 
-			varyingProperty( 'vec3', 'vBetaM' ).assign( totalMie.mul( this.mieCoefficient ) );
+			vBetaM.assign( totalMie.mul( this.mieCoefficient ) );
 
 			// position
 
@@ -158,12 +167,6 @@ class SkyMesh extends Mesh {
 
 		const fragmentNode = /*@__PURE__*/ Fn( () => {
 
-			const vSunDirection = varying( vec3(), 'vSunDirection' );
-			const vSunE = varying( float(), 'vSunE' );
-			const vSunfade = varying( float(), 'vSunfade' );
-			const vBetaR = varying( vec3(), 'vBetaR' );
-			const vBetaM = varying( vec3(), 'vBetaM' );
-
 			// constants for atmospheric scattering
 			const pi = float( 3.141592653589793238462643383279502884197169 );
 

package/examples/jsm/objects/Water.js

@@ -26,6 +26,7 @@ import {
  * - [Water shader explanations in WebGL]{@link http://29a.ch/slides/2012/webglwater/ }
  *
  * @augments Mesh
+ * @three_import import { Water } from 'three/addons/objects/Water.js';
  */
 class Water extends Mesh {
 

package/examples/jsm/objects/Water2.js

@@ -28,6 +28,7 @@ import { Refractor } from '../objects/Refractor.js';
  * - {@link http://graphicsrunner.blogspot.de/2010/08/water-using-flow-maps.html}
  *
  * @augments Mesh
+ * @three_import import { Water } from 'three/addons/objects/Water2.js';
  */
 class Water extends Mesh {
 

package/examples/jsm/objects/Water2Mesh.js

@@ -24,6 +24,7 @@ import { Fn, vec2, viewportSafeUV, viewportSharedTexture, reflector, pow, float,
  * - {@link http://graphicsrunner.blogspot.de/2010/08/water-using-flow-maps.html}
  *
  * @augments Mesh
+ * @three_import import { WaterMesh } from 'three/addons/objects/Water2Mesh.js';
  */
 class WaterMesh extends Mesh {
 
@@ -36,6 +37,7 @@ class WaterMesh extends Mesh {
 	constructor( geometry, options = {} ) {
 
 		const material = new NodeMaterial();
+		material.transparent = true;
 
 		super( geometry, material );
 
@@ -48,7 +50,7 @@ class WaterMesh extends Mesh {
 		 */
 		this.isWater = true;
 
-		material.fragmentNode = new WaterNode( options, this );
+		material.colorNode = new WaterNode( options, this );
 
 	}
 

package/examples/jsm/objects/WaterMesh.js

@@ -20,6 +20,7 @@ import { Fn, add, cameraPosition, div, normalize, positionWorld, sub, time, text
  * - [Water shader explanations in WebGL]{@link http://29a.ch/slides/2012/webglwater/ }
  *
  * @augments Mesh
+ * @three_import import { WaterMesh } from 'three/addons/objects/WaterMesh.js';
  */
 class WaterMesh extends Mesh {
 
@@ -152,7 +153,7 @@ class WaterMesh extends Mesh {
 
 		material.opacityNode = this.alpha;
 
-		material.shadowPositionNode = positionWorld.add( distortion );
+		material.receivedShadowPositionNode = positionWorld.add( distortion );
 
 		material.setupOutgoingLight = () => diffuseColor.rgb; // backwards compatibility
 

package/examples/jsm/physics/AmmoPhysics.js

@@ -12,6 +12,7 @@
  * @name AmmoPhysics
  * @class
  * @hideconstructor
+ * @three_import import { AmmoPhysics } from 'three/addons/physics/AmmoPhysics.js';
  */
 async function AmmoPhysics() {
 

package/examples/jsm/physics/JoltPhysics.js

@@ -69,6 +69,7 @@ function setupCollisionFiltering( settings ) {
  * @name JoltPhysics
  * @class
  * @hideconstructor
+ * @three_import import { JoltPhysics } from 'three/addons/physics/JoltPhysics.js';
  */
 async function JoltPhysics() {