super-three 0.173.4 → 0.175.0

package/src/renderers/webgpu/nodes/WGSLNodeFunction.js

@@ -151,7 +151,7 @@ class WGSLNodeFunction extends NodeFunction {
 	/**
 	 * Constructs a new WGSL node function.
 	 *
-	 * @param {String} source - The WGSL source.
+	 * @param {string} source - The WGSL source.
 	 */
 	constructor( source ) {
 
@@ -168,8 +168,8 @@ class WGSLNodeFunction extends NodeFunction {
 	/**
 	 * This method returns the WGSL code of the node function.
 	 *
-	 * @param {String} [name=this.name] - The function's name.
-	 * @return {String} The shader code.
+	 * @param {string} [name=this.name] - The function's name.
+	 * @return {string} The shader code.
 	 */
 	getCode( name = this.name ) {
 

package/src/renderers/webgpu/nodes/WGSLNodeParser.js

@@ -11,7 +11,7 @@ class WGSLNodeParser extends NodeParser {
 	/**
 	 * The method parses the given WGSL code an returns a node function.
 	 *
-	 * @param {String} source - The WGSL code.
+	 * @param {string} source - The WGSL code.
 	 * @return {WGSLNodeFunction} A node function.
 	 */
 	parseFunction( source ) {

package/src/renderers/webgpu/utils/WebGPUAttributeUtils.js

@@ -71,11 +71,11 @@ class WebGPUAttributeUtils {
 			// patch for INT16 and UINT16
 			if ( attribute.normalized === false ) {
 
-				if ( array.constructor === Int16Array ) {
+				if ( array.constructor === Int16Array || array.constructor === Int8Array ) {
 
 					array = new Int32Array( array );
 
-				} else if ( array.constructor === Uint16Array ) {
+				} else if ( array.constructor === Uint16Array || array.constructor === Uint8Array ) {
 
 					array = new Uint32Array( array );
 
@@ -109,6 +109,8 @@ class WebGPUAttributeUtils {
 				bufferAttribute.itemSize = 4;
 				bufferAttribute.array = array;
 
+				bufferData._force3to4BytesAlignment = true;
+
 			}
 
 			const size = array.byteLength + ( ( 4 - ( array.byteLength % 4 ) ) % 4 ); // ensure 4 byte alignment, see #20441
@@ -142,9 +144,27 @@ class WebGPUAttributeUtils {
 		const backend = this.backend;
 		const device = backend.device;
 
+		const bufferData = backend.get( bufferAttribute );
 		const buffer = backend.get( bufferAttribute ).buffer;
 
-		const array = bufferAttribute.array;
+		let array = bufferAttribute.array;
+
+		//  if storage buffer ensure 4 byte alignment
+		if ( bufferData._force3to4BytesAlignment === true ) {
+
+			array = new array.constructor( bufferAttribute.count * 4 );
+
+			for ( let i = 0; i < bufferAttribute.count; i ++ ) {
+
+				array.set( bufferAttribute.array.subarray( i * 3, i * 3 + 3 ), i * 4 );
+
+			}
+
+			bufferAttribute.array = array;
+
+		}
+
+
 		const isTypedArray = this._isTypedArray( array );
 		const updateRanges = bufferAttribute.updateRanges;
 
@@ -166,13 +186,27 @@ class WebGPUAttributeUtils {
 			for ( let i = 0, l = updateRanges.length; i < l; i ++ ) {
 
 				const range = updateRanges[ i ];
+				let dataOffset, size;
+
+				if ( bufferData._force3to4BytesAlignment === true ) {
+
+					const vertexStart = Math.floor( range.start / 3 );
+					const vertexCount = Math.ceil( range.count / 3 );
+					dataOffset = vertexStart * 4 * byteOffsetFactor;
+					size = vertexCount * 4 * byteOffsetFactor;
+
+				} else {
+
+					dataOffset = range.start * byteOffsetFactor;
+					size = range.count * byteOffsetFactor;
+
+				}
 
-				const dataOffset = range.start * byteOffsetFactor;
-				const size = range.count * byteOffsetFactor;
+				const bufferOffset = dataOffset * ( isTypedArray ? array.BYTES_PER_ELEMENT : 1 ); // bufferOffset is always in bytes
 
 				device.queue.writeBuffer(
 					buffer,
-					0,
+					bufferOffset,
 					array,
 					dataOffset,
 					size
@@ -325,7 +359,7 @@ class WebGPUAttributeUtils {
 	 *
 	 * @private
 	 * @param {BufferAttribute} geometryAttribute - The buffer attribute.
-	 * @return {String} The vertex format (e.g. 'float32x3').
+	 * @return {string|undefined} The vertex format (e.g. 'float32x3').
 	 */
 	_getVertexFormat( geometryAttribute ) {
 
@@ -376,8 +410,8 @@ class WebGPUAttributeUtils {
 	 * Returns `true` if the given array is a typed array.
 	 *
 	 * @private
-	 * @param {Any} array - The array.
-	 * @return {Boolean} Whether the given array is a typed array or not.
+	 * @param {any} array - The array.
+	 * @return {boolean} Whether the given array is a typed array or not.
 	 */
 	_isTypedArray( array ) {
 

package/src/renderers/webgpu/utils/WebGPUBindingUtils.js

@@ -220,8 +220,8 @@ class WebGPUBindingUtils {
 	 *
 	 * @param {BindGroup} bindGroup - The bind group.
 	 * @param {Array<BindGroup>} bindings - Array of bind groups.
-	 * @param {Number} cacheIndex - The cache index.
-	 * @param {Number} version - The version.
+	 * @param {number} cacheIndex - The cache index.
+	 * @param {number} version - The version.
 	 */
 	createBindings( bindGroup, bindings, cacheIndex, version = 0 ) {
 

package/src/renderers/webgpu/utils/WebGPUConstants.js

@@ -113,7 +113,7 @@ export const GPUTextureFormat = {
 	// Packed 32-bit formats
 	RGB9E5UFloat: 'rgb9e5ufloat',
 	RGB10A2Unorm: 'rgb10a2unorm',
-	RG11B10uFloat: 'rgb10a2unorm',
+	RG11B10UFloat: 'rgb10a2unorm',
 
 	// 64-bit formats
 

package/src/renderers/webgpu/utils/WebGPUPipelineUtils.js

@@ -43,7 +43,7 @@ class WebGPUPipelineUtils {
 	 *
 	 * @private
 	 * @param {RenderContext} renderContext - The render context.
-	 * @return {Number} The sample count.
+	 * @return {number} The sample count.
 	 */
 	_getSampleCount( renderContext ) {
 
@@ -188,6 +188,14 @@ class WebGPUPipelineUtils {
 
 			}
 
+			if ( material.polygonOffset === true ) {
+
+				depthStencil.depthBias = material.polygonOffsetUnits;
+				depthStencil.depthBiasSlopeScale = material.polygonOffsetFactor;
+				depthStencil.depthBiasClamp = 0; // three.js does not provide an API to configure this value
+
+			}
+
 			pipelineDescriptor.depthStencil = depthStencil;
 
 		}
@@ -397,8 +405,8 @@ class WebGPUPipelineUtils {
 	 * Returns the GPU blend factor which is required for the pipeline creation.
 	 *
 	 * @private
-	 * @param {Number} blend - The blend factor as a three.js constant.
-	 * @return {String} The GPU blend factor.
+	 * @param {number} blend - The blend factor as a three.js constant.
+	 * @return {string} The GPU blend factor.
 	 */
 	_getBlendFactor( blend ) {
 
@@ -472,7 +480,7 @@ class WebGPUPipelineUtils {
 	 *
 	 * @private
 	 * @param {Material} material - The material.
-	 * @return {String} The GPU stencil compare function.
+	 * @return {string} The GPU stencil compare function.
 	 */
 	_getStencilCompare( material ) {
 
@@ -527,8 +535,8 @@ class WebGPUPipelineUtils {
 	 * Returns the GPU stencil operation which is required for the pipeline creation.
 	 *
 	 * @private
-	 * @param {Number} op - A three.js constant defining the stencil operation.
-	 * @return {String} The GPU stencil operation.
+	 * @param {number} op - A three.js constant defining the stencil operation.
+	 * @return {string} The GPU stencil operation.
 	 */
 	_getStencilOperation( op ) {
 
@@ -581,8 +589,8 @@ class WebGPUPipelineUtils {
 	 * Returns the GPU blend operation which is required for the pipeline creation.
 	 *
 	 * @private
-	 * @param {Number} blendEquation - A three.js constant defining the blend equation.
-	 * @return {String} The GPU blend operation.
+	 * @param {number} blendEquation - A three.js constant defining the blend equation.
+	 * @return {string} The GPU blend operation.
 	 */
 	_getBlendOperation( blendEquation ) {
 
@@ -674,7 +682,7 @@ class WebGPUPipelineUtils {
 	 *
 	 * @private
 	 * @param {Material} material - The material.
-	 * @return {String} The GPU color write mask.
+	 * @return {string} The GPU color write mask.
 	 */
 	_getColorWriteMask( material ) {
 
@@ -687,7 +695,7 @@ class WebGPUPipelineUtils {
 	 *
 	 * @private
 	 * @param {Material} material - The material.
-	 * @return {String} The GPU depth compare function.
+	 * @return {string} The GPU depth compare function.
 	 */
 	_getDepthCompare( material ) {
 

package/src/renderers/webgpu/utils/WebGPUTexturePassUtils.js

@@ -105,7 +105,7 @@ fn main( @location( 0 ) vTex : vec2<f32> ) -> @location( 0 ) vec4<f32> {
 		 * A cache for GPU render pipelines used for copy/transfer passes.
 		 * Every texture format requires a unique pipeline.
 		 *
-		 * @type {Object<String,GPURenderPipeline>}
+		 * @type {Object<string,GPURenderPipeline>}
 		 */
 		this.transferPipelines = {};
 
@@ -113,7 +113,7 @@ fn main( @location( 0 ) vTex : vec2<f32> ) -> @location( 0 ) vec4<f32> {
 		 * A cache for GPU render pipelines used for flipY passes.
 		 * Every texture format requires a unique pipeline.
 		 *
-		 * @type {Object<String,GPURenderPipeline>}
+		 * @type {Object<string,GPURenderPipeline>}
 		 */
 		this.flipYPipelines = {};
 
@@ -153,7 +153,7 @@ fn main( @location( 0 ) vTex : vec2<f32> ) -> @location( 0 ) vec4<f32> {
 	 * Returns a render pipeline for the internal copy render pass. The pass
 	 * requires a unique render pipeline for each texture format.
 	 *
-	 * @param {String} format - The GPU texture format
+	 * @param {string} format - The GPU texture format
 	 * @return {GPURenderPipeline} The GPU render pipeline.
 	 */
 	getTransferPipeline( format ) {
@@ -192,7 +192,7 @@ fn main( @location( 0 ) vTex : vec2<f32> ) -> @location( 0 ) vec4<f32> {
 	 * Returns a render pipeline for the flipY render pass. The pass
 	 * requires a unique render pipeline for each texture format.
 	 *
-	 * @param {String} format - The GPU texture format
+	 * @param {string} format - The GPU texture format
 	 * @return {GPURenderPipeline} The GPU render pipeline.
 	 */
 	getFlipYPipeline( format ) {
@@ -232,7 +232,7 @@ fn main( @location( 0 ) vTex : vec2<f32> ) -> @location( 0 ) vec4<f32> {
 	 *
 	 * @param {GPUTexture} textureGPU - The GPU texture object.
 	 * @param {Object} textureGPUDescriptor - The texture descriptor.
-	 * @param {Number} [baseArrayLayer=0] - The index of the first array layer accessible to the texture view.
+	 * @param {number} [baseArrayLayer=0] - The index of the first array layer accessible to the texture view.
 	 */
 	flipY( textureGPU, textureGPUDescriptor, baseArrayLayer = 0 ) {
 
@@ -309,7 +309,7 @@ fn main( @location( 0 ) vTex : vec2<f32> ) -> @location( 0 ) vec4<f32> {
 	 *
 	 * @param {GPUTexture} textureGPU - The GPU texture object.
 	 * @param {Object} textureGPUDescriptor - The texture descriptor.
-	 * @param {Number} [baseArrayLayer=0] - The index of the first array layer accessible to the texture view.
+	 * @param {number} [baseArrayLayer=0] - The index of the first array layer accessible to the texture view.
 	 */
 	generateMipmaps( textureGPU, textureGPUDescriptor, baseArrayLayer = 0 ) {
 
@@ -342,8 +342,8 @@ fn main( @location( 0 ) vTex : vec2<f32> ) -> @location( 0 ) vec4<f32> {
 	 *
 	 * @param {GPUTexture} textureGPU - The GPU texture object.
 	 * @param {Object} textureGPUDescriptor - The texture descriptor.
-	 * @param {Number} baseArrayLayer - The index of the first array layer accessible to the texture view.
-	 * @return {Array} An array of render bundles.
+	 * @param {number} baseArrayLayer - The index of the first array layer accessible to the texture view.
+	 * @return {Array<Object>} An array of render bundles.
 	 */
 	_mipmapCreateBundles( textureGPU, textureGPUDescriptor, baseArrayLayer ) {
 
@@ -414,7 +414,7 @@ fn main( @location( 0 ) vTex : vec2<f32> ) -> @location( 0 ) vec4<f32> {
 	 * Executes the render bundles.
 	 *
 	 * @param {GPUCommandEncoder} commandEncoder - The GPU command encoder.
-	 * @param {Array} passes - An array of render bundles.
+	 * @param {Array<Object>} passes - An array of render bundles.
 	 */
 	_mipmapRunBundles( commandEncoder, passes ) {
 

package/src/renderers/webgpu/utils/WebGPUTextureUtils.js

@@ -56,7 +56,7 @@ class WebGPUTextureUtils {
 		/**
 		 * A reference to the pass utils.
 		 *
-		 * @type {WebGPUTexturePassUtils?}
+		 * @type {?WebGPUTexturePassUtils}
 		 * @default null
 		 */
 		this._passUtils = null;
@@ -65,7 +65,7 @@ class WebGPUTextureUtils {
 		 * A dictionary for managing default textures. The key
 		 * is the texture format, the value the texture object.
 		 *
-		 * @type {Object<String,Texture>}
+		 * @type {Object<string,Texture>}
 		 */
 		this.defaultTexture = {};
 
@@ -73,14 +73,14 @@ class WebGPUTextureUtils {
 		 * A dictionary for managing default cube textures. The key
 		 * is the texture format, the value the texture object.
 		 *
-		 * @type {Object<String,CubeTexture>}
+		 * @type {Object<string,CubeTexture>}
 		 */
 		this.defaultCubeTexture = {};
 
 		/**
 		 * A default video frame.
 		 *
-		 * @type {VideoFrame?}
+		 * @type {?VideoFrame}
 		 * @default null
 		 */
 		this.defaultVideoFrame = null;
@@ -88,7 +88,7 @@ class WebGPUTextureUtils {
 		/**
 		 * Represents the color attachment of the default framebuffer.
 		 *
-		 * @type {GPUTexture?}
+		 * @type {?GPUTexture}
 		 * @default null
 		 */
 		this.colorBuffer = null;
@@ -178,7 +178,6 @@ class WebGPUTextureUtils {
 	 *
 	 * @param {Texture} texture - The texture.
 	 * @param {Object} [options={}] - Optional configuration parameter.
-	 * @return {undefined}
 	 */
 	createTexture( texture, options = {} ) {
 
@@ -266,7 +265,8 @@ class WebGPUTextureUtils {
 
 				console.warn( 'WebGPURenderer: Texture format not supported.' );
 
-				return this.createDefaultTexture( texture );
+				this.createDefaultTexture( texture );
+				return;
 
 			}
 
@@ -387,8 +387,8 @@ class WebGPUTextureUtils {
 	 * Returns the depth buffer representing the depth
 	 * attachment of the default framebuffer.
 	 *
-	 * @param {Boolean} [depth=true] - Whether depth is enabled or not.
-	 * @param {Boolean} [stencil=false] -  Whether stencil is enabled or not.
+	 * @param {boolean} [depth=true] - Whether depth is enabled or not.
+	 * @param {boolean} [stencil=false] -  Whether stencil is enabled or not.
 	 * @return {GPUTexture} The depth buffer.
 	 */
 	getDepthBuffer( depth = true, stencil = false ) {
@@ -499,11 +499,11 @@ class WebGPUTextureUtils {
 	 *
 	 * @async
 	 * @param {Texture} texture - The texture to copy.
-	 * @param {Number} x - The x coordinate of the copy origin.
-	 * @param {Number} y - The y coordinate of the copy origin.
-	 * @param {Number} width - The width of the copy.
-	 * @param {Number} height - The height of the copy.
-	 * @param {Number} faceIndex - The face index.
+	 * @param {number} x - The x coordinate of the copy origin.
+	 * @param {number} y - The y coordinate of the copy origin.
+	 * @param {number} width - The width of the copy.
+	 * @param {number} height - The height of the copy.
+	 * @param {number} faceIndex - The face index.
 	 * @return {Promise<TypedArray>} A Promise that resolves with a typed array when the copy operation has finished.
 	 */
 	async copyTextureToBuffer( texture, x, y, width, height, faceIndex ) {
@@ -560,7 +560,7 @@ class WebGPUTextureUtils {
 	 *
 	 * @private
 	 * @param {Texture} texture - The texture.
-	 * @return {Boolean} Whether the given texture is an environment map or not.
+	 * @return {boolean} Whether the given texture is an environment map or not.
 	 */
 	_isEnvironmentTexture( texture ) {
 
@@ -574,7 +574,7 @@ class WebGPUTextureUtils {
 	 * Returns the default GPU texture for the given format.
 	 *
 	 * @private
-	 * @param {String} format - The GPU format.
+	 * @param {string} format - The GPU format.
 	 * @return {GPUTexture} The GPU texture.
 	 */
 	_getDefaultTextureGPU( format ) {
@@ -601,7 +601,7 @@ class WebGPUTextureUtils {
 	 * Returns the default GPU cube texture for the given format.
 	 *
 	 * @private
-	 * @param {String} format - The GPU format.
+	 * @param {string} format - The GPU format.
 	 * @return {GPUTexture} The GPU texture.
 	 */
 	_getDefaultCubeTextureGPU( format ) {
@@ -658,7 +658,7 @@ class WebGPUTextureUtils {
 	 * @param {Array} images - The cube image data.
 	 * @param {GPUTexture} textureGPU - The GPU texture.
 	 * @param {Object} textureDescriptorGPU - The GPU texture descriptor.
-	 * @param {Boolean} flipY - Whether to flip texture data along their vertical axis or not.
+	 * @param {boolean} flipY - Whether to flip texture data along their vertical axis or not.
 	 */
 	_copyCubeMapToTexture( images, textureGPU, textureDescriptorGPU, flipY ) {
 
@@ -689,8 +689,8 @@ class WebGPUTextureUtils {
 	 * @param {HTMLImageElement|ImageBitmap|HTMLCanvasElement} image - The image data.
 	 * @param {GPUTexture} textureGPU - The GPU texture.
 	 * @param {Object} textureDescriptorGPU - The GPU texture descriptor.
-	 * @param {Number} originDepth - The origin depth.
-	 * @param {Boolean} flipY - Whether to flip texture data along their vertical axis or not.
+	 * @param {number} originDepth - The origin depth.
+	 * @param {boolean} flipY - Whether to flip texture data along their vertical axis or not.
 	 */
 	_copyImageToTexture( image, textureGPU, textureDescriptorGPU, originDepth, flipY ) {
 
@@ -739,7 +739,7 @@ class WebGPUTextureUtils {
 	 * @private
 	 * @param {GPUTexture} textureGPU - The GPU texture object.
 	 * @param {Object} textureDescriptorGPU - The texture descriptor.
-	 * @param {Number} [baseArrayLayer=0] - The index of the first array layer accessible to the texture view.
+	 * @param {number} [baseArrayLayer=0] - The index of the first array layer accessible to the texture view.
 	 */
 	_generateMipmaps( textureGPU, textureDescriptorGPU, baseArrayLayer = 0 ) {
 
@@ -753,7 +753,7 @@ class WebGPUTextureUtils {
 	 * @private
 	 * @param {GPUTexture} textureGPU - The GPU texture object.
 	 * @param {Object} textureDescriptorGPU - The texture descriptor.
-	 * @param {Number} [originDepth=0] - The origin depth.
+	 * @param {number} [originDepth=0] - The origin depth.
 	 */
 	_flipY( textureGPU, textureDescriptorGPU, originDepth = 0 ) {
 
@@ -768,9 +768,9 @@ class WebGPUTextureUtils {
 	 * @param {Object} image - An object defining the image buffer data.
 	 * @param {GPUTexture} textureGPU - The GPU texture.
 	 * @param {Object} textureDescriptorGPU - The GPU texture descriptor.
-	 * @param {Number} originDepth - The origin depth.
-	 * @param {Boolean} flipY - Whether to flip texture data along their vertical axis or not.
-	 * @param {Number} [depth=0] - TODO.
+	 * @param {number} originDepth - The origin depth.
+	 * @param {boolean} flipY - Whether to flip texture data along their vertical axis or not.
+	 * @param {number} [depth=0] - TODO.
 	 */
 	_copyBufferToTexture( image, textureGPU, textureDescriptorGPU, originDepth, flipY, depth = 0 ) {
 
@@ -869,7 +869,7 @@ class WebGPUTextureUtils {
 	 * data descriptor for the given GPU compressed texture format.
 	 *
 	 * @private
-	 * @param {String} format - The GPU compressed texture format.
+	 * @param {string} format - The GPU compressed texture format.
 	 * @return {Object} The block data descriptor.
 	 */
 	_getBlockData( format ) {
@@ -877,7 +877,7 @@ class WebGPUTextureUtils {
 		if ( format === GPUTextureFormat.BC1RGBAUnorm || format === GPUTextureFormat.BC1RGBAUnormSRGB ) return { byteLength: 8, width: 4, height: 4 }; // DXT1
 		if ( format === GPUTextureFormat.BC2RGBAUnorm || format === GPUTextureFormat.BC2RGBAUnormSRGB ) return { byteLength: 16, width: 4, height: 4 }; // DXT3
 		if ( format === GPUTextureFormat.BC3RGBAUnorm || format === GPUTextureFormat.BC3RGBAUnormSRGB ) return { byteLength: 16, width: 4, height: 4 }; // DXT5
-		if ( format === GPUTextureFormat.BC4RUnorm || format === GPUTextureFormat.BC4RSNorm ) return { byteLength: 8, width: 4, height: 4 }; // RGTC1
+		if ( format === GPUTextureFormat.BC4RUnorm || format === GPUTextureFormat.BC4RSnorm ) return { byteLength: 8, width: 4, height: 4 }; // RGTC1
 		if ( format === GPUTextureFormat.BC5RGUnorm || format === GPUTextureFormat.BC5RGSnorm ) return { byteLength: 16, width: 4, height: 4 }; // RGTC2
 		if ( format === GPUTextureFormat.BC6HRGBUFloat || format === GPUTextureFormat.BC6HRGBFloat ) return { byteLength: 16, width: 4, height: 4 }; // BPTC (float)
 		if ( format === GPUTextureFormat.BC7RGBAUnorm || format === GPUTextureFormat.BC7RGBAUnormSRGB ) return { byteLength: 16, width: 4, height: 4 }; // BPTC (unorm)
@@ -911,8 +911,8 @@ class WebGPUTextureUtils {
 	 * Converts the three.js uv wrapping constants to GPU address mode constants.
 	 *
 	 * @private
-	 * @param {Number} value - The three.js constant defining a uv wrapping mode.
-	 * @return {String} The GPU address mode.
+	 * @param {number} value - The three.js constant defining a uv wrapping mode.
+	 * @return {string} The GPU address mode.
 	 */
 	_convertAddressMode( value ) {
 
@@ -936,8 +936,8 @@ class WebGPUTextureUtils {
 	 * Converts the three.js filter constants to GPU filter constants.
 	 *
 	 * @private
-	 * @param {Number} value - The three.js constant defining a filter mode.
-	 * @return {String} The GPU filter mode.
+	 * @param {number} value - The three.js constant defining a filter mode.
+	 * @return {string} The GPU filter mode.
 	 */
 	_convertFilterMode( value ) {
 
@@ -957,8 +957,8 @@ class WebGPUTextureUtils {
 	 * Returns the bytes-per-texel value for the given GPU texture format.
 	 *
 	 * @private
-	 * @param {String} format - The GPU texture format.
-	 * @return {Number} The bytes-per-texel.
+	 * @param {string} format - The GPU texture format.
+	 * @return {number} The bytes-per-texel.
 	 */
 	_getBytesPerTexel( format ) {
 
@@ -1020,7 +1020,7 @@ class WebGPUTextureUtils {
 	 * Returns the corresponding typed array type for the given GPU texture format.
 	 *
 	 * @private
-	 * @param {String} format - The GPU texture format.
+	 * @param {string} format - The GPU texture format.
 	 * @return {TypedArray.constructor} The typed array type.
 	 */
 	_getTypedArrayType( format ) {
@@ -1078,7 +1078,7 @@ class WebGPUTextureUtils {
 	 *
 	 * @private
 	 * @param {Texture} texture - The texture.
-	 * @return {String} The GPU dimension.
+	 * @return {string} The GPU dimension.
 	 */
 	_getDimension( texture ) {
 
@@ -1104,9 +1104,9 @@ class WebGPUTextureUtils {
  * Returns the GPU format for the given texture.
  *
  * @param {Texture} texture - The texture.
- * @param {GPUDevice?} [device=null] - The GPU device which is used for feature detection.
+ * @param {?GPUDevice} [device=null] - The GPU device which is used for feature detection.
  * It is not necessary to apply the device for most formats.
- * @return {String} The GPU format.
+ * @return {string} The GPU format.
  */
 export function getFormat( texture, device = null ) {
 

package/src/renderers/webgpu/utils/WebGPUTimestampQueryPool.js

@@ -4,16 +4,18 @@ import TimestampQueryPool from '../../common/TimestampQueryPool.js';
 /**
  * Manages a pool of WebGPU timestamp queries for performance measurement.
  * Extends the base TimestampQueryPool to provide WebGPU-specific implementation.
- * @extends TimestampQueryPool
+ *
+ * @augments TimestampQueryPool
  */
 class WebGPUTimestampQueryPool extends TimestampQueryPool {
 
 	/**
-     * Creates a new WebGPU timestamp query pool.
-     * @param {GPUDevice} device - The WebGPU device to create queries on.
-     * @param {string} type - The type identifier for this query pool.
-     * @param {number} [maxQueries=2048] - Maximum number of queries this pool can hold.
-     */
+	 * Creates a new WebGPU timestamp query pool.
+	 *
+	 * @param {GPUDevice} device - The WebGPU device to create queries on.
+	 * @param {string} type - The type identifier for this query pool.
+	 * @param {number} [maxQueries=2048] - Maximum number of queries this pool can hold.
+	 */
 	constructor( device, type, maxQueries = 2048 ) {
 
 		super( maxQueries );
@@ -42,10 +44,11 @@ class WebGPUTimestampQueryPool extends TimestampQueryPool {
 	}
 
 	/**
-     * Allocates a pair of queries for a given render context.
-     * @param {Object} renderContext - The render context to allocate queries for.
-     * @returns {?number} The base offset for the allocated queries, or null if allocation failed.
-     */
+	 * Allocates a pair of queries for a given render context.
+	 *
+	 * @param {Object} renderContext - The render context to allocate queries for.
+	 * @returns {?number} The base offset for the allocated queries, or null if allocation failed.
+	 */
 	allocateQueriesForContext( renderContext ) {
 
 		if ( ! this.trackTimestamp || this.isDisposed ) return null;
@@ -66,10 +69,12 @@ class WebGPUTimestampQueryPool extends TimestampQueryPool {
 	}
 
 	/**
-     * Asynchronously resolves all pending queries and returns the total duration.
-     * If there's already a pending resolve operation, returns that promise instead.
-     * @returns {Promise<number>} The total duration in milliseconds, or the last valid value if resolution fails.
-     */
+	 * Asynchronously resolves all pending queries and returns the total duration.
+	 * If there's already a pending resolve operation, returns that promise instead.
+	 *
+	 * @async
+	 * @returns {Promise<number>} The total duration in milliseconds, or the last valid value if resolution fails.
+	 */
 	async resolveQueriesAsync() {
 
 		if ( ! this.trackTimestamp || this.currentQueryIndex === 0 || this.isDisposed ) {
@@ -100,10 +105,12 @@ class WebGPUTimestampQueryPool extends TimestampQueryPool {
 	}
 
 	/**
-     * Internal method to resolve queries and calculate total duration.
-     * @private
-     * @returns {Promise<number>} The total duration in milliseconds.
-     */
+	 * Internal method to resolve queries and calculate total duration.
+	 *
+	 * @async
+	 * @private
+	 * @returns {Promise<number>} The total duration in milliseconds.
+	 */
 	async _resolveQueries() {
 
 		if ( this.isDisposed ) {
@@ -202,6 +209,12 @@ class WebGPUTimestampQueryPool extends TimestampQueryPool {
 
 	}
 
+	/**
+	 * Dispose of the query pool.
+	 *
+	 * @async
+	 * @returns {Promise} A Promise that resolves when the dispose has been executed.
+	 */
 	async dispose() {
 
 		if ( this.isDisposed ) {