@sapui5/sap.ui.vk 1.138.0 → 1.140.0

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

@@ -76,7 +76,7 @@ sap.ui.define([
 	 *
 	 * @public
 	 * @author SAP SE
-	 * @version 1.138.0
+	 * @version 1.140.0
 	 * @extends sap.ui.vk.ViewportBase
 	 * @alias sap.ui.vk.svg.Viewport
 	 */
@@ -389,7 +389,6 @@ sap.ui.define([
 		this._currentViewIndex = 0;
 		this._currentView = null;
 		this._styles.clear();
-		this._isEcad = undefined;
 
 		if (scene) {
 			this.setCamera(new OrthographicCamera());
@@ -581,7 +580,7 @@ sap.ui.define([
 		var node = this.hitTest(x, y, true);
 
 		if (this.isECAD() && node) {
-			const element = this._findElement(node);
+			const element = this.findElement(node);
 			if (element == null) {
 				return this; // nothing found, must be ECAD orphan node
 			}
@@ -748,7 +747,7 @@ sap.ui.define([
 					}
 				};
 				selection.forEach(ref => {
-					const element = this._findElement(ref);
+					const element = this.findElement(ref);
 					if (element != null) {
 						include(element, output);
 					}
@@ -1755,17 +1754,7 @@ sap.ui.define([
 	};
 
 	Viewport.prototype.isECAD = function() {
-		if (this._isEcad != undefined) {
-			return this._isEcad; // cached value
-		}
-		if (this._scene) {
-			const metadata = this._scene.getSceneMetadata();
-			if (metadata && metadata.length !== 0) {
-				const data = metadata.find((el) => el.category === "ecad" && el.tag === "version" && el.value === "8");
-				return (this._isEcad = !!data);
-			}
-		}
-		return (this._isEcad = false);
+		return this._scene?.isECADScene() ?? false;
 	};
 
 	Viewport.prototype._extractMetadata = function(metadata) {
@@ -1830,7 +1819,7 @@ sap.ui.define([
 		root.setMatrix(ElementSVG._multiplyMatrices(reflect, rotate));
 	};
 
-	Viewport.prototype._findElement = function(ref) {
+	Viewport.prototype.findElement = function(ref) {
 		while (ref != null) {
 			const metadata = this._extractMetadata(ref.userData.metadata ?? {});
 
@@ -1844,7 +1833,9 @@ sap.ui.define([
 
 	Viewport.prototype.rotatePcbCW = function() {
 		if (this.isECAD()) {
-			this._pcbRotateAngle -= Math.PI / 2;
+			this._pcbRotateAngle += this._pcbVisibleSurface === EcadLayerZone.Top
+				? -Math.PI / 2
+				: Math.PI / 2;
 			this._setRootTransform();
 			this.zoomTo(ZoomTo.Visible);
 		}
@@ -1852,7 +1843,9 @@ sap.ui.define([
 
 	Viewport.prototype.rotatePcbCCW = function() {
 		if (this.isECAD()) {
-			this._pcbRotateAngle += Math.PI / 2;
+			this._pcbRotateAngle += this._pcbVisibleSurface === EcadLayerZone.Top
+				? Math.PI / 2
+				: -Math.PI / 2;
 			this._setRootTransform();
 			this.zoomTo(ZoomTo.Visible);
 		}

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.138.0`);
+      warn(`Invalid PDF header version: 1.140.0`);
     }
   }
   parseStartXRef() {