@ui5/webcomponents-localization 0.0.0-037d08c67

package/dist/sap/base/i18n/date/TimezoneUtils.js

@@ -0,0 +1,319 @@
+/**
+ * Static collection of utility functions to handle time zone related conversions
+ *
+ * @author SAP SE
+ * @version 1.120.17
+ * @namespace
+ * @alias module:sap/base/i18n/date/TimezoneUtils
+ * @private
+ * @ui5-restricted sap.ui.core.Configuration, sap/base/i18n/format/DateFormat
+ */ /*!
+     * OpenUI5
+     * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+     * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+     */
+
+var TimezoneUtils = {};
+
+/**
+ * Cache for the (browser's) local IANA timezone ID
+ *
+ * @type {string}
+ */
+var sLocalTimezone = "";
+
+/**
+ * Cache for valid time zones provided by <code>Intl.supportedValuesOf("timeZone")</code>
+ *
+ * @type {Array}
+ */
+var aSupportedTimezoneIDs;
+
+/**
+ * Cache for Intl.DateTimeFormat instances
+ */
+var oIntlDateTimeFormatCache = {
+  _oCache: new Map(),
+  /**
+   * When cache limit is reached, it gets cleared
+   */
+  _iCacheLimit: 10,
+  /**
+   * Creates or gets an instance of Intl.DateTimeFormat.
+   *
+   * @param {string} sTimezone IANA timezone ID
+   * @returns {Intl.DateTimeFormat} Intl.DateTimeFormat instance
+   */
+  get: function (sTimezone) {
+    var cacheEntry = this._oCache.get(sTimezone);
+    if (cacheEntry) {
+      return cacheEntry;
+    }
+    var oOptions = {
+      hourCycle: "h23",
+      hour: "2-digit",
+      minute: "2-digit",
+      second: "2-digit",
+      fractionalSecondDigits: 3,
+      day: "2-digit",
+      month: "2-digit",
+      year: "numeric",
+      timeZone: sTimezone,
+      timeZoneName: 'short',
+      era: 'narrow',
+      weekday: "short"
+    };
+    var oInstance = new Intl.DateTimeFormat("en-US", oOptions);
+
+    // only store a limited number of entries in the cache
+    if (this._oCache.size === this._iCacheLimit) {
+      this._oCache = new Map();
+    }
+    this._oCache.set(sTimezone, oInstance);
+    return oInstance;
+  }
+};
+
+/**
+ * Uses the <code>Intl.supportedValuesOf('timeZone')</code> and <code>Intl.DateTimeFormat</code>
+ * API to check if the browser can handle the given IANA timezone ID.
+ * <code>Intl.supportedValuesOf('timeZone')</code> offers direct access to the list of supported
+ * time zones. It is not yet supported by all browsers but if it is supported and the given time
+ * zone is in the list it is faster than probing.
+ *
+ * <code>Intl.supportedValuesOf('timeZone')</code> does not return all IANA timezone IDs which
+ * the <code>Intl.DateTimeFormat</code> can handle, e.g. "Japan", "Etc/UTC".
+ *
+ * @param {string} sTimezone The IANA timezone ID which is checked, e.g <code>"Europe/Berlin"</code>
+ * @returns {boolean} Whether the time zone is a valid IANA timezone ID
+ * @private
+ * @ui5-restricted sap.ui.core.Configuration, sap.ui.core.format.DateFormat
+ */
+TimezoneUtils.isValidTimezone = function (sTimezone) {
+  if (!sTimezone) {
+    return false;
+  }
+  if (Intl.supportedValuesOf) {
+    try {
+      aSupportedTimezoneIDs = aSupportedTimezoneIDs || Intl.supportedValuesOf('timeZone');
+      if (aSupportedTimezoneIDs.includes(sTimezone)) {
+        return true;
+      }
+      // although not contained in the supportedValues it still can be valid, therefore continue
+    } catch (oError) {
+      // ignore error
+      aSupportedTimezoneIDs = [];
+    }
+  }
+  try {
+    oIntlDateTimeFormatCache.get(sTimezone);
+    return true;
+  } catch (oError) {
+    return false;
+  }
+};
+
+/**
+ * Converts a date to a specific time zone.
+ * The resulting date reflects the given time zone such that the "UTC" Date methods
+ * can be used, e.g. Date#getUTCHours() to display the hours in the given time zone.
+ *
+ * @example
+ * var oDate = new Date("2021-10-13T15:22:33Z"); // UTC
+ * // time zone difference UTC-4 (DST)
+ * TimezoneUtils.convertToTimezone(oDate, "America/New_York");
+ * // result is:
+ * // 2021-10-13 11:22:33 in America/New_York
+ * // same as new Date("2021-10-13T11:22:33Z"); // UTC
+ *
+ * @param {Date} oDate The date which should be converted.
+ * @param {string} sTargetTimezone The target IANA timezone ID, e.g <code>"Europe/Berlin"</code>
+ * @returns {Date} The new date in the target time zone.
+ * @private
+ * @ui5-restricted sap.ui.core.format.DateFormat, sap.ui.unified, sap.m
+ */
+TimezoneUtils.convertToTimezone = function (oDate, sTargetTimezone) {
+  var oFormatParts = this._getParts(oDate, sTargetTimezone);
+  return TimezoneUtils._getDateFromParts(oFormatParts);
+};
+
+/**
+ * Uses the <code>Intl.DateTimeFormat</code> API to convert a date to a specific time zone.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/formatToParts
+ * @param {Date} oDate The date which should be converted.
+ * @param {string} sTargetTimezone The target IANA timezone ID, e.g <code>"Europe/Berlin"</code>
+ * @returns {{
+ *     day: string,
+ *     era: string,
+ *     fractionalSecond: string,
+ *     hour: string,
+ *     minute: string,
+ *     month: string,
+ *     second: string,
+ *     timeZoneName: string,
+ *     weekday: string,
+ *     year: string
+ * }} An object containing the date and time fields considering the target time zone.
+ * @private
+ */
+TimezoneUtils._getParts = function (oDate, sTargetTimezone) {
+  var sKey,
+    oPart,
+    oDateParts = Object.create(null),
+    oIntlDate = oIntlDateTimeFormatCache.get(sTargetTimezone),
+    // clone the date object before passing it to the Intl API, to ensure that no
+    // UniversalDate gets passed to it;
+    // no need to use UI5Date.getInstance as only the UTC timestamp is used
+    oParts = oIntlDate.formatToParts(new Date(oDate.getTime()));
+  for (sKey in oParts) {
+    oPart = oParts[sKey];
+    if (oPart.type !== "literal") {
+      oDateParts[oPart.type] = oPart.value;
+    }
+  }
+  return oDateParts;
+};
+
+/**
+ * Creates a Date from the provided date parts.
+ *
+ * @param {object} oParts Separated date and time fields as object, see {@link #_getParts}.
+ * @returns {Date} Returns the date object created from the provided parts.
+ * @private
+ */
+TimezoneUtils._getDateFromParts = function (oParts) {
+  // no need to use UI5Date.getInstance as only the UTC timestamp is used
+  var oDate = new Date(0),
+    iUTCYear = parseInt(oParts.year);
+  if (oParts.era === "B") {
+    // The JS Date uses astronomical year numbering which supports year zero and negative
+    // year numbers.
+    // The Intl.DateTimeFormat API uses eras (no year zero and no negative year numbers).
+    // years around zero overview:
+    // | Astronomical | In Era
+    // |            2 | 2 Anno Domini (era: "A")
+    // |            1 | 1 Anno Domini (era: "A")
+    // |            0 | 1 Before Christ (era: "B")
+    // |           -1 | 2 Before Christ (era: "B")
+    // |           -2 | 3 Before Christ (era: "B")
+    // For the conversion to the JS Date the parts returned by the Intl.DateTimeFormat API
+    // need to be adapted.
+    iUTCYear = iUTCYear * -1 + 1;
+  }
+
+  // Date.UTC cannot be used here to be able to support dates before the UNIX epoch
+  oDate.setUTCFullYear(iUTCYear, parseInt(oParts.month) - 1, parseInt(oParts.day));
+  oDate.setUTCHours(parseInt(oParts.hour), parseInt(oParts.minute), parseInt(oParts.second), parseInt(oParts.fractionalSecond || 0)); // some older browsers don't support fractionalSecond, e.g. Safari < 14.1 */
+
+  return oDate;
+};
+
+/**
+ * Gets the offset to UTC in seconds for a given date in the time zone specified.
+ *
+ * For non-unique points in time, the daylight saving time takes precedence over the standard
+ * time shortly after the switch back (e.g. clock gets set back 1 hour, duplicate hour).
+ *
+ * @example
+ * var oDate = new Date("2021-10-13T13:22:33Z");
+ * TimezoneUtils.calculateOffset(oDate, "America/New_York");
+ * // => +14400 seconds (4 * 60 * 60 seconds)
+ *
+ * TimezoneUtils.calculateOffset(oDate, "Europe/Berlin");
+ * // => -7200 seconds (-2 * 60 * 60 seconds)
+ *
+ * // daylight saving time (2018 Sun, 25 Mar, 02:00	CET → CEST	+1 hour (DST start)	UTC+2h)
+ * // the given date is taken as it is in the time zone
+ * TimezoneUtils.calculateOffset(new Date("2018-03-25T00:00:00Z"), "Europe/Berlin");
+ * // => -3600 seconds (-1 * 60 * 60 seconds), interpreted as: 2018-03-25 00:00:00 (CET)
+ *
+ * TimezoneUtils.calculateOffset(new Date("2018-03-25T03:00:00Z"), "Europe/Berlin");
+ * // => -7200 seconds (-2 * 60 * 60 seconds)
+ *
+ * var oHistoricalDate = new Date("1800-10-13T13:22:33Z");
+ * TimezoneUtils.calculateOffset(oHistoricalDate, "Europe/Berlin");
+ * // => -3208 seconds (-3208 seconds)
+ *
+ * @param {Date} oDate The date in the time zone used to calculate the offset to UTC.
+ * @param {string} sTimezoneSource The source IANA timezone ID, e.g <code>"Europe/Berlin"</code>
+ * @returns {number} The difference to UTC between the date in the time zone.
+ * @private
+ * @ui5-restricted sap.ui.core.format.DateFormat
+ */
+TimezoneUtils.calculateOffset = function (oDate, sTimezoneSource) {
+  const oDateInTimezone = TimezoneUtils.convertToTimezone(oDate, sTimezoneSource);
+  const iGivenTimestamp = oDate.getTime();
+  const iInitialOffset = iGivenTimestamp - oDateInTimezone.getTime();
+  // no need to use UI5Date.getInstance as only the UTC timestamp is used
+  const oFirstGuess = new Date(iGivenTimestamp + iInitialOffset);
+  const oFirstGuessInTimezone = TimezoneUtils.convertToTimezone(oFirstGuess, sTimezoneSource);
+  const iFirstGuessInTimezoneTimestamp = oFirstGuessInTimezone.getTime();
+  const iSecondOffset = oFirstGuess.getTime() - iFirstGuessInTimezoneTimestamp;
+  let iTimezoneOffset = iSecondOffset;
+  if (iInitialOffset !== iSecondOffset) {
+    const oSecondGuess = new Date(iGivenTimestamp + iSecondOffset);
+    const oSecondGuessInTimezone = TimezoneUtils.convertToTimezone(oSecondGuess, sTimezoneSource);
+    const iSecondGuessInTimezoneTimestamp = oSecondGuessInTimezone.getTime();
+    // if time is different, the given date/time does not exist in the target time zone (switch to Daylight
+    // Saving Time) -> take the offset for the greater date
+    if (iSecondGuessInTimezoneTimestamp !== iGivenTimestamp && iFirstGuessInTimezoneTimestamp > iSecondGuessInTimezoneTimestamp) {
+      iTimezoneOffset = iInitialOffset;
+    }
+  }
+  return iTimezoneOffset / 1000;
+};
+
+/**
+ * Map outdated IANA timezone IDs used in CLDR to correct and up-to-date IANA IDs as maintained in ABAP systems.
+ *
+ * @private
+	 */
+TimezoneUtils.mCLDR2ABAPTimezones = {
+  "America/Buenos_Aires": "America/Argentina/Buenos_Aires",
+  "America/Catamarca": "America/Argentina/Catamarca",
+  "America/Cordoba": "America/Argentina/Cordoba",
+  "America/Jujuy": "America/Argentina/Jujuy",
+  "America/Mendoza": "America/Argentina/Mendoza",
+  "America/Indianapolis": "America/Indiana/Indianapolis",
+  "America/Louisville": "America/Kentucky/Louisville",
+  "Africa/Asmera": "Africa/Asmara",
+  "Asia/Katmandu": "Asia/Kathmandu",
+  "Asia/Calcutta": "Asia/Kolkata",
+  "Atlantic/Faeroe": "Atlantic/Faroe",
+  "Pacific/Ponape": "Pacific/Pohnpei",
+  "Asia/Rangoon": "Asia/Yangon",
+  "Pacific/Truk": "Pacific/Chuuk",
+  "America/Godthab": "America/Nuuk",
+  "Asia/Saigon": "Asia/Ho_Chi_Minh",
+  "America/Coral_Harbour": "America/Atikokan"
+};
+
+/**
+ * Retrieves the browser's local IANA timezone ID; if the browser's timezone ID is not the up-to-date IANA
+ * timezone ID, the corresponding IANA timezone ID is returned.
+ *
+ * @returns {string} The local IANA timezone ID of the browser as up-to-date IANA timezone ID,
+ *   e.g. <code>"Europe/Berlin"</code> or <code>"Asia/Kolkata"</code>
+ *
+ * @private
+ * @ui5-restricted sap.ui.core.Configuration,sap.m.DateTimeField
+ */
+TimezoneUtils.getLocalTimezone = function () {
+  if (sLocalTimezone === "") {
+    // timezone may be undefined, only value "" means empty cache
+    sLocalTimezone = new Intl.DateTimeFormat().resolvedOptions().timeZone;
+    sLocalTimezone = TimezoneUtils.mCLDR2ABAPTimezones[sLocalTimezone] || sLocalTimezone;
+  }
+  return sLocalTimezone;
+};
+
+/**
+ * Clears the cache for the browser's local IANA timezone ID.
+ *
+ * @private
+ */
+TimezoneUtils._clearLocalTimezoneCache = function () {
+  sLocalTimezone = "";
+};
+export default TimezoneUtils;

package/dist/sap/base/strings/camelize.js

@@ -0,0 +1,30 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+var rCamelCase = /-(.)/ig;
+
+/**
+ * Transforms a hyphen separated string to a camel case string.
+ *
+ * @example
+ * sap.ui.require(["sap/base/strings/camelize"], function(camelize){
+ *      camelize("foo-bar"); // "fooBar"
+ * });
+ *
+ * @function
+ * @since 1.58
+ * @alias module:sap/base/strings/camelize
+ * @param {string} sString Hyphen separated string
+ * @returns {string} The transformed string
+ * @public
+ * @SecPassthrough {0|return}
+ */
+var fnCamelize = function (sString) {
+  return sString.replace(rCamelCase, function (sMatch, sChar) {
+    return sChar.toUpperCase();
+  });
+};
+export default fnCamelize;

package/dist/sap/base/strings/formatMessage.js

@@ -0,0 +1,93 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+import assert from "../assert.js";
+/**
+ * Pattern to analyze MessageFormat strings.
+ *
+ * Group 1: captures doubled single quotes within the string
+ * Group 2: captures quoted fragments within the string.
+ *            Note that java.util.MessageFormat silently forgives a missing single quote at
+ *            the end of a pattern. This special case is handled by the RegEx as well.
+ * Group 3: captures placeholders
+ *            Checks only for numerical argument index, any remainder is ignored up to the next
+ *            closing curly brace. Nested placeholders are not accepted!
+ * Group 4: captures any remaining curly braces and indicates syntax errors
+ *
+ *                    [-1] [----- quoted string -----] [------ placeholder ------] [--]
+ * @private
+ */
+var rMessageFormat = /('')|'([^']+(?:''[^']*)*)(?:'|$)|\{([0-9]+(?:\s*,[^{}]*)?)\}|[{}]/g;
+
+/**
+ * Creates a string from a pattern by replacing placeholders with concrete values.
+ *
+ * The syntax of the pattern is inspired by (but not fully equivalent to) the
+ * java.util.MessageFormat.
+ *
+ * Placeholders have the form <code>{ integer }</code>, where any occurrence of
+ * <code>{0}</code> is replaced by the value with index 0 in <code>aValues</code>,
+ * <code>{1}</code> by the value with index 1 in <code>aValues</code> etc.
+ *
+ * To avoid interpretation of curly braces as placeholders, any non-placeholder fragment
+ * of the pattern can be enclosed in single quotes. The surrounding single quotes will be
+ * omitted from the result. Single quotes that are not meant to escape a fragment and
+ * that should appear in the result, need to be doubled. In the result, only a single
+ * single quote will occur.
+ *
+ * Example: Pattern Strings
+ * <pre>
+ *  formatMessage("Say {0}",     ["Hello"]) -> "Say Hello"    // normal use case
+ *  formatMessage("Say '{0}'",   ["Hello"]) -> "Say {0}"      // escaped placeholder
+ *  formatMessage("Say ''{0}''", ["Hello"]) -> "Say 'Hello'"  // doubled single quote
+ *  formatMessage("Say '{0}'''", ["Hello"]) -> "Say {0}'"     // doubled single quote in quoted fragment
+ * </pre>
+ * In contrast to java.util.MessageFormat, format types or format styles are not supported.
+ * Everything after the argument index and up to the first closing curly brace is ignored.
+ * Nested placeholders (as supported by java.lang.MessageFormat for the format type choice)
+ * are not ignored but reported as a parse error.
+ *
+ * This method throws an Error when the pattern syntax is not fulfilled (e.g. unbalanced curly
+ * braces, nested placeholders or a non-numerical argument index).
+ *
+ * This method can also be used as a formatter within a binding. The first part of a composite binding
+ * will be used as pattern, the following parts as aValues. If there is only one value and this
+ * value is an array it will be handled like the default described above.
+ *
+ * @function
+ * @since 1.58
+ * @alias module:sap/base/strings/formatMessage
+ * @param {string} sPattern A pattern string in the described syntax
+ * @param {any[]} [aValues=[]] The values to be used instead of the placeholders.
+ * @returns {string} The formatted result string
+ * @SecPassthrough {*|return}
+ * @public
+ */
+var fnFormatMessage = function (sPattern, aValues) {
+  assert(typeof sPattern === "string" || sPattern instanceof String, "pattern must be string");
+  if (arguments.length > 2 || aValues != null && !Array.isArray(aValues)) {
+    aValues = Array.prototype.slice.call(arguments, 1);
+  }
+  aValues = aValues || [];
+  return sPattern.replace(rMessageFormat, function ($0, $1, $2, $3, offset) {
+    if ($1) {
+      // a doubled single quote in a normal string fragment
+      //   --> emit a single quote
+      return "'";
+    } else if ($2) {
+      // a quoted sequence of chars, potentially containing doubled single quotes again
+      //   --> emit with doubled single quotes replaced by a single quote
+      return $2.replace(/''/g, "'");
+    } else if ($3) {
+      // a welformed curly brace
+      //   --> emit the argument but ignore other parameters
+      return String(aValues[parseInt($3)]);
+    }
+    // e.g. malformed curly braces
+    //   --> throw Error
+    throw new Error("formatMessage: pattern syntax error at pos. " + offset);
+  });
+};
+export default fnFormatMessage;

package/dist/sap/base/util/LoaderExtensions.d.ts

@@ -0,0 +1,4 @@
+declare const LoaderExtensions: {
+    loadResource: (moduleName: string) => import("@ui5/webcomponents-base/dist/asset-registries/LocaleData.js").CLDRData;
+};
+export default LoaderExtensions;

package/dist/sap/base/util/LoaderExtensions.js

@@ -0,0 +1,14 @@
+import { getLocaleData } from "@ui5/webcomponents-base/dist/asset-registries/LocaleData.js";
+const loadResource = (moduleName) => {
+    const moduleFormat = moduleName.match(/sap\/ui\/core\/cldr\/(\w+)\.json/);
+    if (!moduleFormat) {
+        throw new Error(`Unknown module "${moduleName}"`);
+    }
+    const localeId = moduleFormat[1];
+    return getLocaleData(localeId);
+};
+const LoaderExtensions = {
+    loadResource,
+};
+export default LoaderExtensions;
+//# sourceMappingURL=LoaderExtensions.js.map

package/dist/sap/base/util/LoaderExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoaderExtensions.js","sourceRoot":"","sources":["../../../../src/sap/base/util/LoaderExtensions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6DAA6D,CAAC;AAE5F,MAAM,YAAY,GAAG,CAAC,UAAkB,EAAE,EAAE;IAC3C,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC1E,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG;IACxB,YAAY;CACZ,CAAC;AAEF,eAAe,gBAAgB,CAAC","sourcesContent":["import { getLocaleData } from \"@ui5/webcomponents-base/dist/asset-registries/LocaleData.js\";\n\nconst loadResource = (moduleName: string) => {\n\tconst moduleFormat = moduleName.match(/sap\\/ui\\/core\\/cldr\\/(\\w+)\\.json/);\n\tif (!moduleFormat) {\n\t\tthrow new Error(`Unknown module \"${moduleName}\"`);\n\t}\n\n\tconst localeId = moduleFormat[1];\n\treturn getLocaleData(localeId);\n};\n\nconst LoaderExtensions = {\n\tloadResource,\n};\n\nexport default LoaderExtensions;\n"]}

package/dist/sap/base/util/ObjectPath.d.ts

@@ -0,0 +1,4 @@
+declare const ObjectPath: {
+    set(): void;
+};
+export default ObjectPath;

package/dist/sap/base/util/ObjectPath.js

@@ -0,0 +1,6 @@
+// ObjectPath is accessing window which breaks SSR, hence the overlay
+const ObjectPath = {
+    set() { },
+};
+export default ObjectPath;
+//# sourceMappingURL=ObjectPath.js.map

package/dist/sap/base/util/ObjectPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectPath.js","sourceRoot":"","sources":["../../../../src/sap/base/util/ObjectPath.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,MAAM,UAAU,GAAG;IAClB,GAAG,KAAI,CAAC;CACR,CAAC;AAEF,eAAe,UAAU,CAAC","sourcesContent":["// ObjectPath is accessing window which breaks SSR, hence the overlay\n\nconst ObjectPath = {\n\tset() {},\n};\n\nexport default ObjectPath;\n"]}

package/dist/sap/base/util/Version.js

@@ -0,0 +1,157 @@
+// @evo-todo make it a simple object with immutable properties (Object.defineProperties)
+
+// -------------------------- VERSION -------------------------------------
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+var rVersion = /^[0-9]+(?:\.([0-9]+)(?:\.([0-9]+))?)?(.*)$/;
+
+/**
+ * Returns a Version instance created from the given parameters.
+ *
+ * This function can either be called as a constructor (using <code>new</code>) or as a normal function.
+ * It always returns an immutable Version instance.
+ *
+ * The parts of the version number (major, minor, patch, suffix) can be provided in several ways:
+ * <ul>
+ * <li>Version("1.2.3-SNAPSHOT")    - as a dot-separated string. Any non-numerical char or a dot followed
+ *                                    by a non-numerical char starts the suffix portion. Any missing major,
+ *                                    minor or patch versions will be set to 0.</li>
+ * <li>Version(1,2,3,"-SNAPSHOT")   - as individual parameters. Major, minor and patch must be integer numbers
+ *                                    or empty, suffix must be a string not starting with digits.</li>
+ * <li>Version([1,2,3,"-SNAPSHOT"]) - as an array with the individual parts. The same type restrictions apply
+ *                                    as before.</li>
+ * <li>Version(otherVersion)        - as a Version instance (cast operation). Returns the given instance instead
+ *                                    of creating a new one.</li>
+ * </ul>
+ *
+ * To keep the code size small, this implementation mainly validates the single string variant.
+ * All other variants are only validated to some degree. It is the responsibility of the caller to
+ * provide proper parts.
+ *
+ * @param {int|string|any[]|module:sap/base/util/Version} vMajor the major part of the version (int) or any of the single
+ *        parameter variants explained above.
+ * @param {int} iMinor the minor part of the version number
+ * @param {int} iPatch the patch part of the version number
+ * @param {string} sSuffix the suffix part of the version number
+ * @class Represents a version consisting of major, minor, patch version, and suffix, for example '1.2.7-SNAPSHOT'.
+ * @since 1.58
+ * @alias module:sap/base/util/Version
+ * @public
+ */
+function Version(vMajor, iMinor, iPatch, sSuffix) {
+  if (vMajor instanceof Version) {
+    // note: even a constructor may return a value different from 'this'
+    return vMajor;
+  }
+  if (!(this instanceof Version)) {
+    // act as a cast operator when called as function (not as a constructor)
+    return new Version(vMajor, iMinor, iPatch, sSuffix);
+  }
+  var m;
+  if (typeof vMajor === "string") {
+    m = rVersion.exec(vMajor);
+  } else if (Array.isArray(vMajor)) {
+    m = vMajor;
+  } else {
+    m = arguments;
+  }
+  m = m || [];
+  function norm(v) {
+    v = parseInt(v);
+    return isNaN(v) ? 0 : v;
+  }
+  vMajor = norm(m[0]);
+  iMinor = norm(m[1]);
+  iPatch = norm(m[2]);
+  sSuffix = String(m[3] || "");
+
+  /**
+   * Returns a string representation of this version.
+   *
+   * @return {string} a string representation of this version.
+   * @public
+   */
+  this.toString = function () {
+    return vMajor + "." + iMinor + "." + iPatch + sSuffix;
+  };
+
+  /**
+   * Returns the major version part of this version.
+   *
+   * @return {int} the major version part of this version
+   * @public
+   */
+  this.getMajor = function () {
+    return vMajor;
+  };
+
+  /**
+   * Returns the minor version part of this version.
+   *
+   * @return {int} the minor version part of this version
+   * @public
+   */
+  this.getMinor = function () {
+    return iMinor;
+  };
+
+  /**
+   * Returns the patch (or micro) version part of this version.
+   *
+   * @return {int} the patch version part of this version
+   * @public
+   */
+  this.getPatch = function () {
+    return iPatch;
+  };
+
+  /**
+   * Returns the version suffix of this version.
+   *
+   * @return {string} the version suffix of this version
+   * @public
+   */
+  this.getSuffix = function () {
+    return sSuffix;
+  };
+
+  /**
+   * Compares this version with a given one.
+   *
+   * The version with which this version should be compared can be given as a <code>sap/base/util/Version</code> instance,
+   * as a string (e.g. <code>v.compareto("1.4.5")</code>). Or major, minor, patch and suffix values can be given as
+   * separate parameters (e.g. <code>v.compareTo(1, 4, 5)</code>) or in an array (e.g. <code>v.compareTo([1, 4, 5])</code>).
+   *
+   * @return {int} 0, if the given version is equal to this version, a negative value if the given other version is greater
+   *               and a positive value otherwise
+   * @public
+   */
+  this.compareTo = function () {
+    var vOther = Version.apply(window, arguments);
+    /*eslint-disable no-nested-ternary */
+    return vMajor - vOther.getMajor() || iMinor - vOther.getMinor() || iPatch - vOther.getPatch() || (sSuffix < vOther.getSuffix() ? -1 : sSuffix === vOther.getSuffix() ? 0 : 1);
+    /*eslint-enable no-nested-ternary */
+  };
+}
+
+/**
+ * Checks whether this version is in the range of the given interval (start inclusive, end exclusive).
+ *
+ * The boundaries against which this version should be checked can be given as  <code>sap/base/util/Version</code>
+ * instances (e.g. <code>v.inRange(v1, v2)</code>), as strings (e.g. <code>v.inRange("1.4", "2.7")</code>)
+ * or as arrays (e.g. <code>v.inRange([1,4], [2,7])</code>).
+ *
+ * @param {string|any[]|module:sap/base/util/Version} vMin the start of the range (inclusive)
+ * @param {string|any[]|module:sap/base/util/Version} vMax the end of the range (exclusive)
+ * @return {boolean} <code>true</code> if this version is greater or equal to <code>vMin</code> and smaller
+ *                   than <code>vMax</code>, <code>false</code> otherwise.
+ * @public
+ */
+Version.prototype.inRange = function (vMin, vMax) {
+  return this.compareTo(vMin) >= 0 && this.compareTo(vMax) < 0;
+};
+export default Version;