@openui5/sap.ui.documentation 1.120.7 → 1.121.0

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

@@ -5,12 +5,13 @@
  */
 
 sap.ui.define([
-		"sap/ui/documentation/sdk/controller/BaseController",
-		"sap/ui/model/json/JSONModel",
-		"sap/ui/thirdparty/URI",
-		"sap/uxap/ThrottledTaskHelper",
-		"sap/ui/core/Core"
-	], function (BaseController, JSONModel, URI, ThrottledTask, Core) {
+	"sap/ui/core/EventBus",
+	"sap/ui/core/Theming",
+	"sap/ui/documentation/sdk/controller/BaseController",
+	"sap/ui/model/json/JSONModel",
+	"sap/ui/thirdparty/URI",
+	"sap/uxap/ThrottledTaskHelper"
+], function(EventBus, Theming, BaseController, JSONModel, URI, ThrottledTask) {
 		"use strict";
 
 		var SRC_FILE_NAMES = {
@@ -77,7 +78,7 @@ sap.ui.define([
 				// throttle the output of src changes
 				this._oThrottledTask = null;
 
-				this.bus = Core.getEventBus();
+				this.bus = EventBus.getInstance();
 				this.bus.subscribe("themeChanged", "onDemoKitThemeChanged", this.onDemoKitThemeChanged, this);
 			},
 
@@ -168,7 +169,7 @@ sap.ui.define([
 				return {
 					src: oModulesToPost,
 					moduleNameToRequire: sInitModuleName,
-					activeTheme: Core.getConfiguration().getTheme().toLowerCase()
+					activeTheme: Theming.getTheme().toLowerCase()
 				};
 			},
 

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

@@ -5,13 +5,13 @@
  */
 
 sap.ui.define([
+		"sap/ui/core/EventBus",
 		"sap/ui/documentation/sdk/controller/BaseController",
 		'sap/ui/model/json/JSONModel',
 		"sap/ui/documentation/sdk/controller/util/NewsInfo",
-		"sap/ui/core/Core",
 		"sap/m/library"
 		],
-		function (BaseController, JSONModel, NewsInfo, Core, mobileLibrary) {
+		function (EventBus, BaseController, JSONModel, NewsInfo, mobileLibrary) {
 		'use strict';
 
 		return BaseController.extend('sap.ui.documentation.sdk.controller.News', {
@@ -23,7 +23,7 @@ sap.ui.define([
 
 				NewsInfo.prepareNewsData(this.getOwnerComponent().getConfigUtil());
 
-				Core.getEventBus().subscribe("newsChanged", "onDemoKitNewsChanged", this._syncModelWithNewsInfo, this);
+				EventBus.getInstance().subscribe("newsChanged", "onDemoKitNewsChanged", this._syncModelWithNewsInfo, this);
 			},
 
 			onAfterRendering: function() {

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

@@ -21,6 +21,8 @@ sap.ui.define([
 		return BaseController.extend("sap.ui.documentation.sdk.controller.ReleaseNotes", {
 
 			onInit: function() {
+				BaseController.prototype.onInit.call(this);
+
 				this._oView = this.getView();
 
 				// Async resource handling
@@ -33,9 +35,6 @@ sap.ui.define([
 
 				this._oView.setModel(this._oModel);
 				this._oView.setModel(this._oVersionModel, "select");
-
-				library._getAppInfo(this._processAppInfo.bind(this));
-
 			},
 			_processAppInfo: function (oAppInfo) {
 				var oVersion,
@@ -66,14 +65,15 @@ sap.ui.define([
 					items : []
 				};
 
-				while (iMinor >= 28) {
-					sVersion = iMajor + "." + iMinor;
-					oVersions.items.push({
-						key : sVersion,
-						value : sVersion
-					});
-					iMinor = iMinor - (iMinor <= 60 ? 2 : 1);
-				}
+				oVersions.items = this._oNeoAppVersions.reduce(function(result, oVersion) {
+					var sMajorMinorVersion = oVersion.target.version.split(".")[0] + "." + oVersion.target.version.split(".")[1];
+
+					if (!result.some((o) => o.key == sMajorMinorVersion)) {
+						result.push({ key: sMajorMinorVersion, value: sMajorMinorVersion });
+					}
+					return result;
+				}, []);
+
 				this._oVersionModel.setData(oVersions);
 
 				this.appendPageTitle(this.getModel("i18n").getProperty("RELEASE_NOTES_TITLE"));
@@ -81,7 +81,7 @@ sap.ui.define([
 			_processLibInfo: function (aLibs, oLibInfos) {
 				var iReleaseNotes,
 					aReturnLibs = [],
-					iLength = aLibs.length,
+					iLength = Array.isArray(aLibs) ? aLibs.length : 0,
 					fnProcessLib,
 					i;
 
@@ -126,6 +126,7 @@ sap.ui.define([
 						// Store needed data
 						this._oNeoAppVersions = oNeoAppJson[0].routes;
 						this._sSapUiVersion = oSapUiVersionJson[0].version;
+						library._getAppInfo(this._processAppInfo.bind(this));
 
 						// Make version select visible
 						this._oView.byId("VersionSelect").setVisible(true);

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

@@ -6,6 +6,9 @@
 
 
 sap.ui.define([
+	"sap/ui/core/Element",
+	"sap/ui/core/EventBus",
+	"sap/ui/core/Theming",
 	"sap/ui/documentation/sdk/controller/SampleBaseController",
 	"sap/ui/model/json/JSONModel",
 	"sap/ui/model/resource/ResourceModel",
@@ -18,13 +21,15 @@ sap.ui.define([
 	"sap/ui/core/HTML",
 	"sap/m/library",
 	"sap/base/Log",
-	"sap/ui/core/Core",
 	"sap/ui/core/Fragment",
 	"sap/ui/documentation/sdk/util/Resources",
 	"./config/sampleForwardingConfig",
 	"sap/base/strings/capitalize",
 	"sap/ui/core/Configuration"
 ], function(
+	Element,
+	EventBus,
+	Theming,
 	SampleBaseController,
 	JSONModel,
 	ResourceModel,
@@ -37,7 +42,6 @@ sap.ui.define([
 	HTML,
 	mobileLibrary,
 	Log,
-	Core,
 	Fragment,
 	ResourcesUtil,
 	sampleForwardingConfig,
@@ -81,7 +85,7 @@ sap.ui.define([
 
 				this.getView().setModel(this.oModel);
 
-				this.bus = Core.getEventBus();
+				this.bus = EventBus.getInstance();
 				this.setDefaultSampleTheme();
 				this.bus.subscribe("themeChanged", "onDemoKitThemeChanged", this.onDemoKitThemeChanged, this);
 
@@ -102,18 +106,12 @@ sap.ui.define([
 			 * @private
 			 */
 			_onSampleMatched: function (event) {
-				var bShouldRedirect = new URLSearchParams(window.location.search).has("dk-sample-standalone");
 
 				this._sId = event.getParameter("arguments").sampleId;
 				this._sEntityId = event.getParameter("arguments").entityId;
 
 				this.byId("page").setBusy(true);
 
-				// check whether to open sample standalone
-				if (bShouldRedirect) {
-					this._handleRedirect();
-				}
-
 				if (sampleForwardingConfig[this._sId]) {
 					return this.oRouter.navTo("sample", {
 						entityId: sampleForwardingConfig[this._sId].entityId,
@@ -127,7 +125,9 @@ sap.ui.define([
 			},
 
 			_loadSample: function(oData) {
-				var oPage = this._getPage(),
+				var searchParams = window.location.search,
+					bShouldRedirect = searchParams.includes("dk-sample-standalone"),
+					oPage = this._getPage(),
 					oModelData = this.oModel.getData(),
 					oSample = oData.samples[this._sId],
 					oSampleContext;
@@ -147,6 +147,12 @@ sap.ui.define([
 
 				oModelData.sEntityId = this.entityId;
 
+				// check whether to open sample standalone
+				if (bShouldRedirect) {
+					this._handleRedirect();
+				}
+
+
 				// If we are in a scenario without contexts - this is the case for tutorials
 				if (oSample.previousSampleId || oSample.nextSampleId) {
 					oModelData.previousSampleId = oSample.previousSampleId;
@@ -321,16 +327,16 @@ sap.ui.define([
 
 			applySampleSettings: function(eMessage) {
 				if (eMessage.data.type === "SETTINGS") {
-					var oThemeSelect = Core.byId("sample--ThemeSelect");
+					var oThemeSelect = Element.getElementById("sample--ThemeSelect");
 
 					// Theme select
 					oThemeSelect.setSelectedKey(eMessage.data.data.theme);
 
 					// RTL
-					Core.byId("sample--RTLSwitch").setState(eMessage.data.data.RTL);
+					Element.getElementById("sample--RTLSwitch").setState(eMessage.data.data.RTL);
 
 					// Density mode select
-					Core.byId("sample--DensityModeSwitch").setSelectedKey(this._presetDensity(eMessage.data.data.density, true));
+					Element.getElementById("sample--DensityModeSwitch").setSelectedKey(this._presetDensity(eMessage.data.data.density, true));
 
 				}
 			},
@@ -365,9 +371,9 @@ sap.ui.define([
 			},
 
 			handleSaveAppSettings: function () {
-				var	sDensityMode = Core.byId("sample--DensityModeSwitch").getSelectedKey(),
-					sTheme = Core.byId("sample--ThemeSelect").getSelectedKey(),
-					bRTL = Core.byId("sample--RTLSwitch").getState();
+				var	sDensityMode = Element.getElementById("sample--DensityModeSwitch").getSelectedKey(),
+					sTheme = Element.getElementById("sample--ThemeSelect").getSelectedKey(),
+					bRTL = Element.getElementById("sample--RTLSwitch").getState();
 
 				this._oSettingsDialog.close();
 
@@ -623,7 +629,7 @@ sap.ui.define([
 
 					// combine namespace with the file name again
 					this.sIFrameUrl = (sap.ui.require.toUrl((sIframePath + "/" + sIframeWithoutUI5Ending).replace(/\./g, "/")) + sFileEnding || ".html")
-					+ "?sap-ui-theme=" + Configuration.getTheme();
+					+ "?sap-ui-theme=" + Theming.getTheme();
 					this._oHtmlControl.getDomRef().src = this.sIFrameUrl;
 				}
 				this._oHtmlControl.getDomRef().contentWindow.postMessage({
@@ -671,7 +677,7 @@ sap.ui.define([
 			setDefaultSampleTheme: function() {
 				var sSampleVersion = ResourcesUtil.getResourcesVersion();
 				this._sDefaultSampleTheme = sSampleVersion && parseInt(sSampleVersion.slice(3,5)) < 68 ?
-					"sap_belize" : Configuration.getTheme();
+					"sap_belize" : Theming.getTheme();
 			},
 
 			onDemoKitThemeChanged: function(sChannelId, sEventId, oData) {

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

@@ -476,9 +476,26 @@ sap.ui.define([
 							}, true);
 						},
 						_getSubclassesBlock: function (oControlData, oEntityData) {
-							var aSubClasses = oEntityData.extendedBy || oEntityData.implementedBy,
+							var aSubClasses =
+									oEntityData.extendedBy ||
+									oEntityData.implementedBy,
+								fnFilterSubclassesByVisibility = function (aSubClasses) {
+									return aSubClasses.filter((oSubClassInfo) =>
+										this._aAllowedMembers.includes(
+											oSubClassInfo.visibility
+										)
+									);
+								}.bind(this),
+								fnGetSubclassesNames = function (aSubClasses) {
+									return aSubClasses.map(
+										(oSubClassInfo) => oSubClassInfo.name
+									);
+								},
 								oSubClassesLink;
 
+							if (aSubClasses && typeof aSubClasses[0] === "object") {
+								aSubClasses = fnGetSubclassesNames(fnFilterSubclassesByVisibility(aSubClasses));
+							}
 							this._aSubClasses = aSubClasses;
 
 							if (aSubClasses.length === 1) {

package/src/sap/ui/documentation/sdk/controller/util/APIInfo.js

@@ -20,6 +20,8 @@ sap.ui.define(["sap/ui/thirdparty/jquery",
 
 		function getIndexJsonPromise() {
 
+			var sApiInfoRootURL = window['sap-ui-documentation-config'] && window['sap-ui-documentation-config'].apiInfoRootURL;
+
 			if (oLibraryDataCache["index"]) {
 				return Promise.resolve(oLibraryDataCache["index"]);
 			}
@@ -27,7 +29,7 @@ sap.ui.define(["sap/ui/thirdparty/jquery",
 			return new Promise(function (resolve, reject) {
 				jQuery.ajax({
 					async: true,
-					url : ResourcesUtil.getResourceOriginPath("/docs/api/api-index.json"),
+					url : sApiInfoRootURL || ResourcesUtil.getResourceOriginPath("/docs/api/api-index.json"),
 					dataType : 'json',
 					success : function(vResponse) {
 						var aResult = vResponse.symbols || [];

package/src/sap/ui/documentation/sdk/controller/util/ControlsInfo.js

@@ -58,7 +58,8 @@ sap.ui.define(["sap/ui/thirdparty/jquery", 'sap/ui/documentation/library', "sap/
 					"Map",
 					"Utility",
 					"Web Components",
-					"Smart Controls"
+					"Smart Controls",
+					"Personalization"
 				];
 				var afilterProps = ["namespace", "since", "category"]; // content density are set manually
 				var oFilterSets = {

package/src/sap/ui/documentation/sdk/controller/util/NewsInfo.js

@@ -6,12 +6,12 @@
 
 // Provides reuse functionality for reading news from news RSS files
 sap.ui.define([
-		"sap/ui/core/Core",
+		"sap/ui/core/EventBus",
 		"sap/ui/thirdparty/jquery",
 		"sap/ui/documentation/sdk/util/Resources",
 		"sap/base/Log"
 	],
-	function(Core, jQuery, ResourcesUtil, Log) {
+	function(EventBus, jQuery, ResourcesUtil, Log) {
 		"use strict";
 
 		var _oNewsDataCache = {},
@@ -125,7 +125,7 @@ sap.ui.define([
 		}
 
 		function _publishNewsChangedEvent() {
-			Core.getEventBus().publish("newsChanged", "onDemoKitNewsChanged");
+			EventBus.getInstance().publish("newsChanged", "onDemoKitNewsChanged");
 		}
 
 		function _requireFeedXML(oJSON) {

package/src/sap/ui/documentation/sdk/controller/util/ThemePicker.js

@@ -5,9 +5,11 @@
  */
 
 sap.ui.define([
-	"sap/ui/core/Core"
+	"sap/ui/core/Core",
+	"sap/ui/core/EventBus"
 ], function(
-	Core
+	Core,
+	EventBus
 ) {
 	"use strict";
 
@@ -38,7 +40,7 @@ sap.ui.define([
 		this._oConfigUtil = oComponent.getOwnerComponent().getConfigUtil();
 		this._oCookieNames = this._oConfigUtil.COOKIE_NAMES;
 
-		this.bus = Core.getEventBus();
+		this.bus = EventBus.getInstance();
 
 		this._createConfigurationBasedOnURIInput();
 

package/src/sap/ui/documentation/sdk/controller/util/URLUtil.js

@@ -13,24 +13,24 @@ sap.ui.define(["sap/ui/thirdparty/URI"], function(URI) {
 		// compiling a single RegExp seems a less readable option
 		// so bellow are the patterns for individual Demokit sections
 		aDemokitPaths = [
-			/^\/controls/,
-			/^\/group/,
-			/^\/entity/,
-			/^\/sample/,
-			/^\/downloads/,
-			/^\/api/,
-			/^\/topic/,
-			/^\/liveEditor/,
-			/^\/sitemap\//,
+			/^(\/)?controls/,
+			/^(\/)?group/,
+			/^(\/)?entity/,
+			/^(\/)?sample/,
+			/^(\/)?downloads/,
+			/^(\/)?api/,
+			/^(\/)?topic/,
+			/^(\/)?liveEditor/,
+			/^(\/)?sitemap\//,
 			/\/sitemap$/,
-			/^\/demoapps/,
-			/^\/tools/,
-			/^\/news\//,
+			/^(\/)?demoapps/,
+			/^(\/)?tools/,
+			/^(\/)?news\//,
 			/\/news$/,
-			/^\/search\//,
-			/^\/license[.]txt/,
-			/^\/docs\/guide/,
-			/^\/docs\/api\/symbols/
+			/^(\/)?search\//,
+			/^(\/)?license[.]txt/,
+			/^(\/)?docs\/guide/,
+			/^(\/)?docs\/api\/symbols/
 		];
 
 	function pathMatchesDemokitRoute (path) {

package/src/sap/ui/documentation/sdk/cookieSettingsDialog/controller/CookieSettingsDialog.controller.js

@@ -5,12 +5,12 @@
  */
 
 sap.ui.define([
+		"sap/ui/core/Element",
 		"sap/ui/core/mvc/Controller",
 		"sap/ui/model/json/JSONModel",
 		"sap/ui/core/Fragment",
-		"sap/ui/model/resource/ResourceModel",
-		"sap/ui/core/Core"
-	], function (Controller, JSONModel, Fragment, ResourceModel, Core) {
+		"sap/ui/model/resource/ResourceModel"
+	], function (Element, Controller, JSONModel, Fragment, ResourceModel) {
 		"use strict";
 
 		return Controller.extend("sap.ui.documentation.sdk.cookieSettingsDialog.controller.CookieSettingsDialog", {
@@ -59,7 +59,7 @@ sap.ui.define([
 
 
 				oDialog.attachAfterOpen(function() {
-					Core.byId("btnSetPreferences").focus();
+					Element.getElementById("btnSetPreferences").focus();
 				});
 
 
@@ -90,7 +90,7 @@ sap.ui.define([
 			},
 
 			onSaveCookies: function() {
-				var bHasConsentRequiredCookies = Core.byId("requiredCookiesSwitch").getState();
+				var bHasConsentRequiredCookies = Element.getElementById("requiredCookiesSwitch").getState();
 
 				this._saveCookiePreference(this._oCookieNames.ALLOW_REQUIRED_COOKIES, bHasConsentRequiredCookies);
 
@@ -101,7 +101,7 @@ sap.ui.define([
 				this._oModel.setProperty("/showCookieDetails", true);
 				this._oCookieSettingsDialog.addStyleClass("cookiesDetailedView");
 
-				this._focusButton(Core.byId("btnSavePreferences"));
+				this._focusButton(Element.getElementById("btnSavePreferences"));
 			},
 
 			onCancelPress: function() {
@@ -120,12 +120,12 @@ sap.ui.define([
 				this._oModel.setProperty("/showCookieDetails", false);
 				this._oCookieSettingsDialog.removeStyleClass("cookiesDetailedView");
 
-				this._focusButton(Core.byId("btnSetPreferences"));
+				this._focusButton(Element.getElementById("btnSetPreferences"));
 			},
 
 			onCancelEditCookies: function() {
 				this._oCookieSettingsDialog.close();
-				Core.byId("requiredCookiesSwitch").setState(this._oCookiesUtil.getCookieValue(this._oCookieNames.ALLOW_REQUIRED_COOKIES) === "1");
+				Element.getElementById("requiredCookiesSwitch").setState(this._oCookiesUtil.getCookieValue(this._oCookieNames.ALLOW_REQUIRED_COOKIES) === "1");
 			},
 
 			_saveCookiePreference: function(sCookieName, bEnable) {

package/src/sap/ui/documentation/sdk/images/DemoApps_intro_card.svg

@@ -0,0 +1,8 @@
+<svg width="1400" height="187" viewBox="0 0 1400 187" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path opacity="0.6" d="M745.399 259.91C956.984 150.88 1024.8 -35.9502 1024.8 -35.9502C1024.8 -35.9502 1087.48 -176.01 1028.94 -309.863C1028.94 -309.863 1041.46 -142.559 660.574 35.1895C279.691 212.938 397.064 390.686 397.064 390.686C416.997 372.927 435.97 360.919 473.564 350.828C536.439 333.976 634.99 316.973 745.399 259.91Z" fill="white" fill-opacity="0.32"/>
+<path opacity="0.4" d="M756.297 337.155C919.792 337.155 1108.97 261.171 1202.58 91.4452C1217.21 64.957 1230.23 21.92 1236.74 -18.5944C1246.83 -83.1751 1248.09 -131.207 1236.18 -218.441C1236.18 -218.441 1205.2 -131.611 1024.8 -36.1523C959.202 -1.4906 875.386 33.1711 764.371 66.8741C334.238 197.398 397.315 390.484 397.315 390.484C465.085 345.833 465.488 337.155 756.297 337.155Z" fill="white" fill-opacity="0.32"/>
+<path opacity="0.2" d="M756.302 337.155C906.626 337.155 1110.99 345.631 1217.17 256.429C1282.26 201.889 1341.7 129.79 1342.81 19.902C1342.81 19.902 1253.75 78.6806 1202.58 91.2941C1131.94 108.751 1004.32 135.592 887.754 128.983C492.086 106.531 397.32 390.283 397.32 390.283C451.869 340.233 518.276 337.155 756.302 337.155Z" fill="white" fill-opacity="0.32"/>
+<path opacity="0.4" d="M745.397 259.91C956.982 150.88 1024.8 -35.9503 1024.8 -35.9503C959.202 -1.28862 875.386 33.3731 764.371 67.0761C334.238 197.6 397.315 390.686 397.315 390.686C417.247 372.926 436.221 360.918 473.814 350.828C536.437 333.976 634.988 316.973 745.397 259.91Z" fill="white" fill-opacity="0.32"/>
+<path d="M474.021 350.828C536.644 333.976 635.195 316.822 745.604 260.011C809.552 227.038 867.24 183.138 916.063 130.295C906.576 130.295 897.14 129.942 887.754 129.437C492.086 106.985 397.32 390.737 397.32 390.737C414.506 374.447 435.232 362.359 457.874 355.419C462.97 353.956 468.117 352.291 474.021 350.828Z" fill="white" fill-opacity="0.32"/>
+<path opacity="0.4" d="M2040.14 333.422C2040.14 133.12 2002.09 -31.4092 1939.22 -168.341C1945.22 -150.228 2066.88 230.244 1762.3 534.631C1588.41 708.495 1292.56 768.686 1054.68 578.576C1054.68 578.576 1084.96 1055.77 519.487 1126.15C150.261 1172.11 -140.295 936.898 -266.348 637.304C-354.049 428.93 -362.224 189.427 -261.806 -8.50313C-403.653 251.989 -350.113 569.242 -319.584 671.411C-171.329 1166.82 288.021 1527.86 831.692 1527.86C1495.31 1527.86 2040.14 996.938 2040.14 333.422Z" fill="white" fill-opacity="0.32"/>
+</svg>

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

@@ -123,7 +123,7 @@
                         var oContainer = new ComponentContainer({component : oComponent, height: "100%"})
                                 .placeAt("content");
 
-                        var bOpenStandalone = new URLSearchParams(window.location.search).has("dk-sample-standalone");
+                        var bOpenStandalone = window.location.search.includes("dk-sample-standalone");
                         // if dk-sample-standalone is used,
                         // display message for samples with own index.html
                         if (bOpenStandalone && oConfig.sample && oConfig.sample.iframe) {