@sapui5/ts-types 1.130.2 → 1.131.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sapui5/ts-types",
-  "version": "1.130.2",
+  "version": "1.131.0",
   "description": "SAPUI5 TypeScript Definitions",
   "homepage": "https://ui5.sap.com",
   "author": "SAP SE (https://www.sap.com)",

package/types/index.d.ts

@@ -19,7 +19,7 @@
 /// <reference path="./sap.sac.df.d.ts"/>
 /// <reference path="./sap.ui.commons.d.ts"/>
 /// <reference path="./sap.ui.comp.d.ts"/>
-/// <reference path="./core-1.130.0-d.ts"/>
+/// <reference path="./sap.ui.core.d.ts"/>
 /// <reference path="./sap.ui.dt.d.ts"/>
 /// <reference path="./sap.ui.export.d.ts"/>
 /// <reference path="./sap.f.d.ts"/>
@@ -32,8 +32,8 @@
 /// <reference path="./sap.ui.integration.d.ts"/>
 /// <reference path="./sap.ui.layout.d.ts"/>
 /// <reference path="./sap.makit.d.ts"/>
-/// <reference path="./mdc-1.130.0-d.ts"/>
-/// <reference path="./mobile-1.130.0-d.ts"/>
+/// <reference path="./sap.ui.mdc.d.ts"/>
+/// <reference path="./sap.m.d.ts"/>
 /// <reference path="./sap.me.d.ts"/>
 /// <reference path="./sap.ndc.d.ts"/>
 /// <reference path="./sap.ovp.d.ts"/>

package/types/sap.apf.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.130.0
+// For Library Version: 1.131.0
 
 declare namespace sap {
   /**

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.130.0
+// For Library Version: 1.131.0
 
 declare namespace sap {
   namespace ca {

package/types/sap.chart.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.130.1
+// For Library Version: 1.131.0
 
 declare namespace sap {
   /**

package/types/sap.collaboration.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.130.0
+// For Library Version: 1.131.0
 
 declare namespace sap {
   /**

package/types/sap.esh.search.ui.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.130.0
+// For Library Version: 1.131.0
 
 declare namespace sap {
   namespace esh {
@@ -290,8 +290,8 @@ declare namespace sap {
 
           /**
            * A boolean which indicates whether the facet panel is initially openend or closed. This affects only the
-           * initial state of the facet panel. When not setting 'facetVisibility', the initial state of the facet
-           * panel typically is taken from the user personalization storage.
+           * initial state of the facet panel. This initial state of the facet panel can be overwritten by the user,
+           * depending on the user's personalization settings.
            *
            * @since 1.113.0
            */
@@ -446,6 +446,14 @@ declare namespace sap {
             | string
             | sap.ui.base.ManagedObject.PropertyBindingInfo;
 
+          /**
+           * Prevents too many ajax requests in a short time.
+           */
+          limitAjaxRequests?:
+            | boolean
+            | sap.ui.base.ManagedObject.PropertyBindingInfo
+            | `{${string}}`;
+
           /**
            * Event is fired when search is started.
            *
@@ -538,7 +546,7 @@ declare namespace sap {
            * Creates a new subclass of class sap.esh.search.ui.SearchCompositeControl 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.core.Control.extend}.
+           * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.layout.VerticalLayout.extend}.
            *
            *
            * @returns Created class / constructor function
@@ -1072,8 +1080,10 @@ declare namespace sap {
            * Gets current value of property {@link #getFacetVisibility facetVisibility}.
            *
            * A boolean which indicates whether the facet panel is initially openend or closed. This affects only the
-           * initial state of the facet panel. When not setting 'facetVisibility', the initial state of the facet
-           * panel typically is taken from the user personalization storage.
+           * initial state of the facet panel. This initial state of the facet panel can be overwritten by the user,
+           * depending on the user's personalization settings.
+           *
+           * Default value is `false`.
            *
            * @since 1.113.0
            *
@@ -1202,6 +1212,17 @@ declare namespace sap {
            * @returns Value of property `isSearchUrl`
            */
           getIsSearchUrl(): Function;
+          /**
+           * Gets current value of property {@link #getLimitAjaxRequests limitAjaxRequests}.
+           *
+           * Prevents too many ajax requests in a short time.
+           *
+           * Default value is `true`.
+           *
+           *
+           * @returns Value of property `limitAjaxRequests`
+           */
+          getLimitAjaxRequests(): boolean;
           /**
            * Gets current value of property {@link #getOptimizeForValueHelp optimizeForValueHelp}.
            *
@@ -1647,11 +1668,13 @@ declare namespace sap {
            * Sets a new value for property {@link #getFacetVisibility facetVisibility}.
            *
            * A boolean which indicates whether the facet panel is initially openend or closed. This affects only the
-           * initial state of the facet panel. When not setting 'facetVisibility', the initial state of the facet
-           * panel typically is taken from the user personalization storage.
+           * initial state of the facet panel. This initial state of the facet panel can be overwritten by the user,
+           * depending on the user's personalization settings.
            *
            * When called with a value of `null` or `undefined`, the default value of the property will be restored.
            *
+           * Default value is `false`.
+           *
            * @since 1.113.0
            *
            * @returns Reference to `this` in order to allow method chaining
@@ -1660,7 +1683,7 @@ declare namespace sap {
             /**
              * New value for property `facetVisibility`
              */
-            bFacetVisibility: boolean
+            bFacetVisibility?: boolean
           ): this;
           /**
            * Sets a new value for property {@link #getFilterDataSources filterDataSources}.
@@ -1852,6 +1875,24 @@ declare namespace sap {
              */
             fnIsSearchUrl: Function
           ): this;
+          /**
+           * Sets a new value for property {@link #getLimitAjaxRequests limitAjaxRequests}.
+           *
+           * Prevents too many ajax requests in a short time.
+           *
+           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+           *
+           * Default value is `true`.
+           *
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setLimitAjaxRequests(
+            /**
+             * New value for property `limitAjaxRequests`
+             */
+            bLimitAjaxRequests?: boolean
+          ): this;
           /**
            * Sets a new value for property {@link #getOptimizeForValueHelp optimizeForValueHelp}.
            *

package/types/sap.f.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.130.1
+// For Library Version: 1.131.0
 
 declare namespace sap {
   /**
@@ -129,6 +129,60 @@ declare namespace sap {
           | `{${string}}`;
       }
 
+      /**
+       * Describes the settings that can be provided to the CardBadgeCustomData constructor.
+       */
+      interface $CardBadgeCustomDataSettings
+        extends sap.ui.core.$CustomDataSettings {
+        /**
+         * Icon URI. This may be either an icon font or image path.
+         *
+         * @since 1.128
+         */
+        icon?:
+          | sap.ui.core.URI
+          | sap.ui.base.ManagedObject.PropertyBindingInfo
+          | `{${string}}`;
+
+        /**
+         * Describes the corresponding visibility mode, see also {@link sap.f.CardBadgeVisibilityMode}.
+         *
+         * @since 1.128
+         */
+        visibilityMode?:
+          | sap.f.CardBadgeVisibilityMode
+          | sap.ui.base.ManagedObject.PropertyBindingInfo
+          | `{${string}}`;
+
+        /**
+         * Defines the color of the badge. The allowed values are from the enum type `sap.ui.core.IndicationColor`.
+         * Additionally values from `sap.ui.core.ValueState` can be used, but this is not recommended by design
+         * guidelines.
+         *
+         * @since 1.128
+         */
+        state?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
+
+        /**
+         * Defines the cards badge visibility.
+         *
+         * @since 1.128
+         */
+        visible?:
+          | boolean
+          | sap.ui.base.ManagedObject.PropertyBindingInfo
+          | `{${string}}`;
+
+        /**
+         * Defines text which will is overriding default announcement.
+         *
+         * @since 1.128
+         */
+        announcementText?:
+          | string
+          | sap.ui.base.ManagedObject.PropertyBindingInfo;
+      }
+
       /**
        * Describes the settings that can be provided to the Header constructor.
        */
@@ -871,9 +925,20 @@ declare namespace sap {
        *
        * @since 1.128
        */
-      class CardBadgeCustomData
-        extends /* was: sap..ui.core.CustomData */ Object
-      {
+      class CardBadgeCustomData extends sap.ui.core.CustomData {
+        /**
+         * Constructor for a new `CardBadgeCustomData` element.
+         *
+         * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
+         * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
+         * of the syntax of the settings object.
+         */
+        constructor(
+          /**
+           * Initial settings for the new element
+           */
+          mSettings?: sap.f.cards.$CardBadgeCustomDataSettings
+        );
         /**
          * Constructor for a new `CardBadgeCustomData` element.
          *
@@ -889,14 +954,14 @@ declare namespace sap {
           /**
            * Initial settings for the new element
            */
-          mSettings?: object
+          mSettings?: sap.f.cards.$CardBadgeCustomDataSettings
         );
 
         /**
          * Creates a new subclass of class sap.f.cards.CardBadgeCustomData 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.core.CustomData.extend}.
+         * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.core.CustomData.extend}.
          *
          *
          * @returns Created class / constructor function
@@ -922,7 +987,7 @@ declare namespace sap {
          *
          * @returns Metadata object describing this class
          */
-        static getMetadata(): sap.ui.base.Metadata;
+        static getMetadata(): sap.ui.core.ElementMetadata;
         /**
          * Gets current value of property {@link #getAnnouncementText announcementText}.
          *
@@ -2867,6 +2932,24 @@ declare namespace sap {
          */
         End = "End",
       }
+      /**
+       * Different options for the semantic role in controls that implement the {@link sap.f.ICard} interface.
+       *
+       * This enum is part of the 'sap/f/library' module export and must be accessed by the property 'cards.SemanticRole'.
+       *
+       * @since 1.131
+       * @experimental
+       */
+      enum SemanticRole {
+        /**
+         * The card has interactive elements.
+         */
+        ListItem = "ListItem",
+        /**
+         * The card has no interactive elements.
+         */
+        Region = "Region",
+      }
       /**
        * Event object of the Header#press event.
        */
@@ -8319,8 +8402,6 @@ declare namespace sap {
      * Interface for controls suitable for the `additionalContent` aggregation of `{@link sap.f.ShellBar}`.
      *
      * @since 1.63
-     * @experimental (since 1.63) - that provides only limited functionality. Also, it can be removed in future
-     * versions.
      */
     interface IShellBar {
       __implements__sap_f_IShellBar: boolean;
@@ -8465,6 +8546,23 @@ declare namespace sap {
         | sap.ui.core.CSSSize
         | sap.ui.base.ManagedObject.PropertyBindingInfo
         | `{${string}}`;
+
+      /**
+       * Defines the role of the Card Header.
+       *
+       * @experimental (since 1.131)
+       */
+      semanticRole?:
+        | sap.f.cards.SemanticRole
+        | sap.ui.base.ManagedObject.PropertyBindingInfo
+        | `{${string}}`;
+
+      /**
+       * Fired when action is added on card level. Note: Can be used only if `semanticRole` is `sap.f.cards.SemanticRole.ListItem`.
+       *
+       * @experimental (since 1.131)
+       */
+      press?: (oEvent: sap.ui.base.Event) => void;
     }
 
     /**
@@ -10160,6 +10258,13 @@ declare namespace sap {
       avatarsDisplayed?: int;
     }
 
+    /**
+     * Parameters of the CardBase#press event.
+     *
+     * @experimental (since 1.131)
+     */
+    interface CardBase$PressEventParameters {}
+
     /**
      * Parameters of the DynamicPage#pinnedStateChange event.
      */
@@ -11712,6 +11817,88 @@ declare namespace sap {
        * @returns Metadata object describing this class
        */
       static getMetadata(): sap.ui.core.ElementMetadata;
+      /**
+       * Attaches event handler `fnFunction` to the {@link #event:press press} event of this `sap.f.CardBase`.
+       *
+       * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
+       * otherwise it will be bound to this `sap.f.CardBase` itself.
+       *
+       * Fired when action is added on card level. Note: Can be used only if `semanticRole` is `sap.f.cards.SemanticRole.ListItem`.
+       *
+       * @experimental (since 1.131)
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      attachPress(
+        /**
+         * An application-specific payload object that will be passed to the event handler along with the event
+         * object when firing the event
+         */
+        oData: object,
+        /**
+         * The function to be called when the event occurs
+         */
+        fnFunction: (p1: sap.ui.base.Event) => void,
+        /**
+         * Context object to call the event handler with. Defaults to this `sap.f.CardBase` itself
+         */
+        oListener?: object
+      ): this;
+      /**
+       * Attaches event handler `fnFunction` to the {@link #event:press press} event of this `sap.f.CardBase`.
+       *
+       * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
+       * otherwise it will be bound to this `sap.f.CardBase` itself.
+       *
+       * Fired when action is added on card level. Note: Can be used only if `semanticRole` is `sap.f.cards.SemanticRole.ListItem`.
+       *
+       * @experimental (since 1.131)
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      attachPress(
+        /**
+         * The function to be called when the event occurs
+         */
+        fnFunction: (p1: sap.ui.base.Event) => void,
+        /**
+         * Context object to call the event handler with. Defaults to this `sap.f.CardBase` itself
+         */
+        oListener?: object
+      ): this;
+      /**
+       * Detaches event handler `fnFunction` from the {@link #event:press press} event of this `sap.f.CardBase`.
+       *
+       * The passed function and listener object must match the ones used for event registration.
+       *
+       * @experimental (since 1.131)
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      detachPress(
+        /**
+         * The function to be called, when the event occurs
+         */
+        fnFunction: (p1: sap.ui.base.Event) => void,
+        /**
+         * Context object on which the given function had to be called
+         */
+        oListener?: object
+      ): this;
+      /**
+       * Fires event {@link #event:press press} to attached listeners.
+       *
+       * @experimental (since 1.131)
+       * @ui5-protected Do not call from applications (only from related classes in the framework)
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      firePress(
+        /**
+         * Parameters to pass along with the event
+         */
+        mParameters?: object
+      ): this;
       /**
        * Returns the DOM Element that should get the focus.
        *
@@ -11731,6 +11918,18 @@ declare namespace sap {
        * @returns Value of property `height`
        */
       getHeight(): sap.ui.core.CSSSize;
+      /**
+       * Gets current value of property {@link #getSemanticRole semanticRole}.
+       *
+       * Defines the role of the Card Header.
+       *
+       * Default value is `Region`.
+       *
+       * @experimental (since 1.131)
+       *
+       * @returns Value of property `semanticRole`
+       */
+      getSemanticRole(): sap.f.cards.SemanticRole;
       /**
        * Gets current value of property {@link #getWidth width}.
        *
@@ -11760,6 +11959,25 @@ declare namespace sap {
          */
         sHeight?: sap.ui.core.CSSSize
       ): this;
+      /**
+       * Sets a new value for property {@link #getSemanticRole semanticRole}.
+       *
+       * Defines the role of the Card Header.
+       *
+       * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+       *
+       * Default value is `Region`.
+       *
+       * @experimental (since 1.131)
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      setSemanticRole(
+        /**
+         * New value for property `semanticRole`
+         */
+        sSemanticRole?: sap.f.cards.SemanticRole
+      ): this;
       /**
        * Sets a new value for property {@link #getWidth width}.
        *
@@ -22240,7 +22458,6 @@ declare namespace sap {
      * This enum is part of the 'sap/f/library' module export and must be accessed by the property 'AvatarGroupType'.
      *
      * @since 1.73
-     * @experimental (since 1.73)
      */
     enum AvatarGroupType {
       /**
@@ -22549,6 +22766,16 @@ declare namespace sap {
       AvatarGroup
     >;
 
+    /**
+     * Event object of the CardBase#press event.
+     *
+     * @experimental (since 1.131)
+     */
+    type CardBase$PressEvent = sap.ui.base.Event<
+      CardBase$PressEventParameters,
+      CardBase
+    >;
+
     /**
      * Event object of the DynamicPage#pinnedStateChange event.
      */

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

@@ -1,7 +1,35 @@
-// For Library Version: 1.130.1
+// For Library Version: 1.131.0
 
 declare namespace sap {
+  namespace fe {
+    /**
+     * Library providing the base functionality of the runtime for SAP Fiori elements for OData V4.
+     */
+    namespace base {
+      /**
+       * Describes the settings that can be provided to the BuildingBlockBase constructor.
+       *
+       * @experimental
+       */
+      interface $BuildingBlockBaseSettings
+        extends sap.ui.core.$ControlSettings {}
+
+      /**
+       * Base class for building blocks.
+       * This contains the low level functionality of having a content aggregation and handling the rendering
+       * 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
+       */
+      class BuildingBlockBase extends sap.ui.core.Control {}
+    }
+  }
+
   interface IUI5DefineDependencyNames {
+    "sap/fe/base/BuildingBlockBase": undefined;
+
     "sap/fe/base/library": undefined;
   }
 }

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

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

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.130.1
+// For Library Version: 1.131.0
 
 declare namespace sap {
   /**
@@ -1151,12 +1151,12 @@ declare namespace sap {
 
       namespace buildingBlocks {
         /**
-         * Describes the settings that can be provided to the BuildingBlockBase constructor.
+         * Describes the settings that can be provided to the BuildingBlock constructor.
          *
          * @experimental (since 1.121.0)
          */
-        interface $BuildingBlockBaseSettings
-          extends sap.ui.core.$ControlSettings {}
+        interface $BuildingBlockSettings
+          extends sap.fe.base.$BuildingBlockBaseSettings {}
 
         /**
          * Defines a control that will not exist in the DOM.
@@ -1165,7 +1165,7 @@ declare namespace sap {
          * @since 1.121.0
          * @experimental (since 1.121.0)
          */
-        class BuildingBlockBase extends sap.ui.core.Control {}
+        class BuildingBlock extends sap.fe.base.BuildingBlockBase {}
       }
 
       namespace rootView {
@@ -1495,7 +1495,7 @@ declare namespace sap {
 
     "sap/fe/core/BaseController": undefined;
 
-    "sap/fe/core/buildingBlocks/BuildingBlockBase": undefined;
+    "sap/fe/core/buildingBlocks/BuildingBlock": undefined;
 
     "sap/fe/core/controllerextensions/BaseControllerExtension": undefined;
 

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

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