@openui5/ts-types 1.122.0 → 1.123.0

package/types/sap.ui.commons.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.122.0
+// For Library Version: 1.123.0
 
 declare namespace sap {
   namespace ui {
@@ -76,29 +76,74 @@ declare namespace sap {
        * @deprecated (since 1.38)
        */
       namespace form {
+        /**
+         * Describes the settings that can be provided to the Form constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $FormSettings extends sap.ui.layout.form.$FormSettings {}
 
+        /**
+         * Describes the settings that can be provided to the FormContainer constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $FormContainerSettings
           extends sap.ui.layout.form.$FormContainerSettings {}
 
+        /**
+         * Describes the settings that can be provided to the FormElement constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $FormElementSettings
           extends sap.ui.layout.form.$FormElementSettings {}
 
+        /**
+         * Describes the settings that can be provided to the FormLayout constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $FormLayoutSettings
           extends sap.ui.layout.form.$FormLayoutSettings {}
 
+        /**
+         * Describes the settings that can be provided to the GridContainerData constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $GridContainerDataSettings
           extends sap.ui.layout.form.$GridContainerDataSettings {}
 
+        /**
+         * Describes the settings that can be provided to the GridElementData constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $GridElementDataSettings
           extends sap.ui.layout.form.$GridElementDataSettings {}
 
+        /**
+         * Describes the settings that can be provided to the GridLayout constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $GridLayoutSettings
           extends sap.ui.layout.form.$GridLayoutSettings {}
 
+        /**
+         * Describes the settings that can be provided to the ResponsiveLayout constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $ResponsiveLayoutSettings
           extends sap.ui.layout.form.$ResponsiveLayoutSettings {}
 
+        /**
+         * Describes the settings that can be provided to the SimpleForm constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $SimpleFormSettings
           extends sap.ui.layout.form.$SimpleFormSettings {
           /**
@@ -945,6 +990,11 @@ declare namespace sap {
        * @deprecated (since 1.38)
        */
       namespace layout {
+        /**
+         * Describes the settings that can be provided to the AbsoluteLayout constructor.
+         *
+         * @deprecated (since 1.38) - the concept has been discarded.
+         */
         interface $AbsoluteLayoutSettings extends sap.ui.core.$ControlSettings {
           /**
            * The overall width of the control. When not set, 100% is automatically set.
@@ -988,6 +1038,11 @@ declare namespace sap {
             | `{${string}}`;
         }
 
+        /**
+         * Describes the settings that can be provided to the BorderLayout constructor.
+         *
+         * @deprecated (since 1.38) - replaced by {@link sap.m.Page}
+         */
         interface $BorderLayoutSettings extends sap.ui.core.$ControlSettings {
           /**
            * The RTL setting swaps the areas Begin and End.
@@ -1041,6 +1096,11 @@ declare namespace sap {
           bottom?: sap.ui.commons.layout.BorderLayoutArea;
         }
 
+        /**
+         * Describes the settings that can be provided to the BorderLayoutArea constructor.
+         *
+         * @deprecated (since 1.38) - Instead, use the `sap.m.Page` control.
+         */
         interface $BorderLayoutAreaSettings
           extends sap.ui.core.$ElementSettings {
           /**
@@ -1094,9 +1154,19 @@ declare namespace sap {
             | `{${string}}`;
         }
 
+        /**
+         * Describes the settings that can be provided to the HorizontalLayout constructor.
+         *
+         * @deprecated (since 1.38) - Instead, use the `sap.ui.layout.HorizontalLayout` control.
+         */
         interface $HorizontalLayoutSettings
           extends sap.ui.layout.$HorizontalLayoutSettings {}
 
+        /**
+         * Describes the settings that can be provided to the MatrixLayout constructor.
+         *
+         * @deprecated (since 1.38) - Instead, use the `sap.ui.layout.Grid` control.
+         */
         interface $MatrixLayoutSettings extends sap.ui.core.$ControlSettings {
           /**
            * CSS width of the matrix layout. If the LayoutFixed = true an adequate width should be provided.
@@ -1152,6 +1222,11 @@ declare namespace sap {
             | `{${string}}`;
         }
 
+        /**
+         * Describes the settings that can be provided to the MatrixLayoutCell constructor.
+         *
+         * @deprecated (since 1.38) - Instead, use the `sap.ui.layout.Grid` control.
+         */
         interface $MatrixLayoutCellSettings
           extends sap.ui.core.$ElementSettings {
           /**
@@ -1227,6 +1302,11 @@ declare namespace sap {
             | `{${string}}`;
         }
 
+        /**
+         * Describes the settings that can be provided to the MatrixLayoutRow constructor.
+         *
+         * @deprecated (since 1.38) - Instead, use the `sap.ui.layout.Grid` control.
+         */
         interface $MatrixLayoutRowSettings
           extends sap.ui.core.$ElementSettings {
           /**
@@ -1247,6 +1327,11 @@ declare namespace sap {
             | `{${string}}`;
         }
 
+        /**
+         * Describes the settings that can be provided to the PositionContainer constructor.
+         *
+         * @deprecated (since 1.38)
+         */
         interface $PositionContainerSettings
           extends sap.ui.core.$ElementSettings {
           /**
@@ -1305,19 +1390,34 @@ declare namespace sap {
           control?: sap.ui.core.Control;
         }
 
+        /**
+         * Describes the settings that can be provided to the ResponsiveFlowLayout constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $ResponsiveFlowLayoutSettings
           extends sap.ui.layout.$ResponsiveFlowLayoutSettings {}
 
+        /**
+         * Describes the settings that can be provided to the ResponsiveFlowLayoutData constructor.
+         *
+         * @deprecated (since 1.16.0) - moved to sap.ui.layout library. Please use this one.
+         */
         interface $ResponsiveFlowLayoutDataSettings
           extends sap.ui.layout.$ResponsiveFlowLayoutDataSettings {}
 
+        /**
+         * Describes the settings that can be provided to the VerticalLayout constructor.
+         *
+         * @deprecated (since 1.16.0) - Moved to sap.ui.layout library. Please use this one.
+         */
         interface $VerticalLayoutSettings
           extends sap.ui.layout.$VerticalLayoutSettings {}
 
         /**
          * The Absolute Layout positions its child controls absolutely
          *
-         * @deprecated (since 1.38)
+         * @deprecated (since 1.38) - the concept has been discarded.
          */
         class AbsoluteLayout extends sap.ui.core.Control {
           /**
@@ -4041,7 +4141,8 @@ declare namespace sap {
          * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
          * 'layout.BorderLayoutAreaTypes'.
          *
-         * @deprecated (since 1.38)
+         * @deprecated (since 1.38) - (altogether with sap.ui.commons.layout.BorderLayout). Use sap.m.Page instead
+         * with its aggregations.
          */
         enum BorderLayoutAreaTypes {
           /**
@@ -4203,7 +4304,7 @@ declare namespace sap {
          * This enum is part of the 'sap/ui/commons/MessageBox' module export and must be accessed by the property
          * 'Action'.
          *
-         * @deprecated (since 1.38)
+         * @deprecated (since 1.38) - Instead, use the `sap.m.MessageBox.Action`.
          */
         enum Action {
           /**
@@ -4245,7 +4346,7 @@ declare namespace sap {
          * This enum is part of the 'sap/ui/commons/MessageBox' module export and must be accessed by the property
          * 'Icon'.
          *
-         * @deprecated (since 1.38)
+         * @deprecated (since 1.38) - Instead, use the `sap.m.MessageBox.Icon`.
          */
         enum Icon {
           /**
@@ -4283,7 +4384,7 @@ declare namespace sap {
       /**
        * Marker interface for common controls which are suitable for use within a FormattedTextView.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - the concept has been discarded.
        */
       interface FormattedTextViewControl {
         __implements__sap_ui_commons_FormattedTextViewControl: boolean;
@@ -4296,12 +4397,17 @@ declare namespace sap {
        * Toolbar items must have a fixed height compatible with the toolbar being a single horizontal row. They
        * can refer to the toolbar's marker class "sapUiTb" to adjust their own theming when used inside a toolbar.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - (altogether with sap.ui.commons.Toolbar). Use sap.m.Toolbar instead.
        */
       interface ToolbarItem {
         __implements__sap_ui_commons_ToolbarItem: boolean;
       }
 
+      /**
+       * Describes the settings that can be provided to the Accordion constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Panel}.
+       */
       interface $AccordionSettings extends sap.ui.core.$ControlSettings {
         /**
          * When the specified width is less than the width of a section content, a horizontal scroll bar is provided.
@@ -4343,6 +4449,11 @@ declare namespace sap {
         sectionsReorder?: (oEvent: Accordion$SectionsReorderEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the AccordionSection constructor.
+       *
+       * @deprecated (since 1.38) - the concept has been discarded.
+       */
       interface $AccordionSectionSettings extends sap.ui.core.$ElementSettings {
         /**
          * When the section content exceeds maxHeight, a vertical scroll bar appears.
@@ -4393,6 +4504,11 @@ declare namespace sap {
         scroll?: (oEvent: AccordionSection$ScrollEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the ApplicationHeader constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.tnt.ToolHeader` control.
+       */
       interface $ApplicationHeaderSettings
         extends sap.ui.core.$ControlSettings {
         /**
@@ -4435,6 +4551,11 @@ declare namespace sap {
         logoff?: (oEvent: sap.ui.base.Event) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the Area constructor.
+       *
+       * @deprecated (since 1.38)
+       */
       interface $AreaSettings extends sap.ui.core.$ElementSettings {
         /**
          * The value is a string and can be 'rect' for rectangle, 'poly' for poligon, 'circle', or default.
@@ -4460,6 +4581,11 @@ declare namespace sap {
         alt?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
       }
 
+      /**
+       * Describes the settings that can be provided to the AutoComplete constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Input}.
+       */
       interface $AutoCompleteSettings extends sap.ui.commons.$ComboBoxSettings {
         /**
          * Determines whether scrolling should be enabled when the number of items is higher than maxPopupItems.
@@ -4476,6 +4602,11 @@ declare namespace sap {
         suggest?: (oEvent: AutoComplete$SuggestEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the Button constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Button}
+       */
       interface $ButtonSettings extends sap.ui.core.$ControlSettings {
         /**
          * Button text displayed at runtime.
@@ -4591,6 +4722,12 @@ declare namespace sap {
         press?: (oEvent: sap.ui.base.Event) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the Callout constructor.
+       *
+       * @deprecated (since 1.38) - If you want to achieve a similar behavior, use a `sap.m.Popover` control and
+       * open it next to your control.
+       */
       interface $CalloutSettings extends sap.ui.commons.$CalloutBaseSettings {
         /**
          * Determines the content of the Callout
@@ -4602,6 +4739,12 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the CalloutBase constructor.
+       *
+       * @deprecated (since 1.38) - If you want to achieve a similar behavior, use the `sap.m.Popover` control
+       * and open it next to your control.
+       */
       interface $CalloutBaseSettings extends sap.ui.core.$TooltipBaseSettings {
         /**
          * The event is fired when the popup is opened.
@@ -4627,6 +4770,11 @@ declare namespace sap {
         opened?: (oEvent: sap.ui.base.Event) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the Carousel constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.Carousel` control.
+       */
       interface $CarouselSettings extends sap.ui.core.$ControlSettings {
         /**
          * Determines the orientation of the Carousel. Can be either "horizontal" or "vertical"
@@ -4712,6 +4860,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the CheckBox constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.CheckBox` control.
+       */
       interface $CheckBoxSettings extends sap.ui.core.$ControlSettings {
         /**
          * Contains the state of the control whether it is flagged with a check mark, or not
@@ -4790,9 +4943,19 @@ declare namespace sap {
         change?: (oEvent: CheckBox$ChangeEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the ColorPicker constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.ui.unified.ColorPicker}
+       */
       interface $ColorPickerSettings
         extends sap.ui.unified.$ColorPickerSettings {}
 
+      /**
+       * Describes the settings that can be provided to the ComboBox constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.ComboBox}
+       */
       interface $ComboBoxSettings extends sap.ui.commons.$TextFieldSettings {
         /**
          * Defines the number of items that shall be displayed at once. If the overall number of items is higher
@@ -4851,6 +5014,11 @@ declare namespace sap {
         listBox?: sap.ui.commons.ListBox | string;
       }
 
+      /**
+       * Describes the settings that can be provided to the DatePicker constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.DatePicker}
+       */
       interface $DatePickerSettings extends sap.ui.commons.$TextFieldSettings {
         /**
          * Defines the locale (language and country), e.g. "en-US", whose translations and Date formatters should
@@ -4866,6 +5034,11 @@ declare namespace sap {
         yyyymmdd?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
       }
 
+      /**
+       * Describes the settings that can be provided to the Dialog constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.Dialog` control.
+       */
       interface $DialogSettings extends sap.ui.core.$ControlSettings {
         /**
          * Outer width of dialog window. When not set and not constrained by one of the width parameters (minWidth/maxWidth),
@@ -5056,6 +5229,11 @@ declare namespace sap {
         closed?: (oEvent: Dialog$ClosedEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the DropdownBox constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.ComboBox}
+       */
       interface $DropdownBoxSettings extends sap.ui.commons.$ComboBoxSettings {
         /**
          * Whether the DropdownBox's search help should be enabled.
@@ -5103,12 +5281,29 @@ declare namespace sap {
         searchHelp?: (oEvent: DropdownBox$SearchHelpEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the FileUploader constructor.
+       *
+       * @deprecated (since 1.21.0) - Please use the control sap.ui.unified.FileUploader of the library sap.ui.unified
+       * instead.
+       */
       interface $FileUploaderSettings
         extends sap.ui.unified.$FileUploaderSettings {}
 
+      /**
+       * Describes the settings that can be provided to the FileUploaderParameter constructor.
+       *
+       * @deprecated (since 1.21.0) - Please use the element sap.ui.unified.FileUploaderParameter of the library
+       * sap.ui.unified instead.
+       */
       interface $FileUploaderParameterSettings
         extends sap.ui.unified.$FileUploaderParameterSettings {}
 
+      /**
+       * Describes the settings that can be provided to the FormattedTextView constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.ui.core.HTML` control.
+       */
       interface $FormattedTextViewSettings
         extends sap.ui.core.$ControlSettings {
         /**
@@ -5134,6 +5329,12 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the HorizontalDivider constructor.
+       *
+       * @deprecated (since 1.38) - Use the layout controls instead, e.g {@link sap.ui.layout.Splitter} or {@link sap.ui.layout.BlockLayout }
+       * among others.
+       */
       interface $HorizontalDividerSettings
         extends sap.ui.core.$ControlSettings {
         /**
@@ -5161,6 +5362,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the Image constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Image}
+       */
       interface $ImageSettings extends sap.ui.core.$ControlSettings {
         /**
          * Relative or absolute path to URL where the image file is stored.
@@ -5216,6 +5422,11 @@ declare namespace sap {
         press?: (oEvent: sap.ui.base.Event) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the ImageMap constructor.
+       *
+       * @deprecated (since 1.38) - There's not replacement because of the archaic design pattern.
+       */
       interface $ImageMapSettings extends sap.ui.core.$ControlSettings {
         /**
          * Name for the image that serves as reference
@@ -5237,6 +5448,11 @@ declare namespace sap {
         press?: (oEvent: ImageMap$PressEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the InPlaceEdit constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Input}
+       */
       interface $InPlaceEditSettings extends sap.ui.core.$ControlSettings {
         /**
          * Visualizes warnings or errors related to the InPlaceEdit. Possible values: Warning, Error, Success. If
@@ -5287,6 +5503,11 @@ declare namespace sap {
         liveChange?: (oEvent: InPlaceEdit$LiveChangeEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the Label constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.Label` control.
+       */
       interface $LabelSettings extends sap.ui.core.$ControlSettings {
         /**
          * Defines whether the labels are in bold format.
@@ -5374,6 +5595,11 @@ declare namespace sap {
         labelFor?: sap.ui.core.Control | string;
       }
 
+      /**
+       * Describes the settings that can be provided to the Link constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.Link` control.
+       */
       interface $LinkSettings extends sap.ui.core.$ControlSettings {
         /**
          * Link text to be displayed.
@@ -5434,6 +5660,11 @@ declare namespace sap {
         press?: (oEvent: sap.ui.base.Event) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the ListBox constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.List` control.
+       */
       interface $ListBoxSettings extends sap.ui.core.$ControlSettings {
         /**
          * Determines whether the ListBox is interactive or not. Can be used to disable interaction with mouse or
@@ -5580,8 +5811,18 @@ declare namespace sap {
         select?: (oEvent: ListBox$SelectEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the Menu constructor.
+       *
+       * @deprecated (since 1.21.0) - replaced by {@link sap.ui.unified.Menu}
+       */
       interface $MenuSettings extends sap.ui.unified.$MenuSettings {}
 
+      /**
+       * Describes the settings that can be provided to the MenuBar constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.OverflowToolbar` control.
+       */
       interface $MenuBarSettings extends sap.ui.core.$ControlSettings {
         /**
          * When the MenuBar is not enabled, automatically all single menu items are also displayed as 'disabled'.
@@ -5617,6 +5858,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the MenuButton constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.MenuButton` control.
+       */
       interface $MenuButtonSettings extends sap.ui.commons.$ButtonSettings {
         /**
          * The position / edge (see sap.ui.core.Popup.Dock) of the button where the menu is docked. Default is 'begin
@@ -5641,14 +5887,36 @@ declare namespace sap {
         itemSelected?: (oEvent: MenuButton$ItemSelectedEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the MenuItem constructor.
+       *
+       * @deprecated (since 1.21.0) - replaced by {@link sap.ui.unified.MenuItem}
+       */
       interface $MenuItemSettings extends sap.ui.unified.$MenuItemSettings {}
 
+      /**
+       * Describes the settings that can be provided to the MenuItemBase constructor.
+       *
+       * @deprecated (since 1.21.0) - replaced by {@link sap.ui.unified.MenuItemBase}
+       */
       interface $MenuItemBaseSettings
         extends sap.ui.unified.$MenuItemBaseSettings {}
 
+      /**
+       * Describes the settings that can be provided to the MenuTextFieldItem constructor.
+       *
+       * @deprecated (since 1.21.0) - Please use the control `sap.ui.unified.MenuTextFieldItem` of the library
+       * `sap.ui.unified` instead.
+       */
       interface $MenuTextFieldItemSettings
         extends sap.ui.unified.$MenuTextFieldItemSettings {}
 
+      /**
+       * Describes the settings that can be provided to the Message constructor.
+       *
+       * @deprecated (since 1.4.0) - A new messaging concept will be created in future. Therefore this control
+       * might be removed in one of the next versions.
+       */
       interface $MessageSettings extends sap.ui.core.$ControlSettings {
         /**
          * "Success", or "Warning", or "Error" messages. (Mandatory)
@@ -5676,6 +5944,11 @@ declare namespace sap {
         design?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
       }
 
+      /**
+       * Describes the settings that can be provided to the MessageBar constructor.
+       *
+       * @deprecated (since 1.4.0) - Instead, use the `sap.m.MessagePopover` control.
+       */
       interface $MessageBarSettings extends sap.ui.core.$ControlSettings {
         /**
          * Element ID upon which the MessageBar will be initially positioned.
@@ -5719,6 +5992,12 @@ declare namespace sap {
           | sap.ui.base.ManagedObject.PropertyBindingInfo;
       }
 
+      /**
+       * Describes the settings that can be provided to the MessageList constructor.
+       *
+       * @deprecated (since 1.4.0) - A new messaging concept will be created in future. Therefore this control
+       * might be removed in one of the next versions.
+       */
       interface $MessageListSettings extends sap.ui.core.$ControlSettings {
         /**
          * Specifies whether or not the MessageList is visible. Invisible controls are not rendered.
@@ -5739,6 +6018,11 @@ declare namespace sap {
         maxListed?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
       }
 
+      /**
+       * Describes the settings that can be provided to the MessageToast constructor.
+       *
+       * @deprecated (since 1.4.0) - Instead, use the `sap.m.MessageToast` control.
+       */
       interface $MessageToastSettings extends sap.ui.core.$ControlSettings {
         /**
          * ID of the anchor on top of which the MessageToast is to render.
@@ -5751,6 +6035,11 @@ declare namespace sap {
         next?: (oEvent: sap.ui.base.Event) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the Paginator constructor.
+       *
+       * @deprecated (since 1.38) - the concept has been discarded.
+       */
       interface $PaginatorSettings extends sap.ui.core.$ControlSettings {
         /**
          * Represents the current page (first page has index 1, not 0, to match the visual number)
@@ -5774,6 +6063,11 @@ declare namespace sap {
         page?: (oEvent: Paginator$PageEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the Panel constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.Panel` control.
+       */
       interface $PanelSettings extends sap.ui.core.$ControlSettings {
         /**
          * Determines the width of the Panel in CSS size.
@@ -5890,9 +6184,19 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the PasswordField constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.Input` control.
+       */
       interface $PasswordFieldSettings
         extends sap.ui.commons.$TextFieldSettings {}
 
+      /**
+       * Describes the settings that can be provided to the ProgressIndicator constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.ProgressIndicator` control.
+       */
       interface $ProgressIndicatorSettings
         extends sap.ui.core.$ControlSettings {
         /**
@@ -5944,6 +6248,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the RadioButton constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.RadioButton` control.
+       */
       interface $RadioButtonSettings extends sap.ui.core.$ControlSettings {
         /**
          * Defines the text displayed next to the RadioButton.
@@ -6028,6 +6337,11 @@ declare namespace sap {
         select?: (oEvent: sap.ui.base.Event) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the RadioButtonGroup constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.RadioButtonGroup` control.
+       */
       interface $RadioButtonGroupSettings extends sap.ui.core.$ControlSettings {
         /**
          * Defines the width of the RadioButtonGroup.
@@ -6111,6 +6425,11 @@ declare namespace sap {
         select?: (oEvent: RadioButtonGroup$SelectEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the RangeSlider constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.RangeSlider}
+       */
       interface $RangeSliderSettings extends sap.ui.commons.$SliderSettings {
         /**
          * Current second value of the slider. (Position of the second grip.)
@@ -6124,6 +6443,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the RatingIndicator constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.RatingIndicator` control.
+       */
       interface $RatingIndicatorSettings extends sap.ui.core.$ControlSettings {
         /**
          * Determines if the rating symbols can be edited.
@@ -6212,6 +6536,11 @@ declare namespace sap {
         change?: (oEvent: RatingIndicator$ChangeEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the ResponsiveContainer constructor.
+       *
+       * @deprecated (since 1.38) - Use a container by choice from the {@link sap.m} library, instead.
+       */
       interface $ResponsiveContainerSettings
         extends sap.ui.core.$ControlSettings {
         /**
@@ -6250,6 +6579,12 @@ declare namespace sap {
         rangeSwitch?: (oEvent: ResponsiveContainer$RangeSwitchEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the ResponsiveContainerRange constructor.
+       *
+       * @deprecated (since 1.38) - (altogether with sap.ui.commons.ResponsiveContainer). Use a container of your
+       * choice from the sap.m library instead.
+       */
       interface $ResponsiveContainerRangeSettings
         extends sap.ui.core.$ElementSettings {
         /**
@@ -6279,6 +6614,12 @@ declare namespace sap {
         content?: sap.ui.core.Control | string;
       }
 
+      /**
+       * Describes the settings that can be provided to the RichTooltip constructor.
+       *
+       * @deprecated (since 1.38) - Tf you want to achieve a similar behavior, use a `sap.m.Popover` control and
+       * open it next to your control.
+       */
       interface $RichTooltipSettings extends sap.ui.core.$TooltipBaseSettings {
         /**
          * Tool tip title to be displayed in the header.
@@ -6308,6 +6649,11 @@ declare namespace sap {
         imageAltText?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
       }
 
+      /**
+       * Describes the settings that can be provided to the RoadMap constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.Wizard` control.
+       */
       interface $RoadMapSettings extends sap.ui.core.$ControlSettings {
         /**
          * Total number of steps to be displayed at once
@@ -6357,6 +6703,11 @@ declare namespace sap {
         stepExpanded?: (oEvent: RoadMap$StepExpandedEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the RoadMapStep constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.Wizard` control.
+       */
       interface $RoadMapStepSettings extends sap.ui.core.$ElementSettings {
         /**
          * Label of the step
@@ -6404,6 +6755,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the RowRepeater constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.ui.table.Table` control.
+       */
       interface $RowRepeaterSettings extends sap.ui.core.$ControlSettings {
         /**
          * Number of rows displayed.
@@ -6513,6 +6869,11 @@ declare namespace sap {
         resize?: (oEvent: RowRepeater$ResizeEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the RowRepeaterFilter constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.ui.table.Table` control.
+       */
       interface $RowRepeaterFilterSettings
         extends sap.ui.core.$ElementSettings {
         /**
@@ -6534,6 +6895,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the RowRepeaterSorter constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.ui.table.Table` control.
+       */
       interface $RowRepeaterSorterSettings
         extends sap.ui.core.$ElementSettings {
         /**
@@ -6555,6 +6921,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the SearchField constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.SearchField` control.
+       */
       interface $SearchFieldSettings extends sap.ui.core.$ControlSettings {
         /**
          * Defines whether a pop up list shall be provided for suggestions
@@ -6731,9 +7102,19 @@ declare namespace sap {
         suggest?: (oEvent: SearchField$SuggestEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the SearchProvider constructor.
+       *
+       * @deprecated (since 1.6.0) - Replaced by sap.ui.core.search.OpenSearchProvider
+       */
       interface $SearchProviderSettings
         extends sap.ui.core.search.$OpenSearchProviderSettings {}
 
+      /**
+       * Describes the settings that can be provided to the SegmentedButton constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.SegmentedButton}
+       */
       interface $SegmentedButtonSettings extends sap.ui.core.$ControlSettings {
         /**
          * enabled
@@ -6763,6 +7144,11 @@ declare namespace sap {
         select?: (oEvent: SegmentedButton$SelectEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the Slider constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Slider}
+       */
       interface $SliderSettings extends sap.ui.core.$ControlSettings {
         /**
          * Width of the horizontal slider.
@@ -6896,6 +7282,11 @@ declare namespace sap {
         liveChange?: (oEvent: Slider$LiveChangeEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the Splitter constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.ui.layout.Splitter` control.
+       */
       interface $SplitterSettings extends sap.ui.core.$ControlSettings {
         /**
          * The splitter can have horizontal or vertical orientation.
@@ -6984,6 +7375,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the Tab constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.TabContainer` control.
+       */
       interface $TabSettings extends sap.ui.commons.$PanelSettings {
         /**
          * Specifies the vertical scrolling.
@@ -7021,6 +7417,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the TabStrip constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.TabContainer` control.
+       */
       interface $TabStripSettings extends sap.ui.core.$ControlSettings {
         /**
          * Specifies the height of the tab bar and content area.
@@ -7074,6 +7475,11 @@ declare namespace sap {
         close?: (oEvent: TabStrip$CloseEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the TextArea constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.TextArea` control.
+       */
       interface $TextAreaSettings extends sap.ui.commons.$TextFieldSettings {
         /**
          * Height of text field. When it is set (CSS-size such as % or px), this is the exact size.
@@ -7129,6 +7535,11 @@ declare namespace sap {
         labeledBy?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
       }
 
+      /**
+       * Describes the settings that can be provided to the TextField constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Input}
+       */
       interface $TextFieldSettings extends sap.ui.core.$ControlSettings {
         /**
          * Text inside the `TextField`
@@ -7267,6 +7678,11 @@ declare namespace sap {
         liveChange?: (oEvent: TextField$LiveChangeEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the TextView constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Text}.
+       */
       interface $TextViewSettings extends sap.ui.core.$ControlSettings {
         /**
          * Text to be displayed.
@@ -7355,8 +7771,18 @@ declare namespace sap {
         ariaLabelledBy?: Array<sap.ui.core.Control | string>;
       }
 
+      /**
+       * Describes the settings that can be provided to the Title constructor.
+       *
+       * @deprecated (since 1.16.0) - moved to sap.ui.core library. Please use this one.
+       */
       interface $TitleSettings extends sap.ui.core.$TitleSettings {}
 
+      /**
+       * Describes the settings that can be provided to the ToggleButton constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.ToggleButton}
+       */
       interface $ToggleButtonSettings extends sap.ui.commons.$ButtonSettings {
         /**
          * The property is “true” when the control is toggled. The default state of this property is "false".
@@ -7367,6 +7793,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the Toolbar constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Toolbar}
+       */
       interface $ToolbarSettings extends sap.ui.core.$ControlSettings {
         /**
          * When there is not enough space for the toolbar to display all items, the rightmost items are overflowing
@@ -7413,6 +7844,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the ToolbarSeparator constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.Toolbar` control.
+       */
       interface $ToolbarSeparatorSettings extends sap.ui.core.$ElementSettings {
         /**
          * When set to false, there is no visual indication of separation by a vertical line but by a wider space.
@@ -7431,6 +7867,11 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the Tree constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Tree}
+       */
       interface $TreeSettings extends sap.ui.core.$ControlSettings {
         /**
          * Tree title
@@ -7514,6 +7955,11 @@ declare namespace sap {
         selectionChange?: (oEvent: Tree$SelectionChangeEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the TreeNode constructor.
+       *
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Tree}
+       */
       interface $TreeNodeSettings extends sap.ui.core.$ElementSettings {
         /**
          * Node text
@@ -7590,6 +8036,11 @@ declare namespace sap {
         selected?: (oEvent: sap.ui.base.Event) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the TriStateCheckBox constructor.
+       *
+       * @deprecated (since 1.38) - Use {@link sap.m.CheckBox} instead.
+       */
       interface $TriStateCheckBoxSettings extends sap.ui.core.$ControlSettings {
         /**
          * Defines the states of the checkbox
@@ -7652,6 +8103,11 @@ declare namespace sap {
         change?: (oEvent: TriStateCheckBox$ChangeEvent) => void;
       }
 
+      /**
+       * Describes the settings that can be provided to the ValueHelpField constructor.
+       *
+       * @deprecated (since 1.38) - Instead, use the `sap.m.Input` control.
+       */
       interface $ValueHelpFieldSettings
         extends sap.ui.commons.$TextFieldSettings {
         /**
@@ -7687,6 +8143,9 @@ declare namespace sap {
         valueHelpRequest?: (oEvent: sap.ui.base.Event) => void;
       }
 
+      /**
+       * Parameters of the Accordion#sectionClose event.
+       */
       interface Accordion$SectionCloseEventParameters {
         /**
          * ID of the closed section
@@ -7694,6 +8153,9 @@ declare namespace sap {
         closeSectionId?: string;
       }
 
+      /**
+       * Parameters of the Accordion#sectionOpen event.
+       */
       interface Accordion$SectionOpenEventParameters {
         /**
          * ID of the opened section
@@ -7706,6 +8168,9 @@ declare namespace sap {
         closeSectionIds?: string[];
       }
 
+      /**
+       * Parameters of the Accordion#sectionsReorder event.
+       */
       interface Accordion$SectionsReorderEventParameters {
         /**
          * ID of the moved section
@@ -7718,6 +8183,9 @@ declare namespace sap {
         newIndex?: int;
       }
 
+      /**
+       * Parameters of the AccordionSection#scroll event.
+       */
       interface AccordionSection$ScrollEventParameters {
         /**
          * Horizontal scroll position
@@ -7730,8 +8198,14 @@ declare namespace sap {
         top?: int;
       }
 
+      /**
+       * Parameters of the ApplicationHeader#logoff event.
+       */
       interface ApplicationHeader$LogoffEventParameters {}
 
+      /**
+       * Parameters of the AutoComplete#suggest event.
+       */
       interface AutoComplete$SuggestEventParameters {
         /**
          * The current value which was typed in.
@@ -7739,8 +8213,14 @@ declare namespace sap {
         suggestValue?: string;
       }
 
+      /**
+       * Parameters of the Button#press event.
+       */
       interface Button$PressEventParameters {}
 
+      /**
+       * Parameters of the CalloutBase#beforeOpen event.
+       */
       interface CalloutBase$BeforeOpenEventParameters {
         /**
          * Parent control that has this Callout as a tooltip
@@ -7748,8 +8228,14 @@ declare namespace sap {
         parent?: sap.ui.core.Control;
       }
 
+      /**
+       * Parameters of the CalloutBase#close event.
+       */
       interface CalloutBase$CloseEventParameters {}
 
+      /**
+       * Parameters of the CalloutBase#open event.
+       */
       interface CalloutBase$OpenEventParameters {
         /**
          * Parent control that has this Callout as a tooltip
@@ -7757,8 +8243,14 @@ declare namespace sap {
         parent?: sap.ui.core.Control;
       }
 
+      /**
+       * Parameters of the CalloutBase#opened event.
+       */
       interface CalloutBase$OpenedEventParameters {}
 
+      /**
+       * Parameters of the CheckBox#change event.
+       */
       interface CheckBox$ChangeEventParameters {
         /**
          * Checks whether the box is flagged or not flagged.
@@ -7766,6 +8258,9 @@ declare namespace sap {
         checked?: boolean;
       }
 
+      /**
+       * Parameters of the ComboBox#change event.
+       */
       interface ComboBox$ChangeEventParameters
         extends sap.ui.commons.TextField$ChangeEventParameters {
         /**
@@ -7774,6 +8269,9 @@ declare namespace sap {
         selectedItem?: sap.ui.core.ListItem;
       }
 
+      /**
+       * Parameters of the Dialog#closed event.
+       */
       interface Dialog$ClosedEventParameters {
         /**
          * The width of the dialog when closed
@@ -7796,6 +8294,9 @@ declare namespace sap {
         left?: int;
       }
 
+      /**
+       * Parameters of the DropdownBox#searchHelp event.
+       */
       interface DropdownBox$SearchHelpEventParameters {
         /**
          * The current value of the DropdownBox.
@@ -7803,8 +8304,14 @@ declare namespace sap {
         value?: string;
       }
 
+      /**
+       * Parameters of the Image#press event.
+       */
       interface Image$PressEventParameters {}
 
+      /**
+       * Parameters of the ImageMap#press event.
+       */
       interface ImageMap$PressEventParameters {
         /**
          * Id of clicked Area.
@@ -7812,6 +8319,9 @@ declare namespace sap {
         areaId?: string;
       }
 
+      /**
+       * Parameters of the InPlaceEdit#change event.
+       */
       interface InPlaceEdit$ChangeEventParameters {
         /**
          * The new / changed value of the InPlaceEdit.
@@ -7819,6 +8329,9 @@ declare namespace sap {
         newValue?: string;
       }
 
+      /**
+       * Parameters of the InPlaceEdit#liveChange event.
+       */
       interface InPlaceEdit$LiveChangeEventParameters {
         /**
          * Current value of the Textfield.
@@ -7826,8 +8339,14 @@ declare namespace sap {
         liveValue?: string;
       }
 
+      /**
+       * Parameters of the Link#press event.
+       */
       interface Link$PressEventParameters {}
 
+      /**
+       * Parameters of the ListBox#select event.
+       */
       interface ListBox$SelectEventParameters {
         /**
          * ID of the ListBox which triggered the event.
@@ -7853,6 +8372,9 @@ declare namespace sap {
         selectedIndices?: int[];
       }
 
+      /**
+       * Parameters of the MenuButton#itemSelected event.
+       */
       interface MenuButton$ItemSelectedEventParameters {
         /**
          * The ID of the selected item
@@ -7865,6 +8387,9 @@ declare namespace sap {
         item?: sap.ui.unified.MenuItemBase;
       }
 
+      /**
+       * Parameters of the MenuButton#press event.
+       */
       interface MenuButton$PressEventParameters
         extends sap.ui.commons.Button$PressEventParameters {
         /**
@@ -7878,8 +8403,14 @@ declare namespace sap {
         item?: sap.ui.commons.MenuItemBase;
       }
 
+      /**
+       * Parameters of the MessageToast#next event.
+       */
       interface MessageToast$NextEventParameters {}
 
+      /**
+       * Parameters of the Paginator#page event.
+       */
       interface Paginator$PageEventParameters {
         /**
          * The page which is the current one before the page event is fired (and another page is displayed)
@@ -7901,8 +8432,14 @@ declare namespace sap {
         type?: sap.ui.commons.PaginatorEvent;
       }
 
+      /**
+       * Parameters of the RadioButton#select event.
+       */
       interface RadioButton$SelectEventParameters {}
 
+      /**
+       * Parameters of the RadioButtonGroup#select event.
+       */
       interface RadioButtonGroup$SelectEventParameters {
         /**
          * Index of the selected RadioButton.
@@ -7910,6 +8447,9 @@ declare namespace sap {
         selectedIndex?: int;
       }
 
+      /**
+       * Parameters of the RatingIndicator#change event.
+       */
       interface RatingIndicator$ChangeEventParameters {
         /**
          * The value of the user rating
@@ -7917,6 +8457,9 @@ declare namespace sap {
         value?: int;
       }
 
+      /**
+       * Parameters of the ResponsiveContainer#rangeSwitch event.
+       */
       interface ResponsiveContainer$RangeSwitchEventParameters {
         /**
          * The current range
@@ -7924,6 +8467,9 @@ declare namespace sap {
         currentRange?: sap.ui.commons.ResponsiveContainerRange;
       }
 
+      /**
+       * Parameters of the RoadMap#stepExpanded event.
+       */
       interface RoadMap$StepExpandedEventParameters {
         /**
          * ID of the expanded/collapsed step
@@ -7931,6 +8477,9 @@ declare namespace sap {
         stepId?: string;
       }
 
+      /**
+       * Parameters of the RoadMap#stepSelected event.
+       */
       interface RoadMap$StepSelectedEventParameters {
         /**
          * ID of the selected step
@@ -7938,6 +8487,9 @@ declare namespace sap {
         stepId?: string;
       }
 
+      /**
+       * Parameters of the RowRepeater#filter event.
+       */
       interface RowRepeater$FilterEventParameters {
         /**
          * The ID of the filter that has just been applied.
@@ -7945,6 +8497,9 @@ declare namespace sap {
         filterId?: string;
       }
 
+      /**
+       * Parameters of the RowRepeater#page event.
+       */
       interface RowRepeater$PageEventParameters {
         /**
          * The value of the currentPage property after the change.
@@ -7957,6 +8512,9 @@ declare namespace sap {
         previousPage?: int;
       }
 
+      /**
+       * Parameters of the RowRepeater#resize event.
+       */
       interface RowRepeater$ResizeEventParameters {
         /**
          * The value of the numberOfRows property after the change.
@@ -7969,6 +8527,9 @@ declare namespace sap {
         previousNumberOfRows?: int;
       }
 
+      /**
+       * Parameters of the RowRepeater#sort event.
+       */
       interface RowRepeater$SortEventParameters {
         /**
          * The ID of the sorter that has just been applied.
@@ -7976,6 +8537,9 @@ declare namespace sap {
         sorterId?: string;
       }
 
+      /**
+       * Parameters of the SearchField#search event.
+       */
       interface SearchField$SearchEventParameters {
         /**
          * The search query
@@ -7983,6 +8547,9 @@ declare namespace sap {
         query?: string;
       }
 
+      /**
+       * Parameters of the SearchField#suggest event.
+       */
       interface SearchField$SuggestEventParameters {
         /**
          * The value for which suggestions are required.
@@ -7990,6 +8557,9 @@ declare namespace sap {
         value?: string;
       }
 
+      /**
+       * Parameters of the SegmentedButton#select event.
+       */
       interface SegmentedButton$SelectEventParameters {
         /**
          * Id of selected ToggleButton
@@ -7997,6 +8567,9 @@ declare namespace sap {
         selectedButtonId?: string;
       }
 
+      /**
+       * Parameters of the Slider#change event.
+       */
       interface Slider$ChangeEventParameters {
         /**
          * Current value of the slider after a change.
@@ -8004,6 +8577,9 @@ declare namespace sap {
         value?: float;
       }
 
+      /**
+       * Parameters of the Slider#liveChange event.
+       */
       interface Slider$LiveChangeEventParameters {
         /**
          * Current value of the slider after a change.
@@ -8011,6 +8587,9 @@ declare namespace sap {
         value?: float;
       }
 
+      /**
+       * Parameters of the TabStrip#close event.
+       */
       interface TabStrip$CloseEventParameters {
         /**
          * The index of the closed tab.
@@ -8018,6 +8597,9 @@ declare namespace sap {
         index?: int;
       }
 
+      /**
+       * Parameters of the TabStrip#select event.
+       */
       interface TabStrip$SelectEventParameters {
         /**
          * The index of the selected tab.
@@ -8025,6 +8607,9 @@ declare namespace sap {
         index?: int;
       }
 
+      /**
+       * Parameters of the TextField#change event.
+       */
       interface TextField$ChangeEventParameters {
         /**
          * The new / changed value of the `TextField`.
@@ -8032,6 +8617,9 @@ declare namespace sap {
         newValue?: string;
       }
 
+      /**
+       * Parameters of the TextField#liveChange event.
+       */
       interface TextField$LiveChangeEventParameters {
         /**
          * Current visible value of the `TextField`.
@@ -8039,6 +8627,9 @@ declare namespace sap {
         liveValue?: string;
       }
 
+      /**
+       * Parameters of the Tree#select event.
+       */
       interface Tree$SelectEventParameters {
         /**
          * The node which has been selected.
@@ -8051,6 +8642,9 @@ declare namespace sap {
         nodeContext?: object;
       }
 
+      /**
+       * Parameters of the Tree#selectionChange event.
+       */
       interface Tree$SelectionChangeEventParameters {
         /**
          * The nodes which has been selected.
@@ -8063,8 +8657,14 @@ declare namespace sap {
         nodeContexts?: object[];
       }
 
+      /**
+       * Parameters of the TreeNode#selected event.
+       */
       interface TreeNode$SelectedEventParameters {}
 
+      /**
+       * Parameters of the TreeNode#toggleOpenState event.
+       */
       interface TreeNode$ToggleOpenStateEventParameters {
         /**
          * Node has been opened if true
@@ -8072,6 +8672,9 @@ declare namespace sap {
         opened?: boolean;
       }
 
+      /**
+       * Parameters of the TriStateCheckBox#change event.
+       */
       interface TriStateCheckBox$ChangeEventParameters {
         /**
          * Checks whether the box is flagged or not flagged.
@@ -8079,6 +8682,9 @@ declare namespace sap {
         selectionState?: string;
       }
 
+      /**
+       * Parameters of the ValueHelpField#valueHelpRequest event.
+       */
       interface ValueHelpField$ValueHelpRequestEventParameters {}
 
       /**
@@ -8231,7 +8837,7 @@ declare namespace sap {
       /**
        * Contains N sections, acting as containers for any library control
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Panel}.
        */
       class Accordion extends sap.ui.core.Control {
         /**
@@ -8682,7 +9288,7 @@ declare namespace sap {
       /**
        * Represents a panel which is a container for other controls. The container does not have any layout function.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - the concept has been discarded.
        */
       class AccordionSection extends sap.ui.core.Element {
         /**
@@ -9458,7 +10064,7 @@ declare namespace sap {
        * Textfield with list based text completion.
        *
        * @since 1.10.0
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Input}.
        */
       class AutoComplete
         extends sap.ui.commons.ComboBox
@@ -10415,7 +11021,8 @@ declare namespace sap {
       /**
        * CalloutBase is a building block for Callout. Do not use it directly. Use the Callout control instead
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - If you want to achieve a similar behavior, use the `sap.m.Popover` control
+       * and open it next to your control.
        */
       class CalloutBase extends sap.ui.core.TooltipBase {
         /**
@@ -14131,7 +14738,8 @@ declare namespace sap {
       /**
        * Divides the screen in visual areas.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - Use the layout controls instead, e.g {@link sap.ui.layout.Splitter} or {@link sap.ui.layout.BlockLayout }
+       * among others.
        */
       class HorizontalDivider extends sap.ui.core.Control {
         /**
@@ -18468,7 +19076,7 @@ declare namespace sap {
       /**
        * Provides navigation between pages within a list of numbered pages.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - the concept has been discarded.
        */
       class Paginator extends sap.ui.core.Control {
         /**
@@ -21441,7 +22049,8 @@ declare namespace sap {
       /**
        * Defines a range for the ResponsiveContainer
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - (altogether with sap.ui.commons.ResponsiveContainer). Use a container of your
+       * choice from the sap.m library instead.
        */
       class ResponsiveContainerRange extends sap.ui.core.Element {
         /**
@@ -27771,7 +28380,7 @@ declare namespace sap {
       /**
        * Is used to display some continous text. The control can inherit the text direction from its parent control.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - replaced by {@link sap.m.Text}.
        */
       class TextView
         extends sap.ui.core.Control
@@ -30029,7 +30638,7 @@ declare namespace sap {
        * possible which is e.g. required in checkbox trees.
        *
        * @since 1.7.2
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - Use {@link sap.m.CheckBox} instead.
        */
       class TriStateCheckBox extends sap.ui.core.Control {
         /**
@@ -30629,7 +31238,8 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'ButtonStyle'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - (altogether with sap.ui.commons.Button). Use sap.m.Button with its sap.m.ButtonType
+       * instead.
        */
       enum ButtonStyle {
         /**
@@ -30655,7 +31265,7 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'HorizontalDividerHeight'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - without replacement.
        */
       enum HorizontalDividerHeight {
         /**
@@ -30681,7 +31291,7 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'HorizontalDividerType'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - without a replacement.
        */
       enum HorizontalDividerType {
         /**
@@ -30699,7 +31309,7 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'LabelDesign'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - the concept has been discarded.
        */
       enum LabelDesign {
         /**
@@ -30717,7 +31327,8 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'MenuBarDesign'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - (altogether with sap.ui.commons.Toolbar). Use sap.m.Toolbar and its sap.m.ToolbarDesign
+       * instead.
        */
       enum MenuBarDesign {
         /**
@@ -30735,7 +31346,7 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'MessageType'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - Instead, use the `sap.ui.core.MessageType`.
        */
       enum MessageType {
         /**
@@ -30757,7 +31368,7 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'PaginatorEvent'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - the concept has been discarded.
        */
       enum PaginatorEvent {
         /**
@@ -30787,7 +31398,7 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'RatingIndicatorVisualMode'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - Instead, use `sap.m.RatingIndicator` control.
        */
       enum RatingIndicatorVisualMode {
         /**
@@ -30831,7 +31442,7 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'TextViewColor'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - the concept has been discarded.
        */
       enum TextViewColor {
         /**
@@ -30857,7 +31468,7 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'TextViewDesign'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - the concept has been discarded.
        */
       enum TextViewDesign {
         /**
@@ -30939,7 +31550,8 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'ToolbarSeparatorDesign'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - (altogether wuith sap.ui.commons.Toolbar). Use sap.m.Toolbar and its sap.m.ToolbarSeparator
+       * instead.
        */
       enum ToolbarSeparatorDesign {
         /**
@@ -30957,7 +31569,7 @@ declare namespace sap {
        * This enum is part of the 'sap/ui/commons/library' module export and must be accessed by the property
        * 'TreeSelectionMode'.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - (altogether with sap.ui.commons.Tree). Use sap.m.Tree with its items instead.
        */
       enum TreeSelectionMode {
         /**
@@ -30984,7 +31596,7 @@ declare namespace sap {
        * 'TriStateCheckBoxState'.
        *
        * @since 1.7.2
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - Use {@link sap.m.CheckBox} and its properties instead.
        */
       enum TriStateCheckBoxState {
         /**
@@ -31064,7 +31676,7 @@ declare namespace sap {
       /**
        * A string type that represents subset of CSS size values. For the Splitter only px and % are allowed.
        *
-       * @deprecated (since 1.38)
+       * @deprecated (since 1.38) - Instead, use `sap.ui.layout.Splitter` control.
        */
       type SplitterSize = string;
 
@@ -31078,248 +31690,398 @@ declare namespace sap {
        */
       type TitleLevel = sap.ui.core.TitleLevel;
 
+      /**
+       * Event object of the Accordion#sectionClose event.
+       */
       type Accordion$SectionCloseEvent = sap.ui.base.Event<
         Accordion$SectionCloseEventParameters,
         Accordion
       >;
 
+      /**
+       * Event object of the Accordion#sectionOpen event.
+       */
       type Accordion$SectionOpenEvent = sap.ui.base.Event<
         Accordion$SectionOpenEventParameters,
         Accordion
       >;
 
+      /**
+       * Event object of the Accordion#sectionsReorder event.
+       */
       type Accordion$SectionsReorderEvent = sap.ui.base.Event<
         Accordion$SectionsReorderEventParameters,
         Accordion
       >;
 
+      /**
+       * Event object of the AccordionSection#scroll event.
+       */
       type AccordionSection$ScrollEvent = sap.ui.base.Event<
         AccordionSection$ScrollEventParameters,
         AccordionSection
       >;
 
+      /**
+       * Event object of the ApplicationHeader#logoff event.
+       */
       type ApplicationHeader$LogoffEvent = sap.ui.base.Event<
         ApplicationHeader$LogoffEventParameters,
         ApplicationHeader
       >;
 
+      /**
+       * Event object of the AutoComplete#suggest event.
+       */
       type AutoComplete$SuggestEvent = sap.ui.base.Event<
         AutoComplete$SuggestEventParameters,
         AutoComplete
       >;
 
+      /**
+       * Event object of the Button#press event.
+       */
       type Button$PressEvent = sap.ui.base.Event<
         Button$PressEventParameters,
         Button
       >;
 
+      /**
+       * Event object of the CalloutBase#beforeOpen event.
+       */
       type CalloutBase$BeforeOpenEvent = sap.ui.base.Event<
         CalloutBase$BeforeOpenEventParameters,
         CalloutBase
       >;
 
+      /**
+       * Event object of the CalloutBase#close event.
+       */
       type CalloutBase$CloseEvent = sap.ui.base.Event<
         CalloutBase$CloseEventParameters,
         CalloutBase
       >;
 
+      /**
+       * Event object of the CalloutBase#open event.
+       */
       type CalloutBase$OpenEvent = sap.ui.base.Event<
         CalloutBase$OpenEventParameters,
         CalloutBase
       >;
 
+      /**
+       * Event object of the CalloutBase#opened event.
+       */
       type CalloutBase$OpenedEvent = sap.ui.base.Event<
         CalloutBase$OpenedEventParameters,
         CalloutBase
       >;
 
+      /**
+       * Event object of the CheckBox#change event.
+       */
       type CheckBox$ChangeEvent = sap.ui.base.Event<
         CheckBox$ChangeEventParameters,
         CheckBox
       >;
 
+      /**
+       * Event object of the ComboBox#change event.
+       */
       type ComboBox$ChangeEvent = sap.ui.base.Event<
         ComboBox$ChangeEventParameters,
         ComboBox
       >;
 
+      /**
+       * Event object of the Dialog#closed event.
+       */
       type Dialog$ClosedEvent = sap.ui.base.Event<
         Dialog$ClosedEventParameters,
         Dialog
       >;
 
+      /**
+       * Event object of the DropdownBox#searchHelp event.
+       */
       type DropdownBox$SearchHelpEvent = sap.ui.base.Event<
         DropdownBox$SearchHelpEventParameters,
         DropdownBox
       >;
 
+      /**
+       * Event object of the Image#press event.
+       */
       type Image$PressEvent = sap.ui.base.Event<
         Image$PressEventParameters,
         Image
       >;
 
+      /**
+       * Event object of the ImageMap#press event.
+       */
       type ImageMap$PressEvent = sap.ui.base.Event<
         ImageMap$PressEventParameters,
         ImageMap
       >;
 
+      /**
+       * Event object of the InPlaceEdit#change event.
+       */
       type InPlaceEdit$ChangeEvent = sap.ui.base.Event<
         InPlaceEdit$ChangeEventParameters,
         InPlaceEdit
       >;
 
+      /**
+       * Event object of the InPlaceEdit#liveChange event.
+       */
       type InPlaceEdit$LiveChangeEvent = sap.ui.base.Event<
         InPlaceEdit$LiveChangeEventParameters,
         InPlaceEdit
       >;
 
+      /**
+       * Event object of the Link#press event.
+       */
       type Link$PressEvent = sap.ui.base.Event<Link$PressEventParameters, Link>;
 
+      /**
+       * Event object of the ListBox#select event.
+       */
       type ListBox$SelectEvent = sap.ui.base.Event<
         ListBox$SelectEventParameters,
         ListBox
       >;
 
+      /**
+       * Event object of the MenuButton#itemSelected event.
+       */
       type MenuButton$ItemSelectedEvent = sap.ui.base.Event<
         MenuButton$ItemSelectedEventParameters,
         MenuButton
       >;
 
+      /**
+       * Event object of the MenuButton#press event.
+       */
       type MenuButton$PressEvent = sap.ui.base.Event<
         MenuButton$PressEventParameters,
         MenuButton
       >;
 
+      /**
+       * Event object of the MessageToast#next event.
+       */
       type MessageToast$NextEvent = sap.ui.base.Event<
         MessageToast$NextEventParameters,
         MessageToast
       >;
 
+      /**
+       * Event object of the Paginator#page event.
+       */
       type Paginator$PageEvent = sap.ui.base.Event<
         Paginator$PageEventParameters,
         Paginator
       >;
 
+      /**
+       * Event object of the RadioButton#select event.
+       */
       type RadioButton$SelectEvent = sap.ui.base.Event<
         RadioButton$SelectEventParameters,
         RadioButton
       >;
 
+      /**
+       * Event object of the RadioButtonGroup#select event.
+       */
       type RadioButtonGroup$SelectEvent = sap.ui.base.Event<
         RadioButtonGroup$SelectEventParameters,
         RadioButtonGroup
       >;
 
+      /**
+       * Event object of the RatingIndicator#change event.
+       */
       type RatingIndicator$ChangeEvent = sap.ui.base.Event<
         RatingIndicator$ChangeEventParameters,
         RatingIndicator
       >;
 
+      /**
+       * Event object of the ResponsiveContainer#rangeSwitch event.
+       */
       type ResponsiveContainer$RangeSwitchEvent = sap.ui.base.Event<
         ResponsiveContainer$RangeSwitchEventParameters,
         ResponsiveContainer
       >;
 
+      /**
+       * Event object of the RoadMap#stepExpanded event.
+       */
       type RoadMap$StepExpandedEvent = sap.ui.base.Event<
         RoadMap$StepExpandedEventParameters,
         RoadMap
       >;
 
+      /**
+       * Event object of the RoadMap#stepSelected event.
+       */
       type RoadMap$StepSelectedEvent = sap.ui.base.Event<
         RoadMap$StepSelectedEventParameters,
         RoadMap
       >;
 
+      /**
+       * Event object of the RowRepeater#filter event.
+       */
       type RowRepeater$FilterEvent = sap.ui.base.Event<
         RowRepeater$FilterEventParameters,
         RowRepeater
       >;
 
+      /**
+       * Event object of the RowRepeater#page event.
+       */
       type RowRepeater$PageEvent = sap.ui.base.Event<
         RowRepeater$PageEventParameters,
         RowRepeater
       >;
 
+      /**
+       * Event object of the RowRepeater#resize event.
+       */
       type RowRepeater$ResizeEvent = sap.ui.base.Event<
         RowRepeater$ResizeEventParameters,
         RowRepeater
       >;
 
+      /**
+       * Event object of the RowRepeater#sort event.
+       */
       type RowRepeater$SortEvent = sap.ui.base.Event<
         RowRepeater$SortEventParameters,
         RowRepeater
       >;
 
+      /**
+       * Event object of the SearchField#search event.
+       */
       type SearchField$SearchEvent = sap.ui.base.Event<
         SearchField$SearchEventParameters,
         SearchField
       >;
 
+      /**
+       * Event object of the SearchField#suggest event.
+       */
       type SearchField$SuggestEvent = sap.ui.base.Event<
         SearchField$SuggestEventParameters,
         SearchField
       >;
 
+      /**
+       * Event object of the SegmentedButton#select event.
+       */
       type SegmentedButton$SelectEvent = sap.ui.base.Event<
         SegmentedButton$SelectEventParameters,
         SegmentedButton
       >;
 
+      /**
+       * Event object of the Slider#change event.
+       */
       type Slider$ChangeEvent = sap.ui.base.Event<
         Slider$ChangeEventParameters,
         Slider
       >;
 
+      /**
+       * Event object of the Slider#liveChange event.
+       */
       type Slider$LiveChangeEvent = sap.ui.base.Event<
         Slider$LiveChangeEventParameters,
         Slider
       >;
 
+      /**
+       * Event object of the TabStrip#close event.
+       */
       type TabStrip$CloseEvent = sap.ui.base.Event<
         TabStrip$CloseEventParameters,
         TabStrip
       >;
 
+      /**
+       * Event object of the TabStrip#select event.
+       */
       type TabStrip$SelectEvent = sap.ui.base.Event<
         TabStrip$SelectEventParameters,
         TabStrip
       >;
 
+      /**
+       * Event object of the TextField#change event.
+       */
       type TextField$ChangeEvent = sap.ui.base.Event<
         TextField$ChangeEventParameters,
         TextField
       >;
 
+      /**
+       * Event object of the TextField#liveChange event.
+       */
       type TextField$LiveChangeEvent = sap.ui.base.Event<
         TextField$LiveChangeEventParameters,
         TextField
       >;
 
+      /**
+       * Event object of the Tree#select event.
+       */
       type Tree$SelectEvent = sap.ui.base.Event<
         Tree$SelectEventParameters,
         Tree
       >;
 
+      /**
+       * Event object of the Tree#selectionChange event.
+       */
       type Tree$SelectionChangeEvent = sap.ui.base.Event<
         Tree$SelectionChangeEventParameters,
         Tree
       >;
 
+      /**
+       * Event object of the TreeNode#selected event.
+       */
       type TreeNode$SelectedEvent = sap.ui.base.Event<
         TreeNode$SelectedEventParameters,
         TreeNode
       >;
 
+      /**
+       * Event object of the TreeNode#toggleOpenState event.
+       */
       type TreeNode$ToggleOpenStateEvent = sap.ui.base.Event<
         TreeNode$ToggleOpenStateEventParameters,
         TreeNode
       >;
 
+      /**
+       * Event object of the TriStateCheckBox#change event.
+       */
       type TriStateCheckBox$ChangeEvent = sap.ui.base.Event<
         TriStateCheckBox$ChangeEventParameters,
         TriStateCheckBox
       >;
 
+      /**
+       * Event object of the ValueHelpField#valueHelpRequest event.
+       */
       type ValueHelpField$ValueHelpRequestEvent = sap.ui.base.Event<
         ValueHelpField$ValueHelpRequestEventParameters,
         ValueHelpField