fix-types (#31819)

s-rigaud · Samuel Rigaud · web-flow · commit 1041321baf8e · 2025-09-04T20:52:17.000+02:00
Co-authored-by: Samuel Rigaud &lt;rigaud@gmail.com&gt;
diff --git a/examples/jsm/controls/ArcballControls.js b/examples/jsm/controls/ArcballControls.js
@@ -115,7 +115,7 @@ class ArcballControls extends Controls {
 	 * Constructs a new controls instance.
 	 *
 	 * @param {Camera} camera - The camera to be controlled. The camera must not be a child of another object, unless that object is the scene itself.
-	 * @param {?HTMLDOMElement} [domElement=null] - The HTML element used for event listeners.
+	 * @param {?HTMLElement} [domElement=null] - The HTML element used for event listeners.
 	 * @param {?Scene} [scene=null] The scene rendered by the camera. If not given, gizmos cannot be shown.
 	 */
 	constructor( camera, domElement = null, scene = null ) {
diff --git a/examples/jsm/controls/DragControls.js b/examples/jsm/controls/DragControls.js
@@ -61,7 +61,7 @@ class DragControls extends Controls {
 	 *
 	 * @param {Array<Object3D>} objects - An array of draggable 3D objects.
 	 * @param {Camera} camera - The camera of the rendered scene.
-	 * @param {?HTMLDOMElement} [domElement=null] - The HTML DOM element used for event listeners.
+	 * @param {?HTMLElement} [domElement=null] - The HTML DOM element used for event listeners.
 	 */
 	constructor( objects, camera, domElement = null ) {
 
diff --git a/examples/jsm/controls/FirstPersonControls.js b/examples/jsm/controls/FirstPersonControls.js
@@ -22,7 +22,7 @@ class FirstPersonControls extends Controls {
 	 * Constructs a new controls instance.
 	 *
 	 * @param {Object3D} object - The object that is managed by the controls.
-	 * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.
+	 * @param {?HTMLElement} domElement - The HTML element used for event listeners.
 	 */
 	constructor( object, domElement = null ) {
 
diff --git a/examples/jsm/controls/FlyControls.js b/examples/jsm/controls/FlyControls.js
@@ -29,7 +29,7 @@ class FlyControls extends Controls {
 	 * Constructs a new controls instance.
 	 *
 	 * @param {Object3D} object - The object that is managed by the controls.
-	 * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.
+	 * @param {?HTMLElement} domElement - The HTML element used for event listeners.
 	 */
 	constructor( object, domElement = null ) {
 
diff --git a/examples/jsm/controls/OrbitControls.js b/examples/jsm/controls/OrbitControls.js
@@ -91,7 +91,7 @@ class OrbitControls extends Controls {
 	 * Constructs a new controls instance.
 	 *
 	 * @param {Object3D} object - The object that is managed by the controls.
-	 * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.
+	 * @param {?HTMLElement} domElement - The HTML element used for event listeners.
 	 */
 	constructor( object, domElement = null ) {
 
@@ -541,7 +541,7 @@ class OrbitControls extends Controls {
 	 * Adds key event listeners to the given DOM element.
 	 * `window` is a recommended argument for using this method.
 	 *
-	 * @param {HTMLDOMElement} domElement - The DOM element
+	 * @param {HTMLElement} domElement - The DOM element
 	 */
 	listenToKeyEvents( domElement ) {
 
diff --git a/examples/jsm/controls/PointerLockControls.js b/examples/jsm/controls/PointerLockControls.js
@@ -64,7 +64,7 @@ class PointerLockControls extends Controls {
 	 * Constructs a new controls instance.
 	 *
 	 * @param {Camera} camera - The camera that is managed by the controls.
-	 * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.
+	 * @param {?HTMLElement} domElement - The HTML element used for event listeners.
 	 */
 	constructor( camera, domElement = null ) {
 
diff --git a/examples/jsm/controls/TrackballControls.js b/examples/jsm/controls/TrackballControls.js
@@ -59,7 +59,7 @@ class TrackballControls extends Controls {
 	 * Constructs a new controls instance.
 	 *
 	 * @param {Object3D} object - The object that is managed by the controls.
-	 * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.
+	 * @param {?HTMLElement} domElement - The HTML element used for event listeners.
 	 */
 	constructor( object, domElement = null ) {
 
diff --git a/examples/jsm/controls/TransformControls.js b/examples/jsm/controls/TransformControls.js
@@ -80,7 +80,7 @@ class TransformControls extends Controls {
 	 * Constructs a new controls instance.
 	 *
 	 * @param {Camera} camera - The camera of the rendered scene.
-	 * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.
+	 * @param {?HTMLElement} domElement - The HTML element used for event listeners.
 	 */
 	constructor( camera, domElement = null ) {
 
diff --git a/examples/jsm/helpers/ViewHelper.js b/examples/jsm/helpers/ViewHelper.js
@@ -34,7 +34,7 @@ class ViewHelper extends Object3D {
 	 * Constructs a new view helper.
 	 *
 	 * @param {Camera} camera - The camera whose transformation should be visualized.
-	 * @param {HTMLDOMElement} [domElement] - The DOM element that is used to render the view.
+	 * @param {HTMLElement} [domElement] - The DOM element that is used to render the view.
 	 */
 	constructor( camera, domElement ) {
 
diff --git a/examples/jsm/interactive/InteractiveGroup.js b/examples/jsm/interactive/InteractiveGroup.js
@@ -52,7 +52,7 @@ class InteractiveGroup extends Group {
 		/**
 		 * The internal raycaster.
 		 *
-		 * @type {?HTMLDOMElement}
+		 * @type {?HTMLElement}
 		 * @default null
 		 */
 		this.element = null;
diff --git a/examples/jsm/loaders/ColladaLoader.js b/examples/jsm/loaders/ColladaLoader.js
@@ -112,7 +112,7 @@ class ColladaLoader extends Loader {
 	 * an array of animation clips and kinematics.
 	 *
 	 * @param {string} text - The raw Collada data as a string.
-	 * @param {string} path - The asset path.
+	 * @param {string} [path] - The asset path.
 	 * @return {?{scene:Group,animations:Array<AnimationClip>,kinematics:Object}} An object representing the parsed asset.
 	 */
 	parse( text, path ) {
diff --git a/examples/jsm/loaders/DDSLoader.js b/examples/jsm/loaders/DDSLoader.js
@@ -44,7 +44,7 @@ class DDSLoader extends CompressedTextureLoader {
 	 */
 	parse( buffer, loadMipmaps ) {
 
-		const dds = { mipmaps: [], width: 0, height: 0, format: null, mipmapCount: 1 };
+		const dds = { mipmaps: [], width: 0, height: 0, format: null, mipmapCount: 1, isCubemap: false };
 
 		// Adapted from @toji's DDS utils
 		// https://github.com/toji/webgl-texture-utils/blob/master/texture-util/dds.js
diff --git a/examples/jsm/misc/ProgressiveLightMap.js b/examples/jsm/misc/ProgressiveLightMap.js
@@ -280,9 +280,9 @@ class ProgressiveLightMap {
 	 *
 	 * @private
 	 * @param {number} res - The square resolution of this object's lightMap.
-	 * @param {?WebGLRenderTarget} [lightMap] - The lightmap to initialize the plane with.
+	 * @param {WebGLRenderTarget} lightMap - The lightmap to initialize the plane with.
 	 */
-	_initializeBlurPlane( res, lightMap = null ) {
+	_initializeBlurPlane( res, lightMap ) {
 
 		const blurMaterial = new MeshBasicMaterial();
 		blurMaterial.uniforms = { previousShadowMap: { value: null },
diff --git a/examples/jsm/renderers/CSS2DRenderer.js b/examples/jsm/renderers/CSS2DRenderer.js
@@ -16,7 +16,7 @@ class CSS2DObject extends Object3D {
 	/**
 	 * Constructs a new CSS2D object.
 	 *
-	 * @param {DOMElement} [element] - The DOM element.
+	 * @param {HTMLElement} [element] - The DOM element.
 	 */
 	constructor( element = document.createElement( 'div' ) ) {
 
@@ -34,7 +34,7 @@ class CSS2DObject extends Object3D {
 		/**
 		 * The DOM element which defines the appearance of this 3D object.
 		 *
-		 * @type {DOMElement}
+		 * @type {HTMLElement}
 		 * @readonly
 		 * @default true
 		 */
@@ -132,7 +132,7 @@ class CSS2DRenderer {
 		/**
 		 * The DOM where the renderer appends its child-elements.
 		 *
-		 * @type {DOMElement}
+		 * @type {HTMLElement}
 		 */
 		this.domElement = domElement;
 
@@ -310,7 +310,7 @@ class CSS2DRenderer {
  * Constructor parameters of `CSS2DRenderer`.
  *
  * @typedef {Object} CSS2DRenderer~Parameters
- * @property {DOMElement} [element] - A DOM element where the renderer appends its child-elements.
+ * @property {HTMLElement} [element] - A DOM element where the renderer appends its child-elements.
  * If not passed in here, a new div element will be created.
  **/
 
diff --git a/examples/jsm/renderers/CSS3DRenderer.js b/examples/jsm/renderers/CSS3DRenderer.js
@@ -22,7 +22,7 @@ class CSS3DObject extends Object3D {
 	/**
 	 * Constructs a new CSS3D object.
 	 *
-	 * @param {DOMElement} [element] - The DOM element.
+	 * @param {HTMLElement} [element] - The DOM element.
 	 */
 	constructor( element = document.createElement( 'div' ) ) {
 
@@ -40,7 +40,7 @@ class CSS3DObject extends Object3D {
 		/**
 		 * The DOM element which defines the appearance of this 3D object.
 		 *
-		 * @type {DOMElement}
+		 * @type {HTMLElement}
 		 * @readonly
 		 * @default true
 		 */
@@ -94,7 +94,7 @@ class CSS3DSprite extends CSS3DObject {
 	/**
 	 * Constructs a new CSS3D sprite object.
 	 *
-	 * @param {DOMElement} [element] - The DOM element.
+	 * @param {HTMLElement} [element] - The DOM element.
 	 */
 	constructor( element ) {
 
@@ -179,7 +179,7 @@ class CSS3DRenderer {
 		/**
 		 * The DOM where the renderer appends its child-elements.
 		 *
-		 * @type {DOMElement}
+		 * @type {HTMLElement}
 		 */
 		this.domElement = domElement;
 
@@ -446,7 +446,7 @@ class CSS3DRenderer {
  * Constructor parameters of `CSS3DRenderer`.
  *
  * @typedef {Object} CSS3DRenderer~Parameters
- * @property {DOMElement} [element] - A DOM element where the renderer appends its child-elements.
+ * @property {HTMLElement} [element] - A DOM element where the renderer appends its child-elements.
  * If not passed in here, a new div element will be created.
  **/
 
diff --git a/examples/jsm/renderers/SVGRenderer.js b/examples/jsm/renderers/SVGRenderer.js
@@ -120,7 +120,7 @@ class SVGRenderer {
 		/**
 		 * The DOM where the renderer appends its child-elements.
 		 *
-		 * @type {DOMElement}
+		 * @type {SVGSVGElement}
 		 */
 		this.domElement = _svg;
 
diff --git a/src/extras/Controls.js b/src/extras/Controls.js
@@ -13,7 +13,7 @@ class Controls extends EventDispatcher {
 	 * Constructs a new controls instance.
 	 *
 	 * @param {Object3D} object - The object that is managed by the controls.
-	 * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.
+	 * @param {?HTMLElement} domElement - The HTML element used for event listeners.
 	 */
 	constructor( object, domElement = null ) {
 
@@ -29,7 +29,7 @@ class Controls extends EventDispatcher {
 		/**
 		 * The HTML element used for event listeners.
 		 *
-		 * @type {?HTMLDOMElement}
+		 * @type {?HTMLElement}
 		 * @default null
 		 */
 		this.domElement = domElement;
@@ -79,7 +79,7 @@ class Controls extends EventDispatcher {
 	 * Connects the controls to the DOM. This method has so called "side effects" since
 	 * it adds the module's event listeners to the DOM.
 	 *
-	 * @param {HTMLDOMElement} element - The DOM element to connect to.
+	 * @param {HTMLElement} element - The DOM element to connect to.
 	 */
 	connect( element ) {
 
diff --git a/src/renderers/WebGLRenderer.js b/src/renderers/WebGLRenderer.js
@@ -131,7 +131,7 @@ class WebGLRenderer {
 		 * document.body.appendChild( renderer.domElement );
 		 * ```
 		 *
-		 * @type {DOMElement}
+		 * @type {HTMLCanvasElement|OffscreenCanvas}
 		 */
 		this.domElement = canvas;
 
@@ -3414,7 +3414,7 @@ class WebGLRenderer {
  * WebGLRenderer options.
  *
  * @typedef {Object} WebGLRenderer~Options
- * @property {DOMElement} [canvas=null] - A canvas element where the renderer draws its output. If not passed in here, a new canvas element will be created by the renderer.
+ * @property {HTMLCanvasElement|OffscreenCanvas} [canvas=null] - A canvas element where the renderer draws its output. If not passed in here, a new canvas element will be created by the renderer.
  * @property {WebGL2RenderingContext} [context=null] - Can be used to attach an existing rendering context to this renderer.
  * @property {('highp'|'mediump'|'lowp')} [precision='highp'] - The default shader precision. Uses `highp` if supported by the device.
  * @property {boolean} [alpha=false] - Controls the default clear alpha value. When set to`true`, the value is `0`. Otherwise it's `1`.

Original file line number	Diff line number	Diff line change
`@@ -115,7 +115,7 @@ class ArcballControls extends Controls {`
`115`	`115`	`* Constructs a new controls instance.`
`116`	`116`	`*`
`117`	`117`	`* @param {Camera} camera - The camera to be controlled. The camera must not be a child of another object, unless that object is the scene itself.`
`118`		`- * @param {?HTMLDOMElement} [domElement=null] - The HTML element used for event listeners.`
	`118`	`+ * @param {?HTMLElement} [domElement=null] - The HTML element used for event listeners.`
`119`	`119`	`* @param {?Scene} [scene=null] The scene rendered by the camera. If not given, gizmos cannot be shown.`
`120`	`120`	`*/`
`121`	`121`	`constructor( camera, domElement = null, scene = null ) {`
Original file line number	Diff line number	Diff line change
`@@ -61,7 +61,7 @@ class DragControls extends Controls {`
`61`	`61`	`*`
`62`	`62`	`* @param {Array<Object3D>} objects - An array of draggable 3D objects.`
`63`	`63`	`* @param {Camera} camera - The camera of the rendered scene.`
`64`		`- * @param {?HTMLDOMElement} [domElement=null] - The HTML DOM element used for event listeners.`
	`64`	`+ * @param {?HTMLElement} [domElement=null] - The HTML DOM element used for event listeners.`
`65`	`65`	`*/`
`66`	`66`	`constructor( objects, camera, domElement = null ) {`
`67`	`67`
Original file line number	Diff line number	Diff line change
`@@ -22,7 +22,7 @@ class FirstPersonControls extends Controls {`
`22`	`22`	`* Constructs a new controls instance.`
`23`	`23`	`*`
`24`	`24`	`* @param {Object3D} object - The object that is managed by the controls.`
`25`		`- * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.`
	`25`	`+ * @param {?HTMLElement} domElement - The HTML element used for event listeners.`
`26`	`26`	`*/`
`27`	`27`	`constructor( object, domElement = null ) {`
`28`	`28`
Original file line number	Diff line number	Diff line change
`@@ -29,7 +29,7 @@ class FlyControls extends Controls {`
`29`	`29`	`* Constructs a new controls instance.`
`30`	`30`	`*`
`31`	`31`	`* @param {Object3D} object - The object that is managed by the controls.`
`32`		`- * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.`
	`32`	`+ * @param {?HTMLElement} domElement - The HTML element used for event listeners.`
`33`	`33`	`*/`
`34`	`34`	`constructor( object, domElement = null ) {`
`35`	`35`
Original file line number	Diff line number	Diff line change
`@@ -64,7 +64,7 @@ class PointerLockControls extends Controls {`
`64`	`64`	`* Constructs a new controls instance.`
`65`	`65`	`*`
`66`	`66`	`* @param {Camera} camera - The camera that is managed by the controls.`
`67`		`- * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.`
	`67`	`+ * @param {?HTMLElement} domElement - The HTML element used for event listeners.`
`68`	`68`	`*/`
`69`	`69`	`constructor( camera, domElement = null ) {`
`70`	`70`
Original file line number	Diff line number	Diff line change
`@@ -59,7 +59,7 @@ class TrackballControls extends Controls {`
`59`	`59`	`* Constructs a new controls instance.`
`60`	`60`	`*`
`61`	`61`	`* @param {Object3D} object - The object that is managed by the controls.`
`62`		`- * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.`
	`62`	`+ * @param {?HTMLElement} domElement - The HTML element used for event listeners.`
`63`	`63`	`*/`
`64`	`64`	`constructor( object, domElement = null ) {`
`65`	`65`
Original file line number	Diff line number	Diff line change
`@@ -80,7 +80,7 @@ class TransformControls extends Controls {`
`80`	`80`	`* Constructs a new controls instance.`
`81`	`81`	`*`
`82`	`82`	`* @param {Camera} camera - The camera of the rendered scene.`
`83`		`- * @param {?HTMLDOMElement} domElement - The HTML element used for event listeners.`
	`83`	`+ * @param {?HTMLElement} domElement - The HTML element used for event listeners.`
`84`	`84`	`*/`
`85`	`85`	`constructor( camera, domElement = null ) {`
`86`	`86`
Original file line number	Diff line number	Diff line change
`@@ -34,7 +34,7 @@ class ViewHelper extends Object3D {`
`34`	`34`	`* Constructs a new view helper.`
`35`	`35`	`*`
`36`	`36`	`* @param {Camera} camera - The camera whose transformation should be visualized.`
`37`		`- * @param {HTMLDOMElement} [domElement] - The DOM element that is used to render the view.`
	`37`	`+ * @param {HTMLElement} [domElement] - The DOM element that is used to render the view.`
`38`	`38`	`*/`
`39`	`39`	`constructor( camera, domElement ) {`
`40`	`40`
Original file line number	Diff line number	Diff line change
`@@ -52,7 +52,7 @@ class InteractiveGroup extends Group {`
`52`	`52`	`/**`
`53`	`53`	`* The internal raycaster.`
`54`	`54`	`*`
`55`		`- * @type {?HTMLDOMElement}`
	`55`	`+ * @type {?HTMLElement}`
`56`	`56`	`* @default null`
`57`	`57`	`*/`
`58`	`58`	`this.element = null;`