@cesium/engine 24.0.0 → 26.0.0

package/Source/Core/ComponentDatatype.js

@@ -335,4 +335,42 @@ ComponentDatatype.fromName = function (name) {
     //>>includeEnd('debug');
   }
 };
-export default Object.freeze(ComponentDatatype);
+
+/**
+ * Converts a single normalized integer value to a floating-point value in
+ * the range [-1, 1] (for signed types) or [0, 1] (for unsigned types),
+ * following the WebGL and glTF normalization conventions.
+ *
+ * @param {number} value The integer value to dequantize.
+ * @param {ComponentDatatype} componentDatatype The component datatype of the value.
+ * @returns {number} The dequantized floating-point value.
+ *
+ * @example
+ * const floatValue = Cesium.ComponentDatatype.dequantize(32767, Cesium.ComponentDatatype.SHORT); // 1.0
+ */
+ComponentDatatype.dequantize = function (value, componentDatatype) {
+  switch (componentDatatype) {
+    case ComponentDatatype.BYTE:
+      return Math.max(value / 127.0, -1.0);
+    case ComponentDatatype.UNSIGNED_BYTE:
+      return value / 255.0;
+    case ComponentDatatype.SHORT:
+      return Math.max(value / 32767.0, -1.0);
+    case ComponentDatatype.UNSIGNED_SHORT:
+      return value / 65535.0;
+    case ComponentDatatype.INT:
+      return Math.max(value / 2147483647.0, -1.0);
+    case ComponentDatatype.UNSIGNED_INT:
+      return value / 4294967295.0;
+    //>>includeStart('debug', pragmas.debug);
+    default:
+      throw new DeveloperError(
+        "componentDatatype is not a valid integer type for dequantization.",
+      );
+    //>>includeEnd('debug');
+  }
+};
+
+Object.freeze(ComponentDatatype);
+
+export default ComponentDatatype;

package/Source/Core/CornerType.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * Style options for corners.
  *
@@ -34,4 +36,7 @@ const CornerType = {
    */
   BEVELED: 2,
 };
-export default Object.freeze(CornerType);
+
+Object.freeze(CornerType);
+
+export default CornerType;

package/Source/Core/Credit.js

@@ -1,172 +1,169 @@
+// @ts-check
+
 import DOMPurify from "dompurify";
 import Check from "./Check.js";
 import defined from "./defined.js";
 
 let nextCreditId = 0;
+/**
+ * @private
+ * @type {Record<string, number>}
+ */
 const creditToId = {};
 
 /**
  * A credit contains data pertaining to how to display attributions/credits for certain content on the screen.
- * @param {string} html An string representing an html code snippet
- * @param {boolean} [showOnScreen=false] If true, the credit will be visible in the main credit container.  Otherwise, it will appear in a popover. All credits are displayed `inline`, if you have an image we recommend sizing it correctly to match the text or use css to `vertical-align` it.
- *
- * @alias Credit
- * @constructor
- *
- * @exception {DeveloperError} html is required.
  *
  * @example
  * // Create a credit with a tooltip, image and link
  * const credit = new Cesium.Credit('<a href="https://cesium.com/" target="_blank"><img src="/images/cesium_logo.png"  style="vertical-align: -7px" title="Cesium"/></a>');
  */
-function Credit(html, showOnScreen) {
-  //>>includeStart('debug', pragmas.debug);
-  Check.typeOf.string("html", html);
-  //>>includeEnd('debug');
-  let id;
-  const key = html;
-
-  if (defined(creditToId[key])) {
-    id = creditToId[key];
-  } else {
-    id = nextCreditId++;
-    creditToId[key] = id;
+class Credit {
+  /**
+   * @param {string} html An string representing an html code snippet
+   * @param {boolean} [showOnScreen=false] If true, the credit will be visible in the main credit container.  Otherwise, it will appear in a popover. All credits are displayed `inline`, if you have an image we recommend sizing it correctly to match the text or use css to `vertical-align` it.
+   *
+   * @exception {DeveloperError} html is required.
+   */
+  constructor(html, showOnScreen) {
+    //>>includeStart('debug', pragmas.debug);
+    Check.typeOf.string("html", html);
+    //>>includeEnd('debug');
+    let id;
+    const key = html;
+
+    if (defined(creditToId[key])) {
+      id = creditToId[key];
+    } else {
+      id = nextCreditId++;
+      creditToId[key] = id;
+    }
+
+    showOnScreen = showOnScreen ?? false;
+
+    // Credits are immutable so generate an id to use to optimize equal()
+    this._id = id;
+    this._html = html;
+    this._showOnScreen = showOnScreen;
+    this._element = undefined;
   }
 
-  showOnScreen = showOnScreen ?? false;
-
-  // Credits are immutable so generate an id to use to optimize equal()
-  this._id = id;
-  this._html = html;
-  this._showOnScreen = showOnScreen;
-  this._element = undefined;
-}
-
-Object.defineProperties(Credit.prototype, {
   /**
    * The credit content
-   * @memberof Credit.prototype
    * @type {string}
    * @readonly
    */
-  html: {
-    get: function () {
-      return this._html;
-    },
-  },
+  get html() {
+    return this._html;
+  }
 
   /**
-   * @memberof Credit.prototype
    * @type {number}
    * @readonly
    *
    * @private
    */
-  id: {
-    get: function () {
-      return this._id;
-    },
-  },
+  get id() {
+    return this._id;
+  }
 
   /**
    * Whether the credit should be displayed on screen or in a lightbox
-   * @memberof Credit.prototype
    * @type {boolean}
    */
-  showOnScreen: {
-    get: function () {
-      return this._showOnScreen;
-    },
-    set: function (value) {
-      this._showOnScreen = value;
-    },
-  },
+  get showOnScreen() {
+    return this._showOnScreen;
+  }
+
+  set showOnScreen(value) {
+    this._showOnScreen = value;
+  }
 
   /**
    * Gets the credit element
-   * @memberof Credit.prototype
    * @type {HTMLElement}
    * @readonly
    */
-  element: {
-    get: function () {
-      if (!defined(this._element)) {
-        const html = DOMPurify.sanitize(this._html);
-
-        const div = document.createElement("div");
-        div.className = "cesium-credit-wrapper";
-        div._creditId = this._id;
-        div.style.display = "inline";
-        div.innerHTML = html;
-
-        const links = div.querySelectorAll("a");
-        for (let i = 0; i < links.length; i++) {
-          links[i].setAttribute("target", "_blank");
-        }
-
-        this._element = div;
+  get element() {
+    if (!defined(this._element)) {
+      const html = DOMPurify.sanitize(this._html);
+
+      const div = document.createElement("div");
+      div.className = "cesium-credit-wrapper";
+      // @ts-expect-error Consider using a data-id attribute, instead.
+      div._creditId = this._id;
+      div.style.display = "inline";
+      div.innerHTML = html;
+
+      const links = div.querySelectorAll("a");
+      for (let i = 0; i < links.length; i++) {
+        links[i].setAttribute("target", "_blank");
       }
-      return this._element;
-    },
-  },
-});
 
-/**
- * Returns true if the credits are equal
- *
- * @param {Credit} [left] The first credit
- * @param {Credit} [right] The second credit
- * @returns {boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
- */
-Credit.equals = function (left, right) {
-  return (
-    left === right ||
-    (defined(left) &&
-      defined(right) &&
-      left._id === right._id &&
-      left._showOnScreen === right._showOnScreen)
-  );
-};
+      this._element = div;
+    }
+    return this._element;
+  }
 
-/**
- * Returns true if the credits are equal
- *
- * @param {Credit} [credit] The credit to compare to.
- * @returns {boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
- */
-Credit.prototype.equals = function (credit) {
-  return Credit.equals(this, credit);
-};
+  /**
+   * Returns true if the credits are equal
+   *
+   * @param {Credit} [left] The first credit
+   * @param {Credit} [right] The second credit
+   * @returns {boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
+   */
+  static equals(left, right) {
+    return (
+      left === right ||
+      (defined(left) &&
+        defined(right) &&
+        left._id === right._id &&
+        left._showOnScreen === right._showOnScreen)
+    );
+  }
 
-/**
- * @private
- */
-Credit.prototype.isIon = function () {
-  return this.html.indexOf("ion-credit.png") !== -1;
-};
+  /**
+   * Returns true if the credits are equal
+   *
+   * @param {Credit} [credit] The credit to compare to.
+   * @returns {boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
+   */
+  equals(credit) {
+    return Credit.equals(this, credit);
+  }
 
-/**
- * @private
- * @param attribution
- * @return {Credit}
- */
-Credit.getIonCredit = function (attribution) {
-  const showOnScreen =
-    defined(attribution.collapsible) && !attribution.collapsible;
-  const credit = new Credit(attribution.html, showOnScreen);
+  /**
+   * @private
+   */
+  isIon() {
+    return this.html.indexOf("ion-credit.png") !== -1;
+  }
 
-  return credit;
-};
+  /**
+   * @private
+   * @param attribution
+   * @return {Credit}
+   */
+  // @ts-expect-error Define type for GeocoderService.attributions
+  static getIonCredit(attribution) {
+    const showOnScreen =
+      defined(attribution.collapsible) && !attribution.collapsible;
+    const credit = new Credit(attribution.html, showOnScreen);
 
-/**
- * Duplicates a Credit instance.
- *
- * @param {Credit} [credit] The Credit to duplicate.
- * @returns {Credit} A new Credit instance that is a duplicate of the one provided. (Returns undefined if the credit is undefined)
- */
-Credit.clone = function (credit) {
-  if (defined(credit)) {
-    return new Credit(credit.html, credit.showOnScreen);
+    return credit;
   }
-};
+
+  /**
+   * Duplicates a Credit instance.
+   *
+   * @param {Credit} [credit] The Credit to duplicate.
+   * @returns {Credit} A new Credit instance that is a duplicate of the one provided. (Returns undefined if the credit is undefined)
+   */
+  static clone(credit) {
+    if (defined(credit)) {
+      return new Credit(credit.html, credit.showOnScreen);
+    }
+  }
+}
+
 export default Credit;