@ui5/webcomponents-localization 2.26.0-rc.0 → 2.26.0-rc.1

package/dist/generated/assets/cldr/vi.json

@@ -6014,5 +6014,26 @@
 	"sap-calendarWeek": {
 		"narrow": "Tuần theo lịch {0}",
 		"wide": "Tuần theo lịch {0}"
+	},
+	"sap-datePlaceholder": "ví dụ: {0}",
+	"sap-fileSize": {
+		"Byte": "{0} Byte",
+		"Bytes": "{0} Byte",
+		"Kilobyte": "{0} KB",
+		"Megabyte": "{0} MB",
+		"Gigabyte": "{0} GB",
+		"Terabyte": "{0} TB",
+		"Petabyte": "{0} PB",
+		"Exabyte": "{0} EB",
+		"Zettabyte": "{0} ZB",
+		"Yottabyte": "{0} YB",
+		"Kibibyte": "{0} KiB",
+		"Mebibyte": "{0} MiB",
+		"Gibibyte": "{0} GiB",
+		"Tebibyte": "{0} TiB",
+		"Pebibyte": "{0} PiB",
+		"Exbibyte": "{0} EiB",
+		"Zebibyte": "{0} ZiB",
+		"Yobibyte": "{0} YiB"
 	}
 }

package/dist/generated/assets/cldr/zh_CN.json

@@ -5967,5 +5967,26 @@
 	"sap-calendarWeek": {
 		"narrow": "日历周 {0}",
 		"wide": "日历周 {0}"
+	},
+	"sap-datePlaceholder": "例如 {0}",
+	"sap-fileSize": {
+		"Byte": "{0} 字节",
+		"Bytes": "{0} 字节",
+		"Kilobyte": "{0} KB",
+		"Megabyte": "{0} MB",
+		"Gigabyte": "{0} GB",
+		"Terabyte": "{0} TB",
+		"Petabyte": "{0} PB",
+		"Exabyte": "{0} EB",
+		"Zettabyte": "{0} ZB",
+		"Yottabyte": "{0} YB",
+		"Kibibyte": "{0} KiB",
+		"Mebibyte": "{0} MiB",
+		"Gibibyte": "{0} GiB",
+		"Tebibyte": "{0} TiB",
+		"Pebibyte": "{0} PiB",
+		"Exbibyte": "{0} EiB",
+		"Zebibyte": "{0} ZiB",
+		"Yobibyte": "{0} YiB"
 	}
 }

package/dist/generated/assets/cldr/zh_HK.json

@@ -5975,5 +5975,26 @@
 	"sap-calendarWeek": {
 		"narrow": "曆週 {0}",
 		"wide": "曆週 {0}"
+	},
+	"sap-datePlaceholder": "例如 {0}",
+	"sap-fileSize": {
+		"Byte": "{0} 位元組",
+		"Bytes": "{0} 位元組",
+		"Kilobyte": "{0} KB",
+		"Megabyte": "{0} MB",
+		"Gigabyte": "{0} GB",
+		"Terabyte": "{0} TB",
+		"Petabyte": "{0} PB",
+		"Exabyte": "{0} EB",
+		"Zettabyte": "{0} ZB",
+		"Yottabyte": "{0} YB",
+		"Kibibyte": "{0} KiB",
+		"Mebibyte": "{0} MiB",
+		"Gibibyte": "{0} GiB",
+		"Tebibyte": "{0} TiB",
+		"Pebibyte": "{0} PiB",
+		"Exbibyte": "{0} EiB",
+		"Zebibyte": "{0} ZiB",
+		"Yobibyte": "{0} YiB"
 	}
 }

package/dist/generated/assets/cldr/zh_SG.json

@@ -5975,5 +5975,26 @@
 	"sap-calendarWeek": {
 		"narrow": "CW {0}",
 		"wide": "Calendar Week {0}"
+	},
+	"sap-datePlaceholder": "e.g. {0}",
+	"sap-fileSize": {
+		"Byte": "{0} Byte",
+		"Bytes": "{0} Bytes",
+		"Kilobyte": "{0} KB",
+		"Megabyte": "{0} MB",
+		"Gigabyte": "{0} GB",
+		"Terabyte": "{0} TB",
+		"Petabyte": "{0} PB",
+		"Exabyte": "{0} EB",
+		"Zettabyte": "{0} ZB",
+		"Yottabyte": "{0} YB",
+		"Kibibyte": "{0} KiB",
+		"Mebibyte": "{0} MiB",
+		"Gibibyte": "{0} GiB",
+		"Tebibyte": "{0} TiB",
+		"Pebibyte": "{0} PiB",
+		"Exbibyte": "{0} EiB",
+		"Zebibyte": "{0} ZiB",
+		"Yobibyte": "{0} YiB"
 	}
 }

package/dist/generated/assets/cldr/zh_TW.json

@@ -6031,5 +6031,26 @@
 	"sap-calendarWeek": {
 		"narrow": "曆週 {0}",
 		"wide": "曆週 {0}"
+	},
+	"sap-datePlaceholder": "例如 {0}",
+	"sap-fileSize": {
+		"Byte": "{0} 位元組",
+		"Bytes": "{0} 位元組",
+		"Kilobyte": "{0} KB",
+		"Megabyte": "{0} MB",
+		"Gigabyte": "{0} GB",
+		"Terabyte": "{0} TB",
+		"Petabyte": "{0} PB",
+		"Exabyte": "{0} EB",
+		"Zettabyte": "{0} ZB",
+		"Yottabyte": "{0} YB",
+		"Kibibyte": "{0} KiB",
+		"Mebibyte": "{0} MiB",
+		"Gibibyte": "{0} GiB",
+		"Tebibyte": "{0} TiB",
+		"Pebibyte": "{0} PiB",
+		"Exbibyte": "{0} EiB",
+		"Zebibyte": "{0} ZiB",
+		"Yobibyte": "{0} YiB"
 	}
 }

package/dist/sap/base/Event.js

@@ -9,7 +9,7 @@ const EVENT_PARAMETERS_SYMBOL = Symbol("parameters");
 
 /**
  * @author SAP SE
- * @version 1.146.0
+ * @version 1.151.0
  *
  * Creates an event with the given <code>sType</code>,
  * linked to the provided <code>oTarget</code> and enriched with the <code>oParameters</code>.

package/dist/sap/base/Eventing.js

@@ -10,7 +10,7 @@ import Event from "./Event.js";
  * @class A simple eventing implementation that manages listeners and can fire events.
  *
  * @author SAP SE
- * @version 1.146.0
+ * @version 1.151.0
  *
  * @since 1.120.0
  * @private

package/dist/sap/base/i18n/LanguageTag.js

@@ -31,7 +31,7 @@ var rLanguageTag = /^((?:[A-Z]{2,3}(?:-[A-Z]{3}){0,3})|[A-Z]{4}|[A-Z]{5,8})(?:-(
  * @param {string} sLanguageTag the language tag identifier, in format en-US or en_US.
  *
  * @author SAP SE
- * @version 1.146.0
+ * @version 1.151.0
  * @public
  * @alias module:sap/base/i18n/LanguageTag
  */

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

@@ -2,7 +2,7 @@
  * Static collection of utility functions to handle time zone related conversions
  *
  * @author SAP SE
- * @version 1.146.0
+ * @version 1.151.0
  * @namespace
  * @alias module:sap/base/i18n/date/TimezoneUtils
  * @private

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

@@ -137,7 +137,7 @@ function Version(vMajor, iMinor, iPatch, sSuffix) {
    * @public
    */
   this.compareTo = function (vOtherMajor, iOtherMinor, iOtherPatch, sOtherSuffix) {
-    var vOther = Version.apply(window, arguments);
+    var vOther = Version.apply(null, arguments); // cast to Version
     /*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 */

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

@@ -5,7 +5,6 @@
  */
 /*global Node */
 //@evo-todo check isEqualNode dependency: not yet available...
-//@evo-todo dependency to global name 'Node' contradicts sap/base package
 import Log from "../Log.js";
 /**
  * Compares the two given values for equality, especially by comparing the content.
@@ -65,7 +64,8 @@ var fnEqual = function (a, b, maxDepth, contains, depth) {
     if (!contains && Object.keys(a).length !== Object.keys(b).length) {
       return false;
     }
-    if (a instanceof Node) {
+    // 'Node' is a browser-only global; the typeof guard avoids a ReferenceError in non-browser environments.
+    if (typeof Node !== "undefined" && a instanceof Node) {
       return a.isEqualNode(b);
     }
     if (a instanceof Date) {

package/dist/sap/ui/base/Metadata.js

@@ -25,7 +25,7 @@ function isFunction(obj) {
  *
  * @class Metadata for a class.
  * @author Frank Weigel
- * @version 1.146.0
+ * @version 1.151.0
  * @since 0.8.6
  * @public
  * @alias sap.ui.base.Metadata

package/dist/sap/ui/base/Object.js

@@ -21,7 +21,7 @@ import Log from "../../base/Log.js";
  * @class Base class for all SAPUI5 Objects.
  * @abstract
  * @author Malte Wedel
- * @version 1.146.0
+ * @version 1.151.0
  * @public
  * @alias sap.ui.base.Object
  * @throws {Error} When an instance of the class or its subclasses is created without the <code>new</code> operator.

package/dist/sap/ui/core/Locale.js

@@ -19,7 +19,7 @@ var mCache = Object.create(null);
  *
  * @extends sap.ui.base.Object
  * @author SAP SE
- * @version 1.146.0
+ * @version 1.151.0
  * @public
  * @alias sap.ui.core.Locale
  */

package/dist/sap/ui/core/LocaleData.js

@@ -72,7 +72,7 @@ let mLocaleIdToData = {};
  *   {@link https://cldr.unicode.org/ Unicode CLDR}.
  * @hideconstructor
  * @public
- * @version 1.146.0
+ * @version 1.151.0
  */
 var LocaleData = BaseObject.extend("sap.ui.core.LocaleData", /** @lends sap.ui.core.LocaleData.prototype */{
   constructor: function (oLocale, bAsync) {
@@ -1907,6 +1907,28 @@ var LocaleData = BaseObject.extend("sap.ui.core.LocaleData", /** @lends sap.ui.c
     const sText = this._get("sap-calendarWeek")[sStyle];
     return iWeekNumber ? sText.replace("{0}", iWeekNumber) : sText;
   },
+  /**
+   * Gets the locale-specific date input placeholder pattern.
+   *
+   * @returns {string} The placeholder pattern, for example "e.g. {0}" or "z.B. {0}"
+   *
+   * @private
+   */
+  getDatePlaceholder: function () {
+    return this._get("sap-datePlaceholder");
+  },
+  /**
+   * Gets the locale-specific file size format pattern for the given unit.
+   *
+   * @param {string} sUnit
+   *   The file size unit key
+   * @returns {string} The format pattern
+   *
+   * @private
+   */
+  getFileSizePattern: function (sUnit) {
+    return this._get("sap-fileSize", sUnit);
+  },
   /**
    * Whether 1 January is the first day of the first calendar week.
    * This is the definition of the calendar week in the US.

package/dist/sap/ui/core/date/UI5Date.js

@@ -69,7 +69,7 @@ function addLeadingZeros(iValue, iLength) {
  * @hideconstructor
  * @public
  * @since 1.111.0
- * @version 1.146.0
+ * @version 1.151.0
  */
 function UI5Date(vDateParts, sTimezoneID) {
   var oDateInstance = UI5Date._createDateInstance(vDateParts);

package/dist/sap/ui/core/format/DateFormat.js

@@ -13,7 +13,6 @@ import TimezoneUtils from "../../../base/i18n/date/TimezoneUtils.js";
 import formatMessage from "../../../base/strings/formatMessage.js";
 import deepEqual from "../../../base/util/deepEqual.js";
 import extend from "../../../base/util/extend.js";
-import Library from "../Lib.js";
 import Locale from "../Locale.js";
 import LocaleData from "../LocaleData.js";
 import Supportability from "../Supportability.js";
@@ -3268,40 +3267,128 @@ DateFormat.prototype.getAllowedCharacters = function (aFormatArray) {
 
 /**
  * Returns a language-dependent placeholder text according to this instance's format options, for example
- * "e.g. 12/31/2023".
+ * "e.g. 12/31/2023". If <code>oMinimum</code> and/or <code>oMaximum</code> are given, a valid sample date
+ * within the given range is used; see {@link #getSampleValue} for the exact algorithm.
  *
+ * @param {module:sap/ui/core/date/UI5Date} [oMinimum] The minimum date
+ * @param {module:sap/ui/core/date/UI5Date} [oMaximum] The maximum date
  * @returns {string} The language-dependent placeholder text
  *
  * @private
  * @ui5-restricted sap.m
  */
-DateFormat.prototype.getPlaceholderText = function () {
-  var oResourceBundle = Library.getResourceBundleFor("sap.ui.core");
-  return oResourceBundle.getText("date.placeholder", [this.format.apply(this, this.getSampleValue())]);
+DateFormat.prototype.getPlaceholderText = function (oMinimum, oMaximum) {
+  const sPlaceholder = this.oLocaleData.getDatePlaceholder();
+  return sPlaceholder.replace("{0}", this.format.apply(this, this.getSampleValue(oMinimum, oMaximum)));
 };
 
 /**
- * Returns a sample date value.
+ * Returns a sample date value. If <code>oMinimum</code> and/or <code>oMaximum</code> are given, the returned
+ * value lies within the valid range. The end date is chosen by the following rules in order:
+ * <ol>
+ *   <li>If the default sample year (current year) is within [min year, max year], use Dec 31 of the current
+ *       year.</li>
+ *   <li>If <code>oMinimum</code> and <code>oMaximum</code> span different years, or only one bound is given,
+ *       use the Dec 31 year-end closest to <code>oMaximum</code> (or closest to <code>oMinimum</code> if only
+ *       the minimum is given).</li>
+ *   <li>If they span different months in the same year, use the highest month-end within the range.</li>
+ *   <li>Otherwise use <code>oMaximum</code> directly.</li>
+ * </ol>
+ * For interval formats, the start date is nine days before the end date, clamped to <code>oMinimum</code>.
  *
- * @returns {array}
+ * @param {module:sap/ui/core/date/UI5Date} [oMinimum]  The minimum date
+ * @param {module:sap/ui/core/date/UI5Date} [oMaximum] The maximum date
+ * @returns {Array}
  *   A sample date value as an array of parameter values as expected by {@link #format}
  *
  * @private
  */
-DateFormat.prototype.getSampleValue = function () {
-  var oDate,
-    iFullYear = UI5Date.getInstance().getFullYear(),
+DateFormat.prototype.getSampleValue = function (oMinimum, oMaximum) {
+  var iFullYear = UI5Date.getInstance().getFullYear(),
     bUTC = this.oFormatOptions.UTC;
   function getDate(iYear, iMonth, iDay, iHours, iMinutes, iSeconds, iMilliseconds) {
     return bUTC ? UI5Date.getInstance(Date.UTC(iYear, iMonth, iDay, iHours, iMinutes, iSeconds, iMilliseconds)) : UI5Date.getInstance(iYear, iMonth, iDay, iHours, iMinutes, iSeconds, iMilliseconds);
   }
-  oDate = getDate(iFullYear, 11, 31, 23, 59, 58, 123);
+  const periodEnd = (iYear, iMonth, iDay) => {
+    return this.type === mDateFormatTypes.DATE ? getDate(iYear, iMonth, iDay, 0, 0, 0, 0) : getDate(iYear, iMonth, iDay, 23, 59, 58, 123);
+  };
+  function yearEnd(iYear) {
+    return periodEnd(iYear, 11, 31);
+  }
+  const oDefault = yearEnd(iFullYear);
+  const bDefaultInRange = (!oMinimum || oDefault >= oMinimum) && (!oMaximum || oDefault <= oMaximum);
+  let oEnd;
+  if (bDefaultInRange) {
+    // R1: use default
+    oEnd = oDefault;
+  } else if (oMinimum == null || oMaximum == null || oMinimum.getFullYear() !== oMaximum.getFullYear()) {
+    // R2: different years or only one bound
+    if (oMaximum) {
+      const oYearEnd = yearEnd(oMaximum.getFullYear());
+      oEnd = oYearEnd <= oMaximum ? oYearEnd : yearEnd(oMaximum.getFullYear() - 1);
+    } else {
+      const oYearEnd = yearEnd(oMinimum.getFullYear());
+      oEnd = oYearEnd >= oMinimum ? oYearEnd : yearEnd(oMinimum.getFullYear() + 1);
+    }
+  } else if (oMinimum.getMonth() !== oMaximum.getMonth()) {
+    // R3: same year, different months
+    const iYear = oMaximum.getFullYear();
+    const iMaxMonth = oMaximum.getMonth();
+    const oMaxMonthEnd = periodEnd(iYear, iMaxMonth + 1, 0);
+    oEnd = oMaxMonthEnd <= oMaximum ? oMaxMonthEnd : periodEnd(iYear, iMaxMonth, 0);
+  } else {
+    // R4: same year and month
+    oEnd = oMaximum;
+  }
   if (this.type === mDateFormatTypes.DATETIME_WITH_TIMEZONE) {
-    return [oDate, Localization.getTimezone()];
+    return [oEnd, Localization.getTimezone()];
   }
   if (this.oFormatOptions.interval) {
-    return [[getDate(iFullYear, 11, 22, 9, 12, 34, 567), oDate]];
+    const iEndYear = bUTC ? oEnd.getUTCFullYear() : oEnd.getFullYear();
+    const iEndMonth = bUTC ? oEnd.getUTCMonth() : oEnd.getMonth();
+    const iEndDay = bUTC ? oEnd.getUTCDate() : oEnd.getDate();
+    const oStart = getDate(iEndYear, iEndMonth, iEndDay - 9, 9, 12, 34, 567);
+    return [[oMinimum && oStart < oMinimum ? oMinimum : oStart, oEnd]];
   }
-  return [oDate];
+  return [oEnd];
+};
+
+/**
+ * Returns the effective date to use for placeholder text generation.
+ *
+ * @param {any} [oConstraintValue]
+ *   The constraint value in model representation: a <code>UI5Date</code>, a formatted string, or a timestamp number
+ * @param {module:sap/ui/core/date/UI5Date} [oDate]
+ *   The explicit date parameter; takes precedence over the constraint
+ * @param {sap.ui.core.format.DateFormat} [oInputFormat]
+ *   The input format used to parse string constraint values
+ * @returns {module:sap/ui/core/date/UI5Date|undefined}
+ *   The resolved date, or <code>undefined</code> if neither parameter nor constraint is given
+ * @throws {Error}
+ *   If <code>oDate</code> is given but does not match the constraint value
+ *
+ * @private
+ */
+DateFormat.resolveDate = function (oConstraintValue, oDate, oInputFormat) {
+  if (oDate === undefined && oConstraintValue === undefined) {
+    return undefined;
+  }
+  let oConstraintDate;
+  if (oConstraintValue !== undefined) {
+    if (typeof oConstraintValue === "number") {
+      oConstraintDate = UI5Date.getInstance(oConstraintValue);
+    } else if (oInputFormat) {
+      oConstraintDate = oInputFormat.parse(oConstraintValue);
+    } else {
+      oConstraintDate = oConstraintValue;
+    }
+  }
+  if (oDate === undefined || oDate === null) {
+    return oConstraintDate;
+  }
+  if (oConstraintDate && oDate.getTime() !== oConstraintDate.getTime()) {
+    throw new Error(`The date ${oDate} does not match the constraint ${oConstraintDate}`);
+  }
+  return oDate;
 };
 export default DateFormat;

package/dist/sap/ui/core/format/FormatUtils.js

@@ -2,7 +2,7 @@
  * Formatter related utility functions
  *
  * @author SAP SE
- * @version 1.146.0
+ * @version 1.151.0
  * @namespace
  * @private
  */ /*!