@sapui5/ts-types-esm 1.139.0 → 1.140.0

package/types/sap.f.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.139.0
+// For Library Version: 1.140.0
 
 declare module "sap/tnt/library" {
   export interface IToolHeader {
@@ -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.139.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.139.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.139.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.139.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 {}
 }
@@ -1045,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 {
     /**
@@ -1058,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.
      */
@@ -1078,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
@@ -1155,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";
 
@@ -1638,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
@@ -1699,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.139.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.139.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

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.139.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.139.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.139.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.139.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.139.0
+// For Library Version: 1.140.0
 
 declare module "sap/fe/test/library" {}
 

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

@@ -1,3 +1,3 @@
-// For Library Version: 1.139.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.139.0
+// For Library Version: 1.140.0
 
 declare namespace sap {}

package/types/sap.gantt.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.139.0
+// For Library Version: 1.140.0
 
 declare module "sap/gantt/library" {
   import ChartScheme from "sap/gantt/config/ChartScheme";
@@ -35305,8 +35305,6 @@ declare module "sap/gantt/simple/BaseShape" {
      *
      * Postion of left anchor for a shape to connect with other shapes whose value ranges from 0-100
      *
-     * Default value is `50`.
-     *
      * @since 1.131
      *
      * @returns Value of property `leftAnchorPosition`
@@ -35342,8 +35340,6 @@ declare module "sap/gantt/simple/BaseShape" {
      *
      * Postion of right anchor for a shape to connect with other shapes whose value ranges from 0-100
      *
-     * Default value is `50`.
-     *
      * @since 1.131
      *
      * @returns Value of property `rightAnchorPosition`
@@ -36025,8 +36021,6 @@ declare module "sap/gantt/simple/BaseShape" {
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
      *
-     * Default value is `50`.
-     *
      * @since 1.131
      *
      * @returns Reference to `this` in order to allow method chaining
@@ -36035,7 +36029,7 @@ declare module "sap/gantt/simple/BaseShape" {
       /**
        * New value for property `leftAnchorPosition`
        */
-      iLeftAnchorPosition?: int
+      iLeftAnchorPosition: int
     ): this;
     /**
      * Sets a new value for property {@link #getOpacity opacity}.
@@ -36083,8 +36077,6 @@ declare module "sap/gantt/simple/BaseShape" {
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
      *
-     * Default value is `50`.
-     *
      * @since 1.131
      *
      * @returns Reference to `this` in order to allow method chaining
@@ -36093,7 +36085,7 @@ declare module "sap/gantt/simple/BaseShape" {
       /**
        * New value for property `rightAnchorPosition`
        */
-      iRightAnchorPosition?: int
+      iRightAnchorPosition: int
     ): this;
     /**
      * Sets a new value for property {@link #getRowYCenter rowYCenter}.
@@ -54237,6 +54229,8 @@ declare module "sap/gantt/simple/StockChart" {
 
   import StockChartDimension from "sap/gantt/simple/StockChartDimension";
 
+  import BaseLine from "sap/gantt/simple/BaseLine";
+
   import ElementMetadata from "sap/ui/core/ElementMetadata";
 
   import {
@@ -54326,6 +54320,14 @@ declare module "sap/gantt/simple/StockChart" {
        */
       oStockChartDimension: StockChartDimension
     ): this;
+    /**
+     * Destroys the customMiddleLine in the aggregation {@link #getCustomMiddleLine customMiddleLine}.
+     *
+     * @since 1.140
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    destroyCustomMiddleLine(): this;
     /**
      * Destroys all the stockChartDimensions in the aggregation {@link #getStockChartDimensions stockChartDimensions}.
      *
@@ -54333,6 +54335,14 @@ declare module "sap/gantt/simple/StockChart" {
      * @returns Reference to `this` in order to allow method chaining
      */
     destroyStockChartDimensions(): this;
+    /**
+     * Gets content of aggregation {@link #getCustomMiddleLine customMiddleLine}.
+     *
+     * Custom configuration for middle line to define stroke, stroke-width and stroke-dasharray.
+     *
+     * @since 1.140
+     */
+    getCustomMiddleLine(): BaseLine;
     /**
      * Gets current value of property {@link #getMaxValue maxValue}.
      *
@@ -54463,6 +54473,19 @@ declare module "sap/gantt/simple/StockChart" {
        */
       oElement: object
     ): void;
+    /**
+     * Sets the aggregated {@link #getCustomMiddleLine customMiddleLine}.
+     *
+     * @since 1.140
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    setCustomMiddleLine(
+      /**
+       * The customMiddleLine to set
+       */
+      oCustomMiddleLine: BaseLine
+    ): this;
     /**
      * Sets a new value for property {@link #getMaxValue maxValue}.
      *
@@ -54597,6 +54620,13 @@ declare module "sap/gantt/simple/StockChart" {
       | StockChartDimension
       | AggregationBindingInfo
       | `{${string}}`;
+
+    /**
+     * Custom configuration for middle line to define stroke, stroke-width and stroke-dasharray.
+     *
+     * @since 1.140
+     */
+    customMiddleLine?: BaseLine;
   }
 }
 

package/types/sap.insights.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.139.0
+// For Library Version: 1.140.0
 
 declare module "sap/insights/library" {}
 
@@ -75,11 +75,137 @@ declare module "sap/insights/CardHelper" {
       /**
        * callback event to be called when confirm button is pressed
        */
-      onConfirm: Function
+      onConfirm: Function,
+      /**
+       * callback event to be called when close button is pressed
+       */
+      onClose: Function
     ): Promise<void>;
   }
 }
 
+declare module "sap/insights/CardProvider" {
+  import BaseObject from "sap/ui/base/Object";
+
+  import { Card } from "sap/insights/CardsChannel";
+
+  import Metadata from "sap/ui/base/Metadata";
+
+  /**
+   * This class is used to provide cards to consumers like SAP Collaboration Manager. It registers itself
+   * with the cards channel and shares available cards with interested consumers. It also handles requests
+   * for specific cards from consumers. It can be used to share cards with other applications or components
+   * that are interested in them
+   *
+   * @since 1.140
+   */
+  export default class CardProvider extends BaseObject {
+    /**
+     * Constructor for the card provider.
+     */
+    constructor(
+      /**
+       * unique ID to be used for registering the provider
+       */
+      sId: string,
+      /**
+       * An array containing available cards
+       */
+      aCards: Card[]
+    );
+
+    /**
+     * Creates a new subclass of class sap.insights.CardProvider with name `sClassName` and enriches it with
+     * the information contained in `oClassInfo`.
+     *
+     * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.base.Object.extend}.
+     *
+     *
+     * @returns Created class / constructor function
+     */
+    static extend<T extends Record<string, unknown>>(
+      /**
+       * Name of the class being created
+       */
+      sClassName: string,
+      /**
+       * Object literal with information about the class
+       */
+      oClassInfo?: sap.ClassInfo<T, CardProvider>,
+      /**
+       * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
+       * used by this class
+       */
+      FNMetaImpl?: Function
+    ): Function;
+    /**
+     * Returns a metadata object for class sap.insights.CardProvider.
+     *
+     *
+     * @returns Metadata object describing this class
+     */
+    static getMetadata(): Metadata;
+    /**
+     * This method is called when a consumer requests a specific card. It checks if the consumer is registered
+     * and if the card exists in the shared cards. If both conditions are met it publishes the card to the consumer.
+     * If the consumer is not registered, it does nothing.
+     *
+     * @since 1.140
+     */
+    onCardRequested(
+      /**
+       * id of the requesting consumer
+       */
+      sConsumerId: string,
+      /**
+       * unique ID of available card
+       */
+      sCardId: string
+    ): void;
+    /**
+     * This method is called when a consumer connects to the cards channel. It checks if the card detail control
+     * is loaded, and if not, it loads it. Then it shares the available cards with the consumer and navigates
+     * to the card list page. If the card detail control is already loaded, it simply shares the available cards.
+     *
+     * @since 1.140
+     */
+    onConsumerConnected(
+      /**
+       * id of the requesting consumer
+       */
+      sConsumerId: string
+    ): void;
+    /**
+     * This method is called when a consumer disconnects from the cards channel. It removes the consumer from
+     * the list of consumers and stops sharing cards with it. If the consumer is not registered, it does nothing.
+     *
+     * @since 1.140
+     */
+    onConsumerDisconnected(
+      /**
+       * id of the requesting consumer
+       */
+      sConsumerId: string
+    ): void;
+    /**
+     * This method is called when the view is updated. It checks if the home page is currently being rendered
+     * and registers or unregisters the card provider accordingly.
+     *
+     * @since 1.140
+     */
+    onViewUpdate(
+      /**
+       * true if the home page is currently being rendered.
+       */
+      bActive: boolean,
+      /**
+       * An array containing available cards
+       */
+      aCards: Card[]
+    ): void;
+  }
+}
+
 declare module "sap/insights/CardsChannel" {
   import BaseObject from "sap/ui/base/Object";
 
@@ -660,6 +786,8 @@ declare namespace sap {
   interface IUI5DefineDependencyNames {
     "sap/insights/CardHelper": undefined;
 
+    "sap/insights/CardProvider": undefined;
+
     "sap/insights/CardsChannel": undefined;
 
     "sap/insights/channels/ContextChannel": undefined;