@openui5/sap.ui.fl 1.131.1 → 1.132.0

package/src/sap/ui/fl/apply/_internal/flexState/communication/FLPAboutInfo.js

@@ -0,0 +1,140 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+sap.ui.define([
+	"sap/ui/core/Lib",
+	"sap/ui/fl/apply/_internal/flexState/FlexState",
+	"sap/ui/fl/apply/_internal/flexState/ManifestUtils",
+	"sap/ui/fl/apply/api/FlexRuntimeInfoAPI",
+	"sap/ui/fl/Utils"
+], function(
+	Lib,
+	FlexState,
+	ManifestUtils,
+	FlexRuntimeInfoAPI,
+	FlexUtils
+) {
+	"use strict";
+
+	let FLPAboutInfo = {};
+
+	function setAppInfoCustomProperties(oAppLifeCycleService, sLabel, sValue, sApplicationInfoAttributeReference) {
+		const oAppInfo = {
+			info: {
+				customProperties: {
+					[sApplicationInfoAttributeReference]: {
+						label: sLabel,
+						value: sValue,
+						showInAbout: true
+					}
+				}
+			}
+		};
+		oAppLifeCycleService.setAppInfo(oAppInfo);
+	}
+
+	function isUI5Application(oCurrentApplication) {
+		if (oCurrentApplication.homePage || oCurrentApplication.applicationType !== "UI5") {
+			return false;
+		}
+		return true;
+	}
+
+	async function setFlexAdaptationInfoInAppInfo(oAppLifeCycleService, oCurrentApplication) {
+		if (isUI5Application(oCurrentApplication)) {
+			const oCurrentApplicationComponent = oCurrentApplication.componentInstance;
+			const sReference = ManifestUtils.getFlexReference({
+				componentData: oCurrentApplicationComponent.getComponentData(),
+				manifest: oCurrentApplicationComponent.getManifest()
+			});
+			const mPropertyBag = {
+				reference: sReference,
+				componentId: oCurrentApplicationComponent.getId(),
+				manifest: oCurrentApplicationComponent.getManifestObject(),
+				componentData: oCurrentApplicationComponent.getComponentData(),
+				asyncHints: oCurrentApplicationComponent._componentConfig.asyncHints
+			};
+			await FlexState.initialize(mPropertyBag);
+			const sAdaptationId = FlexRuntimeInfoAPI.getContextBasedAdaptationId(mPropertyBag);
+			/**
+			 * In case the adaptationId is "DEFAULT", which is the case, if
+			 * 	1. no context based adaptation has been created yet or
+			 * 	2. the end user contexts do not meet any of the contexts in the created context-based adaptations
+			 * we must not show any ui5.flex.adaptation information in the about dialog.
+			 */
+			if (sAdaptationId === "DEFAULT") {
+				return;
+			}
+			const sAdaptationTitle = FlexRuntimeInfoAPI.getContextBasedAdaptationTitle(mPropertyBag);
+			const sLabel = Lib.getResourceBundleFor("sap.ui.fl").getText("CBA_ABOUT_INFO_DIALOG_LABEL");
+			const sValue = `${sAdaptationTitle} (${sAdaptationId})`;
+			setAppInfoCustomProperties(oAppLifeCycleService, sLabel, sValue, "ui5.flex.adaptation");
+		}
+	}
+
+	async function attachAppLoadedListener() {
+		const oAppLifeCycleService = await FlexUtils.getUShellService("AppLifeCycle");
+		const oCurrentApplication = oAppLifeCycleService.getCurrentApplication();
+		if (oCurrentApplication) {
+			await setFlexAdaptationInfoInAppInfo(oAppLifeCycleService, oCurrentApplication);
+		}
+		oAppLifeCycleService.attachAppLoaded(oAppLifeCycleService, FLPAboutInfo.onAppLoadedListener);
+	}
+
+	function waitForUshellLibraryIsReady() {
+		return new Promise((resolve) => {
+			/**
+			 * We need to dynamically require the BootstrapObserver, because we do not want to accidentially load the whole
+			 * sap.ushell library. Further, we need hard require the module because we are the only once who are using
+			 * it and no one is loading it before.
+			 */
+			sap.ui.require(["sap/ushell/api/BootstrapObserver"], async function(BootstrapObserver) {
+				await BootstrapObserver.ready();
+				resolve();
+			});
+		});
+	}
+
+	function waitForUshellLibraryIsLoaded() {
+		return new Promise((resolve) => {
+			Lib.attachLibraryChanged((oLibraryChangedEvent) => {
+				if (oLibraryChangedEvent.getParameter("operation") === "add" &&
+					oLibraryChangedEvent.getParameter("metadata").sName === "sap.ushell") {
+					resolve();
+				}
+			});
+		});
+	}
+
+	async function waitForUshellLibraryIsLoadedAndReady() {
+		if (!Lib.isLoaded("sap.ushell")) {
+			await waitForUshellLibraryIsLoaded();
+		}
+		await waitForUshellLibraryIsReady();
+	}
+
+	/**
+	 * Provides methods to initialize and handle application loaded events to send custom ui.flex properties to the FLP About Dialog.
+	 *
+	 * @namespace
+	 * @alias module:sap/ui/fl/apply/_internal/flexState/communication/FLPAboutInfo
+	 * @since 1.132
+	 * @private
+	 * @ui5-restricted sap.ui.fl
+	 */
+	FLPAboutInfo = /** @lends sap.ui.fl.apply._internal.flexState.communication.FLPAboutInfo */{
+		async initialize() {
+			await waitForUshellLibraryIsLoadedAndReady();
+			await attachAppLoadedListener();
+		},
+		async onAppLoadedListener(oEvent, oAppLifeCycleService) {
+			const oCurrentApplication = oEvent.getParameters();
+			await setFlexAdaptationInfoInAppInfo(oAppLifeCycleService, oCurrentApplication);
+		}
+	};
+
+	return FLPAboutInfo;
+});

package/src/sap/ui/fl/apply/_internal/flexState/compVariants/CompVariantManagementState.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -20,7 +20,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.apply._internal.flexState.compVariants.CompVariantManagementState
 	 * @since 1.129
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @private
 	 * @ui5-restricted
 	 */

package/src/sap/ui/fl/apply/_internal/flexState/compVariants/CompVariantMerger.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -125,7 +125,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.apply._internal.flexState.compVariants.CompVariantMerger
 	 * @since 1.86
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl
 	 */
@@ -215,7 +215,7 @@ sap.ui.define([
 		 *
 		 * @function
 		 * @since 1.89
-		 * @version 1.131.1
+		 * @version 1.132.0
 		 * @private
 		 * @ui5-restricted sap.ui.fl
 		 *

package/src/sap/ui/fl/apply/_internal/flexState/compVariants/Utils.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/fl/apply/_internal/flexState/compVariants/prepareCompVariantsMap.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/fl/apply/_internal/flexState/controlVariants/Switcher.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -75,7 +75,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.apply._internal.flexState.controlVariants.Switcher
 	 * @since 1.74
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @private
 	 * @ui5-restricted
 	 */

package/src/sap/ui/fl/apply/_internal/flexState/controlVariants/VariantManagementState.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -34,7 +34,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.apply._internal.flexState.controlVariants.VariantManagementState
 	 * @since 1.74
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @private
 	 * @ui5-restricted
 	 */

package/src/sap/ui/fl/apply/_internal/preprocessors/ComponentLifecycleHooks.js

@@ -1,11 +1,12 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
 sap.ui.define([
 	"sap/base/Log",
+	"sap/ui/core/Component",
 	"sap/ui/core/Lib",
 	"sap/ui/fl/apply/_internal/changes/descriptor/Applier",
 	"sap/ui/fl/apply/_internal/changes/descriptor/ApplyStrategyFactory",
@@ -13,14 +14,17 @@ sap.ui.define([
 	"sap/ui/fl/apply/_internal/flexState/FlexState",
 	"sap/ui/fl/apply/_internal/flexState/ManifestUtils",
 	"sap/ui/fl/apply/api/ControlVariantApplyAPI",
+	"sap/ui/fl/initial/_internal/changeHandlers/ChangeHandlerRegistration",
 	"sap/ui/fl/variants/VariantModel",
 	"sap/ui/fl/FlexControllerFactory",
 	"sap/ui/fl/Layer",
 	"sap/ui/fl/Utils",
 	"sap/ui/model/json/JSONModel",
+	"sap/ui/model/odata/ODataUtils",
 	"sap/ui/performance/Measurement"
 ], function(
 	Log,
+	Component,
 	Lib,
 	AppDescriptorApplier,
 	ApplyStrategyFactory,
@@ -28,11 +32,13 @@ sap.ui.define([
 	FlexState,
 	ManifestUtils,
 	ControlVariantApplyAPI,
+	ChangeHandlerRegistration,
 	VariantModel,
 	FlexControllerFactory,
 	Layer,
 	Utils,
 	JSONModel,
+	ODataUtils,
 	Measurement
 ) {
 	"use strict";
@@ -230,5 +236,58 @@ sap.ui.define([
 		return onLoadComponent(...aArgs);
 	};
 
+	async function fetchModelChanges(oPropertyBag) {
+		// if there is the owner property, the model is part of a reuse component.
+		// but the changes must still be fetched for the app component
+		const oOwnerComponent = oPropertyBag.owner && Component.get(oPropertyBag.owner.id);
+
+		// the functionality still works without component Id, but the FlexState will be initialized again
+		// once the component Id is set. This will happen in the instanceCreated hook.
+		// This can only be improved once the generated component instance Id is available in the factory config
+		const sAppComponentId = oPropertyBag.owner?.id || oPropertyBag.factoryConfig.id || oPropertyBag.factoryConfig.settings?.id;
+
+		const oComponentData = oOwnerComponent?.getComponentData()
+			|| oPropertyBag.factoryConfig.componentData
+			|| oPropertyBag.factoryConfig.settings?.componentData;
+		const sReference = ManifestUtils.getFlexReference({
+			manifest: oOwnerComponent?.getManifest() || oPropertyBag.manifest,
+			componentData: oComponentData
+		});
+		await FlexState.initialize({
+			componentData: oComponentData,
+			asyncHints: oPropertyBag.owner?.config.asyncHints || oPropertyBag.factoryConfig.asyncHints,
+			componentId: sAppComponentId,
+			reference: sReference
+		});
+		const sServiceUrl = ODataUtils.removeOriginSegmentParameters(oPropertyBag.model.getServiceUrl());
+		const aRelevantAnnotationChanges = FlexState.getAnnotationChanges(sReference)
+		.filter((oAnnotationChange) => oAnnotationChange.getServiceUrl() === sServiceUrl);
+
+		const aReturn = [];
+		for (const oAnnotationChange of aRelevantAnnotationChanges) {
+			const oChangeHandler = await ChangeHandlerRegistration.getAnnotationChangeHandler({
+				changeType: oAnnotationChange.getChangeType()
+			});
+			aReturn.push(await oChangeHandler.applyChange(oAnnotationChange));
+		}
+		return aReturn;
+	}
+
+	/**
+	 * Sets a promise at the model instance which resolves with the necessary information for the model to change annotations.
+	 *
+	 * @param {object} oPropertyBag - Property bag
+	 * @param {object} oPropertyBag.model - Model instance
+	 * @param {string} oPropertyBag.modelId - Id of the model instance
+	 * @param {object} oPropertyBag.factoryConfig - Configuration of loaded component
+	 * @param {object} oPropertyBag.manifest - Manifest of the owner component
+	 * @param {object} [oPropertyBag.owner] - Only passed if the model is part of an embedded component
+	 * @param {string} [oPropertyBag.owner.id] - Id of the owner component
+	 * @param {object} [oPropertyBag.owner.config] - Configuration of the owner component
+	 */
+	ComponentLifecycleHooks.modelCreatedHook = function(oPropertyBag) {
+		oPropertyBag.model.setAnnotationChangePromise(fetchModelChanges(oPropertyBag));
+	};
+
 	return ComponentLifecycleHooks;
 });

package/src/sap/ui/fl/apply/_internal/preprocessors/ControllerExtension.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @class
 	 * @constructor
 	 * @author SAP SE
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @since 1.27.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl, sap.ui.core

package/src/sap/ui/fl/apply/_internal/preprocessors/RegistrationDelegator.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -11,9 +11,11 @@ sap.ui.define([
 	"sap/ui/core/ComponentHooks",
 	"sap/ui/core/ExtensionPoint",
 	"sap/ui/fl/apply/_internal/changes/descriptor/Preprocessor",
+	"sap/ui/fl/apply/_internal/flexState/communication/FLPAboutInfo",
 	"sap/ui/fl/apply/_internal/flexState/ManifestUtils",
 	"sap/ui/fl/apply/_internal/preprocessors/ComponentLifecycleHooks",
 	"sap/ui/fl/apply/api/DelegateMediatorAPI",
+	"sap/ui/fl/changeHandler/ChangeAnnotation",
 	"sap/ui/fl/initial/_internal/changeHandlers/ChangeHandlerRegistration",
 	"sap/ui/base/DesignTime",
 	// the lower 2 are set as a callback in the "register...Processors" which are not detected as dependencies from the preload-building
@@ -25,9 +27,11 @@ sap.ui.define([
 	ComponentHooks,
 	ExtensionPoint,
 	Preprocessor,
+	FLPAboutInfo,
 	ManifestUtils,
 	ComponentLifecycleHooks,
 	DelegateMediatorAPI,
+	ChangeAnnotation,
 	ChangeHandlerRegistration,
 	DesignTime
 ) {
@@ -40,12 +44,11 @@ sap.ui.define([
 	 * @class
 	 * @constructor
 	 * @author SAP SE
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @since 1.43.0
 	 * @private
 	 */
 	var RegistrationDelegator = {};
-
 	function registerChangesInComponent() {
 		ComponentHooks.onInstanceCreated.register(ComponentLifecycleHooks.instanceCreatedHook);
 	}
@@ -53,6 +56,14 @@ sap.ui.define([
 	function registerChangeHandlers() {
 		ChangeHandlerRegistration.registerPredefinedChangeHandlers();
 		ChangeHandlerRegistration.getChangeHandlersOfLoadedLibsAndRegisterOnNewLoadedLibs();
+		ChangeHandlerRegistration.registerAnnotationChangeHandler({
+			changeHandler: ChangeAnnotation,
+			isDefaultChangeHandler: true
+		});
+	}
+
+	function registerOnModelCreated() {
+		ComponentHooks.onModelCreated.register(ComponentLifecycleHooks.modelCreatedHook);
 	}
 
 	function registerLoadComponentEventHandler() {
@@ -102,6 +113,10 @@ sap.ui.define([
 		});
 	}
 
+	function registerFLPAboutInfo() {
+		FLPAboutInfo.initialize();
+	}
+
 	/**
 	 * Registers everything in one call
 	 *
@@ -116,6 +131,8 @@ sap.ui.define([
 		registerDescriptorChangeHandler();
 		registerExtensionPointProvider();
 		registerModelSpecificReadDelegates();
+		registerOnModelCreated();
+		registerFLPAboutInfo();
 	};
 
 	return RegistrationDelegator;

package/src/sap/ui/fl/apply/_internal/preprocessors/XmlPreprocessor.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -38,7 +38,7 @@ sap.ui.define([
 	 * @class
 	 * @constructor
 	 * @author SAP SE
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @since 1.27.0
 	 * @private
 	 */

package/src/sap/ui/fl/apply/api/AnnotationChangeHandlerAPI.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -21,29 +21,31 @@ sap.ui.define([
 	 */
 	const AnnotationChangeHandlerAPI = /** @lends sap.ui.fl.apply.api.AnnotationChangeHandlerAPI */{
 		/**
-		 * Registers a model-specific annotation change handler for a change type.
+		 * Registers an annotation change handler for a change type.
 		 * The change type is not control-specific, hence it must be unique to avoid conflicts.
 		 *
 		 * @param {object} mPropertyBag - Property bag
-		 * @param {string} mPropertyBag.modelType - Model type
 		 * @param {string} mPropertyBag.changeType - Change type for which the change handler should be registered
 		 * @param {string|object} mPropertyBag.changeHandler - Path to change handler or change handler object
 		 *
 		 * @private
 		 */
 		registerAnnotationChangeHandler(mPropertyBag) {
-			if (!mPropertyBag.modelType || !mPropertyBag.changeType || !mPropertyBag.changeHandler) {
-				throw new Error("'modelType', 'changeType' and 'changeHandler' properties are required for registration!");
+			if (!mPropertyBag.changeType || !mPropertyBag.changeHandler) {
+				throw new Error("'changeType' and 'changeHandler' properties are required for registration!");
+			}
+
+			if (mPropertyBag.isDefaultChangeHandler) {
+				throw new Error("The API is not allowed to register default change handlers!");
 			}
 
 			ChangeHandlerRegistration.registerAnnotationChangeHandler(mPropertyBag);
 		},
 
 		/**
-		 * Returns the model-specific annotation change handler for the requested change type.
+		 * Returns the annotation change handler for the requested change type.
 		 *
 		 * @param {object} mPropertyBag - Property bag
-		 * @param {string} mPropertyBag.modelType - Model type
 		 * @param {string} mPropertyBag.changeType - Change type for which the change handler should be returned
 		 * @returns {Promise<object>} Resolves with the change handler
 		 *
@@ -51,8 +53,8 @@ sap.ui.define([
 		 * @ui5-restricted sap.ui.fl, sap.ui.rta
 		 */
 		getAnnotationChangeHandler(mPropertyBag) {
-			if (!mPropertyBag.modelType || !mPropertyBag.changeType) {
-				throw new Error("'modelType' and 'changeType' properties are required!");
+			if (!mPropertyBag.changeType) {
+				throw new Error("'changeType' property is required!");
 			}
 
 			return ChangeHandlerRegistration.getAnnotationChangeHandler(mPropertyBag);

package/src/sap/ui/fl/apply/api/ControlVariantApplyAPI.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/fl/apply/api/DelegateMediatorAPI.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/fl/apply/api/ExtensionPointRegistryAPI.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/fl/apply/api/FlexRuntimeInfoAPI.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -201,6 +201,28 @@ sap.ui.define([
 			return FlexInfoSession.getByReference(mPropertyBag.reference)?.version;
 		},
 
+		/**
+		 * Returns the context-based adaptation ID for the given property bag.
+		 *
+		 * @param {object} mPropertyBag - Object with parameters as properties
+		 * @param {string} mPropertyBag.reference - Reference of the application
+		 * @returns {string|undefined} The adaptation ID if found, otherwise undefined.
+		 */
+		getContextBasedAdaptationId(mPropertyBag) {
+			return FlexInfoSession.getByReference(mPropertyBag.reference)?.adaptationId;
+		},
+
+		/**
+		 * Returns the title of the context-based adaptation for a given reference.
+		 *
+		 * @param {object} mPropertyBag - Object with parameters as properties
+		 * @param {string} mPropertyBag.reference - Reference of the application
+		 * @returns {string|undefined} The title of the context-based adaptation, or undefined if not found.
+		 */
+		getContextBasedAdaptationTitle(mPropertyBag) {
+			return FlexInfoSession.getByReference(mPropertyBag.reference)?.adaptationTitle;
+		},
+
 		/**
 		 * Returns the information needed for the rta feedback dialog
 		 *

package/src/sap/ui/fl/apply/api/SmartVariantManagementApplyAPI.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/fl/apply/api/UI2PersonalizationApplyAPI.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/fl/changeHandler/AddIFrame.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -22,7 +22,7 @@ sap.ui.define([
 	 *
 	 * @alias sap.ui.fl.changeHandler.AddIFrame
 	 * @author SAP SE
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @since 1.72
 	 * @private
 	 */

package/src/sap/ui/fl/changeHandler/AddXML.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -16,7 +16,7 @@ sap.ui.define([
 	 *
 	 * @alias sap.ui.fl.changeHandler.AddXML
 	 * @author SAP SE
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @since 1.54
 	 * @private
 	 */

package/src/sap/ui/fl/changeHandler/AddXMLAtExtensionPoint.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -18,7 +18,7 @@ sap.ui.define([
 	 *
 	 * @alias sap.ui.fl.changeHandler.AddXMLAtExtensionPoint
 	 * @author SAP SE
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @since 1.75
 	 * @private
 	 */

package/src/sap/ui/fl/changeHandler/Base.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2025 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -14,7 +14,7 @@ sap.ui.define([
 	/**
 	 * Base functionality for all change handlers, which provides some reuse methods
 	 * @namespace sap.ui.fl.changeHandler.Base
-	 * @version 1.131.1
+	 * @version 1.132.0
 	 * @private
 	 * @ui5-restricted change handlers
 	 */