@openui5/sap.ui.documentation 1.103.1 → 1.106.0

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

@@ -18,7 +18,6 @@ sap.ui.define([
 	"sap/ui/core/HTML",
 	"sap/m/library",
 	"sap/base/Log",
-	"sap/base/util/UriParameters",
 	"sap/ui/core/Fragment",
 	"sap/ui/documentation/sdk/util/Resources",
 	"./config/sampleForwardingConfig",
@@ -36,7 +35,6 @@ sap.ui.define([
 	HTML,
 	mobileLibrary,
 	Log,
-	UriParameters,
 	Fragment,
 	ResourcesUtil,
 	sampleForwardingConfig,
@@ -95,11 +93,18 @@ 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.router.navTo("sample", {
 						entityId: sampleForwardingConfig[this._sId].entityId,
@@ -128,6 +133,8 @@ sap.ui.define([
 
 				// we need this property to navigate to API reference
 				this.entityId = this._sEntityId ? this._sEntityId : oSample.entityId;
+				// we need the lib name in order to fetch dependencies for the sample
+				this._sLib = oSample.library;
 
 				oModelData.sEntityId = this.entityId;
 
@@ -193,7 +200,7 @@ sap.ui.define([
 							this.getView().byId("apiRefButton").setVisible(bHasAPIReference);
 						}.bind(this));
 
-						this.oModel.setData(oModelData);
+						this.oModel.setData(oModelData, true);
 						this.appendPageTitle(this.getModel().getProperty("/name"));
 					}.bind(this))
 					.catch(function (oError) {
@@ -207,6 +214,43 @@ sap.ui.define([
 					});
 			},
 
+			/**
+			 * Handles redirection from DemoKit to the sample page, rather than loading it as an iFrame.
+			 * The 'dk-sample-standalone' query parameter must be in the URI to take effect.
+			 * @private
+			 */
+			_handleRedirect : function () {
+				this._initIframeURL();
+				this._applySearchParamValueToIframeURL('sap-ui-theme', this._sDefaultSampleTheme);
+				this.sIFrameUrl += "&dk-sample-standalone";
+				URLHelper.redirect(this.sIFrameUrl, false);
+			},
+
+			/**
+			 * Initializes the URL of the sample itself, loaded either in an iFrame or standalone.
+			 * @private
+			 */
+			_initIframeURL : function () {
+				var sSampleOrigin = ResourcesUtil.getConfig(),
+					sSampleVersion = ResourcesUtil.getResourcesVersion(),
+					sSampleSearchParams = "";
+
+				// Assigning allowed query parameters from Demo Kit URL
+				ALLOWLIST_SAMPLES_SEARCH_PARAMS.forEach(function (oParam, index) {
+					if (new URL(document.location.href).searchParams.get(oParam)) {
+						sSampleSearchParams += (sSampleSearchParams === "" ? "?" : "&") + oParam + "=" + new URL(document.location.href).searchParams.get(oParam);
+					}
+				});
+
+				sSampleSearchParams = (sSampleSearchParams === "" ? "?" : sSampleSearchParams + "&") +
+					"sap-ui-xx-sample-id=" + this._sId
+					+ "&sap-ui-xx-sample-lib=" + (this._sLib || "")
+					+ "&sap-ui-xx-sample-origin=" + sSampleOrigin + sSampleVersion
+					+ "&sap-ui-xx-dk-origin=" + window.location.origin;
+
+				this.sIFrameUrl = ResourcesUtil.getResourceOrigin() + "/resources/sap/ui/documentation/sdk/index.html" + sSampleSearchParams;
+			},
+
 			/**
 			 * Opens the View settings dialog
 			 * @public
@@ -300,7 +344,7 @@ sap.ui.define([
 
 			_saveLocalSettings: function(sTheme, sDensityMode, bRTL) {
 				var sDensityMode = this._presetDensity(sDensityMode);
-				this.getView().getModel().setData({
+				this.oModel.setData({
 					theme: sTheme,
 					rtl: bRTL,
 					density: sDensityMode
@@ -361,15 +405,21 @@ sap.ui.define([
 				this.getRouter().navTo("apiId", {id: this.entityId});
 			},
 
-			onNewTab : function () {
-				// this._applySearchParamValueToIframeURL('sap-ui-theme', this._sDefaultSampleTheme);
+			onNewTab: function () {
+				if (this.oModel.getProperty("/iframe")) {
+					URLHelper.redirect(this.sIFrameUrl, true);
+					return;
+				}
+
 				this.loadSampleSettings(function(eMessage){
 					this._applySearchParamValueToIframeURL('sap-ui-theme', eMessage.data.data.theme);
 					this._applySearchParamValueToIframeURL('sap-ui-rtl', eMessage.data.data.RTL);
 					this._applySearchParamValueToIframeURL('sap-ui-density', eMessage.data.data.density);
 				}.bind(this)).then(function(){
 					URLHelper.redirect(this.sIFrameUrl, true);
-				}.bind(this));
+				}.bind(this)).catch(function(err){
+					Log.error(err);
+				});
 			},
 
 			onPreviousSample: function (oEvent) {
@@ -429,88 +479,28 @@ sap.ui.define([
 
 			_createIframe : function () {
 				return new Promise(function (resolve, reject) {
-					var sSampleId = this._sId,
-					sIframePath = "",
-					rExtractFilename = /\/([^\/]*)$/,// extracts everything after the last slash (e.g. some/path/index.html -> index.html)
-					rStripUI5Ending = /\..+$/,// removes everything after the first dot in the filename (e.g. someFile.qunit.html -> .qunit.html)
-					aFileNameMatches,
-					sFileName,
-					sFileEnding,
-					vIframe;
 
 					this.fResolve = resolve;
 					this.fReject = reject;
-					var sSampleOrigin = (window['sap-ui-documentation-config'] && window['sap-ui-documentation-config'].demoKitResourceOrigin) || "",
-						sSampleVersion = ResourcesUtil.getResourcesVersion(),
-						sSampleSearchParams = "";
-
-					// Assigning allowed query parameters from Demo Kit URL
-					ALLOWLIST_SAMPLES_SEARCH_PARAMS.forEach(function(oParam, index){
-						if (new URL(document.location.href).searchParams.get(oParam)){
-							sSampleSearchParams += (sSampleSearchParams === "" ? "?" : "&") + oParam + "=" + new URL(document.location.href).searchParams.get(oParam);
-						}
-					});
 
-					sSampleSearchParams = (sSampleSearchParams === "" ? "?" : sSampleSearchParams + "&") +
-					"sap-ui-xx-sample-id=" + sSampleId
-					+ "&sap-ui-xx-sample-origin=" + sSampleOrigin + sSampleVersion
-					+ "&sap-ui-xx-dk-origin=" + window.location.origin;
-
-					this.sIFrameUrl = ResourcesUtil.getResourceOrigin() + "/resources/sap/ui/documentation/sdk/index.html" + sSampleSearchParams;
+					this._initIframeURL();
 
 					if (this._oHtmlControl) {
 						this._oHtmlControl.destroy();
 					}
 
-					var fnMessage =  function (eMessage) {
-						var oSettingsData = this.getView().getModel().getData();
-						if (eMessage.data.type === "INIT") {
-							if (eMessage.data.config && eMessage.data.config.sample && eMessage.data.config.sample.iframe) {
-								sSampleId = this._sId;
-								vIframe = eMessage.data.config.sample.iframe;
-								sIframePath = this._resolveIframePath(sSampleId, vIframe);
-
-								//vlaid only for samples that contains own index.html
-								// strip the file extension to be able to use jQuery.sap.getModulePath
-								aFileNameMatches = rExtractFilename.exec(vIframe);
-								sFileName = (aFileNameMatches && aFileNameMatches.length > 1 ? aFileNameMatches[1] : vIframe);
-								sFileEnding = rStripUI5Ending.exec(sFileName)[0];
-								var sIframeWithoutUI5Ending = sFileName.replace(rStripUI5Ending, "");
-
-								// combine namespace with the file name again
-								this.sIFrameUrl = (sap.ui.require.toUrl((sIframePath + "/" + sIframeWithoutUI5Ending).replace(/\./g, "/")) + sFileEnding || ".html")
-								+ "?sap-ui-theme=" + sap.ui.getCore().getConfiguration().getTheme();
-								this._oHtmlControl.getDomRef().src = this.sIFrameUrl;
-							}
-							this._oHtmlControl.getDomRef().contentWindow.postMessage({
-								type: "SETTINGS",
-								reason: "set",
-								data: {
-									"density": oSettingsData.density,
-									"RTL": oSettingsData.rtl,
-									"theme": oSettingsData.theme
-								}
-							}, this.getOwnerComponent()._sSampleIframeOrigin);
-							this.fResolve(eMessage.data.config.sample);
-						} else if (eMessage.data.type === "ERR") {
-							this.fReject(eMessage.data.data.msg);
-						} else if (eMessage.data.type === "RTA") {
-							this._loadRTA.call(this);
-						}
-					}.bind(this);
-
 					this._oHtmlControl = new HTML({
 						id : "sampleFrame",
 						content : '<iframe src="' + this.sIFrameUrl + '" id="sampleFrame" frameBorder="0"></iframe>'
 					}).addEventDelegate({
 						onBeforeRendering: function () {
-							window.removeEventListener("message", fnMessage);
-						}
+							window.removeEventListener("message", this.onMessage.bind(this));
+						}.bind(this)
 					})
 					.addEventDelegate({
 						onAfterRendering: function () {
-							window.addEventListener("message", fnMessage);
-						}
+							window.addEventListener("message",this.onMessage.bind(this));
+						}.bind(this)
 					});
 
 					this.byId("page").removeAllContent();
@@ -519,6 +509,72 @@ sap.ui.define([
 				}.bind(this));
 			},
 
+			onMessage: function(eMessage) {
+				if (eMessage.origin !== this.getOwnerComponent()._sSampleIframeOrigin) {
+					return;
+				}
+				if (eMessage.source !== this._oHtmlControl.getDomRef().contentWindow) {
+					return;
+				}
+
+				if (eMessage.data.type === "INIT") {
+					this.fnMessageInit(eMessage);
+				} else if (eMessage.data.type === "ERR") {
+					this.fnMessageError(eMessage);
+				} else if (eMessage.data.type === "LOAD") {
+					this.fnMessageLoad(eMessage);
+				} else if (eMessage.data.type === "RTA") {
+					this._loadRTA.call(this);
+				}
+			},
+
+			fnMessageInit: function(eMessage) {
+				var sSampleId,
+					sIframePath = "",
+					rExtractFilename = /\/([^\/]*)$/,// extracts everything after the last slash (e.g. some/path/index.html -> index.html)
+					rStripUI5Ending = /\..+$/,// removes everything after the first dot in the filename (e.g. someFile.qunit.html -> .qunit.html)
+					aFileNameMatches,
+					sFileName,
+					sFileEnding,
+					vIframe,
+					oSettingsData = this.oModel.getData();
+
+				if (eMessage.data.config && eMessage.data.config.sample && eMessage.data.config.sample.iframe) {
+					sSampleId = this._sId;
+					vIframe = eMessage.data.config.sample.iframe;
+					sIframePath = this._resolveIframePath(sSampleId, vIframe);
+
+					//vlaid only for samples that contains own index.html
+					// strip the file extension to be able to use jQuery.sap.getModulePath
+					aFileNameMatches = rExtractFilename.exec(vIframe);
+					sFileName = (aFileNameMatches && aFileNameMatches.length > 1 ? aFileNameMatches[1] : vIframe);
+					sFileEnding = rStripUI5Ending.exec(sFileName)[0];
+					var sIframeWithoutUI5Ending = sFileName.replace(rStripUI5Ending, "");
+
+					// combine namespace with the file name again
+					this.sIFrameUrl = (sap.ui.require.toUrl((sIframePath + "/" + sIframeWithoutUI5Ending).replace(/\./g, "/")) + sFileEnding || ".html")
+					+ "?sap-ui-theme=" + sap.ui.getCore().getConfiguration().getTheme();
+					this._oHtmlControl.getDomRef().src = this.sIFrameUrl;
+				}
+				this._oHtmlControl.getDomRef().contentWindow.postMessage({
+					type: "SETTINGS",
+					reason: "set",
+					data: {
+						"density": oSettingsData.density,
+						"RTL": oSettingsData.rtl,
+						"theme": oSettingsData.theme
+					}
+				}, this.getOwnerComponent()._sSampleIframeOrigin);
+				this.fResolve(eMessage.data.config.sample);
+			},
+			fnMessageLoad: function() {
+				Log.info("Sample Iframe for sample " + this._sId + " is loaded");
+			},
+
+			fnMessageError: function(eMessage) {
+				this.fReject(eMessage.data.data.msg);
+			},
+
 			_createComponent : function () {
 
 				// create component only once
@@ -595,7 +651,7 @@ sap.ui.define([
 
 					oModelData.rtaLoaded = true;
 
-					this.oModel.setData(oModelData);
+					this.oModel.setData(oModelData, true);
 
 					this.getRouter().attachRouteMatched(function () {
 						if (this._oRTA) {

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

@@ -238,7 +238,7 @@ sap.ui.define([
 
 		_formatMockFile: function (sMockData) {
 			var sWrongPath = "test-resources/sap/ui/documentation/sdk/images/",
-				sCorrectPath = "https://openui5.hana.ondemand.com/test-resources/sap/ui/documentation/sdk/images/",
+				sCorrectPath = "https://sdk.openui5.org/test-resources/sap/ui/documentation/sdk/images/",
 				oRegExp = new RegExp(sWrongPath, "g");
 
 			return sMockData.replace(oRegExp, sCorrectPath);

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

@@ -6,6 +6,7 @@
 
 sap.ui.define([
 		"sap/ui/thirdparty/jquery",
+		"sap/ui/core/Fragment",
 		"sap/ui/documentation/sdk/controller/BaseController",
 		"sap/ui/documentation/sdk/util/ToggleFullScreenHandler",
 		"sap/ui/documentation/sdk/model/formatter",
@@ -23,7 +24,7 @@ sap.ui.define([
 		"sap/m/List",
 		"sap/ui/dom/includeStylesheet",
 		"sap/ui/dom/includeScript"
-	], function (jQuery, BaseController, ToggleFullScreenHandler,
+	], function (jQuery, Fragment, BaseController, ToggleFullScreenHandler,
 			formatter, Image, Label, Link, Text, HBox, ObjectAttribute, ObjectStatus, Popover,
 			library, coreLibrary, CustomListItem, List, includeStylesheet, includeScript) {
 		"use strict";
@@ -253,6 +254,24 @@ sap.ui.define([
 				}
 			},
 
+			onVisibilityInformationClick: function (oEvent) {
+				var oIcon = oEvent.getSource(),
+					oView = this.getView();
+
+				if (!this._oPopover) {
+					this._oPopover = Fragment.load({
+						name: "sap.ui.documentation.sdk.view.VisibilityInformation",
+						controller: this
+					}).then(function(oPopover) {
+						oView.addDependent(oPopover);
+						return oPopover;
+					});
+				}
+				this._oPopover.then(function(oPopover) {
+					oPopover.openBy(oIcon);
+				});
+			},
+
 			/* =========================================================== */
 			/* begin: internal methods									   aa*/
 			/* =========================================================== */

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

@@ -7,12 +7,12 @@
 sap.ui.define([
 	"./BaseController",
 	"sap/ui/thirdparty/jquery",
-	"sap/ui/thirdparty/URI",
+	"sap/ui/documentation/sdk/controller/util/URLUtil",
 	"sap/m/library"
 ], function (
 	BaseController,
 	jQuery,
-	URI,
+	DemokitURLUtil,
 	mLib
 ) {
 	"use strict";
@@ -44,22 +44,29 @@ sap.ui.define([
 		_onVersionInfo: function (oVersionInfo) {
 			var oMessagePage = this.getView().byId("page"),
 				oReadMoreBtn = this.getView().byId("readMoreButton"),
-				reVersion = new RegExp("^([0-9]+)(?:\\.([0-9]+)(?:\\.([0-9]+))?)?(.+)?"),
-				oURI = new URI(document.location.href),
-				aSegments = oURI.segment(),
-				sVersion,
+				sUrl = document.location.href,
+				sRedirectUrl,
+				sVersion = DemokitURLUtil.parseVersion(sUrl),
 				isRemoved = false;
 
 			oMessagePage.setBusy(false);
 
-			for (var i = 0, l = aSegments.length; i < l; i++) {
-				if (reVersion.test(aSegments[i])) {
-					sVersion = aSegments[i];
-					break;
-				}
+			isRemoved = this._isVersionRemoved(oVersionInfo, sVersion);
+
+			if (isRemoved && DemokitURLUtil.requestsDemokitView(sUrl)) {
+				// redirect to the latest (version-less) URL
+				sRedirectUrl = DemokitURLUtil.removeVersion(sUrl);
+				mLib.URLHelper.redirect(sRedirectUrl);
+				return;
 			}
 
-			isRemoved = this._isVersionRemoved(oVersionInfo, sVersion);
+			if (DemokitURLUtil.hasSEOOptimizedFormat(sUrl)) {
+				// 404 may be due to server not supporting SEO-optimized urls =>
+				// redirect to the corresponding non-optimized URL
+				sRedirectUrl = DemokitURLUtil.convertToNonSEOFormat(sUrl);
+				mLib.URLHelper.redirect(sRedirectUrl);
+				return;
+			}
 
 			if (isRemoved) {
 				// show removed message

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

@@ -8,8 +8,10 @@
 sap.ui.define([
 	"sap/ui/base/Object",
 	"sap/base/strings/capitalize",
-	"sap/base/util/merge"
-], function (BaseObject, capitalize, merge) {
+	"sap/ui/thirdparty/jquery",
+	"sap/ui/documentation/sdk/util/Resources",
+	"sap/base/Log"
+], function (BaseObject, capitalize, jQuery, ResourcesUtil, Log) {
 	"use strict";
 
 	return BaseObject.extend("sap.ui.documentation.sdk.controller.util.ConfigUtil", {
@@ -109,6 +111,23 @@ sap.ui.define([
 		destroy: function () {
 			this._oComponent = null;
 			return BaseObject.prototype.destroy.apply(this, arguments);
+		},
+
+		// Require the configuration file for static pages paths
+		_requireConfigJSON: function() {
+			return new Promise(function (resolve) {
+				jQuery.ajax(ResourcesUtil.getResourceOriginPath("/news-config.json"), {
+						type: "GET",
+						dataType: "JSON",
+					success : function(oResult) {
+						resolve(oResult);
+					},
+					error : function () {
+						Log.error("failed to load news-config.json");
+						resolve();
+					}
+				});
+			});
 		}
 	});
 });

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

@@ -140,6 +140,7 @@ sap.ui.define(["sap/ui/thirdparty/jquery", 'sap/ui/documentation/library', "sap/
 							Log.error("explored: cannot register sample '" + oSample.id + "'. missing 'name'");
 						} else {
 							data.samples[oSample.id] = oSample;
+							oSample.library = oDoc.library;
 						}
 					});
 

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

@@ -373,14 +373,19 @@ sap.ui.define([
 					oOption = null;
 				}
 
-				if (oOption && oOption.length > 0) {
+				if (oOption && oOption.is("p")) {
+					var sText = oOption.text();
+					if (aOptions.indexOf(sText) < 0) {
+						aOptions.push(sText);
+					}
+				} else if (oOption && oOption.length > 0) {
 					oOption.find('li').each(function (i, sOption) {
 						if (aOptions.indexOf(sOption.textContent) < 0) {
 							aOptions.push(sOption.textContent);
 						}
 					});
 				} else {
-					aOptions.push(sOption);
+					sOption && aOptions.push(sOption);
 				}
 
 			});
@@ -398,7 +403,7 @@ sap.ui.define([
 				that.API = this.api();
 
 				// Create new table row to append filters
-				var oTableHeader = $('#' + sId + ' thead'),
+				var oTableHeader = $('#' + sId + ' > thead'),
 					oNewTableRow = $('<tr/>'),
 					oFilterHeader,
 					oHighlighter,
@@ -449,7 +454,7 @@ sap.ui.define([
 								control: oFilter.control
 							});
 						});
-						oFilter.control.placeAt(oFilterHeader);
+						oFilter.control.placeAt(oFilterHeader[0]);
 					}
 
 					oNewTableRow.append(oFilterHeader);

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

@@ -32,7 +32,7 @@ sap.ui.define([
 			_oConfigUtilInstance = oConfigUtilInstance;
 			_sLocalStorageNewsName = _oConfigUtilInstance.LOCAL_STORAGE_NAMES[_sOldNewsLocalStorageKey];
 
-			return _requireConfigJSON()
+			return oConfigUtilInstance._requireConfigJSON()
 					.then(_requireFeedXML)
 					.then(_parseDateToLocaleString)
 					.then(_splitNewAndOldItems)
@@ -128,22 +128,6 @@ sap.ui.define([
 			Core.getEventBus().publish("newsChanged", "onDemoKitNewsChanged");
 		}
 
-		function _requireConfigJSON() {
-			return new Promise(function (resolve) {
-				jQuery.ajax(ResourcesUtil.getResourceOriginPath("/news-config.json"), {
-						type: "GET",
-						dataType: "JSON",
-					success : function(oResult) {
-						resolve(oResult);
-					},
-					error : function () {
-						Log.error("failed to load news-config.json");
-						resolve();
-					}
-				});
-			});
-		}
-
 		function _requireFeedXML(oJSON) {
 			return new Promise(function (resolve) {
 				jQuery.ajax(ResourcesUtil.getResourceOriginPath(oJSON.feedPath), {

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

@@ -58,7 +58,8 @@ sap.ui.define([],
 			{
 				"id": "liveEditor",
 				"text": "Live Editor",
-				"href": "liveEditor"
+				"href": "liveEditor",
+				"hideOnPhone": true
 			},
 			{
 				"id": "fioriTools",
@@ -68,12 +69,15 @@ sap.ui.define([],
 			{
 				"id": "flexibleProgrammingModelExplorer",
 				"text": "Flexible Programming Model Explorer",
-				"href": "https://sapui5.hana.ondemand.com/test-resources/sap/fe/core/fpmExplorer/index.html#/overview/introduction"
+				"href": "test-resources/sap/fe/core/fpmExplorer/index.html#/overview/introduction",
+				"isDistributionScope": true,
+				"hideOnPhone": true
 			},
 			{
 				"id": "accessibilityGuide",
 				"text": "Accessibility Guide",
-				"href": "test-resources/sap/m/demokit/accessibilityGuide/webapp/index.html"
+				"href": "test-resources/sap/m/demokit/accessibilityGuide/webapp/index.html",
+				"hideOnPhone": true
 			}
 		];
 

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

@@ -0,0 +1,121 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides reuse functionality for parsing and manipulating demokit urls
+sap.ui.define(["sap/ui/thirdparty/URI"], function(URI) {
+
+	"use strict";
+
+	var reVersion = new RegExp("^([0-9]+)(?:\\.([0-9]+)(?:\\.([0-9]+))?)?(.+)?"),
+		// 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\//,
+			/\/sitemap$/,
+			/^\/demoapps/,
+			/^\/tools/,
+			/^\/news\//,
+			/\/news$/,
+			/^\/search\//,
+			/^\/license[.]txt/,
+			/^\/docs\/guide/,
+			/^\/docs\/api\/symbols/
+		];
+
+	function pathMatchesDemokitRoute (path) {
+		return aDemokitPaths.some(function(regexp) {
+			return regexp.test(path);
+		});
+	}
+
+	return {
+		parseVersion: function(sUrl) {
+			var oURI = new URI(sUrl),
+				aSegments = oURI.segment(),
+				sVersion;
+
+			if (pathMatchesDemokitRoute(oURI.path())) {
+				return; // no version in path
+			}
+
+			for (var i = 0, l = aSegments.length; i < l; i++) {
+				if (reVersion.test(aSegments[i])) {
+					sVersion = aSegments[i];
+					break;
+				}
+				if (pathMatchesDemokitRoute("/" + aSegments[i] + "/")) {
+					break; // version not found
+				}
+			}
+			return sVersion;
+		},
+
+		removeVersion: function(sUrl) {
+			var oURI = new URI(sUrl),
+				sPath = oURI.path(),
+				sVersion = this.parseVersion(sUrl);
+
+			// remove the version string from <code>sPath</code>
+			if (sVersion) {
+				sPath = sPath.substring(sPath.indexOf(sVersion) + sVersion.length);
+				oURI.path(sPath);
+				return oURI.href();
+			}
+			return sUrl;
+		},
+
+		requestsDemokitView: function(sUrl) {
+			if (this.hasSEOOptimizedFormat(sUrl)) {
+				return true;
+			}
+
+			return pathMatchesDemokitRoute(new URI(sUrl).fragment());
+		},
+
+		hasSEOOptimizedFormat: function(sUrl) {
+			var sPath = new URI(sUrl).path();
+
+			if (pathMatchesDemokitRoute(sPath)) {
+				return true;
+			}
+
+			sUrl = this.removeVersion(sUrl);
+			sPath = new URI(sUrl).path();
+			return pathMatchesDemokitRoute(sPath);
+		},
+
+		convertToNonSEOFormat: function(sUrl) {
+			var oURI = new URI(sUrl),
+				sViewPath = new URI(this.removeVersion(sUrl)).path(),
+				sFragment = oURI.fragment(),
+				sNewPath,
+				sNewFragment;
+
+			// move the <code>sViewPath</code> from the URL path into the URL fragment:
+			sNewPath = oURI.path().replace(sViewPath, "/");
+			sNewFragment = sViewPath;
+
+			if (sFragment) {
+				// preserve any existing fragment part by appending at the end
+				sNewFragment += encodeURIComponent("#") + sFragment;
+			}
+
+			oURI.path(sNewPath);
+			oURI.fragment(sNewFragment);
+
+			return oURI.href();
+		}
+	};
+
+});