@openui5/sap.ui.core 1.129.0 → 1.130.0

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

@@ -0,0 +1,174 @@
+/*
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([], function() {
+	"use strict";
+
+	class Hook {
+		#allowMultiple;
+		#callbacks;
+
+		/**
+		 * @constructor
+		 * @param {boolean} bAllowMultiple Set to 'true' if the hook should allow multiple callbacks, 'false' otherwise.
+		 */
+		constructor(bAllowMultiple) {
+			this.#allowMultiple = bAllowMultiple;
+			this.#callbacks = bAllowMultiple ? [] : null;
+		}
+
+		/**
+		 * Registers a callback function for this hook.
+		 * @param {Function} fnCallback The callback to register.
+		 * @throws {Error} Throws an error if the callback is not a function.
+		 * @throws {Error} Throws an error if the callback is already registered for this hook.
+		 */
+		register(fnCallback) {
+			if (typeof fnCallback !== "function") {
+				throw new Error('Registered callback must be a function.');
+			}
+			if (this.#allowMultiple) {
+				this.#callbacks.push(fnCallback);
+			} else {
+				if (this.#callbacks) {
+					throw new Error(`Callback is already registered. The hooks are restricted to the 'sap.ui.fl' library only.`);
+				}
+
+				this.#callbacks = fnCallback;
+			}
+		}
+
+		/**
+		 * Checks if callback function is registered for this hook.
+		 * @returns {boolean} Returns 'true' if registered, else 'false'.
+		 */
+		isRegistered() {
+			return this.#allowMultiple ? this.#callbacks.length > 0 : !!this.#callbacks;
+		}
+
+		/**
+		 * Deregisters the callback(s) from this hook.
+		 */
+		deregister() {
+			this.#callbacks = this.#allowMultiple ? [] : null;
+		}
+
+		/**
+		 * Executes the registered callback for this hook.
+		 *
+		 * @param {any} args Arguments to pass to the callback function(s).
+		 * @returns {any|any[]} Returns the result of the callback(s). If multiple callbacks
+		 * 						are registered, returns an array of results will be returned.
+		 * 						If a single callback is registered, it will return the result directly.
+		 * 						If no callback is registered, the function returns 'undefined'.
+		 */
+		execute(...args) {
+			return this.#allowMultiple ?
+				this.#callbacks.map((callback) => callback(...args)) :
+				this.#callbacks?.(...args);
+		}
+	}
+
+	/**
+	 * A registry of all <code>sap.ui.core.Component</code> hooks that can be used to register, deregister, and execute callback functions.
+	 *
+	 * @alias module:sap/ui/core/ComponentHooks
+	 * @namespace
+	 * @private
+	 * @ui5-restricted sap.ui.fl,sap.ui.integration
+	 *
+	 */
+	const ComponentHooks = {
+		/**
+		 * Callback handler that executes when a manifest model (ODataModel v2 and v4) is created.
+		 * The model instance, the manifest model ID, and the configuration object will be passed into the registered function.
+		 *
+		 * Example usage:
+		 * <pre>
+		 * sap.ui.require(['sap/ui/core/ComponentHooks'], function(ComponentHooks) {
+		 *   ComponentHooks.onModelCreated.register(function(oModel, sModelID, oConfig) {
+		 *     // do some logic
+		 *   });
+		 * });
+		 * </pre>
+		 *
+		 * @private
+		 * @ui5-restricted sap.ui.fl
+		 * @since 1.130
+		 */
+		onModelCreated: new Hook(false),
+
+		/**
+		 * Callback handler which will be executed once a component instance has
+		 * been created by {#link sap.ui.component}. The component instance and the
+		 * configuration object will be passed into the registered function.
+		 * For async scenarios (<code>vConfig.async = true</code>) a Promise can be provided as
+		 * return value from the callback handler to delay resolving the Promise
+		 * returned by {@link sap.ui.component}.
+		 * In synchronous scenarios the return value will be ignored.
+		 *
+		 * Example usage:
+		 * <pre>
+		 * sap.ui.require(['sap/ui/core/ComponentHooks'], function(ComponentHooks) {
+		 *   ComponentHooks.onInstanceCreated.register(function(oComponent, oConfig) {
+		 *     // do some logic with the config
+		 *
+		 *     // optionally return a Promise
+		 *     return doAsyncStuff();
+		 *   });
+		 * });
+		 * </pre>
+		 * <b>ATTENTION:</b> This hook must only be used by UI flexibility (sap.ui.fl)
+		 * or the sap.ui.integration library.
+		 *
+		 * @private
+		 * @ui5-restricted sap.ui.fl,sap.ui.integration
+		 * @since 1.43.0
+		 */
+		onInstanceCreated: new Hook(true),
+
+		/**
+		 * Callback handler which will be executed once the manifest.json was
+		 * loaded for a component, but before the manifest is interpreted.
+		 * The loaded manifest will be passed into the registered function.
+		 *
+		 * The callback may modify the parsed manifest object and must return a Promise which
+		 * resolves with the manifest object. If the Promise is rejected, the component creation
+		 * fails with the rejection reason.
+		 *
+		 * @private
+		 * @ui5-restricted sap.ui.fl
+		 * @since 1.70.0
+		 */
+		onPreprocessManifest: new Hook(false),
+
+		/**
+		 * Callback handler which will be executed once the component is loaded. A copy of the
+		 * configuration object together with a copy of the manifest object will be passed into
+		 * the registered function.
+		 * Also a return value is not expected from the callback handler.
+		 * It will only be called for asynchronous manifest first scenarios.
+		 * <p>
+		 * Example usage:
+		 * <pre>
+		 * sap.ui.require(['sap/ui/core/ComponentHooks'], function(ComponentHooks) {
+		 *   ComponentHooks.onComponentLoaded.register(function(oConfig, oManifest) {
+		 *     // do some logic with the config
+		 *   });
+		 * });
+		 * </pre>
+		 * <p>
+		 * <b>ATTENTION:</b> This hook must only be used by UI flexibility (library:
+		 * sap.ui.fl) and will be replaced with a more generic solution!
+		 *
+		 * @private
+		 * @ui5-restricted sap.ui.fl
+		 * @since 1.37.0
+		 */
+		onComponentLoaded: new Hook(false)
+	};
+
+	return ComponentHooks;
+});

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

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * @public
 	 * @class
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.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.129.0
+	 * @version 1.130.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.129.0");
+	var oVersion = new Version("1.130.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.129.0
+	 * @version 1.130.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

@@ -118,7 +118,7 @@ sap.ui.define([
 	 * @private
 	 * @ui5-restricted sap.ui.core, sap.ui.test
 	 */
-	const sVersion = "1.129.0";
+	const sVersion = "1.130.0";
 
 	/**
 	 * The buildinfo.
@@ -443,7 +443,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 * @final
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 * @alias sap.ui.core.Core
 	 * @public
 	 * @hideconstructor

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

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * in the documentation.
 	 *
 	 * @extends sap.ui.core.Element
-	 * @version 1.129.0
+	 * @version 1.130.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.129.0
+	 * @version 1.130.0
 	 * @since 1.7.0
 	 * @public
 	 * @alias sap.ui.core.DeclarativeSupport

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

@@ -138,7 +138,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 * @public
 	 * @alias sap.ui.core.Element
 	 */
@@ -2075,7 +2075,11 @@ sap.ui.define([
 
 		if (typeof vParam === "string") {
 			oDomRef = document.querySelector(vParam);
-		} else if (vParam instanceof window.Element){
+		} else if (typeof vParam === "object"
+			&& vParam.nodeType === Node.ELEMENT_NODE
+			&& typeof vParam.nodeName === "string") {
+			// can't use 'instanceof window.Element' because DOM node may be
+			// created by using the constructor in another frame in Chrome/Edge.
 			oDomRef = vParam;
 		} else if (vParam.jquery) {
 			oDomRef = vParam[0];

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

@@ -37,7 +37,7 @@ sap.ui.define([
 	 *
 	 * @class
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 * @since 0.8.6
 	 * @alias sap.ui.core.ElementMetadata
 	 * @extends sap.ui.base.ManagedObjectMetadata

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

@@ -43,7 +43,7 @@ sap.ui.define([], function() {
 	 *
 	 * @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.129.0
+	 * @version 1.130.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.129.0
+	 * @version 1.130.0
 	 * @public
 	 * @since 1.8.0
 	 * @alias sap.ui.core.EventBus

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

@@ -99,7 +99,7 @@ function(
 	 * @class
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 * @public
 	 * @alias sap.ui.core.Fragment
 	 */
@@ -887,12 +887,13 @@ function(
 				try {
 					pContentPromise.unwrap();
 				} catch (e) {
-					future.errorThrows("An Error occured during XML processing of '" +
-							this.getMetadata().getName() +
+					future.errorThrows(this.getMetadata().getName() +
+							": An Error occured during XML processing of '" +
+							(mSettings.fragmentName || mSettings.fragmentContent) +
 							"' with id '" +
 							this.getId() +
-							"':\n" +
-							e.stack);
+							"'",
+							{ cause: e });
 				}
 			}
 			return pContentPromise;

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

@@ -44,7 +44,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.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.129.0
+	 * @version 1.130.0
 	 * @alias sap.ui.core.History
 	 * @protected
 	 */

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

@@ -75,7 +75,7 @@ sap.ui.define([
 	 * @implements sap.ui.core.IFormContent
 	 *
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 *
 	 * @public
 	 * @since 1.11.1

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

@@ -16,7 +16,7 @@ sap.ui.define(['./library', 'sap/ui/core/Lib'],
 		 * Helper functionality for indication color support.
 		 *
 		 * @author SAP SE
-		 * @version 1.129.0
+		 * @version 1.130.0
 		 * @public
 		 * @namespace sap.ui.core.IndicationColorSupport
 		 * @since 1.66

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

@@ -23,7 +23,7 @@ sap.ui.define(['../base/Object', './EventBus', "sap/base/assert"],
 		 *
 		 * @extends sap.ui.base.Object
 		 * @author SAP SE
-		 * @version 1.129.0
+		 * @version 1.130.0
 		 * @public
 		 * @since 1.11.0
 		 * @alias sap.ui.core.IntervalTrigger

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

@@ -35,7 +35,7 @@ sap.ui.define(["./library", "./Core", "sap/ui/base/ManagedObject", "sap/base/Log
 		 * @extends sap.ui.base.ManagedObject
 		 *
 		 * @author SAP SE
-		 * @version 1.129.0
+		 * @version 1.130.0
 		 * @hideconstructor
 		 * @public
 		 * @since 1.78

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

@@ -12,7 +12,7 @@ sap.ui.define([], function() {
 	 * Provides the default renderer for the controls that have set their <code>visible</code> property to <code>false</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 * @alias module:sap/ui/core/InvisibleRenderer
 	 * @since 1.66.0
 	 * @protected

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

@@ -34,7 +34,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 *
 	 * @public
 	 * @since 1.27.0

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

@@ -24,7 +24,7 @@ sap.ui.define(['./Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.Item

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

@@ -15,18 +15,6 @@ sap.ui.define(['../base/ManagedObject', "sap/base/assert"],
 	// Mapping between the outer control and the inner control when outer control overwrites 'getIdForLabel'
 	const CONTROL_TO_INNERCONTROL_MAPPING = {};
 
-	// The controls which should not be referenced by a "for" attribute (Specified in the HTML standard).
-	// Extend when needed.
-	var NON_LABELABLE_CONTROLS = [
-		"sap.ui.comp.navpopover.SmartLink",
-		"sap.m.Link",
-		"sap.m.Label",
-		"sap.m.Text",
-		"sap.m.Select",
-		"sap.ui.webc.main.Label",
-		"sap.ui.webc.main.Link"
-	];
-
 	var Element;
 
 	// Returns the control for the given id (if available) and invalidates it if desired
@@ -195,8 +183,7 @@ sap.ui.define(['../base/ManagedObject', "sap/base/assert"],
 			return oControl.hasLabelableHTMLElement();
 		}
 
-		var sName = oControl.getMetadata().getName();
-		return NON_LABELABLE_CONTROLS.indexOf(sName) < 0;
+		return true;
 	}
 
 	/**
@@ -205,7 +192,7 @@ sap.ui.define(['../base/ManagedObject', "sap/base/assert"],
 	 * @see sap.ui.core.LabelEnablement#enrich
 	 *
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 * @protected
 	 * @alias sap.ui.core.LabelEnablement
 	 * @namespace

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

@@ -23,7 +23,7 @@ sap.ui.define(['./Element', "sap/ui/thirdparty/jquery", './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.LayoutData

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

@@ -23,7 +23,7 @@ sap.ui.define(['./Item', './library'],
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.ListItem

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

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 *
 	 * @public
 	 * @since 1.11.0

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

@@ -20,7 +20,7 @@ sap.ui.define(['sap/base/assert', 'sap/ui/base/Object', "sap/base/i18n/Localizat
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.129.0
+	 * @version 1.130.0
 	 * @public
 	 * @alias sap.ui.core.Locale
 	 */