@ui5/webcomponents-localization 0.0.0-e818f286e → 0.0.0-ebd9a4db3

package/dist/sap/base/i18n/Localization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Localization.js","sourceRoot":"","sources":["../../../../src/sap/base/i18n/Localization.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG;IAC3B,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;CACV,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAE,EAAE;IAC/C,OAAO,mBAAmB,CAAC,SAA6C,CAAC,IAAI,SAAS,CAAC;AACxF,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG;IACpB,iBAAiB;CACjB,CAAC;AAEF,eAAe,YAAY,CAAC","sourcesContent":["const M_ISO639_OLD_TO_NEW = {\n\t\"iw\": \"he\",\n\t\"ji\": \"yi\",\n};\n\nconst getModernLanguage = (sLanguage: string) => {\n\treturn M_ISO639_OLD_TO_NEW[sLanguage as keyof typeof M_ISO639_OLD_TO_NEW] || sLanguage;\n};\n\nconst Localization = {\n\tgetModernLanguage,\n};\n\nexport default Localization;\n"]}

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

@@ -0,0 +1,43 @@
+/**
+ * The types of <code>Calendar</code>.
+ *
+ * @enum {string}
+ * @alias module:sap/base/i18n/date/CalendarType
+ * @public
+ * @since 1.120
+ */ /*!
+     * OpenUI5
+     * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+     * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+     */
+
+// Provides type module:sap/base/i18n/date/CalendarType.
+
+var CalendarType = {
+  /**
+   * The Gregorian calendar
+   * @public
+   */
+  Gregorian: "Gregorian",
+  /**
+   * The Islamic calendar
+   * @public
+   */
+  Islamic: "Islamic",
+  /**
+   * The Japanese emperor calendar
+   * @public
+   */
+  Japanese: "Japanese",
+  /**
+   * The Persian Jalali calendar
+   * @public
+   */
+  Persian: "Persian",
+  /**
+   * The Thai buddhist calendar
+   * @public
+   */
+  Buddhist: "Buddhist"
+};
+export default CalendarType;

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

@@ -0,0 +1,105 @@
+/**
+ * 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
+ * @alias module:sap/base/i18n/date/CalendarWeekNumbering
+ * @since 1.120
+ */ /*!
+     * OpenUI5
+     * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+     * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+     */
+
+// Provides type module:sap/base/i18n/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"
+};
+
+/**
+ * Returns an object containing the week configuration values for the given calendar week
+ * numbering algorithm.
+ *
+ * @param {module:sap/base/i18n/date/CalendarWeekNumbering} [sCalendarWeekNumbering=Default]
+ *   The calendar week numbering algorithm
+ * @returns {{firstDayOfWeek: 0|1|2|3|4|5|6, minimalDaysInFirstWeek: 1|2|3|4|5|6|7}|undefined}
+ *   The week configuration values or <code>undefined</code> if the given calendar week
+ *   numbering algorithm is "Default"
+ *
+ * @function
+ * @name module:sap/base/i18n/date/CalendarWeekNumbering.getWeekConfigurationValues
+ * @private
+ */
+Object.defineProperty(CalendarWeekNumbering, "getWeekConfigurationValues", {
+  // configurable : false,
+  // enumerable : false,
+  value: function (sCalendarWeekNumbering) {
+    switch (sCalendarWeekNumbering) {
+      case CalendarWeekNumbering.ISO_8601:
+        return {
+          firstDayOfWeek: 1,
+          minimalDaysInFirstWeek: 4
+        };
+      case CalendarWeekNumbering.MiddleEastern:
+        return {
+          firstDayOfWeek: 6,
+          minimalDaysInFirstWeek: 1
+        };
+      case CalendarWeekNumbering.WesternTraditional:
+        return {
+          firstDayOfWeek: 0,
+          minimalDaysInFirstWeek: 1
+        };
+      default:
+        return undefined;
+    }
+  }
+  // writable : false
+});
+export default CalendarWeekNumbering;

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

@@ -1,20 +1,93 @@
-import assert from '../assert.js';
+/*!
+ * 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);
+  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)]);
     }
-    aValues = aValues || [];
-    return sPattern.replace(rMessageFormat, function ($0, $1, $2, $3, offset) {
-        if ($1) {
-            return '\'';
-        } else if ($2) {
-            return $2.replace(/''/g, '\'');
-        } else if ($3) {
-            return String(aValues[parseInt($3)]);
-        }
-        throw new Error('formatMessage: pattern syntax error at pos. ' + offset);
-    });
+    // 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

@@ -1,17 +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 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,
+    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;