@openui5/types 1.126.1 → 1.128.0

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.128.0
 
 declare module "sap/ui/fl/library" {}
 
@@ -1506,12 +1506,20 @@ declare namespace sap {
 
     "sap/ui/fl/apply/_internal/changes/descriptor/app/AddNewInbound": undefined;
 
+    "sap/ui/fl/apply/_internal/changes/descriptor/app/AddTechnicalAttributes": undefined;
+
     "sap/ui/fl/apply/_internal/changes/descriptor/app/ChangeDataSource": undefined;
 
     "sap/ui/fl/apply/_internal/changes/descriptor/app/ChangeInbound": undefined;
 
+    "sap/ui/fl/apply/_internal/changes/descriptor/app/ChangeOutbound": undefined;
+
     "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/SetDescription": undefined;
+
     "sap/ui/fl/apply/_internal/changes/descriptor/app/SetTitle": undefined;
 
     "sap/ui/fl/apply/_internal/changes/descriptor/fiori/SetAbstract": undefined;
@@ -1552,6 +1560,8 @@ declare namespace sap {
 
     "sap/ui/fl/apply/_internal/extensionPoint/Registry": undefined;
 
+    "sap/ui/fl/apply/_internal/flexObjects/AnnotationChange": undefined;
+
     "sap/ui/fl/apply/_internal/flexObjects/AppDescriptorChange": undefined;
 
     "sap/ui/fl/apply/_internal/flexObjects/CompVariant": undefined;
@@ -1654,8 +1664,6 @@ declare namespace sap {
 
     "sap/ui/fl/registry/Settings": undefined;
 
-    "sap/ui/fl/support/_internal/getAllUIChanges": undefined;
-
     "sap/ui/fl/support/_internal/getChangeDependencies": undefined;
 
     "sap/ui/fl/support/_internal/getFlexSettings": undefined;
@@ -1712,7 +1720,7 @@ declare namespace sap {
 
     "sap/ui/fl/write/_internal/flexState/compVariants/CompVariantState": undefined;
 
-    "sap/ui/fl/write/_internal/flexState/FlexObjectState": undefined;
+    "sap/ui/fl/write/_internal/flexState/FlexObjectManager": undefined;
 
     "sap/ui/fl/write/_internal/flexState/UI2Personalization/UI2PersonalizationState": undefined;
 

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.126.1
+// For Library Version: 1.128.0
 
 declare module "sap/ui/integration/library" {
   import { URI } from "sap/ui/core/library";
@@ -104,7 +104,7 @@ declare module "sap/ui/integration/library" {
    */
   export enum CardBlockingMessageType {
     /**
-     * An error ocurred in the card.
+     * An error occurred in the card.
      */
     Error = "Error",
     /**
@@ -253,6 +253,45 @@ declare module "sap/ui/integration/library" {
     parameters: object;
   };
 
+  /**
+   * Card message strip types.
+   *
+   * This enum is part of the 'sap/ui/integration/library' module export and must be accessed by the property
+   * 'CardMessageType'.
+   *
+   * @experimental (since 1.128)
+   */
+  export enum CardMessageType {
+    /**
+     * Message is an error
+     */
+    Error = "Error",
+    /**
+     * Message should be just an information
+     */
+    Information = "Information",
+    /**
+     * Informs the user that the content is busy at that moment with a loading operation. Blocks the content
+     * from interaction.
+     */
+    Loading = "Loading",
+    /**
+     * Message has no specific level
+     */
+    None = "None",
+    /**
+     * Message is a success message
+     */
+    Success = "Success",
+    /**
+     * Message is an informative brief toast message. For this type the default behavior is to auto close.
+     */
+    Toast = "Toast",
+    /**
+     * Message is a warning
+     */
+    Warning = "Warning",
+  }
   /**
    * Preview modes for `{@link sap.ui.integration.widgets.Card}`. Helpful in scenarios when the end user is
    * choosing or configuring a card.
@@ -716,6 +755,7 @@ declare module "sap/ui/integration/widgets/Card" {
     CardDisplayVariant,
     CardPreviewMode,
     CardArea,
+    CardMessageType,
     CardActionType,
   } from "sap/ui/integration/library";
 
@@ -729,7 +769,7 @@ declare module "sap/ui/integration/widgets/Card" {
 
   import Event from "sap/ui/base/Event";
 
-  import { URI, ID, MessageType } from "sap/ui/core/library";
+  import { URI, ID } from "sap/ui/core/library";
 
   import Host from "sap/ui/integration/Host";
 
@@ -1503,6 +1543,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 +1932,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.
@@ -1916,7 +1991,12 @@ declare module "sap/ui/integration/widgets/Card" {
       /**
        * Type of the message.
        */
-      sType: MessageType
+      sType: CardMessageType | keyof typeof CardMessageType,
+      /**
+       * Close the message automatically. Default is `false` for most message types. It is `true` for message
+       * type `Toast`. **Note** This property has no effect for message type `Loading`.
+       */
+      bAutoClose: boolean
     ): void;
     /**
      * Triggers an action inside the card.
@@ -2256,7 +2336,12 @@ declare module "sap/ui/integration/widgets/Card" {
       /**
        * Type of the message.
        */
-      sType: MessageType
+      sType: CardMessageType | keyof typeof CardMessageType,
+      /**
+       * Close the message automatically. Default is `false` for most message types. It is `true` for message
+       * type `Toast`. **Note** This property has no effect for message type `Loading`.
+       */
+      bAutoClose: boolean
     ): void;
     /**
      * Triggers an action inside the card.
@@ -2432,6 +2517,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.128.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>;
@@ -8379,13 +8387,13 @@ declare module "sap/ui/layout/form/ResponsiveGridLayout" {
    * and the labels are rendered in the same row as the fields or above the fields. This behavior can be influenced
    * by the properties of this layout control.
    *
-   * On the {@link sap.ui.layout.form.FormContainer FormContainers}, labels and content fields, {@link sap.ui.layout.GridGata GridData }
-   * can be used to change the default rendering. {@link sap.ui.layout.GridGata GridData} is not supported
+   * On the {@link sap.ui.layout.form.FormContainer FormContainers}, labels and content fields, {@link sap.ui.layout.GridData GridData }
+   * can be used to change the default rendering. {@link sap.ui.layout.GridData GridData} is not supported
    * for {@link sap.ui.layout.form.FormElement FormElements}.
    *
-   * **Note:** If {@link sap.ui.layout.GridGata GridData} is used, this may result in a much more complex
+   * **Note:** If {@link sap.ui.layout.GridData GridData} is used, this may result in a much more complex
    * layout than the default one. This means that in some cases, the calculation for the other content may
-   * not bring the expected result. In such cases, {@link sap.ui.layout.GridGata GridData} should be used
+   * not bring the expected result. In such cases, {@link sap.ui.layout.GridData GridData} should be used
    * for all content controls to disable the default behavior.
    *
    * This control cannot be used stand-alone, it just renders a {@link sap.ui.layout.form.Form Form}, so it
@@ -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 {