Box3: Improve docs.

jsdoc-testing/changes.patch

@@ -10453,6 +10453,190 @@ index 4d9e0160a..962926ab4 100644
  }
 +
 +export default NodeMaterialObserver;
+diff --git a/jsdoc-testing/jsdoc/src/math/Box3.d.ts b/jsdoc-testing/jsdoc/src/math/Box3.d.ts
+index b1c152106..c255529c1 100644
+--- a/jsdoc-testing/jsdoc/src/math/Box3.d.ts
++++ b/jsdoc-testing/jsdoc/src/math/Box3.d.ts
+@@ -1,3 +1,11 @@
++import { Vector3 } from './Vector3.js';
++import { BufferAttribute } from '../core/BufferAttribute.js';
++import { Object3D } from '../core/Object3D.js';
++import { Sphere } from './Sphere.js';
++import { Plane } from './Plane.js';
++import { Triangle } from './Triangle.js';
++import { Matrix4 } from './Matrix4.js';
++
+ /**
+  * Represents an axis-aligned bounding box (AABB) in 3D space.
+  */
+@@ -37,7 +45,7 @@ export class Box3 {
+      * @param {Vector3} max - The upper boundary of the box.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    set(min: Vector3, max: Vector3): Box3;
++    set(min: Vector3, max: Vector3): this;
+     /**
+      * Sets the upper and lower bounds of this box so it encloses the position data
+      * in the given array.
+@@ -45,7 +53,7 @@ export class Box3 {
+      * @param {Array<number>} array - An array holding 3D position data.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    setFromArray(array: Array<number>): Box3;
++    setFromArray(array: ArrayLike<number>): this;
+     /**
+      * Sets the upper and lower bounds of this box so it encloses the position data
+      * in the given buffer attribute.
+@@ -53,7 +61,7 @@ export class Box3 {
+      * @param {BufferAttribute} attribute - A buffer attribute holding 3D position data.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    setFromBufferAttribute(attribute: BufferAttribute): Box3;
++    setFromBufferAttribute(attribute: BufferAttribute): this;
+     /**
+      * Sets the upper and lower bounds of this box so it encloses the position data
+      * in the given array.
+@@ -61,7 +69,7 @@ export class Box3 {
+      * @param {Array<Vector3>} points - An array holding 3D position data as instances of {@link Vector3}.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    setFromPoints(points: Array<Vector3>): Box3;
++    setFromPoints(points: Array<Vector3>): this;
+     /**
+      * Centers this box on the given center vector and sets this box's width, height and
+      * depth to the given size values.
+@@ -70,7 +78,7 @@ export class Box3 {
+      * @param {Vector3} size - The x, y and z dimensions of the box.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    setFromCenterAndSize(center: Vector3, size: Vector3): Box3;
++    setFromCenterAndSize(center: Vector3, size: Vector3): this;
+     /**
+      * Computes the world-axis-aligned bounding box for the given 3D object
+      * (including its children), accounting for the object's, and children's,
+@@ -86,26 +94,26 @@ export class Box3 {
+      * world-axis-aligned bounding box at the expense of more computation.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    setFromObject(object: Object3D, precise?: boolean): Box3;
++    setFromObject(object: Object3D, precise?: boolean): this;
+     /**
+      * Returns a new box with copied values from this instance.
+      *
+      * @return {Box3} A clone of this instance.
+      */
+-    clone(): Box3;
++    clone(): this;
+     /**
+      * Copies the values of the given box to this instance.
+      *
+      * @param {Box3} box - The box to copy.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    copy(box: Box3): Box3;
++    copy(box: Box3): this;
+     /**
+      * Makes this box empty which means in encloses a zero space in 3D.
+      *
+      * @return {Box3} A reference to this bounding box.
+      */
+-    makeEmpty(): Box3;
++    makeEmpty(): this;
+     /**
+      * Returns true if this box includes zero points within its bounds.
+      * Note that a box with equal lower and upper bounds still includes one
+@@ -134,7 +142,7 @@ export class Box3 {
+      * @param {Vector3} point - The point that should be included by the bounding box.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    expandByPoint(point: Vector3): Box3;
++    expandByPoint(point: Vector3): this;
+     /**
+      * Expands this box equilaterally by the given vector. The width of this
+      * box will be expanded by the x component of the vector in both
+@@ -145,7 +153,7 @@ export class Box3 {
+      * @param {Vector3} vector - The vector that should expand the bounding box.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    expandByVector(vector: Vector3): Box3;
++    expandByVector(vector: Vector3): this;
+     /**
+      * Expands each dimension of the box by the given scalar. If negative, the
+      * dimensions of the box will be contracted.
+@@ -153,7 +161,7 @@ export class Box3 {
+      * @param {number} scalar - The scalar value that should expand the bounding box.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    expandByScalar(scalar: number): Box3;
++    expandByScalar(scalar: number): this;
+     /**
+      * Expands the boundaries of this box to include the given 3D object and
+      * its children, accounting for the object's, and children's, world
+@@ -165,7 +173,7 @@ export class Box3 {
+      * as little as necessary at the expense of more computation.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    expandByObject(object: Object3D, precise?: boolean): Box3;
++    expandByObject(object: Object3D, precise?: boolean): this;
+     /**
+      * Returns `true` if the given point lies within or on the boundaries of this box.
+      *
+@@ -249,7 +257,7 @@ export class Box3 {
+      * @param {Box3} box - The bounding box to intersect with.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    intersect(box: Box3): Box3;
++    intersect(box: Box3): this;
+     /**
+      * Computes the union of this box and another and the given one, setting the upper
+      * bound of this box to the greater of the two boxes' upper bounds and the
+@@ -258,14 +266,14 @@ export class Box3 {
+      * @param {Box3} box - The bounding box that will be unioned with this instance.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    union(box: Box3): Box3;
++    union(box: Box3): this;
+     /**
+      * Transforms this bounding box by the given 4x4 transformation matrix.
+      *
+      * @param {Matrix4} matrix - The transformation matrix.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    applyMatrix4(matrix: Matrix4): Box3;
++    applyMatrix4(matrix: Matrix4): this;
+     /**
+      * Adds the given offset to both the upper and lower bounds of this bounding box,
+      * effectively moving it in 3D space.
+@@ -273,7 +281,7 @@ export class Box3 {
+      * @param {Vector3} offset - The offset that should be used to translate the bounding box.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    translate(offset: Vector3): Box3;
++    translate(offset: Vector3): this;
+     /**
+      * Returns `true` if this bounding box is equal with the given one.
+      *
+@@ -286,13 +294,17 @@ export class Box3 {
+      *
+      * @return {Object} Serialized structure with fields representing the object state.
+      */
+-    toJSON(): Object;
++    toJSON(): Box3JSON;
+     /**
+      * Returns a serialized structure of the bounding box.
+      *
+      * @param {Object} json - The serialized json to set the box from.
+      * @return {Box3} A reference to this bounding box.
+      */
+-    fromJSON(json: Object): Box3;
++    fromJSON(json: Box3JSON): this;
++}
++
++export interface Box3JSON {
++    min: number[];
++    max: number[];
+ }
+-import { Vector3 } from './Vector3.js';
 diff --git a/jsdoc-testing/jsdoc/src/math/Interpolant.d.ts b/jsdoc-testing/jsdoc/src/math/Interpolant.d.ts
 index 561415c0e..093bab0de 100644
 --- a/jsdoc-testing/jsdoc/src/math/Interpolant.d.ts

jsdoc-testing/declarations.js

@@ -99,6 +99,7 @@ const files = [
     'src/materials/ShaderMaterial',
     'src/materials/ShadowMaterial',
     'src/materials/SpriteMaterial',
+    'src/math/Box3',
     'src/math/interpolants/BezierInterpolant',
     'src/math/interpolants/CubicInterpolant',
     'src/math/interpolants/DiscreteInterpolant',