@openui5/types 1.120.11 → 1.120.13

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.11
+// For Library Version: 1.120.13
 
 declare module "sap/ui/commons/library" {
   import { ColorPickerMode as ColorPickerMode1 } from "sap/ui/unified/library";
@@ -1099,7 +1099,11 @@ declare module "sap/ui/commons/Accordion" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Accordion constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $AccordionSettings extends $ControlSettings {
     /**
      * When the specified width is less than the width of a section content, a horizontal scroll bar is provided.
@@ -1136,6 +1140,9 @@ declare module "sap/ui/commons/Accordion" {
     sectionsReorder?: (oEvent: Accordion$SectionsReorderEvent) => void;
   }
 
+  /**
+   * Parameters of the Accordion#sectionClose event.
+   */
   export interface Accordion$SectionCloseEventParameters {
     /**
      * ID of the closed section
@@ -1143,11 +1150,17 @@ declare module "sap/ui/commons/Accordion" {
     closeSectionId?: string;
   }
 
+  /**
+   * Event object of the Accordion#sectionClose event.
+   */
   export type Accordion$SectionCloseEvent = Event<
     Accordion$SectionCloseEventParameters,
     Accordion
   >;
 
+  /**
+   * Parameters of the Accordion#sectionOpen event.
+   */
   export interface Accordion$SectionOpenEventParameters {
     /**
      * ID of the opened section
@@ -1160,11 +1173,17 @@ declare module "sap/ui/commons/Accordion" {
     closeSectionIds?: string[];
   }
 
+  /**
+   * Event object of the Accordion#sectionOpen event.
+   */
   export type Accordion$SectionOpenEvent = Event<
     Accordion$SectionOpenEventParameters,
     Accordion
   >;
 
+  /**
+   * Parameters of the Accordion#sectionsReorder event.
+   */
   export interface Accordion$SectionsReorderEventParameters {
     /**
      * ID of the moved section
@@ -1177,6 +1196,9 @@ declare module "sap/ui/commons/Accordion" {
     newIndex?: int;
   }
 
+  /**
+   * Event object of the Accordion#sectionsReorder event.
+   */
   export type Accordion$SectionsReorderEvent = Event<
     Accordion$SectionsReorderEventParameters,
     Accordion
@@ -1523,7 +1545,11 @@ declare module "sap/ui/commons/AccordionSection" {
       sTitle?: string
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the AccordionSection constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $AccordionSectionSettings extends $ElementSettings {
     /**
      * When the section content exceeds maxHeight, a vertical scroll bar appears.
@@ -1561,6 +1587,9 @@ declare module "sap/ui/commons/AccordionSection" {
     scroll?: (oEvent: AccordionSection$ScrollEvent) => void;
   }
 
+  /**
+   * Parameters of the AccordionSection#scroll event.
+   */
   export interface AccordionSection$ScrollEventParameters {
     /**
      * Horizontal scroll position
@@ -1573,6 +1602,9 @@ declare module "sap/ui/commons/AccordionSection" {
     top?: int;
   }
 
+  /**
+   * Event object of the AccordionSection#scroll event.
+   */
   export type AccordionSection$ScrollEvent = Event<
     AccordionSection$ScrollEventParameters,
     AccordionSection
@@ -1871,7 +1903,11 @@ declare module "sap/ui/commons/ApplicationHeader" {
       sUserName?: string
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the ApplicationHeader constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.tnt.ToolHeader` control.
+   */
   export interface $ApplicationHeaderSettings extends $ControlSettings {
     /**
      * Path (src) to the logo icon to be displayed in the application header.
@@ -1904,8 +1940,14 @@ declare module "sap/ui/commons/ApplicationHeader" {
     logoff?: (oEvent: Event) => void;
   }
 
+  /**
+   * Parameters of the ApplicationHeader#logoff event.
+   */
   export interface ApplicationHeader$LogoffEventParameters {}
 
+  /**
+   * Event object of the ApplicationHeader#logoff event.
+   */
   export type ApplicationHeader$LogoffEvent = Event<
     ApplicationHeader$LogoffEventParameters,
     ApplicationHeader
@@ -2091,7 +2133,11 @@ declare module "sap/ui/commons/Area" {
       sShape?: string
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Area constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $AreaSettings extends $ElementSettings {
     /**
      * The value is a string and can be 'rect' for rectangle, 'poly' for poligon, 'circle', or default.
@@ -2348,7 +2394,11 @@ declare module "sap/ui/commons/AutoComplete" {
      */
     setSelectedKey(sSelectedKey: string): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the AutoComplete constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $AutoCompleteSettings extends $ComboBoxSettings {
     /**
      * Determines whether scrolling should be enabled when the number of items is higher than maxPopupItems.
@@ -2362,6 +2412,9 @@ declare module "sap/ui/commons/AutoComplete" {
     suggest?: (oEvent: AutoComplete$SuggestEvent) => void;
   }
 
+  /**
+   * Parameters of the AutoComplete#suggest event.
+   */
   export interface AutoComplete$SuggestEventParameters {
     /**
      * The current value which was typed in.
@@ -2369,6 +2422,9 @@ declare module "sap/ui/commons/AutoComplete" {
     suggestValue?: string;
   }
 
+  /**
+   * Event object of the AutoComplete#suggest event.
+   */
   export type AutoComplete$SuggestEvent = Event<
     AutoComplete$SuggestEventParameters,
     AutoComplete
@@ -2898,7 +2954,11 @@ declare module "sap/ui/commons/layout/BorderLayout" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the BorderLayout constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.Page}
+   */
   export interface $BorderLayoutSettings extends $ControlSettings {
     /**
      * The RTL setting swaps the areas Begin and End.
@@ -3554,7 +3614,11 @@ declare module "sap/ui/commons/Button" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Button constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.Button}
+   */
   export interface $ButtonSettings extends $ControlSettings {
     /**
      * Button text displayed at runtime.
@@ -3643,8 +3707,14 @@ declare module "sap/ui/commons/Button" {
     press?: (oEvent: Event) => void;
   }
 
+  /**
+   * Parameters of the Button#press event.
+   */
   export interface Button$PressEventParameters {}
 
+  /**
+   * Event object of the Button#press event.
+   */
   export type Button$PressEvent = Event<Button$PressEventParameters, Button>;
 }
 
@@ -3808,7 +3878,12 @@ declare module "sap/ui/commons/Callout" {
       vContent: int | string | Control
     ): Control | null;
   }
-
+  /**
+   * 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.
+   */
   export interface $CalloutSettings extends $CalloutBaseSettings {
     /**
      * Determines the content of the Callout
@@ -4247,7 +4322,11 @@ declare module "sap/ui/commons/CalloutBase" {
       atPosition: Dock
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the CalloutBase constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $CalloutBaseSettings extends $TooltipBaseSettings {
     /**
      * The event is fired when the popup is opened.
@@ -4273,6 +4352,9 @@ declare module "sap/ui/commons/CalloutBase" {
     opened?: (oEvent: Event) => void;
   }
 
+  /**
+   * Parameters of the CalloutBase#beforeOpen event.
+   */
   export interface CalloutBase$BeforeOpenEventParameters {
     /**
      * Parent control that has this Callout as a tooltip
@@ -4280,18 +4362,30 @@ declare module "sap/ui/commons/CalloutBase" {
     parent?: Control;
   }
 
+  /**
+   * Event object of the CalloutBase#beforeOpen event.
+   */
   export type CalloutBase$BeforeOpenEvent = Event<
     CalloutBase$BeforeOpenEventParameters,
     CalloutBase
   >;
 
+  /**
+   * Parameters of the CalloutBase#close event.
+   */
   export interface CalloutBase$CloseEventParameters {}
 
+  /**
+   * Event object of the CalloutBase#close event.
+   */
   export type CalloutBase$CloseEvent = Event<
     CalloutBase$CloseEventParameters,
     CalloutBase
   >;
 
+  /**
+   * Parameters of the CalloutBase#open event.
+   */
   export interface CalloutBase$OpenEventParameters {
     /**
      * Parent control that has this Callout as a tooltip
@@ -4299,13 +4393,22 @@ declare module "sap/ui/commons/CalloutBase" {
     parent?: Control;
   }
 
+  /**
+   * Event object of the CalloutBase#open event.
+   */
   export type CalloutBase$OpenEvent = Event<
     CalloutBase$OpenEventParameters,
     CalloutBase
   >;
 
+  /**
+   * Parameters of the CalloutBase#opened event.
+   */
   export interface CalloutBase$OpenedEventParameters {}
 
+  /**
+   * Event object of the CalloutBase#opened event.
+   */
   export type CalloutBase$OpenedEvent = Event<
     CalloutBase$OpenedEventParameters,
     CalloutBase
@@ -4783,7 +4886,11 @@ declare module "sap/ui/commons/Carousel" {
      */
     unbindContent(): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Carousel constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Carousel` control.
+   */
   export interface $CarouselSettings extends $ControlSettings {
     /**
      * Determines the orientation of the Carousel. Can be either "horizontal" or "vertical"
@@ -5340,7 +5447,11 @@ declare module "sap/ui/commons/CheckBox" {
      */
     unbindChecked(): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the CheckBox constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.CheckBox` control.
+   */
   export interface $CheckBoxSettings extends $ControlSettings {
     /**
      * Contains the state of the control whether it is flagged with a check mark, or not
@@ -5407,6 +5518,9 @@ declare module "sap/ui/commons/CheckBox" {
     change?: (oEvent: CheckBox$ChangeEvent) => void;
   }
 
+  /**
+   * Parameters of the CheckBox#change event.
+   */
   export interface CheckBox$ChangeEventParameters {
     /**
      * Checks whether the box is flagged or not flagged.
@@ -5414,6 +5528,9 @@ declare module "sap/ui/commons/CheckBox" {
     checked?: boolean;
   }
 
+  /**
+   * Event object of the CheckBox#change event.
+   */
   export type CheckBox$ChangeEvent = Event<
     CheckBox$ChangeEventParameters,
     CheckBox
@@ -5504,7 +5621,11 @@ declare module "sap/ui/commons/ColorPicker" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * Describes the settings that can be provided to the ColorPicker constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.ui.unified.ColorPicker}
+   */
   export interface $ColorPickerSettings extends $ColorPickerSettings1 {}
 }
 
@@ -5955,7 +6076,11 @@ declare module "sap/ui/commons/ComboBox" {
      */
     unbindItems(): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the ComboBox constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.ComboBox}
+   */
   export interface $ComboBoxSettings extends $TextFieldSettings {
     /**
      * Defines the number of items that shall be displayed at once. If the overall number of items is higher
@@ -6004,6 +6129,9 @@ declare module "sap/ui/commons/ComboBox" {
     listBox?: ListBox | string;
   }
 
+  /**
+   * Parameters of the ComboBox#change event.
+   */
   export interface ComboBox$ChangeEventParameters
     extends TextField$ChangeEventParameters {
     /**
@@ -6012,6 +6140,9 @@ declare module "sap/ui/commons/ComboBox" {
     selectedItem?: ListItem;
   }
 
+  /**
+   * Event object of the ComboBox#change event.
+   */
   export type ComboBox$ChangeEvent = Event<
     ComboBox$ChangeEventParameters,
     ComboBox
@@ -6192,7 +6323,11 @@ declare module "sap/ui/commons/DatePicker" {
       sYyyymmdd?: string
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the DatePicker constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.DatePicker}
+   */
   export interface $DatePickerSettings extends $TextFieldSettings {
     /**
      * Defines the locale (language and country), e.g. "en-US", whose translations and Date formatters should
@@ -7115,7 +7250,11 @@ declare module "sap/ui/commons/Dialog" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Dialog constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Dialog` control.
+   */
   export interface $DialogSettings extends $ControlSettings {
     /**
      * Outer width of dialog window. When not set and not constrained by one of the width parameters (minWidth/maxWidth),
@@ -7256,6 +7395,9 @@ declare module "sap/ui/commons/Dialog" {
     closed?: (oEvent: Dialog$ClosedEvent) => void;
   }
 
+  /**
+   * Parameters of the Dialog#closed event.
+   */
   export interface Dialog$ClosedEventParameters {
     /**
      * The width of the dialog when closed
@@ -7278,6 +7420,9 @@ declare module "sap/ui/commons/Dialog" {
     left?: int;
   }
 
+  /**
+   * Event object of the Dialog#closed event.
+   */
   export type Dialog$ClosedEvent = Event<Dialog$ClosedEventParameters, Dialog>;
 }
 
@@ -7745,7 +7890,11 @@ declare module "sap/ui/commons/DropdownBox" {
       sSearchHelpText: string
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the DropdownBox constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.ComboBox}
+   */
   export interface $DropdownBoxSettings extends $ComboBoxSettings {
     /**
      * Whether the DropdownBox's search help should be enabled.
@@ -7782,6 +7931,9 @@ declare module "sap/ui/commons/DropdownBox" {
     searchHelp?: (oEvent: DropdownBox$SearchHelpEvent) => void;
   }
 
+  /**
+   * Parameters of the DropdownBox#searchHelp event.
+   */
   export interface DropdownBox$SearchHelpEventParameters {
     /**
      * The current value of the DropdownBox.
@@ -7789,6 +7941,9 @@ declare module "sap/ui/commons/DropdownBox" {
     value?: string;
   }
 
+  /**
+   * Event object of the DropdownBox#searchHelp event.
+   */
   export type DropdownBox$SearchHelpEvent = Event<
     DropdownBox$SearchHelpEventParameters,
     DropdownBox
@@ -7882,7 +8037,12 @@ declare module "sap/ui/commons/FileUploader" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * 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.
+   */
   export interface $FileUploaderSettings extends $FileUploaderSettings1 {}
 }
 
@@ -7970,7 +8130,12 @@ declare module "sap/ui/commons/FileUploaderParameter" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * 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.
+   */
   export interface $FileUploaderParameterSettings
     extends $FileUploaderParameterSettings1 {}
 }
@@ -8880,7 +9045,11 @@ declare module "sap/ui/commons/TextField" {
      */
     unbindValue(): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the TextField constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.Input}
+   */
   export interface $TextFieldSettings extends $ControlSettings {
     /**
      * Text inside the `TextField`
@@ -9004,6 +9173,9 @@ declare module "sap/ui/commons/TextField" {
     liveChange?: (oEvent: TextField$LiveChangeEvent) => void;
   }
 
+  /**
+   * Parameters of the TextField#change event.
+   */
   export interface TextField$ChangeEventParameters {
     /**
      * The new / changed value of the `TextField`.
@@ -9011,11 +9183,17 @@ declare module "sap/ui/commons/TextField" {
     newValue?: string;
   }
 
+  /**
+   * Event object of the TextField#change event.
+   */
   export type TextField$ChangeEvent = Event<
     TextField$ChangeEventParameters,
     TextField
   >;
 
+  /**
+   * Parameters of the TextField#liveChange event.
+   */
   export interface TextField$LiveChangeEventParameters {
     /**
      * Current visible value of the `TextField`.
@@ -9023,6 +9201,9 @@ declare module "sap/ui/commons/TextField" {
     liveValue?: string;
   }
 
+  /**
+   * Event object of the TextField#liveChange event.
+   */
   export type TextField$LiveChangeEvent = Event<
     TextField$LiveChangeEventParameters,
     TextField
@@ -9139,7 +9320,11 @@ declare module "sap/ui/commons/form/Form" {
       bVisible: boolean
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $FormSettings extends $FormSettings1 {}
 }
 
@@ -9252,7 +9437,11 @@ declare module "sap/ui/commons/form/FormContainer" {
       bVisible: boolean
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $FormContainerSettings extends $FormContainerSettings1 {}
 }
 
@@ -9365,7 +9554,11 @@ declare module "sap/ui/commons/form/FormElement" {
       bVisible: boolean
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $FormElementSettings extends $FormElementSettings1 {}
 }
 
@@ -9453,7 +9646,11 @@ declare module "sap/ui/commons/form/FormLayout" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * 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.
+   */
   export interface $FormLayoutSettings extends $FormLayoutSettings1 {}
 }
 
@@ -9542,7 +9739,11 @@ declare module "sap/ui/commons/form/GridContainerData" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * 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.
+   */
   export interface $GridContainerDataSettings
     extends $GridContainerDataSettings1 {}
 }
@@ -9632,7 +9833,11 @@ declare module "sap/ui/commons/form/GridElementData" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * 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.
+   */
   export interface $GridElementDataSettings extends $GridElementDataSettings1 {}
 }
 
@@ -9722,7 +9927,11 @@ declare module "sap/ui/commons/form/GridLayout" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * 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.
+   */
   export interface $GridLayoutSettings extends $GridLayoutSettings1 {}
 }
 
@@ -9810,7 +10019,11 @@ declare module "sap/ui/commons/form/ResponsiveLayout" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * 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.
+   */
   export interface $ResponsiveLayoutSettings
     extends $ResponsiveLayoutSettings1 {}
 }
@@ -9947,7 +10160,11 @@ declare module "sap/ui/commons/form/SimpleForm" {
       sLayout?: form.SimpleFormLayout | keyof typeof form.SimpleFormLayout
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $SimpleFormSettings extends $SimpleFormSettings1 {
     /**
      * The `FormLayout` that is used to render the `SimpleForm`.
@@ -10196,7 +10413,11 @@ declare module "sap/ui/commons/FormattedTextView" {
       sText: string
     ): void;
   }
-
+  /**
+   * Describes the settings that can be provided to the FormattedTextView constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.ui.core.HTML` control.
+   */
   export interface $FormattedTextViewSettings extends $ControlSettings {
     /**
      * The ARIA role for the control.
@@ -10388,7 +10609,11 @@ declare module "sap/ui/commons/HorizontalDivider" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the HorizontalDivider constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $HorizontalDividerSettings extends $ControlSettings {
     /**
      * Defines the width of the divider.
@@ -10748,7 +10973,11 @@ declare module "sap/ui/commons/Image" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Image constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.Image}
+   */
   export interface $ImageSettings extends $ControlSettings {
     /**
      * Relative or absolute path to URL where the image file is stored.
@@ -10792,8 +11021,14 @@ declare module "sap/ui/commons/Image" {
     press?: (oEvent: Event) => void;
   }
 
+  /**
+   * Parameters of the Image#press event.
+   */
   export interface Image$PressEventParameters {}
 
+  /**
+   * Event object of the Image#press event.
+   */
   export type Image$PressEvent = Event<Image$PressEventParameters, Image>;
 }
 
@@ -11074,7 +11309,11 @@ declare module "sap/ui/commons/ImageMap" {
       sName?: string
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $ImageMapSettings extends $ControlSettings {
     /**
      * Name for the image that serves as reference
@@ -11092,6 +11331,9 @@ declare module "sap/ui/commons/ImageMap" {
     press?: (oEvent: ImageMap$PressEvent) => void;
   }
 
+  /**
+   * Parameters of the ImageMap#press event.
+   */
   export interface ImageMap$PressEventParameters {
     /**
      * Id of clicked Area.
@@ -11099,6 +11341,9 @@ declare module "sap/ui/commons/ImageMap" {
     areaId?: string;
   }
 
+  /**
+   * Event object of the ImageMap#press event.
+   */
   export type ImageMap$PressEvent = Event<
     ImageMap$PressEventParameters,
     ImageMap
@@ -11521,7 +11766,11 @@ declare module "sap/ui/commons/InPlaceEdit" {
       sValueState?: ValueState | keyof typeof ValueState
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the InPlaceEdit constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.Input}
+   */
   export interface $InPlaceEditSettings extends $ControlSettings {
     /**
      * Visualizes warnings or errors related to the InPlaceEdit. Possible values: Warning, Error, Success. If
@@ -11569,6 +11818,9 @@ declare module "sap/ui/commons/InPlaceEdit" {
     liveChange?: (oEvent: InPlaceEdit$LiveChangeEvent) => void;
   }
 
+  /**
+   * Parameters of the InPlaceEdit#change event.
+   */
   export interface InPlaceEdit$ChangeEventParameters {
     /**
      * The new / changed value of the InPlaceEdit.
@@ -11576,11 +11828,17 @@ declare module "sap/ui/commons/InPlaceEdit" {
     newValue?: string;
   }
 
+  /**
+   * Event object of the InPlaceEdit#change event.
+   */
   export type InPlaceEdit$ChangeEvent = Event<
     InPlaceEdit$ChangeEventParameters,
     InPlaceEdit
   >;
 
+  /**
+   * Parameters of the InPlaceEdit#liveChange event.
+   */
   export interface InPlaceEdit$LiveChangeEventParameters {
     /**
      * Current value of the Textfield.
@@ -11588,6 +11846,9 @@ declare module "sap/ui/commons/InPlaceEdit" {
     liveValue?: string;
   }
 
+  /**
+   * Event object of the InPlaceEdit#liveChange event.
+   */
   export type InPlaceEdit$LiveChangeEvent = Event<
     InPlaceEdit$LiveChangeEventParameters,
     InPlaceEdit
@@ -11978,7 +12239,11 @@ declare module "sap/ui/commons/Label" {
       bWrapping?: boolean
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Label constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Label` control.
+   */
   export interface $LabelSettings extends $ControlSettings {
     /**
      * Defines whether the labels are in bold format.
@@ -12397,7 +12662,11 @@ declare module "sap/ui/commons/layout/AbsoluteLayout" {
       sWidth: string
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the AbsoluteLayout constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $AbsoluteLayoutSettings extends $ControlSettings {
     /**
      * The overall width of the control. When not set, 100% is automatically set.
@@ -12778,7 +13047,11 @@ declare module "sap/ui/commons/layout/BorderLayoutArea" {
       bVisible?: boolean
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the BorderLayoutArea constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Page` control.
+   */
   export interface $BorderLayoutAreaSettings extends $ElementSettings {
     /**
      * Defines which area the element represents: top, begin, center, end, bottom
@@ -12908,7 +13181,11 @@ declare module "sap/ui/commons/layout/HorizontalLayout" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * Describes the settings that can be provided to the HorizontalLayout constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.ui.layout.HorizontalLayout` control.
+   */
   export interface $HorizontalLayoutSettings
     extends $HorizontalLayoutSettings1 {}
 }
@@ -13231,7 +13508,11 @@ declare module "sap/ui/commons/layout/MatrixLayout" {
       sWidths?: CSSSize[]
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the MatrixLayout constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.ui.layout.Grid` control.
+   */
   export interface $MatrixLayoutSettings extends $ControlSettings {
     /**
      * CSS width of the matrix layout. If the LayoutFixed = true an adequate width should be provided.
@@ -13711,7 +13992,11 @@ declare module "sap/ui/commons/layout/MatrixLayoutCell" {
       sVAlign?: layout.VAlign | keyof typeof layout.VAlign
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the MatrixLayoutCell constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.ui.layout.Grid` control.
+   */
   export interface $MatrixLayoutCellSettings extends $ElementSettings {
     /**
      * Determines the matrix layout cell's background design.
@@ -14022,7 +14307,11 @@ declare module "sap/ui/commons/layout/MatrixLayoutRow" {
       sHeight?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the MatrixLayoutRow constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.ui.layout.Grid` control.
+   */
   export interface $MatrixLayoutRowSettings extends $ElementSettings {
     /**
      * Height of the row.
@@ -14318,7 +14607,11 @@ declare module "sap/ui/commons/layout/PositionContainer" {
       oPos: object
     ): void;
   }
-
+  /**
+   * Describes the settings that can be provided to the PositionContainer constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $PositionContainerSettings extends $ElementSettings {
     /**
      * Defines the distance to the top of the layout (as specified in HTML)
@@ -14444,7 +14737,11 @@ declare module "sap/ui/commons/layout/ResponsiveFlowLayout" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * 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.
+   */
   export interface $ResponsiveFlowLayoutSettings
     extends $ResponsiveFlowLayoutSettings1 {}
 }
@@ -14558,7 +14855,11 @@ declare module "sap/ui/commons/layout/ResponsiveFlowLayoutData" {
       bMargin: boolean
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $ResponsiveFlowLayoutDataSettings
     extends $ResponsiveFlowLayoutDataSettings1 {}
 }
@@ -14646,7 +14947,11 @@ declare module "sap/ui/commons/layout/VerticalLayout" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * 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.
+   */
   export interface $VerticalLayoutSettings extends $VerticalLayoutSettings1 {}
 }
 
@@ -15080,7 +15385,11 @@ declare module "sap/ui/commons/Link" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Link constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Link` control.
+   */
   export interface $LinkSettings extends $ControlSettings {
     /**
      * Link text to be displayed.
@@ -15132,8 +15441,14 @@ declare module "sap/ui/commons/Link" {
     press?: (oEvent: Event) => void;
   }
 
+  /**
+   * Parameters of the Link#press event.
+   */
   export interface Link$PressEventParameters {}
 
+  /**
+   * Event object of the Link#press event.
+   */
   export type Link$PressEvent = Event<Link$PressEventParameters, Link>;
 }
 
@@ -15973,7 +16288,11 @@ declare module "sap/ui/commons/ListBox" {
       sWidth: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the ListBox constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.List` control.
+   */
   export interface $ListBoxSettings extends $ControlSettings {
     /**
      * Determines whether the ListBox is interactive or not. Can be used to disable interaction with mouse or
@@ -16083,6 +16402,9 @@ declare module "sap/ui/commons/ListBox" {
     select?: (oEvent: ListBox$SelectEvent) => void;
   }
 
+  /**
+   * Parameters of the ListBox#select event.
+   */
   export interface ListBox$SelectEventParameters {
     /**
      * ID of the ListBox which triggered the event.
@@ -16108,6 +16430,9 @@ declare module "sap/ui/commons/ListBox" {
     selectedIndices?: int[];
   }
 
+  /**
+   * Event object of the ListBox#select event.
+   */
   export type ListBox$SelectEvent = Event<
     ListBox$SelectEventParameters,
     ListBox
@@ -16200,7 +16525,11 @@ declare module "sap/ui/commons/Menu" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * Describes the settings that can be provided to the Menu constructor.
+   *
+   * @deprecated (since 1.21.0) - replaced by {@link sap.ui.unified.Menu}
+   */
   export interface $MenuSettings extends $MenuSettings1 {}
 }
 
@@ -16458,7 +16787,11 @@ declare module "sap/ui/commons/MenuBar" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the MenuBar constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.OverflowToolbar` control.
+   */
   export interface $MenuBarSettings extends $ControlSettings {
     /**
      * When the MenuBar is not enabled, automatically all single menu items are also displayed as 'disabled'.
@@ -16817,7 +17150,11 @@ declare module "sap/ui/commons/MenuButton" {
       oMenu: Menu
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the MenuButton constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.MenuButton` control.
+   */
   export interface $MenuButtonSettings extends $ButtonSettings {
     /**
      * The position / edge (see sap.ui.core.Popup.Dock) of the button where the menu is docked. Default is 'begin
@@ -16842,6 +17179,9 @@ declare module "sap/ui/commons/MenuButton" {
     itemSelected?: (oEvent: MenuButton$ItemSelectedEvent) => void;
   }
 
+  /**
+   * Parameters of the MenuButton#itemSelected event.
+   */
   export interface MenuButton$ItemSelectedEventParameters {
     /**
      * The ID of the selected item
@@ -16854,11 +17194,17 @@ declare module "sap/ui/commons/MenuButton" {
     item?: MenuItemBase;
   }
 
+  /**
+   * Event object of the MenuButton#itemSelected event.
+   */
   export type MenuButton$ItemSelectedEvent = Event<
     MenuButton$ItemSelectedEventParameters,
     MenuButton
   >;
 
+  /**
+   * Parameters of the MenuButton#press event.
+   */
   export interface MenuButton$PressEventParameters
     extends Button$PressEventParameters {
     /**
@@ -16872,6 +17218,9 @@ declare module "sap/ui/commons/MenuButton" {
     item?: MenuItemBase1;
   }
 
+  /**
+   * Event object of the MenuButton#press event.
+   */
   export type MenuButton$PressEvent = Event<
     MenuButton$PressEventParameters,
     MenuButton
@@ -16963,7 +17312,11 @@ declare module "sap/ui/commons/MenuItem" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * Describes the settings that can be provided to the MenuItem constructor.
+   *
+   * @deprecated (since 1.21.0) - replaced by {@link sap.ui.unified.MenuItem}
+   */
   export interface $MenuItemSettings extends $MenuItemSettings1 {}
 }
 
@@ -17003,7 +17356,11 @@ declare module "sap/ui/commons/MenuItemBase" {
       mSettings?: $MenuItemBaseSettings
     );
   }
-
+  /**
+   * Describes the settings that can be provided to the MenuItemBase constructor.
+   *
+   * @deprecated (since 1.21.0) - replaced by {@link sap.ui.unified.MenuItemBase}
+   */
   export interface $MenuItemBaseSettings extends $MenuItemBaseSettings1 {}
 }
 
@@ -17093,7 +17450,12 @@ declare module "sap/ui/commons/MenuTextFieldItem" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * 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.
+   */
   export interface $MenuTextFieldItemSettings
     extends $MenuTextFieldItemSettings1 {}
 }
@@ -17291,7 +17653,12 @@ declare module "sap/ui/commons/Message" {
       sType?: MessageType | keyof typeof MessageType
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $MessageSettings extends $ControlSettings {
     /**
      * "Success", or "Warning", or "Error" messages. (Mandatory)
@@ -17575,7 +17942,11 @@ declare module "sap/ui/commons/MessageBar" {
       bVisible: boolean
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the MessageBar constructor.
+   *
+   * @deprecated (since 1.4.0) - Instead, use the `sap.m.MessagePopover` control.
+   */
   export interface $MessageBarSettings extends $ControlSettings {
     /**
      * Element ID upon which the MessageBar will be initially positioned.
@@ -17776,6 +18147,9 @@ declare module "sap/ui/commons/MessageBox" {
     ): void;
   }
   const MessageBox: MessageBox;
+  /**
+   * @deprecated (since 1.38) - Instead, use the `sap.m.MessageBox` control.
+   */
   export default MessageBox;
 
   /**
@@ -18029,7 +18403,12 @@ declare module "sap/ui/commons/MessageList" {
       bVisible: boolean
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $MessageListSettings extends $ControlSettings {
     /**
      * Specifies whether or not the MessageList is visible. Invisible controls are not rendered.
@@ -18251,7 +18630,11 @@ declare module "sap/ui/commons/MessageToast" {
       sAnchorId: string
     ): void;
   }
-
+  /**
+   * Describes the settings that can be provided to the MessageToast constructor.
+   *
+   * @deprecated (since 1.4.0) - Instead, use the `sap.m.MessageToast` control.
+   */
   export interface $MessageToastSettings extends $ControlSettings {
     /**
      * ID of the anchor on top of which the MessageToast is to render.
@@ -18264,8 +18647,14 @@ declare module "sap/ui/commons/MessageToast" {
     next?: (oEvent: Event) => void;
   }
 
+  /**
+   * Parameters of the MessageToast#next event.
+   */
   export interface MessageToast$NextEventParameters {}
 
+  /**
+   * Event object of the MessageToast#next event.
+   */
   export type MessageToast$NextEvent = Event<
     MessageToast$NextEventParameters,
     MessageToast
@@ -18484,7 +18873,11 @@ declare module "sap/ui/commons/Paginator" {
       iNumberOfPages?: int
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Paginator constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $PaginatorSettings extends $ControlSettings {
     /**
      * Represents the current page (first page has index 1, not 0, to match the visual number)
@@ -18502,6 +18895,9 @@ declare module "sap/ui/commons/Paginator" {
     page?: (oEvent: Paginator$PageEvent) => void;
   }
 
+  /**
+   * Parameters of the Paginator#page event.
+   */
   export interface Paginator$PageEventParameters {
     /**
      * The page which is the current one before the page event is fired (and another page is displayed)
@@ -18523,6 +18919,9 @@ declare module "sap/ui/commons/Paginator" {
     type?: PaginatorEvent | keyof typeof PaginatorEvent;
   }
 
+  /**
+   * Event object of the Paginator#page event.
+   */
   export type Paginator$PageEvent = Event<
     Paginator$PageEventParameters,
     Paginator
@@ -19085,7 +19484,11 @@ declare module "sap/ui/commons/Panel" {
       sWidth: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Panel constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Panel` control.
+   */
   export interface $PanelSettings extends $ControlSettings {
     /**
      * Determines the width of the Panel in CSS size.
@@ -19254,7 +19657,11 @@ declare module "sap/ui/commons/PasswordField" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * Describes the settings that can be provided to the PasswordField constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Input` control.
+   */
   export interface $PasswordFieldSettings extends $TextFieldSettings {}
 }
 
@@ -19522,7 +19929,11 @@ declare module "sap/ui/commons/ProgressIndicator" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the ProgressIndicator constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.ProgressIndicator` control.
+   */
   export interface $ProgressIndicatorSettings extends $ControlSettings {
     /**
      * Determines whether the control is enabled or not. Disabled controls have different colors, and can not
@@ -20059,7 +20470,11 @@ declare module "sap/ui/commons/RadioButton" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the RadioButton constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.RadioButton` control.
+   */
   export interface $RadioButtonSettings extends $ControlSettings {
     /**
      * Defines the text displayed next to the RadioButton.
@@ -20132,8 +20547,14 @@ declare module "sap/ui/commons/RadioButton" {
     select?: (oEvent: Event) => void;
   }
 
+  /**
+   * Parameters of the RadioButton#select event.
+   */
   export interface RadioButton$SelectEventParameters {}
 
+  /**
+   * Event object of the RadioButton#select event.
+   */
   export type RadioButton$SelectEvent = Event<
     RadioButton$SelectEventParameters,
     RadioButton
@@ -20688,7 +21109,11 @@ declare module "sap/ui/commons/RadioButtonGroup" {
      */
     unbindItems(): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the RadioButtonGroup constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.RadioButtonGroup` control.
+   */
   export interface $RadioButtonGroupSettings extends $ControlSettings {
     /**
      * Defines the width of the RadioButtonGroup.
@@ -20753,6 +21178,9 @@ declare module "sap/ui/commons/RadioButtonGroup" {
     select?: (oEvent: RadioButtonGroup$SelectEvent) => void;
   }
 
+  /**
+   * Parameters of the RadioButtonGroup#select event.
+   */
   export interface RadioButtonGroup$SelectEventParameters {
     /**
      * Index of the selected RadioButton.
@@ -20760,6 +21188,9 @@ declare module "sap/ui/commons/RadioButtonGroup" {
     selectedIndex?: int;
   }
 
+  /**
+   * Event object of the RadioButtonGroup#select event.
+   */
   export type RadioButtonGroup$SelectEvent = Event<
     RadioButtonGroup$SelectEventParameters,
     RadioButtonGroup
@@ -20879,7 +21310,11 @@ declare module "sap/ui/commons/RangeSlider" {
       fValue2?: float
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the RangeSlider constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.RangeSlider}
+   */
   export interface $RangeSliderSettings extends $SliderSettings {
     /**
      * Current second value of the slider. (Position of the second grip.)
@@ -21388,7 +21823,11 @@ declare module "sap/ui/commons/RatingIndicator" {
      */
     unbindValue(): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the RatingIndicator constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.RatingIndicator` control.
+   */
   export interface $RatingIndicatorSettings extends $ControlSettings {
     /**
      * Determines if the rating symbols can be edited.
@@ -21456,6 +21895,9 @@ declare module "sap/ui/commons/RatingIndicator" {
     change?: (oEvent: RatingIndicator$ChangeEvent) => void;
   }
 
+  /**
+   * Parameters of the RatingIndicator#change event.
+   */
   export interface RatingIndicator$ChangeEventParameters {
     /**
      * The value of the user rating
@@ -21463,6 +21905,9 @@ declare module "sap/ui/commons/RatingIndicator" {
     value?: int;
   }
 
+  /**
+   * Event object of the RatingIndicator#change event.
+   */
   export type RatingIndicator$ChangeEvent = Event<
     RatingIndicator$ChangeEventParameters,
     RatingIndicator
@@ -21789,7 +22234,11 @@ declare module "sap/ui/commons/ResponsiveContainer" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $ResponsiveContainerSettings extends $ControlSettings {
     /**
      * The width of the responsive container.
@@ -21821,6 +22270,9 @@ declare module "sap/ui/commons/ResponsiveContainer" {
     rangeSwitch?: (oEvent: ResponsiveContainer$RangeSwitchEvent) => void;
   }
 
+  /**
+   * Parameters of the ResponsiveContainer#rangeSwitch event.
+   */
   export interface ResponsiveContainer$RangeSwitchEventParameters {
     /**
      * The current range
@@ -21828,6 +22280,9 @@ declare module "sap/ui/commons/ResponsiveContainer" {
     currentRange?: ResponsiveContainerRange;
   }
 
+  /**
+   * Event object of the ResponsiveContainer#rangeSwitch event.
+   */
   export type ResponsiveContainer$RangeSwitchEvent = Event<
     ResponsiveContainer$RangeSwitchEventParameters,
     ResponsiveContainer
@@ -22018,7 +22473,11 @@ declare module "sap/ui/commons/ResponsiveContainerRange" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the ResponsiveContainerRange constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $ResponsiveContainerRangeSettings extends $ElementSettings {
     /**
      * The minimal width for this range to be displayed.
@@ -22229,7 +22688,12 @@ declare module "sap/ui/commons/RichTooltip" {
       sText: string
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $RichTooltipSettings extends $TooltipBaseSettings {
     /**
      * Tool tip title to be displayed in the header.
@@ -22679,7 +23143,11 @@ declare module "sap/ui/commons/RoadMap" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the RoadMap constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Wizard` control.
+   */
   export interface $RoadMapSettings extends $ControlSettings {
     /**
      * Total number of steps to be displayed at once
@@ -22721,6 +23189,9 @@ declare module "sap/ui/commons/RoadMap" {
     stepExpanded?: (oEvent: RoadMap$StepExpandedEvent) => void;
   }
 
+  /**
+   * Parameters of the RoadMap#stepExpanded event.
+   */
   export interface RoadMap$StepExpandedEventParameters {
     /**
      * ID of the expanded/collapsed step
@@ -22728,11 +23199,17 @@ declare module "sap/ui/commons/RoadMap" {
     stepId?: string;
   }
 
+  /**
+   * Event object of the RoadMap#stepExpanded event.
+   */
   export type RoadMap$StepExpandedEvent = Event<
     RoadMap$StepExpandedEventParameters,
     RoadMap
   >;
 
+  /**
+   * Parameters of the RoadMap#stepSelected event.
+   */
   export interface RoadMap$StepSelectedEventParameters {
     /**
      * ID of the selected step
@@ -22740,6 +23217,9 @@ declare module "sap/ui/commons/RoadMap" {
     stepId?: string;
   }
 
+  /**
+   * Event object of the RoadMap#stepSelected event.
+   */
   export type RoadMap$StepSelectedEvent = Event<
     RoadMap$StepSelectedEventParameters,
     RoadMap
@@ -23034,7 +23514,11 @@ declare module "sap/ui/commons/RoadMapStep" {
       bVisible?: boolean
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the RoadMapStep constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Wizard` control.
+   */
   export interface $RoadMapStepSettings extends $ElementSettings {
     /**
      * Label of the step
@@ -24001,7 +24485,11 @@ declare module "sap/ui/commons/RowRepeater" {
      */
     unbindRows(): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the RowRepeater constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.ui.table.Table` control.
+   */
   export interface $RowRepeaterSettings extends $ControlSettings {
     /**
      * Number of rows displayed.
@@ -24092,6 +24580,9 @@ declare module "sap/ui/commons/RowRepeater" {
     resize?: (oEvent: RowRepeater$ResizeEvent) => void;
   }
 
+  /**
+   * Parameters of the RowRepeater#filter event.
+   */
   export interface RowRepeater$FilterEventParameters {
     /**
      * The ID of the filter that has just been applied.
@@ -24099,11 +24590,17 @@ declare module "sap/ui/commons/RowRepeater" {
     filterId?: string;
   }
 
+  /**
+   * Event object of the RowRepeater#filter event.
+   */
   export type RowRepeater$FilterEvent = Event<
     RowRepeater$FilterEventParameters,
     RowRepeater
   >;
 
+  /**
+   * Parameters of the RowRepeater#page event.
+   */
   export interface RowRepeater$PageEventParameters {
     /**
      * The value of the currentPage property after the change.
@@ -24116,11 +24613,17 @@ declare module "sap/ui/commons/RowRepeater" {
     previousPage?: int;
   }
 
+  /**
+   * Event object of the RowRepeater#page event.
+   */
   export type RowRepeater$PageEvent = Event<
     RowRepeater$PageEventParameters,
     RowRepeater
   >;
 
+  /**
+   * Parameters of the RowRepeater#resize event.
+   */
   export interface RowRepeater$ResizeEventParameters {
     /**
      * The value of the numberOfRows property after the change.
@@ -24133,11 +24636,17 @@ declare module "sap/ui/commons/RowRepeater" {
     previousNumberOfRows?: int;
   }
 
+  /**
+   * Event object of the RowRepeater#resize event.
+   */
   export type RowRepeater$ResizeEvent = Event<
     RowRepeater$ResizeEventParameters,
     RowRepeater
   >;
 
+  /**
+   * Parameters of the RowRepeater#sort event.
+   */
   export interface RowRepeater$SortEventParameters {
     /**
      * The ID of the sorter that has just been applied.
@@ -24145,6 +24654,9 @@ declare module "sap/ui/commons/RowRepeater" {
     sorterId?: string;
   }
 
+  /**
+   * Event object of the RowRepeater#sort event.
+   */
   export type RowRepeater$SortEvent = Event<
     RowRepeater$SortEventParameters,
     RowRepeater
@@ -24303,7 +24815,11 @@ declare module "sap/ui/commons/RowRepeaterFilter" {
       sText?: string
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the RowRepeaterFilter constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.ui.table.Table` control.
+   */
   export interface $RowRepeaterFilterSettings extends $ElementSettings {
     /**
      * The filter title if needed for display.
@@ -24474,7 +24990,11 @@ declare module "sap/ui/commons/RowRepeaterSorter" {
       sText?: string
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the RowRepeaterSorter constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.ui.table.Table` control.
+   */
   export interface $RowRepeaterSorterSettings extends $ElementSettings {
     /**
      * The sorter title if needed for display.
@@ -25381,7 +25901,11 @@ declare module "sap/ui/commons/SearchField" {
       aASuggestions: string[]
     ): void;
   }
-
+  /**
+   * Describes the settings that can be provided to the SearchField constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.SearchField` control.
+   */
   export interface $SearchFieldSettings extends $ControlSettings {
     /**
      * Defines whether a pop up list shall be provided for suggestions
@@ -25516,6 +26040,9 @@ declare module "sap/ui/commons/SearchField" {
     suggest?: (oEvent: SearchField$SuggestEvent) => void;
   }
 
+  /**
+   * Parameters of the SearchField#search event.
+   */
   export interface SearchField$SearchEventParameters {
     /**
      * The search query
@@ -25523,11 +26050,17 @@ declare module "sap/ui/commons/SearchField" {
     query?: string;
   }
 
+  /**
+   * Event object of the SearchField#search event.
+   */
   export type SearchField$SearchEvent = Event<
     SearchField$SearchEventParameters,
     SearchField
   >;
 
+  /**
+   * Parameters of the SearchField#suggest event.
+   */
   export interface SearchField$SuggestEventParameters {
     /**
      * The value for which suggestions are required.
@@ -25535,6 +26068,9 @@ declare module "sap/ui/commons/SearchField" {
     value?: string;
   }
 
+  /**
+   * Event object of the SearchField#suggest event.
+   */
   export type SearchField$SuggestEvent = Event<
     SearchField$SuggestEventParameters,
     SearchField
@@ -25624,7 +26160,11 @@ declare module "sap/ui/commons/SearchProvider" {
      */
     static getMetadata(): ElementMetadata;
   }
-
+  /**
+   * Describes the settings that can be provided to the SearchProvider constructor.
+   *
+   * @deprecated (since 1.6.0) - Replaced by sap.ui.core.search.OpenSearchProvider
+   */
   export interface $SearchProviderSettings
     extends $OpenSearchProviderSettings {}
 }
@@ -25929,7 +26469,11 @@ declare module "sap/ui/commons/SegmentedButton" {
       oSelectedButton: ID | Button
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the SegmentedButton constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.SegmentedButton}
+   */
   export interface $SegmentedButtonSettings extends $ControlSettings {
     /**
      * enabled
@@ -25952,6 +26496,9 @@ declare module "sap/ui/commons/SegmentedButton" {
     select?: (oEvent: SegmentedButton$SelectEvent) => void;
   }
 
+  /**
+   * Parameters of the SegmentedButton#select event.
+   */
   export interface SegmentedButton$SelectEventParameters {
     /**
      * Id of selected ToggleButton
@@ -25959,6 +26506,9 @@ declare module "sap/ui/commons/SegmentedButton" {
     selectedButtonId?: string;
   }
 
+  /**
+   * Event object of the SegmentedButton#select event.
+   */
   export type SegmentedButton$SelectEvent = Event<
     SegmentedButton$SelectEventParameters,
     SegmentedButton
@@ -26635,7 +27185,11 @@ declare module "sap/ui/commons/Slider" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Slider constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.Slider}
+   */
   export interface $SliderSettings extends $ControlSettings {
     /**
      * Width of the horizontal slider.
@@ -26733,6 +27287,9 @@ declare module "sap/ui/commons/Slider" {
     liveChange?: (oEvent: Slider$LiveChangeEvent) => void;
   }
 
+  /**
+   * Parameters of the Slider#change event.
+   */
   export interface Slider$ChangeEventParameters {
     /**
      * Current value of the slider after a change.
@@ -26740,8 +27297,14 @@ declare module "sap/ui/commons/Slider" {
     value?: float;
   }
 
+  /**
+   * Event object of the Slider#change event.
+   */
   export type Slider$ChangeEvent = Event<Slider$ChangeEventParameters, Slider>;
 
+  /**
+   * Parameters of the Slider#liveChange event.
+   */
   export interface Slider$LiveChangeEventParameters {
     /**
      * Current value of the slider after a change.
@@ -26749,6 +27312,9 @@ declare module "sap/ui/commons/Slider" {
     value?: float;
   }
 
+  /**
+   * Event object of the Slider#liveChange event.
+   */
   export type Slider$LiveChangeEvent = Event<
     Slider$LiveChangeEventParameters,
     Slider
@@ -27232,7 +27798,11 @@ declare module "sap/ui/commons/Splitter" {
       sWidth?: SplitterSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Splitter constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.ui.layout.Splitter` control.
+   */
   export interface $SplitterSettings extends $ControlSettings {
     /**
      * The splitter can have horizontal or vertical orientation.
@@ -27499,7 +28069,11 @@ declare module "sap/ui/commons/Tab" {
       sVerticalScrolling?: Scrolling | keyof typeof Scrolling
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Tab constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.TabContainer` control.
+   */
   export interface $TabSettings extends $PanelSettings {
     /**
      * Specifies the vertical scrolling.
@@ -27986,7 +28560,11 @@ declare module "sap/ui/commons/TabStrip" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the TabStrip constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.TabContainer` control.
+   */
   export interface $TabStripSettings extends $ControlSettings {
     /**
      * Specifies the height of the tab bar and content area.
@@ -28024,6 +28602,9 @@ declare module "sap/ui/commons/TabStrip" {
     close?: (oEvent: TabStrip$CloseEvent) => void;
   }
 
+  /**
+   * Parameters of the TabStrip#close event.
+   */
   export interface TabStrip$CloseEventParameters {
     /**
      * The index of the closed tab.
@@ -28031,11 +28612,17 @@ declare module "sap/ui/commons/TabStrip" {
     index?: int;
   }
 
+  /**
+   * Event object of the TabStrip#close event.
+   */
   export type TabStrip$CloseEvent = Event<
     TabStrip$CloseEventParameters,
     TabStrip
   >;
 
+  /**
+   * Parameters of the TabStrip#select event.
+   */
   export interface TabStrip$SelectEventParameters {
     /**
      * The index of the selected tab.
@@ -28043,6 +28630,9 @@ declare module "sap/ui/commons/TabStrip" {
     index?: int;
   }
 
+  /**
+   * Event object of the TabStrip#select event.
+   */
   export type TabStrip$SelectEvent = Event<
     TabStrip$SelectEventParameters,
     TabStrip
@@ -28317,7 +28907,11 @@ declare module "sap/ui/commons/TextArea" {
       sWrapping?: Wrapping | keyof typeof Wrapping
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the TextArea constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.TextArea` control.
+   */
   export interface $TextAreaSettings extends $TextFieldSettings {
     /**
      * Height of text field. When it is set (CSS-size such as % or px), this is the exact size.
@@ -28845,7 +29439,11 @@ declare module "sap/ui/commons/TextView" {
      */
     unbindText(): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the TextView constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $TextViewSettings extends $ControlSettings {
     /**
      * Text to be displayed.
@@ -29039,7 +29637,11 @@ declare module "sap/ui/commons/Title" {
       oLevel: TitleLevel | keyof typeof TitleLevel
     ): this;
   }
-
+  /**
+   * 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.
+   */
   export interface $TitleSettings extends $TitleSettings1 {}
 }
 
@@ -29159,7 +29761,11 @@ declare module "sap/ui/commons/ToggleButton" {
       bPressed?: boolean
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the ToggleButton constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.ToggleButton}
+   */
   export interface $ToggleButtonSettings extends $ButtonSettings {
     /**
      * The property is “true” when the control is toggled. The default state of this property is "false".
@@ -29499,7 +30105,11 @@ declare module "sap/ui/commons/Toolbar" {
       sWidth?: CSSSize
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Toolbar constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.Toolbar}
+   */
   export interface $ToolbarSettings extends $ControlSettings {
     /**
      * When there is not enough space for the toolbar to display all items, the rightmost items are overflowing
@@ -29677,7 +30287,11 @@ declare module "sap/ui/commons/ToolbarSeparator" {
       bDisplayVisualSeparator?: boolean
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the ToolbarSeparator constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Toolbar` control.
+   */
   export interface $ToolbarSeparatorSettings extends $ElementSettings {
     /**
      * When set to false, there is no visual indication of separation by a vertical line but by a wider space.
@@ -30291,7 +30905,11 @@ declare module "sap/ui/commons/Tree" {
      */
     unbindNodes(): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the Tree constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.Tree}
+   */
   export interface $TreeSettings extends $ControlSettings {
     /**
      * Tree title
@@ -30353,6 +30971,9 @@ declare module "sap/ui/commons/Tree" {
     selectionChange?: (oEvent: Tree$SelectionChangeEvent) => void;
   }
 
+  /**
+   * Parameters of the Tree#select event.
+   */
   export interface Tree$SelectEventParameters {
     /**
      * The node which has been selected.
@@ -30365,8 +30986,14 @@ declare module "sap/ui/commons/Tree" {
     nodeContext?: object;
   }
 
+  /**
+   * Event object of the Tree#select event.
+   */
   export type Tree$SelectEvent = Event<Tree$SelectEventParameters, Tree>;
 
+  /**
+   * Parameters of the Tree#selectionChange event.
+   */
   export interface Tree$SelectionChangeEventParameters {
     /**
      * The nodes which has been selected.
@@ -30379,6 +31006,9 @@ declare module "sap/ui/commons/Tree" {
     nodeContexts?: object[];
   }
 
+  /**
+   * Event object of the Tree#selectionChange event.
+   */
   export type Tree$SelectionChangeEvent = Event<
     Tree$SelectionChangeEventParameters,
     Tree
@@ -30964,7 +31594,11 @@ declare module "sap/ui/commons/TreeNode" {
       sText?: string
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the TreeNode constructor.
+   *
+   * @deprecated (since 1.38) - replaced by {@link sap.m.Tree}
+   */
   export interface $TreeNodeSettings extends $ElementSettings {
     /**
      * Node text
@@ -31022,13 +31656,22 @@ declare module "sap/ui/commons/TreeNode" {
     selected?: (oEvent: Event) => void;
   }
 
+  /**
+   * Parameters of the TreeNode#selected event.
+   */
   export interface TreeNode$SelectedEventParameters {}
 
+  /**
+   * Event object of the TreeNode#selected event.
+   */
   export type TreeNode$SelectedEvent = Event<
     TreeNode$SelectedEventParameters,
     TreeNode
   >;
 
+  /**
+   * Parameters of the TreeNode#toggleOpenState event.
+   */
   export interface TreeNode$ToggleOpenStateEventParameters {
     /**
      * Node has been opened if true
@@ -31036,6 +31679,9 @@ declare module "sap/ui/commons/TreeNode" {
     opened?: boolean;
   }
 
+  /**
+   * Event object of the TreeNode#toggleOpenState event.
+   */
   export type TreeNode$ToggleOpenStateEvent = Event<
     TreeNode$ToggleOpenStateEventParameters,
     TreeNode
@@ -31418,7 +32064,11 @@ declare module "sap/ui/commons/TriStateCheckBox" {
       destState: TriStateCheckBoxState | keyof typeof TriStateCheckBoxState
     ): void;
   }
-
+  /**
+   * Describes the settings that can be provided to the TriStateCheckBox constructor.
+   *
+   * @deprecated (since 1.38)
+   */
   export interface $TriStateCheckBoxSettings extends $ControlSettings {
     /**
      * Defines the states of the checkbox
@@ -31472,6 +32122,9 @@ declare module "sap/ui/commons/TriStateCheckBox" {
     change?: (oEvent: TriStateCheckBox$ChangeEvent) => void;
   }
 
+  /**
+   * Parameters of the TriStateCheckBox#change event.
+   */
   export interface TriStateCheckBox$ChangeEventParameters {
     /**
      * Checks whether the box is flagged or not flagged.
@@ -31479,6 +32132,9 @@ declare module "sap/ui/commons/TriStateCheckBox" {
     selectionState?: string;
   }
 
+  /**
+   * Event object of the TriStateCheckBox#change event.
+   */
   export type TriStateCheckBox$ChangeEvent = Event<
     TriStateCheckBox$ChangeEventParameters,
     TriStateCheckBox
@@ -31741,7 +32397,11 @@ declare module "sap/ui/commons/ValueHelpField" {
       sIconURL?: URI
     ): this;
   }
-
+  /**
+   * Describes the settings that can be provided to the ValueHelpField constructor.
+   *
+   * @deprecated (since 1.38) - Instead, use the `sap.m.Input` control.
+   */
   export interface $ValueHelpFieldSettings extends $TextFieldSettings {
     /**
      * URL of the standard icon for the value help. If no parameter is supplied the default icon image will
@@ -31767,8 +32427,14 @@ declare module "sap/ui/commons/ValueHelpField" {
     valueHelpRequest?: (oEvent: Event) => void;
   }
 
+  /**
+   * Parameters of the ValueHelpField#valueHelpRequest event.
+   */
   export interface ValueHelpField$ValueHelpRequestEventParameters {}
 
+  /**
+   * Event object of the ValueHelpField#valueHelpRequest event.
+   */
   export type ValueHelpField$ValueHelpRequestEvent = Event<
     ValueHelpField$ValueHelpRequestEventParameters,
     ValueHelpField