@openui5/sap.ui.documentation 1.131.1 → 1.132.1

package/src/sap/ui/documentation/sdk/index.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/documentation/sdk/manifest.json

@@ -401,44 +401,52 @@
 				"welcome": {
 					"viewName": "Welcome",
 					"viewLevel": 2,
-					"viewId": "welcome"
+					"viewId": "welcome",
+					"title": "home"
 				},
 				"controls": {
 					"viewName": "Controls",
 					"viewLevel": 2,
-					"viewId": "controls"
+					"viewId": "controls",
+					"title": "samples"
 				},
 				"controlsMaster": {
 					"viewName": "ControlsMaster",
 					"viewLevel": 1,
 					"viewId": "controlsMaster",
-					"controlAggregation": "masterPages"
+					"controlAggregation": "masterPages",
+					"title": "samples"
 				},
 				"group": {
 					"viewName": "Group",
 					"viewLevel": 2,
-					"viewId": "group"
+					"viewId": "group",
+					"title": "samples"
 				},
 				"entity": {
 					"viewName": "Entity",
 					"viewLevel": 2,
-					"viewId": "entity"
+					"viewId": "entity",
+					"title": "samples"
 				},
 				"sample": {
 					"viewName": "Sample",
 					"viewLevel": 2,
-					"viewId": "sample"
+					"viewId": "sample",
+					"title": "samples"
 				},
 				"code": {
 					"viewName": "Code",
 					"viewLevel": 2,
 					"viewId": "code",
-					"transition": "slide"
+					"transition": "slide",
+					"title": "samples"
 				},
 				"downloads": {
 					"viewName": "Downloads",
 					"viewLevel": 2,
-					"viewId": "downloads"
+					"viewId": "downloads",
+					"title": "demoApps"
 				},
 				"apiMaster": {
 					"viewName": "ApiMaster",
@@ -449,47 +457,56 @@
 				"demoApps": {
 					"viewName": "DemoApps",
 					"viewLevel": 2,
-					"viewId": "demoApps"
+					"viewId": "demoApps",
+					"title": "demoApps"
 				},
 				"resources": {
 					"viewName": "Resources",
 					"viewLevel": 2,
-					"viewId": "resources"
+					"viewId": "resources",
+					"title": "resources"
 				},
 				"news": {
 					"viewName": "News",
 					"viewLevel": 2,
-					"viewId": "news"
+					"viewId": "news",
+					"title": "home"
 				},
 				"BPSupport": {
 					"viewName": "BPSupport",
 					"viewLevel": 2,
-					"viewId": "BPSupport"
+					"viewId": "BPSupport",
+					"title": "home"
 				},
 				"apiDetailInitial": {
 					"viewName": "ApiDetailInitial",
 					"viewId": "apiDetailInitial",
-					"viewLevel": 2
+					"viewLevel": 2,
+					"title": "apiReference"
 				},
 				"apiDetail": {
 					"viewName": "ApiDetail",
 					"viewId": "apiDetail",
-					"viewLevel": 2
+					"viewLevel": 2,
+					"title": "apiReference"
 				},
 				"apiDetailDeprecated": {
 					"viewName": "ApiDetailDeprecated",
 					"viewId": "apiDetailDeprecated",
-					"viewLevel": 2
+					"viewLevel": 2,
+					"title": "apiReference"
 				},
 				"apiDetailExperimental": {
 					"viewName": "ApiDetailExperimental",
 					"viewId": "apiDetailExperimental",
-					"viewLevel": 2
+					"viewLevel": 2,
+					"title": "apiReference"
 				},
 				"apiDetailSince": {
 					"viewName": "ApiDetailSince",
 					"viewId": "apiDetailSince",
-					"viewLevel": 2
+					"viewLevel": 2,
+					"title": "apiReference"
 				},
 				"topicMaster": {
 					"viewName": "TopicMaster",
@@ -500,62 +517,74 @@
 				"topicDetailInitial": {
 					"viewName": "TopicDetailInitial",
 					"viewId": "topicDetailInitial",
-					"viewLevel": 2
+					"viewLevel": 2,
+					"title": "documentation"
 				},
 				"topicDetail": {
 					"viewName": "TopicDetail",
 					"viewId": "topicDetail",
-					"viewLevel": 2
+					"viewLevel": 2,
+					"title": "documentation"
 				},
 				"searchPage": {
 					"viewName": "SearchPage",
 					"viewId": "searchPage",
 					"viewLevel": 2,
-					"controlAggregation": "detailPages"
+					"controlAggregation": "detailPages",
+					"title": "home"
 				},
 				"sampleNotFound": {
-				  "viewName": "SampleNotFound",
-				  "viewId": "sampleNotFound"
+					"viewName": "SampleNotFound",
+					"viewId": "sampleNotFound",
+					"title": "samples"
 				},
 				"notFound": {
 					"viewName": "NotFound",
-					"viewId": "notFound"
+					"viewId": "notFound",
+					"title": "home"
 				},
 				"versionNotFound": {
 					"viewName": "VersionNotFound",
-					"viewId": "versionNotFound"
+					"viewId": "versionNotFound",
+					"title": "home"
 				},
 				"sitemap": {
 					"viewName": "Sitemap",
-					"viewId": "sitemap"
+					"viewId": "sitemap",
+					"title": "home"
 				},
 				"liveEditor": {
 					"viewName": "LiveEditor",
-					"viewId": "liveEditor"
+					"viewId": "liveEditor",
+					"title": "home"
 				},
 				"releaseNotes": {
 					"viewName": "ReleaseNotes",
 					"viewLevel": 2,
 					"viewId": "releaseNotes",
-					"controlAggregation": "detailPages"
+					"controlAggregation": "detailPages",
+					"title": "home"
 				},
 				"license": {
 					"viewName": "License",
 					"viewLevel": 2,
 					"viewId": "releaseNotes",
-					"controlAggregation": "detailPages"
+					"controlAggregation": "detailPages",
+					"title": "home"
 				},
 				"termsOfUse": {
 					"viewName": "TermsOfUse",
 					"viewLevel": 2,
 					"viewId": "termsOfUse",
-					"controlAggregation": "detailPages"
+					"controlAggregation": "detailPages",
+					"title": "home"
 				},
 				"versionInfo": {
 					"viewName": "VersionInfo",
 					"viewLevel": 2,
 					"viewId": "versionInfo",
-					"controlAggregation": "detailPages"
+					"controlAggregation": "detailPages",
+					"title": "home"
 				}
 			}
 		},

package/src/sap/ui/documentation/sdk/model/ExploreSettingsModel.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/documentation/sdk/model/formatter.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.
  */
 
@@ -362,6 +362,40 @@ sap.ui.define([
 					return sType;
 				}
 				return "api/" + sType.replace("[]", "");
+			},
+
+			stringify: function (oObject) {
+				return JSON.stringify(oObject, null, 2);
+			},
+			stringifyJSDocType: function (oObject, aTyoes, sType, bLinkEnabled) {
+				oObject = oFormatter.formatJSDocType(oObject, aTyoes, sType, bLinkEnabled);
+				return JSON.stringify(oObject, null, 2);
+			},
+			formatJSDocType: function (oObject, aTyoes, sType, bLinkEnabled) {
+				oObject ??= oFormatter.convertLegacyJSDocTypes(aTyoes, sType, bLinkEnabled);
+				return oObject;
+			},
+			convertLegacyJSDocTypes: function(aTypes, sType, bLinkEnabled) {
+				if (!aTypes && !sType) {
+					return;
+				}
+				aTypes || (aTypes = [{value: sType, linkEnabled: bLinkEnabled}]);
+				// try to get the old 'types' array and convert it to the new typeInfo structure
+				if ( Array.isArray(aTypes) ) {
+					const UI5Types = [];
+					const template = aTypes.map(({value, name, linkEnabled}) => {
+						const simpleType = value || name;
+						if ( linkEnabled ) {
+							UI5Types.push(simpleType);
+							return `\${${UI5Types.length - 1}}`;
+						}
+						return simpleType;
+					}).join(" | ");
+					return {
+						template,
+						UI5Types
+					};
+				}
 			}
 		};
 

package/src/sap/ui/documentation/sdk/model/libraryData.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/documentation/sdk/model/models.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/documentation/sdk/thirdparty/highlight.js/highlight.js

@@ -998,10 +998,10 @@ var hljs = (function () {
    * @param {string} message
    */
   const deprecated = (version, message) => {
-    if (seenDeprecations[`1.131.1/${message}`]) return;
+    if (seenDeprecations[`1.132.1/${message}`]) return;
 
-    console.log(`Deprecated as of 1.131.1. ${message}`);
-    seenDeprecations[`1.131.1/${message}`] = true;
+    console.log(`Deprecated as of 1.132.1. ${message}`);
+    seenDeprecations[`1.132.1/${message}`] = true;
   };
 
   /* eslint-disable no-throw-literal */

package/src/sap/ui/documentation/sdk/util/DocumentationRouter.js

@@ -1,7 +1,7 @@
 /* global hasher */
 /*!
  * 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.
  */
 // Provides a customized router class for the 'documentation' app.
@@ -9,10 +9,11 @@ sap.ui.define([
 	'sap/m/routing/Router',
 	'sap/ui/core/routing/History',
 	'sap/ui/thirdparty/hasher',
+	"sap/ui/documentation/sdk/util/Resources",
 	"sap/ui/documentation/sdk/controller/util/ControlsInfo",
 	"sap/ui/documentation/sdk/controller/util/URLUtil",
 	"sap/ui/thirdparty/URI"
-], function(Router, History, Hasher, ControlsInfo, URLUtil, URI) {
+], function(Router, History, Hasher, ResourcesUtil, ControlsInfo, URLUtil, URI) {
 	"use strict";
 
 	// We need to set the global hasher instance to not encode URL's. This is specific for the SDK
@@ -167,6 +168,7 @@ sap.ui.define([
 
 				oApp.addPage(oView, master);
 				oApp.toDetail(oView.getId(), "show", data);
+				this.fireEvent("_navToWithoutHash", { viewName, viewType, master, data });
 			}.bind(this));
 		},
 
@@ -397,9 +399,8 @@ sap.ui.define([
 	 * @returns {object} Demo Kit custom object
 	 * @private
 	 */
-	DocumentationRouter.prototype._decodeSpecialRouteArguments = function (oEvent) {
-		var oArguments = oEvent.getParameters().arguments,
-			aEntity = [],
+	DocumentationRouter.prototype._decodeSpecialRouteArguments = function (oArguments) {
+		var aEntity = [],
 			sMemberType,
 			aMember = [],
 			aTemp;
@@ -485,6 +486,52 @@ sap.ui.define([
 
 	};
 
+	DocumentationRouter.prototype._decodeDocumentationRouteArguments = function (oArguments) {
+		var sId = decodeURIComponent(oArguments.id),
+			aUrlParts = sId.split("#"),
+			sTopicId = aUrlParts[0],
+			sSubTopicId = oArguments.subId || aUrlParts[1],
+			oOptions = oArguments["?options"];
+
+		return {
+			topicId: sTopicId.replace(".html", ""),
+			subTopicId: sSubTopicId,
+			options: oOptions,
+			topicURL: ResourcesUtil.getResourceOriginPath(this.getAppConfig().docuPath + sTopicId + (sTopicId.match(/\.html/) ? "" : ".html"))
+		};
+	};
+
+	DocumentationRouter.prototype.getAppConfig = function () {
+		if (!this._oAppConfig) {
+			this._oAppConfig = this._getOwnerComponent().getConfig();
+		}
+		return this._oAppConfig;
+	};
+
+	DocumentationRouter.prototype.getConfig = function () {
+		return this._getOwnerComponent().getManifestEntry("/sap.ui5/routing");
+	};
+
+	DocumentationRouter.prototype.getRouteConfig = function (sRouteName) {
+		return this.getConfig().routes.find((oRouteConfig) => oRouteConfig.name === sRouteName);
+	};
+
+	DocumentationRouter.prototype.getTargetConfig = function (sTargetName) {
+		return this.getConfig().targets[sTargetName];
+	};
+
+	DocumentationRouter.prototype.getRouteTopLevelTitle = function(oRouteConfig) {
+		var sTarget = oRouteConfig.titleTarget || this._getLastTargetForRoute(oRouteConfig);
+		return this.getTargetConfig(sTarget)?.title; // the title is the title of the corresponding top-level tab
+	};
+
+	DocumentationRouter.prototype._getLastTargetForRoute = function(oRouteConfig) {
+		var aTargets = oRouteConfig.target;
+		if (aTargets && aTargets.length) {
+			return aTargets[aTargets.length - 1];
+		}
+	};
+
 	/**
 	 * @override
 	 */

package/src/sap/ui/documentation/sdk/util/FileUtils.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/documentation/sdk/util/LiveEditorOutput.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.
  */
 // Applies the html of a live-edited code-sample

package/src/sap/ui/documentation/sdk/util/Resources.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/documentation/sdk/util/ToggleFullScreenHandler.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/documentation/sdk/view/App.view.xml

@@ -128,6 +128,10 @@
 										icon="sap-icon://document-text"
 										text="{i18n>APP_INFORMATION_BTN_TERMS_OF_USE}"
 										visible="{versionData>/isOpenUI5}" />
+									<MenuItem
+										key="cookie_preferences"
+										icon="sap-icon://user-settings"
+										text="{i18n>APP_SETTINGS_DIALOG_COOKIE_PREFERENCES}" />
 									<MenuItem
 										key="terms_of_use"
 										icon="sap-icon://document-text"
@@ -319,7 +323,4 @@
 			</ScrollContainer>
 		</tnt:mainContents>
 	</tnt:ToolPage>
-	<core:HTML visible="{appView>/bShowTAConsent}"
-	content='&lt;div id="consent_blackbar"&gt;&lt;/div&gt;&lt;div id="teconsent"&gt;&lt;/div&gt;&lt;script async="async" src="https://consent.trustarc.com/notice?domain=ui5.sap.com&amp;c=teconsent&amp;gtm=1&amp;pcookie&amp;js=nj&amp;noticeType=bb&amp;pn=1-0&amp;privacypolicylink=https%3A%2F%2Fwww.sap.com%2Fabout%2Flegal%2Fprivacy.html&amp;text=true&amp;gtm=1" crossorigin&gt;&lt;/script&gt;'>
-	</core:HTML>
 </mvc:View>

package/src/sap/ui/documentation/sdk/view/Footer.fragment.xml

@@ -36,7 +36,7 @@
 								href="https://www.sap.com/corporate/en/legal/privacy.html"
 								target="_blank"/>
 						<Link
-								class="sapUiDocumentationFooterLink"
+								class="sapUiTinyMarginBottom sapUiLargeMarginEnd sapUiDocumentationFooterLink"
 								text="{i18n>FOOTER_TERMS}"
 								href="https://www.sap.com/corporate/en/legal/terms-of-use.html"
 								visible="{= !${versionData>/isOpenUI5} &amp;&amp; !${versionData>/isDevEnv} }"
@@ -48,11 +48,15 @@
 								visible="{versionData>/isOpenUI5}"
 								target="_blank"/>
 						<Link
-								class="sapUiDocumentationFooterLink"
+								class="sapUiTinyMarginBottom sapUiLargeMarginEnd sapUiDocumentationFooterLink"
 								text="{i18n>FOOTER_TERMS}"
 								href="TermsOfUse.txt"
 								visible="{versionData>/isOpenUI5}"
 								target="_blank"/>
+						<Link
+								class="sapUiDocumentationFooterLink"
+								text="{i18n>APP_SETTINGS_DIALOG_COOKIE_PREFERENCES}"
+								press="onEditCookiePreferencesRequest"/>
 					</items>
 				</FlexBox>
 			</items>

package/src/sap/ui/documentation/sdk/view/FooterMaster.fragment.xml

@@ -7,5 +7,6 @@
 		<tnt:NavigationListItem icon="sap-icon://locked" key="privacy" text="{i18n>APP_INFORMATION_BTN_PRIVACY}" />
 		<tnt:NavigationListItem icon="sap-icon://permission" text="{i18n>APP_INFORMATION_BTN_LICENSE}" key="license" visible="{versionData>/isOpenUI5}" />
 		<tnt:NavigationListItem icon="sap-icon://document-text" key="terms_of_use" text="{i18n>APP_INFORMATION_BTN_TERMS_OF_USE}" visible="{=!${versionData>/isOpenUI5}}" />
+		<tnt:NavigationListItem icon="sap-icon://user-settings" key="cookie_preferences" text="{i18n>APP_SETTINGS_DIALOG_COOKIE_PREFERENCES}" />
 	</tnt:NavigationList>
 </core:FragmentDefinition>

package/src/sap/ui/documentation/sdk/view/GlobalSearchPicker.fragment.xml

@@ -59,6 +59,15 @@
 					<core:CustomData key="category" value="entity" />
 				</customData>
 			</StandardListItem>
+			<StandardListItem
+					title="{i18n>SEARCH_SUGGESTIONS_EXTERNAL_SECTION_TITLE}"
+					counter="{searchData>/matches/ExternalLength}"
+					press="onSearchResultsSummaryPress"
+					type="Active">
+				<customData>
+					<core:CustomData key="category" value="external" />
+				</customData>
+			</StandardListItem>
 		</List>
 	</VBox>
 </core:FragmentDefinition>

package/src/sap/ui/documentation/sdk/view/SearchPage.view.xml

@@ -202,6 +202,50 @@
 					</op:ObjectPageSubSection>
  				</op:subSections>
 			</op:ObjectPageSection>
+			<op:ObjectPageSection id="external" title="{
+				parts: [
+						'i18n>SEARCH_PAGE_EXTERNAL_SECTION_TITLE',
+						'searchData>/matches/ExternalLength'
+					],
+					formatter: '.formatMessage' 
+				}"
+				visible="{=!!${searchData>/matches/ExternalLength}}"
+				app:category="external">
+				<op:subSections>
+					<op:ObjectPageSubSection>
+						<op:blocks>
+							<VBox class="sapUxAPObjectPageSubSectionAlignContent" width="auto">
+								<OverflowToolbar design="Transparent" height="3rem">
+									<Title text="{
+										parts: [
+											'i18n>SEARCH_PAGE_EXTERNAL_SECTION_TABLE_TITLE',
+											'searchView>/visibleExternalLength',
+											'searchData>/matches/ExternalLength'
+										],
+										formatter: '.formatTableTitle'
+									}"/>
+								</OverflowToolbar>
+
+								<List
+									id="externalList"
+									growing="true"
+									growingThreshold="25"
+									updateFinished="onExternalLoadMore"
+									items="{
+										path: 'searchData>/matches/aDataExternal'
+									}">
+									<FeedListItem
+										sender="{searchData>title}"
+										text="{searchData>summary}"
+										showIcon="false"
+										app:path="{searchData>path}"
+										app:external="{searchData>external}"/>
+								</List>
+							</VBox>
+						</op:blocks>
+					</op:ObjectPageSubSection>
+				</op:subSections>
+			</op:ObjectPageSection>
 		</op:sections>
 	</op:ObjectPageLayout>
 </mvc:View>