@openui5/ts-types 1.126.0 → 1.127.0

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.0
+// For Library Version: 1.127.0
 
 declare module "sap/base/assert" {
   /**
@@ -6236,6 +6236,10 @@ declare module "sap/ui/performance/trace/Interaction" {
      * The default PassportAction for startup
      */
     passportAction: string;
+    /**
+     * The root context ID
+     */
+    rootId: string;
   };
 
   /**
@@ -7097,6 +7101,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
@@ -7546,8 +7587,6 @@ declare module "sap/ui/VersionInfo" {
 }
 /**
  * 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 {
   /**
@@ -21066,14 +21105,64 @@ declare namespace sap {
            * **Note:** This static method is automatically propagated to subclasses of `ControllerExtension`.
            *
            *
-           * @returns A controller extension class
+           * @returns The adapted controller extension class
            */
-          static override(
+          static override<
+            TheExtension extends new () => ControllerExtension,
+            AddtlProps extends object,
+          >(
+            this: TheExtension,
             /**
              * The custom extension definition
              */
-            oExtension: Record<string, Function>
-          ): Function;
+            customExtension: AddtlProps
+          ): new () => InstanceType<TheExtension> & AddtlProps;
+          /**
+           * A marker method for applying controller extensions to controller class members in TypeScript code.
+           * This method is only used to make TypeScript usage compatible to the UI5 runtime behavior, where an extension
+           * *class* is assigned when the controller is defined, but each controller instance gets an *instance* of
+           * this extension. This method call is removed in the class transformer when the ES class is transformed
+           * to the traditional UI5 class definition syntax.
+           *
+           * To allow for proper removal, it may only be called directly on the base class `ControllerExtension`,
+           * at the place where a controller extension is assigned to a member property of the new controller class.
+           * The class transformation then removes this call. If it is not removed because it is used in any other
+           * way, then it throws an error at runtime.
+           *
+           * Usage example:
+           * ```javascript
+           * import Routing from "sap/fe/core/controllerextensions/Routing";
+           * import ControllerExtension from "sap/ui/core/mvc/ControllerExtension";
+           * ...
+           * export default class App extends Controller {
+           *    routing = ControllerExtension.use(Routing);
+           * ```
+           *
+           * Usage example with overriding extension callbacks:
+           * ```javascript
+           * import Routing from "sap/fe/core/controllerextensions/Routing";
+           * import ControllerExtension from "sap/ui/core/mvc/ControllerExtension";
+           * ...
+           * export default class App extends Controller {
+           *    routing = ControllerExtension.use(Routing.override({
+           *       ...
+           *    }));
+           * ```
+           *
+           *
+           *
+           * @returns An instance of the given `ControllerExtension`. **NOTE:** this is only a dummy return type for
+           * proper usage in TypeScript. This method does not actually return an instance of `ControllerExtension`,
+           * but only throws an error at runtime. The sole purpose of this method is to mimic the actual runtime behavior
+           * where a *class* is given when a controller is defined, but an *instance* is present in each controller
+           * instance.
+           */
+          static use<TheExtension extends sap.ui.core.mvc.ControllerExtension>(
+            /**
+             * The ControllerExtension to use
+             */
+            extensionClass: new () => TheExtension
+          ): TheExtension;
           /**
            * Returns an Element of the connected view with the given local ID.
            *
@@ -33345,6 +33434,12 @@ declare namespace sap {
           | sap.ui.core.dnd.DragDropBase
           | sap.ui.base.ManagedObject.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?: sap.ui.core.Element | string;
       }
 
       /**
@@ -35023,7 +35118,7 @@ declare namespace sap {
          * @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;
@@ -39512,7 +39607,7 @@ declare namespace sap {
          *
          * @returns Current accessibility state of the control.
          */
-        getAccessibilityInfo(): sap.ui.core.AccessibilityInfo;
+        getAccessibilityInfo?(): sap.ui.core.AccessibilityInfo;
         /**
          * Gets current value of property blocked.
          *
@@ -40702,7 +40797,7 @@ declare namespace sap {
          *
          * @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
            */
@@ -40849,6 +40944,36 @@ declare namespace sap {
            */
           sModelName?: string
         ): sap.ui.model.ContextBinding | undefined;
+        /**
+         * ID of the element which is the current target of the association {@link #getFieldHelpDisplay fieldHelpDisplay},
+         * or `null`.
+         */
+        getFieldHelpDisplay(): sap.ui.core.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.
          *
@@ -41059,6 +41184,19 @@ declare namespace sap {
          * @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.
@@ -41177,6 +41315,19 @@ declare namespace sap {
          * @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: sap.ui.core.ID | sap.ui.core.Element
+        ): this;
         /**
          * Sets the {@link sap.ui.core.LayoutData} defining the layout constraints for this control when it is used
          * inside a layout.
@@ -50444,6 +50595,27 @@ declare namespace sap {
          */
         Polite = "Polite",
       }
+      /**
+       * 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
+       */
+      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",
+      }
       /**
        * Specifies possible message types.
        *
@@ -63159,7 +63331,7 @@ declare namespace sap {
              * 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:
@@ -63217,14 +63389,22 @@ declare namespace sap {
              */
             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.
              *
@@ -64169,7 +64349,7 @@ declare namespace sap {
                * 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
@@ -65107,7 +65287,7 @@ declare namespace sap {
                * 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
@@ -65977,6 +66157,11 @@ declare namespace sap {
              * 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
@@ -66413,7 +66598,8 @@ declare namespace sap {
                 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;
                 /**
@@ -66777,9 +66963,8 @@ declare namespace sap {
              * 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
@@ -67513,7 +67698,7 @@ declare namespace sap {
                * 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
@@ -85672,6 +85857,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;
@@ -86050,6 +86237,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.0
+// 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.0
+// For Library Version: 1.127.0
 
 declare namespace sap {
   namespace ui {
@@ -1328,6 +1328,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.0
+// For Library Version: 1.127.0
 
 declare namespace sap {
   namespace ui {
@@ -890,6 +890,18 @@ declare namespace sap {
             | sap.ui.base.ManagedObject.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
+            | sap.ui.base.ManagedObject.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.
@@ -1731,6 +1743,20 @@ declare namespace sap {
              */
             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.
            *
@@ -2109,6 +2135,27 @@ declare namespace sap {
              */
             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.

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.0
+// For Library Version: 1.127.0
 
 declare namespace sap {
   namespace ui {
@@ -3031,7 +3031,7 @@ declare namespace sap {
            *
            * **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?:
@@ -3043,7 +3043,7 @@ declare namespace sap {
            * 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
@@ -3059,6 +3059,10 @@ declare namespace sap {
           /**
            * 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<sap.ui.core.Control | string>;
@@ -3138,6 +3142,10 @@ declare namespace sap {
            * **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<sap.ui.core.Control | string>;
@@ -3889,6 +3897,13 @@ declare namespace sap {
           /**
            * 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?:
@@ -3900,7 +3915,7 @@ declare namespace sap {
            * 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
            */
@@ -3909,6 +3924,10 @@ declare namespace sap {
           /**
            * 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<sap.ui.core.Control | string>;
@@ -4682,7 +4701,7 @@ declare namespace sap {
            *
            * **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(): sap.ui.core.Title | string;
@@ -4692,7 +4711,7 @@ declare namespace sap {
            * 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
@@ -7480,6 +7499,13 @@ declare namespace sap {
            *
            * 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(): sap.ui.core.Title | string;
@@ -7489,7 +7515,7 @@ declare namespace sap {
            * 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
            */
@@ -14651,6 +14677,9 @@ declare namespace sap {
       /**
        * 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
        */
       class VerticalLayout extends sap.ui.core.Control {