super-three 0.173.4 → 0.175.0

package/src/nodes/utils/RTTNode.js

@@ -9,8 +9,6 @@ import { RenderTarget } from '../../core/RenderTarget.js';
 import { Vector2 } from '../../math/Vector2.js';
 import { HalfFloatType } from '../../constants.js';
 
-/** @module RTTNode **/
-
 const _size = /*@__PURE__*/ new Vector2();
 
 /**
@@ -19,7 +17,7 @@ const _size = /*@__PURE__*/ new Vector2();
  * texture input for their effects. With the helper function `convertToTexture()` which is based
  * on this module, the node system can automatically ensure texture input if required.
  *
- * @augments module:TextureNode~TextureNode
+ * @augments TextureNode
  */
 class RTTNode extends TextureNode {
 
@@ -33,8 +31,8 @@ class RTTNode extends TextureNode {
 	 * Constructs a new RTT node.
 	 *
 	 * @param {Node} node - The node to render a texture with.
-	 * @param {Number?} [width=null] - The width of the internal render target. If not width is applied, the render target is automatically resized.
-	 * @param {Number?} [height=null] - The height of the internal render target.
+	 * @param {?number} [width=null] - The width of the internal render target. If not width is applied, the render target is automatically resized.
+	 * @param {?number} [height=null] - The height of the internal render target.
 	 * @param {Object} [options={type:HalfFloatType}] - The options for the internal render target.
 	 */
 	constructor( node, width = null, height = null, options = { type: HalfFloatType } ) {
@@ -54,7 +52,7 @@ class RTTNode extends TextureNode {
 		 * The width of the internal render target.
 		 * If not width is applied, the render target is automatically resized.
 		 *
-		 * @type {Number?}
+		 * @type {?number}
 		 * @default null
 		 */
 		this.width = width;
@@ -62,7 +60,7 @@ class RTTNode extends TextureNode {
 		/**
 		 * The height of the internal render target.
 		 *
-		 * @type {Number?}
+		 * @type {?number}
 		 * @default null
 		 */
 		this.height = height;
@@ -70,7 +68,7 @@ class RTTNode extends TextureNode {
 		/**
 		 * The pixel ratio
 		 *
-		 * @type {Number}
+		 * @type {number}
 		 * @default 1
 		 */
 		this.pixelRatio = 1;
@@ -85,7 +83,7 @@ class RTTNode extends TextureNode {
 		/**
 		 * Whether the texture requires an update or not.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @default true
 		 */
 		this.textureNeedsUpdate = true;
@@ -93,7 +91,7 @@ class RTTNode extends TextureNode {
 		/**
 		 * Whether the texture should automatically be updated or not.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @default true
 		 */
 		this.autoUpdate = true;
@@ -119,7 +117,7 @@ class RTTNode extends TextureNode {
 		 * The `updateBeforeType` is set to `NodeUpdateType.RENDER` since the node updates
 		 * the texture once per render in its {@link RTTNode#updateBefore} method.
 		 *
-		 * @type {String}
+		 * @type {string}
 		 * @default 'render'
 		 */
 		this.updateBeforeType = NodeUpdateType.RENDER;
@@ -129,7 +127,7 @@ class RTTNode extends TextureNode {
 	/**
 	 * Whether the internal render target should automatically be resized or not.
 	 *
-	 * @type {Boolean}
+	 * @type {boolean}
 	 * @readonly
 	 * @default true
 	 */
@@ -152,8 +150,8 @@ class RTTNode extends TextureNode {
 	/**
 	 * Sets the size of the internal render target
 	 *
-	 * @param {Number} width - The width to set.
-	 * @param {Number} height - The width to set.
+	 * @param {number} width - The width to set.
+	 * @param {number} height - The width to set.
 	 */
 	setSize( width, height ) {
 
@@ -172,7 +170,7 @@ class RTTNode extends TextureNode {
 	/**
 	 * Sets the pixel ratio. This will also resize the render target.
 	 *
-	 * @param {Number} pixelRatio - The pixel ratio to set.
+	 * @param {number} pixelRatio - The pixel ratio to set.
 	 */
 	setPixelRatio( pixelRatio ) {
 
@@ -233,10 +231,11 @@ export default RTTNode;
 /**
  * TSL function for creating a RTT node.
  *
+ * @tsl
  * @function
  * @param {Node} node - The node to render a texture with.
- * @param {Number?} [width=null] - The width of the internal render target. If not width is applied, the render target is automatically resized.
- * @param {Number?} [height=null] - The height of the internal render target.
+ * @param {?number} [width=null] - The width of the internal render target. If not width is applied, the render target is automatically resized.
+ * @param {?number} [height=null] - The height of the internal render target.
  * @param {Object} [options={type:HalfFloatType}] - The options for the internal render target.
  * @returns {RTTNode}
  */
@@ -245,10 +244,11 @@ export const rtt = ( node, ...params ) => nodeObject( new RTTNode( nodeObject( n
 /**
  * TSL function for converting nodes to textures nodes.
  *
+ * @tsl
  * @function
  * @param {Node} node - The node to render a texture with.
- * @param {Number?} [width=null] - The width of the internal render target. If not width is applied, the render target is automatically resized.
- * @param {Number?} [height=null] - The height of the internal render target.
+ * @param {?number} [width=null] - The width of the internal render target. If not width is applied, the render target is automatically resized.
+ * @param {?number} [height=null] - The height of the internal render target.
  * @param {Object} [options={type:HalfFloatType}] - The options for the internal render target.
  * @returns {RTTNode}
  */

package/src/nodes/utils/ReflectorNode.js

@@ -14,8 +14,6 @@ import { Matrix4 } from '../../math/Matrix4.js';
 import { RenderTarget } from '../../core/RenderTarget.js';
 import { DepthTexture } from '../../textures/DepthTexture.js';
 
-/** @module ReflectorNode **/
-
 const _reflectorPlane = new Plane();
 const _normal = new Vector3();
 const _reflectorWorldPosition = new Vector3();
@@ -48,7 +46,7 @@ let _inReflector = false;
  * plane.add( groundReflector.target );
  * ```
  *
- * @augments module:TextureNode~TextureNode
+ * @augments TextureNode
  */
 class ReflectorNode extends TextureNode {
 
@@ -63,10 +61,10 @@ class ReflectorNode extends TextureNode {
 	 *
 	 * @param {Object} [parameters={}] - An object holding configuration parameters.
 	 * @param {Object3D} [parameters.target=new Object3D()] - The 3D object the reflector is linked to.
-	 * @param {Number} [parameters.resolution=1] - The resolution scale.
-	 * @param {Boolean} [parameters.generateMipmaps=false] - Whether mipmaps should be generated or not.
-	 * @param {Boolean} [parameters.bounces=true] - Whether reflectors can render other reflector nodes or not.
-	 * @param {Boolean} [parameters.depth=false] - Whether depth data should be generated or not.
+	 * @param {number} [parameters.resolution=1] - The resolution scale.
+	 * @param {boolean} [parameters.generateMipmaps=false] - Whether mipmaps should be generated or not.
+	 * @param {boolean} [parameters.bounces=true] - Whether reflectors can render other reflector nodes or not.
+	 * @param {boolean} [parameters.depth=false] - Whether depth data should be generated or not.
 	 * @param {TextureNode} [parameters.defaultTexture] - The default texture node.
 	 * @param {ReflectorBaseNode} [parameters.reflector] - The reflector base node.
 	 */
@@ -78,8 +76,8 @@ class ReflectorNode extends TextureNode {
 		 * A reference to the internal reflector base node which holds the actual implementation.
 		 *
 		 * @private
-		 * @type {ReflectorBaseNode?}
-		 * @default null
+		 * @type {ReflectorBaseNode}
+		 * @default ReflectorBaseNode
 		 */
 		this._reflectorBaseNode = parameters.reflector || new ReflectorBaseNode( this, parameters );
 
@@ -87,7 +85,7 @@ class ReflectorNode extends TextureNode {
 		 * A reference to the internal depth node.
 		 *
 		 * @private
-		 * @type {Node?}
+		 * @type {?Node}
 		 * @default null
 		 */
 		this._depthNode = null;
@@ -188,10 +186,10 @@ class ReflectorBaseNode extends Node {
 	 * @param {TextureNode} textureNode - Represents the rendered reflections as a texture node.
 	 * @param {Object} [parameters={}] - An object holding configuration parameters.
 	 * @param {Object3D} [parameters.target=new Object3D()] - The 3D object the reflector is linked to.
-	 * @param {Number} [parameters.resolution=1] - The resolution scale.
-	 * @param {Boolean} [parameters.generateMipmaps=false] - Whether mipmaps should be generated or not.
-	 * @param {Boolean} [parameters.bounces=true] - Whether reflectors can render other reflector nodes or not.
-	 * @param {Boolean} [parameters.depth=false] - Whether depth data should be generated or not.
+	 * @param {number} [parameters.resolution=1] - The resolution scale.
+	 * @param {boolean} [parameters.generateMipmaps=false] - Whether mipmaps should be generated or not.
+	 * @param {boolean} [parameters.bounces=true] - Whether reflectors can render other reflector nodes or not.
+	 * @param {boolean} [parameters.depth=false] - Whether depth data should be generated or not.
 	 */
 	constructor( textureNode, parameters = {} ) {
 
@@ -223,7 +221,7 @@ class ReflectorBaseNode extends Node {
 		/**
 		 * The resolution scale.
 		 *
-		 * @type {Number}
+		 * @type {number}
 		 * @default {1}
 		 */
 		this.resolution = resolution;
@@ -231,7 +229,7 @@ class ReflectorBaseNode extends Node {
 		/**
 		 * Whether mipmaps should be generated or not.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @default {false}
 		 */
 		this.generateMipmaps = generateMipmaps;
@@ -239,7 +237,7 @@ class ReflectorBaseNode extends Node {
 		/**
 		 * Whether reflectors can render other reflector nodes or not.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @default {true}
 		 */
 		this.bounces = bounces;
@@ -247,7 +245,7 @@ class ReflectorBaseNode extends Node {
 		/**
 		 * Whether depth data should be generated or not.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @default {false}
 		 */
 		this.depth = depth;
@@ -256,7 +254,7 @@ class ReflectorBaseNode extends Node {
 		 * The `updateBeforeType` is set to `NodeUpdateType.RENDER` when {@link ReflectorBaseNode#bounces}
 		 * is `true`. Otherwise it's `NodeUpdateType.FRAME`.
 		 *
-		 * @type {String}
+		 * @type {string}
 		 * @default 'render'
 		 */
 		this.updateBeforeType = bounces ? NodeUpdateType.RENDER : NodeUpdateType.FRAME;
@@ -275,6 +273,14 @@ class ReflectorBaseNode extends Node {
 		 */
 		this.renderTargets = new WeakMap();
 
+		/**
+		 * Force render even if reflector is facing away from camera.
+		 *
+		 * @type {boolean}
+		 * @default {false}
+		 */
+		this.forceUpdate = false;
+
 	}
 
 	/**
@@ -389,9 +395,10 @@ class ReflectorBaseNode extends Node {
 
 		_view.subVectors( _reflectorWorldPosition, _cameraWorldPosition );
 
-		// Avoid rendering when reflector is facing away
+		// Avoid rendering when reflector is facing away unless forcing an update
+		const isFacingAway = _view.dot( _normal ) > 0;
 
-		if ( _view.dot( _normal ) > 0 ) return;
+		if ( isFacingAway === true && this.forceUpdate === false ) return;
 
 		_view.reflect( _normal ).negate();
 		_view.add( _reflectorWorldPosition );
@@ -476,6 +483,8 @@ class ReflectorBaseNode extends Node {
 
 		_inReflector = false;
 
+		this.forceUpdate = false;
+
 	}
 
 }
@@ -483,13 +492,14 @@ class ReflectorBaseNode extends Node {
 /**
  * TSL function for creating a reflector node.
  *
+ * @tsl
  * @function
  * @param {Object} [parameters={}] - An object holding configuration parameters.
  * @param {Object3D} [parameters.target=new Object3D()] - The 3D object the reflector is linked to.
- * @param {Number} [parameters.resolution=1] - The resolution scale.
- * @param {Boolean} [parameters.generateMipmaps=false] - Whether mipmaps should be generated or not.
- * @param {Boolean} [parameters.bounces=true] - Whether reflectors can render other reflector nodes or not.
- * @param {Boolean} [parameters.depth=false] - Whether depth data should be generated or not.
+ * @param {number} [parameters.resolution=1] - The resolution scale.
+ * @param {boolean} [parameters.generateMipmaps=false] - Whether mipmaps should be generated or not.
+ * @param {boolean} [parameters.bounces=true] - Whether reflectors can render other reflector nodes or not.
+ * @param {boolean} [parameters.depth=false] - Whether depth data should be generated or not.
  * @param {TextureNode} [parameters.defaultTexture] - The default texture node.
  * @param {ReflectorBaseNode} [parameters.reflector] - The reflector base node.
  * @returns {ReflectorNode}

package/src/nodes/utils/RemapNode.js

@@ -1,8 +1,6 @@
 import Node from '../core/Node.js';
 import { float, addMethodChaining, nodeProxy } from '../tsl/TSLCore.js';
 
-/** @module RemapNode **/
-
 /**
  * This node allows to remap a node value from one range into another. E.g a value of
  * `0.4` in the range `[ 0.3, 0.5 ]` should be remapped into the normalized range `[ 0, 1 ]`.
@@ -72,7 +70,7 @@ class RemapNode extends Node {
 		 * Whether the node value should be clamped before
 		 * remapping it to the target range.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @default true
 		 */
 		this.doClamp = true;
@@ -98,28 +96,30 @@ export default RemapNode;
 /**
  * TSL function for creating a remap node.
  *
+ * @tsl
  * @function
  * @param {Node} node - The node that should be remapped.
  * @param {Node} inLowNode - The source or current lower bound of the range.
  * @param {Node} inHighNode - The source or current upper bound of the range.
- * @param {Node} [outLowNode=float(0)] - The target lower bound of the range.
- * @param {Node} [outHighNode=float(1)] - The target upper bound of the range.
+ * @param {?Node} [outLowNode=float(0)] - The target lower bound of the range.
+ * @param {?Node} [outHighNode=float(1)] - The target upper bound of the range.
  * @returns {RemapNode}
  */
-export const remap = /*@__PURE__*/ nodeProxy( RemapNode, null, null, { doClamp: false } );
+export const remap = /*@__PURE__*/ nodeProxy( RemapNode, null, null, { doClamp: false } ).setParameterLength( 3, 5 );
 
 /**
  * TSL function for creating a remap node, but with enabled clamping.
  *
+ * @tsl
  * @function
  * @param {Node} node - The node that should be remapped.
  * @param {Node} inLowNode - The source or current lower bound of the range.
  * @param {Node} inHighNode - The source or current upper bound of the range.
- * @param {Node} [outLowNode=float(0)] - The target lower bound of the range.
- * @param {Node} [outHighNode=float(1)] - The target upper bound of the range.
+ * @param {?Node} [outLowNode=float(0)] - The target lower bound of the range.
+ * @param {?Node} [outHighNode=float(1)] - The target upper bound of the range.
  * @returns {RemapNode}
  */
-export const remapClamp = /*@__PURE__*/ nodeProxy( RemapNode );
+export const remapClamp = /*@__PURE__*/ nodeProxy( RemapNode ).setParameterLength( 3, 5 );
 
 addMethodChaining( 'remap', remap );
 addMethodChaining( 'remapClamp', remapClamp );

package/src/nodes/utils/RotateNode.js

@@ -2,8 +2,6 @@ import TempNode from '../core/TempNode.js';
 import { nodeProxy, vec4, mat2, mat4 } from '../tsl/TSLBase.js';
 import { cos, sin } from '../math/MathNode.js';
 
-/** @module RotateNode **/
-
 /**
  * Applies a rotation to the given position node.
  *
@@ -49,7 +47,7 @@ class RotateNode extends TempNode {
 	 * The type of the {@link RotateNode#positionNode} defines the node's type.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The node's type.
+	 * @return {string} The node's type.
 	 */
 	getNodeType( builder ) {
 
@@ -95,10 +93,11 @@ export default RotateNode;
 /**
  * TSL function for creating a rotate node.
  *
+ * @tsl
  * @function
  * @param {Node} positionNode - The position node.
  * @param {Node} rotationNode - Represents the rotation that is applied to the position node. Depending
  * on whether the position data are 2D or 3D, the rotation is expressed a single float value or an Euler value.
  * @returns {RotateNode}
  */
-export const rotate = /*@__PURE__*/ nodeProxy( RotateNode );
+export const rotate = /*@__PURE__*/ nodeProxy( RotateNode ).setParameterLength( 2 );

package/src/nodes/utils/SetNode.js

@@ -24,7 +24,7 @@ class SetNode extends TempNode {
 	 * Constructs a new set node.
 	 *
 	 * @param {Node} sourceNode - The node that should be updated.
-	 * @param {String} components - The components that should be updated.
+	 * @param {string} components - The components that should be updated.
 	 * @param {Node} targetNode - The value node.
 	 */
 	constructor( sourceNode, components, targetNode ) {
@@ -41,7 +41,7 @@ class SetNode extends TempNode {
 		/**
 		 * The components that should be updated.
 		 *
-		 * @type {String}
+		 * @type {string}
 		 */
 		this.components = components;
 
@@ -58,7 +58,7 @@ class SetNode extends TempNode {
 	 * This method is overwritten since the node type is inferred from {@link SetNode#sourceNode}.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The node type.
+	 * @return {string} The node type.
 	 */
 	getNodeType( builder ) {
 

package/src/nodes/utils/SplitNode.js

@@ -26,7 +26,7 @@ class SplitNode extends Node {
 	 * Constructs a new split node.
 	 *
 	 * @param {Node} node - The node that should be accessed.
-	 * @param {String} [components='x'] - The components that should be accessed.
+	 * @param {string} [components='x'] - The components that should be accessed.
 	 */
 	constructor( node, components = 'x' ) {
 
@@ -49,7 +49,7 @@ class SplitNode extends Node {
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -60,7 +60,7 @@ class SplitNode extends Node {
 	/**
 	 * Returns the vector length which is computed based on the requested components.
 	 *
-	 * @return {Number} The vector length.
+	 * @return {number} The vector length.
 	 */
 	getVectorLength() {
 
@@ -80,7 +80,7 @@ class SplitNode extends Node {
 	 * Returns the component type of the node's type.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The component type.
+	 * @return {string} The component type.
 	 */
 	getComponentType( builder ) {
 
@@ -92,7 +92,7 @@ class SplitNode extends Node {
 	 * This method is overwritten since the node type is inferred from requested components.
 	 *
 	 * @param {NodeBuilder} builder - The current node builder.
-	 * @return {String} The node type.
+	 * @return {string} The node type.
 	 */
 	getNodeType( builder ) {
 

package/src/nodes/utils/SpriteSheetUVNode.js

@@ -2,8 +2,6 @@ import Node from '../core/Node.js';
 import { uv } from '../accessors/UV.js';
 import { nodeProxy, float, vec2 } from '../tsl/TSLBase.js';
 
-/** @module SpriteSheetUVNode **/
-
 /**
  * Can be used to compute texture coordinates for animated sprite sheets.
  *
@@ -82,10 +80,11 @@ export default SpriteSheetUVNode;
 /**
  * TSL function for creating a sprite sheet uv node.
  *
+ * @tsl
  * @function
  * @param {Node<vec2>} countNode - The node that defines the number of sprites in the x and y direction (e.g 6x6).
- * @param {Node<vec2>} [uvNode=uv()] - The uv node.
- * @param {Node<float>} [frameNode=float()] - The node that defines the current frame/sprite.
+ * @param {?Node<vec2>} [uvNode=uv()] - The uv node.
+ * @param {?Node<float>} [frameNode=float()] - The node that defines the current frame/sprite.
  * @returns {SpriteSheetUVNode}
  */
-export const spritesheetUV = /*@__PURE__*/ nodeProxy( SpriteSheetUVNode );
+export const spritesheetUV = /*@__PURE__*/ nodeProxy( SpriteSheetUVNode ).setParameterLength( 3 );

package/src/nodes/utils/SpriteUtils.js

@@ -3,8 +3,6 @@ import { cameraViewMatrix, cameraProjectionMatrix } from '../accessors/Camera.js
 import { positionLocal } from '../accessors/Position.js';
 import { Fn, defined } from '../tsl/TSLBase.js';
 
-/** @module SpriteUtils **/
-
 /**
  * This can be used to achieve a billboarding behavior for flat meshes. That means they are
  * oriented always towards the camera.
@@ -13,11 +11,12 @@ import { Fn, defined } from '../tsl/TSLBase.js';
  * material.vertexNode = billboarding();
  * ```
  *
- * @method
+ * @tsl
+ * @function
  * @param {Object} config - The configuration object.
- * @param {Node<vec3>?} [config.position=null] - Can be used to define the vertex positions in world space.
- * @param {Boolean} [config.horizontal=true] - Whether to follow the camera rotation horizontally or not.
- * @param {Boolean} [config.vertical=false] - Whether to follow the camera rotation vertically or not.
+ * @param {?Node<vec3>} [config.position=null] - Can be used to define the vertex positions in world space.
+ * @param {boolean} [config.horizontal=true] - Whether to follow the camera rotation horizontally or not.
+ * @param {boolean} [config.vertical=false] - Whether to follow the camera rotation vertically or not.
  * @return {Node<vec3>} The updated vertex position in clip space.
  */
 export const billboarding = /*@__PURE__*/ Fn( ( { position = null, horizontal = true, vertical = false } ) => {

package/src/nodes/utils/StorageArrayElementNode.js

@@ -1,8 +1,6 @@
 import { nodeProxy } from '../tsl/TSLBase.js';
 import ArrayElementNode from './ArrayElementNode.js';
 
-/** @module StorageArrayElementNode **/
-
 /**
  * This class enables element access on instances of {@link StorageBufferNode}.
  * In most cases, it is indirectly used when accessing elements with the
@@ -35,7 +33,7 @@ class StorageArrayElementNode extends ArrayElementNode {
 		/**
 		 * This flag can be used for type testing.
 		 *
-		 * @type {Boolean}
+		 * @type {boolean}
 		 * @readonly
 		 * @default true
 		 */
@@ -136,9 +134,10 @@ export default StorageArrayElementNode;
 /**
  * TSL function for creating a storage element node.
  *
+ * @tsl
  * @function
  * @param {StorageBufferNode} storageBufferNode - The storage buffer node.
  * @param {Node} indexNode - The index node that defines the element access.
  * @returns {StorageArrayElementNode}
  */
-export const storageElement = /*@__PURE__*/ nodeProxy( StorageArrayElementNode );
+export const storageElement = /*@__PURE__*/ nodeProxy( StorageArrayElementNode ).setParameterLength( 2 );

package/src/nodes/utils/Timer.js

@@ -1,11 +1,10 @@
 import { renderGroup } from '../core/UniformGroupNode.js';
 import { uniform } from '../core/UniformNode.js';
 
-/** @module Timer **/
-
 /**
  * Represents the elapsed time in seconds.
  *
+ * @tsl
  * @type {UniformNode<float>}
  */
 export const time = /*@__PURE__*/ uniform( 0 ).setGroup( renderGroup ).onRenderUpdate( ( frame ) => frame.time );
@@ -13,6 +12,7 @@ export const time = /*@__PURE__*/ uniform( 0 ).setGroup( renderGroup ).onRenderU
 /**
  * Represents the delta time in seconds.
  *
+ * @tsl
  * @type {UniformNode<float>}
  */
 export const deltaTime = /*@__PURE__*/ uniform( 0 ).setGroup( renderGroup ).onRenderUpdate( ( frame ) => frame.deltaTime );
@@ -20,6 +20,7 @@ export const deltaTime = /*@__PURE__*/ uniform( 0 ).setGroup( renderGroup ).onRe
 /**
  * Represents the current frame ID.
  *
+ * @tsl
  * @type {UniformNode<uint>}
  */
 export const frameId = /*@__PURE__*/ uniform( 0, 'uint' ).setGroup( renderGroup ).onRenderUpdate( ( frame ) => frame.frameId );
@@ -27,10 +28,11 @@ export const frameId = /*@__PURE__*/ uniform( 0, 'uint' ).setGroup( renderGroup
 // Deprecated
 
 /**
+ * @tsl
  * @function
  * @deprecated since r170. Use {@link time} instead.
  *
- * @param {Number} [timeScale=1] - The time scale.
+ * @param {number} [timeScale=1] - The time scale.
  * @returns {UniformNode<float>}
  */
 export const timerLocal = ( timeScale = 1 ) => { // @deprecated, r170
@@ -41,10 +43,11 @@ export const timerLocal = ( timeScale = 1 ) => { // @deprecated, r170
 };
 
 /**
+ * @tsl
  * @function
  * @deprecated since r170. Use {@link time} instead.
  *
- * @param {Number} [timeScale=1] - The time scale.
+ * @param {number} [timeScale=1] - The time scale.
  * @returns {UniformNode<float>}
  */
 export const timerGlobal = ( timeScale = 1 ) => { // @deprecated, r170
@@ -55,10 +58,11 @@ export const timerGlobal = ( timeScale = 1 ) => { // @deprecated, r170
 };
 
 /**
+ * @tsl
  * @function
  * @deprecated since r170. Use {@link deltaTime} instead.
  *
- * @param {Number} [timeScale=1] - The time scale.
+ * @param {number} [timeScale=1] - The time scale.
  * @returns {UniformNode<float>}
  */
 export const timerDelta = ( timeScale = 1 ) => { // @deprecated, r170