@openui5/ts-types-esm 1.100.0 → 1.102.1

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.100.0
+// For Library Version: 1.102.1
 
 declare module "sap/ui/integration/library" {
   import { URI } from "sap/ui/core/library";
@@ -29,7 +29,7 @@ declare module "sap/ui/integration/library" {
     /**
      * @EXPERIMENTAL (since 1.76)
      *
-     * Used for custom actions
+     * Used for custom actions.
      */
     Custom = "Custom",
     /**
@@ -51,7 +51,7 @@ declare module "sap/ui/integration/library" {
      */
     MonthChange = "MonthChange",
     /**
-     * Used for navigation actions
+     * Used for navigation actions.
      */
     Navigation = "Navigation",
     /**
@@ -61,7 +61,7 @@ declare module "sap/ui/integration/library" {
      */
     ShowCard = "ShowCard",
     /**
-     * Used for submit actions
+     * Used for submit actions.
      */
     Submit = "Submit",
   }
@@ -208,6 +208,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * it with the information contained in `oClassInfo`.
      *
      * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.core.Element.extend}.
+     *
+     * @returns Created class / constructor function
      */
     static extend<T extends Record<string, unknown>>(
       /**
@@ -226,6 +228,8 @@ declare module "sap/ui/integration/ActionDefinition" {
     ): Function;
     /**
      * Returns a metadata object for class sap.ui.integration.ActionDefinition.
+     *
+     * @returns Metadata object describing this class
      */
     static getMetadata(): ElementMetadata;
     /**
@@ -235,6 +239,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * otherwise it will be bound to this `sap.ui.integration.ActionDefinition` itself.
      *
      * Fired when the action button is pressed.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachPress(
       /**
@@ -259,6 +265,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * otherwise it will be bound to this `sap.ui.integration.ActionDefinition` itself.
      *
      * Fired when the action button is pressed.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachPress(
       /**
@@ -275,6 +283,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * Detaches event handler `fnFunction` from the {@link #event:press press} event of this `sap.ui.integration.ActionDefinition`.
      *
      * The passed function and listener object must match the ones used for event registration.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     detachPress(
       /**
@@ -288,6 +298,8 @@ declare module "sap/ui/integration/ActionDefinition" {
     ): this;
     /**
      * Fires event {@link #event:press press} to attached listeners.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     firePress(
       /**
@@ -301,6 +313,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * The type of the action button.
      *
      * Default value is `Transparent`.
+     *
+     * @returns Value of property `buttonType`
      */
     getButtonType(): ButtonType | keyof typeof ButtonType;
     /**
@@ -310,18 +324,24 @@ declare module "sap/ui/integration/ActionDefinition" {
      * be focused and they are out of the navigation tab-chain.
      *
      * Default value is `true`.
+     *
+     * @returns Value of property `enabled`
      */
     getEnabled(): boolean;
     /**
      * Gets current value of property {@link #getIcon icon}.
      *
      * The icon of the action button.
+     *
+     * @returns Value of property `icon`
      */
     getIcon(): URI;
     /**
      * Gets current value of property {@link #getParameters parameters}.
      *
      * The parameters of the action.
+     *
+     * @returns Value of property `parameters`
      */
     getParameters(): object;
     /**
@@ -330,12 +350,16 @@ declare module "sap/ui/integration/ActionDefinition" {
      * The text of the action button.
      *
      * Default value is `empty string`.
+     *
+     * @returns Value of property `text`
      */
     getText(): string;
     /**
      * Gets current value of property {@link #getType type}.
      *
      * The type of the action.
+     *
+     * @returns Value of property `type`
      */
     getType(): CardActionType | keyof typeof CardActionType;
     /**
@@ -344,6 +368,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * Whether the action button should be visible on the screen.
      *
      * Default value is `true`.
+     *
+     * @returns Value of property `visible`
      */
     getVisible(): boolean;
     /**
@@ -354,6 +380,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
      *
      * Default value is `Transparent`.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setButtonType(
       /**
@@ -370,6 +398,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * 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
      */
     setEnabled(
       /**
@@ -383,6 +413,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * The icon of the action button.
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setIcon(
       /**
@@ -396,6 +428,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * The parameters of the action.
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setParameters(
       /**
@@ -411,6 +445,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
      *
      * Default value is `empty string`.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setText(
       /**
@@ -424,6 +460,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * The type of the action.
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setType(
       /**
@@ -439,6 +477,8 @@ declare module "sap/ui/integration/ActionDefinition" {
      * 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
      */
     setVisible(
       /**
@@ -452,7 +492,10 @@ declare module "sap/ui/integration/ActionDefinition" {
     /**
      * The type of the action.
      */
-    type?: (CardActionType | keyof typeof CardActionType) | PropertyBindingInfo;
+    type?:
+      | (CardActionType | keyof typeof CardActionType)
+      | PropertyBindingInfo
+      | `{${string}}`;
 
     /**
      * The text of the action button.
@@ -462,28 +505,31 @@ declare module "sap/ui/integration/ActionDefinition" {
     /**
      * The icon of the action button.
      */
-    icon?: URI | PropertyBindingInfo;
+    icon?: URI | PropertyBindingInfo | `{${string}}`;
 
     /**
      * The type of the action button.
      */
-    buttonType?: (ButtonType | keyof typeof ButtonType) | PropertyBindingInfo;
+    buttonType?:
+      | (ButtonType | keyof typeof ButtonType)
+      | PropertyBindingInfo
+      | `{${string}}`;
 
     /**
      * Indicates whether the user can interact with the action button or not. **Note**: Disabled controls cannot
      * be focused and they are out of the navigation tab-chain.
      */
-    enabled?: boolean | PropertyBindingInfo;
+    enabled?: boolean | PropertyBindingInfo | `{${string}}`;
 
     /**
      * Whether the action button should be visible on the screen.
      */
-    visible?: boolean | PropertyBindingInfo;
+    visible?: boolean | PropertyBindingInfo | `{${string}}`;
 
     /**
      * The parameters of the action.
      */
-    parameters?: object | PropertyBindingInfo;
+    parameters?: object | PropertyBindingInfo | `{${string}}`;
 
     /**
      * Fired when the action button is pressed.
@@ -552,6 +598,8 @@ declare module "sap/ui/integration/Designtime" {
      * with the information contained in `oClassInfo`.
      *
      * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.base.ManagedObject.extend}.
+     *
+     * @returns Created class / constructor function
      */
     static extend<T extends Record<string, unknown>>(
       /**
@@ -570,10 +618,14 @@ declare module "sap/ui/integration/Designtime" {
     ): Function;
     /**
      * Returns a metadata object for class sap.ui.integration.Designtime.
+     *
+     * @returns Metadata object describing this class
      */
     static getMetadata(): ManagedObjectMetadata;
     /**
      * Returns an interface to the card, which uses this extension.
+     *
+     * @returns An interface to the card.
      */
     getCard(): CardFacade;
   }
@@ -591,6 +643,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/IsBoolean" {
   interface IsBoolean {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -613,6 +667,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/IsDate" {
   interface IsDate {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -635,6 +691,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/IsInteger" {
   interface IsInteger {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -657,6 +715,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/IsNumber" {
   interface IsNumber {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -679,6 +739,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/IsSelectedKey
   interface IsSelectedKey {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -710,6 +772,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/IsStringList"
   interface IsStringList {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -732,6 +796,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/IsUniqueKey"
   interface IsUniqueKey {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -767,6 +833,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/IsUniqueList"
   interface IsUniqueList {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -789,6 +857,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/IsValidBindin
   interface IsValidBinding {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -820,6 +890,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/MaxLength" {
   interface MaxLength {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -842,6 +914,8 @@ declare module "sap/ui/integration/designtime/baseEditor/validator/NotABinding"
   interface NotABinding {
     /**
      * Validator function
+     *
+     * @returns Validation result
      */
     validate(
       /**
@@ -867,6 +941,8 @@ declare module "sap/ui/integration/editor/Editor" {
      * @EXPERIMENTAL (since 1.94)
      *
      * Performs an HTTP request using the given configuration.
+     *
+     * @returns Resolves when the request is successful, rejects otherwise.
      */
     request(
       /**
@@ -963,6 +1039,8 @@ declare module "sap/ui/integration/editor/Extension" {
      * it with the information contained in `oClassInfo`.
      *
      * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.base.ManagedObject.extend}.
+     *
+     * @returns Created class / constructor function
      */
     static extend<T extends Record<string, unknown>>(
       /**
@@ -981,10 +1059,14 @@ declare module "sap/ui/integration/editor/Extension" {
     ): Function;
     /**
      * Returns a metadata object for class sap.ui.integration.editor.Extension.
+     *
+     * @returns Metadata object describing this class
      */
     static getMetadata(): ManagedObjectMetadata;
     /**
      * Returns an interface to the editor, which uses this extension.
+     *
+     * @returns An interface to the card.
      */
     getEditor(): CardFacade;
     /**
@@ -993,6 +1075,8 @@ declare module "sap/ui/integration/editor/Extension" {
      * Gets current value of property {@link #getFormatters formatters}.
      *
      * The formatters, which can be used in the manifest.
+     *
+     * @returns Value of property `formatters`
      */
     getFormatters(): object;
     /**
@@ -1007,7 +1091,7 @@ declare module "sap/ui/integration/editor/Extension" {
      *
      * The formatters, which can be used in the manifest.
      */
-    formatters?: object | PropertyBindingInfo;
+    formatters?: object | PropertyBindingInfo | `{${string}}`;
   }
 }
 
@@ -1071,6 +1155,8 @@ declare module "sap/ui/integration/Extension" {
      * the information contained in `oClassInfo`.
      *
      * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.base.ManagedObject.extend}.
+     *
+     * @returns Created class / constructor function
      */
     static extend<T extends Record<string, unknown>>(
       /**
@@ -1089,6 +1175,8 @@ declare module "sap/ui/integration/Extension" {
     ): Function;
     /**
      * Returns a metadata object for class sap.ui.integration.Extension.
+     *
+     * @returns Metadata object describing this class
      */
     static getMetadata(): ManagedObjectMetadata;
     /**
@@ -1100,6 +1188,8 @@ declare module "sap/ui/integration/Extension" {
      * otherwise it will be bound to this `sap.ui.integration.Extension` itself.
      *
      * Fired when an action is triggered in the card.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachAction(
       /**
@@ -1125,6 +1215,8 @@ declare module "sap/ui/integration/Extension" {
      * otherwise it will be bound to this `sap.ui.integration.Extension` itself.
      *
      * Fired when an action is triggered in the card.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachAction(
       /**
@@ -1142,6 +1234,8 @@ declare module "sap/ui/integration/Extension" {
      * Detaches event handler `fnFunction` from the {@link #event:action action} event of this `sap.ui.integration.Extension`.
      *
      * The passed function and listener object must match the ones used for event registration.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     detachAction(
       /**
@@ -1160,6 +1254,8 @@ declare module "sap/ui/integration/Extension" {
      *
      * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
      * event object. The return value of this method indicates whether the default action should be executed.
+     *
+     * @returns Whether or not to prevent the default action
      */
     fireAction(
       /**
@@ -1195,10 +1291,14 @@ declare module "sap/ui/integration/Extension" {
      * Gets current value of property {@link #getActions actions}.
      *
      * The actions configuration.
+     *
+     * @returns Value of property `actions`
      */
     getActions(): CardMenuAction[];
     /**
      * Returns an interface to the card, which uses this extension.
+     *
+     * @returns An interface to the card.
      */
     getCard(): CardFacade;
     /**
@@ -1207,6 +1307,8 @@ declare module "sap/ui/integration/Extension" {
      * Gets current value of property {@link #getFormatters formatters}.
      *
      * The formatters, which can be used in the manifest.
+     *
+     * @returns Value of property `formatters`
      */
     getFormatters(): object;
     /**
@@ -1222,14 +1324,14 @@ declare module "sap/ui/integration/Extension" {
      *
      * The actions configuration.
      */
-    actions?: CardMenuAction[] | PropertyBindingInfo;
+    actions?: CardMenuAction[] | PropertyBindingInfo | `{${string}}`;
 
     /**
      * @EXPERIMENTAL (since 1.79)
      *
      * The formatters, which can be used in the manifest.
      */
-    formatters?: object | PropertyBindingInfo;
+    formatters?: object | PropertyBindingInfo | `{${string}}`;
 
     /**
      * @EXPERIMENTAL (since 1.75)
@@ -1298,6 +1400,8 @@ declare module "sap/ui/integration/Host" {
      * information contained in `oClassInfo`.
      *
      * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.core.Element.extend}.
+     *
+     * @returns Created class / constructor function
      */
     static extend<T extends Record<string, unknown>>(
       /**
@@ -1316,6 +1420,8 @@ declare module "sap/ui/integration/Host" {
     ): Function;
     /**
      * Returns a metadata object for class sap.ui.integration.Host.
+     *
+     * @returns Metadata object describing this class
      */
     static getMetadata(): ElementMetadata;
     /**
@@ -1327,6 +1433,8 @@ declare module "sap/ui/integration/Host" {
      * otherwise it will be bound to this `sap.ui.integration.Host` itself.
      *
      * Fired when an action is triggered.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachAction(
       /**
@@ -1352,6 +1460,8 @@ declare module "sap/ui/integration/Host" {
      * otherwise it will be bound to this `sap.ui.integration.Host` itself.
      *
      * Fired when an action is triggered.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachAction(
       /**
@@ -1374,6 +1484,8 @@ declare module "sap/ui/integration/Host" {
      *
      * Fired when some card configuration settings are changed as a result of user interaction. For example
      * - filter value is changed.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachCardConfigurationChange(
       /**
@@ -1401,6 +1513,8 @@ declare module "sap/ui/integration/Host" {
      *
      * Fired when some card configuration settings are changed as a result of user interaction. For example
      * - filter value is changed.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachCardConfigurationChange(
       /**
@@ -1421,6 +1535,8 @@ declare module "sap/ui/integration/Host" {
      * otherwise it will be bound to this `sap.ui.integration.Host` itself.
      *
      * Fired when a message from channels like navigator.serviceWorker is received.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachMessage(
       /**
@@ -1446,6 +1562,8 @@ declare module "sap/ui/integration/Host" {
      * otherwise it will be bound to this `sap.ui.integration.Host` itself.
      *
      * Fired when a message from channels like navigator.serviceWorker is received.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachMessage(
       /**
@@ -1489,6 +1607,8 @@ declare module "sap/ui/integration/Host" {
      * Detaches event handler `fnFunction` from the {@link #event:action action} event of this `sap.ui.integration.Host`.
      *
      * The passed function and listener object must match the ones used for event registration.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     detachAction(
       /**
@@ -1507,6 +1627,8 @@ declare module "sap/ui/integration/Host" {
      * event of this `sap.ui.integration.Host`.
      *
      * The passed function and listener object must match the ones used for event registration.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     detachCardConfigurationChange(
       /**
@@ -1524,6 +1646,8 @@ declare module "sap/ui/integration/Host" {
      * Detaches event handler `fnFunction` from the {@link #event:message message} event of this `sap.ui.integration.Host`.
      *
      * The passed function and listener object must match the ones used for event registration.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     detachMessage(
       /**
@@ -1542,6 +1666,8 @@ declare module "sap/ui/integration/Host" {
      *
      * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
      * event object. The return value of this method indicates whether the default action should be executed.
+     *
+     * @returns Whether or not to prevent the default action
      */
     fireAction(
       /**
@@ -1574,6 +1700,8 @@ declare module "sap/ui/integration/Host" {
      * @EXPERIMENTAL (since 1.96)
      *
      * Fires event {@link #event:cardConfigurationChange cardConfigurationChange} to attached listeners.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     fireCardConfigurationChange(
       /**
@@ -1603,6 +1731,8 @@ declare module "sap/ui/integration/Host" {
      * @EXPERIMENTAL (since 1.91)
      *
      * Fires event {@link #event:message message} to attached listeners.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     fireMessage(
       /**
@@ -1618,6 +1748,8 @@ declare module "sap/ui/integration/Host" {
      * Gets current value of property {@link #getActions actions}.
      *
      * The actions configuration.
+     *
+     * @returns Value of property `actions`
      */
     getActions(): CardMenuAction[];
     /**
@@ -1633,6 +1765,8 @@ declare module "sap/ui/integration/Host" {
      *
      * The context information and texts should be translated as they appear in the design-time UI of the Card
      * Editor.
+     *
+     * @returns A promise which contains the context structure.
      */
     getContexts(): Promise<any>;
     /**
@@ -1647,6 +1781,8 @@ declare module "sap/ui/integration/Host" {
      *
      * Example path to the current user id of the context sPath = "sap.workzone/currentUser/id" parameter: {
      * userId: { value: "{context>sap.workzone/currentUser/id}" resolves to UserId } }
+     *
+     * @returns A promise which resolves with the value of this context.
      */
     getContextValue(
       /**
@@ -1658,6 +1794,8 @@ declare module "sap/ui/integration/Host" {
      * @EXPERIMENTAL (since 1.97)
      *
      * Resolves the CSRF token and returns a Promise with its value.
+     *
+     * @returns A promise which resolves the CSRF token to its value.
      */
     getCsrfToken(
       /**
@@ -1667,6 +1805,8 @@ declare module "sap/ui/integration/Host" {
     ): Promise<any>;
     /**
      * Resolves the destination and returns its URL.
+     *
+     * @returns A promise which resolves with the URL of the destination.
      */
     getDestination(
       /**
@@ -1679,6 +1819,8 @@ declare module "sap/ui/integration/Host" {
      *
      * Returns the list of destinations for the Card Editor design-time environment List entries are objects
      * that contain at least the name. { "name": "DestinationName" }
+     *
+     * @returns A promise which resolves with the list of destinations.
      */
     getDestinations(): Promise<any>;
     /**
@@ -1693,6 +1835,8 @@ declare module "sap/ui/integration/Host" {
      *
      * The callback receives `destinationName` as parameter and returns a string with the URL. Or alternatively
      * the callback may return a `Promise` with the URL as an argument.
+     *
+     * @returns Value of property `resolveDestination`
      */
     getResolveDestination(): Function;
     /**
@@ -1703,6 +1847,8 @@ declare module "sap/ui/integration/Host" {
      * The actions configuration.
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setActions(
       /**
@@ -1724,6 +1870,8 @@ declare module "sap/ui/integration/Host" {
      * the callback may return a `Promise` with the URL as an argument.
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setResolveDestination(
       /**
@@ -1739,7 +1887,7 @@ declare module "sap/ui/integration/Host" {
      *
      * The actions configuration.
      */
-    actions?: CardMenuAction[] | PropertyBindingInfo;
+    actions?: CardMenuAction[] | PropertyBindingInfo | `{${string}}`;
 
     /**
      * A function that resolves the given destination name to a URL.
@@ -1752,7 +1900,7 @@ declare module "sap/ui/integration/Host" {
      * The callback receives `destinationName` as parameter and returns a string with the URL. Or alternatively
      * the callback may return a `Promise` with the URL as an argument.
      */
-    resolveDestination?: Function | PropertyBindingInfo;
+    resolveDestination?: Function | PropertyBindingInfo | `{${string}}`;
 
     /**
      * @EXPERIMENTAL (since 1.75)
@@ -1834,8 +1982,8 @@ declare module "sap/ui/integration/widgets/Card" {
    * 	 - The dimensions of the card inside a layout of choice, using the `width` and `height` properties
    * 	 - The behavior for the actions described in the manifest.json file, using the action event
    *
-   * **You can learn more about integration cards in the Card
-   * Explorer**
+   * **You can learn more about integration cards in the {@link demo:sap/ui/integration/demokit/cardExplorer/index.html
+   * Card Explorer}**
    *
    * When to use
    * 	 - When you want to reuse the card across apps.
@@ -1889,6 +2037,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * with the information contained in `oClassInfo`.
      *
      * `oClassInfo` might contain the same kind of information as described in {@link sap.f.CardBase.extend}.
+     *
+     * @returns Created class / constructor function
      */
     static extend<T extends Record<string, unknown>>(
       /**
@@ -1907,6 +2057,8 @@ declare module "sap/ui/integration/widgets/Card" {
     ): Function;
     /**
      * Returns a metadata object for class sap.ui.integration.widgets.Card.
+     *
+     * @returns Metadata object describing this class
      */
     static getMetadata(): ElementMetadata;
     /**
@@ -1914,6 +2066,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.85)
      *
      * Adds some actionDefinition to the aggregation {@link #getActionDefinitions actionDefinitions}.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     addActionDefinition(
       /**
@@ -1930,6 +2084,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * otherwise it will be bound to this `sap.ui.integration.widgets.Card` itself.
      *
      * Fired when an action is triggered on the card.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachAction(
       /**
@@ -1955,6 +2111,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * otherwise it will be bound to this `sap.ui.integration.widgets.Card` itself.
      *
      * Fired when an action is triggered on the card.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachAction(
       /**
@@ -1977,6 +2135,8 @@ declare module "sap/ui/integration/widgets/Card" {
      *
      * Fired when some configuration settings are changed as a result of user interaction. For example - filter
      * value is changed.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachConfigurationChange(
       /**
@@ -2004,6 +2164,8 @@ declare module "sap/ui/integration/widgets/Card" {
      *
      * Fired when some configuration settings are changed as a result of user interaction. For example - filter
      * value is changed.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachConfigurationChange(
       /**
@@ -2026,6 +2188,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * and initialized.
      *
      * Note: The card's content may not be available yet because it may depend on other resources to load.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachManifestApplied(
       /**
@@ -2053,6 +2217,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * and initialized.
      *
      * Note: The card's content may not be available yet because it may depend on other resources to load.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachManifestApplied(
       /**
@@ -2073,6 +2239,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * otherwise it will be bound to this `sap.ui.integration.widgets.Card` itself.
      *
      * Fired when the manifest is loaded.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachManifestReady(
       /**
@@ -2098,6 +2266,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * otherwise it will be bound to this `sap.ui.integration.widgets.Card` itself.
      *
      * Fired when the manifest is loaded.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     attachManifestReady(
       /**
@@ -2114,6 +2284,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.85)
      *
      * Destroys all the actionDefinitions in the aggregation {@link #getActionDefinitions actionDefinitions}.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     destroyActionDefinitions(): this;
     /**
@@ -2122,6 +2294,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * Detaches event handler `fnFunction` from the {@link #event:action action} event of this `sap.ui.integration.widgets.Card`.
      *
      * The passed function and listener object must match the ones used for event registration.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     detachAction(
       /**
@@ -2140,6 +2314,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * of this `sap.ui.integration.widgets.Card`.
      *
      * The passed function and listener object must match the ones used for event registration.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     detachConfigurationChange(
       /**
@@ -2156,6 +2332,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * this `sap.ui.integration.widgets.Card`.
      *
      * The passed function and listener object must match the ones used for event registration.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     detachManifestApplied(
       /**
@@ -2174,6 +2352,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * `sap.ui.integration.widgets.Card`.
      *
      * The passed function and listener object must match the ones used for event registration.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     detachManifestReady(
       /**
@@ -2192,6 +2372,8 @@ declare module "sap/ui/integration/widgets/Card" {
      *
      * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
      * event object. The return value of this method indicates whether the default action should be executed.
+     *
+     * @returns Whether or not to prevent the default action
      */
     fireAction(
       /**
@@ -2220,6 +2402,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.96)
      *
      * Fires event {@link #event:configurationChange configurationChange} to attached listeners.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     fireConfigurationChange(
       /**
@@ -2243,6 +2427,8 @@ declare module "sap/ui/integration/widgets/Card" {
     ): this;
     /**
      * Fires event {@link #event:manifestApplied manifestApplied} to attached listeners.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     fireManifestApplied(
       /**
@@ -2254,6 +2440,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.72)
      *
      * Fires event {@link #event:manifestReady manifestReady} to attached listeners.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     fireManifestReady(
       /**
@@ -2279,18 +2467,26 @@ declare module "sap/ui/integration/widgets/Card" {
      *
      * Defines the base URL of the Card Manifest. It should be used when manifest property is an object instead
      * of a URL.
+     *
+     * @returns Value of property `baseUrl`
      */
     getBaseUrl(): URI;
     /**
      * Implements sap.f.ICard interface.
+     *
+     * @returns The content of the card
      */
     getCardContent(): Control;
     /**
      * Implements sap.f.ICard interface.
+     *
+     * @returns The header of the card
      */
     getCardHeader(): cards.IHeader;
     /**
      * Implements sap.f.ICard interface.
+     *
+     * @returns The position of the header of the card.
      */
     getCardHeaderPosition():
       | cards.HeaderPosition
@@ -2305,6 +2501,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * - Use this method when the manifest is ready. Check `manifestReady` event.
      *
      * - Use when developing a Component card.
+     *
+     * @returns Object containing parameters in format `{parameterKey: parameterValue}`.
      */
     getCombinedParameters(): Record<string, any>;
     /**
@@ -2316,10 +2514,14 @@ declare module "sap/ui/integration/widgets/Card" {
      * Defines the state of the `Card`. When set to `Inactive`, the `Card` doesn't make requests.
      *
      * Default value is `Active`.
+     *
+     * @returns Value of property `dataMode`
      */
     getDataMode(): CardDataMode | keyof typeof CardDataMode;
     /**
      * Returns the DOM Element that should get the focus.
+     *
+     * @returns Returns the DOM Element that should get the focus
      */
     getFocusDomRef(): Element;
     /**
@@ -2330,10 +2532,14 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.77)
      *
      * Gets the instance of the `host` association.
+     *
+     * @returns The host object associated with this card.
      */
     getHostInstance(): Host;
     /**
      * Overwrites getter for card manifest.
+     *
+     * @returns Cloned of the parameters.
      */
     getManifest(): string | Object;
     /**
@@ -2357,6 +2563,9 @@ declare module "sap/ui/integration/widgets/Card" {
      *     {"content": {"header": {"title": "My new title"}}}
      * ]
      * ```
+     *
+     *
+     * @returns Value of property `manifestChanges`
      */
     getManifestChanges(): object[];
     /**
@@ -2365,6 +2574,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * Returns a value from the Manifest based on the specified path.
      *
      * **Note** Use this method when the manifest is ready. Check `manifestReady` event.
+     *
+     * @returns The value at the specified path.
      */
     getManifestEntry(
       /**
@@ -2378,6 +2589,9 @@ declare module "sap/ui/integration/widgets/Card" {
      * Gets translated text from the i18n properties files configured for this card.
      *
      * For more details see {@link module:sap/base/i18n/ResourceBundle#getText}.
+     *
+     * @returns The value belonging to the key, if found; otherwise the key itself or `undefined` depending
+     * on `bIgnoreKeyFallback`.
      */
     getTranslatedText(
       /**
@@ -2413,6 +2627,8 @@ declare module "sap/ui/integration/widgets/Card" {
      *
      * Checks for the provided `sap.ui.integration.ActionDefinition` in the aggregation {@link #getActionDefinitions
      * actionDefinitions}. and returns its index if found or -1 otherwise.
+     *
+     * @returns The index of the provided control in the aggregation if found, or -1 otherwise
      */
     indexOfActionDefinition(
       /**
@@ -2425,6 +2641,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.85)
      *
      * Inserts a actionDefinition into the aggregation {@link #getActionDefinitions actionDefinitions}.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     insertActionDefinition(
       /**
@@ -2440,6 +2658,9 @@ declare module "sap/ui/integration/widgets/Card" {
     ): this;
     /**
      * @EXPERIMENTAL (since 1.65)
+     *
+     *
+     * @returns If the card is ready or not.
      */
     isReady(): boolean;
     /**
@@ -2451,6 +2672,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * Returns a promise that resolves with an object { designtime: the designtime modules response manifest:
      * the complete manifest json } The promise is rejected if the module cannot be loaded with an object: {
      * error: "Card.designtime not found" }
+     *
+     * @returns Promise resolves after the designtime configuration is loaded.
      */
     loadDesigntime(): Promise<any>;
     /**
@@ -2470,6 +2693,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.85)
      *
      * Removes a actionDefinition from the aggregation {@link #getActionDefinitions actionDefinitions}.
+     *
+     * @returns The removed actionDefinition or `null`
      */
     removeActionDefinition(
       /**
@@ -2484,12 +2709,16 @@ declare module "sap/ui/integration/widgets/Card" {
      * Removes all the controls from the aggregation {@link #getActionDefinitions actionDefinitions}.
      *
      * Additionally, it unregisters them from the hosting UIArea.
+     *
+     * @returns An array of the removed elements (might be empty)
      */
     removeAllActionDefinitions(): ActionDefinition[];
     /**
      * @EXPERIMENTAL (since 1.79)
      *
      * Performs an HTTP request using the given configuration.
+     *
+     * @returns Resolves when the request is successful, rejects otherwise.
      */
     request(
       /**
@@ -2531,6 +2760,8 @@ declare module "sap/ui/integration/widgets/Card" {
     ): Promise<any>;
     /**
      * Resolves the destination and returns its URL.
+     *
+     * @returns A promise which resolves with the URL of the destination.
      */
     resolveDestination(
       /**
@@ -2548,6 +2779,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * of a URL.
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setBaseUrl(
       /**
@@ -2560,6 +2793,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.65)
      *
      * Sets a new value for the `dataMode` property.
+     *
+     * @returns Pointer to the control instance to allow method chaining.
      */
     setDataMode(
       /**
@@ -2569,6 +2804,8 @@ declare module "sap/ui/integration/widgets/Card" {
     ): this;
     /**
      * Sets the associated {@link #getHost host}.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setHost(
       /**
@@ -2585,6 +2822,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
      *
      * Default value is `empty string`.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setManifest(
       /**
@@ -2616,6 +2855,8 @@ declare module "sap/ui/integration/widgets/Card" {
      *
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     setManifestChanges(
       /**
@@ -2702,6 +2943,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.85)
      *
      * Adds some actionDefinition to the aggregation {@link #getActionDefinitions actionDefinitions}.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     addActionDefinition(
       /**
@@ -2717,6 +2960,8 @@ declare module "sap/ui/integration/widgets/Card" {
      *
      * Defines the base URL of the Card Manifest. It should be used when manifest property is an object instead
      * of a URL.
+     *
+     * @returns Value of property `baseUrl`
      */
     getBaseUrl(): URI;
     /**
@@ -2729,6 +2974,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * - Use this method when the manifest is ready. Check `manifestReady` event.
      *
      * - Use when developing a Component card.
+     *
+     * @returns Object containing parameters in format `{parameterKey: parameterValue}`.
      */
     getCombinedParameters(): Record<string, any>;
     /**
@@ -2737,6 +2984,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * Returns a value from the Manifest based on the specified path.
      *
      * **Note** Use this method when the manifest is ready. Check `manifestReady` event.
+     *
+     * @returns The value at the specified path.
      */
     getManifestEntry(
       /**
@@ -2751,6 +3000,8 @@ declare module "sap/ui/integration/widgets/Card" {
      *
      * Overrides the default values of the parameters, which are defined in the manifest. The value is an object
      * containing parameters in format `{parameterKey: parameterValue}`.
+     *
+     * @returns Value of property `parameters`
      */
     getParameters(): object;
     /**
@@ -2759,6 +3010,9 @@ declare module "sap/ui/integration/widgets/Card" {
      * Gets translated text from the i18n properties files configured for this card.
      *
      * For more details see {@link module:sap/base/i18n/ResourceBundle#getText}.
+     *
+     * @returns The value belonging to the key, if found; otherwise the key itself or `undefined` depending
+     * on `bIgnoreKeyFallback`.
      */
     getTranslatedText(
       /**
@@ -2794,6 +3048,8 @@ declare module "sap/ui/integration/widgets/Card" {
      *
      * Checks for the provided `sap.ui.integration.ActionDefinition` in the aggregation {@link #getActionDefinitions
      * actionDefinitions}. and returns its index if found or -1 otherwise.
+     *
+     * @returns The index of the provided control in the aggregation if found, or -1 otherwise
      */
     indexOfActionDefinition(
       /**
@@ -2806,6 +3062,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.85)
      *
      * Inserts a actionDefinition into the aggregation {@link #getActionDefinitions actionDefinitions}.
+     *
+     * @returns Reference to `this` in order to allow method chaining
      */
     insertActionDefinition(
       /**
@@ -2836,6 +3094,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.85)
      *
      * Removes a actionDefinition from the aggregation {@link #getActionDefinitions actionDefinitions}.
+     *
+     * @returns The removed actionDefinition or `null`
      */
     removeActionDefinition(
       /**
@@ -2847,6 +3107,8 @@ declare module "sap/ui/integration/widgets/Card" {
      * @EXPERIMENTAL (since 1.79)
      *
      * Performs an HTTP request using the given configuration.
+     *
+     * @returns Resolves when the request is successful, rejects otherwise.
      */
     request(
       /**
@@ -2888,6 +3150,8 @@ declare module "sap/ui/integration/widgets/Card" {
     ): Promise<any>;
     /**
      * Resolves the destination and returns its URL.
+     *
+     * @returns A promise which resolves with the URL of the destination.
      */
     resolveDestination(
       /**
@@ -2966,7 +3230,7 @@ declare module "sap/ui/integration/widgets/Card" {
     /**
      * The URL of the manifest or an object.
      */
-    manifest?: any | PropertyBindingInfo;
+    manifest?: any | PropertyBindingInfo | `{${string}}`;
 
     /**
      * @EXPERIMENTAL (since 1.65)
@@ -2974,7 +3238,7 @@ declare module "sap/ui/integration/widgets/Card" {
      * Overrides the default values of the parameters, which are defined in the manifest. The value is an object
      * containing parameters in format `{parameterKey: parameterValue}`.
      */
-    parameters?: object | PropertyBindingInfo;
+    parameters?: object | PropertyBindingInfo | `{${string}}`;
 
     /**
      * @SINCE 1.65
@@ -2982,7 +3246,10 @@ declare module "sap/ui/integration/widgets/Card" {
      *
      * Defines the state of the `Card`. When set to `Inactive`, the `Card` doesn't make requests.
      */
-    dataMode?: (CardDataMode | keyof typeof CardDataMode) | PropertyBindingInfo;
+    dataMode?:
+      | (CardDataMode | keyof typeof CardDataMode)
+      | PropertyBindingInfo
+      | `{${string}}`;
 
     /**
      * @SINCE 1.70
@@ -2991,7 +3258,7 @@ declare module "sap/ui/integration/widgets/Card" {
      * Defines the base URL of the Card Manifest. It should be used when manifest property is an object instead
      * of a URL.
      */
-    baseUrl?: URI | PropertyBindingInfo;
+    baseUrl?: URI | PropertyBindingInfo | `{${string}}`;
 
     /**
      * @SINCE 1.76
@@ -3013,7 +3280,7 @@ declare module "sap/ui/integration/widgets/Card" {
      * ]
      * ```
      */
-    manifestChanges?: object[] | PropertyBindingInfo;
+    manifestChanges?: object[] | PropertyBindingInfo | `{${string}}`;
 
     /**
      * @SINCE 1.85
@@ -3025,7 +3292,8 @@ declare module "sap/ui/integration/widgets/Card" {
     actionDefinitions?:
       | ActionDefinition[]
       | ActionDefinition
-      | AggregationBindingInfo;
+      | AggregationBindingInfo
+      | `{${string}}`;
 
     /**
      * The host.
@@ -3085,6 +3353,8 @@ declare namespace sap {
               namespace IsInIconPool {
                 /**
                  * Validator function
+                 *
+                 * @returns Validation result
                  */
                 function validate(
                   /**