@openui5/sap.ui.testrecorder 1.145.1 → 1.147.0

package/REUSE.toml

@@ -613,57 +613,6 @@ SPDX-License-Identifier = "MIT"
 SPDX-FileComment = "these files belong to: hammer.js"
 
 
-# Library: sap.ui.webc.common:
-
-[[annotations]]
-path = [
-    "src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/base/**",
-    "src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/theming/**",
-    "src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/localization/**",
-    "src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons/**",
-    "src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons-tnt/**",
-    "src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons-business-suite/**"
-]
-precedence = "aggregate"
-SPDX-FileCopyrightText = "SAP"
-SPDX-License-Identifier = "Apache-2.0"
-SPDX-FileComment = "these files belong to: UI5 Web Components"
-
-[[annotations]]
-path = "src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/lit-html/**"
-precedence = "aggregate"
-SPDX-FileCopyrightText = "Google LLC"
-SPDX-License-Identifier = "BSD-3-Clause"
-SPDX-FileComment = "these files belong to: lit-html"
-
-
-# Library: sap.ui.webc.fiori:
-
-[[annotations]]
-path = "src/sap.ui.webc.fiori/src/sap/ui/webc/fiori/thirdparty/**"
-precedence = "aggregate"
-SPDX-FileCopyrightText = "SAP"
-SPDX-License-Identifier = "Apache-2.0"
-SPDX-FileComment = "these files belong to: UI5 Web Components"
-
-[[annotations]]
-path = "src/sap.ui.webc.fiori/src/sap/ui/webc/fiori/lib/zxing.js"
-precedence = "aggregate"
-SPDX-FileCopyrightText = "2005 Sun Microsystems, Inc.; 2010-2014 University of Manchester; 2010-2015 Stian Soiland-Reyes; 2015 Peter Hull"
-SPDX-License-Identifier = "Apache-2.0"
-SPDX-FileComment = "these files belong to: ZXing"
-
-
-# Library: sap.ui.webc.main:
-
-[[annotations]]
-path = "src/sap.ui.webc.main/src/sap/ui/webc/main/thirdparty/**"
-precedence = "aggregate"
-SPDX-FileCopyrightText = "SAP"
-SPDX-License-Identifier = "Apache-2.0"
-SPDX-FileComment = "these files belong to: UI5 Web Components"
-
-
 # Outside of Libraries:
 
 [[annotations]]

package/THIRDPARTY.txt

@@ -6,31 +6,31 @@ The full text of all referenced licenses is appended at the end of this file.
 
 Library: sap.f:
 
-Component: UI5 Web Components, version: 2.15.0
+Component: UI5 Web Components, version: 2.19.2
 Copyright: SAP
 License: Apache-2.0
 License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
 Contained in: src/sap.f/src/sap/f/thirdparty/**
 
-Component: UI5 Web Components Fiori, version: 2.15.0
+Component: UI5 Web Components Fiori, version: 2.19.2
 Copyright: SAP
 License: Apache-2.0
 License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
 Contained in: src/sap.f/src/sap/f/thirdparty/**
 
-Component: UI5 Web Components Icons, version: 2.15.0
+Component: UI5 Web Components Icons, version: 2.19.2
 Copyright: SAP
 License: Apache-2.0
 License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
 Contained in: src/sap.f/src/sap/f/thirdparty/**
 
-Component: UI5 Web Components Icons Business Suite, version: 2.15.0
+Component: UI5 Web Components Icons Business Suite, version: 2.19.2
 Copyright: SAP
 License: Apache-2.0
 License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
 Contained in: src/sap.f/src/sap/f/thirdparty/**
 
-Component: UI5 Web Components Icons TNT, version: 2.15.0
+Component: UI5 Web Components Icons TNT, version: 2.19.2
 Copyright: SAP
 License: Apache-2.0
 License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
@@ -446,50 +446,6 @@ License Text: https://github.com/UI5/openui5/blob/master/LICENSES/MIT.txt
 Contained in: src/sap.ui.mdc/test/sap/ui/mdc/demokit/sample/Chart/ChartJS/control/hammerjs.js
 
 
-Library: sap.ui.webc.common:
-
-Component: UI5 Web Components, version: 1.18.0
-Copyright: SAP
-License: Apache-2.0
-License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
-Contained in: src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/base/**
-	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/theming/**
-	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/localization/**
-	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons/**
-	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons-tnt/**
-	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons-business-suite/**
-
-Component: lit-html, version: 2.2.2
-Copyright: Google LLC
-License: BSD-3-Clause
-License Text: https://github.com/UI5/openui5/blob/master/LICENSES/BSD-3-Clause.txt
-Contained in: src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/lit-html/**
-
-
-Library: sap.ui.webc.fiori:
-
-Component: UI5 Web Components, version: 1.18.0
-Copyright: SAP
-License: Apache-2.0
-License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
-Contained in: src/sap.ui.webc.fiori/src/sap/ui/webc/fiori/thirdparty/**
-
-Component: ZXing, version: 0.17.1
-Copyright: 2005 Sun Microsystems, Inc.; 2010-2014 University of Manchester; 2010-2015 Stian Soiland-Reyes; 2015 Peter Hull
-License: Apache-2.0
-License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
-Contained in: src/sap.ui.webc.fiori/src/sap/ui/webc/fiori/lib/zxing.js
-
-
-Library: sap.ui.webc.main:
-
-Component: UI5 Web Components, version: 1.18.0
-Copyright: SAP
-License: Apache-2.0
-License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
-Contained in: src/sap.ui.webc.main/src/sap/ui/webc/main/thirdparty/**
-
-
 Outside of Libraries:
 
 Component: JSDoc 3, version: 3.6.7
@@ -498,7 +454,7 @@ License: Apache-2.0
 License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt
 Contained in: lib/jsdoc/ui5/plugin.js
 
-Component: SAP Theming Base Content, version: 11.32.2-20250827135846+79bb30d311678435d61b21db26ecbe07d6b05079
+Component: SAP Theming Base Content, version: 11.34.0
 Copyright: SAP SE or an SAP affiliate company and Theming Base Content contributors
 License: Apache-2.0
 License Text: https://github.com/UI5/openui5/blob/master/LICENSES/Apache-2.0.txt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/sap.ui.testrecorder",
-  "version": "1.145.1",
+  "version": "1.147.0",
   "description": "OpenUI5 UI Library sap.ui.testrecorder",
   "author": "SAP SE (https://www.sap.com)",
   "license": "Apache-2.0",
@@ -14,10 +14,10 @@
     "url": "https://github.com/UI5/openui5.git"
   },
   "dependencies": {
-    "@openui5/sap.m": "1.145.1",
-    "@openui5/sap.ui.codeeditor": "1.145.1",
-    "@openui5/sap.ui.core": "1.145.1",
-    "@openui5/sap.ui.layout": "1.145.1",
-    "@openui5/sap.ui.support": "1.145.1"
+    "@openui5/sap.m": "1.147.0",
+    "@openui5/sap.ui.codeeditor": "1.147.0",
+    "@openui5/sap.ui.core": "1.147.0",
+    "@openui5/sap.ui.layout": "1.147.0",
+    "@openui5/sap.ui.support": "1.147.0"
   }
 }

package/src/sap/ui/testrecorder/.library

@@ -6,7 +6,7 @@
 	<copyright>OpenUI5
  * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-	<version>1.145.1</version>
+	<version>1.147.0</version>
 
 	<documentation>UI5 library: sap.ui.testrecorder</documentation>
 

package/src/sap/ui/testrecorder/ControlTree.js

@@ -0,0 +1,303 @@
+/*!
+* OpenUI5
+ * (c) Copyright 2026 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/base/ManagedObject",
+	"sap/ui/core/Element",
+	"sap/base/util/merge",
+	"sap/ui/test/Opa5",
+	"sap/ui/test/RecordReplay",
+	"sap/ui/test/actions/Press",
+	"sap/ui/test/actions/EnterText",
+	"sap/ui/testrecorder/inspector/ControlAPI",
+	"sap/ui/testrecorder/inspector/ControlInspector",
+	"sap/ui/testrecorder/utils/filterControlTree",
+	"sap/ui/testrecorder/utils/convertTreeToMarkdown"
+], function (Log, ManagedObject, Element, merge, Opa5, RecordReplay, Press, EnterText, ControlAPI, ControlInspector, filterControlTree, convertTreeToMarkdown) {
+	"use strict";
+
+	var oControlTree = null;
+
+	var NODE_ID_REGEX = /^(\d+)_(\d+)$/;
+
+	const TREE_CONFIG = {
+		filter: {
+			includeAncestors: true,
+			includeDescendants: true,
+			includeInvisibleText: false
+		},
+		nodeData: {
+			includeAssignedProperties: true,
+			includeAssignedAssociations: true,
+			includeTooltipText: true
+		},
+		output: {
+			verbose: false
+		}
+	};
+
+	/**
+	 * @class A singleton that provides methods to interact with the UI5 control tree, such as searching for controls, performing actions, and retrieving control information.
+	 * @extends sap.ui.base.ManagedObject
+	 * @alias sap.ui.testrecorder.ControlTree
+	 * @private
+	 * @since 1.147
+	 */
+	var ControlTree = ManagedObject.extend("sap.ui.testrecorder.ControlTree", {
+		constructor: function () {
+			if (!oControlTree) {
+				ManagedObject.apply(this, arguments);
+				this._oNodeIdToControlIdMap = {};
+				this._iSnapshotsCount = 0;
+				this._iNodesCount = 0;  // count of nodes in last snapshot
+				ControlInspector.updateSettings({
+					preferViewId: true, // prefer view-relative control id over global control id
+					preferViewNameAsViewLocator: true,
+					separateViewNamespace: true,
+					preferChainableSnippets: true
+				});
+			} else {
+				Log.warning("Only one ControlTree allowed");
+				return oControlTree;
+			}
+		}
+	});
+
+	/**
+	 * @typedef {sap.ui.core.support.ToolsAPI.ControlTreeNode} sap.ui.testrecorder.ControlTreeNode
+	 * @description Extends {@link sap.ui.core.support.ToolsAPI.ControlTreeNode} with snapshot-relative identifier
+	 * for API consumers to retrieve detailed control information.
+	 * @property {string} [nodeId] - Snapshot-relative identifier (format: "snapshotNumber_nodeNumber").
+	 *   Can be passed to getControlData() to identify the control.
+	 * @private
+	 * @since 1.147
+	 */
+
+	/**
+	 * Search for controls matching the provided query
+	 * @param {string} sQuery The search query string
+	 * @returns {Promise<String>} A promise that resolves with the matched subtree formatted as a markdown string
+	 * @private
+	 * @since 1.147
+	 */
+	ControlTree.prototype.search = function (sQuery) {
+		var aTree = ControlAPI.getAllControlData(TREE_CONFIG.nodeData).renderedControls;
+
+		var oFilterOptions = merge({ query: sQuery }, TREE_CONFIG.filter);
+		var aFilteredTree = filterControlTree(aTree, oFilterOptions);
+
+		// assign nodeIds to survivors
+		this._assignNodeIdsToTree(aFilteredTree);
+
+		// to output format
+		return Promise.resolve(convertTreeToMarkdown(aFilteredTree, {
+			verbose: TREE_CONFIG.output.verbose
+		}));
+	};
+
+	/**
+	 * Obtains detailed information about a control identified by the given node ID, including a selector snippet and customized control data
+	 * @param {string} sNodeId
+	 * @returns {Promise<object>} A promise that resolves with an object containing the control information
+	 * @private
+	 * @since 1.147
+	 */
+	ControlTree.prototype.getControlData = function (sId) {
+		var sControlId = this._getControlId(sId),
+			sControlType = this._getControlType(sControlId),
+			oControlData = ControlAPI.getControlData({
+				controlId: sControlId,
+				includeAggregations: true,
+				includeAssociations: true
+			}),
+			oPrunedData = this._pruneControlData(oControlData, {
+				inheritedFrom: false,
+				type: false,
+				bindings: false
+			});
+
+		return ControlInspector._getCodeSnippet({ domElementId: sControlId })
+			.then(function (sSnippet) {
+				return Object.assign({
+					controlId: sControlId,
+					controlType: sControlType,
+					selectorSnippet: sSnippet
+				}, oPrunedData);
+			});
+	};
+
+	/**
+	 * Presses a control identified by the given node ID and returns the corresponding test action snippet
+	 * @param {string} sNodeId The ID of the control to press
+	 * @param {object} oSettings optional settings for the press action
+	 * @param {boolean} [oSettings.altKey=false] Press with Alt key modifier
+	 * @param {boolean} [oSettings.ctrlKey=false] Press with Ctrl key modifier
+	 * @param {boolean} [oSettings.shiftKey=false] Press with Shift key modifier
+	 * @param {float} [oSettings.xPercentage=0] Press with X coordinate (0-100% of control width)
+	 * @param {float} [oSettings.yPercentage=0] Press with Y coordinate (0-100% of control height)
+	 * @param {boolean} [oSettings.keyDown=false] Dispatch a <code>keydown</code> keyboard event instead of mouse events; modifier keys (shiftKey, altKey, ctrlKey) are applied if set
+	 * @param {boolean} [oSettings.keyUp=false] Dispatch a <code>keyup</code> keyboard event instead of mouse events; modifier keys (shiftKey, altKey, ctrlKey) are applied if set
+	 * @param {boolean} [oSettings.rightClick=false] Trigger a right-click (context menu) event instead of a left-click, dispatching <code>mousedown</code> and <code>mouseup</code> with button 2 followed by a <code>contextmenu</code> event
+	 * @returns {Promise<string>} The generated test action snippet for the press action
+	 * @private
+	 * @since 1.147
+	 */
+	ControlTree.prototype.press = function (sNodeId, oSettings) {
+		var sActionSnippet, sControlId = this._getControlId(sNodeId);
+
+		return ControlInspector._getCodeSnippet({ domElementId: sControlId, action: "PRESS", actionSettings: oSettings })
+			.then(function (snippet) {
+				sActionSnippet = snippet;
+				return this._executeAction(sControlId, Press, oSettings);
+			}.bind(this)).then(function () {
+				return sActionSnippet;
+			});
+	};
+
+	/**
+	 * Enters text into a control identified by the given node ID and returns the corresponding test action snippet
+	 * @param {string} sNodeId
+	 * @param {object} oSettings settings for entering text
+	 * @param {string} oSettings.text the text to enter (required)
+	 * @param {boolean} oSettings.submitText whether to submit the text after entering (optional, default: false)
+	 * @param {boolean} oSettings.clearTextFirst whether to clear existing text before entering new text (optional, default: false)
+	 * @returns {Promise<string>} A promise that resolves with the corresponding test action snippet
+	 * @private
+	 * @since 1.147
+	 */
+	ControlTree.prototype.enterText = function (sNodeId, oSettings) {
+		var sActionSnippet, sControlId = this._getControlId(sNodeId);
+
+		this._adaptEnterTextSettings(oSettings);
+
+		return ControlInspector._getCodeSnippet({ domElementId: sControlId, action: "ENTER_TEXT", actionSettings: oSettings })
+			.then(function (snippet) {
+				sActionSnippet = snippet;
+				return this._executeAction(sControlId, EnterText, oSettings);
+			}.bind(this)).then(function () {
+				return sActionSnippet;
+			});
+	};
+
+	ControlTree.prototype._executeAction = function (sControlId, ActionClass, oSettings) {
+		return ControlInspector.getSelector({ domElementId: sControlId })
+			.then(function (oSelector) {
+				oSettings = this._refineActionSettings(oSelector, oSettings);
+				oSelector.actions = new ActionClass(oSettings);
+
+				var oPromise = new Opa5().waitFor(oSelector); // enqueue
+				Opa5.emptyQueue(); // trigger execution of enqueued `waitFor`s
+				return oPromise.then(function () {
+					return RecordReplay.waitForUI5();
+				});
+			}.bind(this));
+	};
+
+	ControlTree.prototype._refineActionSettings = function (oSelector, oSettings) {
+		oSettings = oSettings || {};
+		var sIdSuffix = oSelector.interaction?.idSuffix;
+		if (sIdSuffix) {
+			oSettings.idSuffix = sIdSuffix;
+		}
+		return oSettings;
+	};
+
+	/**
+	 * Walk the filtered tree and assign nodeIds to all control nodes.
+	 * @param {Array<sap.ui.testrecorder.ControlTreeNode>} aNodes - Array of filtered tree nodes
+	 * @private
+	 */
+	ControlTree.prototype._assignNodeIdsToTree = function (aNodes) {
+		this._iSnapshotsCount++;
+		this._iNodesCount = 0;
+
+		var assignRecursive = function (aInnerNodes) {
+			for (var i = 0; i < aInnerNodes.length; i++) {
+				this._assignNodeId(aInnerNodes[i]);
+				if (aInnerNodes[i].content && aInnerNodes[i].content.length) {
+					assignRecursive(aInnerNodes[i].content);
+				}
+			}
+		}.bind(this);
+
+		assignRecursive(aNodes);
+	};
+
+	/**
+	 * Assign a unique nodeId to a control node.
+	 * Stores the mapping between nodeId and control ID for later retrieval.
+	 * @param {sap.ui.testrecorder.ControlTreeNode} oNode - Node to enhance (mutated)
+	 * @private
+	 */
+	ControlTree.prototype._assignNodeId = function (oNode) {
+		if (oNode.type === 'sap-ui-control') {
+			var sNodeId = this._iSnapshotsCount + "_" + (++this._iNodesCount);
+			oNode.nodeId = sNodeId;
+			this._oNodeIdToControlIdMap[sNodeId] = oNode.id;
+		}
+	};
+
+	/**
+	 * Retrieve original control id for a previously assigned nodeId or return the raw controlId as-is.
+	 * @param {string} sId - nodeId (format: "snapshotNumber_nodeNumber") or raw controlId
+	 * @returns {string|null} original control id or null when not found
+	 */
+	ControlTree.prototype._getControlId = function (sId) {
+		if (typeof sId !== "string") {
+			return null;
+		}
+
+		return NODE_ID_REGEX.test(sId) ? (this._oNodeIdToControlIdMap[sId] || null) : sId;
+	};
+
+	/**
+	 * Retrieve control type name for either a nodeId or a raw controlId.
+	 * When given a nodeId, resolves it to a controlId via the map first.
+	 * @param {string} sControlId - control id
+	 * @returns {string|null} control type name or null when not found
+	 */
+	ControlTree.prototype._getControlType = function (sControlId) {
+		var oControl = Element.getElementById(sControlId);
+		return oControl ? oControl.getMetadata().getName() : null;
+	};
+
+	ControlTree.prototype._pruneControlData = function (oControlData, oOptions) {
+		var fnPrune = function (oProperty) {
+			if (oOptions.inheritedFrom === false) {
+				delete oProperty.inheritedFrom;
+			}
+			if (oOptions.type === false) {
+				delete oProperty.type;
+			}
+		};
+
+		if (oOptions.bindings === false) {
+			delete oControlData.bindings;
+		}
+
+		oControlData.properties?.own.forEach(fnPrune);
+		oControlData.properties?.inherited.forEach(fnPrune);
+		oControlData.aggregations?.own.forEach(fnPrune);
+		oControlData.aggregations?.inherited.forEach(fnPrune);
+		oControlData.associations?.own.forEach(fnPrune);
+		oControlData.associations?.inherited.forEach(fnPrune);
+
+		return oControlData;
+	};
+
+	// adapt the more AI-friendly property name to the underlying legacy property name
+	ControlTree.prototype._adaptEnterTextSettings = function (oSettings) {
+		if (oSettings.submitText === false) { // adapt to underlying API
+			oSettings.keepFocus = true;
+		}
+		delete oSettings.submitText;
+	};
+
+	oControlTree = new ControlTree();
+
+	return oControlTree;
+
+}, true);

package/src/sap/ui/testrecorder/codeSnippets/CodeSnippetProvider.js

@@ -36,6 +36,7 @@ sap.ui.define([
 	 * @param {object} mData data from which to generate a snippet
 	 * @param {object} mData.controlSelector control selector in string format
 	 * @param {string} mData.action name of the action to record for the control
+	 * @param {string} mData.actionSettings settings for the action constructor
 	 * @returns {Promise<string>} Promise for a code snippet or error
 	 */
 	ControlSnippetProvider.prototype.getSnippet = function (mData) {

package/src/sap/ui/testrecorder/codeSnippets/ControlSnippetGenerator.js

@@ -21,6 +21,7 @@ sap.ui.define([
 	 * @param {object} mData data from which to generate a snippet
 	 * @param {object} mData.controlSelector control selector in string format
 	 * @param {string} mData.action name of the action to record for the control
+	 * @param {string} mData.actionSettings settings for the action constructor
 	 * @param {object} mData.assertion assertion details - property name, type and expected value
 	 * @param {object} mData.settings preferences for the snippet e.g. formatting, method wrapping
 	 * @param {boolean} mData.settings.formatAsPOMethod true if selectors should be wrapped in a page object method. Default value is true.

package/src/sap/ui/testrecorder/codeSnippets/OPA5ControlSnippetGenerator.js

@@ -20,12 +20,17 @@ sap.ui.define([
 	 * @param {object} mData data from which to generate a snippet
 	 * @param {object} mData.controlSelector control selector in string format
 	 * @param {string} mData.action name of the action to record for the control
+	 * @param {object} mData.actionSettings options for the action contructor
 	 * @param {object} mData.assertion assertion details - property name, type and expected value
 	 * @returns {string} a stringified code snippet
 	 */
 	OPA5ControlSnippetGenerator.prototype._generate = function (mData) {
 		var sIdSuffix = mData.controlSelector.interaction && mData.controlSelector.interaction.idSuffix;
-		var sAction = this._getActionAsString(mData.action, sIdSuffix);
+		var oActionSettings = mData.actionSettings || {};
+		if (sIdSuffix) {
+			oActionSettings.idSuffix = sIdSuffix;
+		}
+		var sAction = this._getActionAsString(mData.action, oActionSettings);
 		var sAssertion = this._getAssertionAsString(mData.assertion);
 
 		if (sAction) {
@@ -41,20 +46,28 @@ sap.ui.define([
 		var sBasicSelector = this._getSelectorAsString(mData.controlSelector);
 		var sSelectorWithAction = this._getSelectorWithAction(sBasicSelector, sAction);
 		var sFullSelector = this._getSelectorWithAssertion(sSelectorWithAction, sAssertion);
-		return "this.waitFor(" + sFullSelector + ");";
+		var sReturnPrefix = mData.settings && mData.settings.preferChainableSnippets ? "return " : "";
+		return sReturnPrefix + "this.waitFor(" + sFullSelector + ");";
 	};
 
-	OPA5ControlSnippetGenerator.prototype._getActionAsString = function (sAction, sIdSuffix) {
-		sIdSuffix = sIdSuffix ? 'idSuffix: "' + sIdSuffix + '"' : "";
-		var sParams;
+	/**
+	 * @param {string} sAction name of the action to record for the control
+	 * @param {object} oSettings settings for the action constructor
+	 * @returns {string} a stringified code snippet for the action
+	 */
+	OPA5ControlSnippetGenerator.prototype._getActionAsString = function (sAction, oSettings) {
+		oSettings = oSettings || {};
+
 		switch (sAction) {
 			case Commands.PRESS:
-				sParams = sIdSuffix && "{\n" + this._getIndentation(3) + sIdSuffix + "\n" + this._getIndentation(2) + "}";
-				return "new Press(" + sParams + ")";
+				return "new Press(" + this._getSettingsAsString(oSettings, 2) + ")";
+
 			case Commands.ENTER_TEXT:
-				sParams = "{\n" + this._getIndentation(2) + (sIdSuffix && sIdSuffix + ",\n" + this._getIndentation(2)) +
-					'text: "test"' + "\n" + this._getIndentation(1) + "}";
-				return "new EnterText(" + sParams + ")";
+				if (oSettings.text === undefined) {
+					oSettings.text = "test";
+				}
+				return "new EnterText(" + this._getSettingsAsString(oSettings, 2) + ")";
+
 			default: return "";
 		}
 	};
@@ -75,6 +88,17 @@ sap.ui.define([
 		}
 	};
 
+	OPA5ControlSnippetGenerator.prototype._getSettingsAsString = function (oSettings, iIndentationLevel) {
+		if (!oSettings || Object.keys(oSettings).length === 0) {
+			return "";
+		}
+		return "{\n" + this._getIndentation(iIndentationLevel) +
+			Object.keys(oSettings).map(function(sKey) {
+				return sKey + ': "' + oSettings[sKey] + '"';
+			}).join(",\n" + this._getIndentation(iIndentationLevel + 1)) +
+			"\n" + this._getIndentation(iIndentationLevel - 1) + "}";
+	};
+
 	OPA5ControlSnippetGenerator.prototype._getSelectorWithAction = function (sSelector, sAction) {
 		return sSelector.replace("actions: []", "actions: " + sAction);
 	};

package/src/sap/ui/testrecorder/inspector/ControlAPI.js

@@ -25,13 +25,22 @@ sap.ui.define([
 		};
 	};
 
-	ControlAPI.prototype.getAllControlData = function () {
-		var renderedControls = ToolsAPI.getRenderedControlTree();
+	ControlAPI.prototype.getAllControlData = function (oOptions) {
+		var renderedControls = ToolsAPI.getRenderedControlTree(oOptions);
 		return {
 			renderedControls: renderedControls
 		};
 	};
 
+	/**
+	 * Retrieves detailed information about a control based on the provided data.
+	 * @param {object} mData The data containing control identification information
+	 * @param {object} mData.controlId The ID of the control (optional)
+	 * @param {object} mData.domElementId The ID of the DOM element associated with the control (optional)
+	 * @param {object} mData.includeAggregations Whether to include aggregations in the control data (optional, default: false)
+	 * @param {object} mData.includeAssociations Whether to include associations in the control data (optional, default: false)
+	 * @returns {object} An object containing the control's properties and bindings
+	 */
 	ControlAPI.prototype.getControlData = function (mData) {
 		var sControlId;
 		if (mData.controlId) {
@@ -50,10 +59,18 @@ sap.ui.define([
 		var aProperties = this._getFormattedProperties(sControlId);
 		var aBindings = this._getFormattedBindings(sControlId);
 
-		return {
+		var oData = {
 			properties: aProperties,
 			bindings: aBindings
 		};
+
+		if (mData.includeAggregations) {
+			oData.aggregations = this._getFormattedAggregations(sControlId);
+		}
+		if (mData.includeAssociations) {
+			oData.associations = this._getFormattedAssociations(sControlId);
+		}
+		return oData;
 	};
 
 	ControlAPI.prototype._getFormattedProperties = function (sControlId) {
@@ -113,6 +130,56 @@ sap.ui.define([
 		return aFormattedBindings;
 	};
 
+	ControlAPI.prototype._getFormattedAggregations = function (sControlId) {
+		var oAllAggregations = ToolsAPI.getControlAggregations(sControlId);
+		oAllAggregations.own = [oAllAggregations.own];
+		var mFormattedAggregations = {};
+		["own", "inherited"].forEach(function (sType) {
+			mFormattedAggregations[sType] = [];
+			oAllAggregations[sType].forEach(function (mAggregationsContainer) {
+				Object.keys(mAggregationsContainer.aggregations).forEach(function (sAggregation) {
+					var mAggregation = mAggregationsContainer.aggregations[sAggregation];
+					mFormattedAggregations[sType].push({
+						inheritedFrom: mAggregationsContainer.meta.controlName,
+						aggregation: sAggregation,
+						type: mAggregation.type,
+						count: mAggregation.count
+					});
+				});
+			});
+		});
+
+		return mFormattedAggregations;
+	};
+
+	ControlAPI.prototype._getFormattedAssociations = function (sControlId) {
+		var oAllAssociations = ToolsAPI.getControlAssociations(sControlId);
+		oAllAssociations.own = [oAllAssociations.own];
+		var mFormattedAssociations = {};
+		["own", "inherited"].forEach(function (sType) {
+			mFormattedAssociations[sType] = [];
+			oAllAssociations[sType].forEach(function (mAssociationsContainer) {
+				Object.keys(mAssociationsContainer.associations).forEach(function (sAssociation) {
+					var mAssociation = mAssociationsContainer.associations[sAssociation];
+					var vValue = isManagedObject(mAssociation.value) ? mAssociation.value.getId() : mAssociation.value;
+					mFormattedAssociations[sType].push({
+						inheritedFrom: mAssociationsContainer.meta.controlName,
+						association: sAssociation,
+						type: mAssociation.type,
+						value: vValue
+					});
+				});
+			});
+		});
+
+		return mFormattedAssociations;
+	};
+
+	// utils
+	function isManagedObject(oValue) {
+		return oValue && typeof oValue === "object" && typeof oValue.isA === "function" && oValue.isA("sap.ui.base.ManagedObject");
+	}
+
 	return new ControlAPI();
 
 }, true);

package/src/sap/ui/testrecorder/inspector/ControlInspector.js

@@ -66,13 +66,19 @@ sap.ui.define([
 	/**
 	 * send an event to the test recorder frame that has as payload:
 	 * the most basic data about the app - framework name + version and control IDs
+	 * @param {Object} [oOptions] - Optional settings for enriching tree nodes.
+	 * @param {boolean} [oOptions.includeAssignedProperties] - Whether to include assigned properties in each node.
+	 * @param {boolean} [oOptions.includeAssignedAssociations] - Whether to include assigned associations in each node.
+	 * @param {boolean} [oOptions.includeTooltipText] - Whether to include tooltip text in each node.
 	 */
-	ControlInspector.prototype.getAllControlData = function () {
+	ControlInspector.prototype.getAllControlData = function (oOptions) {
+		var oRenderedControls = ControlAPI.getAllControlData(oOptions).renderedControls;
 		CommunicationBus.publish(CommunicationChannels.RECEIVE_ALL_CONTROLS_DATA, {
-			renderedControls: ControlAPI.getAllControlData().renderedControls,
+			renderedControls: oRenderedControls,
 			framework: ControlAPI.getFrameworkData().framework
 		});
 		ControlInspectorRepo.clear();
+		return oRenderedControls;
 	};
 
 	/**
@@ -81,6 +87,8 @@ sap.ui.define([
 	 * @param {object} mData control identifier
 	 * @param {string} mData.controlId ID of the control to inspect
 	 * @param {string} mData.domElementId ID of a dom element from which the control is found (e.g. dom ref)
+	 * @param {object} mData.includeAggregations Whether to include aggregations in the control data (optional, default: false)
+	 * @param {object} mData.includeAssociations Whether to include associations in the control data (optional, default: false)
 	 */
 	ControlInspector.prototype.getControlData = function (mData) {
 		var oDomElement = mData.domElementId ? document.getElementById(mData.domElementId) : Element.getElementById(mData.controlId).getDomRef();
@@ -89,31 +97,29 @@ sap.ui.define([
 
 		var mControlData = ControlAPI.getControlData(mData);
 		CommunicationBus.publish(CommunicationChannels.RECEIVE_CONTROL_DATA, mControlData);
+		return mControlData;
 	};
 
 	/**
-	 * send an event to the test recorder frame that has as payload:
-	 * a generated code snippet for locating controls
+	 * generate a code snippet for locating controls, without publishing to the communication bus.
 	 * @param {object} mData object containing control identifiers and actions
 	 * @param {string} mData.domElementId ID of a dom element from which the control is found (e.g. dom ref)
 	 * @param {string} mData.action name of an action to record in the snippet (e.g. press, enter text)
+	 * @param {string} mData.actionSettings settings for the action contructor
 	 * @param {object} mData.assertion assertion details - property name, type and expected value
+	 * @returns {Promise<string>} resolves with the generated code snippet
 	 */
-	ControlInspector.prototype.getCodeSnippet = function (mData) {
-		var mDataForGenerator = Object.assign({}, mData, {
-			settings: mSelectorSettings
-		});
-		// find a cached selector or generate a new one
-		var mControlSelector = ControlInspectorRepo.findSelector(mData.domElementId);
-		var oSelectorPromise = mControlSelector ? Promise.resolve(mControlSelector) : ControlSelectorGenerator.getSelector(mDataForGenerator);
+	ControlInspector.prototype._getCodeSnippet = function (mData) {
+		var mControlSelector;
 
-		return oSelectorPromise.then(function (mSelector) {
+		return this.getSelector(mData).then(function (mSelector) {
 			mControlSelector = mSelector;
 			// given the selector, generate a dialect-specific code snippet
 			return CodeSnippetProvider.getSnippet({
 				controlSelector: mSelector,
-				action: mDataForGenerator.action,
-				assertion: mDataForGenerator.assertion,
+				action: mData.action,
+				actionSettings: mData.actionSettings,
+				assertion: mData.assertion,
 				settings: mSelectorSettings
 			});
 		}).then(function (sSnippet) {
@@ -131,7 +137,20 @@ sap.ui.define([
 					assertion: mData.assertion
 				}, mSelectorSettings), DialectRegistry.getActiveDialect() === Dialects.WDI5);
 			}
-		}).then(function (sSnippet) {
+		});
+	};
+
+	/**
+	 * send an event to the test recorder frame that has as payload:
+	 * a generated code snippet for locating controls
+	 * @param {object} mData object containing control identifiers and actions
+	 * @param {string} mData.domElementId ID of a dom element from which the control is found (e.g. dom ref)
+	 * @param {string} mData.action name of an action to record in the snippet (e.g. press, enter text)
+	 * @param {string} mData.actionSettings settings for the action contructor
+	 * @param {object} mData.assertion assertion details - property name, type and expected value
+	 */
+	ControlInspector.prototype.getCodeSnippet = function (mData) {
+		return this._getCodeSnippet(mData).then(function (sSnippet) {
 			// here sSnippet contains the snippets for one or multiple controls
 			CommunicationBus.publish(CommunicationChannels.RECEIVE_CODE_SNIPPET, {
 				codeSnippet: sSnippet
@@ -139,11 +158,25 @@ sap.ui.define([
 		}).catch(function (oError) {
 			CommunicationBus.publish(CommunicationChannels.RECEIVE_CODE_SNIPPET, {
 				error: "Could not generate code snippet for " + JSON.stringify(mData) + ". Details: " + oError,
-				domElementId: mDataForGenerator.domElementId
+				domElementId: mData.domElementId
 			});
 		});
 	};
 
+	/**
+	 * find a cached selector or generate a new one
+	 * @param {object} mData object containing control identifiers
+	 * @param {string} mData.domElementId ID of a dom element from which the control is found (e.g. dom ref)
+	 * @returns {Promise<object>} resolves with the control selector
+	 */
+	ControlInspector.prototype.getSelector = function (mData) {
+		var mDataForGenerator = Object.assign({}, mData, {
+			settings: mSelectorSettings
+		});
+		var mControlSelector = ControlInspectorRepo.findSelector(mData.domElementId);
+		return mControlSelector ? Promise.resolve(mControlSelector) : ControlSelectorGenerator.getSelector(mDataForGenerator);
+	};
+
 	/**
 	 * given a control identifier, highlight the control in the app
 	 * @param {object} mData control identifier

package/src/sap/ui/testrecorder/library.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @namespace
 	 * @alias sap.ui.testrecorder
 	 * @author SAP SE
-	 * @version 1.145.1
+	 * @version 1.147.0
 	 * @since 1.74
 	 * @public
 	 */
@@ -39,7 +39,7 @@ sap.ui.define([
 		controls: [],
 		elements: [],
 		noLibraryCSS: true,
-		version: "1.145.1",
+		version: "1.147.0",
 		extensions: {
 			//Configuration used for rule loading of Support Assistant
 			"sap.ui.support": {

package/src/sap/ui/testrecorder/ui/views/Main.view.xml

@@ -16,7 +16,7 @@
 					<contentMiddle>
 						<Image src="../ui/images/Logo_O_22x22.png" densityAware="false"></Image>
 						<Text text="{/iFrameTitle}" />
-						<c:Icon src="sap-icon://full-screen" press="toggleMinimize" />
+						<c:Icon src="sap-icon://full-screen" press=".toggleMinimize" />
 					</contentMiddle>
 				</Bar>
 				<Bar id="ttStandardHeaderBar" class="sapContrast ttPageBar ttStandardPageBar">
@@ -29,15 +29,15 @@
 					</contentMiddle>
 					<contentRight>
 						<!-- <c:Icon src="sap-icon://sys-help" tooltip="{i18n>TestRecorder.TitleBar.Documentation.Tooltip}" /> -->
-						<c:Icon src="sap-icon://settings" press="openSettingsDialog" tooltip="{i18n>TestRecorder.TitleBar.Window.Settings.Tooltip}"/>
+						<c:Icon src="sap-icon://settings" press=".openSettingsDialog" tooltip="{i18n>TestRecorder.TitleBar.Window.Settings.Tooltip}"/>
 
-						<c:Icon src="sap-icon://minimize" press="toggleMinimize" tooltip="{i18n>TestRecorder.TitleBar.Window.Minimize.Tooltip}" visible="{/isInIframe}" />
-						<c:Icon src="sap-icon://slim-arrow-down" press="dockBottom" tooltip="{i18n>TestRecorder.TitleBar.Window.Dock.Bottom.Tooltip}" />
-						<c:Icon src="sap-icon://slim-arrow-left" press="dockLeft" tooltip="{i18n>TestRecorder.TitleBar.Window.Dock.Left.Tooltip}" />
-						<c:Icon src="sap-icon://slim-arrow-right" press="dockRight" tooltip="{i18n>TestRecorder.TitleBar.Window.Dock.Right.Tooltip}" />
+						<c:Icon src="sap-icon://minimize" press=".toggleMinimize" tooltip="{i18n>TestRecorder.TitleBar.Window.Minimize.Tooltip}" visible="{/isInIframe}" />
+						<c:Icon src="sap-icon://slim-arrow-down" press=".dockBottom" tooltip="{i18n>TestRecorder.TitleBar.Window.Dock.Bottom.Tooltip}" />
+						<c:Icon src="sap-icon://slim-arrow-left" press=".dockLeft" tooltip="{i18n>TestRecorder.TitleBar.Window.Dock.Left.Tooltip}" />
+						<c:Icon src="sap-icon://slim-arrow-right" press=".dockRight" tooltip="{i18n>TestRecorder.TitleBar.Window.Dock.Right.Tooltip}" />
 
-						<c:Icon src="sap-icon://popup-window" press="openWindow" tooltip="{i18n>TestRecorder.TitleBar.Window.New.Tooltip}" visible="{/isInIframe}"/>
-						<c:Icon src="sap-icon://decline" press="close" tooltip="{i18n>TestRecorder.TitleBar.Window.Close.Tooltip}"/>
+						<c:Icon src="sap-icon://popup-window" press=".openWindow" tooltip="{i18n>TestRecorder.TitleBar.Window.New.Tooltip}" visible="{/isInIframe}"/>
+						<c:Icon src="sap-icon://decline" press=".close" tooltip="{i18n>TestRecorder.TitleBar.Window.Close.Tooltip}"/>
 					</contentRight>
 				</Bar>
 			</l:fixContent>
@@ -73,7 +73,7 @@
 										<c:Item key="{key}" text="{label}" />
 									</Select>
 									<Label text="{i18n>TestRecorder.Inspect.Snippet.MultiSwitch.Label}" labelFor="multiSwitch" class="sapUiSmallMarginEnd" />
-									<Switch id="multiSwitch" state="{/settings/multipleSnippets}" type="AcceptReject" change="_onChangeMultiple"/>
+									<Switch id="multiSwitch" state="{/settings/multipleSnippets}" type="AcceptReject" change="._onChangeMultiple"/>
 								</HBox>
 							</VBox>
 							<code:CodeEditor
@@ -90,8 +90,8 @@
 								colorTheme="theme-ambiance"
 								lineNumbers="false"/>
 							<HBox justifyContent="End" alignItems="Center">
-								<Button text="{i18n>TestRecorder.Inspect.Snippet.Copy.Text}" press="copyCodeSnippet"/>
-								<Button text="{i18n>TestRecorder.Inspect.Snippet.Clear.Text}" press="clearCodeSnippet" class="sapUiSmallMarginBegin"/>
+								<Button text="{i18n>TestRecorder.Inspect.Snippet.Copy.Text}" press=".copyCodeSnippet"/>
+								<Button text="{i18n>TestRecorder.Inspect.Snippet.Clear.Text}" press=".clearCodeSnippet" class="sapUiSmallMarginBegin"/>
 							</HBox>
 						</ScrollContainer>
 						</Panel>
@@ -129,7 +129,7 @@
 													<c:Icon src="sap-icon://add-process"
 														class="sapUiSmallMarginEnd"
 														tooltip="{i18n>TestRecorder.Inspect.Properties.Property.Icon.Tooltip}"
-														press="handlePropertyIconPress"/>
+														press=".handlePropertyIconPress"/>
 													<Text text="{controls>property}"/>
 												</HBox>
 												<Text text="{controls>value}"/>
@@ -158,7 +158,7 @@
 													<c:Icon src="sap-icon://add-process"
 														class="sapUiSmallMarginEnd"
 														tooltip="{i18n>TestRecorder.Inspect.Properties.Property.Icon.Tooltip}"
-														press="handlePropertyIconPress"/>
+														press=".handlePropertyIconPress"/>
 													<Text text="{controls>property}"/>
 												</HBox>
 												<Text text="{controls>value}"/>

package/src/sap/ui/testrecorder/utils/convertTreeToMarkdown.js

@@ -0,0 +1,150 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([], function() {
+	"use strict";
+
+	// Constants
+	var PAGE_CONTENT_HEADER = "## Page content";
+	var DEFAULT_INDENT = "  ";
+
+	var DEFAULT_OPTIONS = {
+		indent: DEFAULT_INDENT,
+		verbose: false
+	};
+
+	/**
+	 * Converts a control tree structure into a markdown-formatted string representation.
+	 *
+	 * The function takes a tree structure (single node or array of nodes) and formats it
+	 * as an indented markdown hierarchy showing each control's metadata and relationships.
+	 *
+	 * <b>Note:</b> No module from <code>sap/ui/testrecorder</code> should be used for productive coding!
+	 *
+	 * @alias module:sap/ui/testrecorder/utils/convertTreeToMarkdown
+	 * @param {sap.ui.testrecorder.ControlTreeNode|Array<sap.ui.testrecorder.ControlTreeNode>} vTree - Control tree (single node or array of root nodes)
+	 * @param {Object} [oOptions] - Formatting options
+	 * @param {string} [oOptions.indent="  "] - Indentation string for nested levels
+	 * @param {boolean} [oOptions.verbose=false] - Whether to include verbose output (full control IDs and class names)
+	 * @returns {string} Markdown-formatted string representation of the control tree
+	 * @private
+	 * @since 1.147
+	 */
+	function convertTreeToMarkdown(vTree, oOptions) {
+		var aRoots = Array.isArray(vTree) ? vTree.slice() : [vTree];
+		var oMergedOptions = Object.assign({}, DEFAULT_OPTIONS, oOptions);
+		var aLines = [PAGE_CONTENT_HEADER];
+
+		aRoots.forEach(function (oRoot) {
+			traverseNode(oRoot, 0, aLines, oMergedOptions);
+		});
+
+		return aLines.join("\n");
+	}
+
+	/**
+	 * Recursively traverses a node and its children, appending formatted lines to output.
+	 * @param {sap.ui.testrecorder.ControlTreeNode} oNode - Node to traverse
+	 * @param {number} iLevel - Current indentation level
+	 * @param {Array<string>} aOut - Output array to append lines to
+	 * @param {Object} oOptions - Formatting options
+	 * @private
+	 */
+	function traverseNode(oNode, iLevel, aOut, oOptions) {
+		if (!oNode) {
+			return;
+		}
+
+		aOut.push(formatNodeLine(oNode, iLevel, oOptions));
+
+		// Process children
+		var aChildren = oNode.content || [];
+		for (var iIndex = 0; iIndex < aChildren.length; iIndex++) {
+			traverseNode(aChildren[iIndex], iLevel + 1, aOut, oOptions);
+		}
+	}
+
+	/**
+	 * Formats a single node line with indentation and attributes.
+	 * @param {sap.ui.testrecorder.ControlTreeNode} oNode - Node to format
+	 * @param {number} iLevel - Indentation level
+	 * @param {Object} oOptions - Formatting options
+	 * @returns {string} Formatted node line
+	 * @private
+	 */
+	function formatNodeLine(oNode, iLevel, oOptions) {
+		var aParts = [];
+
+		// ID token (only when verbose)
+		if (oOptions.verbose) {
+			aParts.push("id=" + oNode.id);
+		}
+
+		// Include control class name: full when verbose, otherwise only last segment
+		if (oNode.name) {
+			var sDisplayName = oOptions.verbose ? oNode.name : getSimpleName(oNode.name);
+			aParts.push(sDisplayName);
+		}
+
+		var oData = oNode.data || {};
+
+		Object.keys(oData).forEach(function (sKey) {
+			var vValue = oData[sKey];
+			if (typeof vValue === "boolean") {
+				if (vValue === true) {
+					// For true booleans, emit bare attribute (e.g. focused, hidden, busy)
+					aParts.push(sKey);
+				}
+			} else {
+				var sFormatted = formatAttrValue(vValue);
+				aParts.push(sKey + "=" + sFormatted);
+			}
+		});
+
+		// nodeId (snapshot-relative identifier for API consumers)
+		if (oNode.nodeId) {
+			aParts.push("nodeId=" + formatAttrValue(oNode.nodeId));
+		}
+
+		return oOptions.indent.repeat(iLevel) + aParts.join(" ");
+	}
+
+	/**
+	 * Formats an attribute value for markdown output.
+	 * @param {*} vValue - Value to format
+	 * @returns {string|boolean} Formatted value (boolean true returns true, others return strings)
+	 * @private
+	 */
+	function formatAttrValue(vValue) {
+		if (typeof vValue === "boolean") {
+			// Boolean true -> print key alone; false -> key=false (handled by caller)
+			return vValue === true ? true : "false";
+		}
+		if (typeof vValue === "number") {
+			return String(vValue);
+		}
+		if (typeof vValue === "string") {
+			return '"' + vValue.replace(/"/g, '\\"') + '"';
+		}
+		if (vValue === undefined || vValue === null) {
+			return '""';
+		}
+		// Fallback for complex types
+		return '"' + JSON.stringify(vValue).replace(/"/g, '\\"') + '"';
+	}
+
+	/**
+	 * Extracts the simple name from a qualified name by returning the last segment after the final dot.
+	 * @param {string} sQualifiedName - Fully qualified name (e.g., "sap.m.Button")
+	 * @returns {string} Simple name (e.g., "Button") or the original name if no dots are present
+	 * @private
+	 */
+	function getSimpleName(sQualifiedName) {
+		var aNameParts = String(sQualifiedName).split('.');
+		return aNameParts[aNameParts.length - 1] || sQualifiedName;
+	}
+
+	return convertTreeToMarkdown;
+});

package/src/sap/ui/testrecorder/utils/filterControlTree.js

@@ -0,0 +1,176 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([], function() {
+	"use strict";
+
+	/**
+	 * Filters a control tree based on search query and options.
+	 *
+	 * Applies node-skip rules (e.g. InvisibleText exclusion) and, when a search query is
+	 * present, prunes the tree so that only matching nodes (and optionally their ancestors
+	 * and/or descendants) survive.
+	 *
+	 * <b>Note:</b> No module from <code>sap/ui/testrecorder</code> should be used for productive coding!
+	 *
+	 * @alias module:sap/ui/testrecorder/utils/filterControlTree
+	 * @param {Array<sap.ui.core.support.ToolsAPI.ControlTreeNode>} aRawTree - Array of root control-tree nodes
+	 * @param {Object} oOptions - Filter options
+	 * @param {string} [oOptions.query] - Free-text query to match against node id, name, and data
+	 * @param {boolean} [oOptions.includeAncestors=true] - Keep ancestor nodes when a descendant matches
+	 * @param {boolean} [oOptions.includeDescendants=true] - Keep descendant nodes when a node matches
+	 * @param {boolean} [oOptions.includeInvisibleText=false] - Whether to include InvisibleText controls
+	 * @returns {Array<sap.ui.testrecorder.ControlTreeNode>} Filtered copy of the tree (original is not mutated)
+	 * @private
+	 * @since 1.147
+	 */
+	function filterControlTree(aRawTree, oOptions) {
+		return aRawTree.map(function(oControlNode) {
+			return filterNode(oControlNode, oOptions, false);
+		}).filter(Boolean);
+	}
+
+	/**
+	 * Filter a control node and its subtree based on search query and options.
+	 * @param {sap.ui.core.support.ToolsAPI.ControlTreeNode} controlNode - Original tree node
+	 * @param {Object} oOptions - Filter options
+	 * @param {boolean} bAncestorMatched - Whether an ancestor matched the query (propagated down)
+	 * @returns {sap.ui.testrecorder.ControlTreeNode|null} Filtered node or null if pruned
+	 * @private
+	 */
+	function filterNode(controlNode, oOptions, bAncestorMatched) {
+		if (!controlNode || shouldSkipNode(controlNode, oOptions)) {
+			return null;
+		}
+		var sQuery = oOptions.query;
+
+		// No query → keep entire subtree (only apply skip checks)
+		if (!sQuery || !sQuery.trim()) {
+			return Object.assign({}, controlNode, { content: copyChildren(controlNode, oOptions) });
+		}
+
+		var bThisNodeMatches = doesNodeMatchQuery(controlNode, sQuery);
+
+		// If this node (or an ancestor) matched and includeDescendants is on,
+		// keep the entire subtree below (only apply skip checks)
+		if ((bAncestorMatched || bThisNodeMatches) && oOptions.includeDescendants) {
+			return Object.assign({}, controlNode, { content: copyChildren(controlNode, oOptions) });
+		}
+
+		// Recurse children — only surviving children are kept
+		var aFilteredChildren = [];
+		if (controlNode.content && Array.isArray(controlNode.content)) {
+			for (var i = 0; i < controlNode.content.length; i++) {
+				var oChild = filterNode(controlNode.content[i], oOptions, bThisNodeMatches);
+				if (oChild) {
+					aFilteredChildren.push(oChild);
+				}
+			}
+		}
+
+		// Keep this node if it directly matches,
+		// or if includeAncestors is on and a descendant survived (i.e. matched)
+		var bHasMatchingDescendant = aFilteredChildren.length > 0;
+		if (bThisNodeMatches || (oOptions.includeAncestors && bHasMatchingDescendant)) {
+			return Object.assign({}, controlNode, { content: aFilteredChildren });
+		}
+
+		return null; // prune
+	}
+
+	/**
+	 * Copy children of a node, applying only skip checks (no query filtering).
+	 * Used when the entire subtree should be kept.
+	 * @param {sap.ui.core.support.ToolsAPI.ControlTreeNode} controlNode - Parent node whose children to copy
+	 * @param {Object} oOptions - Filter options
+	 * @returns {Array<sap.ui.testrecorder.ControlTreeNode>} Copied children
+	 * @private
+	 */
+	function copyChildren(controlNode, oOptions) {
+		var aChildren = [];
+		if (controlNode.content && Array.isArray(controlNode.content)) {
+			for (var i = 0; i < controlNode.content.length; i++) {
+				var oChild = controlNode.content[i];
+				if (!oChild || shouldSkipNode(oChild, oOptions)) {
+					continue;
+				}
+				aChildren.push(Object.assign({}, oChild, { content: copyChildren(oChild, oOptions) }));
+			}
+		}
+		return aChildren;
+	}
+
+	/**
+	 * Check if a node should be skipped during processing.
+	 * @param {sap.ui.core.support.ToolsAPI.ControlTreeNode} controlNode - Control node to check
+	 * @param {Object} oOptions - Filter options
+	 * @returns {boolean} True if node should be skipped
+	 * @private
+	 */
+	function shouldSkipNode(controlNode, oOptions) {
+		// Skip InvisibleText controls unless explicitly included
+		return !oOptions.includeInvisibleText && isInvisibleText(controlNode);
+	}
+
+	/**
+	 * Check if a single node matches the query (without checking descendants).
+	 * @param {sap.ui.core.support.ToolsAPI.ControlTreeNode} oNode - Control node to check
+	 * @param {string} sQuery - Query string to match against
+	 * @returns {boolean} True if THIS node matches (ignoring descendants)
+	 * @private
+	 */
+	function doesNodeMatchQuery(oNode, sQuery) {
+		if (!oNode || typeof sQuery !== "string" || !sQuery.trim()) {
+			return false; // no match if no query
+		}
+		sQuery = sQuery.toLowerCase().trim();
+
+		function matches(value) {
+			return value != null && String(value).toLowerCase().indexOf(sQuery) !== -1;
+		}
+
+		return matches(oNode.id) || matches(oNode.name) || matchesObjectKeysOrValues(oNode.data, matches);
+	}
+
+	/**
+	 * Checks if a control node represents an InvisibleText control.
+	 * @param {sap.ui.core.support.ToolsAPI.ControlTreeNode} controlNode - Control node to check
+	 * @returns {boolean} True if the node is an InvisibleText control
+	 * @private
+	 */
+	function isInvisibleText(controlNode) {
+		return controlNode.type === 'sap-ui-control' &&
+			controlNode.name && controlNode.name.indexOf('InvisibleText') !== -1;
+	}
+
+	/**
+	 * Check if any key or value in an object matches the given matcher function.
+	 * @param {Object} oObject - Object to check
+	 * @param {Function} fnMatcher - Function that returns true if a value matches
+	 * @returns {boolean} True if any key or value matches
+	 * @private
+	 */
+	function matchesObjectKeysOrValues(oObject, fnMatcher) {
+		if (!oObject || typeof oObject !== 'object') {
+			return false;
+		}
+		var aKeys = Object.keys(oObject);
+		for (var i = 0; i < aKeys.length; i++) {
+			var sKey = aKeys[i];
+			if (fnMatcher(sKey)) {
+				return true;
+			}
+			var vValue = oObject[sKey];
+			if (vValue !== null && vValue !== undefined) {
+				if (fnMatcher(vValue)) {
+					return true;
+				}
+			}
+		}
+		return false;
+	}
+
+	return filterControlTree;
+});