@openui5/sap.ui.mdc 1.102.2 → 1.104.0

package/.reuse/dep5

@@ -137,6 +137,11 @@ Copyright: jQuery Foundation and other contributors
 License: MIT
 Comment: these files belong to: QUnit 2
 
+Files: src/sap.ui.core/test/sap/ui/core/qunit/thirdparty/qunit-2.18.*
+Copyright: jQuery Foundation and other contributors
+License: MIT
+Comment: these files belong to: QUnit 2.18
+
 Files: src/sap.ui.core/src/sap/ui/thirdparty/jquery-compat.js
 Copyright: OpenJS Foundation and other contributors
 License: MIT
@@ -234,6 +239,11 @@ Copyright: 2010-2017, Christian Johansen, christian@cjohansen.no
 License: BSD-3-Clause
 Comment: these files belong to: SinonJS
 
+Files: src/sap.ui.core/test/sap/ui/core/qunit/thirdparty/sinon-14.0.*
+Copyright: 2010-2022, Christian Johansen, christian@cjohansen.no
+License: BSD-3-Clause
+Comment: these files belong to: SinonJS 14
+
 Files: src/sap.ui.core/src/sap/ui/thirdparty/sinon-qunit.js
 Copyright: 2010-2011, Christian Johansen
 License: BSD-3-Clause
@@ -339,6 +349,13 @@ Copyright:
 License: Apache-2.0 and ISC
 Comment: these files contain content from SAP and node-lru-cache: LRUPersistentCache.js is overall written by SAP, but portions ('Least Recently Used' logic) are taken from the node-lru-cache project (see https://github.com/isaacs/node-lru-cache/blob/v2.7.3/README.md) and modified.
 
+Files: src/sap.ui.core/test/sap/ui/core/qunit/i18n/helper/_timezones.js
+Copyright:
+    2009-2022 SAP SE or an SAP affiliate company and OpenUI5 contributors
+    Arthur David Olson, Paul Eggert and other contributors
+License: Apache-2.0 and LicenseRef-tzdata-PublicDomain
+Comment: these files contain content from SAP and Time Zone Database: _timezones.js is overall written by SAP, but the list of IANA timezone IDs is taken from the Timezone Database
+
 
 # Library: sap.ui.documentation:
 

package/LICENSES/LicenseRef-tzdata-PublicDomain.txt

@@ -0,0 +1,5 @@
+Unless specified below, all files in the tz code and data (including
+this LICENSE file) are in the public domain.
+
+If the files date.c, newstrftime.3, and strftime.c are present, they
+contain material derived from BSD and use the BSD 3-clause license.

package/THIRDPARTY.txt

@@ -76,6 +76,12 @@ License: MIT
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/MIT.txt
 Contained in: src/sap.ui.core/src/sap/ui/thirdparty/qunit-2.*
 
+Component: QUnit 2.18, version: 2.18.0
+Copyright: jQuery Foundation and other contributors
+License: MIT
+License Text: https://github.com/SAP/openui5/blob/master/LICENSES/MIT.txt
+Contained in: src/sap.ui.core/test/sap/ui/core/qunit/thirdparty/qunit-2.18.*
+
 Component: jQuery-Migrate, version: 3.3.1
 Copyright: OpenJS Foundation and other contributors
 License: MIT
@@ -191,13 +197,19 @@ License: BSD-3-Clause
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/BSD-3-Clause.txt
 Contained in: src/sap.ui.core/src/sap/ui/thirdparty/sinon-4.js
 
+Component: SinonJS 14, version: 14.0.0
+Copyright: 2010-2022, Christian Johansen, christian@cjohansen.no
+License: BSD-3-Clause
+License Text: https://github.com/SAP/openui5/blob/master/LICENSES/BSD-3-Clause.txt
+Contained in: src/sap.ui.core/test/sap/ui/core/qunit/thirdparty/sinon-14.0.*
+
 Component: Sinon-qunit, version: 2.0.0
 Copyright: 2010-2011, Christian Johansen
 License: BSD-3-Clause
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/BSD-3-Clause.txt
 Contained in: src/sap.ui.core/src/sap/ui/thirdparty/sinon-qunit.js
 
-Component: URI.js, version: 1.19.10
+Component: URI.js, version: 1.19.11
 Copyright: Rodney Rehm
 License: MIT
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/MIT.txt
@@ -315,6 +327,12 @@ License: ISC
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/ISC.txt
 Contained in: src/sap.ui.core/src/sap/ui/core/cache/LRUPersistentCache.js
 
+Component: Time Zone Database, version: 2022a
+Copyright: Arthur David Olson, Paul Eggert and other contributors
+License: LicenseRef-tzdata-PublicDomain
+License Text: https://github.com/SAP/openui5/blob/master/LICENSES/LicenseRef-tzdata-PublicDomain.txt
+Contained in: src/sap.ui.core/test/sap/ui/core/qunit/i18n/helper/_timezones.js
+
 
 Library: sap.ui.documentation:
 
@@ -450,7 +468,7 @@ License: Apache-2.0
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/Apache-2.0.txt
 Contained in: lib/jsdoc/ui5/plugin.js
 
-Component: SAP Theming Base Content, version: 11.1.39
+Component: SAP Theming Base Content, version: 11.1.40
 Copyright: SAP SE or an SAP affiliate company and Theming Base Content contributors
 License: Apache-2.0
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/Apache-2.0.txt
@@ -980,6 +998,21 @@ END of license: LicenseRef-JSONinJSPublicDomain
 =================================
 
 
+=================================
+BEGIN of license: LicenseRef-tzdata-PublicDomain
+=================================
+
+Unless specified below, all files in the tz code and data (including
+this LICENSE file) are in the public domain.
+
+If the files date.c, newstrftime.3, and strftime.c are present, they
+contain material derived from BSD and use the BSD 3-clause license.
+
+=================================
+END of license: LicenseRef-tzdata-PublicDomain
+=================================
+
+
 =================================
 BEGIN of license: MIT
 =================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/sap.ui.mdc",
-  "version": "1.102.2",
+  "version": "1.104.0",
   "description": "OpenUI5 UI Library sap.ui.mdc",
   "author": "SAP SE (https://www.sap.com)",
   "license": "Apache-2.0",
@@ -14,8 +14,8 @@
     "url": "https://github.com/SAP/openui5.git"
   },
   "dependencies": {
-    "@openui5/sap.m": "1.102.2",
-    "@openui5/sap.ui.core": "1.102.2",
-    "@openui5/sap.ui.layout": "1.102.2"
+    "@openui5/sap.m": "1.104.0",
+    "@openui5/sap.ui.core": "1.104.0",
+    "@openui5/sap.ui.layout": "1.104.0"
   }
 }

package/src/sap/ui/mdc/.library

@@ -6,7 +6,7 @@
 	<copyright>OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-	<version>1.102.2</version>
+	<version>1.104.0</version>
 
 	<documentation>UI5 library: sap.ui.mdc</documentation>
 

package/src/sap/ui/mdc/ActionToolbar.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * @class The column for the metadata driven table, that hold the template to be shown when the rows has data.
 	 * @extends sap.m.OverflowToolbar
 	 * @author SAP SE
-	 * @version 1.102.2
+	 * @version 1.104.0
 	 * @constructor
 	 * @private
 	 * @since 1.58

package/src/sap/ui/mdc/AggregationBaseDelegate.js

@@ -101,6 +101,17 @@ sap.ui.define(['sap/ui/mdc/BaseDelegate', 'sap/ui/core/library'], function (Base
 				/* Please provide a meaningful message here. */
 				message: undefined
 			};
+		},
+
+		/**
+		 * Hook that will be executed when changes are done applying to controls during the XML flexibility change appliance process.
+		 *
+		 * @param {Object<sap.ui.mdc.Control>} oControl Instance of an MDC control
+		 * @param {Object} mPropertyBag Property bag from SAPUI5 flexibility
+		 *
+		 */
+		onAfterXMLChangeProcessing: function(oControl, mPropertyBag) {
+			//Neccessary cleanups can be implemented here
 		}
 
 

package/src/sap/ui/mdc/Chart.js

@@ -25,7 +25,8 @@ sap.ui.define([
         "sap/ui/base/ManagedObjectObserver",
         "sap/ui/mdc/chart/DrillBreadcrumbs",
         "sap/ui/mdc/actiontoolbar/ActionToolbarAction",
-        "sap/ui/thirdparty/jquery"
+        "sap/ui/thirdparty/jquery",
+        "sap/ui/core/library"
     ],
     function (
         Core,
@@ -48,21 +49,23 @@ sap.ui.define([
         ManagedObjectObserver,
         Breadcrumbs,
         ActionToolbarAction,
-        jQuery
+        jQuery,
+        coreLibrary
     ) {
         "use strict";
 
         var DrillStackHandler;
+        var TitleLevel = coreLibrary.TitleLevel;
 
         /**
          * Constructor for a new Chart.
          *
-         * @param {string} [sId] id for the new control, generated automatically if no id is given
-         * @param {object} [mSettings] initial settings for the new control
+         * @param {string} [sId] ID for the new control, generated automatically if no id is given
+         * @param {object} [mSettings] Initial settings for the new control
          * @class The Chart control creates a chart based on metadata and the configuration specified.
          * @extends sap.ui.mdc.Control
          * @author SAP SE
-         * @version 1.102.2
+         * @version 1.104.0
          * @constructor
          * @experimental As of version ...
          * @private
@@ -70,7 +73,6 @@ sap.ui.define([
          * @MDC_PUBLIC_CANDIDATE
          * @since 1.88
          * @alias sap.ui.mdc.Chart
-         * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
          */
         var Chart = Control.extend("sap.ui.mdc.Chart", /** @lends sap.ui.mdc.Chart.prototype */ {
             metadata: {
@@ -225,13 +227,16 @@ sap.ui.define([
                         group: "Misc",
                         defaultValue: "column"
                     },
+                    /**
+                     * Enables the Details button in the chart toolbar.
+                     */
                     showSelectionDetails: {
                         type: "boolean",
                         group: "Misc",
                         defaultValue: true
                     },
                     /**
-                     * Specifies the filter metadata.<br>
+                     * Specifies the chart metadata.<br>
                      * <b>Note</b>: This property must not be bound.<br>
                      * <b>Note</b>: This property is used exclusively for SAPUI5 flexibility/ Fiori Elements. Do not use it otherwise.
                      *
@@ -240,13 +245,32 @@ sap.ui.define([
                     propertyInfo: {
                         type: "object",
                         defaultValue: []
+                    },
+                    /**
+                    * Semantic level of the header.
+                    * For more information, see {@link sap.m.Title#setLevel}.
+                    *
+                    * @since 1.104
+                    */
+                    headerLevel: {
+                        type: "sap.ui.core.TitleLevel",
+                        group: "Appearance",
+                        defaultValue: TitleLevel.Auto
                     }
                 },
                 aggregations: {
+                    /**
+                     * This property describes the measures and dimensions visible in the chart.
+                     * Changes in the personalization are also reflected here.
+                     */
                     items: {
                         type: "sap.ui.mdc.chart.Item",
                         multiple: true
                     },
+                    /**
+                     * This aggregation describes actions that are added to the chart toolbar.
+                     * See {@link sap.ui.mdc.actiontoolbar.ActionToolbarAction} for more information.
+                     */
                     actions: {
                         type: "sap.ui.core.Control",
                         multiple: true,
@@ -275,7 +299,7 @@ sap.ui.define([
                         multiple: false
                     },
                     /**
-                     * <code>VariantManagement<code> control for the chart.
+                     * Reference to a {@link sap.ui.fl.variants.VariantManagement} control for the chart.
                      */
                     variant: {
                         type: "sap.ui.fl.variants.VariantManagement",
@@ -284,7 +308,7 @@ sap.ui.define([
                 },
                 associations: {
                     /**
-                     * Control or object which enables the chart to do filtering, such as {@link sap.ui.mdc.FilterBar}.
+                     * Control or object that enables the chart to do filtering, such as {@link sap.ui.mdc.FilterBar}.
                      * Also see {@link sap.ui.mdc.IFilter}.
                      *
                      * @since 1.88
@@ -364,6 +388,16 @@ sap.ui.define([
             this._setPropertyHelperClass(PropertyHelper);
         };
 
+        /**
+         * Defines which personalization options are available in the chart.
+         * Valid options are: "Item", "Sort", "Type".
+         * @param {array} aMode String array containing the p13n options that are available
+         * @returns {sap.ui.mdc.Chart} Reference to <code>this</code> for method chaining
+         *
+         * @experimental
+         * @private
+         * @ui5-restricted Fiori Elements
+         */
         Chart.prototype.setP13nMode = function(aMode) {
             var aSortedKeys = null;
             if (aMode && aMode.length >= 1){
@@ -426,11 +460,6 @@ sap.ui.define([
 
         };
 
-
-        Chart.prototype.isFilteringEnabled = function() {
-            return this.getP13nMode().indexOf("Filter") > -1;
-        };
-
         Chart.prototype.setFilterConditions = function(mConditions) {
             this.setProperty("filterConditions", mConditions, true);
 
@@ -442,6 +471,14 @@ sap.ui.define([
             return this;
         };
 
+        /**
+         * Getter for <code>filterConditions</code> set in the personalization settings.
+         * @returns {array} Filters set in the chart
+         *
+         * @experimental
+         * @private
+         * @ui5-restricted Fiori Elements
+         */
         Chart.prototype.getConditions = function() {
             //may only return conditions if the inner FilterBar has already been initialized
             return this.getInbuiltFilter() ? this.getInbuiltFilter().getConditions() : [];
@@ -454,7 +491,7 @@ sap.ui.define([
         };
 
         /**
-         * Applies given settings onto the MDC Chart, loads the delegate and initializes the MDC Chart
+         * Applies given settings onto the MDC chart, loads the delegate and initializes the MDC chart
          *
          * @param {*} mSettings settings to apply
          *
@@ -501,7 +538,7 @@ sap.ui.define([
         };
 
         /**
-         * Initializes the inner controls of the MDC Chart (toolbar, inner chart)
+         * Initializes the inner controls of the MDC chart (toolbar, inner chart)
          * Inner chart is initialized via the delegate
          */
         Chart.prototype._initInnerControls = function () {
@@ -554,7 +591,7 @@ sap.ui.define([
                         ]
                     });
 
-                    //Sync MDC Chart properties with inner chart
+                    //Sync MDC chart properties with inner chart
                     this._propagatePropertiesToInnerChart();
 
                     this._fnResolveInnerChartBound();
@@ -562,6 +599,15 @@ sap.ui.define([
             }.bind(this));
         };
 
+        /**
+         * Defines the height of the chart.
+         * @param {sap.ui.core.CSSSize} iHeight New height for the chart.
+         * @returns {sap.ui.mdc.Chart} Reference to <code>this</code> for method chaining
+         *
+         * @experimental
+         * @private
+         * @ui5-restricted Fiori Elements
+         */
         Chart.prototype.setHeight = function(iHeight) {
             try {
                 this.getControlDelegate().adjustChartHeight(this);
@@ -587,7 +633,7 @@ sap.ui.define([
         };
 
         /**
-         * Loads the delegate for the MDC Chart
+         * Loads the delegate for the MDC chart
          * @returns {Promise} resolved when delegate is loaded
          */
         Chart.prototype._loadDelegate = function () {
@@ -604,7 +650,8 @@ sap.ui.define([
 
         };
         /**
-         * Gets whether filtering is enabled for p13n
+         * Gets whether filtering is enabled in the personalization dialog.
+         * @returns {boolean} <code>true</code> if filtering enabled, <code>false</code> if otherwise
          *
          * @experimental
          * @private
@@ -615,8 +662,13 @@ sap.ui.define([
         };
 
         /**
-         * Gets the adaption UI for the p13n dialog
-         * @returns {Prmoise} promise that resolves with UI
+         * Gets the adaptation panel for the p13n dialog.
+         * <b>Note:</b> This is only used for  personalization, do not use it otherwise.
+         * @returns {Promise} <code>Promise</code> that resolves with the adaptation panel control
+         *
+         * @experimental
+         * @private
+         * @ui5-restricted sap.ui.mdc
          */
         Chart.prototype.getAdaptationUI = function () {
             return this.getControlDelegate().getAdaptionUI(this);
@@ -739,30 +791,11 @@ sap.ui.define([
             }
         };
 
-        //TODO: Think of a good name
-        Chart.prototype._addItems = function () {
-
-        };
-
-        /**
-         * Gets the collection model from the binding information
-         * @returns {object} Object containing the binding information
-         *
-         * @experimental
-         * @private
-         * @ui5-restricted Fiori Elements
-         */
-        Chart.prototype.getCollectionModel = function () {
-            var oBindingInfo = this.getBindingInfo("data");
-            return oBindingInfo ? this.getModel(oBindingInfo.model) : null;
-        };
-
-
         /**
-         * Can be used to check whether the chart is initialized
-         * After initialization the delegate should be loaded and (in case of autoBindOnInit=true) the inner chart has been created
-         * This does not include the inner chart to be bound. Use <code>innerChartBound</code> for it.
-         * @returns {Promise} Promise that resolves once MDC Chart is initialized. Contains reference to MDC Chart
+         * Checks whether the chart is initialized.
+         * After initialization the delegate is loaded and (in case of <code>autoBindOnInit=true</code>) the inner chart is created.
+         * The inner chart is not bound yet. Use <code>innerChartBound</code> for it.
+         * @returns {Promise} <code>Promise</code> that resolves once MDC chart is initialized. Contains reference to MDC chart
          *
          * @experimental
          * @private
@@ -773,8 +806,8 @@ sap.ui.define([
         };
 
         /**
-         * Can be used to check whether the inner chart is initialized and bound
-         * @returns {Promise} Promise that resolves once MDC Chart is bound
+         * Can be used to check whether the inner chart is initialized and bound.
+         * @returns {Promise} Promise that resolves once MDC chart is bound
          *
          * @experimental
          * @private
@@ -785,7 +818,7 @@ sap.ui.define([
         };
 
         /**
-         * Zooms in the inner chart
+         * Zooms in the inner chart.
          * @param {int} iValue how much steps should be zoomed in
          *
          * @experimental
@@ -801,7 +834,7 @@ sap.ui.define([
         };
 
         /**
-         * Zooms out the inner chart
+         * Zooms out the inner chart.
          * @param {int} iValue how much steps should be zoomed out
          *
          * @experimental
@@ -833,22 +866,49 @@ sap.ui.define([
             return this.getControlDelegate().getZoomState(this);
         };
 
+        /**
+         * Retrieves the selection handler of the inner chart.
+         * @returns {object} Selection handler of the inner chart
+         *
+         * @experimental
+         * @private
+         * @ui5-restricted sap.ui.mdc, sap.fe
+         */
         Chart.prototype.getSelectionHandler = function () {
             return this.getControlDelegate().getInnerChartSelectionHandler(this);
         };
 
+        /**
+         * Retrieves the chart type layout configuration.
+         * <b>Note:</b> This is only used inside personalization.
+         * @returns {object} Layout configuration
+         *
+         * @experimental
+         * @private
+         * @ui5-restricted sap.ui.mdc
+         */
         Chart.prototype.getChartTypeLayoutConfig = function() {
             return this.getControlDelegate().getChartTypeLayoutConfig();
         };
 
+        /**
+         * Retrieves the allowed chart roles for the chart types.
+         * <b>Note:</b> This is only used inside the personalization.
+         * @returns {object} Allowed roles
+         *
+         * @experimental
+         * @private
+         * @ui5-restricted sap.ui.mdc
+         */
         Chart.prototype.getAllowedRolesForKinds = function() {
             return this.getControlDelegate().getAllowedRolesForKinds();
         };
 
         /**
-         * Sets the visibility of the legend
-         * Calls the Delegates <code>setLegendVisible</code>. Never call the delegates function directly as it would not update the Chart Toolbar!
-         * @param {boolean} bVisible true to show legend, false to hide
+         * Sets the visibility of the legend.
+         * Calls <code>setLegendVisible</code> on the delegate.
+         * @param {boolean} bVisible <code>true</code> to show legend, <code>false</code> to hide
+         * @returns {sap.ui.mdc.Chart} Reference to <code>this</code> for method chaining
          *
          * @experimental
          * @private
@@ -871,7 +931,7 @@ sap.ui.define([
         /**
          * Sets the ShowChartTooltip Property
          * @param {boolean} bValue true for visible; false for invisible
-         * @returns {sap.ui.mdc.Chart} the MDC Chart
+         * @returns {sap.ui.mdc.Chart} the MDC chart
          */
         Chart.prototype.setShowChartTooltip = function (bValue) {
             this.setProperty("showChartTooltip", bValue);
@@ -931,7 +991,7 @@ sap.ui.define([
         };
 
         /**
-         * If some properties are set on the MDC Chart while the inner chart is not yet initialized, they need to eb set after initialaization.
+         * If some properties are set on the MDC chart while the inner chart is not yet initialized, they need to eb set after initialaization.
          * This methods gets called after inner chart is ready and takes care of that
          *
          * @private
@@ -946,7 +1006,7 @@ sap.ui.define([
         /**
          * Gets information about the current chart type.
          *
-         * @returns {sap.ui.mdc.Chart.ChartTypeInfo} Object containing information about the chart type
+         * @returns {object} object containing information about the chart type
          *
          * @experimental
          * @private
@@ -986,7 +1046,7 @@ sap.ui.define([
 
 
         /**
-         * Sets the MDC Chart to a specific chart type
+         * Sets the MDC chart to a specific chart type
          * @param {string} sChartType the name of the new chart type
          * @returns {sap.ui.mdc.chart} reference to <code>this</code> for method chaining
          */
@@ -1008,7 +1068,7 @@ sap.ui.define([
          *
          * @experimental
          * @private
-         * @ui5-restricted Fiori Elements
+         * @ui5-restricted sap.ui.mdc
          */
         Chart.prototype.getManagedObjectModel = function () {
             return this._oManagedObjectModel;
@@ -1137,7 +1197,7 @@ sap.ui.define([
 
         /**
 		 * Callback for when fuilters changed
-		 * Activates the overlay on the MDC Chart
+		 * Activates the overlay on the MDC chart
 		 *
 		 * @param oEvent filter changed event
 		 *
@@ -1185,6 +1245,16 @@ sap.ui.define([
 			}
 		};
 
+        /**
+         * Adds an action to the <code>actions</code> aggregation of the chart.
+         * If the given control is not of type {@link sap.ui.mdc.actiontoolbar.ActionToolbarAction}, a container is created for the control before passing it on to the {@link sap.ui.mdc.ActionToolbar}.
+         * @param {sap.ui.core.Control} oControl to add to the aggregation
+         * @return {sap.ui.mdc.Chart} Reference to <code>this</code> for method chaining.
+         *
+         * @experimental
+         * @private
+         * @ui5-restricted sap.ui.mdc, sap.fe
+         */
         Chart.prototype.addAction = function(oControl) {
             if (oControl.getMetadata().getName() !== "sap.ui.mdc.actiontoolbar.ActionToolbarAction") {
                 oControl = new ActionToolbarAction(oControl.getId() + "-action", {
@@ -1195,5 +1265,19 @@ sap.ui.define([
             return Control.prototype.addAggregation.apply(this, ["actions", oControl]);
         };
 
+        /**
+         * Specifies the header level for the title of the chart.
+         * @param {sap.ui.core.TitleLevel} sHeaderLevel Header level
+         * @returns {sap.ui.mdc.Chart} Reference to <code>this</code> in order to allow method chaining
+         */
+        Chart.prototype.setHeaderLevel = function(sHeaderLevel) {
+            if (this.getAggregation("_toolbar")) {
+                this.getAggregation("_toolbar")._setHeaderLevel(sHeaderLevel);
+            }
+
+            this.setProperty("headerLevel", sHeaderLevel);
+            return this;
+        };
+
         return Chart;
     });