@sapui5/ts-types-esm 1.138.1 → 1.140.0

package/types/sap.f.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare module "sap/tnt/library" {
   export interface IToolHeader {
@@ -6898,8 +6898,8 @@ declare module "sap/f/DynamicPageTitle" {
      * Gets content of aggregation {@link #getActions actions}.
      *
      * The `DynamicPageTitle` actions.
-     * **Note:** The `actions` aggregation accepts any UI5 control, but it`s recommended to use controls, suitable
-     * for {@link sap.m.Toolbar} and {@link sap.m.OverflowToolbar}.
+     * **Note:** The `actions` aggregation accepts any UI5 control. However, it is best to use buttons or controls
+     * that work well inside toolbars, such as those typically used with {@link sap.m.Toolbar} and {@link sap.m.OverflowToolbar}.
      *
      * **Note:** If the `snappedTitleOnMobile` aggregation is set, its content overrides this aggregation when
      * the control is viewed on a phone mobile device and the `DynamicPageHeader` is in its collapsed (snapped)
@@ -7614,8 +7614,8 @@ declare module "sap/f/DynamicPageTitle" {
 
     /**
      * The `DynamicPageTitle` actions.
-     * **Note:** The `actions` aggregation accepts any UI5 control, but it`s recommended to use controls, suitable
-     * for {@link sap.m.Toolbar} and {@link sap.m.OverflowToolbar}.
+     * **Note:** The `actions` aggregation accepts any UI5 control. However, it is best to use buttons or controls
+     * that work well inside toolbars, such as those typically used with {@link sap.m.Toolbar} and {@link sap.m.OverflowToolbar}.
      *
      * **Note:** If the `snappedTitleOnMobile` aggregation is set, its content overrides this aggregation when
      * the control is viewed on a phone mobile device and the `DynamicPageHeader` is in its collapsed (snapped)
@@ -14672,10 +14672,10 @@ declare module "sap/f/ProductSwitch" {
 declare module "sap/f/ProductSwitchItem" {
   import { default as Control, $ControlSettings } from "sap/ui/core/Control";
 
-  import ElementMetadata from "sap/ui/core/ElementMetadata";
-
   import { URI } from "sap/ui/core/library";
 
+  import ElementMetadata from "sap/ui/core/ElementMetadata";
+
   import { PropertyBindingInfo } from "sap/ui/base/ManagedObject";
 
   /**
@@ -14748,6 +14748,18 @@ declare module "sap/f/ProductSwitchItem" {
      * @returns Metadata object describing this class
      */
     static getMetadata(): ElementMetadata;
+    /**
+     * Gets current value of property {@link #getImageSrc imageSrc}.
+     *
+     * Defines the image to be displayed as graphical element within the `ProductSwitchItem`.
+     *
+     * **Note:** This property takes precedence over the `src` property.
+     *
+     * @since 1.140
+     *
+     * @returns Value of property `imageSrc`
+     */
+    getImageSrc(): URI;
     /**
      * Gets current value of property {@link #getSrc src}.
      *
@@ -14800,6 +14812,25 @@ declare module "sap/f/ProductSwitchItem" {
      * @returns Value of property `title`
      */
     getTitle(): string;
+    /**
+     * Sets a new value for property {@link #getImageSrc imageSrc}.
+     *
+     * Defines the image to be displayed as graphical element within the `ProductSwitchItem`.
+     *
+     * **Note:** This property takes precedence over the `src` property.
+     *
+     * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+     *
+     * @since 1.140
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    setImageSrc(
+      /**
+       * New value for property `imageSrc`
+       */
+      sImageSrc?: URI
+    ): this;
     /**
      * Sets a new value for property {@link #getSrc src}.
      *
@@ -14898,6 +14929,15 @@ declare module "sap/f/ProductSwitchItem" {
      */
     src?: URI | PropertyBindingInfo | `{${string}}`;
 
+    /**
+     * Defines the image to be displayed as graphical element within the `ProductSwitchItem`.
+     *
+     * **Note:** This property takes precedence over the `src` property.
+     *
+     * @since 1.140
+     */
+    imageSrc?: URI | PropertyBindingInfo | `{${string}}`;
+
     /**
      * Determines the title of the `ProductSwitchItem`.
      */
@@ -14936,16 +14976,24 @@ declare module "sap/f/routing/Router" {
   import TargetHandler from "sap/f/routing/TargetHandler";
 
   /**
-   * The `sap.f.routing.Router` class is intended to be used with `{@link sap.f.FlexibleColumnLayout}` as
-   * a root control.
+   * The `sap.f.routing.Router` extends the capabilities of the standard `{@link sap.ui.core.routing.Router}`
+   * to support flexible and responsive layouts based on `{@link sap.f.FlexibleColumnLayout}` as the root
+   * control.
+   *
+   * This router enables advanced navigation scenarios tailored to flexible column layouts, such as changing
+   * both the layout type (e.g., OneColumn, TwoColumnsMidExpanded) and the currently displayed views within
+   * individual columns.
+   *
+   * Compared to `{@link sap.ui.core.routing.Router}`, it adds support for additional target properties:
    *
-   * The difference to the `{@link sap.ui.core.routing.Router}` are the `level`, `transition`, and `transitionParameters`
-   * properties that you can specify in every Route or Target created by this router.
+   * 	 - `level`: Defines the hierarchical level of the target view for proper history and back navigation
+   *     handling
+   * 	 - `transition`: Specifies the type of transition animation between views (e.g., `slide`, `fade`)
+   * 	 - `transitionParameters`: Custom parameters for transitions
    *
-   * The difference to the `{@link sap.m.routing.Router}` is the additional `layout` property that can be
-   * specified in every Route, in which case it is applied to the root control. Also, the `sap.f.routing.Router`
-   * supports navigations that involve both change of `{@link sap.f.LayoutType}` and change of the current
-   * page within a single column of the `sap.f.FlexibleColumnLayout`.
+   * Compared to `{@link sap.m.routing.Router}`, it further introduces a `layout` property on each route,
+   * allowing you to define the desired `{@link sap.f.LayoutType}` to be applied to the `FlexibleColumnLayout`
+   * root control during navigation.
    *
    * See `{@link sap.ui.core.routing.Router}` for the constructor arguments.
    *

package/types/sap.fe.ariba.d.ts

@@ -1,3 +1,3 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare namespace sap {}

package/types/sap.fe.base.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare module "sap/fe/base/BuildingBlockBase" {
   import { default as Control, $ControlSettings } from "sap/ui/core/Control";
@@ -9,14 +9,10 @@ declare module "sap/fe/base/BuildingBlockBase" {
    * of the content without an actual DOM element.
    * The building block also defines a state object that can be used to store the state of the building block.
    * Accessibility and classes information are forwarded to the content control.
-   *
-   * @experimental
    */
   export default class BuildingBlockBase extends Control {}
   /**
    * Describes the settings that can be provided to the BuildingBlockBase constructor.
-   *
-   * @experimental
    */
   export interface $BuildingBlockBaseSettings extends $ControlSettings {}
 }

package/types/sap.fe.controls.d.ts

@@ -1,3 +1,3 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare namespace sap {}

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare module "sap/fe/core/AppComponent" {
   import {
@@ -391,13 +391,10 @@ declare module "sap/fe/core/buildingBlocks/BuildingBlock" {
    * Instead, only its child will be there and this control will forward all DOM related instruction to it.
    *
    * @since 1.121.0
-   * @experimental As of version 1.121.0.
    */
   export default class BuildingBlock extends BuildingBlockBase {}
   /**
    * Describes the settings that can be provided to the BuildingBlock constructor.
-   *
-   * @experimental As of version 1.121.0.
    */
   export interface $BuildingBlockSettings extends $BuildingBlockBaseSettings {}
 }
@@ -608,10 +605,14 @@ declare module "sap/fe/core/controllerextensions/EditFlow" {
      *
      * @since 1.90.0
      *
-     * @returns A promise which resolves once the action has been executed. If resolved, the promise returns:
-     * - If the parameter contexts is an array: an array of objects, each object containing a key "status",
+     * @returns A promise which resolves once the action has been executed. If resolved, the promise returns
+     *
+     *
+     * 	 - If the parameter contexts is an array: an array of objects, each object containing a key "status",
      *     as well as "value" referencing the action status and the context
-     * - If the parameter contexts is not an array: a single context
+     *
+     * 	 - If the parameter contexts is not an array: a single context
+     *
      * The context(s) provided in the promise is (are) either the return value context of the action or the
      * bound context if the return value is undefined.
      */
@@ -1041,7 +1042,6 @@ declare module "sap/fe/core/controllerextensions/MessageHandler" {
    * A controller extension offering message handling.
    *
    * @since 1.90.0
-   * @experimental As of version 1.90.0.
    */
   export default class MessageHandler extends ControllerExtension {
     /**
@@ -1054,7 +1054,6 @@ declare module "sap/fe/core/controllerextensions/MessageHandler" {
      * 3. provide a presser handler incase the message should show as a link.
      *
      *
-     * @experimental
      *
      * @returns A promise that must be returned by the overridden method.
      */
@@ -1074,7 +1073,6 @@ declare module "sap/fe/core/controllerextensions/MessageHandler" {
      * toast is shown instead.
      *
      * @since 1.90.0
-     * @experimental As of version 1.90.0.
      *
      * @returns A promise that is resolved once the user closes the dialog. If there are no messages
      * to be shown, the promise is resolved immediately
@@ -1103,10 +1101,14 @@ declare module "sap/fe/core/controllerextensions/Paginator" {
    */
   export default class Paginator extends ControllerExtension {
     /**
-     * This function is used to determine the type of navigation.
-     * If the context is not navigable, it must return 'ContextNavigationType.None'.
-     * If the context is navigable within the same application to a sub object page, it must return 'ContextNavigationType.Internal'.
-     * If the context is navigable to an external application, it must return 'ContextNavigationType.External'.
+     * This method is invoked whenever a context is loaded using the paginator buttons. It determines whether
+     * the context supports navigation. The method must return one of the following:
+     * ContextNavigationType.None: If the context is not navigable.
+     * ContextNavigationType.Internal: If the context supports internal navigation within the same application
+     * to a detail view, such as an object page or a subobject page.
+     * ContextNavigationType.External: If the context navigates to an external application.
+     * The paginator buttons only allow navigation to contexts with internal navigation. Contexts with None
+     * or External navigation are skipped.
      *
      * @since 1.138.0
      *
@@ -1147,6 +1149,18 @@ declare module "sap/fe/core/controllerextensions/Paginator" {
   }
 }
 
+declare module "sap/fe/core/controllerextensions/Recommendations" {
+  /**
+   * Parameters for the acceptRecommendations and onBeforeAcceptRecommendations methods.
+   */
+  export type AcceptAllParams = {};
+
+  /**
+   * Represents a single recommendation entry.
+   */
+  export type RecommendationData = {};
+}
+
 declare module "sap/fe/core/controllerextensions/Routing" {
   import BaseControllerExtension from "sap/fe/core/controllerextensions/BaseControllerExtension";
 
@@ -1630,7 +1644,6 @@ declare module "sap/fe/core/fpm/Component" {
    *
    *
    * @since 1.92.0
-   * @experimental As of version 1.92.0.
    */
   export default class Component
     extends /* was: sap.fe.core.TemplateComponent */ Object
@@ -1691,6 +1704,8 @@ declare namespace sap {
 
     "sap/fe/core/controllerextensions/Paginator": undefined;
 
+    "sap/fe/core/controllerextensions/Recommendations": undefined;
+
     "sap/fe/core/controllerextensions/Routing": undefined;
 
     "sap/fe/core/controllerextensions/Share": undefined;

package/types/sap.fe.ina.d.ts

@@ -1,3 +1,3 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare namespace sap {}

package/types/sap.fe.macros.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare module "sap/fe/macros/Chart" {
   import {
@@ -741,16 +741,10 @@ declare module "sap/fe/macros/MessageButton" {
    *
    * <macros:MessageButton visibilityChange=".handler.onMessageButtonVisibilityChange" />
    * ```
-   *
-   *
-   *
-   * @experimental
    */
   export default class MessageButton extends BuildingBlock {}
   /**
    * Describes the settings that can be provided to the MessageButton constructor.
-   *
-   * @experimental
    */
   export interface $MessageButtonSettings extends $BuildingBlockSettings {}
 
@@ -936,13 +930,10 @@ declare module "sap/fe/macros/MultiValueField" {
    *
    *
    * @since 1.118.0
-   * @experimental As of version 1.118.0.
    */
   export default class MultiValueField extends BuildingBlock {}
   /**
    * Describes the settings that can be provided to the MultiValueField constructor.
-   *
-   * @experimental As of version 1.118.0.
    */
   export interface $MultiValueFieldSettings extends $BuildingBlockSettings {
     /**
@@ -1695,12 +1686,14 @@ declare module "sap/fe/macros/controls/BuildingBlockWithTemplating" {
    * block.
    * On change of the main properties you will be able to recreate the content.
    *
+   * @deprecated As of version 1.140.
    * @experimental
    */
   export default class BuildingBlockWithTemplating extends BuildingBlock {}
   /**
    * Describes the settings that can be provided to the BuildingBlockWithTemplating constructor.
    *
+   * @deprecated As of version 1.140.
    * @experimental
    */
   export interface $BuildingBlockWithTemplatingSettings
@@ -1934,14 +1927,14 @@ declare module "sap/fe/macros/field/FieldFormatOptions" {
     /**
      * Property for defining a custom pattern for the date, time, or dateTime format.
      *
-     * If there is a dateTimePattern defined dateTimeStyle is ignored.
+     * If a dateTimePattern is defined, the dateTimeStyle is ignored.
      */
     dateTimePattern?: string | PropertyBindingInfo;
 
     /**
      * Property for defining the display style for the date, time, or dateTime format.
      *
-     * If there is a dateTimePattern defined dateTimeStyle is ignored.
+     * If there is a dateTimePattern defined, dateTimeStyle is ignored.
      */
     dateTimeStyle?: string | PropertyBindingInfo;
 
@@ -1974,6 +1967,21 @@ declare module "sap/fe/macros/field/FieldFormatOptions" {
       | PropertyBindingInfo
       | `{${string}}`;
 
+    /**
+     * When the Field is displayed as a clickable element, it defines the size of the reactive area of the clickable
+     * element:
+     * - ReactiveAreaMode.Inline - The link is displayed as part of a sentence.
+     * - ReactiveAreaMode.Overlay - The link is displayed as an overlay on top of other interactive parts of
+     *     the page.
+     * Note: It is designed to make the clickable element easier to activate and helps meet the WCAG 2.2 Target
+     * Size requirement. It is applicable only for the SAP Horizon themes. Note: The size of the reactive area
+     * is sufficiently large to help users avoid accidentally selecting (clicking or tapping) unintended UI
+     * elements. UI elements positioned over other parts of the page may need an invisible active touch area.
+     * This ensures that no elements beneath are activated accidentally when the user tries to interact with
+     * the overlay element.
+     */
+    reactiveAreaMode?: string | PropertyBindingInfo;
+
     /**
      * Defines if the date part of a date time with timezone field should be shown.
      *
@@ -3853,6 +3861,22 @@ declare module "sap/fe/macros/table/Table.block" {
      */
     personalization?: string | PropertyBindingInfo;
 
+    /**
+     * Defines the layout options of the table popins. Only applies to responsive tables.
+     * Allowed values are `Block`, `GridLarge`, and `GridSmall`.
+     *
+     * - `Block`: Sets a block layout for rendering the table popins. The elements inside the popin container
+     *     are rendered one below the other.
+     *
+     * - `GridLarge`: Sets a grid layout for rendering the table popins. The grid width for each table popin
+     *     is comparatively larger than GridSmall, so this layout allows less content to be rendered in a single
+     *     popin row.
+     *
+     * - `GridSmall`: Sets a grid layout for rendering the table popins. The grid width for each table popin
+     *     is small, so this layout allows more content to be rendered in a single popin row.
+     */
+    popinLayout?: string | PropertyBindingInfo;
+
     /**
      * An expression that allows you to control the 'read-only' state of the table.
      * If you do not set any expression, SAP Fiori elements hooks into the standard lifecycle to determine the
@@ -4480,6 +4504,22 @@ declare module "sap/fe/macros/table/Table" {
      */
     personalization?: string | PropertyBindingInfo;
 
+    /**
+     * Defines the layout options of the table popins. Only applies to responsive tables.
+     * Allowed values are `Block`, `GridLarge`, and `GridSmall`.
+     *
+     * - `Block`: Sets a block layout for rendering the table popins. The elements inside the popin container
+     *     are rendered one below the other.
+     *
+     * - `GridLarge`: Sets a grid layout for rendering the table popins. The grid width for each table popin
+     *     is comparatively larger than GridSmall, so this layout allows less content to be rendered in a single
+     *     popin row.
+     *
+     * - `GridSmall`: Sets a grid layout for rendering the table popins. The grid width for each table popin
+     *     is small, so this layout allows more content to be rendered in a single popin row.
+     */
+    popinLayout?: string | PropertyBindingInfo;
+
     /**
      * An expression that allows you to control the 'read-only' state of the table.
      * If you do not set any expression, SAP Fiori elements hooks into the standard lifecycle to determine the
@@ -5100,6 +5140,22 @@ declare module "sap/fe/macros/table/TreeTable.block" {
      */
     personalization?: string | PropertyBindingInfo;
 
+    /**
+     * Defines the layout options of the table popins. Only applies to responsive tables.
+     * Allowed values are `Block`, `GridLarge`, and `GridSmall`.
+     *
+     * - `Block`: Sets a block layout for rendering the table popins. The elements inside the popin container
+     *     are rendered one below the other.
+     *
+     * - `GridLarge`: Sets a grid layout for rendering the table popins. The grid width for each table popin
+     *     is comparatively larger than GridSmall, so this layout allows less content to be rendered in a single
+     *     popin row.
+     *
+     * - `GridSmall`: Sets a grid layout for rendering the table popins. The grid width for each table popin
+     *     is small, so this layout allows more content to be rendered in a single popin row.
+     */
+    popinLayout?: string | PropertyBindingInfo;
+
     /**
      * An expression that allows you to control the 'read-only' state of the table.
      * If you do not set any expression, SAP Fiori elements hooks into the standard lifecycle to determine the
@@ -5760,6 +5816,22 @@ declare module "sap/fe/macros/table/TreeTable" {
      */
     personalization?: string | PropertyBindingInfo;
 
+    /**
+     * Defines the layout options of the table popins. Only applies to responsive tables.
+     * Allowed values are `Block`, `GridLarge`, and `GridSmall`.
+     *
+     * - `Block`: Sets a block layout for rendering the table popins. The elements inside the popin container
+     *     are rendered one below the other.
+     *
+     * - `GridLarge`: Sets a grid layout for rendering the table popins. The grid width for each table popin
+     *     is comparatively larger than GridSmall, so this layout allows less content to be rendered in a single
+     *     popin row.
+     *
+     * - `GridSmall`: Sets a grid layout for rendering the table popins. The grid width for each table popin
+     *     is small, so this layout allows more content to be rendered in a single popin row.
+     */
+    popinLayout?: string | PropertyBindingInfo;
+
     /**
      * An expression that allows you to control the 'read-only' state of the table.
      * If you do not set any expression, SAP Fiori elements hooks into the standard lifecycle to determine the

package/types/sap.fe.navigation.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare module "sap/fe/navigation/library" {
   /**

package/types/sap.fe.placeholder.d.ts

@@ -1,3 +1,3 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare namespace sap {}

package/types/sap.fe.plugins.managecache.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare module "sap/fe/plugins/managecache/library" {}
 

package/types/sap.fe.templates.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare module "sap/fe/templates/library" {}
 

package/types/sap.fe.test.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare module "sap/fe/test/library" {}
 
@@ -976,6 +976,18 @@ declare module "sap/fe/test/api/FilterBarActions" {
        */
       bApplyAutomatically?: string
     ): object;
+    /**
+     * Select a value from a filter field drop-down list.
+     *
+     *
+     * @returns The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
+     */
+    iSelectDropDownOption(
+      /**
+       * The new value to be selected from the drop-down list
+       */
+      vValue?: string
+    ): object;
     /**
      * Selects the chosen variant.
      *

package/types/sap.fe.tools.d.ts

@@ -1,3 +1,3 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare namespace sap {}

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

@@ -1,3 +1,3 @@
-// For Library Version: 1.138.0
+// For Library Version: 1.140.0
 
 declare namespace sap {}