@openui5/sap.ui.core 1.124.1 → 1.125.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.124.1
+ * @version 1.125.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.124.1";
+		var apiVersion = "1.125.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.124.1";
+		var v = "1.125.0";
 		if (v != sVersion) {
 			oLogger.log(WARNING, "Device API version differs: " + v + " <-> " + sVersion);
 		}

package/src/sap/ui/Global.js

@@ -18,7 +18,7 @@
  * sap.ui.lazyRequire("sap.ui.core.Control");
  * sap.ui.lazyRequire("sap.m.Button");
  *
- * @version 1.124.1
+ * @version 1.125.0
  * @author  SAP SE
  * @public
  */
@@ -48,7 +48,7 @@ sap.ui.define([
 	 * The <code>sap</code> namespace is automatically registered with the
 	 * OpenAjax hub if it exists.
 	 *
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @namespace
 	 * @public
 	 * @name sap
@@ -58,7 +58,7 @@ sap.ui.define([
 	 * The <code>sap.ui</code> namespace is the central OpenAjax compliant entry
 	 * point for UI related JavaScript functionality provided by SAP.
 	 *
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @namespace
 	 * @name sap.ui
 	 * @public
@@ -69,7 +69,7 @@ sap.ui.define([
 		 * The version of the SAP UI Library
 		 * @type string
 		 */
-		version: "1.124.1",
+		version: "1.125.0",
 		// buildinfo.lastchange is deprecated and is therefore defaulted to empty string
 		buildinfo : { lastchange : "", buildtime : "${buildtime}" }
 	};

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.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.0
 	 * @public
 	 * @alias sap.ui.base.EventProvider
 	 */

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

@@ -28,7 +28,7 @@ sap.ui.define(['sap/ui/base/Object'], function(BaseObject) {
 	 * no internals of the class can be accessed.
 	 *
 	 * @author Malte Wedel, Daniel Brinkmann
-	 * @version 1.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.0
 	 * @public
 	 * @alias sap.ui.base.ManagedObject
 	 */

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

@@ -79,7 +79,7 @@ function(
 	 *
 	 *
 	 * @author Frank Weigel
-	 * @version 1.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.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.124.1</version>
+  <version>1.125.0</version>
 
   <documentation>The SAPUI5 Core Runtime.
 
@@ -274,7 +274,7 @@
             <copyright>Google Inc.</copyright>
             <pattern>sap/ui/thirdparty/caja-html-sanitizer.js</pattern>
         </lib>
-        <lib name="cldr" displayName="Unicode Common Locale Data Repository" npmName="cldr-core" version="44" hash="132467204ffa486e82a48a3a0e51f5b4" homepage="http://cldr.unicode.org/" id="73555000106100020909">
+        <lib name="cldr" displayName="Unicode Common Locale Data Repository" npmName="cldr-core" version="44" hash="06472d2307e74ae4abc124190d5d6e99" homepage="http://cldr.unicode.org/" id="73555000106100189306">
             <license url="http://www.unicode.org/copyright.html" type="Unicode-DFS-2015" />
             <copyright>1991-2023 Unicode, Inc.</copyright>
             <pattern>sap/ui/core/cldr/*</pattern>
@@ -407,7 +407,7 @@
             <copyright>Isaac Z. Schlueter and Contributors</copyright>
             <pattern partial="true" otherContent="SAP" explanation="LRUPersistentCache.js is overall written by SAP, but portions ('Least Recently Used' logic) are taken from the node-lru-cache project (see https://github.com/isaacs/node-lru-cache/blob/v2.7.3/README.md) and modified.">sap/ui/core/cache/LRUPersistentCache.js</pattern>
         </lib>
-        <lib name="tzdata" displayName="Time Zone Database" npmName="n/a" version="2023d" homepage="http://www.iana.org/time-zones" id="73554900106100123193">
+        <lib name="tzdata" displayName="Time Zone Database" npmName="n/a" version="2023d" homepage="http://www.iana.org/time-zones" id="73555000106100181707">
             <license url="https://github.com/eggert/tz/blob/main/LICENSE" type="LicenseRef-tzdata-PublicDomain" />
             <copyright>Arthur David Olson, Paul Eggert and other contributors</copyright>
             <pattern partial="true" otherContent="SAP" explanation="_timezones.js is overall written by SAP, but the list of IANA timezone IDs is taken from the Timezone Database">../test/sap/ui/core/qunit/i18n/helper/_timezones.js</pattern>

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.124.1
+	 * @version 1.125.0
 	 * @public
 	 * @alias sap.ui.core.BusyIndicator
 	 */

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

@@ -216,8 +216,10 @@ sap.ui.define([
 	}
 
 	/**
-	 * Creates and initializes a new Component with the given <code>sId</code> and
-	 * settings.
+	 * As <code>Component</code> is an abstract base class for components, applications should not call the constructor.
+	 * For many use cases the static {@link #.create Component.create} factory can be used to instantiate a <code>Component</code>.
+	 * Depending on the requirements, the framework also provides other ways to instantiate a <code>Component</code>, documented under the
+	 * {@link topic:958ead51e2e94ab8bcdc90fb7e9d53d0 "Component"} chapter.
 	 *
 	 * The set of allowed entries in the <code>mSettings</code> object depends on
 	 * the concrete subclass and is described there. See {@link sap.ui.core.Component}
@@ -240,7 +242,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @alias sap.ui.core.Component
 	 * @since 1.9.2
 	 */
@@ -626,6 +628,7 @@ sap.ui.define([
 	 * @return {any|null} Value of the manifest section or the key (could be any kind of value)
 	 * @see {@link #getManifestEntry}
 	 * @private
+	 * @ui5-restricted sap.ushell
 	 * @since 1.34.2
 	 */
 	Component.prototype._getManifestEntry = function(sKey, bMerged) {

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.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.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.124.1");
+	var oVersion = new Version("1.125.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.124.1
+	 * @version 1.125.0
 	 * @alias sap.ui.core.Control
 	 */
 	var Control = Element.extend("sap.ui.core.Control", /** @lends sap.ui.core.Control.prototype */ {

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

@@ -360,29 +360,34 @@ sap.ui.define([
 	 */
 
 	/**
-	 * @class Core Class of the SAP UI Library.
+	 * @class Singleton Core instance of the SAP UI Library.
 	 *
-	 * This class boots the Core framework and makes it available for the application
-	 * by requiring <code>sap.ui.core.Core</code>.
-	 *
-	 * The Core provides a {@link #ready ready function} to execute code after the core was booted.
+	 * The module export of <code>sap/ui/core/Core</code> is <b>not</b> a class, but the singleton Core instance itself.
+	 * The <code>sap.ui.core.Core</code> class itself must not be instantiated, except by the framework itself.
+	*
+	 * The Core provides a {@link #ready ready function} to execute code after the Core was booted.
 	 *
 	 * Example:
 	 * <pre>
 	 *
-	 *   oCore.ready(function() {
+	 *   sap.ui.require(["sap/ui/core/Core"], async function(Core) {
+	 *
+	 *     // Usage of a callback function
+	 *     Core.ready(function() {
 	 *       ...
-	 *   });
+	 *     });
 	 *
-	 *   await oCore.ready();
-	 *   ...
+	 *     // Usage of Core.ready() as a Promise
+	 *     await Core.ready();
+	 *     ...
+	 *   });
 	 *
 	 * </pre>
 	 *
 	 * @extends sap.ui.base.Object
 	 * @final
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @alias sap.ui.core.Core
 	 * @public
 	 * @hideconstructor
@@ -555,9 +560,6 @@ sap.ui.define([
 			oFrameOptionsConfig.allowlistService = Security.getAllowlistService();
 			this.oFrameOptions = new FrameOptions(oFrameOptionsConfig);
 
-			// let Element and Component get friend access to the respective register/deregister methods
-			this._grantFriendAccess();
-
 			// handle libraries & modules
 			this.aModules = BaseConfig.get({
 				name: "sapUiModules",
@@ -953,17 +955,6 @@ sap.ui.define([
 			LibraryChanged : "libraryChanged",
 			ValidationError : "validationError", ParseError : "parseError", FormatError : "formatError", ValidationSuccess : "validationSuccess"};
 
-	/**
-	 * The core allows some friend components to register/deregister themselves
-	 * @private
-	 */
-	Core.prototype._grantFriendAccess = function() {
-		// grant ElementMetadata "friend" access to Core for registration
-		ElementMetadata.prototype.register = function(oMetadata) {
-			Library._registerElement(oMetadata);
-		};
-	};
-
 	/**
 	 * Set the body's browser-related attributes.
 	 * @private
@@ -3244,7 +3235,9 @@ sap.ui.define([
 		Rendering.addPrerenderingTask(fnPrerenderingTask, bFirst);
 	};
 
-	/** Returns a Promise that resolves if the Core is initialized.
+	/**
+	 * Returns a Promise that resolves if the Core is initialized.
+	 * Additionally, a callback function can be passed, for use cases where using Promises is not an option.
 	 *
 	 * @param {function():void} [fnReady] If the Core is ready the function will be called immediately, otherwise when the ready Promise resolves.
 	 * @returns {Promise<undefined>} The ready promise

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

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * in the documentation.
 	 *
 	 * @extends sap.ui.core.Element
-	 * @version 1.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.0
 	 * @since 1.7.0
 	 * @public
 	 * @alias sap.ui.core.DeclarativeSupport

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

@@ -134,7 +134,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @public
 	 * @alias sap.ui.core.Element
 	 */

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

@@ -9,9 +9,10 @@ sap.ui.define([
 	'sap/base/Log',
 	'sap/base/util/ObjectPath',
 	'sap/ui/base/ManagedObjectMetadata',
+	'sap/ui/core/Lib',
 	'sap/ui/core/Renderer'
 ],
-	function(Log, ObjectPath, ManagedObjectMetadata, Renderer) {
+	function(Log, ObjectPath, ManagedObjectMetadata, Library, Renderer) {
 	"use strict";
 
 	/**
@@ -36,7 +37,7 @@ sap.ui.define([
 	 *
 	 * @class
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @since 0.8.6
 	 * @alias sap.ui.core.ElementMetadata
 	 * @extends sap.ui.base.ManagedObjectMetadata
@@ -198,7 +199,7 @@ sap.ui.define([
 
 	ElementMetadata.prototype.afterApplySettings = function() {
 		ManagedObjectMetadata.prototype.afterApplySettings.apply(this, arguments);
-		this.register && this.register(this);
+		Library._registerElement(this);
 	};
 
 	ElementMetadata.prototype.isHidden = function() {

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

@@ -43,7 +43,7 @@ sap.ui.define([
 	 *
 	 * @param {boolean} [bDefault=true] Value that should be used as default value for the enhancement of the control.
 	 * @param {boolean} [bLegacy=false] Whether the introduced property should use the old name <code>Enabled</code>.
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @public
 	 * @class
 	 * @alias sap.ui.core.EnabledPropagator

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

@@ -31,7 +31,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @public
 	 * @since 1.8.0
 	 * @alias sap.ui.core.EventBus

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

@@ -112,7 +112,12 @@ sap.ui.define(["sap/base/future", "sap/base/Log", "sap/ui/core/mvc/View", "sap/u
 					type: oExtensionConfig.type
 				};
 
-				// processingMode must not be set for sync path
+				/**
+				 * @deprecated because the 'Sequential' Mode is used by default and it's the only mode that will be supported
+				 * in the next major release
+				 *
+				 * processingMode must not be set for sync path
+				 */
 				if (bAsync && oView._sProcessingMode) {
 					oFactoryConfig.processingMode = oView._sProcessingMode;
 				}
@@ -147,16 +152,25 @@ sap.ui.define(["sap/base/future", "sap/base/Log", "sap/ui/core/mvc/View", "sap/u
 				} else if (oExtensionConfig.className === "sap.ui.core.mvc.View") {
 					oFactoryConfig.viewName = oExtensionConfig.viewName;
 
-					// Call View._create in order to keep the processingMode (e.g. 'SequentialLegacy')
-					// View.create always overrides the processingMode to 'Sequential'
-					var oExtensionView = View._create(oFactoryConfig);
-
-					if (bAsync) {
-						vResult = oExtensionView.loaded();
+					/**
+					 * @ui5-transform-hint replace-local false
+					 */
+					const bLegacyCreate = true;
+
+					if (bLegacyCreate) {
+						// Call View._create in order to keep the processingMode (e.g. 'SequentialLegacy')
+						// View.create always overrides the processingMode to 'Sequential'
+						const oExtensionView = View._create(oFactoryConfig);
+						if (bAsync) {
+							vResult = oExtensionView.loaded();
+						} else {
+							// sync view creation
+							vResult = [oExtensionView]; // vResult is now an array, even if empty - so if a Fragment is configured, the default content below is not added anymore
+						}
 					} else {
-						// sync view creation
-						vResult = [oExtensionView]; // vResult is now an array, even if empty - so if a Fragment is configured, the default content below is not added anymore
+						vResult = View.create(oFactoryConfig);
 					}
+
 				} else {
 					// unknown extension class
 					future.warningThrows("Customizing: Unknown extension className configured in Component.js for extension point '" + sExtName

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

@@ -99,7 +99,7 @@ function(
 	 * @class
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @public
 	 * @alias sap.ui.core.Fragment
 	 */
@@ -150,6 +150,9 @@ function(
 				sOwnerId : { type: 'sap.ui.core.ID', visibility: 'hidden' },
 
 				/**
+				 * @deprecated because only the "Sequential" processing mode will be supported
+				 * in the next major release
+				 *
 				 * The processing mode is not used by the Fragment itself.
 				 * It is only relevant for XMLViews nested within the Fragment.
 				 */
@@ -538,6 +541,11 @@ function(
 
 		mParameters.type = mParameters.type || "XML";
 		mParameters.async = true;
+
+		/**
+		 * @deprecated because the 'Sequential' Mode is used by default and it's the only mode that will be supported
+		 * in the next major release
+		 */
 		mParameters.processingMode = mParameters.processingMode || XMLProcessingMode.Sequential;
 
 		// map new parameter names to classic API, delete new names to avoid assertion failures
@@ -831,7 +839,13 @@ function(
 				this._oContainingView.oController = (mSettings.containingView && mSettings.containingView.oController) || mSettings.oController;
 			}
 
+
+			/**
+			 * @deprecated because the 'Sequential' Mode is used by default and it's the only mode that will be supported
+			 * in the next major release
+			 *
 			// If given, processingMode will be passed down to nested subviews in XMLTemplateProcessor
+			 */
 			this._sProcessingMode = mSettings.processingMode;
 
 			// take the settings preprocessor from the containing view (if any)

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

@@ -44,7 +44,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.HTML

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

@@ -22,7 +22,7 @@ sap.ui.define(['sap/ui/base/Object', "sap/ui/util/Storage"],
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @alias sap.ui.core.History
 	 * @protected
 	 */