@openui5/sap.ui.documentation 1.145.1 → 1.147.0

package/src/sap/ui/documentation/Row.js

@@ -3,34 +3,173 @@
  * (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/ui/core/Element'],
-	function(Element) {
+sap.ui.define([
+	'sap/ui/core/Control',
+	'sap/ui/core/Icon'
+], function(Control, Icon) {
 	"use strict";
 
 		/**
 		 * @class
 		 * Provides a row element for the <code>LightTable</code>.
-		 * @extends sap.ui.core.Element
+		 * @extends sap.ui.core.Control
 		 * @private
 		 * @ui5-restricted sdk
 		 */
-		return Element.extend("sap.ui.documentation.Row", {
+		var Row = Control.extend("sap.ui.documentation.Row", {
 			metadata : {
 				library: "sap.ui.documentation",
 				properties: {
 					/**
 					 * Determines whether the row is visible.
 					 */
-					visible: {type: "boolean"}
+					visible: {type: "boolean", defaultValue: true},
+					/**
+					 * Determines whether the row is expanded (showing subRows).
+					 */
+					expanded: {type: "boolean", defaultValue: false},
+					/**
+					 * Determines whether the row can be expanded/collapsed (shows expand/collapse icon).
+					 */
+					expandable: {type: "boolean", defaultValue: false},
+					/**
+					 * The name of the typedef that this parameter refers to
+					 */
+					typedefName: {type : "string", defaultValue : ""}
 				},
 				defaultAggregation : "content",
 				aggregations: {
 					/**
 					 * Controls to be displayed by the <code>LightTable</code>.
 					 */
-					content: {type: "sap.ui.core.Control", multiple: true}
+					content: {type: "sap.ui.core.Control", multiple: true},
+					/**
+					 * Sub-rows to be displayed when the row is expanded.
+					 */
+					subRows: {type: "sap.ui.documentation.Row", multiple: true},
+					/**
+					 * Internal Icon control for the expand/collapse functionality
+					 */
+					_expandIcon: {type: "sap.ui.core.Icon", multiple: false, visibility: "hidden"}
+				},
+				events: {
+					/**
+					 * Event is fired when the user clicks on the expand/collapse icon.
+					 */
+					expandToggle: {}
+				}
+			},
+
+			/**
+			 * Creates the expand/collapse icon
+			 * @private
+			 */
+			_getExpandCollapseIcon: function() {
+				if (!this.getAggregation("_expandIcon")) {
+					var oExpandIcon = new Icon({
+						press: function() {
+							this.fireExpandToggle();
+						}.bind(this)
+					});
+
+					// Add custom classes for styling
+					oExpandIcon.addStyleClass("sapUiTinyMarginEnd").addStyleClass("sapUiDocTypedefExpandIcon");
+
+					this.setAggregation("_expandIcon", oExpandIcon);
+
+					// Update the icon appearance based on the current expanded state
+					this._updateExpandIconState();
+				}
+
+				return this.getAggregation("_expandIcon");
+			},
+
+			/**
+			 * Updates the expand icon state (src) based on the expanded property
+			 * @private
+			 */
+			_updateExpandIconState: function() {
+				var oExpandIcon = this.getAggregation("_expandIcon");
+
+				if (oExpandIcon) {
+					var bExpanded = this.getExpanded();
+					oExpandIcon.setSrc(bExpanded ? "sap-icon://slim-arrow-down" : "sap-icon://slim-arrow-right");
+				}
+			},
+
+			/**
+			 * Updates the expand icon when the expanded property changes
+			 */
+			setExpanded: function(bExpanded) {
+				this.setProperty("expanded", bExpanded, true); // Suppress rerendering
+				this._updateExpandIconState();
+				return this;
+			},
+			renderer: {
+				apiVersion: 2,
+
+				render: function(oRm, oControl) {
+					var aControls = oControl.getContent(),
+						aSubRows = oControl.getSubRows(),
+						bExpanded = oControl.getExpanded(),
+						bExpandable = oControl.getExpandable(),
+						bVisible = oControl.getVisible(),
+						aLen,
+						a;
+
+					// Don't render if not visible
+					if (!bVisible) {
+						return;
+					}
+
+					// Get column titles from parent LightTable
+					var oParent = oControl.getParent(),
+						aColumnTitles = oParent && oParent.getColumnTitles ? oParent.getColumnTitles() : [];
+
+					// Render the main row
+					oRm.openStart("div", oControl);
+					oRm.class("row");
+					if (bExpandable) {
+						oRm.class(bExpanded ? "expanded" : "collapsed");
+					}
+					oRm.openEnd();
+
+					// Render cells
+					for (a = 0, aLen = aControls.length; a < aLen; a++) {
+						oRm.openStart("div")
+							.class("cell")
+							.openEnd();
+
+						// Handle inline title (for responsive view)
+						if (a > 0 && aColumnTitles[a]) {
+							oRm.openStart("div")
+								.class("inTitle")
+								.openEnd()
+								.text(aColumnTitles[a] + ":")
+								.close("div");
+						}
+
+						// Render the expand/collapse icon in the first cell if expandable
+						if (a === 0 && bExpandable) {
+							oRm.renderControl(oControl._getExpandCollapseIcon());
+						}
+
+						oRm.renderControl(aControls[a]);
+						oRm.close("div");
+					}
+
+					oRm.close("div");
+
+					// Render sub-rows if expanded
+					if (bExpanded && aSubRows.length > 0) {
+						for (var i = 0; i < aSubRows.length; i++) {
+							oRm.renderControl(aSubRows[i]);
+						}
+					}
 				}
 			}
 		});
 
-	});
+		return Row;
+
+});

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

@@ -25,14 +25,14 @@ sap.ui.define([
 	 * @namespace
 	 * @alias sap.ui.documentation
 	 * @author SAP SE
-	 * @version 1.145.1
+	 * @version 1.147.0
 	 * @since 1.48
 	 * @public
 	 */
 	var thisLibrary = Lib.init({
 		apiVersion: 2,
 		name : 'sap.ui.documentation',
-		version: '1.145.1',
+		version: '1.147.0',
 		dependencies : ['sap.ui.core','sap.m'],
 		types: [],
 		interfaces: [],

package/src/sap/ui/documentation/messagebundle.properties

@@ -782,6 +782,12 @@ API_DETAIL_DEPRECATED_WARNING = For general information about Deprecated feature
 API_DETAIL_AS_OF_VERSION = As of {0}
 #XTXT: Text for non-existing version
 API_DETAIL_NA_VERSION = Version N/A
+#XTOL: Tooltip for the bookmark icon that copies a direct link to the section or subsection
+API_DETAIL_BOOKMARK_TOOLTIP = Copy link to Section
+#XMSG: Toast message shown after the section/subsection URL is successfully copied to clipboard
+API_DETAIL_BOOKMARK_COPIED = URL copied to clipboard
+#XMSG: Toast message shown when clipboard API is unavailable but the URL was updated in the address bar
+API_DETAIL_BOOKMARK_URL_UPDATED = URL updated in address bar
 
 #XHED: The title of the intro card on Resources page
 RESOURCES_INTRO_CARD_TITLE = Resources
@@ -828,6 +834,10 @@ RESOURCES_CARD_DESC_LINTER = UI5 linter is a static code analysis tool for UI5 p
 RESOURCES_CARD_TITLE_MCPSERVER = UI5 MCP server
 #XTXT: Card description for UI5 server resource
 RESOURCES_CARD_DESC_MCPSERVER = The UI5 Model Context Protocol server offers tools to improve the developer experience when working with agentic AI tools.
+#XHED: Card title for SAP Fiori MCP server resource
+RESOURCES_CARD_TITLE_FIORI_MCPSERVER = SAP Fiori MCP server
+#XTXT: Card description for SAP Fiori MCP server resource
+RESOURCES_CARD_DESC_FIORI_MCPSERVER = This package includes a Model Context Protocol (MCP) server for integration with AI coding assistants. The server helps AI models create or modify SAP Fiori applications based on prompts.
 #XHED: Card title for SAP Business Application Studio resource
 RESOURCES_CARD_TITLE_BUSINESS_APP_STUDIO = SAP Business Application Studio
 #XTXT: Card description for SAP Business Application Studio resource
@@ -884,6 +894,8 @@ RESOURCES_CARD_LINK_CARD_EXPLORER = Check out UI Integration with cards
 RESOURCES_CARD_LINK_LINTER = Check out UI5 linter
 #XLNK: Link text for UI5 MCP server action button
 RESOURCES_CARD_LINK_MCPSERVER = Check out UI5 MCP server
+#XLNK: Link text for SAP Fiori MCP server action button
+RESOURCES_CARD_LINK_FIORI_MCPSERVER = Check out SAP Fiori MCP server
 #XLNK: Link text for SAP Fiori Development Portal action button
 RESOURCES_CARD_LINK_FIORI_DEV_PORTAL = Check out the SAP Fiori Development Portal
 #XLNK: Link text for SAP Business Application Studio action button

package/src/sap/ui/documentation/messagebundle_de.properties

@@ -8,7 +8,7 @@ APP_TABHEADER_ITEM_API_REFERENCE=API-Referenz
 APP_TABHEADER_ITEM_SAMPLES=Beispiele
 APP_TABHEADER_ITEM_DEMO_APPS=Demo-Apps
 APP_TABHEADER_ITEM_RESOURCES=Ressourcen
-APP_TABHEADER_SUBITEM_FIORI_TOOLS=Fiori-Tools
+APP_TABHEADER_SUBITEM_FIORI_TOOLS=SAP Fiori tools
 APP_TABHEADER_SUBITEM_ICON_EXPLORER=Symbolexplorer
 APP_TABHEADER_SUBITEM_UI5_INSPECTOR=UI5 Inspector
 APP_TABHEADER_SUBITEM_UI5_CLI=UI5 CLI

package/src/sap/ui/documentation/messagebundle_en.properties

@@ -346,8 +346,8 @@ RELEASE_DIALOG_NO_DATA_TEXT=No changes for this library.
 
 ABOUT_DIALOG_TITLE=About
 ABOUT_DIALOG_TEXT_1=UI5 Demo Kit - UI Development Toolkit for HTML5
-ABOUT_DIALOG_TEXT_2=\u00A9 Copyright 2025 SAP SE. All rights reserved.
-ABOUT_DIALOG_TEXT_3=\u00A9 2025 SAP SE or an SAP affiliate company.
+ABOUT_DIALOG_TEXT_2=\u00A9 Copyright 2026 SAP SE. All rights reserved.
+ABOUT_DIALOG_TEXT_3=\u00A9 2026 SAP SE or an SAP affiliate company.
 ABOUT_DIALOG_TEXT_4={0} Version {1}
 ABOUT_DIALOG_TEXT_5=Open UI5 Version {0}
 ABOUT_DIALOG_TEXT_6=This software includes the following library versions

package/src/sap/ui/documentation/messagebundle_en_US_saprigi.properties

@@ -435,6 +435,8 @@ RESOURCES_CARD_TITLE_LINTER=\u206A\u206A\u206A\u200C\u200C\u200C\u200D\u200C\u20
 RESOURCES_CARD_DESC_LINTER=\u206A\u206A\u206A\u200C\u200B\u200C\u200B\u200D\u200C\u200C\u200C\u200D\u200B\u200C\u200B\u200C\u200C\u200C\u200D\u200B\u200B\u200B\u200B\u200D\u200B\u200B\u200B\u200D\u200C\u200D\u200C\u200C\u200B\u200B\u200D\u200D\u200C\u200D\u200B\u200C\u200B\u200C\u200B\u206AUI5 linter is a static code analysis tool for UI5 projects. It checks JavaScript, XML, JSON, and other files in your project, and reports findings. It helps you follow best practices in your UI5 projects and to adapt them to new UI5 major versions.\u206A\u206A
 RESOURCES_CARD_TITLE_MCPSERVER=\u206A\u206A\u206A\u200C\u200D\u200C\u200B\u200B\u200C\u200B\u200C\u200B\u200C\u200B\u200C\u200C\u200D\u200D\u200C\u200B\u200D\u200C\u200B\u200C\u200D\u200B\u200D\u200D\u200C\u200D\u200D\u200B\u200D\u200D\u200D\u200D\u200B\u200C\u200B\u200D\u200B\u200B\u206AUI5 MCP server\u206A\u206A
 RESOURCES_CARD_DESC_MCPSERVER=\u206A\u206A\u206A\u200D\u200B\u200B\u200B\u200B\u200B\u200D\u200C\u200C\u200C\u200D\u200B\u200B\u200B\u200B\u200B\u200D\u200B\u200C\u200C\u200B\u200C\u200B\u200C\u200B\u200C\u200D\u200B\u200B\u200C\u200B\u200D\u200D\u200D\u200C\u200D\u200B\u200C\u200B\u200B\u206AThe UI5 Model Context Protocol server offers tools to improve the developer experience when working with agentic AI tools.\u206A\u206A
+RESOURCES_CARD_TITLE_FIORI_MCPSERVER=\u206A\u206A\u206A\u200D\u200B\u200B\u200B\u200C\u200B\u200B\u200C\u200C\u200C\u200D\u200D\u200D\u200C\u200D\u200B\u200B\u200D\u200D\u200D\u200B\u200C\u200D\u200C\u200C\u200C\u200B\u200D\u200B\u200B\u200C\u200B\u200D\u200B\u200B\u200B\u200B\u200D\u200C\u200B\u206ASAP Fiori MCP server\u206A\u206A
+RESOURCES_CARD_DESC_FIORI_MCPSERVER=\u206A\u206A\u206A\u200D\u200D\u200D\u200D\u200D\u200B\u200B\u200C\u200B\u200B\u200B\u200B\u200D\u200C\u200D\u200D\u200D\u200B\u200D\u200C\u200D\u200B\u200B\u200B\u200D\u200C\u200D\u200C\u200B\u200D\u200D\u200B\u200B\u200D\u200B\u200D\u200B\u200D\u200C\u200B\u206AThis package includes a Model Context Protocol (MCP) server for integration with AI coding assistants. The server helps AI models create or modify SAP Fiori applications based on prompts.\u206A\u206A
 RESOURCES_CARD_TITLE_BUSINESS_APP_STUDIO=\u206A\u206A\u206A\u200D\u200D\u200C\u200C\u200B\u200B\u200D\u200C\u200D\u200B\u200B\u200C\u200D\u200D\u200D\u200B\u200B\u200D\u200C\u200D\u200B\u200C\u200D\u200C\u200D\u200C\u200D\u200D\u200C\u200D\u200B\u200B\u200D\u200C\u200B\u200D\u200D\u200C\u200B\u206ASAP Business Application Studio\u206A\u206A
 RESOURCES_CARD_DESC_BUSINESS_APP_STUDIO=\u206A\u206A\u206A\u200C\u200B\u200B\u200D\u200C\u200C\u200D\u200C\u200C\u200C\u200B\u200C\u200D\u200B\u200C\u200D\u200B\u200B\u200D\u200D\u200D\u200B\u200D\u200D\u200C\u200D\u200B\u200C\u200D\u200D\u200D\u200B\u200B\u200C\u200B\u200D\u200B\u200C\u200D\u200D\u200C\u206ASAP Business Application Studio (BAS) is a modern cloud-based development environment, tailored for efficient development and extension of business applications for intelligent enterprises.\u206A\u206A
 
@@ -465,6 +467,7 @@ RESOURCES_CARD_LINK_FIORI_TOOLS=\u206A\u206A\u206A\u200C\u200B\u200B\u200B\u200C
 RESOURCES_CARD_LINK_CARD_EXPLORER=\u206A\u206A\u206A\u200D\u200B\u200B\u200B\u200B\u200C\u200B\u200D\u200D\u200B\u200C\u200D\u200D\u200D\u200B\u200C\u200D\u200C\u200B\u200B\u200D\u200D\u200D\u200B\u200B\u200D\u200D\u200B\u200B\u200D\u200B\u200C\u200B\u200D\u200B\u200C\u200C\u200B\u200D\u200C\u206ACheck out UI Integration with cards\u206A\u206A
 RESOURCES_CARD_LINK_LINTER=\u206A\u206A\u206A\u200C\u200D\u200B\u200B\u200C\u200B\u200D\u200B\u200C\u200C\u200D\u200B\u200B\u200C\u200C\u200B\u200D\u200C\u200C\u200D\u200D\u200D\u200B\u200D\u200B\u200C\u200B\u200B\u200B\u200D\u200C\u200B\u200B\u200D\u200D\u200B\u200C\u200B\u200B\u206ACheck out UI5 linter\u206A\u206A
 RESOURCES_CARD_LINK_MCPSERVER=\u206A\u206A\u206A\u200D\u200D\u200C\u200C\u200C\u200C\u200D\u200B\u200D\u200D\u200D\u200C\u200D\u200C\u200C\u200C\u200C\u200B\u200C\u200B\u200C\u200D\u200D\u200C\u200C\u200C\u200C\u200B\u200B\u200C\u200C\u200C\u200C\u200B\u200D\u200C\u200C\u200C\u200C\u200D\u206ACheck out UI5 MCP server\u206A\u206A
+RESOURCES_CARD_LINK_FIORI_MCPSERVER=\u206A\u206A\u206A\u200D\u200B\u200B\u200C\u200B\u200B\u200D\u200C\u200C\u200D\u200D\u200B\u200B\u200B\u200C\u200C\u200D\u200C\u200B\u200B\u200D\u200B\u200B\u200C\u200D\u200D\u200B\u200D\u200B\u200B\u200C\u200C\u200D\u200D\u200C\u200C\u200B\u200D\u200C\u200B\u206ACheck out SAP Fiori MCP server\u206A\u206A
 RESOURCES_CARD_LINK_FIORI_DEV_PORTAL=\u206A\u206A\u206A\u200D\u200D\u200D\u200C\u200D\u200D\u200D\u200D\u200C\u200C\u200B\u200C\u200D\u200D\u200B\u200D\u200C\u200B\u200B\u200B\u200D\u200C\u200B\u200C\u200B\u200D\u200B\u200B\u200C\u200D\u200C\u200B\u200C\u200D\u200D\u200C\u200B\u200D\u200D\u206ACheck out the SAP Fiori Development Portal\u206A\u206A
 RESOURCES_CARD_LINK_BUSINESS_APP_STUDIO=\u206A\u206A\u206A\u200C\u200C\u200C\u200C\u200D\u200B\u200D\u200C\u200B\u200C\u200B\u200B\u200C\u200D\u200B\u200D\u200C\u200C\u200B\u200B\u200C\u200B\u200D\u200C\u200D\u200C\u200C\u200D\u200B\u200B\u200D\u200C\u200D\u200C\u200D\u200B\u200D\u200C\u200C\u200B\u200C\u206ACheck out BAS\u206A\u206A
 RESOURCES_CARD_LINK_THEME_DESIGNER=\u206A\u206A\u206A\u200C\u200C\u200D\u200C\u200D\u200D\u200C\u200C\u200D\u200C\u200C\u200C\u200D\u200B\u200B\u200B\u200C\u200C\u200B\u200B\u200D\u200D\u200D\u200C\u200C\u200D\u200D\u200D\u200C\u200B\u200B\u200D\u200C\u200B\u200C\u200C\u200D\u200B\u200C\u200B\u206ACheck out UI theme designer\u206A\u206A

package/src/sap/ui/documentation/sdk/Component.js

@@ -6,6 +6,7 @@
 
 sap.ui.define([
 	"sap/ui/thirdparty/jquery",
+	"sap/ui/core/IconPool",
 	"sap/ui/core/UIComponent",
 	"sap/ui/Device",
 	"sap/ui/documentation/sdk/model/models",
@@ -23,6 +24,7 @@ sap.ui.define([
 	"sap/m/ColumnListItem"
 ], function(
 	jQuery,
+	IconPool,
 	UIComponent,
 	Device,
 	models,
@@ -55,6 +57,10 @@ sap.ui.define([
 			init : function () {
 
 				this._oErrorHandler = new ErrorHandler(this);
+				IconPool.registerFont({
+					fontFamily: "SAP-icons-TNT",
+					fontURI: sap.ui.require.toUrl("sap/tnt/themes/base/fonts/")
+				});
 
 				// set the device model
 				this.setModel(models.createDeviceModel(), "device");

package/src/sap/ui/documentation/sdk/controller/App.controller.js

@@ -1477,7 +1477,7 @@ sap.ui.define([
 			// Handle the case when the user deletes the query and the search picker is open
 			// Only on desktop, because on mobile we don't want to close the picker
 			if (!sQuery && Device.system.desktop) {
-				if (this.oPicker.isOpen()) {
+				if (this.oPicker && this.oPicker.isOpen()) {
 					this.oPicker.close();
 				}
 

package/src/sap/ui/documentation/sdk/controller/Code.controller.js

@@ -35,6 +35,7 @@ sap.ui.define(
 
 		return SampleController.extend("sap.ui.documentation.sdk.controller.Code", {
 			constructor: function () {
+				SampleController.apply(this, arguments);
 				this.onFileEditorFileChangeDebounced = _debounce(this.onFileEditorFileChangeDebounced, 500);
 			},
 

package/src/sap/ui/documentation/sdk/controller/ErrorHandler.js

@@ -20,6 +20,7 @@ sap.ui.define([
 			 * @alias sap.ui.documentation.sdk.controller.ErrorHandler
 			 */
 			constructor : function (oComponent) {
+				UI5Object.call(this);
 				this._oComponent = oComponent;
 				this._oModel = oComponent.getModel();
 				this._bMessageOpen = false;

package/src/sap/ui/documentation/sdk/controller/Sample.controller.js

@@ -409,10 +409,13 @@ sap.ui.define([
 					});
 
 					var fnLoadSettings = function(eMessage) {
+						if (!this._isMessageFromSampleIframe(eMessage)) {
+							return;
+						}
 						fnCallback(eMessage);
 						window.removeEventListener("message", fnLoadSettings);
 						resolve();
-					};
+					}.bind(this);
 
 					window.addEventListener("message", fnLoadSettings);
 
@@ -680,6 +683,11 @@ sap.ui.define([
 				return this.byId("page");
 			},
 
+			_isMessageFromSampleIframe: function(eMessage) {
+				return eMessage.origin === this.getOwnerComponent()._sSampleIframeOrigin &&
+					eMessage.source === this._oHtmlControl.getDomRef().contentWindow;
+			},
+
 			onMessage: function(eMessage) {
 				var oModelData = this.oModel.getData();
 
@@ -687,10 +695,7 @@ sap.ui.define([
 					return;
 				}
 
-				if (eMessage.origin !== this.getOwnerComponent()._sSampleIframeOrigin) {
-					return;
-				}
-				if (eMessage.source !== this._oHtmlControl.getDomRef().contentWindow) {
+				if (!this._isMessageFromSampleIframe(eMessage)) {
 					return;
 				}