@cesium/engine 26.3.0 → 26.3.1-wasm.0

package/Build/Workers/gaussianSplatSorter.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.145.0
+ * Version 1.145.1-wasm.0
  *
  * Copyright 2011-2022 Cesium Contributors
  *
@@ -26,19 +26,26 @@
 import {
   initSync,
   radix_sort_gaussians_indexes
-} from "./chunk-DZK34ZVD.js";
+} from "./chunk-MUNZ77KV.js";
+import {
+  fetchWebAssemblyBinary_default
+} from "./chunk-OUG5JB2K.js";
 import {
   createTaskProcessorWorker_default
-} from "./chunk-EDETO6NY.js";
+} from "./chunk-T67YY3KP.js";
+import "./chunk-NYKURYFR.js";
+import "./chunk-P4SDLSGF.js";
+import "./chunk-PPRK3XQU.js";
 import {
   defined_default
-} from "./chunk-B4AVL7VI.js";
+} from "./chunk-YUICDZKO.js";
 
 // packages/engine/Source/Workers/gaussianSplatSorter.js
 async function initWorker(parameters, transferableObjects) {
   const wasmConfig = parameters.webAssemblyConfig;
-  if (defined_default(wasmConfig) && defined_default(wasmConfig.wasmBinary)) {
-    initSync({ module: wasmConfig.wasmBinary });
+  const wasmBinary = await fetchWebAssemblyBinary_default(wasmConfig) ?? wasmConfig.wasmBinary;
+  if (defined_default(wasmBinary)) {
+    initSync({ module: wasmBinary });
     return true;
   }
 }

package/Build/Workers/gaussianSplatTextureGenerator.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.145.0
+ * Version 1.145.1-wasm.0
  *
  * Copyright 2011-2022 Cesium Contributors
  *
@@ -26,19 +26,26 @@
 import {
   generate_splat_texture,
   initSync
-} from "./chunk-DZK34ZVD.js";
+} from "./chunk-MUNZ77KV.js";
+import {
+  fetchWebAssemblyBinary_default
+} from "./chunk-OUG5JB2K.js";
 import {
   createTaskProcessorWorker_default
-} from "./chunk-EDETO6NY.js";
+} from "./chunk-T67YY3KP.js";
+import "./chunk-NYKURYFR.js";
+import "./chunk-P4SDLSGF.js";
+import "./chunk-PPRK3XQU.js";
 import {
   defined_default
-} from "./chunk-B4AVL7VI.js";
+} from "./chunk-YUICDZKO.js";
 
 // packages/engine/Source/Workers/gaussianSplatTextureGenerator.js
 async function initWorker(parameters, transferableObjects) {
   const wasmConfig = parameters.webAssemblyConfig;
-  if (defined_default(wasmConfig) && defined_default(wasmConfig.wasmBinary)) {
-    initSync({ module: wasmConfig.wasmBinary });
+  const wasmBinary = await fetchWebAssemblyBinary_default(wasmConfig) ?? wasmConfig.wasmBinary;
+  if (defined_default(wasmBinary)) {
+    initSync({ module: wasmBinary });
     return true;
   }
   return false;

package/Build/Workers/incrementallyBuildTerrainPicker.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.145.0
+ * Version 1.145.1-wasm.0
  *
  * Copyright 2011-2022 Cesium Contributors
  *
@@ -25,21 +25,20 @@
 
 import {
   createTaskProcessorWorker_default
-} from "./chunk-EDETO6NY.js";
+} from "./chunk-T67YY3KP.js";
 import {
   AxisAlignedBoundingBox_default
-} from "./chunk-N5YK44FS.js";
-import "./chunk-UZY5XRL2.js";
+} from "./chunk-ROHWZQZ5.js";
+import "./chunk-ZY733NZA.js";
 import {
   Matrix4_default
-} from "./chunk-6R6SGKYN.js";
-import "./chunk-GLHDTTTO.js";
+} from "./chunk-OQUOLQTN.js";
 import {
   Cartesian3_default
-} from "./chunk-Z2DW5NM2.js";
-import "./chunk-HDD3RFLT.js";
-import "./chunk-XSIUYAT6.js";
-import "./chunk-B4AVL7VI.js";
+} from "./chunk-FVLSQBPH.js";
+import "./chunk-P4SDLSGF.js";
+import "./chunk-PPRK3XQU.js";
+import "./chunk-YUICDZKO.js";
 
 // packages/engine/Source/Workers/incrementallyBuildTerrainPicker.js
 var scratchAABBCornerMin = new Cartesian3_default();

package/Build/Workers/transcodeKTX2.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.145.0
+ * Version 1.145.1-wasm.0
  *
  * Copyright 2011-2022 Cesium Contributors
  *
@@ -23,24 +23,27 @@
  * See https://github.com/CesiumGS/cesium/blob/main/LICENSE.md for full licensing details.
  */
 
+import {
+  fetchWebAssemblyBinary_default
+} from "./chunk-OUG5JB2K.js";
 import {
   createTaskProcessorWorker_default
-} from "./chunk-EDETO6NY.js";
+} from "./chunk-T67YY3KP.js";
 import {
   WebGLConstants_default
-} from "./chunk-E7G32DWL.js";
+} from "./chunk-V4ICCWYA.js";
+import "./chunk-NYKURYFR.js";
+import "./chunk-P4SDLSGF.js";
 import {
+  Check_default,
   RuntimeError_default
-} from "./chunk-GLHDTTTO.js";
-import {
-  Check_default
-} from "./chunk-XSIUYAT6.js";
+} from "./chunk-PPRK3XQU.js";
 import {
   __commonJS,
   __require,
   __toESM,
   defined_default
-} from "./chunk-B4AVL7VI.js";
+} from "./chunk-YUICDZKO.js";
 
 // packages/engine/Source/ThirdParty/Workers/basis_transcoder.js
 var require_basis_transcoder = __commonJS({
@@ -3444,11 +3447,22 @@ function transcodeCompressed(data, header, supportedTargetFormats, transcoderMod
 }
 async function initWorker(parameters, transferableObjects) {
   const wasmConfig = parameters.webAssemblyConfig;
-  const basisTranscoder = import_basis_transcoder.default ?? self.BASIS;
-  if (defined_default(wasmConfig.wasmBinaryFile)) {
-    transcoderModule = await basisTranscoder(wasmConfig);
+  let createBasisModule = import_basis_transcoder.default ?? self.BASIS;
+  if (defined_default(wasmConfig.modulePath)) {
+    const wrapperModule = await import(wasmConfig.modulePath);
+    createBasisModule = wrapperModule.default;
+  }
+  if (typeof createBasisModule !== "function") {
+    throw new RuntimeError_default(
+      "The Basis wrapper must have a default export that is a module factory."
+    );
+  }
+  const wasmBinary = await fetchWebAssemblyBinary_default(wasmConfig) ?? wasmConfig.wasmBinary;
+  if (defined_default(wasmBinary)) {
+    const moduleOptions = { wasmBinary };
+    transcoderModule = await createBasisModule(moduleOptions);
   } else {
-    transcoderModule = await basisTranscoder();
+    transcoderModule = await createBasisModule();
   }
   transcoderModule.initializeBasis();
   return true;

package/Build/Workers/transferTypedArrayTest.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.145.0
+ * Version 1.145.1-wasm.0
  *
  * Copyright 2011-2022 Cesium Contributors
  *

package/Build/Workers/upsampleQuantizedTerrainMesh.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.145.0
+ * Version 1.145.1-wasm.0
  *
  * Copyright 2011-2022 Cesium Contributors
  *
@@ -26,52 +26,52 @@
 import {
   EllipsoidalOccluder_default,
   TerrainEncoding_default
-} from "./chunk-4DMAXPKB.js";
+} from "./chunk-TF5473GK.js";
 import {
   createTaskProcessorWorker_default
-} from "./chunk-EDETO6NY.js";
+} from "./chunk-T67YY3KP.js";
 import {
   OrientedBoundingBox_default
-} from "./chunk-A7SMPV6B.js";
+} from "./chunk-MJTLGN63.js";
 import {
   AttributeCompression_default
-} from "./chunk-NZQUP52G.js";
-import "./chunk-L73K5UPP.js";
-import "./chunk-N5YK44FS.js";
-import "./chunk-75BC2IHI.js";
-import "./chunk-LL2SGJYH.js";
+} from "./chunk-UV2YC2Q5.js";
+import "./chunk-IFKM2GZR.js";
+import "./chunk-ROHWZQZ5.js";
+import "./chunk-VC6XXI2Z.js";
+import "./chunk-YJRDTEHQ.js";
 import {
   IndexDatatype_default
-} from "./chunk-JKTWW7IO.js";
+} from "./chunk-O5GUOP2G.js";
 import {
   BoundingSphere_default
-} from "./chunk-BNDSDQ7D.js";
-import "./chunk-UZY5XRL2.js";
+} from "./chunk-ZIM5H2DB.js";
+import "./chunk-ZY733NZA.js";
 import {
   Rectangle_default
-} from "./chunk-XRZCS3HE.js";
-import "./chunk-6R6SGKYN.js";
-import "./chunk-JBJ6BRIM.js";
-import "./chunk-E7G32DWL.js";
-import "./chunk-GLHDTTTO.js";
+} from "./chunk-AEHANE5A.js";
+import "./chunk-OQUOLQTN.js";
+import "./chunk-6XUIECFB.js";
+import "./chunk-V4ICCWYA.js";
 import {
   Cartesian2_default,
   Cartographic_default,
   Ellipsoid_default
-} from "./chunk-6BSNYZZG.js";
+} from "./chunk-7ZBJRQQT.js";
 import {
   Cartesian3_default
-} from "./chunk-Z2DW5NM2.js";
+} from "./chunk-FVLSQBPH.js";
+import "./chunk-NYKURYFR.js";
 import {
   Math_default
-} from "./chunk-HDD3RFLT.js";
+} from "./chunk-P4SDLSGF.js";
 import {
-  Check_default,
-  DeveloperError_default
-} from "./chunk-XSIUYAT6.js";
+  Check_default
+} from "./chunk-PPRK3XQU.js";
 import {
+  DeveloperError_default,
   defined_default
-} from "./chunk-B4AVL7VI.js";
+} from "./chunk-YUICDZKO.js";
 
 // packages/engine/Source/Core/Intersections2D.js
 var Intersections2D = {};

package/Build/Workers/upsampleVerticesFromCesium3DTilesTerrain.js

@@ -1,7 +1,7 @@
 /**
  * @license
  * Cesium - https://github.com/CesiumGS/cesium
- * Version 1.145.0
+ * Version 1.145.1-wasm.0
  *
  * Copyright 2011-2022 Cesium Contributors
  *
@@ -25,32 +25,32 @@
 
 import {
   Cesium3DTilesTerrainGeometryProcessor_default
-} from "./chunk-HDPNFEPP.js";
-import "./chunk-JL4NWWQY.js";
-import "./chunk-4DMAXPKB.js";
+} from "./chunk-AUU74SIZ.js";
+import "./chunk-KOAXSU77.js";
+import "./chunk-TF5473GK.js";
 import {
   createTaskProcessorWorker_default
-} from "./chunk-EDETO6NY.js";
-import "./chunk-XBY3354M.js";
-import "./chunk-A7SMPV6B.js";
-import "./chunk-NZQUP52G.js";
-import "./chunk-L73K5UPP.js";
-import "./chunk-N5YK44FS.js";
-import "./chunk-75BC2IHI.js";
-import "./chunk-LL2SGJYH.js";
-import "./chunk-JKTWW7IO.js";
-import "./chunk-BNDSDQ7D.js";
-import "./chunk-UZY5XRL2.js";
-import "./chunk-XRZCS3HE.js";
-import "./chunk-6R6SGKYN.js";
-import "./chunk-JBJ6BRIM.js";
-import "./chunk-E7G32DWL.js";
-import "./chunk-GLHDTTTO.js";
-import "./chunk-6BSNYZZG.js";
-import "./chunk-Z2DW5NM2.js";
-import "./chunk-HDD3RFLT.js";
-import "./chunk-XSIUYAT6.js";
-import "./chunk-B4AVL7VI.js";
+} from "./chunk-T67YY3KP.js";
+import "./chunk-SNUWISJO.js";
+import "./chunk-MJTLGN63.js";
+import "./chunk-UV2YC2Q5.js";
+import "./chunk-IFKM2GZR.js";
+import "./chunk-ROHWZQZ5.js";
+import "./chunk-VC6XXI2Z.js";
+import "./chunk-YJRDTEHQ.js";
+import "./chunk-O5GUOP2G.js";
+import "./chunk-ZIM5H2DB.js";
+import "./chunk-ZY733NZA.js";
+import "./chunk-AEHANE5A.js";
+import "./chunk-OQUOLQTN.js";
+import "./chunk-6XUIECFB.js";
+import "./chunk-V4ICCWYA.js";
+import "./chunk-7ZBJRQQT.js";
+import "./chunk-FVLSQBPH.js";
+import "./chunk-NYKURYFR.js";
+import "./chunk-P4SDLSGF.js";
+import "./chunk-PPRK3XQU.js";
+import "./chunk-YUICDZKO.js";
 
 // packages/engine/Source/Workers/upsampleVerticesFromCesium3DTilesTerrain.js
 function upsampleVerticesFromCesium3DTilesTerrain(options, transferableObjects) {

package/Source/Core/Cesium3DTilesTerrainData.js

@@ -324,7 +324,7 @@ Cesium3DTilesTerrainData.prototype.createMesh = function (options) {
 };
 
 /**
- * Creates a {@link TerrainMesh} from this terrain data synchronously.
+ * Creates a {@link TerrainMesh} from this terrain data without task throttling.
  *
  * @private
  *
@@ -340,6 +340,16 @@ Cesium3DTilesTerrainData.prototype.createMesh = function (options) {
 Cesium3DTilesTerrainData.prototype._createMeshSync = function (options) {
   options = options ?? Frozen.EMPTY_OBJECT;
 
+  const hasMeshoptCompression =
+    this._gltf.extensionsRequired?.includes("EXT_meshopt_compression") === true;
+  if (hasMeshoptCompression) {
+    // Meshopt decoding must remain in the worker
+    return this.createMesh({
+      ...options,
+      throttle: false,
+    });
+  }
+
   //>>includeStart('debug', pragmas.debug)
   Check.typeOf.object("options.tilingScheme", options.tilingScheme);
   Check.typeOf.number("options.x", options.x);

package/Source/Core/Cesium3DTilesTerrainGeometryProcessor.js

@@ -1,4 +1,3 @@
-import { MeshoptDecoder } from "meshoptimizer";
 import AttributeCompression from "./AttributeCompression.js";
 import Axis from "../Scene/Axis.js";
 import AxisAlignedBoundingBox from "./AxisAlignedBoundingBox.js";
@@ -97,6 +96,7 @@ const sortedEdgeCompare = function (a, b) {
  * @property {number} skirtHeight The height of the skirts.
  * @property {number} [exaggeration=1.0] The scale used to exaggerate the terrain.
  * @property {number} [exaggerationRelativeHeight=0.0] The height relative to which terrain is exaggerated.
+ * @property {object} [meshoptDecoder] The meshoptimizer decoder supplied by the worker for compressed terrain.
  */
 
 /**
@@ -163,11 +163,11 @@ Cesium3DTilesTerrainGeometryProcessor.createMesh = async function (options) {
     gltf.extensionsRequired !== undefined &&
     gltf.extensionsRequired.indexOf("EXT_meshopt_compression") !== -1;
 
-  const decoderPromise = hasMeshOptCompression
-    ? MeshoptDecoder.ready
-    : Promise.resolve(undefined);
-
-  await decoderPromise;
+  //>>includeStart('debug', pragmas.debug);
+  if (hasMeshOptCompression) {
+    Check.typeOf.object("options.meshoptDecoder", options.meshoptDecoder);
+  }
+  //>>includeEnd('debug');
 
   const tileMinLongitude = rectangle.west;
   const tileMinLatitude = rectangle.south;
@@ -206,7 +206,12 @@ Cesium3DTilesTerrainGeometryProcessor.createMesh = async function (options) {
     tilesetTransform,
   );
 
-  const gltfInfo = decodeGltf(gltf, hasVertexNormals, scratchGltfInfo);
+  const gltfInfo = decodeGltf(
+    gltf,
+    hasVertexNormals,
+    options.meshoptDecoder,
+    scratchGltfInfo,
+  );
 
   const skirtVertexCount = TerrainProvider.getSkirtVertexCount(
     gltfInfo.edgeIndicesWest,
@@ -449,9 +454,10 @@ const scratchGeodeticSurfaceNormalUpsample = new Cartesian3();
  * Decode the position attributes from a glTF object.
  * @private
  * @param {Object.<string,*>} gltf The glTF JSON.
+ * @param {object} meshoptDecoder The meshoptimizer decoder for compressed attributes.
  * @returns {Float32Array} The decoded positions, as a flattened array of x, y, z values.
  */
-function decodePositions(gltf) {
+function decodePositions(gltf, meshoptDecoder) {
   const primitive = gltf.meshes[0].primitives[0];
   const accessor = gltf.accessors[primitive.attributes["POSITION"]];
   const bufferView = gltf.bufferViews[accessor.bufferView];
@@ -486,7 +492,7 @@ function decodePositions(gltf) {
   const positionByteLength = bufferViewMeshOpt.byteStride;
   const PositionType = positionByteLength === 4 ? Uint8Array : Uint16Array;
   const positionsResult = new PositionType(positionCount * 4);
-  MeshoptDecoder.decodeVertexBuffer(
+  meshoptDecoder.decodeVertexBuffer(
     new Uint8Array(positionsResult.buffer),
     positionCount,
     positionByteLength,
@@ -510,9 +516,10 @@ function decodePositions(gltf) {
  * Decode the normal attributes from a glTF object.
  * @private
  * @param {Object.<string,*>} gltf The glTF JSON.
+ * @param {object} meshoptDecoder The meshoptimizer decoder for compressed attributes.
  * @returns {Float32Array} The decoded normals, as a flattened array of x, y, z values.
  */
-function decodeNormals(gltf) {
+function decodeNormals(gltf, meshoptDecoder) {
   const primitive = gltf.meshes[0].primitives[0];
   const accessor = gltf.accessors[primitive.attributes["NORMAL"]];
   const bufferView = gltf.bufferViews[accessor.bufferView];
@@ -547,7 +554,7 @@ function decodeNormals(gltf) {
   const normalByteLength = bufferViewMeshOpt.byteStride;
   const normalsResult = new Int8Array(normalCount * normalByteLength);
 
-  MeshoptDecoder.decodeVertexBuffer(
+  meshoptDecoder.decodeVertexBuffer(
     new Uint8Array(normalsResult.buffer),
     normalCount,
     normalByteLength,
@@ -588,9 +595,10 @@ function decodeNormals(gltf) {
  * Decode the index attributes from a glTF object.
  * @private
  * @param {Object.<string,*>} gltf The glTF JSON.
+ * @param {object} meshoptDecoder The meshoptimizer decoder for compressed attributes.
  * @returns {Uint16Array|Uint32Array} An array of indices.
  */
-function decodeIndices(gltf) {
+function decodeIndices(gltf, meshoptDecoder) {
   const primitive = gltf.meshes[0].primitives[0];
   const accessor = gltf.accessors[primitive.indices];
   const bufferView = gltf.bufferViews[accessor.bufferView];
@@ -626,7 +634,7 @@ function decodeIndices(gltf) {
   );
 
   const indices = new SizedIndexType(indexCount);
-  MeshoptDecoder.decodeIndexBuffer(
+  meshoptDecoder.decodeIndexBuffer(
     new Uint8Array(indices.buffer),
     indexCount,
     bufferViewMeshOpt.byteStride,
@@ -640,9 +648,10 @@ function decodeIndices(gltf) {
  * @private
  * @param {Object.<string,*>} gltf The glTF JSON.
  * @param {string} name The name of the edge indices to decode.
+ * @param {object} meshoptDecoder The meshoptimizer decoder for compressed attributes.
  * @returns {Uint16Array|Uint32Array} An array of edge indices.
  */
-function decodeEdgeIndices(gltf, name) {
+function decodeEdgeIndices(gltf, name, meshoptDecoder) {
   const primitive = gltf.meshes[0].primitives[0];
   const accessor = gltf.accessors[primitive.extensions.CESIUM_tile_edges[name]];
   const bufferView = gltf.bufferViews[accessor.bufferView];
@@ -680,7 +689,7 @@ function decodeEdgeIndices(gltf, name) {
 
   const indices = new SizedIndexType(indexCount);
   const indexByteLength = bufferViewMeshOpt.byteStride;
-  MeshoptDecoder.decodeIndexSequence(
+  meshoptDecoder.decodeIndexSequence(
     new Uint8Array(indices.buffer),
     indexCount,
     indexByteLength,
@@ -694,17 +703,18 @@ function decodeEdgeIndices(gltf, name) {
  * @private
  * @param {Object.<string,*>} gltf The glTF JSON.
  * @param {boolean} hasNormals <code>true</code> if the glTF has normal attributes.
+ * @param {object} meshoptDecoder The meshoptimizer decoder for compressed attributes.
  * @param {GltfInfo} result The object to store the decoded arrays.
  * @returns {GltfInfo} The decoded geometry info.
  */
-function decodeGltf(gltf, hasNormals, result) {
-  result.positions = decodePositions(gltf);
-  result.normals = hasNormals ? decodeNormals(gltf) : undefined;
-  result.indices = decodeIndices(gltf);
-  result.edgeIndicesWest = decodeEdgeIndices(gltf, "left");
-  result.edgeIndicesSouth = decodeEdgeIndices(gltf, "bottom");
-  result.edgeIndicesEast = decodeEdgeIndices(gltf, "right");
-  result.edgeIndicesNorth = decodeEdgeIndices(gltf, "top");
+function decodeGltf(gltf, hasNormals, meshoptDecoder, result) {
+  result.positions = decodePositions(gltf, meshoptDecoder);
+  result.normals = hasNormals ? decodeNormals(gltf, meshoptDecoder) : undefined;
+  result.indices = decodeIndices(gltf, meshoptDecoder);
+  result.edgeIndicesWest = decodeEdgeIndices(gltf, "left", meshoptDecoder);
+  result.edgeIndicesSouth = decodeEdgeIndices(gltf, "bottom", meshoptDecoder);
+  result.edgeIndicesEast = decodeEdgeIndices(gltf, "right", meshoptDecoder);
+  result.edgeIndicesNorth = decodeEdgeIndices(gltf, "top", meshoptDecoder);
   return result;
 }
 

package/Source/Core/KTX2Transcoder.js

@@ -1,16 +1,101 @@
 import Check from "./Check.js";
 import CompressedTextureBuffer from "./CompressedTextureBuffer.js";
 import defined from "./defined.js";
+import DeveloperError from "./DeveloperError.js";
+import getAbsoluteUri from "./getAbsoluteUri.js";
 import RuntimeError from "./RuntimeError.js";
 import TaskProcessor from "./TaskProcessor.js";
 
 /**
- * Transcodes KTX2 textures using web workers.
+ * Lets applications use their own Basis Universal build to decode KTX2 textures.
+ * Cesium uses its bundled build by default.
  *
- * @private
+ * @alias KTX2Transcoder
+ * @namespace
+ * @experimental This feature is not final and is subject to change without
+ * Cesium's standard deprecation policy.
  */
 function KTX2Transcoder() {}
 
+/**
+ * The two files that make up an application-supplied Basis Universal build.
+ * Both the JavaScript wrapper and Wasm binary must come from the same build.
+ *
+ * The wrapper must be an ES module whose default export is a factory function.
+ * Cesium calls that function in its KTX2 worker with an Emscripten configuration
+ * that contains the binary bytes in <code>wasmBinary</code>.
+ * The function returns a Basis module, or a promise for that module.
+ *
+ * The module must provide <code>initializeBasis</code>, <code>KTX2File</code>,
+ * and <code>transcoder_texture_format</code>. These APIs must be compatible
+ * with Cesium's bundled Basis version.
+ *
+ * @typedef {object} KTX2Transcoder.BasisTranscoderOptions
+ * @property {string} modulePath The URL of the JavaScript wrapper.
+ * @property {string} wasmBinaryFile The URL of the matching Wasm binary.
+ */
+
+Object.defineProperties(KTX2Transcoder, {
+  /**
+   * Uses your own Basis Universal build to decode KTX2 textures.
+   * Leave this undefined to use Cesium's bundled build.
+   *
+   * Before the first KTX2 load, set both the JavaScript wrapper URL and the
+   * matching Wasm binary URL. Relative URLs resolve against the document URL.
+   * Cesium copies the options and rejects changes after loading starts.
+   *
+   * Cesium's existing KTX2 worker loads both files and compiles the Wasm binary.
+   * See {@link KTX2Transcoder.BasisTranscoderOptions} for the wrapper requirements.
+   *
+   * For a Content Security Policy without <code>'unsafe-eval'</code>, use a
+   * compatible Basis build that does not generate JavaScript at runtime.
+   * The worker's policy must allow the wrapper import, binary fetch, and Wasm compilation.
+   *
+   * @memberof KTX2Transcoder
+   * @type {KTX2Transcoder.BasisTranscoderOptions|undefined}
+   * @default undefined
+   * @experimental This feature is not final and is subject to change without
+   * Cesium's standard deprecation policy.
+   *
+   * @example
+   * Cesium.KTX2Transcoder.basisTranscoderOptions = {
+   *   modulePath: "/decoders/basis_transcoder.js",
+   *   wasmBinaryFile: "/decoders/basis_transcoder.wasm",
+   * };
+   */
+  basisTranscoderOptions: {
+    get: function () {
+      return KTX2Transcoder._basisTranscoderOptions;
+    },
+    set: function (value) {
+      if (defined(KTX2Transcoder._readyPromise)) {
+        throw new DeveloperError(
+          "KTX2Transcoder.basisTranscoderOptions must be configured before the first KTX2 load.",
+        );
+      }
+      if (!defined(value)) {
+        KTX2Transcoder._basisTranscoderOptions = undefined;
+        return;
+      }
+      if (
+        typeof value !== "object" ||
+        typeof value.modulePath !== "string" ||
+        value.modulePath.length === 0 ||
+        typeof value.wasmBinaryFile !== "string" ||
+        value.wasmBinaryFile.length === 0
+      ) {
+        throw new DeveloperError(
+          "KTX2Transcoder.basisTranscoderOptions requires non-empty modulePath and wasmBinaryFile strings.",
+        );
+      }
+      KTX2Transcoder._basisTranscoderOptions = Object.freeze({
+        modulePath: value.modulePath,
+        wasmBinaryFile: value.wasmBinaryFile,
+      });
+    },
+  },
+});
+
 KTX2Transcoder._transcodeTaskProcessor = new TaskProcessor(
   "transcodeKTX2",
   Number.POSITIVE_INFINITY, // KTX2 transcoding is used in place of Resource.fetchImage, so it can't reject as "just soooo busy right now"
@@ -19,10 +104,15 @@ KTX2Transcoder._transcodeTaskProcessor = new TaskProcessor(
 KTX2Transcoder._readyPromise = undefined;
 
 function makeReadyPromise() {
+  const options = KTX2Transcoder._basisTranscoderOptions;
+  const wasmOptions = defined(options)
+    ? {
+        modulePath: getAbsoluteUri(options.modulePath),
+        wasmBinaryFile: getAbsoluteUri(options.wasmBinaryFile),
+      }
+    : { wasmBinaryFile: "ThirdParty/basis_transcoder.wasm" };
   const readyPromise = KTX2Transcoder._transcodeTaskProcessor
-    .initWebAssemblyModule({
-      wasmBinaryFile: "ThirdParty/basis_transcoder.wasm",
-    })
+    .initWebAssemblyModule(wasmOptions)
     .then(function (result) {
       if (result) {
         return KTX2Transcoder._transcodeTaskProcessor;
@@ -33,6 +123,10 @@ function makeReadyPromise() {
   KTX2Transcoder._readyPromise = readyPromise;
 }
 
+/**
+ * Transcodes a KTX2 buffer in the worker.
+ * @private
+ */
 KTX2Transcoder.transcode = function (ktx2Buffer, supportedTargetFormats) {
   //>>includeStart('debug', pragmas.debug);
   Check.defined("supportedTargetFormats", supportedTargetFormats);