@ui5/webcomponents-localization 1.22.0-rc.1 → 1.22.0-rc.3

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.3
+ *
+ * @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,240 +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 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, vDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.FATAL, sMessage, vDetails, sComponent, fnSupportInfo);
-};
-Log.error = function (sMessage, vDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.ERROR, sMessage, vDetails, sComponent, fnSupportInfo);
-};
-Log.warning = function (sMessage, vDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.WARNING, sMessage, vDetails, sComponent, fnSupportInfo);
-};
-Log.info = function (sMessage, vDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.INFO, sMessage, vDetails, sComponent, fnSupportInfo);
-};
-Log.debug = function (sMessage, vDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.DEBUG, sMessage, vDetails, sComponent, fnSupportInfo);
-};
-Log.trace = function (sMessage, vDetails, sComponent, fnSupportInfo) {
-    log(Log.Level.TRACE, sMessage, vDetails, sComponent, fnSupportInfo);
-};
-Log.setLevel = function (iLogLevel, sComponent, _bDefault) {
-    sComponent = sComponent || '';
-    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);
-};
-Log.isLoggable = function (iLevel, sComponent) {
-    return (iLevel == null ? Log.Level.DEBUG : iLevel) <= level(sComponent);
-};
-Log.logSupportInfo = function (bEnabled) {
-    bLogSupportInfo = bEnabled;
-};
-function log(iLevel, sMessage, vDetails, sComponent, fnSupportInfo) {
-    if (!fnSupportInfo && !sComponent && typeof vDetails === 'function') {
-        fnSupportInfo = vDetails;
-        vDetails = '';
-    }
-    if (!fnSupportInfo && typeof sComponent === 'function') {
-        fnSupportInfo = sComponent;
-        sComponent = '';
-    }
-    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(vDetails || ''),
-                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 = vDetails 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', vDetails) : console.error(logText);
-                break;
-            case Log.Level.WARNING:
-                isDetailsError ? console.warn(logText, '\n', vDetails) : console.warn(logText);
-                break;
-            case Log.Level.INFO:
-                if (console.info) {
-                    isDetailsError ? console.info(logText, '\n', vDetails) : console.info(logText);
-                } else {
-                    isDetailsError ? console.log(logText, '\n', vDetails) : console.log(logText);
-                }
-                break;
-            case Log.Level.DEBUG:
-                isDetailsError ? console.debug(logText, '\n', vDetails) : console.debug(logText);
-                break;
-            case Log.Level.TRACE:
-                isDetailsError ? console.trace(logText, '\n', vDetails) : console.trace(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,7 +1,34 @@
+// 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;
+    /*eslint-disable no-console */
     console.assert(bResult, sMessage);
+    /*eslint-enable no-console */
   }
 };
-export default fnAssert;
+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: {}
+};