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

package/dist/sap/base/Eventing.js

@@ -0,0 +1,146 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+// Provides mixin sap/base/Eventing
+import assert from "./assert.js";
+import Event from "./Event.js";
+/**
+ * Eventing
+ *
+ * @author SAP SE
+ * @version 1.120.17
+ *
+ * @since 1.120.0
+ * @private
+ * @ui5-restricted sap.ui.core sap/base/i18n
+ */
+class Eventing {
+  #mEventRegistry = {};
+  /**
+   * Attaches an event handler to the event with the given identifier.
+   *
+   * @param {string}
+   * 		sType The type of the event to listen for
+   * @param {function}
+   * 		fnFunction The handler function to call when the event occurs. The event
+   * 		object ({@link module:sap/base/Event}) is provided as first argument of the handler. Handlers must not change
+   * 		the content of the event.
+   * @param {object}
+   * 		[oData] An object that will be passed to the handler along with the event object when the event is fired
+   * @since 1.120.0
+   * @private
+   * @ui5-restricted sap.ui.core sap/base/i18n
+   */
+  attachEvent(sType, fnFunction, oData) {
+    assert(typeof sType === "string" && sType, "Eventing.attachEvent: sType must be a non-empty string");
+    assert(typeof fnFunction === "function", "Eventing.attachEvent: fnFunction must be a function");
+    let aEventListeners = this.#mEventRegistry[sType];
+    if (!Array.isArray(aEventListeners)) {
+      aEventListeners = this.#mEventRegistry[sType] = [];
+    }
+    aEventListeners.push({
+      fnFunction: fnFunction,
+      oData: oData
+    });
+  }
+
+  /**
+   * Attaches an event handler, called one time only, to the event with the given identifier.
+   *
+   * When the event occurs, the handler function is called and the handler registration is automatically removed afterwards.
+   *
+   * @param {string}
+   *            sType The type of the event to listen for
+   * @param {function}
+   *            fnFunction The handler function to call when the event occurs. The event
+   *                       object ({@link module:sap/base/Event}) is provided as first argument of the handler. Handlers must not change
+   *                       the content of the event.
+   * @param {object}
+   *            [oData] An object that will be passed to the handler along with the event object when the event is fired
+   * @since 1.120.0
+   * @private
+   * @ui5-restricted sap.ui.core sap/base/i18n
+   */
+  attachEventOnce(sType, fnFunction, oData) {
+    const fnOnce = oEvent => {
+      this.detachEvent(sType, fnOnce);
+      fnFunction.call(null, oEvent); // needs to do the same resolution as in fireEvent
+    };
+    fnOnce.oOriginal = {
+      fnFunction: fnFunction
+    };
+    this.attachEvent(sType, fnOnce, oData);
+  }
+
+  /**
+   * Removes a previously attached event handler from the event with the given identifier.
+   *
+   * The passed parameters must match those used for registration with {@link #attachEvent} beforehand.
+   *
+   * @param {string}
+   *            sType The type of the event to detach from
+   * @param {function}
+   *            fnFunction The handler function to detach from the event
+   * @since 1.120.0
+   * @private
+   * @ui5-restricted sap.ui.core sap/base/i18n
+   */
+  detachEvent(sType, fnFunction) {
+    assert(typeof sType === "string" && sType, "Eventing.detachEvent: sType must be a non-empty string");
+    assert(typeof fnFunction === "function", "Eventing.detachEvent: fnFunction must be a function");
+    const aEventListeners = this.#mEventRegistry[sType];
+    if (!Array.isArray(aEventListeners)) {
+      return;
+    }
+    let oFound;
+    for (let i = 0, iL = aEventListeners.length; i < iL; i++) {
+      if (aEventListeners[i].fnFunction === fnFunction) {
+        oFound = aEventListeners[i];
+        aEventListeners.splice(i, 1);
+        break;
+      }
+    }
+    // If no listener was found, look for original listeners of attachEventOnce
+    if (!oFound) {
+      for (let i = 0, iL = aEventListeners.length; i < iL; i++) {
+        const oOriginal = aEventListeners[i].fnFunction.oOriginal;
+        if (oOriginal && oOriginal.fnFunction === fnFunction) {
+          aEventListeners.splice(i, 1);
+          break;
+        }
+      }
+    }
+    // If we just deleted the last registered EventHandler, remove the whole entry from our map.
+    if (aEventListeners.length == 0) {
+      delete this.#mEventRegistry[sType];
+    }
+  }
+
+  /**
+   * Fires an {@link module:sap/base/Event event} with the given settings and notifies all attached event handlers.
+   *
+   * @param {string}
+   *            sType The type of the event to fire
+   * @param {object}
+   *            [oParameters] Parameters which should be carried by the event
+   * @since 1.120.0
+   * @private
+   * @ui5-restricted sap.ui.core sap/base/i18n
+   */
+  fireEvent(sType, oParameters) {
+    let aEventListeners, oEvent, i, iL, oInfo;
+    aEventListeners = this.#mEventRegistry[sType];
+    if (Array.isArray(aEventListeners)) {
+      // avoid issues with 'concurrent modification' (e.g. if an event listener unregisters itself).
+      aEventListeners = aEventListeners.slice();
+      oEvent = new Event(sType, oParameters);
+      for (i = 0, iL = aEventListeners.length; i < iL; i++) {
+        oInfo = aEventListeners[i];
+        oInfo.fnFunction.call(null, oEvent);
+      }
+    }
+  }
+}
+export default Eventing;

package/dist/sap/base/Log.js

@@ -1,249 +1,3 @@
-import now from './util/now.js';
-var Log = {};
-Log.Level = {
-    NONE: -1,
-    FATAL: 0,
-    ERROR: 1,
-    WARNING: 2,
-    INFO: 3,
-    DEBUG: 4,
-    TRACE: 5,
-    ALL: 5 + 1
-};
-var sDefaultComponent, aLog = [], mMaxLevel = { '': Log.Level.ERROR }, iLogEntriesLimit = 3000, oListener = null, bLogSupportInfo = false;
-function pad0(i, w) {
-    return ('000' + String(i)).slice(-w);
-}
-function level(sComponent) {
-    return !sComponent || isNaN(mMaxLevel[sComponent]) ? mMaxLevel[''] : mMaxLevel[sComponent];
-}
-function discardLogEntries() {
-    var iLogLength = aLog.length;
-    if (iLogLength) {
-        var iEntriesToKeep = Math.min(iLogLength, Math.floor(iLogEntriesLimit * 0.7));
-        if (oListener) {
-            oListener.onDiscardLogEntries(aLog.slice(0, iLogLength - iEntriesToKeep));
-        }
-        if (iEntriesToKeep) {
-            aLog = aLog.slice(-iEntriesToKeep, iLogLength);
-        } else {
-            aLog = [];
-        }
-    }
-}
-function getLogEntryListenerInstance() {
-    if (!oListener) {
-        oListener = {
-            listeners: [],
-            onLogEntry: function (oLogEntry) {
-                for (var i = 0; i < oListener.listeners.length; i++) {
-                    if (oListener.listeners[i].onLogEntry) {
-                        oListener.listeners[i].onLogEntry(oLogEntry);
-                    }
-                }
-            },
-            onDiscardLogEntries: function (aDiscardedLogEntries) {
-                for (var i = 0; i < oListener.listeners.length; i++) {
-                    if (oListener.listeners[i].onDiscardLogEntries) {
-                        oListener.listeners[i].onDiscardLogEntries(aDiscardedLogEntries);
-                    }
-                }
-            },
-            attach: function (oLog, oLstnr) {
-                if (oLstnr) {
-                    oListener.listeners.push(oLstnr);
-                    if (oLstnr.onAttachToLog) {
-                        oLstnr.onAttachToLog(oLog);
-                    }
-                }
-            },
-            detach: function (oLog, oLstnr) {
-                for (var i = 0; i < oListener.listeners.length; i++) {
-                    if (oListener.listeners[i] === oLstnr) {
-                        if (oLstnr.onDetachFromLog) {
-                            oLstnr.onDetachFromLog(oLog);
-                        }
-                        oListener.listeners.splice(i, 1);
-                        return;
-                    }
-                }
-            }
-        };
-    }
-    return oListener;
-}
-Log.fatal = function (sMessage, sDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.FATAL, sMessage, sDetails, sComponent, fnSupportInfo);
-};
-Log.error = function (sMessage, sDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.ERROR, sMessage, sDetails, sComponent, fnSupportInfo);
-};
-Log.warning = function (sMessage, sDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.WARNING, sMessage, sDetails, sComponent, fnSupportInfo);
-};
-Log.info = function (sMessage, sDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.INFO, sMessage, sDetails, sComponent, fnSupportInfo);
-};
-Log.debug = function (sMessage, sDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.DEBUG, sMessage, sDetails, sComponent, fnSupportInfo);
-};
-Log.trace = function (sMessage, sDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.TRACE, sMessage, sDetails, sComponent, fnSupportInfo);
-};
-Log.setLevel = function (iLogLevel, sComponent, _bDefault) {
-    sComponent = sComponent || sDefaultComponent || '';
-    if (!_bDefault || mMaxLevel[sComponent] == null) {
-        mMaxLevel[sComponent] = iLogLevel;
-        var sLogLevel;
-        Object.keys(Log.Level).forEach(function (sLevel) {
-            if (Log.Level[sLevel] === iLogLevel) {
-                sLogLevel = sLevel;
-            }
-        });
-        log(Log.Level.INFO, 'Changing log level ' + (sComponent ? 'for \'' + sComponent + '\' ' : '') + 'to ' + sLogLevel, '', 'sap.base.log');
-    }
-};
-Log.getLevel = function (sComponent) {
-    return level(sComponent || sDefaultComponent);
-};
-Log.isLoggable = function (iLevel, sComponent) {
-    return (iLevel == null ? Log.Level.DEBUG : iLevel) <= level(sComponent || sDefaultComponent);
-};
-Log.logSupportInfo = function (bEnabled) {
-    bLogSupportInfo = bEnabled;
-};
-function log(iLevel, sMessage, sDetails, sComponent, fnSupportInfo) {
-    if (!fnSupportInfo && !sComponent && typeof sDetails === 'function') {
-        fnSupportInfo = sDetails;
-        sDetails = '';
-    }
-    if (!fnSupportInfo && typeof sComponent === 'function') {
-        fnSupportInfo = sComponent;
-        sComponent = '';
-    }
-    sComponent = sComponent || sDefaultComponent;
-    if (iLevel <= level(sComponent)) {
-        var fNow = now(), oNow = new Date(fNow), iMicroSeconds = Math.floor((fNow - Math.floor(fNow)) * 1000), oLogEntry = {
-                time: pad0(oNow.getHours(), 2) + ':' + pad0(oNow.getMinutes(), 2) + ':' + pad0(oNow.getSeconds(), 2) + '.' + pad0(oNow.getMilliseconds(), 3) + pad0(iMicroSeconds, 3),
-                date: pad0(oNow.getFullYear(), 4) + '-' + pad0(oNow.getMonth() + 1, 2) + '-' + pad0(oNow.getDate(), 2),
-                timestamp: fNow,
-                level: iLevel,
-                message: String(sMessage || ''),
-                details: String(sDetails || ''),
-                component: String(sComponent || '')
-            };
-        if (bLogSupportInfo && typeof fnSupportInfo === 'function') {
-            oLogEntry.supportInfo = fnSupportInfo();
-        }
-        if (iLogEntriesLimit) {
-            if (aLog.length >= iLogEntriesLimit) {
-                discardLogEntries();
-            }
-            aLog.push(oLogEntry);
-        }
-        if (oListener) {
-            oListener.onLogEntry(oLogEntry);
-        }
-        if (console) {
-            var isDetailsError = sDetails instanceof Error, logText = oLogEntry.date + ' ' + oLogEntry.time + ' ' + oLogEntry.message + ' - ' + oLogEntry.details + ' ' + oLogEntry.component;
-            switch (iLevel) {
-            case Log.Level.FATAL:
-            case Log.Level.ERROR:
-                isDetailsError ? console.error(logText, '\n', sDetails) : console.error(logText);
-                break;
-            case Log.Level.WARNING:
-                isDetailsError ? console.warn(logText, '\n', sDetails) : console.warn(logText);
-                break;
-            case Log.Level.INFO:
-                if (console.info) {
-                    isDetailsError ? console.info(logText, '\n', sDetails) : console.info(logText);
-                } else {
-                    isDetailsError ? console.log(logText, '\n', sDetails) : console.log(logText);
-                }
-                break;
-            case Log.Level.DEBUG:
-                if (console.debug) {
-                    isDetailsError ? console.debug(logText, '\n', sDetails) : console.debug(logText);
-                } else {
-                    isDetailsError ? console.log(logText, '\n', sDetails) : console.log(logText);
-                }
-                break;
-            case Log.Level.TRACE:
-                if (console.trace) {
-                    isDetailsError ? console.trace(logText, '\n', sDetails) : console.trace(logText);
-                } else {
-                    isDetailsError ? console.log(logText, '\n', sDetails) : console.log(logText);
-                }
-                break;
-            }
-            if (console.info && oLogEntry.supportInfo) {
-                console.info(oLogEntry.supportInfo);
-            }
-        }
-        return oLogEntry;
-    }
-}
-Log.getLogEntries = function () {
-    return aLog.slice();
-};
-Log.getLogEntriesLimit = function () {
-    return iLogEntriesLimit;
-};
-Log.setLogEntriesLimit = function (iLimit) {
-    if (iLimit < 0) {
-        throw new Error('The log entries limit needs to be greater than or equal to 0!');
-    }
-    iLogEntriesLimit = iLimit;
-    if (aLog.length >= iLogEntriesLimit) {
-        discardLogEntries();
-    }
-};
-Log.addLogListener = function (oListener) {
-    getLogEntryListenerInstance().attach(this, oListener);
-};
-Log.removeLogListener = function (oListener) {
-    getLogEntryListenerInstance().detach(this, oListener);
-};
-function Logger(sComponent) {
-    this.fatal = function (msg, detail, comp, support) {
-        Log.fatal(msg, detail, comp || sComponent, support);
-        return this;
-    };
-    this.error = function (msg, detail, comp, support) {
-        Log.error(msg, detail, comp || sComponent, support);
-        return this;
-    };
-    this.warning = function (msg, detail, comp, support) {
-        Log.warning(msg, detail, comp || sComponent, support);
-        return this;
-    };
-    this.info = function (msg, detail, comp, support) {
-        Log.info(msg, detail, comp || sComponent, support);
-        return this;
-    };
-    this.debug = function (msg, detail, comp, support) {
-        Log.debug(msg, detail, comp || sComponent, support);
-        return this;
-    };
-    this.trace = function (msg, detail, comp, support) {
-        Log.trace(msg, detail, comp || sComponent, support);
-        return this;
-    };
-    this.setLevel = function (level, comp) {
-        Log.setLevel(level, comp || sComponent);
-        return this;
-    };
-    this.getLevel = function (comp) {
-        return Log.getLevel(comp || sComponent);
-    };
-    this.isLoggable = function (level, comp) {
-        return Log.isLoggable(level, comp || sComponent);
-    };
-}
-Log.getLogger = function (sComponent, iDefaultLogLevel) {
-    if (!isNaN(iDefaultLogLevel) && mMaxLevel[sComponent] == null) {
-        mMaxLevel[sComponent] = iDefaultLogLevel;
-    }
-    return new Logger(sComponent);
-};
+const Log = console;
+Log.warning = console.warn;
 export default Log;

package/dist/sap/base/assert.js

@@ -1,12 +1,34 @@
-import Log from './Log.js';
+// TODO-evo:assert on node throws an error if the assertion is violated
+
+/**
+ * A simple assertion mechanism that logs a message when a given condition is not met.
+ *
+ * <b>Note:</b> Calls to this method might be removed when the JavaScript code
+ *              is optimized during build. Therefore, callers should not rely on any side effects
+ *              of this method.
+ *
+ * @function
+ * @since 1.58
+ * @alias module:sap/base/assert
+ * @param {boolean} bResult Result of the checked assertion
+ * @param {string|function():any} vMessage Message that will be logged when the result is <code>false</code>.
+ * In case this is a function, the return value of the function will be displayed. This can be used to execute
+ * complex code only if the assertion fails.
+ * @public
+ * @SecSink {1|SECRET} Could expose secret data in logs
+ *
+ */ /*!
+     * OpenUI5
+     * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+     * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+     */
+
 var fnAssert = function (bResult, vMessage) {
-    if (!bResult) {
-        var sMessage = typeof vMessage === 'function' ? vMessage() : vMessage;
-        if (console && console.assert) {
-            console.assert(bResult, sMessage);
-        } else {
-            Log.debug('[Assertions] ' + sMessage);
-        }
-    }
+  if (!bResult) {
+    var sMessage = typeof vMessage === "function" ? vMessage() : vMessage;
+    /*eslint-disable no-console */
+    console.assert(bResult, sMessage);
+    /*eslint-enable no-console */
+  }
 };
 export default fnAssert;

package/dist/sap/base/config/MemoryConfigurationProvider.js

@@ -0,0 +1,20 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+import uid from "../util/uid.js";
+var MemoryConfigurationProvider = function () {
+  this.oConfig = Object.create(null);
+  this.id = uid();
+};
+MemoryConfigurationProvider.prototype.getId = function () {
+  return this.id;
+};
+MemoryConfigurationProvider.prototype.get = function (sName) {
+  return this.oConfig[sName];
+};
+MemoryConfigurationProvider.prototype.set = function (sName, vValue) {
+  this.oConfig[sName] = vValue;
+};
+export default MemoryConfigurationProvider;

package/dist/sap/base/config.js

@@ -0,0 +1,17 @@
+// called from sapui5, but not supported by us
+const legacyFormats = ["sapUiLegacyTimeFormat", "sapUiABAPTimeFormat", "sapUiLegacyDateFormat", "sapUiABAPDateFormat", "sapUiLegacyNumberFormat", "sapUiABAPNumberFormat"];
+export default {
+  getWritableInstance() {
+    return {
+      get({
+        name
+      }) {
+        if (legacyFormats.includes(name)) {
+          return undefined;
+        }
+        throw new Error("Localization :: missing configuration requested.");
+      }
+    };
+  },
+  Type: {}
+};

package/dist/sap/base/i18n/Formatting.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OpenUI5 Formatting Shim
+ */
+declare const Formatting: {
+    getABAPDateFormat: () => void;
+    getCustomIslamicCalendarData: typeof import("@ui5/webcomponents-base/dist/features/LegacyDateFormats.js").default.getLegacyDateCalendarCustomizing;
+};
+export default Formatting;

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

@@ -0,0 +1,11 @@
+import { getLegacyDateCalendarCustomizing } from "@ui5/webcomponents-base/dist/config/FormatSettings.js";
+const emptyFn = () => { };
+/**
+ * OpenUI5 Formatting Shim
+ */
+const Formatting = {
+    getABAPDateFormat: emptyFn,
+    getCustomIslamicCalendarData: getLegacyDateCalendarCustomizing,
+};
+export default Formatting;
+//# sourceMappingURL=Formatting.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Formatting.js","sourceRoot":"","sources":["../../../../src/sap/base/i18n/Formatting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,uDAAuD,CAAC;AAEzG,MAAM,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AAEzB;;GAEG;AACH,MAAM,UAAU,GAAG;IAClB,iBAAiB,EAAE,OAAO;IAC1B,4BAA4B,EAAE,gCAAgC;CAC9D,CAAC;AAEF,eAAe,UAAU,CAAC","sourcesContent":["import { getLegacyDateCalendarCustomizing } from \"@ui5/webcomponents-base/dist/config/FormatSettings.js\";\n\nconst emptyFn = () => {};\n\n/**\n * OpenUI5 Formatting Shim\n */\nconst Formatting = {\n\tgetABAPDateFormat: emptyFn,\n\tgetCustomIslamicCalendarData: getLegacyDateCalendarCustomizing,\n};\n\nexport default Formatting;\n"]}

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

@@ -0,0 +1,173 @@
+/**
+ * A regular expression that describes language tags according to BCP-47.
+ * @see BCP47 "Tags for Identifying Languages" (http://www.ietf.org/rfc/bcp/bcp47.txt)
+ *
+ * The matching groups are
+ *  0=all
+ *  1=language (shortest ISO639 code + ext. language sub tags | 4digits (reserved) | registered language sub tags)
+ *  2=script (4 letters)
+ *  3=region (2 letter language or 3 digits)
+ *  4=variants (separated by '-', Note: capturing group contains leading '-' to shorten the regex!)
+ *  5=extensions (including leading singleton, multiple extensions separated by '-'.Note: capturing group contains leading '-' to shorten the regex!)
+ *  6=private use section (including leading 'x', multiple sections separated by '-')
+ *
+ *              [-------------------- language ----------------------][--- script ---][------- region --------][------------- variants --------------][----------- extensions ------------][------ private use -------]
+ */ /*!
+     * OpenUI5
+     * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+     * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+     */
+
+//Provides the LanguageTag object module:sap/base/i18n/LanguageTag
+
+var rLanguageTag = /^((?:[A-Z]{2,3}(?:-[A-Z]{3}){0,3})|[A-Z]{4}|[A-Z]{5,8})(?:-([A-Z]{4}))?(?:-([A-Z]{2}|[0-9]{3}))?((?:-[0-9A-Z]{5,8}|-[0-9][0-9A-Z]{3})*)((?:-[0-9A-WYZ](?:-[0-9A-Z]{2,8})+)*)(?:-(X(?:-[0-9A-Z]{1,8})+))?$/i;
+
+/**
+ * Creates an LanguageTag instance.
+ * LanguageTag represents a BCP-47 language tag, consisting of a language, script, region, variants, extensions and private use section.
+ *
+ * @class
+ *
+ * @param {string} sLanguageTag the language tag identifier, in format en-US or en_US.
+ *
+ * @author SAP SE
+ * @version 1.120.17
+ * @public
+ * @alias module:sap/base/i18n/LanguageTag
+ */
+class LanguageTag {
+  /**
+   * Get the language.
+   *
+   * Note that the case might differ from the original script tag
+   * (Lower case is enforced as recommended by BCP47/ISO639).
+   *
+   * @type {string}
+   * @public
+   */
+  language;
+
+  /**
+   * Get the script or <code>null</code> if none was specified.
+   *
+   * Note that the case might differ from the original language tag
+   * (Upper case first letter and lower case reminder enforced as
+   * recommended by BCP47/ISO15924)
+   *
+   * @type {string|null}
+   * @public
+   */
+  script;
+
+  /**
+   * Get the region or <code>null</code> if none was specified.
+   *
+   * Note that the case might differ from the original script tag
+   * (Upper case is enforced as recommended by BCP47/ISO3166-1).
+   *
+   * @type {string}
+   * @public
+   */
+  region;
+
+  /**
+   * Get the variants as a single string or <code>null</code>.
+   *
+   * Multiple variants are separated by a dash '-'.
+   *
+   * @type {string|null}
+   * @public
+   */
+  variant;
+
+  /**
+   * Get the variants as an array of individual variants.
+   *
+   * The separating dashes are not part of the result.
+   * If there is no variant section in the language tag, an empty array is returned.
+   *
+   * @type {string[]}
+   * @public
+   */
+  variantSubtags;
+
+  /**
+   * Get the extension as a single string or <code>null</code>.
+   *
+   * The extension always consists of a singleton character (not 'x'),
+   * a dash '-' and one or more extension token, each separated
+   * again with a dash.
+   *
+   * @type {string|null}
+   * @public
+   */
+  extension;
+
+  /**
+   * Get the extensions as an array of tokens.
+   *
+   * The leading singleton and the separating dashes are not part of the result.
+   * If there is no extensions section in the language tag, an empty array is returned.
+   *
+   * @type {string[]}
+   * @public
+   */
+  extensionSubtags;
+
+  /**
+   * Get the private use section or <code>null</code>.
+   *
+   * @type {string}
+   */
+  privateUse;
+
+  /**
+   * Get the private use section as an array of tokens.
+   *
+   * The leading singleton and the separating dashes are not part of the result.
+   * If there is no private use section in the language tag, an empty array is returned.
+   *
+   * @type {string[]}
+   */
+  privateUseSubtags;
+  constructor(sLanguageTag) {
+    var aResult = rLanguageTag.exec(sLanguageTag.replace(/_/g, "-"));
+    // If the given language tag string cannot be parsed by the regular expression above,
+    // we should at least tell the developer why the Core fails to load.
+    if (aResult === null) {
+      throw new TypeError("The given language tag'" + sLanguageTag + "' does not adhere to BCP-47.");
+    }
+    this.language = aResult[1] || null;
+    this.script = aResult[2] || null;
+    this.region = aResult[3] || null;
+    this.variant = aResult[4] && aResult[4].slice(1) || null; // remove leading dash from capturing group
+    this.variantSubtags = this.variant ? this.variant.split('-') : [];
+    this.extension = aResult[5] && aResult[5].slice(1) || null; // remove leading dash from capturing group
+    this.extensionSubtags = this.variant ? this.variant.split('-') : [];
+    this.privateUse = aResult[6] || null;
+    this.privateUseSubtags = this.privateUse ? this.privateUse.slice(2).split('-') : [];
+    // convert subtags according to the BCP47 recommendations
+    // - language: all lower case
+    // - script: lower case with the first letter capitalized
+    // - region: all upper case
+    if (this.language) {
+      this.language = this.language.toLowerCase();
+    }
+    if (this.script) {
+      this.script = this.script.toLowerCase().replace(/^[a-z]/, function ($) {
+        return $.toUpperCase();
+      });
+    }
+    if (this.region) {
+      this.region = this.region.toUpperCase();
+    }
+    Object.freeze(this);
+  }
+  toString() {
+    return this.#join(this.language, this.script, this.region, this.variant, this.extension, this.privateUse);
+  }
+  #join() {
+    return Array.prototype.filter.call(arguments, Boolean).join("-");
+  }
+}
+export default LanguageTag;

package/dist/sap/base/i18n/Localization.d.ts

@@ -0,0 +1,4 @@
+declare const Localization: {
+    getModernLanguage: (sLanguage: string) => string;
+};
+export default Localization;