super-three 0.173.4 → 0.175.0

package/src/nodes/accessors/MaterialNode.js

@@ -8,8 +8,6 @@ import { normalMap } from '../display/NormalMapNode.js';
 import { bumpMap } from '../display/BumpMapNode.js';
 import { Vector2 } from '../../math/Vector2.js';
 
-/** @module MaterialNode **/
-
 const _propertyCache = new Map();
 
 /**
@@ -31,7 +29,7 @@ class MaterialNode extends Node {
 	/**
 	 * Constructs a new material node.
 	 *
-	 * @param {String} scope - The scope defines what kind of material property is referred by the node.
+	 * @param {string} scope - The scope defines what kind of material property is referred by the node.
 	 */
 	constructor( scope ) {
 
@@ -40,7 +38,7 @@ class MaterialNode extends Node {
 		/**
 		 * The scope defines what material property is referred by the node.
 		 *
-		 * @type {String}
+		 * @type {string}
 		 */
 		this.scope = scope;
 
@@ -49,8 +47,8 @@ class MaterialNode extends Node {
 	/**
 	 * Returns a cached reference node for the given property and type.
 	 *
-	 * @param {String} property - The name of the material property.
-	 * @param {String} type - The uniform type of the property.
+	 * @param {string} property - The name of the material property.
+	 * @param {string} type - The uniform type of the property.
 	 * @return {MaterialReferenceNode} A material reference node representing the property access.
 	 */
 	getCache( property, type ) {
@@ -72,7 +70,7 @@ class MaterialNode extends Node {
 	/**
 	 * Returns a float-typed material reference node for the given property name.
 	 *
-	 * @param {String} property - The name of the material property.
+	 * @param {string} property - The name of the material property.
 	 * @return {MaterialReferenceNode<float>} A material reference node representing the property access.
 	 */
 	getFloat( property ) {
@@ -84,7 +82,7 @@ class MaterialNode extends Node {
 	/**
 	 * Returns a color-typed material reference node for the given property name.
 	 *
-	 * @param {String} property - The name of the material property.
+	 * @param {string} property - The name of the material property.
 	 * @return {MaterialReferenceNode<color>} A material reference node representing the property access.
 	 */
 	getColor( property ) {
@@ -96,7 +94,7 @@ class MaterialNode extends Node {
 	/**
 	 * Returns a texture-typed material reference node for the given property name.
 	 *
-	 * @param {String} property - The name of the material property.
+	 * @param {string} property - The name of the material property.
 	 * @return {MaterialReferenceNode} A material reference node representing the property access.
 	 */
 	getTexture( property ) {
@@ -445,6 +443,7 @@ export default MaterialNode;
 /**
  * TSL object that represents alpha test of the current material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialAlphaTest = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.ALPHA_TEST );
@@ -453,6 +452,7 @@ export const materialAlphaTest = /*@__PURE__*/ nodeImmutable( MaterialNode, Mate
  * TSL object that represents the diffuse color of the current material.
  * The value is composed via `color` * `map`.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const materialColor = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.COLOR );
@@ -460,6 +460,7 @@ export const materialColor = /*@__PURE__*/ nodeImmutable( MaterialNode, Material
 /**
  * TSL object that represents the shininess of the current material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialShininess = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.SHININESS );
@@ -468,6 +469,7 @@ export const materialShininess = /*@__PURE__*/ nodeImmutable( MaterialNode, Mate
  * TSL object that represents the emissive color of the current material.
  * The value is composed via `emissive` * `emissiveIntensity` * `emissiveMap`.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const materialEmissive = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.EMISSIVE );
@@ -476,6 +478,7 @@ export const materialEmissive = /*@__PURE__*/ nodeImmutable( MaterialNode, Mater
  * TSL object that represents the opacity of the current material.
  * The value is composed via `opacity` * `alphaMap`.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialOpacity = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.OPACITY );
@@ -483,6 +486,7 @@ export const materialOpacity = /*@__PURE__*/ nodeImmutable( MaterialNode, Materi
 /**
  * TSL object that represents the specular of the current material.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const materialSpecular = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.SPECULAR );
@@ -491,6 +495,7 @@ export const materialSpecular = /*@__PURE__*/ nodeImmutable( MaterialNode, Mater
  * TSL object that represents the specular intensity of the current material.
  * The value is composed via `specularIntensity` * `specularMap.a`.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialSpecularIntensity = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.SPECULAR_INTENSITY );
@@ -499,6 +504,7 @@ export const materialSpecularIntensity = /*@__PURE__*/ nodeImmutable( MaterialNo
  * TSL object that represents the specular color of the current material.
  * The value is composed via `specularColor` * `specularMap.rgb`.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const materialSpecularColor = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.SPECULAR_COLOR );
@@ -507,6 +513,7 @@ export const materialSpecularColor = /*@__PURE__*/ nodeImmutable( MaterialNode,
  * TSL object that represents the specular strength of the current material.
  * The value is composed via `specularMap.r`.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialSpecularStrength = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.SPECULAR_STRENGTH );
@@ -514,6 +521,7 @@ export const materialSpecularStrength = /*@__PURE__*/ nodeImmutable( MaterialNod
 /**
  * TSL object that represents the reflectivity of the current material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialReflectivity = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.REFLECTIVITY );
@@ -522,6 +530,7 @@ export const materialReflectivity = /*@__PURE__*/ nodeImmutable( MaterialNode, M
  * TSL object that represents the roughness of the current material.
  * The value is composed via `roughness` * `roughnessMap.g`.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialRoughness = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.ROUGHNESS );
@@ -530,6 +539,7 @@ export const materialRoughness = /*@__PURE__*/ nodeImmutable( MaterialNode, Mate
  * TSL object that represents the metalness of the current material.
  * The value is composed via `metalness` * `metalnessMap.b`.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialMetalness = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.METALNESS );
@@ -538,6 +548,7 @@ export const materialMetalness = /*@__PURE__*/ nodeImmutable( MaterialNode, Mate
  * TSL object that represents the normal of the current material.
  * The value will be either `normalMap` * `normalScale`, `bumpMap` * `bumpScale` or `normalView`.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const materialNormal = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.NORMAL );
@@ -546,6 +557,7 @@ export const materialNormal = /*@__PURE__*/ nodeImmutable( MaterialNode, Materia
  * TSL object that represents the clearcoat of the current material.
  * The value is composed via `clearcoat` * `clearcoatMap.r`
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialClearcoat = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.CLEARCOAT );
@@ -554,6 +566,7 @@ export const materialClearcoat = /*@__PURE__*/ nodeImmutable( MaterialNode, Mate
  * TSL object that represents the clearcoat roughness of the current material.
  * The value is composed via `clearcoatRoughness` * `clearcoatRoughnessMap.r`.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialClearcoatRoughness = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.CLEARCOAT_ROUGHNESS );
@@ -562,6 +575,7 @@ export const materialClearcoatRoughness = /*@__PURE__*/ nodeImmutable( MaterialN
  * TSL object that represents the clearcoat normal of the current material.
  * The value will be either `clearcoatNormalMap` or `normalView`.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const materialClearcoatNormal = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.CLEARCOAT_NORMAL );
@@ -569,6 +583,7 @@ export const materialClearcoatNormal = /*@__PURE__*/ nodeImmutable( MaterialNode
 /**
  * TSL object that represents the rotation of the current sprite material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialRotation = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.ROTATION );
@@ -577,6 +592,7 @@ export const materialRotation = /*@__PURE__*/ nodeImmutable( MaterialNode, Mater
  * TSL object that represents the sheen color of the current material.
  * The value is composed via `sheen` * `sheenColor` * `sheenColorMap`.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const materialSheen = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.SHEEN );
@@ -585,6 +601,7 @@ export const materialSheen = /*@__PURE__*/ nodeImmutable( MaterialNode, Material
  * TSL object that represents the sheen roughness of the current material.
  * The value is composed via `sheenRoughness` * `sheenRoughnessMap.a`.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialSheenRoughness = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.SHEEN_ROUGHNESS );
@@ -592,6 +609,7 @@ export const materialSheenRoughness = /*@__PURE__*/ nodeImmutable( MaterialNode,
 /**
  * TSL object that represents the anisotropy of the current material.
  *
+ * @tsl
  * @type {Node<vec2>}
  */
 export const materialAnisotropy = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.ANISOTROPY );
@@ -599,6 +617,7 @@ export const materialAnisotropy = /*@__PURE__*/ nodeImmutable( MaterialNode, Mat
 /**
  * TSL object that represents the iridescence of the current material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialIridescence = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.IRIDESCENCE );
@@ -606,6 +625,7 @@ export const materialIridescence = /*@__PURE__*/ nodeImmutable( MaterialNode, Ma
 /**
  * TSL object that represents the iridescence IOR of the current material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialIridescenceIOR = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.IRIDESCENCE_IOR );
@@ -613,6 +633,7 @@ export const materialIridescenceIOR = /*@__PURE__*/ nodeImmutable( MaterialNode,
 /**
  * TSL object that represents the iridescence thickness of the current material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialIridescenceThickness = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.IRIDESCENCE_THICKNESS );
@@ -621,6 +642,7 @@ export const materialIridescenceThickness = /*@__PURE__*/ nodeImmutable( Materia
  * TSL object that represents the transmission of the current material.
  * The value is composed via `transmission` * `transmissionMap.r`.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialTransmission = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.TRANSMISSION );
@@ -629,6 +651,7 @@ export const materialTransmission = /*@__PURE__*/ nodeImmutable( MaterialNode, M
  * TSL object that represents the thickness of the current material.
  * The value is composed via `thickness` * `thicknessMap.g`.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialThickness = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.THICKNESS );
@@ -636,6 +659,7 @@ export const materialThickness = /*@__PURE__*/ nodeImmutable( MaterialNode, Mate
 /**
  * TSL object that represents the IOR of the current material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialIOR = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.IOR );
@@ -643,6 +667,7 @@ export const materialIOR = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNo
 /**
  * TSL object that represents the attenuation distance of the current material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialAttenuationDistance = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.ATTENUATION_DISTANCE );
@@ -650,6 +675,7 @@ export const materialAttenuationDistance = /*@__PURE__*/ nodeImmutable( Material
 /**
  * TSL object that represents the attenuation color of the current material.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const materialAttenuationColor = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.ATTENUATION_COLOR );
@@ -657,6 +683,7 @@ export const materialAttenuationColor = /*@__PURE__*/ nodeImmutable( MaterialNod
 /**
  * TSL object that represents the scale of the current dashed line material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialLineScale = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.LINE_SCALE );
@@ -664,6 +691,7 @@ export const materialLineScale = /*@__PURE__*/ nodeImmutable( MaterialNode, Mate
 /**
  * TSL object that represents the dash size of the current dashed line material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialLineDashSize = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.LINE_DASH_SIZE );
@@ -671,6 +699,7 @@ export const materialLineDashSize = /*@__PURE__*/ nodeImmutable( MaterialNode, M
 /**
  * TSL object that represents the gap size of the current dashed line material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialLineGapSize = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.LINE_GAP_SIZE );
@@ -678,6 +707,7 @@ export const materialLineGapSize = /*@__PURE__*/ nodeImmutable( MaterialNode, Ma
 /**
  * TSL object that represents the line width of the current line material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialLineWidth = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.LINE_WIDTH );
@@ -685,6 +715,7 @@ export const materialLineWidth = /*@__PURE__*/ nodeImmutable( MaterialNode, Mate
 /**
  * TSL object that represents the dash offset of the current line material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialLineDashOffset = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.LINE_DASH_OFFSET );
@@ -692,6 +723,7 @@ export const materialLineDashOffset = /*@__PURE__*/ nodeImmutable( MaterialNode,
 /**
  * TSL object that represents the point size of the current points material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialPointSize = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.POINT_SIZE );
@@ -699,6 +731,7 @@ export const materialPointSize = /*@__PURE__*/ nodeImmutable( MaterialNode, Mate
 /**
  * TSL object that represents the dispersion of the current material.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialDispersion = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.DISPERSION );
@@ -707,6 +740,7 @@ export const materialDispersion = /*@__PURE__*/ nodeImmutable( MaterialNode, Mat
  * TSL object that represents the light map of the current material.
  * The value is composed via `lightMapIntensity` * `lightMap.rgb`.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const materialLightMap = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.LIGHT_MAP );
@@ -715,6 +749,7 @@ export const materialLightMap = /*@__PURE__*/ nodeImmutable( MaterialNode, Mater
  * TSL object that represents the ambient occlusion map of the current material.
  * The value is composed via `aoMap.r` - 1 * `aoMapIntensity` + 1.
  *
+ * @tsl
  * @type {Node<float>}
  */
 export const materialAO = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNode.AO );
@@ -722,6 +757,7 @@ export const materialAO = /*@__PURE__*/ nodeImmutable( MaterialNode, MaterialNod
 /**
  * TSL object that represents the anisotropy vector of the current material.
  *
+ * @tsl
  * @type {Node<vec2>}
  */
 export const materialAnisotropyVector = /*@__PURE__*/ uniform( new Vector2() ).onReference( function ( frame ) {

package/src/nodes/accessors/MaterialProperties.js

@@ -1,10 +1,59 @@
+import { Euler } from '../../math/Euler.js';
+import { Matrix4 } from '../../math/Matrix4.js';
 import { uniform } from '../core/UniformNode.js';
 
-/** @module MaterialProperties **/
+const _e1 = /*@__PURE__*/ new Euler();
+const _m1 = /*@__PURE__*/ new Matrix4();
 
 /**
  * TSL object that represents the refraction ratio of the material used for rendering the current object.
  *
+ * @tsl
  * @type {UniformNode<float>}
  */
-export const materialRefractionRatio = /*@__PURE__*/ uniform( 0 ).onReference( ( { material } ) => material ).onRenderUpdate( ( { material } ) => material.refractionRatio );
+export const materialRefractionRatio = /*@__PURE__*/ uniform( 0 ).onReference( ( { material } ) => material ).onObjectUpdate( ( { material } ) => material.refractionRatio );
+
+/**
+ * TSL object that represents the intensity of environment maps of PBR materials.
+ * When `material.envMap` is set, the value is `material.envMapIntensity` otherwise `scene.environmentIntensity`.
+ *
+ * @tsl
+ * @type {Node<float>}
+ */
+export const materialEnvIntensity = /*@__PURE__*/ uniform( 1 ).onReference( ( { material } ) => material ).onObjectUpdate( function ( { material, scene } ) {
+
+	return material.envMap ? material.envMapIntensity : scene.environmentIntensity;
+
+} );
+
+/**
+ * TSL object that represents the rotation of environment maps.
+ * When `material.envMap` is set, the value is `material.envMapRotation`. `scene.environmentRotation` controls the
+ * rotation of `scene.environment` instead.
+ *
+ * @tsl
+ * @type {Node<mat4>}
+ */
+export const materialEnvRotation = /*@__PURE__*/ uniform( new Matrix4() ).onReference( function ( frame ) {
+
+	return frame.material;
+
+} ).onObjectUpdate( function ( { material, scene } ) {
+
+	const rotation = ( scene.environment !== null && material.envMap === null ) ? scene.environmentRotation : material.envMapRotation;
+
+	if ( rotation ) {
+
+		_e1.copy( rotation );
+
+		_m1.makeRotationFromEuler( _e1 );
+
+	} else {
+
+		_m1.identity();
+
+	}
+
+	return _m1;
+
+} );

package/src/nodes/accessors/MaterialReferenceNode.js

@@ -1,8 +1,6 @@
 import ReferenceNode from './ReferenceNode.js';
 import { nodeObject } from '../tsl/TSLBase.js';
 
-/** @module MaterialReferenceNode **/
-
 /**
  * This node is a special type of reference node which is intended
  * for linking material properties with node values.
@@ -12,7 +10,7 @@ import { nodeObject } from '../tsl/TSLBase.js';
  * When changing `material.opacity`, the node value of `opacityNode` will
  * automatically be updated.
  *
- * @augments module:ReferenceNode~ReferenceNode
+ * @augments ReferenceNode
  */
 class MaterialReferenceNode extends ReferenceNode {
 
@@ -25,9 +23,9 @@ class MaterialReferenceNode extends ReferenceNode {
 	/**
 	 * Constructs a new material reference node.
 	 *
-	 * @param {String} property - The name of the property the node refers to.
-	 * @param {String} inputType - The uniform type that should be used to represent the property value.
-	 * @param {Material?} [material=null] - The material the property belongs to. When no material is set,
+	 * @param {string} property - The name of the property the node refers to.
+	 * @param {string} inputType - The uniform type that should be used to represent the property value.
+	 * @param {?Material} [material=null] - The material the property belongs to. When no material is set,
 	 * the node refers to the material of the current rendered object.
 	 */
 	constructor( property, inputType, material = null ) {
@@ -38,7 +36,7 @@ class MaterialReferenceNode extends ReferenceNode {
 		 * The material the property belongs to. When no material is set,
 		 * the node refers to the material of the current rendered object.
 		 *
-		 * @type {Material?}
+		 * @type {?Material}
 		 * @default null
 		 */
 		this.material = material;
@@ -46,7 +44,7 @@ class MaterialReferenceNode extends ReferenceNode {
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -56,7 +54,7 @@ class MaterialReferenceNode extends ReferenceNode {
 
 	/**
 	 * Updates the reference based on the given state. The state is only evaluated
-	 * {@link module:MaterialReferenceNode~MaterialReferenceNode#material} is not set.
+	 * {@link MaterialReferenceNode#material} is not set.
 	 *
 	 * @param {(NodeFrame|NodeBuilder)} state - The current state.
 	 * @return {Object} The updated reference.
@@ -76,10 +74,11 @@ export default MaterialReferenceNode;
 /**
  * TSL function for creating a material reference node.
  *
+ * @tsl
  * @function
- * @param {String} name - The name of the property the node refers to.
- * @param {String} type - The uniform type that should be used to represent the property value.
- * @param {Material?} [material=null] - The material the property belongs to.
+ * @param {string} name - The name of the property the node refers to.
+ * @param {string} type - The uniform type that should be used to represent the property value.
+ * @param {?Material} [material=null] - The material the property belongs to.
  * When no material is set, the node refers to the material of the current rendered object.
  * @returns {MaterialReferenceNode}
  */

package/src/nodes/accessors/ModelNode.js

@@ -6,15 +6,13 @@ import { Matrix4 } from '../../math/Matrix4.js';
 import { cameraViewMatrix } from './Camera.js';
 import { Matrix3 } from '../../math/Matrix3.js';
 
-/** @module ModelNode **/
-
 /**
  * This type of node is a specialized version of `Object3DNode`
  * with larger set of model related metrics. Unlike `Object3DNode`,
  * `ModelNode` extracts the reference to the 3D object from the
  * current node frame state.
  *
- * @augments module:Object3DNode~Object3DNode
+ * @augments Object3DNode
  */
 class ModelNode extends Object3DNode {
 
@@ -56,6 +54,7 @@ export default ModelNode;
 /**
  * TSL object that represents the object's direction in world space.
  *
+ * @tsl
  * @type {ModelNode<vec3>}
  */
 export const modelDirection = /*@__PURE__*/ nodeImmutable( ModelNode, ModelNode.DIRECTION );
@@ -63,6 +62,7 @@ export const modelDirection = /*@__PURE__*/ nodeImmutable( ModelNode, ModelNode.
 /**
  * TSL object that represents the object's world matrix.
  *
+ * @tsl
  * @type {ModelNode<mat4>}
  */
 export const modelWorldMatrix = /*@__PURE__*/ nodeImmutable( ModelNode, ModelNode.WORLD_MATRIX );
@@ -70,6 +70,7 @@ export const modelWorldMatrix = /*@__PURE__*/ nodeImmutable( ModelNode, ModelNod
 /**
  * TSL object that represents the object's position in world space.
  *
+ * @tsl
  * @type {ModelNode<vec3>}
  */
 export const modelPosition = /*@__PURE__*/ nodeImmutable( ModelNode, ModelNode.POSITION );
@@ -77,6 +78,7 @@ export const modelPosition = /*@__PURE__*/ nodeImmutable( ModelNode, ModelNode.P
 /**
  * TSL object that represents the object's scale in world space.
  *
+ * @tsl
  * @type {ModelNode<vec3>}
  */
 export const modelScale = /*@__PURE__*/ nodeImmutable( ModelNode, ModelNode.SCALE );
@@ -84,13 +86,23 @@ export const modelScale = /*@__PURE__*/ nodeImmutable( ModelNode, ModelNode.SCAL
 /**
  * TSL object that represents the object's position in view/camera space.
  *
+ * @tsl
  * @type {ModelNode<vec3>}
  */
 export const modelViewPosition = /*@__PURE__*/ nodeImmutable( ModelNode, ModelNode.VIEW_POSITION );
 
+/**
+ * TSL object that represents the object's radius.
+ *
+ * @tsl
+ * @type {ModelNode<float>}
+ */
+export const modelRadius = /*@__PURE__*/ nodeImmutable( ModelNode, ModelNode.RADIUS );
+
 /**
  * TSL object that represents the object's normal matrix.
  *
+ * @tsl
  * @type {UniformNode<mat3>}
  */
 export const modelNormalMatrix = /*@__PURE__*/ uniform( new Matrix3() ).onObjectUpdate( ( { object }, self ) => self.value.getNormalMatrix( object.matrixWorld ) );
@@ -98,6 +110,7 @@ export const modelNormalMatrix = /*@__PURE__*/ uniform( new Matrix3() ).onObject
 /**
  * TSL object that represents the object's inverse world matrix.
  *
+ * @tsl
  * @type {UniformNode<mat4>}
  */
 export const modelWorldMatrixInverse = /*@__PURE__*/ uniform( new Matrix4() ).onObjectUpdate( ( { object }, self ) => self.value.copy( object.matrixWorld ).invert() );
@@ -105,6 +118,7 @@ export const modelWorldMatrixInverse = /*@__PURE__*/ uniform( new Matrix4() ).on
 /**
  * TSL object that represents the object's model view matrix.
  *
+ * @tsl
  * @type {Node<mat4>}
  */
 export const modelViewMatrix = /*@__PURE__*/ ( Fn( ( builder ) => {
@@ -118,6 +132,7 @@ export const modelViewMatrix = /*@__PURE__*/ ( Fn( ( builder ) => {
 /**
  * TSL object that represents the object's model view in `mediump` precision.
  *
+ * @tsl
  * @type {Node<mat4>}
  */
 export const mediumpModelViewMatrix = /*@__PURE__*/ cameraViewMatrix.mul( modelWorldMatrix );
@@ -128,6 +143,7 @@ export const mediumpModelViewMatrix = /*@__PURE__*/ cameraViewMatrix.mul( modelW
  * TSL object that represents the object's model view in `highp` precision
  * which is achieved by computing the matrix in JS and not in the shader.
  *
+ * @tsl
  * @type {Node<mat4>}
  */
 export const highpModelViewMatrix = /*@__PURE__*/ ( Fn( ( builder ) => {
@@ -146,6 +162,7 @@ export const highpModelViewMatrix = /*@__PURE__*/ ( Fn( ( builder ) => {
  * TSL object that represents the object's model normal view in `highp` precision
  * which is achieved by computing the matrix in JS and not in the shader.
  *
+ * @tsl
  * @type {Node<mat3>}
  */
 export const highpModelNormalViewMatrix = /*@__PURE__*/ ( Fn( ( builder ) => {

package/src/nodes/accessors/ModelViewProjectionNode.js

@@ -1,10 +1,9 @@
 import { Fn } from '../tsl/TSLCore.js';
 
-/** @module ModelViewProjectionNode **/
-
 /**
  * TSL object that represents the position in clip space after the model-view-projection transform of the current rendered object.
  *
+ * @tsl
  * @type {VaryingNode<vec4>}
  */
 export const modelViewProjection = /*@__PURE__*/ ( Fn( ( builder ) => {