@openui5/types 1.126.1 → 1.127.0

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.127.0
 
 declare module "sap/ui/codeeditor/library" {}
 
@@ -268,11 +268,14 @@ declare module "sap/ui/codeeditor/CodeEditor" {
     /**
      * Gets current value of property {@link #getColorTheme colorTheme}.
      *
-     * Sets the editor color theme. Possible values are: default, hcb, hcb_bright, hcb_blue, theme-ambiance,
-     * chaos, chrome, clouds, clouds_midnight, cobalt, crimson_editor, dawn, dreamweaver, eclipse, github, gob,
-     * gruvbox, idle_fingers, iplastic, katzenmilch, kr_theme, kuroir, merbivore, merbivore_soft, mono_industrial,
-     * monokai, pastel_on_dark, solarized_dark, solarized_light, sqlserver, terminal, textmate, tomorrow, tomorrow_night,
-     * tomorrow_night_blue, tomorrow_night_bright, tomorrow_night_eighties, twilight, dracula vibrant_ink, xcode
+     * Sets the editor color theme. Possible values are:
+     * 	 - default: best fitting to the current UI5 theme
+     * 	 - any light theme from the list: chrome, clouds, crimson_editor, dawn, dreamweaver, eclipse, github,
+     *     iplastic, solarized_light, textmate, tomorrow, xcode, kuroir, katzenmilch, sqlserver
+     * 	 - any dark theme from the list: hcb, hcb_bright, hcb_blue, ambiance, chaos, clouds_midnight, dracula,
+     *     cobalt, gruvbox, gob, idle_fingers, kr_theme, merbivore, merbivore_soft, mono_industrial, monokai, nord_dark,
+     *     one_dark, pastel_on_dark, solarized_dark, terminal, tomorrow_night, tomorrow_night_blue, tomorrow_night_bright,
+     *     tomorrow_night_eighties, twilight, vibrant_ink, github_dark
      *
      * Default value is `"default"`.
      *
@@ -679,11 +682,14 @@ declare module "sap/ui/codeeditor/CodeEditor" {
     maxLines?: int | PropertyBindingInfo | `{${string}}`;
 
     /**
-     * Sets the editor color theme. Possible values are: default, hcb, hcb_bright, hcb_blue, theme-ambiance,
-     * chaos, chrome, clouds, clouds_midnight, cobalt, crimson_editor, dawn, dreamweaver, eclipse, github, gob,
-     * gruvbox, idle_fingers, iplastic, katzenmilch, kr_theme, kuroir, merbivore, merbivore_soft, mono_industrial,
-     * monokai, pastel_on_dark, solarized_dark, solarized_light, sqlserver, terminal, textmate, tomorrow, tomorrow_night,
-     * tomorrow_night_blue, tomorrow_night_bright, tomorrow_night_eighties, twilight, dracula vibrant_ink, xcode
+     * Sets the editor color theme. Possible values are:
+     * 	 - default: best fitting to the current UI5 theme
+     * 	 - any light theme from the list: chrome, clouds, crimson_editor, dawn, dreamweaver, eclipse, github,
+     *     iplastic, solarized_light, textmate, tomorrow, xcode, kuroir, katzenmilch, sqlserver
+     * 	 - any dark theme from the list: hcb, hcb_bright, hcb_blue, ambiance, chaos, clouds_midnight, dracula,
+     *     cobalt, gruvbox, gob, idle_fingers, kr_theme, merbivore, merbivore_soft, mono_industrial, monokai, nord_dark,
+     *     one_dark, pastel_on_dark, solarized_dark, terminal, tomorrow_night, tomorrow_night_blue, tomorrow_night_bright,
+     *     tomorrow_night_eighties, twilight, vibrant_ink, github_dark
      */
     colorTheme?: string | PropertyBindingInfo;
 

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.127.0
 
 declare module "sap/ui/commons/library" {
   import { ColorPickerMode as ColorPickerMode1 } from "sap/ui/unified/library";

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

@@ -279,7 +279,7 @@ declare namespace sap {
     "sap/ui/thirdparty/qunit-2": undefined;
   }
 }
-// For Library Version: 1.126.1
+// For Library Version: 1.127.0
 
 declare module "sap/base/assert" {
   /**
@@ -6272,6 +6272,10 @@ declare module "sap/ui/performance/trace/Interaction" {
      * The default PassportAction for startup
      */
     passportAction: string;
+    /**
+     * The root context ID
+     */
+    rootId: string;
   };
 
   /**
@@ -7152,6 +7156,43 @@ declare module "sap/ui/test/opaQunit" {
   ): void;
 }
 
+declare module "sap/ui/test/utils/nextUIUpdate" {
+  /**
+   * Return a Promise that resolves when the next Rendering is ready. If no rendering is sheduled it resolves
+   * immediately.
+   *
+   * **Note:** No module from `sap/ui/test` should be used for productive coding!
+   *
+   * @since 1.127
+   *
+   * @returns A promise resolving when the next UI update is finished or rejecting when the next update fails.
+   */
+  export default function nextUIUpdate(
+    /**
+     * An optional sinon clock. When using sinon faketimers the clock must be ticked to ensure async rendering.
+     * Async rendering is done with a setTimeout(0) so, when given, we tick the clock by 1.
+     */
+    clock?: {
+      tick: Function;
+    }
+  ): Promise<undefined>;
+}
+
+declare module "sap/ui/test/utils/waitForThemeApplied" {
+  /**
+   * Checks whether the theme has already been applied and if not, waits for the 'applied' event to be fired.
+   *
+   * Returns a rejected promise if the Core is not ready yet.
+   *
+   * **Note:** No module from `sap/ui/test` should be used for productive coding!
+   *
+   * @since 1.127
+   *
+   * @returns Promise that resolves when the theme has been applied
+   */
+  export default function waitForThemeApplied(): Promise<undefined>;
+}
+
 declare module "sap/ui/util/Mobile" {
   /**
    * @since 1.58
@@ -14059,6 +14100,27 @@ declare module "sap/ui/core/library" {
     __implements__sap_ui_core_IShrinkable: boolean;
   }
 
+  /**
+   * Defines the selection mode of the menu items.
+   *
+   * This enum is part of the 'sap/ui/core/library' module export and must be accessed by the property 'ItemSelectionMode'.
+   *
+   * @since 1.127.0
+   */
+  export enum ItemSelectionMode {
+    /**
+     * Multi selection mode (more than one menu item can be selected).
+     */
+    MultiSelect = "undefined",
+    /**
+     * No selection mode.
+     */
+    None = "undefined",
+    /**
+     * Single selection mode (only one menu item can be selected).
+     */
+    SingleSelect = "undefined",
+  }
   /**
    * Marker interface for controls that can be used in `content` aggregation of the `sap.m.Title` control.
    *
@@ -18795,7 +18857,7 @@ declare module "sap/ui/core/Control" {
      *
      * @returns Current accessibility state of the control.
      */
-    getAccessibilityInfo(): AccessibilityInfo;
+    getAccessibilityInfo?(): AccessibilityInfo;
     /**
      * Gets current value of property blocked.
      *
@@ -19462,7 +19524,7 @@ declare module "sap/ui/core/Core" {
      * @deprecated (since 1.118) - without replacement. In the next major version, synchronously rendering UI
      * updates is no longer supported as it can lead to unnecessary intermediate DOM updates or layout shifting
      * etc. Controls should rather use invalidation and apps should not trigger rendering at all but rather
-     * rely on the framework's automatic update mechanisms. Test code can use the test module `sap/ui/qunit/utils/nextUIUpdate`
+     * rely on the framework's automatic update mechanisms. Test code can use the test module `sap/ui/test/utils/nextUIUpdate`
      * as a convenient way to wait for the next asynchronous rendering.
      */
     applyChanges(): void;
@@ -24383,7 +24445,7 @@ declare module "sap/ui/core/Element" {
      *
      * @ui5-protected Do not call from applications (only from related classes in the framework)
      */
-    enhanceAccessibilityState(
+    enhanceAccessibilityState?(
       /**
        * The Control/Element for which ARIA properties are collected
        */
@@ -24530,6 +24592,36 @@ declare module "sap/ui/core/Element" {
        */
       sModelName?: string
     ): ContextBinding | undefined;
+    /**
+     * ID of the element which is the current target of the association {@link #getFieldHelpDisplay fieldHelpDisplay},
+     * or `null`.
+     */
+    getFieldHelpDisplay(): ID | null;
+    /**
+     * This function (if available on the concrete subclass) provides information for the field help.
+     *
+     * Applications must not call this hook method directly, it is called by the framework.
+     *
+     * Subclasses should implement this hook to provide any necessary information for displaying field help:
+     *
+     *
+     * ```javascript
+     *
+     * MyElement.prototype.getFieldHelpInfo = function() {
+     *    return {
+     *      label: "some label"
+     *    };
+     * };
+     * ```
+     *
+     *
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     *
+     * @returns Field Help Information of the element.
+     */
+    getFieldHelpInfo?(): {
+      label: string;
+    };
     /**
      * Returns the DOM Element that should get the focus or `null` if there's no such element currently.
      *
@@ -24740,6 +24832,19 @@ declare module "sap/ui/core/Element" {
      * @returns Whether the element can get the focus after calling {@link #focus}
      */
     isFocusable(): boolean;
+    /**
+     * Handles the 'focusfail' event by attempting to find and focus on a tabbable element. The 'focusfail'
+     * event is triggered when the current element, which initially holds the focus, becomes disabled or invisible.
+     * The event is received by the parent of the element that failed to retain the focus.
+     *
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     */
+    onfocusfail(
+      /**
+       * The event object containing the source element that failed to gain focus.
+       */
+      oEvent: Event
+    ): void;
     /**
      * This function either calls set[sPropertyName] or get[sPropertyName] with the specified property name
      * depending if an `oValue` is provided or not.
@@ -24858,6 +24963,19 @@ declare module "sap/ui/core/Element" {
      * @ui5-protected Do not call from applications (only from related classes in the framework)
      */
     rerender(): void;
+    /**
+     * Sets the associated {@link #getFieldHelpDisplay fieldHelpDisplay}.
+     *
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    setFieldHelpDisplay(
+      /**
+       * ID of an element which becomes the new target of this fieldHelpDisplay association; alternatively, an
+       * element instance may be given
+       */
+      oFieldHelpDisplay: ID | UI5Element
+    ): this;
     /**
      * Sets the {@link sap.ui.core.LayoutData} defining the layout constraints for this control when it is used
      * inside a layout.
@@ -25102,6 +25220,12 @@ declare module "sap/ui/core/Element" {
       | DragDropBase
       | AggregationBindingInfo
       | `{${string}}`;
+
+    /**
+     * Reference to the element to show the field help for this control; if unset, field help is show on the
+     * control itself.
+     */
+    fieldHelpDisplay?: UI5Element | string;
   }
 
   export namespace MetadataOptions {
@@ -71098,7 +71222,7 @@ declare module "sap/ui/model/odata/v4/Context" {
      * of reset or failure.
      *
      * Since 1.125.0, deleting a node in a recursive hierarchy (see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation})
-     * is supported. As a precondition, the context must not be both {@link #setKeepAlive kept-alive} and hidden
+     * is supported. As a precondition, the context must not be both {@link #setKeepAlive kept alive} and hidden
      * (for example due to a filter), and the group ID must not have {@link sap.ui.model.odata.v4.SubmitMode.API}.
      * Such a deletion is not a pending change.
      * See:
@@ -71156,14 +71280,22 @@ declare module "sap/ui/model/odata/v4/Context" {
      */
     destroy(): void;
     /**
-     * Expands the group node that this context points to.
+     * Expands the group node that this context points to. Since 1.127.0, it is possible to expand a group node
+     * by a given number of levels.
      * See:
      * 	#collapse
      * 	#isExpanded
      *
      * @since 1.77.0
      */
-    expand(): void;
+    expand(
+      /**
+       * The number of levels to expand (@experimental as of version 1.127.0), `iLevels >= Number.MAX_SAFE_INTEGER`
+       * can be used to expand all levels. If a node is expanded a second time, the expand state of the descendants
+       * is not changed.
+       */
+      iLevels?: number
+    ): void;
     /**
      * Returns the binding this context belongs to.
      *
@@ -72118,7 +72250,7 @@ declare module "sap/ui/model/odata/v4/ODataContextBinding" {
        * because they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} (since 1.97.0)
        * or {@link sap.ui.model.odata.v4.Context#delete deleted} (since 1.108.0) context of this binding. Since
        * 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts of a {@link #getRootBinding root binding }
-       * are treated as kept-alive by this flag. Since 1.99.0, the same happens for bindings using the `$$ownRequest`
+       * are treated as kept alive by this flag. Since 1.99.0, the same happens for bindings using the `$$ownRequest`
        * parameter (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
        */
       bIgnoreKeptAlive?: boolean
@@ -73159,7 +73291,7 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
        * because they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} (since 1.97.0)
        * or {@link sap.ui.model.odata.v4.Context#delete deleted} (since 1.108.0) context of this binding. Since
        * 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts of a {@link #getRootBinding root binding }
-       * are treated as kept-alive by this flag. Since 1.99.0, the same happens for bindings using the `$$ownRequest`
+       * are treated as kept alive by this flag. Since 1.99.0, the same happens for bindings using the `$$ownRequest`
        * parameter (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
        */
       bIgnoreKeptAlive?: boolean
@@ -74233,6 +74365,11 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" {
      * results in "@com.sap.vocabularies.Common.v1.Label" and a slash does not make any difference as long as
      * the annotation does not have a "$Type" property.  A technical property (that is, a numerical segment
      * or one starting with a "$") immediately before "@sapui.name" is invalid, for example "/$EntityContainer@sapui.name".
+     *  Since 1.127.0, "@sapui.name" can also be used to access the resulting name of an entity set via
+     * a navigation property binding. This allows XML Templating to use "${entitySet>@sapui.name}" no matter
+     * whether the variable "entitySet" refers to "/TEAMS" or "/TEAMS/$NavigationPropertyBinding/TEAM_2_EMPLOYEES".
+     * This way, "/TEAMS@sapui.name" results in "TEAMS" and "/TEAMS/$NavigationPropertyBinding/TEAM_2_EMPLOYEES@sapui.name"
+     * results either in a simple name like "EMPLOYEES" or maybe in a path like "some.other.EntityContainer/SomeEntitySet".
      *  The path must not continue after "@sapui.name".
      *
      * If the current object is a string value, that string value is treated as a relative path and followed
@@ -74709,7 +74846,8 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
         synchronizationMode?: string;
         /**
          * The group ID that is used for update requests. If no update group ID is specified, `mParameters.groupId`
-         * is used. Valid update group IDs are `undefined`, '$auto', '$direct' or an application group ID.
+         * is used. Valid update group IDs are `undefined`, '$auto', '$auto.*', '$direct' or an application group
+         * ID.
          */
         updateGroupId?: string;
         /**
@@ -75073,9 +75211,8 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
      * If the target type specified in the corresponding control property's binding info is "any" and the binding
      * is relative or points to metadata, the binding may have an object value; in this case and unless the
      * binding refers to an action advertisement the binding's mode must be {@link sap.ui.model.BindingMode.OneTime}.
-     * {@link sap.ui.model.BindingMode.OneWay OneWay} is also supported (@experimental as of version 1.126.0),
-     * but client-side updates of the object are not supported and `$$patchWithoutSideEffects` should be used
-     * for the parent entity.
+     * {@link sap.ui.model.BindingMode.OneWay OneWay} is also supported (@experimental as of version 1.126.0)
+     * for complex types and collections thereof; for entity types, use {@link #bindContext} instead.
      * See:
      * 	sap.ui.base.ManagedObject#bindProperty
      * 	sap.ui.model.Model#bindProperty
@@ -75970,7 +76107,7 @@ declare module "sap/ui/model/odata/v4/ODataPropertyBinding" {
        * because they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} (since 1.97.0)
        * or {@link sap.ui.model.odata.v4.Context#delete deleted} (since 1.108.0) context of this binding. Since
        * 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts of a {@link #getRootBinding root binding }
-       * are treated as kept-alive by this flag. Since 1.99.0, the same happens for bindings using the `$$ownRequest`
+       * are treated as kept alive by this flag. Since 1.99.0, the same happens for bindings using the `$$ownRequest`
        * parameter (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
        */
       bIgnoreKeptAlive?: boolean
@@ -84524,8 +84661,6 @@ declare module "sap/ui/test/RecordReplay" {
 }
 /**
  * Root namespace for JavaScript functionality provided by SAP SE.
- *
- * The `sap` namespace is automatically registered with the OpenAjax hub if it exists.
  */
 declare namespace sap {
   /**
@@ -87801,6 +87936,8 @@ declare namespace sap {
 
     "sap/ui/dom/includeStylesheet": undefined;
 
+    "sap/ui/dom/isElementCovered": undefined;
+
     "sap/ui/dom/isHidden": undefined;
 
     "sap/ui/dom/jquery/Aria": undefined;
@@ -88179,6 +88316,10 @@ declare namespace sap {
 
     "sap/ui/test/RecordReplay": undefined;
 
+    "sap/ui/test/utils/nextUIUpdate": undefined;
+
+    "sap/ui/test/utils/waitForThemeApplied": undefined;
+
     "sap/ui/thirdparty/jquery": undefined;
 
     "sap/ui/util/ActivityDetection": undefined;

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.127.0
 
 declare namespace sap {
   interface IUI5DefineDependencyNames {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.127.0
 
 declare module "sap/ui/fl/library" {}
 
@@ -1512,6 +1512,8 @@ declare namespace sap {
 
     "sap/ui/fl/apply/_internal/changes/descriptor/app/RemoveAllInboundsExceptOne": undefined;
 
+    "sap/ui/fl/apply/_internal/changes/descriptor/app/SetAch": undefined;
+
     "sap/ui/fl/apply/_internal/changes/descriptor/app/SetTitle": undefined;
 
     "sap/ui/fl/apply/_internal/changes/descriptor/fiori/SetAbstract": undefined;

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.127.0
 
 declare module "sap/ui/integration/library" {
   import { URI } from "sap/ui/core/library";
@@ -1503,6 +1503,20 @@ declare module "sap/ui/integration/widgets/Card" {
        */
       bIgnoreKeyFallback?: boolean
     ): string;
+    /**
+     * Gets current value of property {@link #getUseProgressiveDisclosure useProgressiveDisclosure}.
+     *
+     * If the card should change depending on its size. This property is temporary. Should be used to enable
+     * the feature for cards where it is needed.
+     *
+     * Default value is `false`.
+     *
+     * @since 1.127
+     * @experimental (since 1.127)
+     *
+     * @returns Value of property `useProgressiveDisclosure`
+     */
+    getUseProgressiveDisclosure(): boolean;
     /**
      * Hide the blocking message that is shown in the card by `showBlockingMessage` call.
      *
@@ -1878,6 +1892,27 @@ declare module "sap/ui/integration/widgets/Card" {
        */
       sReferenceId?: string
     ): this;
+    /**
+     * Sets a new value for property {@link #getUseProgressiveDisclosure useProgressiveDisclosure}.
+     *
+     * If the card should change depending on its size. This property is temporary. Should be used to enable
+     * the feature for cards where it is needed.
+     *
+     * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+     *
+     * Default value is `false`.
+     *
+     * @since 1.127
+     * @experimental (since 1.127)
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    setUseProgressiveDisclosure(
+      /**
+       * New value for property `useProgressiveDisclosure`
+       */
+      bUseProgressiveDisclosure?: boolean
+    ): this;
     /**
      * Show blocking message in the card's content area. Should be used after the `manifestApplied` event or
      * after the `cardReady` lifecycle hook in Component cards and Extensions.
@@ -2432,6 +2467,15 @@ declare module "sap/ui/integration/widgets/Card" {
       | PropertyBindingInfo
       | `{${string}}`;
 
+    /**
+     * If the card should change depending on its size. This property is temporary. Should be used to enable
+     * the feature for cards where it is needed.
+     *
+     * @since 1.127
+     * @experimental (since 1.127)
+     */
+    useProgressiveDisclosure?: boolean | PropertyBindingInfo | `{${string}}`;
+
     /**
      * Actions definitions from which actions in the header menu of the card are created. **Note**: This aggregation
      * is destroyed when the property `manifest` changes.

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.127.0
 
 declare module "sap/ui/layout/library" {
   import Control from "sap/ui/core/Control";
@@ -6718,7 +6718,7 @@ declare module "sap/ui/layout/form/Form" {
      *
      * **Note:** If the title is provided as a string, the title is rendered with a theme-dependent default
      * level. As the `Form` control cannot know the structure of the page, this might not fit the page structure.
-     * In this case provide the title using a `Title` element and set its {@link sap.ui.core.Title#setLevel level }
+     * In this case, provide the title using a `Title` element and set its {@link sap.ui.core.Title#setLevel level }
      * to the needed value.
      */
     getTitle(): Title | string;
@@ -6728,7 +6728,7 @@ declare module "sap/ui/layout/form/Form" {
      * Toolbar of the `Form`.
      *
      * **Note:** If a `Toolbar` is used, the `Title` is ignored. If a title is needed inside the `Toolbar` it
-     * must be added at content to the `Toolbar`. In this case add the `Title` to the `ariaLabelledBy` association.
+     * must be added at content to the `Toolbar`. In this case, add the `Title` to the `ariaLabelledBy` association.
      * Use the right title level to meet the visual requirements. This might be theme-dependent.
      *
      * @since 1.36.0
@@ -6944,7 +6944,7 @@ declare module "sap/ui/layout/form/Form" {
      *
      * **Note:** If the title is provided as a string, the title is rendered with a theme-dependent default
      * level. As the `Form` control cannot know the structure of the page, this might not fit the page structure.
-     * In this case provide the title using a `Title` element and set its {@link sap.ui.core.Title#setLevel level }
+     * In this case, provide the title using a `Title` element and set its {@link sap.ui.core.Title#setLevel level }
      * to the needed value.
      */
     title?: string | Title | PropertyBindingInfo;
@@ -6953,7 +6953,7 @@ declare module "sap/ui/layout/form/Form" {
      * Toolbar of the `Form`.
      *
      * **Note:** If a `Toolbar` is used, the `Title` is ignored. If a title is needed inside the `Toolbar` it
-     * must be added at content to the `Toolbar`. In this case add the `Title` to the `ariaLabelledBy` association.
+     * must be added at content to the `Toolbar`. In this case, add the `Title` to the `ariaLabelledBy` association.
      * Use the right title level to meet the visual requirements. This might be theme-dependent.
      *
      * @since 1.36.0
@@ -6969,6 +6969,10 @@ declare module "sap/ui/layout/form/Form" {
     /**
      * Association to controls / IDs that label this control (see WAI-ARIA attribute `aria-labelledby`).
      *
+     * **Note:** Every `Form` needs to have some title or label (at least for screen reader support). If no
+     * `Title` is set, and the `Form` is not a child or a control with a title, such as {@link sap.m.Panel Panel }
+     * or {@link sap.m.Dialog Dialog}, a label or title needs to be assigned using the `ariaLabelledBy` association.
+     *
      * @since 1.28.0
      */
     ariaLabelledBy?: Array<Control | string>;
@@ -7429,6 +7433,10 @@ declare module "sap/ui/layout/form/FormContainer" {
      * **Note:** This attribute is only rendered if the `FormContainer` has it's own DOM representation in the
      * used `FormLayout`.
      *
+     * **Note:** If there is more than one `FormContainers`, every `FormContainer` needs to have some title
+     * or label (at least for screen reader support). If no `Title` is set, a label or title needs to be assigned
+     * using the `ariaLabelledBy` association.
+     *
      * @since 1.36.0
      */
     ariaLabelledBy?: Array<Control | string>;
@@ -10075,6 +10083,13 @@ declare module "sap/ui/layout/form/SimpleForm" {
      *
      * Title element of the `SimpleForm`. Can either be a `Title` element, or a string.
      *
+     * **Note:** If a `Toolbar` is used, the `Title` is ignored.
+     *
+     * **Note:** If the title is provided as a string, the title is rendered with a theme-dependent default
+     * level. As the `Form` control cannot know the structure of the page, this might not fit the page structure.
+     * In this case, provide the title using a `Title` element and set its {@link sap.ui.core.Title#setLevel level }
+     * to the needed value.
+     *
      * @since 1.16.3
      */
     getTitle(): Title | string;
@@ -10084,7 +10099,7 @@ declare module "sap/ui/layout/form/SimpleForm" {
      * Toolbar of the `SimpleForm`.
      *
      * **Note:** If a `Toolbar` is used, the `Title` is ignored. If a title is needed inside the `Toolbar` it
-     * must be added at content to the `Toolbar`. In this case add the `Title` to the `ariaLabelledBy` association.
+     * must be added at content to the `Toolbar`. In this case, add the `Title` to the `ariaLabelledBy` association.
      *
      * @since 1.36.0
      */
@@ -11041,6 +11056,13 @@ declare module "sap/ui/layout/form/SimpleForm" {
     /**
      * Title element of the `SimpleForm`. Can either be a `Title` element, or a string.
      *
+     * **Note:** If a `Toolbar` is used, the `Title` is ignored.
+     *
+     * **Note:** If the title is provided as a string, the title is rendered with a theme-dependent default
+     * level. As the `Form` control cannot know the structure of the page, this might not fit the page structure.
+     * In this case, provide the title using a `Title` element and set its {@link sap.ui.core.Title#setLevel level }
+     * to the needed value.
+     *
      * @since 1.16.3
      */
     title?: string | Title | PropertyBindingInfo;
@@ -11049,7 +11071,7 @@ declare module "sap/ui/layout/form/SimpleForm" {
      * Toolbar of the `SimpleForm`.
      *
      * **Note:** If a `Toolbar` is used, the `Title` is ignored. If a title is needed inside the `Toolbar` it
-     * must be added at content to the `Toolbar`. In this case add the `Title` to the `ariaLabelledBy` association.
+     * must be added at content to the `Toolbar`. In this case, add the `Title` to the `ariaLabelledBy` association.
      *
      * @since 1.36.0
      */
@@ -11058,6 +11080,10 @@ declare module "sap/ui/layout/form/SimpleForm" {
     /**
      * Association to controls / IDs which label this control (see WAI-ARIA attribute `aria-labelledby`).
      *
+     * **Note:** Every `Form` needs to have some title or label (at least for screen reader support). If no
+     * `Title` is set, and the `Form` is not a child or a control with a title, such as {@link sap.m.Panel Panel }
+     * or {@link sap.m.Dialog Dialog}, a label or title needs to be assigned using the `ariaLabelledBy` association.
+     *
      * @since 1.32.0
      */
     ariaLabelledBy?: Array<Control | string>;
@@ -14977,6 +15003,9 @@ declare module "sap/ui/layout/VerticalLayout" {
   /**
    * In this layout the content controls are rendered one below the other.
    *
+   * **Note:** `VerticalLayout` is not a focusable element and therefore the inheritance of the `tooltip`
+   * property isn't supported.
+   *
    * @since 1.16.0
    */
   export default class VerticalLayout extends Control {