@openui5/sap.ui.core 1.107.0 → 1.108.0

package/src/sap/ui/core/_UrlResolver.js

@@ -0,0 +1,139 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([
+	"sap/ui/thirdparty/URI"
+], function(URI) {
+	"use strict";
+
+	/**
+	 * Helper module that provides a set of functions to resolve bundle urls.
+	 *
+	 * @namespace
+	 * @alias module:sap/ui/core/_UrlResolver
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+	var _UrlResolver = {};
+
+	/**
+	 * Function that loops through the model config and resolves the bundle urls
+	 * of terminologies relative to the component, the manifest or relative to an URL.
+	 *
+	 * @example
+	 * {
+	 *   "oil": {
+	 *     "bundleUrl": "i18n/terminologies/oil.i18n.properties"
+	 *   },
+	 *   "retail": {
+	 *     "bundleName": "i18n.terminologies.retail.i18n.properties"
+	 *   }
+	 * }
+	 *
+	 * @param {object} mBundleConfig Map with bundle config settings
+	 * @param {object} mSettings Map with settings for processing the resource configuration
+	 * @param {boolean} [mSettings.alreadyResolvedOnRoot=false] Whether the bundleUrl was already resolved (usually by the sap.ui.core.Component)
+	 * @param {URI} mSettings.baseURI The base URI of the Component (usually provided by the sap.ui.core.Component or sap.ui.core.Manifest)
+	 * @param {URI} mSettings.manifestBaseURI The base URI of the manifest (usually provided by the sap.ui.core.Component or sap.ui.core.Manifest)
+	 * @param {string} [mSettings.relativeTo="component"] Either "component", "manifest" or a "library path" to which the bundleUrl should be resolved
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+	_UrlResolver._processResourceConfiguration = function (mBundleConfig, mSettings) {
+		mSettings = mSettings || {};
+
+		var bAlreadyResolvedOnRoot = mSettings.alreadyResolvedOnRoot || false;
+		var sRelativeTo = mBundleConfig.bundleUrlRelativeTo || mSettings.relativeTo;
+		var vRelativeToURI;
+
+		if (sRelativeTo === "manifest") {
+			vRelativeToURI = mSettings.manifestBaseURI;
+		} else if (sRelativeTo === "component") {
+			vRelativeToURI = mSettings.baseURI;
+		} else {
+			// relative to library path or undefined; default (component base uri)
+			vRelativeToURI = sRelativeTo || mSettings.baseURI;
+		}
+
+		Object.keys(mBundleConfig).forEach(function(sKey) {
+			if (sKey === "bundleUrl" && !bAlreadyResolvedOnRoot) {
+				var sBundleUrl = mBundleConfig[sKey];
+				var oResolvedUri = _UrlResolver._resolveUri(sBundleUrl, vRelativeToURI);
+				mBundleConfig[sKey] = oResolvedUri && oResolvedUri.toString();
+			}
+			if (sKey === "terminologies") {
+				var mTerminologies = mBundleConfig[sKey];
+				for (var sTerminology in mTerminologies) {
+					_UrlResolver._processResourceConfiguration(mTerminologies[sTerminology], {
+						relativeTo: sRelativeTo,
+						baseURI: mSettings.baseURI,
+						manifestBaseURI: mSettings.manifestBaseURI
+					});
+				}
+			}
+			if (sKey === "enhanceWith") {
+				var aEnhanceWith = mBundleConfig[sKey] || [];
+				for (var i = 0; i < aEnhanceWith.length; i++) {
+					_UrlResolver._processResourceConfiguration(aEnhanceWith[i], {
+						relativeTo: sRelativeTo,
+						baseURI: mSettings.baseURI,
+						manifestBaseURI: mSettings.manifestBaseURI
+					});
+				}
+			}
+		});
+	};
+
+	/**
+	 * Makes sure that we can safely deal with URI instances.
+	 * See return value.
+	 *
+	 * @param {URI|string|undefined} v either a URI instance, a string value or undefined
+	 * @returns {URI} a URI instance created from the given argument, or the given argument if it is already a URI instance
+	 */
+	function normalizeToUri(v) {
+		if (v && v instanceof URI) {
+			return v;
+		}
+		return new URI(v);
+	}
+
+	/**
+	 * Resolves the given URI relative to the Component by default,
+	 * relative to the manifest when passing 'manifest'
+	 * or relative to URL path when passing an URL string as seceond
+	 * parameter.
+	 *
+	 * @param {URI|string} vUri URI to resolve
+	 * @param {URI|string} [vRelativeToURI] defines to which base URI the given URI will be resolved to.
+	 *                                      Either a string or a URI instance.
+	 *                                      Can be a component base URI, a manifest base URI or a library path.
+	 * @return {URI} resolved URI
+	 * @private
+	 */
+	_UrlResolver._resolveUri = function (vUri, vRelativeToURI) {
+		return _UrlResolver._resolveUriRelativeTo(normalizeToUri(vUri), normalizeToUri(vRelativeToURI));
+	};
+
+	/**
+	 * Resolves the given URI relative to the given base URI.
+	 *
+	 * @param {URI} oUri URI to resolve
+	 * @param {URI} oBase Base URI
+	 * @return {URI} resolved URI
+	 * @static
+	 * @private
+	 */
+	_UrlResolver._resolveUriRelativeTo = function(oUri, oBase) {
+		if (oUri.is("absolute") || (oUri.path() && oUri.path()[0] === "/")) {
+			return oUri;
+		}
+		var oPageBase = new URI(document.baseURI).search("");
+		oBase = oBase.absoluteTo(oPageBase);
+		return oUri.absoluteTo(oBase).relativeTo(oPageBase);
+	};
+
+	return _UrlResolver;
+});

package/src/sap/ui/core/date/CalendarUtils.js

@@ -0,0 +1,87 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides type sap.ui.core.date.CalendarUtils.
+sap.ui.define([
+	"sap/ui/core/date/CalendarWeekNumbering",
+	"sap/ui/core/Configuration",
+	"sap/ui/core/LocaleData"
+], function(
+	CalendarWeekNumbering,
+	Configuration,
+	LocaleData
+) {
+	"use strict";
+
+	var mWeekNumberingConfiguration = {
+			ISO_8601 : {
+				firstDayOfWeek : 1,
+				minimalDaysInFirstWeek : 4
+			},
+			MiddleEastern : {
+				firstDayOfWeek : 6,
+				minimalDaysInFirstWeek : 1
+			},
+			WesternTraditional : {
+				firstDayOfWeek : 0,
+				minimalDaysInFirstWeek : 1
+			}
+		};
+
+	/**
+	 * Provides calendar-related utilities.
+	 *
+	 * @namespace
+	 * @alias module:sap/ui/core/date/CalendarUtils
+	 * @public
+	 * @since 1.108.0
+	 */
+	var CalendarUtils = {
+
+		/**
+		 * Resolves calendar week configuration.
+		 *
+		 * Returns an object with the following fields:
+		 * <ul>
+		 *   <li><code>firstDayOfWeek</code>: specifies the first day of the week starting with
+		 *   <code>0</code> (which is Sunday)</li>
+		 *   <li><code>minimalDaysInFirstWeek</code>: minimal days at the beginning of the year
+		 *   which define the first calendar week</li>
+		 * </ul>
+		 *
+		 * @param {sap.ui.core.date.CalendarWeekNumbering} [sCalendarWeekNumbering=Default]
+		 *   The calendar week numbering; if omitted, <code>Default</code> is used.
+		 * @param {sap.ui.core.Locale} [oLocale]
+		 *   The locale to use; if not provided, this falls back to the format locale from the
+		 *   Configuration; see {@link sap.ui.core.Configuration.FormatSettings#getFormatLocale}.
+		 *   Is only used when <code>sCalendarWeekNumbering</code> is set to <code>Default</code>.
+		 * @returns {{firstDayOfWeek: int, minimalDaysInFirstWeek: int}|undefined}
+		 *   The calendar week configuration, or <code>undefined<code> for an invalid value of
+		 *   <code>sap.ui.core.date.CalendarWeekNumbering</code>.
+		 * @public
+		 * @since 1.108.0
+		 */
+		getWeekConfigurationValues : function (sCalendarWeekNumbering, oLocale) {
+			var oLocaleData;
+
+			if (mWeekNumberingConfiguration.hasOwnProperty(sCalendarWeekNumbering)) {
+				return mWeekNumberingConfiguration[sCalendarWeekNumbering];
+			}
+			sCalendarWeekNumbering = sCalendarWeekNumbering || CalendarWeekNumbering.Default;
+			if (sCalendarWeekNumbering === CalendarWeekNumbering.Default) {
+				oLocale = oLocale || Configuration.getFormatSettings().getFormatLocale();
+				oLocaleData = LocaleData.getInstance(oLocale);
+				return {
+					firstDayOfWeek : oLocaleData.getFirstDayOfWeek(),
+					minimalDaysInFirstWeek : oLocaleData.getMinimalDaysInFirstWeek()
+				};
+			}
+			return undefined;
+		}
+	};
+
+	return CalendarUtils;
+});

package/src/sap/ui/core/date/CalendarWeekNumbering.js

@@ -0,0 +1,73 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides type sap.ui.core.date.CalendarWeekNumbering.
+sap.ui.define([], function() {
+	"use strict";
+
+	/**
+	 * The <code>CalendarWeekNumbering</code> enum defines how to calculate calendar weeks. Each
+	 * value defines:
+	 * <ul>
+	 * <li>The first day of the week,</li>
+	 * <li>the first week of the year.</li>
+	 * </ul>
+	 *
+	 * @enum {string}
+	 * @public
+	 * @since 1.108.0
+	 * @alias sap.ui.core.date.CalendarWeekNumbering
+	 */
+	var CalendarWeekNumbering = {
+
+		/**
+		 * The default calendar week numbering:
+		 *
+		 * The framework determines the week numbering scheme; currently it is derived from the
+		 * active format locale. Future versions of UI5 might select a different week numbering
+		 * scheme.
+		 *
+		 * @public
+		 */
+		Default : "Default",
+
+		/**
+		 * Official calendar week numbering in most of Europe (ISO 8601 standard):
+		 * <ul>
+		 * <li>Monday is first day of the week,
+		 * <li>the week containing January 4th is first week of the year.
+		 * </ul>
+		 *
+		 * @public
+		 */
+		ISO_8601 : "ISO_8601",
+
+		/**
+		 * Official calendar week numbering in much of the Middle East (Middle Eastern calendar):
+		 * <ul>
+		 * <li>Saturday is first day of the week,
+		 * <li>the week containing January 1st is first week of the year.
+		 * </ul>
+		 *
+		 * @public
+		 */
+		MiddleEastern : "MiddleEastern",
+
+		/**
+		 * Official calendar week numbering in the United States, Canada, Brazil, Israel, Japan, and
+		 * other countries (Western traditional calendar):
+		 * <ul>
+		 * <li>Sunday is first day of the week,
+		 * <li>the week containing January 1st is first week of the year.
+		 * </ul>
+		 *
+		 * @public
+		 */
+		WesternTraditional : "WesternTraditional"
+	};
+
+	return CalendarWeekNumbering;
+}, /* bExport= */ true);