@openui5/sap.ui.documentation 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.documentation",
-  "version": "1.145.1",
+  "version": "1.147.0",
   "description": "OpenUI5 UI Library sap.ui.documentation",
   "author": "SAP SE (https://www.sap.com)",
   "license": "Apache-2.0",
@@ -14,11 +14,11 @@
     "url": "https://github.com/UI5/openui5.git"
   },
   "dependencies": {
-    "@openui5/sap.m": "1.145.1",
-    "@openui5/sap.ui.core": "1.145.1",
-    "@openui5/sap.ui.layout": "1.145.1",
-    "@openui5/themelib_sap_belize": "1.145.1",
-    "@openui5/themelib_sap_fiori_3": "1.145.1",
-    "@openui5/themelib_sap_horizon": "1.145.1"
+    "@openui5/sap.m": "1.147.0",
+    "@openui5/sap.ui.core": "1.147.0",
+    "@openui5/sap.ui.layout": "1.147.0",
+    "@openui5/themelib_sap_belize": "1.147.0",
+    "@openui5/themelib_sap_fiori_3": "1.147.0",
+    "@openui5/themelib_sap_horizon": "1.147.0"
   }
 }

package/src/sap/ui/documentation/.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>SAPUI5 library for the Demokit 2.0.</documentation>
 

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

@@ -37,68 +37,42 @@ sap.ui.define(['sap/ui/core/Control'],
 				}
 			},
 			renderer: {
-			apiVersion: 2,
+				apiVersion: 2,
 
-			render: function(oRm, oControl) {
-				var aRows = oControl.getRows(),
-					aControls,
+				render: function(oRm, oControl) {
+					var aRows = oControl.getRows(),
 					aColumnTitles = oControl.getColumnTitles(),
-					aLen,
-					a,
 					iLen,
 					i;
 
-				oRm.openStart("div", oControl);
-				oRm.class("sapUiDocLightTable");
-				oRm.class("columns-" + oControl.getColumnCount());
-				oRm.openEnd();
+					oRm.openStart("div", oControl);
+					oRm.class("sapUiDocLightTable");
+					oRm.class("columns-" + oControl.getColumnCount());
+					oRm.openEnd();
 
-				// Column titles
-				oRm.openStart("div")
-					.class("head")
-					.openEnd();
-
-				for (i = 0, iLen = aColumnTitles.length; i < iLen; i++) {
-					oRm.openStart("div")
-						.class("cell")
-						.openEnd();
-
-					oRm.text(aColumnTitles[i])
-						.close("div");
-				}
-
-				oRm.close("div");
-
-				// Rows
-				for (i = 0, iLen = aRows.length; i < iLen; i++) {
+					// Column titles
 					oRm.openStart("div")
-						.class("row")
+						.class("head")
 						.openEnd();
 
-					aControls = aRows[i].getContent();
-					for (a = 0, aLen = aControls.length; a < aLen; a++) {
+					for (i = 0, iLen = aColumnTitles.length; i < iLen; i++) {
 						oRm.openStart("div")
 							.class("cell")
 							.openEnd();
 
-						// Handle inline title
-						if (a > 0) {
-							oRm.openStart("div")
-								.class("inTitle")
-								.openEnd()
-								.text(aColumnTitles[a] + ":")
-								.close("div");
-						}
+						oRm.text(aColumnTitles[i])
+							.close("div");
+					}
+
+					oRm.close("div");
 
-						oRm.renderControl(aControls[a]);
-						oRm.close("div");
+					// Render rows (each row handles its own rendering including subRows)
+					for (i = 0, iLen = aRows.length; i < iLen; i++) {
+						oRm.renderControl(aRows[i]);
 					}
 
 					oRm.close("div");
 				}
-
-				oRm.close("div");
 			}
-		}});
-
-	});
+		});
+});

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

@@ -0,0 +1,108 @@
+
+/*!\n * OpenUI5
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.\n */
+sap.ui.define([
+	'sap/uxap/ObjectPageSection',
+	'sap/uxap/ObjectPageSectionRenderer',
+	'sap/ui/core/Icon',
+	'sap/ui/core/RenderManager',
+	'sap/ui/core/Core'
+], function(ObjectPageSection, ObjectPageSectionRenderer, Icon, RenderManager, Core) {
+	"use strict";
+
+	/**
+	 * @class
+	 * Custom ObjectPageSection control which supports a showBookmarkIcon property.
+	 * When showBookmarkIcon=true, a chain-link icon is injected into the DOM right after
+	 * the section title in onAfterRendering — no renderer override needed.
+	 * Clicking the icon fires the bookmarkIconPress event.
+	 * @extends sap.uxap.ObjectPageSection
+	 * @private
+	 * @ui5-restricted sdk
+	 */
+	var SDKObjectPageSection = ObjectPageSection.extend("sap.ui.documentation.ObjectPageSection", {
+		metadata: {
+			library: "sap.ui.documentation",
+			properties: {
+				/**
+				 * When true, a chain-link icon is injected after the section title.
+				 * Clicking the icon fires the bookmarkIconPress event.
+				 */
+				showBookmarkIcon: { type: "boolean", defaultValue: false }
+			},
+			aggregations: {
+				/**
+				 * Internal bookmark icon. The Section is the ManagedObject parent,
+				 * so lifecycle (destroy) is handled automatically.
+				 * Not intended for external use.
+				 */
+				_bookmarkIcon: { type: "sap.ui.core.Icon", multiple: false, visibility: "hidden" }
+			},
+			events: {
+				/**
+				 * Fired when the chain-link icon is pressed. Use to copy the section URL to clipboard.
+				 */
+				bookmarkIconPress: {}
+			}
+		},
+		renderer: ObjectPageSectionRenderer
+	});
+
+	/**
+	 * After the base renderer writes the section DOM, injects the bookmark icon
+	 * right after the title element using a RenderManager flush into a placeholder span.
+	 * This avoids copying/maintaining the ObjectPageSectionRenderer.
+	 * @override
+	 */
+	SDKObjectPageSection.prototype.onAfterRendering = function () {
+		ObjectPageSection.prototype.onAfterRendering?.apply(this, arguments);
+
+		if (!this.getShowBookmarkIcon() || !this.getTitleVisible()) {
+			return;
+		}
+
+		var oTitleControl = this._getTitleControl();
+		var oTitleDom = oTitleControl && oTitleControl.getDomRef();
+		if (!oTitleDom) {
+			return;
+		}
+
+		// Insert a placeholder <span> directly after the title element.
+		// The base renderer recreates the section DOM on every render cycle, so the
+		// placeholder is also recreated fresh each time (no stale-DOM risk).
+		var oPlaceholder = document.createElement("span");
+		oTitleDom.parentNode.insertBefore(oPlaceholder, oTitleDom.nextSibling);
+
+		// Render the icon into the placeholder (RenderManager.flush replaces
+		// the placeholder's children with the icon's DOM).
+		var oRm = new RenderManager().getInterface();
+		oRm.renderControl(this._getBookmarkIcon());
+		oRm.flush(oPlaceholder, true);
+		oRm.destroy();
+	};
+
+	/**
+	 * Lazy getter for the internal bookmark icon.
+	 * Creates the icon on first call and stores it in the _bookmarkIcon hidden aggregation.
+	 * @returns {sap.ui.core.Icon}
+	 * @private
+	 */
+	SDKObjectPageSection.prototype._getBookmarkIcon = function () {
+		var oIcon = this.getAggregation("_bookmarkIcon");
+		if (!oIcon) {
+			oIcon = new Icon({
+				src: "sap-icon://chain-link",
+				tooltip: Core.getLibraryResourceBundle("sap.ui.documentation").getText("API_DETAIL_BOOKMARK_TOOLTIP"),
+				decorative: false,
+				press: function () {
+					this.fireBookmarkIconPress();
+				}.bind(this)
+			}).addStyleClass("sapUiDocSectionLinkIcon");
+			this.setAggregation("_bookmarkIcon", oIcon, true); // suppress invalidate
+		}
+		return oIcon;
+	};
+
+	return SDKObjectPageSection;
+});

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

@@ -1,4 +1,3 @@
-
 /*!
  * OpenUI5
  * (c) Copyright 2026 SAP SE or an SAP affiliate company.
@@ -7,24 +6,123 @@
 sap.ui.define([
 	'sap/ui/core/Control',
 	'sap/uxap/ObjectPageSubSection',
-	'sap/uxap/ObjectPageSubSectionRenderer'
-], function(Control, ObjectPageSubSection, ObjectPageSubSectionRenderer) {
+	'sap/uxap/ObjectPageSubSectionRenderer',
+	'sap/m/OverflowToolbarLayoutData',
+	'sap/m/library',
+	'sap/ui/core/Icon',
+	'sap/ui/core/Core'
+], function(Control, ObjectPageSubSection, ObjectPageSubSectionRenderer, OverflowToolbarLayoutData, mobileLibrary, Icon, Core) {
 	"use strict";
 
+	var OverflowToolbarPriority = mobileLibrary.OverflowToolbarPriority;
+
 	/**
 	 * @class
-	 * Custom ObjectPageSubSection control which internally does not uses Grid control.
+	 * Custom ObjectPageSubSection control which:
+	 * - Does not use the Grid control internally (uses a simple Container instead)
+	 * - Supports a showBookmarkIcon property: when true, a chain-link icon is inserted
+	 *   into the internal OverflowToolbar right after the title. Clicking the icon
+	 *   fires the bookmarkIconPress event.
+	 *
 	 * @extends sap.uxap.ObjectPageSubSection
 	 * @private
 	 * @ui5-restricted sdk
 	 */
 	var SDKObjectPageSubSection = ObjectPageSubSection.extend("sap.ui.documentation.ObjectPageSubSection", {
 		metadata: {
-			library: "sap.ui.documentation"
+			library: "sap.ui.documentation",
+			properties: {
+				/**
+				 * When true, a chain-link icon is rendered inside the subsection toolbar
+				 * right after the title. Clicking the icon fires the bookmarkIconPress event.
+				 */
+				showBookmarkIcon: { type: "boolean", defaultValue: false }
+			},
+			events: {
+				/**
+				 * Fired when the chain-link icon is pressed. Use to copy the subsection URL to clipboard.
+				 */
+				bookmarkIconPress: {}
+			}
 		},
 		renderer: ObjectPageSubSectionRenderer
 	});
 
+	/**
+	 * Override to create and insert the bookmark icon into the OverflowToolbar when
+	 * showBookmarkIcon is set to true. The icon is NOT stored in a ManagedObject aggregation
+	 * on this control - it lives only in the toolbar (its true parent), with a plain JS
+	 * reference kept in this._oBookmarkIcon. The toolbar (a hidden child of this SubSection
+	 * via _headerToolbar) owns the icon lifecycle.
+	 * This mirrors how sap.uxap.ObjectPageSubSection handles its "actions" aggregation.
+	 * @override
+	 */
+	SDKObjectPageSubSection.prototype.setShowBookmarkIcon = function (bValue) {
+		this.setProperty("showBookmarkIcon", bValue, true); // suppress invalidate — toolbar insertion handles rendering
+
+		if (bValue) {
+			if (!this._oBookmarkIcon) {
+				this._oBookmarkIcon = new Icon({
+					src: "sap-icon://chain-link",
+					tooltip: Core.getLibraryResourceBundle("sap.ui.documentation").getText("API_DETAIL_BOOKMARK_TOOLTIP"),
+					decorative: false,
+					layoutData: new OverflowToolbarLayoutData({
+						priority: OverflowToolbarPriority.NeverOverflow
+					}),
+					press: function () {
+						this.fireBookmarkIconPress();
+					}.bind(this)
+				}).addStyleClass("sapUiDocSectionLinkIcon");
+			}
+			// Insert at index 1: after Title (0), before ToolbarSpacer (was 1, now shifts to 2).
+			// insertAggregation reparents the icon to the toolbar; the toolbar (child of this
+			// SubSection via _headerToolbar) then owns the icon lifecycle.
+			this._getHeaderToolbar()?.insertAggregation("content", this._oBookmarkIcon, 1);
+		} else if (this._oBookmarkIcon) {
+			// Remove from toolbar but keep the instance — re-inserted if showBookmarkIcon is set to true again
+			this._getHeaderToolbar()?.removeContent(this._oBookmarkIcon);
+		}
+
+		return this;
+	};
+
+	/**
+	 * Clean up the bookmark icon on control exit.
+	 * The icon may be detached from the toolbar (showBookmarkIcon=false) so we destroy it explicitly.
+	 * @override
+	 */
+	SDKObjectPageSubSection.prototype.exit = function () {
+		if (this._oBookmarkIcon) {
+			this._oBookmarkIcon.destroy();
+			this._oBookmarkIcon = null;
+		}
+		ObjectPageSubSection.prototype.exit?.apply(this, arguments);
+	};
+
+	// -----------------------------------------------------------------------
+	// Action aggregation overrides
+	// -----------------------------------------------------------------------
+
+	// Number of fixed toolbar slots when showBookmarkIcon=true:
+	// [Title(0), BookmarkIcon(1), ToolbarSpacer(2)] = 3
+	SDKObjectPageSubSection.NUMBER_OF_ADDITIONAL_ACTIONS_BOOKMARKABLE = 3;
+
+	/**
+	 * Returns the number of fixed toolbar slots before user-added actions.
+	 * Overrides the base to account for the optional bookmark icon slot.
+	 * @returns {int}
+	 * @override
+	 */
+	SDKObjectPageSubSection.prototype._getActionsOffset = function () {
+		return this.getShowBookmarkIcon()
+			? SDKObjectPageSubSection.NUMBER_OF_ADDITIONAL_ACTIONS_BOOKMARKABLE
+			: ObjectPageSubSection.NUMBER_OF_ADDITIONAL_ACTIONS;
+	};
+
+	// -----------------------------------------------------------------------
+	// Grid override - replace with simple Container
+	// -----------------------------------------------------------------------
+
 	var Container = Control.extend("sap.ui.documentation.Container", {
 		metadata: {
 			library: "sap.ui.documentation",
@@ -37,19 +135,20 @@ sap.ui.define([
 			apiVersion: 2,
 
 			render: function (oRm, oControl) {
-			var aContent = oControl.getContent(),
-				iLen,
-				i;
+				var aContent = oControl.getContent(),
+					iLen,
+					i;
 
-			oRm.openStart("div", oControl).openEnd();
+				oRm.openStart("div", oControl).openEnd();
 
-			for (i = 0, iLen = aContent.length; i < iLen; i++) {
-				oRm.renderControl(aContent[i]);
-			}
+				for (i = 0, iLen = aContent.length; i < iLen; i++) {
+					oRm.renderControl(aContent[i]);
+				}
 
-			oRm.close("div");
+				oRm.close("div");
+			}
 		}
-	}});
+	});
 
 	SDKObjectPageSubSection.prototype._getGrid = function () {
 		if (!this.getAggregation("_grid")) {
@@ -62,4 +161,4 @@ sap.ui.define([
 	};
 
 	return SDKObjectPageSubSection;
-});
+});