Update three.js (#1798)

* Update three.js

* Add src

* Update patch and delete src

* Update declarations

* Add jsdoc

* Update patch and delete jsdoc

* Update declarations

Author: Methuselah96

jsdoc-testing/changes.patch

@@ -2298,7 +2298,7 @@ index b3beb46d..b27cb65e 100644
 +// eslint-disable-next-line @typescript-eslint/no-empty-interface
 +export interface MeshDepthMaterial extends MeshDepthMaterialProperties {}
 diff --git a/jsdoc-testing/jsdoc/materials/MeshDistanceMaterial.d.ts b/jsdoc-testing/jsdoc/materials/MeshDistanceMaterial.d.ts
-index 65ab8f0e..34a4486b 100644
+index bddc4ff5..4e7170f4 100644
 --- a/jsdoc-testing/jsdoc/materials/MeshDistanceMaterial.d.ts
 +++ b/jsdoc-testing/jsdoc/materials/MeshDistanceMaterial.d.ts
 @@ -1,39 +1,11 @@
@@ -2309,7 +2309,7 @@ index 65ab8f0e..34a4486b 100644
 - * Can also be used to customize the shadow casting of an object by assigning
 - * an instance of `MeshDistanceMaterial` to {@link Object3D#customDistanceMaterial}.
 - * The following examples demonstrates this approach in order to ensure
-- * transparent parts of objects do no cast shadows.
+- * transparent parts of objects do not cast shadows.
 - *
 - * @augments Material
 - */
@@ -2391,7 +2391,7 @@ index 65ab8f0e..34a4486b 100644
 + * Can also be used to customize the shadow casting of an object by assigning
 + * an instance of `MeshDistanceMaterial` to {@link Object3D#customDistanceMaterial}.
 + * The following examples demonstrates this approach in order to ensure
-+ * transparent parts of objects do no cast shadows.
++ * transparent parts of objects do not cast shadows.
 + */
 +export class MeshDistanceMaterial extends Material {
 +    /**

src-testing/changes.patch

@@ -63,7 +63,7 @@ export interface MeshDistanceMaterialParameters
  * Can also be used to customize the shadow casting of an object by assigning
  * an instance of `MeshDistanceMaterial` to {@link Object3D#customDistanceMaterial}.
  * The following examples demonstrates this approach in order to ensure
- * transparent parts of objects do no cast shadows.
+ * transparent parts of objects do not cast shadows.
  */
 export class MeshDistanceMaterial extends Material {
     /**

three.js

@@ -289,7 +289,7 @@ declare class Node extends EventDispatcher<{
      * This state builds the output node and returns the resulting shader string.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @param {?string} output - Can be used to define the output type.
+     * @param {?string} [output] - Can be used to define the output type.
      * @return {?string} The generated shader string.
      */
     generate(builder: NodeBuilder, output?: string | null): string | null | undefined;
@@ -327,14 +327,14 @@ declare class Node extends EventDispatcher<{
      * - **generate**: Generates the shader code for the node. Returns the generated shader string.
      *
      * @param {NodeBuilder} builder - The current node builder.
-     * @param {string|Node|null} [output=null] - Can be used to define the output type.
-     * @return {Node|string|null} The result of the build process, depending on the build stage.
+     * @param {?(string|Node)} [output=null] - Can be used to define the output type.
+     * @return {?(Node|string)} The result of the build process, depending on the build stage.
      */
     build(builder: NodeBuilder, output?: string | Node | null): Node | string | null;
     /**
      * Returns the child nodes as a JSON object.
      *
-     * @return {Array<Object>} An iterable list of serialized child objects as JSON.
+     * @return {Generator<Object>} An iterable list of serialized child objects as JSON.
      */
     getSerializeChildren(): Generator<import("./NodeUtils.js").NodeChild, void, unknown>;
     /**

types/three/src/materials/MeshDistanceMaterial.d.ts

@@ -30,7 +30,7 @@ declare class Attributes extends DataMap<{
      * Deletes the data for the given attribute.
      *
      * @param {BufferAttribute} attribute - The attribute.
-     * @return {Object|null} The deleted attribute data.
+     * @return {?Object} The deleted attribute data.
      */
     delete(attribute: BufferAttribute | InterleavedBufferAttribute): Data;
     /**

types/three/src/nodes/core/Node.d.ts

@@ -742,7 +742,7 @@ declare class Renderer {
      * if the renderer has been initialized.
      *
      * @param {Node|Array<Node>} computeNodes - The compute node(s).
-     * @param {Array<number>|number} [dispatchSizeOrCount=null] - Array with [ x, y, z ] values for dispatch or a single number for the count.
+     * @param {?(Array<number>|number)} [dispatchSizeOrCount=null] - Array with [ x, y, z ] values for dispatch or a single number for the count.
      * @return {Promise|undefined} A Promise that resolve when the compute has finished. Only returned when the renderer has not been initialized.
      */
     compute(
@@ -754,7 +754,7 @@ declare class Renderer {
      *
      * @async
      * @param {Node|Array<Node>} computeNodes - The compute node(s).
-     * @param {Array<number>|number} [dispatchSizeOrCount=null] - Array with [ x, y, z ] values for dispatch or a single number for the count.
+     * @param {?(Array<number>|number)} [dispatchSizeOrCount=null] - Array with [ x, y, z ] values for dispatch or a single number for the count.
      * @return {Promise} A Promise that resolve when the compute has finished.
      */
     computeAsync(
@@ -806,7 +806,7 @@ declare class Renderer {
      * Copies the current bound framebuffer into the given texture.
      *
      * @param {FramebufferTexture} framebufferTexture - The texture.
-     * @param {?Vector2|Vector4} [rectangle=null] - A two or four dimensional vector that defines the rectangular portion of the framebuffer that should be copied.
+     * @param {?(Vector2|Vector4)} [rectangle=null] - A two or four dimensional vector that defines the rectangular portion of the framebuffer that should be copied.
      */
     copyFramebufferToTexture(framebufferTexture: FramebufferTexture, rectangle?: Rectangle | null): void;
     /**