@cesium/engine 23.0.1 → 25.0.0

package/Source/Core/Cartesian2.js

@@ -79,10 +79,10 @@ class Cartesian2 {
    * Stores the provided instance into the provided array.
    *
    * @param {Cartesian2} value The value to pack.
-   * @param {number[]|TypedArray} array The array to pack into.
+   * @param {number[]} array The array to pack into.
    * @param {number} [startingIndex=0] The index into the array at which to start packing the elements.
    *
-   * @returns {number[]|TypedArray} The array that was packed into
+   * @returns {number[]} The array that was packed into
    */
   static pack(value, array, startingIndex) {
     //>>includeStart('debug', pragmas.debug);
@@ -101,7 +101,7 @@ class Cartesian2 {
   /**
    * Retrieves an instance from a packed array.
    *
-   * @param {number[]|TypedArray} array The packed array.
+   * @param {number[]} array The packed array.
    * @param {number} [startingIndex=0] The starting index of the element to be unpacked.
    * @param {Cartesian2} [result] The object into which to store the result.
    * @returns {Cartesian2} The modified result parameter or a new Cartesian2 instance if one was not provided.
@@ -125,8 +125,8 @@ class Cartesian2 {
    * Flattens an array of Cartesian2s into an array of components.
    *
    * @param {Cartesian2[]} array The array of cartesians to pack.
-   * @param {number[]|TypedArray} [result] The array onto which to store the result. If this is a typed array, it must have array.length * 2 components, else a {@link DeveloperError} will be thrown. If it is a regular array, it will be resized to have (array.length * 2) elements.
-   * @returns {number[]|TypedArray} The packed array.
+   * @param {number[]} [result] The array onto which to store the result. If this is a typed array, it must have array.length * 2 components, else a {@link DeveloperError} will be thrown. If it is a regular array, it will be resized to have (array.length * 2) elements.
+   * @returns {number[]} The packed array.
    */
   static packArray(array, result) {
     //>>includeStart('debug', pragmas.debug);
@@ -137,6 +137,7 @@ class Cartesian2 {
     const resultLength = length * 2;
     if (!defined(result)) {
       result = new Array(resultLength);
+      // @ts-expect-error TODO(tsd-jsdoc): See https://github.com/CesiumGS/cesium/pull/13302.
     } else if (!Array.isArray(result) && result.length !== resultLength) {
       //>>includeStart('debug', pragmas.debug);
       throw new DeveloperError(
@@ -150,6 +151,7 @@ class Cartesian2 {
     for (let i = 0; i < length; ++i) {
       Cartesian2.pack(array[i], result, i * 2);
     }
+
     return result;
   }
 

package/Source/Core/Cartesian3.js

@@ -117,10 +117,10 @@ class Cartesian3 {
    * Stores the provided instance into the provided array.
    *
    * @param {Cartesian3} value The value to pack.
-   * @param {number[]|TypedArray} array The array to pack into.
+   * @param {number[]} array The array to pack into.
    * @param {number} [startingIndex=0] The index into the array at which to start packing the elements.
    *
-   * @returns {number[]|TypedArray} The array that was packed into
+   * @returns {number[]} The array that was packed into
    */
   static pack(value, array, startingIndex) {
     //>>includeStart('debug', pragmas.debug);
@@ -140,7 +140,7 @@ class Cartesian3 {
   /**
    * Retrieves an instance from a packed array.
    *
-   * @param {number[]|TypedArray} array The packed array.
+   * @param {number[]} array The packed array.
    * @param {number} [startingIndex=0] The starting index of the element to be unpacked.
    * @param {Cartesian3} [result] The object into which to store the result.
    * @returns {Cartesian3} The modified result parameter or a new Cartesian3 instance if one was not provided.
@@ -165,8 +165,8 @@ class Cartesian3 {
    * Flattens an array of Cartesian3s into an array of components.
    *
    * @param {Cartesian3[]} array The array of cartesians to pack.
-   * @param {number[]|TypedArray} [result] The array onto which to store the result. If this is a typed array, it must have array.length * 3 components, else a {@link DeveloperError} will be thrown. If it is a regular array, it will be resized to have (array.length * 3) elements.
-   * @returns {number[]|TypedArray} The packed array.
+   * @param {number[]} [result] The array onto which to store the result. If this is a typed array, it must have array.length * 3 components, else a {@link DeveloperError} will be thrown. If it is a regular array, it will be resized to have (array.length * 3) elements.
+   * @returns {number[]} The packed array.
    */
   static packArray(array, result) {
     //>>includeStart('debug', pragmas.debug);
@@ -177,6 +177,7 @@ class Cartesian3 {
     const resultLength = length * 3;
     if (!defined(result)) {
       result = new Array(resultLength);
+      // @ts-expect-error TODO(tsd-jsdoc): See https://github.com/CesiumGS/cesium/pull/13302.
     } else if (!Array.isArray(result) && result.length !== resultLength) {
       //>>includeStart('debug', pragmas.debug);
       throw new DeveloperError(
@@ -190,13 +191,14 @@ class Cartesian3 {
     for (let i = 0; i < length; ++i) {
       Cartesian3.pack(array[i], result, i * 3);
     }
+
     return result;
   }
 
   /**
    * Unpacks an array of cartesian components into an array of Cartesian3s.
    *
-   * @param {number[]|TypedArray} array The array of components to unpack.
+   * @param {number[]} array The array of components to unpack.
    * @param {Cartesian3[]} [result] The array onto which to store the result.
    * @returns {Cartesian3[]} The unpacked array.
    */
@@ -874,8 +876,7 @@ class Cartesian3 {
 
     const radiiSquared = !defined(ellipsoid)
       ? Cartesian3._ellipsoidRadiiSquared
-      : // @ts-expect-error Requires type-checking on Ellipsoid.js.
-        ellipsoid.radiiSquared;
+      : ellipsoid.radiiSquared;
 
     const cosLatitude = Math.cos(latitude);
     scratchN.x = cosLatitude * Math.cos(longitude);

package/Source/Core/Cartesian4.js

@@ -124,10 +124,10 @@ class Cartesian4 {
    * Stores the provided instance into the provided array.
    *
    * @param {Cartesian4} value The value to pack.
-   * @param {number[]|TypedArray} array The array to pack into.
+   * @param {number[]} array The array to pack into.
    * @param {number} [startingIndex=0] The index into the array at which to start packing the elements.
    *
-   * @returns {number[]|TypedArray} The array that was packed into
+   * @returns {number[]} The array that was packed into
    */
   static pack(value, array, startingIndex) {
     //>>includeStart('debug', pragmas.debug);
@@ -148,7 +148,7 @@ class Cartesian4 {
   /**
    * Retrieves an instance from a packed array.
    *
-   * @param {number[]|TypedArray} array The packed array.
+   * @param {number[]} array The packed array.
    * @param {number} [startingIndex=0] The starting index of the element to be unpacked.
    * @param {Cartesian4} [result] The object into which to store the result.
    * @returns {Cartesian4}  The modified result parameter or a new Cartesian4 instance if one was not provided.
@@ -174,8 +174,8 @@ class Cartesian4 {
    * Flattens an array of Cartesian4s into an array of components.
    *
    * @param {Cartesian4[]} array The array of cartesians to pack.
-   * @param {number[]|TypedArray} [result] The array onto which to store the result. If this is a typed array, it must have array.length * 4 components, else a {@link DeveloperError} will be thrown. If it is a regular array, it will be resized to have (array.length * 4) elements.
-   * @returns {number[]|TypedArray} The packed array.
+   * @param {number[]} [result] The array onto which to store the result. If this is a typed array, it must have array.length * 4 components, else a {@link DeveloperError} will be thrown. If it is a regular array, it will be resized to have (array.length * 4) elements.
+   * @returns {number[]} The packed array.
    */
   static packArray(array, result) {
     //>>includeStart('debug', pragmas.debug);
@@ -186,6 +186,7 @@ class Cartesian4 {
     const resultLength = length * 4;
     if (!defined(result)) {
       result = new Array(resultLength);
+      // @ts-expect-error TODO(tsd-jsdoc): See https://github.com/CesiumGS/cesium/pull/13302.
     } else if (!Array.isArray(result) && result.length !== resultLength) {
       //>>includeStart('debug', pragmas.debug);
       throw new DeveloperError(
@@ -199,13 +200,14 @@ class Cartesian4 {
     for (let i = 0; i < length; ++i) {
       Cartesian4.pack(array[i], result, i * 4);
     }
+
     return result;
   }
 
   /**
    * Unpacks an array of cartesian components into an array of Cartesian4s.
    *
-   * @param {number[]|TypedArray} array The array of components to unpack.
+   * @param {number[]} array The array of components to unpack.
    * @param {Cartesian4[]} [result] The array onto which to store the result.
    * @returns {Cartesian4[]} The unpacked array.
    */