@openui5/sap.ui.core 1.126.0 → 1.127.0

package/src/sap/ui/Device.js

@@ -11,7 +11,7 @@
  * This API is independent from any other part of the UI5 framework. This allows it to be loaded beforehand, if it is needed, to create the UI5 bootstrap
  * dynamically depending on the capabilities of the browser or device.
  *
- * @version 1.126.0
+ * @version 1.127.0
  * @namespace
  * @name sap.ui.Device
  * @public
@@ -32,7 +32,7 @@ if (typeof window.sap.ui !== "object") {
 
 	//Skip initialization if API is already available
 	if (typeof window.sap.ui.Device === "object" || typeof window.sap.ui.Device === "function") {
-		var apiVersion = "1.126.0";
+		var apiVersion = "1.127.0";
 		window.sap.ui.Device._checkAPIVersion(apiVersion);
 		return;
 	}
@@ -105,7 +105,7 @@ if (typeof window.sap.ui !== "object") {
 
 	//Only used internal to make clear when Device API is loaded in wrong version
 	Device._checkAPIVersion = function(sVersion) {
-		var v = "1.126.0";
+		var v = "1.127.0";
 		if (v != sVersion) {
 			oLogger.log(WARNING, "Device API version differs: " + v + " <-> " + sVersion);
 		}

package/src/sap/ui/Global.js

@@ -18,9 +18,11 @@
  * sap.ui.lazyRequire("sap.ui.core.Control");
  * sap.ui.lazyRequire("sap.m.Button");
  *
- * @version 1.126.0
+ * @version 1.127.0
  * @author  SAP SE
  * @public
+ * @fileoverview
+ * @deprecated Version and buildtime information can be retrieved via sap/ui/core/Core.versionInfo
  */
 
 /*global OpenAjax */
@@ -42,23 +44,11 @@ sap.ui.define([
 	// soft dependency to sap/ui/base/Object
 	var BaseObject;
 
-	/**
-	 * Root namespace for JavaScript functionality provided by SAP SE.
-	 *
-	 * The <code>sap</code> namespace is automatically registered with the
-	 * OpenAjax hub if it exists.
-	 *
-	 * @version 1.126.0
-	 * @namespace
-	 * @public
-	 * @name sap
-	 */
-
 	/**
 	 * The <code>sap.ui</code> namespace is the central OpenAjax compliant entry
 	 * point for UI related JavaScript functionality provided by SAP.
 	 *
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @namespace
 	 * @name sap.ui
 	 * @public
@@ -69,7 +59,7 @@ sap.ui.define([
 		 * The version of the SAP UI Library
 		 * @type string
 		 */
-		version: "1.126.0",
+		version: "1.127.0",
 		// buildinfo.lastchange is deprecated and is therefore defaulted to empty string
 		buildinfo : { lastchange : "", buildtime : "${buildtime}" }
 	};

package/src/sap/ui/base/BindingInfo.js

@@ -17,7 +17,37 @@ sap.ui.define([
 	"use strict";
 
 	// Marker to not 'forget' ui5Objects
-	var sUI5ObjectMarker = Symbol("ui5object");
+	const UI5_OBJECT_MARKER = Symbol("ui5object");
+
+	// Marker that is used for aggregation binding. It's set on the instance
+	// cloned from the given template with value pointing to the original
+	// parent where the aggregation is defined. In case the aggregation is
+	// forwarded to another control, the original parent isn't changed and still
+	// points to the control before the aggregation gets forwarded.
+	const ORIGINAL_PARENT = Symbol("OriginalParent");
+
+	// Marker symbol for BindingInfos which already have extracted a
+	// named model from their path
+	const MODEL_NAME_EXTRACTED = Symbol("ModelNameExtracted");
+
+	/**
+	 * Checks if the "path" of the given BindingInfo/part contains
+	 * a model name and if so extracts it accordingly.
+	 * @param {sap.ui.base.BindingInfo} oPart the BindingInfo to check for a model name
+	 * @returns {sap.ui.base.BindingInfo} the modified BindingInfo
+	 */
+	function extractModelName(oPart) {
+		if (!oPart[MODEL_NAME_EXTRACTED]) {
+			// if a model separator is found in the path, extract model name and path
+			const iSeparatorPos = oPart.path.indexOf(">");
+			if (iSeparatorPos > 0) {
+				oPart.model = oPart.path.substr(0, iSeparatorPos);
+				oPart.path = oPart.path.substr(iSeparatorPos + 1);
+				oPart[MODEL_NAME_EXTRACTED] = true;
+			}
+		}
+		return oPart;
+	}
 
 	/**
 	 * This module is responsible for the following tasks:
@@ -40,8 +70,6 @@ sap.ui.define([
 		 * @ui5-restricted sap.ui.base, sap.ui.core
 		 */
 		createProperty: function(oBindingInfo) {
-			var iSeparatorPos;
-
 			// only one binding object with one binding specified
 			if (!oBindingInfo.parts) {
 				oBindingInfo.parts = [];
@@ -74,11 +102,7 @@ sap.ui.define([
 
 				// if a model separator is found in the path, extract model name and path
 				if (oPart.path !== undefined) {
-					iSeparatorPos = oPart.path.indexOf(">");
-					if (iSeparatorPos > 0) {
-						oPart.model = oPart.path.substr(0, iSeparatorPos);
-						oPart.path = oPart.path.substr(iSeparatorPos + 1);
-					}
+					extractModelName(oPart);
 				}
 				// if a formatter exists the binding mode can be one way or one time only
 				if (oBindingInfo.formatter &&
@@ -113,16 +137,18 @@ sap.ui.define([
 			} else if (oBindingInfo.template) {
 				// if we have a template we will create a factory function
 				oBindingInfo.factory = function(sId) {
-					return oBindingInfo.template.clone(sId);
+					const oClone = oBindingInfo.template.clone(sId);
+					// This flag is currently used by FieldHelp.js and it needs to be set only when a binding template is given.
+					// When a custom factory method is provided, it's not guaranteed that all instances created from the factory
+					// are bound to the same sub-path under the given aggregation path. Therefore we can't use the parent
+					// control for showing the header of the field help.
+					oClone[ORIGINAL_PARENT] = oBindingInfo[ORIGINAL_PARENT];
+					return oClone;
 				};
 			}
 
 			// if a model separator is found in the path, extract model name and path
-			var iSeparatorPos = oBindingInfo.path.indexOf(">");
-			if (iSeparatorPos > 0) {
-				oBindingInfo.model = oBindingInfo.path.substr(0, iSeparatorPos);
-				oBindingInfo.path = oBindingInfo.path.substr(iSeparatorPos + 1);
-			}
+			extractModelName(oBindingInfo);
 			return oBindingInfo;
 		},
 
@@ -134,14 +160,8 @@ sap.ui.define([
 		 * @ui5-restricted sap.ui.base, sap.ui.core
 		 */
 		createObject: function(oBindingInfo) {
-			var iSeparatorPos;
-
 			// if a model separator is found in the path, extract model name and path
-			iSeparatorPos = oBindingInfo.path.indexOf(">");
-			if (iSeparatorPos > 0) {
-				oBindingInfo.model = oBindingInfo.path.substr(0, iSeparatorPos);
-				oBindingInfo.path = oBindingInfo.path.substr(iSeparatorPos + 1);
-			}
+			extractModelName(oBindingInfo);
 			return oBindingInfo;
 		},
 
@@ -155,9 +175,9 @@ sap.ui.define([
 				if (oValue.Type) {
 					// if value contains the 'Type' property (capital 'T'), this is not a binding info.
 					oBindingInfo = undefined;
-				} else if (oValue[sUI5ObjectMarker]) {
+				} else if (oValue[UI5_OBJECT_MARKER]) {
 					// no bindingInfo, delete marker
-					delete oValue[sUI5ObjectMarker];
+					delete oValue[UI5_OBJECT_MARKER];
 				} else if (oValue.ui5object) {
 					// if value contains ui5object property, this is not a binding info,
 					// remove it and not check for path or parts property
@@ -199,7 +219,8 @@ sap.ui.define([
 			}
 		},
 
-		UI5ObjectMarker: sUI5ObjectMarker
+		UI5ObjectMarker: UI5_OBJECT_MARKER,
+		OriginalParent: ORIGINAL_PARENT
 	};
 
 	/**

package/src/sap/ui/base/DataType.js

@@ -711,6 +711,25 @@ sap.ui.define([
 	};
 
 
+	/**
+	 * A string type representing an ID or a name.
+	 *
+	 * Allowed is a sequence of characters (capital/lowercase), digits, underscores, dashes, points and/or colons.
+	 * It may start with a character or underscore only.
+	 *
+	 * @typedef {string} sap.ui.core.ID
+	 * @final
+	 * @public
+	 * @ui5-module-override sap/ui/core/library ID
+	 */
+	DataType.createType('sap.ui.core.ID', {
+			isValid : function(vValue) {
+				return /^([A-Za-z_][-A-Za-z0-9_.:]*)$/.test(vValue);
+			}
+		},
+		DataType.getType('string')
+	);
+
 	return DataType;
 
 }, /* bExport= */ true);

package/src/sap/ui/base/Event.js

@@ -23,7 +23,7 @@ sap.ui.define(['./Object', "sap/base/assert"],
 	 * @extends sap.ui.base.Object
 	 * @implements sap.ui.base.Poolable
 	 * @author SAP SE
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @alias sap.ui.base.Event
 	 * @public
 	 * @template {Object<string,any>} [ParamsType=object]

package/src/sap/ui/base/EventProvider.js

@@ -17,7 +17,7 @@ sap.ui.define(['./Event', './Object', "sap/base/assert", "sap/base/Log"],
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @public
 	 * @alias sap.ui.base.EventProvider
 	 */

package/src/sap/ui/base/Interface.js

@@ -27,8 +27,38 @@ sap.ui.define(['sap/ui/base/Object'], function(BaseObject) {
 	 * <b>Note:</b> If a class returns a facade in its constructor, only the defined functions will be visible,
 	 * no internals of the class can be accessed.
 	 *
+	 * @example
+	 * <code>sap.ui.define([
+	 *   "sap/ui/base/Object",
+	 *   "sap/ui/base/Interface"
+	 * ], (BaseObject, Interface) => {
+	 *   "use strict";
+	 *   const MyModule = BaseObject.extend("MyModule", {
+	 *     constructor: function() {
+	 *       this._limitedModuleInterface = new Interface(this, [
+	 *         "doSomething",
+	 *         "doSomethingElse"
+	 *       ]);
+	 *     },
+	 *     doSomething() {
+	 *       // Can be called on a MyModule instance and on the facade
+	 *     },
+	 *     doSomethingElse() {
+	 *       // Can be called on a MyModule instance and on the facade
+	 *     },
+	 *     doSomethingNot() {
+	 *      // Can be called only on a MyModule instance and not on the facade
+	 *     },
+	 *     getFacade() {
+	 *       return this._limitedModuleInterface;
+	 *     }
+	 *   });
+	 *   return MyModule;
+	 * });
+	 * </code>
+	 *
 	 * @author Malte Wedel, Daniel Brinkmann
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @param {sap.ui.base.Object} oObject
 	 *   Object for which a facade should be created
 	 * @param {string[]} aMethods

package/src/sap/ui/base/ManagedObject.js

@@ -264,7 +264,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @public
 	 * @alias sap.ui.base.ManagedObject
 	 */
@@ -2318,9 +2318,6 @@ sap.ui.define([
 		} else {
 			i = iIndex;
 		}
-		if (i !== iIndex) {
-			future.warningThrows("ManagedObject.insertAggregation: index '" + iIndex + "' out of range [0," + aChildren.length + "], forced to " + i);
-		}
 		aChildren.splice(i, 0, oObject);
 		oObject.setParent(this, sAggregationName, bSuppressInvalidate);
 
@@ -3752,6 +3749,8 @@ sap.ui.define([
 			}
 		}
 
+		oBindingInfo[BindingInfo.OriginalParent] ??= this;
+
 		var oForwarder = oMetadata.getAggregationForwarder(sName);
 		if (oForwarder && oForwarder.forwardBinding) {
 			oForwarder.getTarget(this).bindAggregation(oForwarder.targetAggregationName, oBindingInfo);

package/src/sap/ui/base/ManagedObjectMetadata.js

@@ -79,7 +79,7 @@ function(
 	 *
 	 *
 	 * @author Frank Weigel
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @since 0.8.6
 	 * @alias sap.ui.base.ManagedObjectMetadata
 	 * @extends sap.ui.base.Metadata

package/src/sap/ui/base/Metadata.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 *
 	 * @class Metadata for a class.
 	 * @author Frank Weigel
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @since 0.8.6
 	 * @public
 	 * @alias sap.ui.base.Metadata

package/src/sap/ui/base/Object.js

@@ -26,7 +26,7 @@ sap.ui.define(['./Metadata', "sap/base/Log"],
 	 * @class Base class for all SAPUI5 Objects.
 	 * @abstract
 	 * @author Malte Wedel
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @public
 	 * @alias sap.ui.base.Object
 	 * @throws {Error} When an instance of the class or its subclasses is created without the <code>new</code> operator.

package/src/sap/ui/base/ObjectPool.js

@@ -59,7 +59,7 @@ sap.ui.define(['./Object'],
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @alias sap.ui.base.ObjectPool
 	 * @public
 	 */

package/src/sap/ui/core/.library

@@ -6,7 +6,7 @@
   <copyright>OpenUI5
  * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-  <version>1.126.0</version>
+  <version>1.127.0</version>
 
   <documentation>The SAPUI5 Core Runtime.
 

package/src/sap/ui/core/.theming

@@ -0,0 +1,8 @@
+{
+  "sEntity": "Library",
+  "sId": "sap/ui/core",
+  "aFiles": [
+    "library",
+    "global"
+  ]
+}

package/src/sap/ui/core/BusyIndicator.js

@@ -42,7 +42,7 @@ sap.ui.define([
 	 * Provides methods to show or hide a waiting animation covering the whole
 	 * page and blocking user interaction.
 	 * @namespace
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @public
 	 * @alias sap.ui.core.BusyIndicator
 	 */

package/src/sap/ui/core/Component.js

@@ -256,7 +256,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @alias sap.ui.core.Component
 	 * @since 1.9.2
 	 */

package/src/sap/ui/core/ComponentContainer.js

@@ -58,7 +58,7 @@ sap.ui.define([
 	 * See also {@link module:sap/ui/core/ComponentSupport}.
 	 *
 	 * @extends sap.ui.core.Control
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.ComponentContainer

package/src/sap/ui/core/ComponentMetadata.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * @public
 	 * @class
 	 * @author SAP SE
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @since 1.9.2
 	 * @alias sap.ui.core.ComponentMetadata
 	 * @extends sap.ui.base.ManagedObjectMetadata

package/src/sap/ui/core/ComponentSupport.js

@@ -111,7 +111,7 @@ sap.ui.define([
 	 * @author SAP SE
 	 * @public
 	 * @since 1.58.0
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @namespace
 	 * @alias module:sap/ui/core/ComponentSupport
 	 */

package/src/sap/ui/core/Configuration.js

@@ -41,7 +41,7 @@ sap.ui.define([
 ) {
 	"use strict";
 
-	var oVersion = new Version("1.126.0");
+	var oVersion = new Version("1.127.0");
 	var oFormatSettings;
 
 	// Lazy dependency to core

package/src/sap/ui/core/Control.js

@@ -84,7 +84,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @alias sap.ui.core.Control
 	 */
 	var Control = Element.extend("sap.ui.core.Control", /** @lends sap.ui.core.Control.prototype */ {
@@ -1282,7 +1282,7 @@ sap.ui.define([
 	 * @return {sap.ui.core.AccessibilityInfo} Current accessibility state of the control.
 	 * @since 1.37.0
 	 * @function
-	 * @name sap.ui.core.Control.prototype.getAccessibilityInfo
+	 * @name sap.ui.core.Control.prototype.getAccessibilityInfo?
 	 * @protected
 	 */
 	//Control.prototype.getAccessibilityInfo = function() { return null; };

package/src/sap/ui/core/Core.js

@@ -30,6 +30,7 @@ sap.ui.define([
 	"sap/base/util/ObjectPath",
 	"sap/base/util/Version",
 	"sap/ui/Device",
+	"sap/ui/Global",
 	"sap/ui/VersionInfo",
 	"sap/ui/base/EventProvider",
 	"sap/ui/base/Interface",
@@ -80,6 +81,7 @@ sap.ui.define([
 		ObjectPath,
 		Version,
 		Device,
+		Global,
 		VersionInfo,
 		EventProvider,
 		Interface,
@@ -102,6 +104,42 @@ sap.ui.define([
 
 	var oCore;
 
+	/**
+	 * The Core version, e.g. '1.127.0'
+	 * @name sap.ui.core.Core.version
+	 * @final
+	 * @type {string}
+	 * @static
+	 * @since 1.127
+	 * @private
+	 * @ui5-restricted sap.ui.core, sap.ui.test
+	 */
+	const sVersion = "1.127.0";
+
+	/**
+	 * The buildinfo.
+	 * @typedef {object} sap.ui.core.Core.BuildInfo
+	 * @property {string} buildtime the build timestamp, e.g. '20240625091308'
+	 * @since 1.127
+	 * @private
+	 * @ui5-restricted sap.ui.core, sap.ui.test
+	 */
+
+	/**
+	 * The buildinfo, containing a build timestamp.
+	 * @name sap.ui.core.Core.buildinfo
+	 * @final
+	 * @type {sap.ui.core.Core.BuildInfo}
+	 * @static
+	 * @since 1.127
+	 * @private
+	 * @ui5-restricted sap.ui.core, sap.ui.test
+	 */
+	const oBuildinfo = Object.assign({}, Global.buildinfo);
+	 // freeze since it is exposed as a property on the Core and must not be changed at runtime
+	 // (refer to Core#getInterface)
+	Object.freeze(oBuildinfo);
+
 	// getComputedStyle polyfill + syncXHR fix for firefox
 	if ( Device.browser.firefox ) {
 		getComputedStyleFix();
@@ -396,7 +434,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 * @final
 	 * @author SAP SE
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @alias sap.ui.core.Core
 	 * @public
 	 * @hideconstructor
@@ -956,6 +994,23 @@ sap.ui.define([
 
 	});
 
+	/*
+	 * Overwrite getInterface so that we can add the version info as a property
+	 * to the Core.
+	 */
+	Core.prototype.getInterface = function() {
+		const oCoreInterface = BaseObject.prototype.getInterface.call(this);
+		Object.defineProperties(oCoreInterface, {
+			"version": {
+				value: sVersion
+			},
+			"buildinfo": {
+				value: oBuildinfo
+			}
+		});
+		return oCoreInterface;
+	};
+
 	/**
 	 * Map of event names and ids, that are provided by this class
 	 * @private
@@ -2308,7 +2363,7 @@ sap.ui.define([
 	 *    synchronously rendering UI updates is no longer supported as it can lead to unnecessary
 	 *    intermediate DOM updates or layout shifting etc. Controls should rather use invalidation
 	 *    and apps should not trigger rendering at all but rather rely on the framework's automatic
-	 *    update mechanisms. Test code can use the test module <code>sap/ui/qunit/utils/nextUIUpdate</code>
+	 *    update mechanisms. Test code can use the test module <code>sap/ui/test/utils/nextUIUpdate</code>
 	 *    as a convenient way to wait for the next asynchronous rendering.
 	 */
 	Core.prototype.applyChanges = function() {

package/src/sap/ui/core/CustomData.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * in the documentation.
 	 *
 	 * @extends sap.ui.core.Element
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.CustomData

package/src/sap/ui/core/DeclarativeSupport.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * @class Static class for enabling declarative UI support.
 	 *
 	 * @author Peter Muessig, Tino Butz
-	 * @version 1.126.0
+	 * @version 1.127.0
 	 * @since 1.7.0
 	 * @public
 	 * @alias sap.ui.core.DeclarativeSupport