@sapui5/sap.ui.vk 1.139.0 → 1.140.0

package/src/sap/ui/vk/library.js

@@ -62,7 +62,7 @@ sap.ui.define([
 	 * @namespace
 	 * @name sap.ui.vk
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @public
 	 */
 
@@ -150,7 +150,7 @@ sap.ui.define([
 			"sap.ui.vk.tools.PoiManipulationTool"
 		],
 		noLibraryCSS: false,
-		version: "1.139.0",
+		version: "1.140.0",
 		designtime: "sap/ui/vk/designtime/library.designtime"
 	});
 

package/src/sap/ui/vk/measurements/Angle.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 * @param {object} [settings] A JSON-like object.
 	 * @private
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @alias sap.ui.vk.measurement.Angle
 	 * @since 1.101.0
 	 */

package/src/sap/ui/vk/measurements/Area.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 * @param {object} [settings] A JSON-like object.
 	 * @private
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @alias sap.ui.vk.measurement.Area
 	 * @since 1.101.0
 	 */

package/src/sap/ui/vk/measurements/Distance.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @param {object} [settings] A JSON-like object.
 	 * @private
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @alias sap.ui.vk.measurement.Distance
 	 * @since 1.101.0
 	 */

package/src/sap/ui/vk/measurements/Edge.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @param {float[]} [settings.edge] World coordinates of the edge ends in form <code>[x1, y1, z1, x2, y2, z2]</code>.
 	 * @private
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @alias sap.ui.vk.measurement.Edge
 	 * @since 1.101.0
 	 */

package/src/sap/ui/vk/measurements/Face.js

@@ -44,7 +44,7 @@ sap.ui.define([
 	 *     where <code>e</code> is the number of edges in the list.
 	 * @private
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @alias sap.ui.vk.measurement.Face
 	 * @since 1.101.0
 	 */

package/src/sap/ui/vk/measurements/Feature.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @abstract
 	 * @private
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @alias sap.ui.vk.measurement.Feature
 	 * @since 1.101.0
 	 */

package/src/sap/ui/vk/measurements/Vertex.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @param {float[]} [settings.vertex] World coordinates of the vertex in form <code>[x, y, z]</code>.
 	 * @private
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @alias sap.ui.vk.measurement.Vertex
 	 * @since 1.101.0
 	 */

package/src/sap/ui/vk/pdf/ContentManager.js

@@ -43,7 +43,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new ContentManager object.
 	 * @private
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @extends sap.ui.vk.ContentManager
 	 * @alias sap.ui.vk.pdf.ContentManager
 	 * @since 1.123.0

package/src/sap/ui/vk/pdf/Viewport.js

@@ -64,7 +64,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.vk.ViewportBase
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @constructor
 	 * @public
 	 * @alias sap.ui.vk.pdf.Viewport

package/src/sap/ui/vk/svg/BaseNodeProxy.js

@@ -35,7 +35,7 @@ sap.ui.define([
 	 *
 	 * @public
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @extends sap.ui.vk.BaseNodeProxy
 	 * @implements sap.ui.base.Poolable
 	 * @alias sap.ui.vk.svg.BaseNodeProxy

package/src/sap/ui/vk/svg/ContentDeliveryService.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @class Provides a class to communicate with content delivery service.
 	 * @private
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @extends sap.ui.base.ManagedObject
 	 * @alias sap.ui.vk.svg.ContentDeliveryService
 	 */

package/src/sap/ui/vk/svg/ContentManager.js

@@ -45,7 +45,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new ContentManager object.
 	 * @protected
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @extends sap.ui.vk.ContentManager
 	 * @alias sap.ui.vk.svg.ContentManager
 	 * @since 1.80.0

package/src/sap/ui/vk/svg/NodeHierarchy.js

@@ -55,7 +55,7 @@ sap.ui.define([
 	 *
 	 * @public
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @extends sap.ui.vk.NodeHierarchy
 	 * @alias sap.ui.vk.svg.NodeHierarchy
 	 */

package/src/sap/ui/vk/svg/NodeProxy.js

@@ -36,7 +36,7 @@ sap.ui.define([
 	 *
 	 * @public
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @extends sap.ui.vk.NodeProxy
 	 * @alias sap.ui.vk.svg.NodeProxy
 	 */

package/src/sap/ui/vk/svg/OrthographicCamera.js

@@ -22,7 +22,7 @@ sap.ui.define([
 	 *
 	 * @public
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @extends sap.ui.vk.OrthographicCamera
 	 * @alias sap.ui.vk.svg.OrthographicCamera
 	 * @since 1.80.0

package/src/sap/ui/vk/svg/Scene.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 *
 	 * @public
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @extends sap.ui.vk.Scene
 	 * @alias sap.ui.vk.svg.Scene
 	 */

package/src/sap/ui/vk/svg/SceneBuilder.js

@@ -66,7 +66,7 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 */
 	var SceneBuilder = function(rootNode, contentResource, resolve, reject) {
 		this._rootNode = rootNode;

package/src/sap/ui/vk/svg/ViewStateManager.js

@@ -49,7 +49,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new ViewStateManager object.
 	 * @public
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @extends sap.ui.vk.ViewStateManagerBase
 	 * @alias sap.ui.vk.svg.ViewStateManager
 	 * @since 1.80.0

package/src/sap/ui/vk/svg/Viewport.js

@@ -76,7 +76,7 @@ sap.ui.define([
 	 *
 	 * @public
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @extends sap.ui.vk.ViewportBase
 	 * @alias sap.ui.vk.svg.Viewport
 	 */

package/src/sap/ui/vk/thirdparty/BufferGeometryUtils.js

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2010-2023 Three.js Authors
+ * Copyright 2010-2025 Three.js Authors
  * SPDX-License-Identifier: MIT
  */
 
@@ -14,6 +14,30 @@ sap.ui.define([
 var Module = (function (exports, three) {
 	'use strict';
 
+	/**
+	 * @module BufferGeometryUtils
+	 * @three_import import * as BufferGeometryUtils from 'three/addons/utils/BufferGeometryUtils.js';
+	 */
+
+	/**
+	 * Computes vertex tangents using the MikkTSpace algorithm. MikkTSpace generates the same tangents consistently,
+	 * and is used in most modelling tools and normal map bakers. Use MikkTSpace for materials with normal maps,
+	 * because inconsistent tangents may lead to subtle visual issues in the normal map, particularly around mirrored
+	 * UV seams.
+	 *
+	 * In comparison to this method, {@link BufferGeometry#computeTangents} (a custom algorithm) generates tangents that
+	 * probably will not match the tangents in other software. The custom algorithm is sufficient for general use with a
+	 * custom material, and may be faster than MikkTSpace.
+	 *
+	 * Returns the original BufferGeometry. Indexed geometries will be de-indexed. Requires position, normal, and uv attributes.
+	 *
+	 * @param {BufferGeometry} geometry - The geometry to compute tangents for.
+	 * @param {Object} MikkTSpace - Instance of `examples/jsm/libs/mikktspace.module.js`, or `mikktspace` npm package.
+	 * Await `MikkTSpace.ready` before use.
+	 * @param {boolean} [negateSign=true] - Whether to negate the sign component (.w) of each tangent.
+	 * Required for normal map conventions in some formats, including glTF.
+	 * @return {BufferGeometry} The updated geometry.
+	 */
 	function computeMikkTSpaceTangents( geometry, MikkTSpace, negateSign = true ) {
 
 		if ( ! MikkTSpace || ! MikkTSpace.isReady ) {
@@ -103,9 +127,11 @@ var Module = (function (exports, three) {
 	}
 
 	/**
-	 * @param  {Array<BufferGeometry>} geometries
-	 * @param  {Boolean} useGroups
-	 * @return {BufferGeometry}
+	 * Merges a set of geometries into a single instance. All geometries must have compatible attributes.
+	 *
+	 * @param {Array<BufferGeometry>} geometries - The geometries to merge.
+	 * @param {boolean} [useGroups=false] - Whether to use groups or not.
+	 * @return {?BufferGeometry} The merged geometry. Returns `null` if the merge does not succeed.
 	 */
 	function mergeGeometries( geometries, useGroups = false ) {
 
@@ -299,8 +325,11 @@ var Module = (function (exports, three) {
 	}
 
 	/**
-	 * @param {Array<BufferAttribute>} attributes
-	 * @return {BufferAttribute}
+	 * Merges a set of attributes into a single instance. All attributes must have compatible properties and types.
+	 * Instances of {@link InterleavedBufferAttribute} are not supported.
+	 *
+	 * @param {Array<BufferAttribute>} attributes - The attributes to merge.
+	 * @return {?BufferAttribute} The merged attribute. Returns `null` if the merge does not succeed.
 	 */
 	function mergeAttributes( attributes ) {
 
@@ -392,8 +421,10 @@ var Module = (function (exports, three) {
 	}
 
 	/**
-	 * @param {BufferAttribute}
-	 * @return {BufferAttribute}
+	 * Performs a deep clone of the given buffer attribute.
+	 *
+	 * @param {BufferAttribute} attribute - The attribute to clone.
+	 * @return {BufferAttribute} The cloned attribute.
 	 */
 	function deepCloneAttribute( attribute ) {
 
@@ -414,8 +445,11 @@ var Module = (function (exports, three) {
 	}
 
 	/**
-	 * @param {Array<BufferAttribute>} attributes
-	 * @return {Array<InterleavedBufferAttribute>}
+	 * Interleaves a set of attributes and returns a new array of corresponding attributes that share a
+	 * single {@link InterleavedBuffer} instance. All attributes must have compatible types.
+	 *
+	 * @param {Array<BufferAttribute>} attributes - The attributes to interleave.
+	 * @return {Array<InterleavedBufferAttribute>} An array of interleaved attributes. If interleave does not succeed, the method returns `null`.
 	 */
 	function interleaveAttributes( attributes ) {
 
@@ -478,7 +512,12 @@ var Module = (function (exports, three) {
 
 	}
 
-	// returns a new, non-interleaved version of the provided attribute
+	/**
+	 * Returns a new, non-interleaved version of the given attribute.
+	 *
+	 * @param {InterleavedBufferAttribute} attribute - The interleaved attribute.
+	 * @return {BufferAttribute} The non-interleaved attribute.
+	 */
 	function deinterleaveAttribute( attribute ) {
 
 		const cons = attribute.data.array.constructor;
@@ -526,7 +565,11 @@ var Module = (function (exports, three) {
 
 	}
 
-	// deinterleaves all attributes on the geometry
+	/**
+	 * Deinterleaves all attributes on the given geometry.
+	 *
+	 * @param {BufferGeometry} geometry - The geometry to deinterleave.
+	 */
 	function deinterleaveGeometry( geometry ) {
 
 		const attributes = geometry.attributes;
@@ -570,8 +613,10 @@ var Module = (function (exports, three) {
 	}
 
 	/**
-	 * @param {BufferGeometry} geometry
-	 * @return {number}
+	 * Returns the amount of bytes used by all attributes to represent the geometry.
+	 *
+	 * @param {BufferGeometry} geometry - The geometry.
+	 * @return {number} The estimate bytes used.
 	 */
 	function estimateBytesUsed( geometry ) {
 
@@ -593,9 +638,11 @@ var Module = (function (exports, three) {
 	}
 
 	/**
-	 * @param {BufferGeometry} geometry
-	 * @param {number} tolerance
-	 * @return {BufferGeometry}
+	 * Returns a new geometry with vertices for which all similar vertex attributes (within tolerance) are merged.
+	 *
+	 * @param {BufferGeometry} geometry - The geometry to merge vertices for.
+	 * @param {number} [tolerance=1e-4] - The tolerance value.
+	 * @return {BufferGeometry} - The new geometry with merged vertices.
 	 */
 	function mergeVertices( geometry, tolerance = 1e-4 ) {
 
@@ -756,9 +803,12 @@ var Module = (function (exports, three) {
 	}
 
 	/**
-	 * @param {BufferGeometry} geometry
-	 * @param {number} drawMode
-	 * @return {BufferGeometry}
+	 * Returns a new indexed geometry based on `TrianglesDrawMode` draw mode.
+	 * This mode corresponds to the `gl.TRIANGLES` primitive in WebGL.
+	 *
+	 * @param {BufferGeometry} geometry - The geometry to convert.
+	 * @param {number} drawMode - The current draw mode.
+	 * @return {BufferGeometry} The new geometry using `TrianglesDrawMode`.
 	 */
 	function toTrianglesDrawMode( geometry, drawMode ) {
 
@@ -867,9 +917,13 @@ var Module = (function (exports, three) {
 
 	/**
 	 * Calculates the morphed attributes of a morphed/skinned BufferGeometry.
-	 * Helpful for Raytracing or Decals.
-	 * @param {Mesh | Line | Points} object An instance of Mesh, Line or Points.
-	 * @return {Object} An Object with original position/normal attributes and morphed ones.
+	 *
+	 * Helpful for Raytracing or Decals (i.e. a `DecalGeometry` applied to a morphed Object with a `BufferGeometry`
+	 * will use the original `BufferGeometry`, not the morphed/skinned one, generating an incorrect result.
+	 * Using this function to create a shadow `Object3`D the `DecalGeometry` can be correctly generated).
+	 *
+	 * @param {Mesh|Line|Points} object - The 3D object to compute morph attributes for.
+	 * @return {Object} An object with original position/normal attributes and morphed ones.
 	 */
 	function computeMorphedAttributes( object ) {
 
@@ -1145,6 +1199,12 @@ var Module = (function (exports, three) {
 
 	}
 
+	/**
+	 * Merges the {@link BufferGeometry#groups} for the given geometry.
+	 *
+	 * @param {BufferGeometry} geometry - The geometry to modify.
+	 * @return {BufferGeometry} - The updated geometry
+	 */
 	function mergeGroups( geometry ) {
 
 		if ( geometry.groups.length === 0 ) {
@@ -1247,15 +1307,14 @@ var Module = (function (exports, three) {
 
 	}
 
-
 	/**
 	 * Modifies the supplied geometry if it is non-indexed, otherwise creates a new,
 	 * non-indexed geometry. Returns the geometry with smooth normals everywhere except
 	 * faces that meet at an angle greater than the crease angle.
 	 *
-	 * @param {BufferGeometry} geometry
-	 * @param {number} [creaseAngle]
-	 * @return {BufferGeometry}
+	 * @param {BufferGeometry} geometry - The geometry to modify.
+	 * @param {number} [creaseAngle=Math.PI/3] - The crease angle in radians.
+	 * @return {BufferGeometry} - The updated geometry
 	 */
 	function toCreasedNormals( geometry, creaseAngle = Math.PI / 3 /* 60 degrees */ ) {
 

package/src/sap/ui/vk/thirdparty/pdf.worker.js

@@ -54306,7 +54306,7 @@ class PDFDocument {
     if (PDF_VERSION_REGEXP.test(version)) {
       this._version = version;
     } else {
-      warn(`Invalid PDF header version: 1.139.0`);
+      warn(`Invalid PDF header version: 1.140.0`);
     }
   }
   parseStartXRef() {