super-three 0.173.5 → 0.176.0

package/src/math/interpolants/CubicInterpolant.js

@@ -7,10 +7,19 @@ import { Interpolant } from '../Interpolant.js';
  * It was derived from a Hermitian construction setting the first derivative
  * at each sample position to the linear slope between neighboring positions
  * over their parameter interval.
+ *
+ * @augments Interpolant
  */
-
 class CubicInterpolant extends Interpolant {
 
+	/**
+	 * Constructs a new cubic interpolant.
+	 *
+	 * @param {TypedArray} parameterPositions - The parameter positions hold the interpolation factors.
+	 * @param {TypedArray} sampleValues - The sample values.
+	 * @param {number} sampleSize - The sample size
+	 * @param {TypedArray} [resultBuffer] - The result buffer.
+	 */
 	constructor( parameterPositions, sampleValues, sampleSize, resultBuffer ) {
 
 		super( parameterPositions, sampleValues, sampleSize, resultBuffer );

package/src/math/interpolants/DiscreteInterpolant.js

@@ -1,13 +1,21 @@
 import { Interpolant } from '../Interpolant.js';
 
 /**
- *
  * Interpolant that evaluates to the sample value at the position preceding
  * the parameter.
+ *
+ * @augments Interpolant
  */
-
 class DiscreteInterpolant extends Interpolant {
 
+	/**
+	 * Constructs a new discrete interpolant.
+	 *
+	 * @param {TypedArray} parameterPositions - The parameter positions hold the interpolation factors.
+	 * @param {TypedArray} sampleValues - The sample values.
+	 * @param {number} sampleSize - The sample size
+	 * @param {TypedArray} [resultBuffer] - The result buffer.
+	 */
 	constructor( parameterPositions, sampleValues, sampleSize, resultBuffer ) {
 
 		super( parameterPositions, sampleValues, sampleSize, resultBuffer );

package/src/math/interpolants/LinearInterpolant.js

@@ -1,7 +1,20 @@
 import { Interpolant } from '../Interpolant.js';
 
+/**
+ * A basic linear interpolant.
+ *
+ * @augments Interpolant
+ */
 class LinearInterpolant extends Interpolant {
 
+	/**
+	 * Constructs a new linear interpolant.
+	 *
+	 * @param {TypedArray} parameterPositions - The parameter positions hold the interpolation factors.
+	 * @param {TypedArray} sampleValues - The sample values.
+	 * @param {number} sampleSize - The sample size
+	 * @param {TypedArray} [resultBuffer] - The result buffer.
+	 */
 	constructor( parameterPositions, sampleValues, sampleSize, resultBuffer ) {
 
 		super( parameterPositions, sampleValues, sampleSize, resultBuffer );

package/src/math/interpolants/QuaternionLinearInterpolant.js

@@ -3,10 +3,19 @@ import { Quaternion } from '../Quaternion.js';
 
 /**
  * Spherical linear unit quaternion interpolant.
+ *
+ * @augments Interpolant
  */
-
 class QuaternionLinearInterpolant extends Interpolant {
 
+	/**
+	 * Constructs a new SLERP interpolant.
+	 *
+	 * @param {TypedArray} parameterPositions - The parameter positions hold the interpolation factors.
+	 * @param {TypedArray} sampleValues - The sample values.
+	 * @param {number} sampleSize - The sample size
+	 * @param {TypedArray} [resultBuffer] - The result buffer.
+	 */
 	constructor( parameterPositions, sampleValues, sampleSize, resultBuffer ) {
 
 		super( parameterPositions, sampleValues, sampleSize, resultBuffer );

package/src/nodes/Nodes.js

@@ -56,6 +56,7 @@ export { default as TriplanarTexturesNode } from './utils/TriplanarTexturesNode.
 export { default as ReflectorNode } from './utils/ReflectorNode.js';
 export { default as RTTNode } from './utils/RTTNode.js';
 export { default as MemberNode } from './utils/MemberNode.js';
+export { default as DebugNode } from './utils/DebugNode.js';
 
 // accessors
 export { default as UniformArrayNode } from './accessors/UniformArrayNode.js';

package/src/nodes/TSL.js

@@ -134,6 +134,7 @@ export * from './lighting/LightsNode.js';
 export * from './lighting/LightingContextNode.js';
 export * from './lighting/ShadowBaseNode.js';
 export * from './lighting/ShadowNode.js';
+export * from './lighting/PointShadowNode.js';
 export * from './lighting/PointLightNode.js';
 
 // pmrem

package/src/nodes/accessors/AccessorsUtils.js

@@ -6,11 +6,10 @@ import { mix } from '../math/MathNode.js';
 import { anisotropy, anisotropyB, roughness } from '../core/PropertyNode.js';
 import { positionViewDirection } from './Position.js';
 
-/** @module AccessorsUtils **/
-
 /**
  * TSL object that represents the TBN matrix in view space.
  *
+ * @tsl
  * @type {Node<mat3>}
  */
 export const TBNViewMatrix = /*@__PURE__*/ mat3( tangentView, bitangentView, normalView );
@@ -18,6 +17,7 @@ export const TBNViewMatrix = /*@__PURE__*/ mat3( tangentView, bitangentView, nor
 /**
  * TSL object that represents the parallax direction.
  *
+ * @tsl
  * @type {Node<mat3>}
  */
 export const parallaxDirection = /*@__PURE__*/ positionViewDirection.mul( TBNViewMatrix )/*.normalize()*/;
@@ -25,6 +25,7 @@ export const parallaxDirection = /*@__PURE__*/ positionViewDirection.mul( TBNVie
 /**
  * TSL function for computing parallax uv coordinates.
  *
+ * @tsl
  * @function
  * @param {Node<vec2>} uv - A uv node.
  * @param {Node<vec2>} scale - A scale node.
@@ -35,6 +36,7 @@ export const parallaxUV = ( uv, scale ) => uv.sub( parallaxDirection.mul( scale
 /**
  * TSL function for computing bent normals.
  *
+ * @tsl
  * @function
  * @returns {Node<vec3>} Bent normals.
  */

package/src/nodes/accessors/Arrays.js

@@ -3,14 +3,13 @@ import StorageBufferAttribute from '../../renderers/common/StorageBufferAttribut
 import { storage } from './StorageBufferNode.js';
 import { getLengthFromType, getTypedArrayFromType } from '../core/NodeUtils.js';
 
-/** @module Arrays **/
-
 /**
  * TSL function for creating a storage buffer node with a configured `StorageBufferAttribute`.
  *
+ * @tsl
  * @function
- * @param {Number|TypedArray} count - The data count. It is also valid to pass a typed array as an argument.
- * @param {String|Struct} [type='float'] - The data type.
+ * @param {number|TypedArray} count - The data count. It is also valid to pass a typed array as an argument.
+ * @param {string|Struct} [type='float'] - The data type.
  * @returns {StorageBufferNode}
  */
 export const attributeArray = ( count, type = 'float' ) => {
@@ -39,9 +38,10 @@ export const attributeArray = ( count, type = 'float' ) => {
 /**
  * TSL function for creating a storage buffer node with a configured `StorageInstancedBufferAttribute`.
  *
+ * @tsl
  * @function
- * @param {Number|TypedArray} count - The data count. It is also valid to pass a typed array as an argument.
- * @param {String|Struct} [type='float'] - The data type.
+ * @param {number|TypedArray} count - The data count. It is also valid to pass a typed array as an argument.
+ * @param {string|Struct} [type='float'] - The data type.
  * @returns {StorageBufferNode}
  */
 export const instancedArray = ( count, type = 'float' ) => {

package/src/nodes/accessors/BatchNode.js

@@ -8,8 +8,6 @@ import { tangentLocal } from './Tangent.js';
 import { instanceIndex, drawIndex } from '../core/IndexNode.js';
 import { varyingProperty } from '../core/PropertyNode.js';
 
-/** @module BatchNode **/
-
 /**
  * This node implements the vertex shader logic which is required
  * when rendering 3D objects via batching. `BatchNode` must be used
@@ -44,7 +42,7 @@ class BatchNode extends Node {
 		/**
 		 * The batching index node.
 		 *
-		 * @type {IndexNode?}
+		 * @type {?IndexNode}
 		 * @default null
 		 */
 		this.batchingIdNode = null;
@@ -76,8 +74,8 @@ class BatchNode extends Node {
 
 		const getIndirectIndex = Fn( ( [ id ] ) => {
 
-			const size = int( textureSize( textureLoad( this.batchMesh._indirectTexture ), 0 ) );
-			const x = int( id ).modInt( size );
+			const size = int( textureSize( textureLoad( this.batchMesh._indirectTexture ), 0 ).x );
+			const x = int( id ).mod( size );
 			const y = int( id ).div( size );
 			return textureLoad( this.batchMesh._indirectTexture, ivec2( x, y ) ).x;
 
@@ -93,11 +91,11 @@ class BatchNode extends Node {
 
 		const matricesTexture = this.batchMesh._matricesTexture;
 
-		const size = textureSize( textureLoad( matricesTexture ), 0 );
+		const size = int( textureSize( textureLoad( matricesTexture ), 0 ).x );
 		const j = float( indirectId ).mul( 4 ).toInt().toVar();
 
-		const x = j.modInt( size );
-		const y = j.div( int( size ) );
+		const x = j.mod( size );
+		const y = j.div( size );
 		const batchingMatrix = mat4(
 			textureLoad( matricesTexture, ivec2( x, y ) ),
 			textureLoad( matricesTexture, ivec2( x.add( 1 ), y ) ),
@@ -112,9 +110,9 @@ class BatchNode extends Node {
 
 			const getBatchingColor = Fn( ( [ id ] ) => {
 
-				const size = textureSize( textureLoad( colorsTexture ), 0 ).x;
+				const size = int( textureSize( textureLoad( colorsTexture ), 0 ).x );
 				const j = id;
-				const x = j.modInt( size );
+				const x = j.mod( size );
 				const y = j.div( size );
 				return textureLoad( colorsTexture, ivec2( x, y ) ).rgb;
 
@@ -157,8 +155,9 @@ export default BatchNode;
 /**
  * TSL function for creating a batch node.
  *
+ * @tsl
  * @function
  * @param {BatchedMesh} batchMesh - A reference to batched mesh.
  * @returns {BatchNode}
  */
-export const batch = /*@__PURE__*/ nodeProxy( BatchNode );
+export const batch = /*@__PURE__*/ nodeProxy( BatchNode ).setParameterLength( 1 );

package/src/nodes/accessors/Bitangent.js

@@ -3,13 +3,12 @@ import { cameraViewMatrix } from './Camera.js';
 import { normalGeometry, normalLocal, normalView, normalWorld, transformedNormalView } from './Normal.js';
 import { tangentGeometry, tangentLocal, tangentView, tangentWorld, transformedTangentView } from './Tangent.js';
 
-/** @module Bitangent **/
-
 const getBitangent = ( crossNormalTangent ) => crossNormalTangent.mul( tangentGeometry.w ).xyz;
 
 /**
  * TSL object that represents the bitangent attribute of the current rendered object.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const bitangentGeometry = /*@__PURE__*/ varying( getBitangent( normalGeometry.cross( tangentGeometry ) ), 'v_bitangentGeometry' ).normalize().toVar( 'bitangentGeometry' );
@@ -17,6 +16,7 @@ export const bitangentGeometry = /*@__PURE__*/ varying( getBitangent( normalGeom
 /**
  * TSL object that represents the vertex bitangent in local space of the current rendered object.
  *
+ * @tsl
  * @type {Node<vec3>}
  */
 export const bitangentLocal = /*@__PURE__*/ varying( getBitangent( normalLocal.cross( tangentLocal ) ), 'v_bitangentLocal' ).normalize().toVar( 'bitangentLocal' );
@@ -24,6 +24,7 @@ export const bitangentLocal = /*@__PURE__*/ varying( getBitangent( normalLocal.c
 /**
  * TSL object that represents the vertex bitangent in view space of the current rendered object.
  *
+ * @tsl
  * @type {Node<vec4>}
  */
 export const bitangentView = /*@__PURE__*/ varying( getBitangent( normalView.cross( tangentView ) ), 'v_bitangentView' ).normalize().toVar( 'bitangentView' );
@@ -31,6 +32,7 @@ export const bitangentView = /*@__PURE__*/ varying( getBitangent( normalView.cro
 /**
  * TSL object that represents the vertex bitangent in world space of the current rendered object.
  *
+ * @tsl
  * @type {Node<vec4>}
  */
 export const bitangentWorld = /*@__PURE__*/ varying( getBitangent( normalWorld.cross( tangentWorld ) ), 'v_bitangentWorld' ).normalize().toVar( 'bitangentWorld' );
@@ -38,6 +40,7 @@ export const bitangentWorld = /*@__PURE__*/ varying( getBitangent( normalWorld.c
 /**
  * TSL object that represents the transformed vertex bitangent in view space of the current rendered object.
  *
+ * @tsl
  * @type {Node<vec4>}
  */
 export const transformedBitangentView = /*@__PURE__*/ getBitangent( transformedNormalView.cross( transformedTangentView ) ).normalize().toVar( 'transformedBitangentView' );
@@ -45,6 +48,7 @@ export const transformedBitangentView = /*@__PURE__*/ getBitangent( transformedN
 /**
  * TSL object that represents the transformed vertex bitangent in world space of the current rendered object.
  *
+ * @tsl
  * @type {Node<vec4>}
  */
 export const transformedBitangentWorld = /*@__PURE__*/ transformedBitangentView.transformDirection( cameraViewMatrix ).normalize().toVar( 'transformedBitangentWorld' );

package/src/nodes/accessors/BufferAttributeNode.js

@@ -6,8 +6,6 @@ import { InterleavedBufferAttribute } from '../../core/InterleavedBufferAttribut
 import { InterleavedBuffer } from '../../core/InterleavedBuffer.js';
 import { StaticDrawUsage, DynamicDrawUsage } from '../../constants.js';
 
-/** @module BufferAttributeNode **/
-
 /**
  * In earlier `three.js` versions it was only possible to define attribute data
  * on geometry level. With `BufferAttributeNode`, it is also possible to do this
@@ -42,9 +40,9 @@ class BufferAttributeNode extends InputNode {
 	 * Constructs a new buffer attribute node.
 	 *
 	 * @param {BufferAttribute|InterleavedBuffer|TypedArray} value - The attribute data.
-	 * @param {String?} [bufferType=null] - The buffer type (e.g. `'vec3'`).
-	 * @param {Number} [bufferStride=0] - The buffer stride.
-	 * @param {Number} [bufferOffset=0] - The buffer offset.
+	 * @param {?string} [bufferType=null] - The buffer type (e.g. `'vec3'`).
+	 * @param {number} [bufferStride=0] - The buffer stride.
+	 * @param {number} [bufferOffset=0] - The buffer offset.
 	 */
 	constructor( value, bufferType = null, bufferStride = 0, bufferOffset = 0 ) {
 
@@ -53,7 +51,7 @@ class BufferAttributeNode extends InputNode {
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -62,7 +60,7 @@ class BufferAttributeNode extends InputNode {
 		/**
 		 * The buffer type (e.g. `'vec3'`).
 		 *
-		 * @type {String}
+		 * @type {?string}
 		 * @default null
 		 */
 		this.bufferType = bufferType;
@@ -70,7 +68,7 @@ class BufferAttributeNode extends InputNode {
 		/**
 		 * The buffer stride.
 		 *
-		 * @type {Number}
+		 * @type {number}
 		 * @default 0
 		 */
 		this.bufferStride = bufferStride;
@@ -78,7 +76,7 @@ class BufferAttributeNode extends InputNode {
 		/**
 		 * The buffer offset.
 		 *
-		 * @type {Number}
+		 * @type {number}
 		 * @default 0
 		 */
 		this.bufferOffset = bufferOffset;
@@ -87,7 +85,7 @@ class BufferAttributeNode extends InputNode {
 		 * The usage property. Set this to `THREE.DynamicDrawUsage` via `.setUsage()`,
 		 * if you are planning to update the attribute data per frame.
 		 *
-		 * @type {Number}
+		 * @type {number}
 		 * @default StaticDrawUsage
 		 */
 		this.usage = StaticDrawUsage;
@@ -95,7 +93,7 @@ class BufferAttributeNode extends InputNode {
 		/**
 		 * Whether the attribute is instanced or not.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @default false
 		 */
 		this.instanced = false;
@@ -103,7 +101,7 @@ class BufferAttributeNode extends InputNode {
 		/**
 		 * A reference to the buffer attribute.
 		 *
-		 * @type {BufferAttribute?}
+		 * @type {?BufferAttribute}
 		 * @default null
 		 */
 		this.attribute = null;
@@ -111,7 +109,7 @@ class BufferAttributeNode extends InputNode {
 		/**
 		 * `BufferAttributeNode` sets this property to `true` by default.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @default true
 		 */
 		this.global = true;
@@ -131,7 +129,7 @@ class BufferAttributeNode extends InputNode {
 	 * and thus the hash should be shared as well.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The hash.
+	 * @return {string} The hash.
 	 */
 	getHash( builder ) {
 
@@ -162,7 +160,7 @@ class BufferAttributeNode extends InputNode {
 	 * the buffer attribute.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The node type.
+	 * @return {string} The node type.
 	 */
 	getNodeType( builder ) {
 
@@ -207,7 +205,7 @@ class BufferAttributeNode extends InputNode {
 	 * Generates the code snippet of the buffer attribute node.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The generated code snippet.
+	 * @return {string} The generated code snippet.
 	 */
 	generate( builder ) {
 
@@ -240,7 +238,7 @@ class BufferAttributeNode extends InputNode {
 	 * Overwrites the default implementation to return a fixed value `'bufferAttribute'`.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The input type.
+	 * @return {string} The input type.
 	 */
 	getInputType( /*builder*/ ) {
 
@@ -251,7 +249,7 @@ class BufferAttributeNode extends InputNode {
 	/**
 	 * Sets the `usage` property to the given value.
 	 *
-	 * @param {Number} value - The usage to set.
+	 * @param {number} value - The usage to set.
 	 * @return {BufferAttributeNode} A reference to this node.
 	 */
 	setUsage( value ) {
@@ -271,7 +269,7 @@ class BufferAttributeNode extends InputNode {
 	/**
 	 * Sets the `instanced` property to the given value.
 	 *
-	 * @param {Boolean} value - The value to set.
+	 * @param {boolean} value - The value to set.
 	 * @return {BufferAttributeNode} A reference to this node.
 	 */
 	setInstanced( value ) {
@@ -289,11 +287,12 @@ export default BufferAttributeNode;
 /**
  * TSL function for creating a buffer attribute node.
  *
+ * @tsl
  * @function
  * @param {BufferAttribute|InterleavedBuffer|TypedArray} array - The attribute data.
- * @param {String?} [type=null] - The buffer type (e.g. `'vec3'`).
- * @param {Number} [stride=0] - The buffer stride.
- * @param {Number} [offset=0] - The buffer offset.
+ * @param {?string} [type=null] - The buffer type (e.g. `'vec3'`).
+ * @param {number} [stride=0] - The buffer stride.
+ * @param {number} [offset=0] - The buffer offset.
  * @returns {BufferAttributeNode}
  */
 export const bufferAttribute = ( array, type = null, stride = 0, offset = 0 ) => nodeObject( new BufferAttributeNode( array, type, stride, offset ) );
@@ -302,11 +301,12 @@ export const bufferAttribute = ( array, type = null, stride = 0, offset = 0 ) =>
  * TSL function for creating a buffer attribute node but with dynamic draw usage.
  * Use this function if attribute data are updated per frame.
  *
+ * @tsl
  * @function
  * @param {BufferAttribute|InterleavedBuffer|TypedArray} array - The attribute data.
- * @param {String?} [type=null] - The buffer type (e.g. `'vec3'`).
- * @param {Number} [stride=0] - The buffer stride.
- * @param {Number} [offset=0] - The buffer offset.
+ * @param {?string} [type=null] - The buffer type (e.g. `'vec3'`).
+ * @param {number} [stride=0] - The buffer stride.
+ * @param {number} [offset=0] - The buffer offset.
  * @returns {BufferAttributeNode}
  */
 export const dynamicBufferAttribute = ( array, type = null, stride = 0, offset = 0 ) => bufferAttribute( array, type, stride, offset ).setUsage( DynamicDrawUsage );
@@ -314,11 +314,12 @@ export const dynamicBufferAttribute = ( array, type = null, stride = 0, offset =
 /**
  * TSL function for creating a buffer attribute node but with enabled instancing
  *
+ * @tsl
  * @function
  * @param {BufferAttribute|InterleavedBuffer|TypedArray} array - The attribute data.
- * @param {String?} [type=null] - The buffer type (e.g. `'vec3'`).
- * @param {Number} [stride=0] - The buffer stride.
- * @param {Number} [offset=0] - The buffer offset.
+ * @param {?string} [type=null] - The buffer type (e.g. `'vec3'`).
+ * @param {number} [stride=0] - The buffer stride.
+ * @param {number} [offset=0] - The buffer offset.
  * @returns {BufferAttributeNode}
  */
 export const instancedBufferAttribute = ( array, type = null, stride = 0, offset = 0 ) => bufferAttribute( array, type, stride, offset ).setInstanced( true );
@@ -326,11 +327,12 @@ export const instancedBufferAttribute = ( array, type = null, stride = 0, offset
 /**
  * TSL function for creating a buffer attribute node but with dynamic draw usage and enabled instancing
  *
+ * @tsl
  * @function
  * @param {BufferAttribute|InterleavedBuffer|TypedArray} array - The attribute data.
- * @param {String?} [type=null] - The buffer type (e.g. `'vec3'`).
- * @param {Number} [stride=0] - The buffer stride.
- * @param {Number} [offset=0] - The buffer offset.
+ * @param {?string} [type=null] - The buffer type (e.g. `'vec3'`).
+ * @param {number} [stride=0] - The buffer stride.
+ * @param {number} [offset=0] - The buffer offset.
  * @returns {BufferAttributeNode}
  */
 export const instancedDynamicBufferAttribute = ( array, type = null, stride = 0, offset = 0 ) => dynamicBufferAttribute( array, type, stride, offset ).setInstanced( true );

package/src/nodes/accessors/BufferNode.js

@@ -1,8 +1,6 @@
 import UniformNode from '../core/UniformNode.js';
 import { nodeObject } from '../tsl/TSLBase.js';
 
-/** @module BufferNode **/
-
 /**
  * A special type of uniform node which represents array-like data
  * as uniform buffers. The access usually happens via `element()`
@@ -15,7 +13,7 @@ import { nodeObject } from '../tsl/TSLBase.js';
  * In general, it is recommended to use the more managed {@link UniformArrayNode}
  * since it handles more input types and automatically cares about buffer paddings.
  *
- * @augments module:UniformNode~UniformNode
+ * @augments UniformNode
  */
 class BufferNode extends UniformNode {
 
@@ -28,9 +26,9 @@ class BufferNode extends UniformNode {
 	/**
 	 * Constructs a new buffer node.
 	 *
-	 * @param {Array<Number>} value - Array-like buffer data.
-	 * @param {String} bufferType - The data type of the buffer.
-	 * @param {Number} [bufferCount=0] - The count of buffer elements.
+	 * @param {Array<number>} value - Array-like buffer data.
+	 * @param {string} bufferType - The data type of the buffer.
+	 * @param {number} [bufferCount=0] - The count of buffer elements.
 	 */
 	constructor( value, bufferType, bufferCount = 0 ) {
 
@@ -39,7 +37,7 @@ class BufferNode extends UniformNode {
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -48,14 +46,14 @@ class BufferNode extends UniformNode {
 		/**
 		 * The data type of the buffer.
 		 *
-		 * @type {String}
+		 * @type {string}
 		 */
 		this.bufferType = bufferType;
 
 		/**
 		 * The uniform node that holds the value of the reference node.
 		 *
-		 * @type {Number}
+		 * @type {number}
 		 * @default 0
 		 */
 		this.bufferCount = bufferCount;
@@ -66,7 +64,7 @@ class BufferNode extends UniformNode {
 	 * The data type of the buffer elements.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The element type.
+	 * @return {string} The element type.
 	 */
 	getElementType( builder ) {
 
@@ -78,7 +76,7 @@ class BufferNode extends UniformNode {
 	 * Overwrites the default implementation to return a fixed value `'buffer'`.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The input type.
+	 * @return {string} The input type.
 	 */
 	getInputType( /*builder*/ ) {
 
@@ -93,10 +91,11 @@ export default BufferNode;
 /**
  * TSL function for creating a buffer node.
  *
+ * @tsl
  * @function
  * @param {Array} value - Array-like buffer data.
- * @param {String} type - The data type of a buffer element.
- * @param {Number} count - The count of buffer elements.
+ * @param {string} type - The data type of a buffer element.
+ * @param {number} count - The count of buffer elements.
  * @returns {BufferNode}
  */
 export const buffer = ( value, type, count ) => nodeObject( new BufferNode( value, type, count ) );

package/src/nodes/accessors/BuiltinNode.js

@@ -1,8 +1,6 @@
 import Node from '../core/Node.js';
 import { nodeProxy } from '../tsl/TSLBase.js';
 
-/** @module BuiltinNode **/
-
 /**
  * The node allows to set values for built-in shader variables. That is
  * required for features like hardware-accelerated vertex clipping.
@@ -14,7 +12,7 @@ class BuiltinNode extends Node {
 	/**
 	 * Constructs a new builtin node.
 	 *
-	 * @param {String} name - The name of the built-in shader variable.
+	 * @param {string} name - The name of the built-in shader variable.
 	 */
 	constructor( name ) {
 
@@ -23,14 +21,14 @@ class BuiltinNode extends Node {
 		/**
 		 * The name of the built-in shader variable.
 		 *
-		 * @type {String}
+		 * @type {string}
 		 */
 		this.name = name;
 
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -42,7 +40,7 @@ class BuiltinNode extends Node {
 	 * Generates the code snippet of the builtin node.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The generated code snippet.
+	 * @return {string} The generated code snippet.
 	 */
 	generate( /* builder */ ) {
 
@@ -57,8 +55,9 @@ export default BuiltinNode;
 /**
  * TSL function for creating a builtin node.
  *
+ * @tsl
  * @function
- * @param {String} name - The name of the built-in shader variable.
+ * @param {string} name - The name of the built-in shader variable.
  * @returns {BuiltinNode}
  */
-export const builtin = nodeProxy( BuiltinNode );
+export const builtin = nodeProxy( BuiltinNode ).setParameterLength( 1 );