@sapui5/ts-types 1.146.0 → 1.147.0

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

@@ -279,7 +279,7 @@ declare namespace sap {
     "sap/ui/thirdparty/qunit-2": undefined;
   }
 }
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare module "sap/base/assert" {
   /**
@@ -33157,6 +33157,9 @@ declare namespace sap {
            * 'SUPPORTED_PROTOCOLS'.
            */
           enum SUPPORTED_PROTOCOLS {
+            /**
+             * Protocol v10.pcp.sap.com
+             */
             v10 = "v10.pcp.sap.com",
           }
         }
@@ -33767,7 +33770,6 @@ declare namespace sap {
       /**
        * Implementing this interface allows a control to be accessible via access keys.
        *
-       * @since 1.104
        * @experimental As of version 1.104.
        */
       interface IAccessKeySupport {
@@ -33777,21 +33779,18 @@ declare namespace sap {
          * Returns a refence to DOM element to be focused during Access key navigation. If not implemented getFocusDomRef()
          * method is used.
          *
-         * @since 1.104
          * @experimental As of version 1.104.
          */
         getAccessKeysFocusTarget?(): void;
         /**
          * If implemented called when access keys feature is enabled and highlighting is over
          *
-         * @since 1.104
          * @experimental As of version 1.104.
          */
         onAccKeysHighlightEnd?(): void;
         /**
          * If implemented called when access keys feature is enabled and highlighting is ongoing
          *
-         * @since 1.104
          * @experimental As of version 1.104.
          */
         onAccKeysHighlightStart?(): void;
@@ -48727,6 +48726,59 @@ declare namespace sap {
            */
           oTargetDomNode: /* was Element */ global_Element
         ): void;
+        /**
+         * Executes a rendering callback and flushes the result into the provided DOM node.
+         *
+         * The rendering callback receives a RenderManager instance with the semantic rendering API implementation
+         * (DOM interface methods like `openStart`, `attr`, `openEnd`, `text`, `close`, etc.).
+         *
+         * This method combines rendering and flushing in a single call, automatically handling non-HTML namespaces
+         * (e.g., SVG, MathML) by detecting the namespace of the target DOM node.
+         *
+         * **Difference from calling render() then flush() separately:** When rendering into a non-HTML namespace
+         * context (e.g., SVG or MathML elements), this method automatically detects the target node's namespace
+         * and applies it as a fallback namespace for the rendering operation. This ensures that elements created
+         * without an explicit parent element (such as when rendering into a DocumentFragment initially) inherit
+         * the correct namespace.
+         *
+         * This function must not be called within control renderers.
+         *
+         * Usage:
+         * ```javascript
+         *
+         *   const oRM = new RenderManager().getInterface();
+         *
+         *   // assume that oSvgContainer is already part of the DOM and we want to render a circle into it
+         *   oRM.renderAndFlush(function(oRM) {
+         *     oRM.openStart("circle").attr("cx", "50").attr("cy", "50").attr("r", "40");
+         *     oRM.openEnd();
+         *     oRM.close("circle");
+         *   }, oSvgContainer);
+         *
+         *   oRM.destroy();
+         * ```
+         *
+         *
+         * @since 1.147
+         *
+         * @returns Reference to `this` to allow method chaining
+         */
+        renderAndFlush(
+          /**
+           * Rendering callback that receives a RenderManager instance with the semantic rendering API implementation
+           * (DOM interface methods like `openStart`, `attr`, `openEnd`, `text`, `close`, etc.)
+           */
+          fnRender: (p1: sap.ui.core.RenderManager) => void,
+          /**
+           * Node in the DOM where the result should be flushed into
+           */
+          oTargetDomNode: /* was Element */ global_Element,
+          /**
+           * Determines whether the buffer of the target DOM node is expanded (`true`) or replaced (`false`), or the
+           * new entry is inserted at a specific position (value of type `int`)
+           */
+          vInsert?: boolean | int
+        ): this;
         /**
          * Turns the given control into its HTML representation and appends it to the rendering buffer.
          *
@@ -62737,9 +62789,9 @@ declare namespace sap {
              * has been resolved!
              *
              *
-             * @returns The meta model for this `ODataModel`
+             * @returns The meta model for this `ODataModel`, or `undefined` if the model has been destroyed
              */
-            getMetaModel(): sap.ui.model.odata.ODataMetaModel;
+            getMetaModel(): sap.ui.model.odata.ODataMetaModel | undefined;
             /**
              * Returns a JSON object that is a copy of the entity data referenced by the given `sPath` and `oContext`.
              * It does not load any data and may not return all requested data if it is not available.
@@ -65446,11 +65498,24 @@ declare namespace sap {
              * @returns `true` if this context is kept alive
              */
             isKeepAlive(): boolean;
+            /**
+             * Tells whether this context is outdated:
+             * 	`undefined`: The outdated state has not been determined yet `true`: The context is outdated `false`:
+             * The context is up to date
+             *
+             * The outdated state can also be accessed via the instance annotation "@$ui5.context.isOutdated".
+             *
+             * @experimental As of version 1.147.
+             *
+             * @returns Whether this context is outdated, or `undefined` if the outdated state has not been determined
+             * yet
+             */
+            isOutdated(): boolean | undefined;
             /**
              * Tells whether this context is currently selected, but not {@link #delete deleted} on the client. Selection
-             * was experimental as of version 1.111.0. Since 1.122.0, the selection state can also be accessed via instance
-             * annotation "@$ui5.context.isSelected" at the entity. Note that the annotation does not take the deletion
-             * state into account.
+             * was experimental as of version 1.111.0. Since 1.122.0, the selection state can also be accessed via the
+             * instance annotation "@$ui5.context.isSelected" at the entity. Note that the annotation does not take
+             * the deletion state into account.
              * See:
              * 	#setSelected
              *
@@ -65726,9 +65791,11 @@ declare namespace sap {
              * effects fail to load. Use it to set fields affected by side effects to read-only before {@link #requestSideEffects }
              * and make them editable again when the promise resolves; in the error handler, you can repeat the loading
              * of side effects.
-             *  The promise is rejected if the call wants to refresh a whole list binding (via header context or an
-             * absolute path), but the deletion of a row context (see {@link #delete}) is pending with a different group
-             * ID.
+             *  The promise is rejected if
+             * 	 the call attempts to refresh an entire list binding (via header context or an absolute path) while
+             * the deletion of a row context (see {@link #delete}) is pending with a different group ID,  this is
+             * the row context of a list binding with data aggregation which has `groupLevels` or `"grandTotal like
+             * 1.84"`, or  this context does not represent a single entity
              */
             requestSideEffects(
               /**
@@ -67142,9 +67209,11 @@ declare namespace sap {
              */
             getGroupId(): string;
             /**
-             * Returns the header context which allows binding to `$count` or `@$ui5.context.isSelected`.
+             * Returns the header context which allows binding to `$count`, `@$ui5.context.isOutdated`, or `@$ui5.context.isSelected`.
              * See:
              * 	#getCount
+             * 	sap.ui.model.odata.v4.Context#isOutdated
+             * 	sap.ui.model.odata.v4.Context#isSelected
              *
              * @since 1.45.0
              *
@@ -76559,7 +76628,7 @@ declare namespace sap {
         /**
          * HTTP status code returned by the request (if available)
          */
-        statusCode?: string;
+        statusCode?: string | number;
 
         /**
          * The status as a text, details not specified, intended only for diagnosis output
@@ -81034,6 +81103,11 @@ declare namespace sap {
                  * See `vGroup` parameter
                  */
                 group?: boolean | Function;
+                /**
+                 * An array of paths that are required for grouping. Supported since 1.147.0; consult the documentation
+                 * of the specific model implementation whether it evaluates these paths.
+                 */
+                groupPaths?: string[];
                 /**
                  * The binding path for this sorter
                  */
@@ -81143,6 +81217,14 @@ declare namespace sap {
          * @returns The group function
          */
         getGroupFunction(): Function;
+        /**
+         * Returns the group paths.
+         *
+         * @since 1.147.0
+         *
+         * @returns The array of group paths or `undefined` if this sorter has no group paths.
+         */
+        getGroupPaths(): string[] | undefined;
         /**
          * Returns the binding path for this sorter; see the path parameter of {@link sap.ui.model.Sorter#constructor}.
          *
@@ -82916,6 +82998,19 @@ declare namespace sap {
             | boolean
             | sap.ui.base.ManagedObject.PropertyBindingInfo
             | `{${string}}`;
+
+          /**
+           * If set to `true`, a right-click (context menu) event will be triggered instead of a left-click. This
+           * simulates the native browser right-click behavior by dispatching `mousedown` and `mouseup` with `button:
+           * 2`, followed by a `contextmenu` event. The `xPercentage` and `yPercentage` properties can be used to
+           * specify the position of the right-click event.
+           *
+           * @since 1.147
+           */
+          rightClick?:
+            | boolean
+            | sap.ui.base.ManagedObject.PropertyBindingInfo
+            | `{${string}}`;
         }
 
         /**
@@ -83534,6 +83629,10 @@ declare namespace sap {
          * The `Press` action is used to simulate a press interaction with a control. Most controls are supported,
          * for example buttons, links, list items, tables, filters, and form controls.
          *
+         * The `Press` action can also simulate right-click (context menu) interactions by setting the `rightClick`
+         * property to true. This is useful for testing controls with custom context menus, such as `sap.ui.table.Table`
+         * and `sap.m.Table`.
+         *
          * The `Press` action targets a special DOM element representing the control. This DOM element can be customized.
          *
          * For most most controls (even custom ones), the DOM focus reference is an appropriate choice. You can
@@ -83633,7 +83732,9 @@ declare namespace sap {
           /**
            * Sets focus on given control and triggers a 'tap' event on it (which is internally translated into a 'press'
            * event). If `keyDown` or `keyUp` is set to `true`, dispatches the corresponding keyboard event instead
-           * of mouse events. Logs an error if control is not visible (i.e. has no dom representation)
+           * of mouse events. If `rightClick` property is set to `true`, triggers a `contextmenu` event instead, along
+           * with appropriate `mousedown` and `mouseup` events. Logs an error if control is not visible (i.e. has
+           * no dom representation)
            */
           executeOn(
             /**
@@ -83683,6 +83784,21 @@ declare namespace sap {
            * @returns Value of property `keyUp`
            */
           getKeyUp(): boolean;
+          /**
+           * Gets current value of property {@link #getRightClick rightClick}.
+           *
+           * If set to `true`, a right-click (context menu) event will be triggered instead of a left-click. This
+           * simulates the native browser right-click behavior by dispatching `mousedown` and `mouseup` with `button:
+           * 2`, followed by a `contextmenu` event. The `xPercentage` and `yPercentage` properties can be used to
+           * specify the position of the right-click event.
+           *
+           * Default value is `false`.
+           *
+           * @since 1.147
+           *
+           * @returns Value of property `rightClick`
+           */
+          getRightClick(): boolean;
           /**
            * Gets current value of property {@link #getShiftKey shiftKey}.
            *
@@ -83785,6 +83901,28 @@ declare namespace sap {
              */
             bKeyUp: boolean
           ): this;
+          /**
+           * Sets a new value for property {@link #getRightClick rightClick}.
+           *
+           * If set to `true`, a right-click (context menu) event will be triggered instead of a left-click. This
+           * simulates the native browser right-click behavior by dispatching `mousedown` and `mouseup` with `button:
+           * 2`, followed by a `contextmenu` event. The `xPercentage` and `yPercentage` properties can be used to
+           * specify the position of the right-click event.
+           *
+           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+           *
+           * Default value is `false`.
+           *
+           * @since 1.147
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setRightClick(
+            /**
+             * New value for property `rightClick`
+             */
+            bRightClick?: boolean
+          ): this;
           /**
            * Sets a new value for property {@link #getShiftKey shiftKey}.
            *
@@ -87787,6 +87925,27 @@ declare namespace sap {
          * Use when there are multiple views with the same viewName.
          */
         viewId?: string;
+        /**
+         * The namespace to be prepended to the view name defined in the `viewName` parameter. When set, all `waitFor`
+         * calls inside the page object will resolve the view by `viewNamespace + "." + viewName`.
+         *
+         * Example:
+         * ```javascript
+         *
+         *     Opa5.createPageObjects({
+         *       onMyPage: {
+         *         viewName: "myView",
+         *         viewNamespace: "my.app.namespace",
+         *         assertions: { ... }
+         *       }
+         *     });
+         *   ```
+         *
+         *
+         * Note: If all page objects share the same `viewNamespace`, consider setting it globally via {@link sap.ui.test.Opa5.extendConfig }
+         * to avoid repetition.
+         */
+        viewNamespace?: string;
         /**
          * Base class for the page object's actions and assertions
          */

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare namespace sap {
   interface IUI5DefineDependencyNames {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare namespace sap {
   namespace ui {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare namespace sap {
   namespace ui {
@@ -1471,6 +1471,8 @@ declare namespace sap {
 
     "sap/ui/fl/initial/_internal/connectors/Utils": undefined;
 
+    "sap/ui/fl/initial/_internal/FlexConfiguration": undefined;
+
     "sap/ui/fl/initial/_internal/preprocessors/ComponentLifecycleHooks": undefined;
 
     "sap/ui/fl/initial/_internal/preprocessors/ControllerExtension": undefined;
@@ -1579,6 +1581,8 @@ declare namespace sap {
 
     "sap/ui/fl/write/api/ControlPersonalizationWriteAPI": undefined;
 
+    "sap/ui/fl/write/api/ControlVariantWriteAPI": undefined;
+
     "sap/ui/fl/write/api/FeaturesAPI": undefined;
 
     "sap/ui/fl/write/api/FieldExtensibility": undefined;

package/types/sap.ui.generic.app.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare namespace sap {
   namespace ui {
@@ -1733,7 +1733,7 @@ declare namespace sap {
               /**
                * The OData model currently used
                */
-              oModel: sap.ui.model.odata.ODataModel,
+              oModel: sap.ui.model.odata.v2.ODataModel,
               /**
                * Optional HTTP request queue
                */
@@ -1867,7 +1867,7 @@ declare namespace sap {
               /**
                * The OData model currently used
                */
-              oModel: sap.ui.model.odata.ODataModel
+              oModel: sap.ui.model.odata.v2.ODataModel
             );
 
             /**
@@ -2102,7 +2102,7 @@ declare namespace sap {
               /**
                * The OData model currently used
                */
-              oModel: sap.ui.model.odata.ODataModel,
+              oModel: sap.ui.model.odata.v2.ODataModel,
               /**
                * Optional HTTP request queue
                */
@@ -2371,7 +2371,7 @@ declare namespace sap {
               /**
                * The OData model currently used
                */
-              oModel: sap.ui.model.odata.ODataModel,
+              oModel: sap.ui.model.odata.v2.ODataModel,
               /**
                * Optional HTTP request queue
                */

package/types/sap.ui.generic.template.d.ts

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

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare module "sap/ui/geomap/gen/sap_webcomponents/geomap" {
   /**

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare namespace sap {
   namespace ui {
@@ -433,18 +433,6 @@ declare namespace sap {
            * @experimental As of version 1.85.
            */
           getActionDefinitions(): sap.ui.integration.ActionDefinition[];
-          /**
-           * Gets current value of property {@link #getBaseUrl baseUrl}.
-           *
-           * Defines the base URL of the card manifest. It should be used when manifest property is an object instead
-           * of a URL. If both manifest URL and base URL are defined - the base URL will be used for loading dependencies.
-           * If both manifest URL and base URL are not defined - relative resources might not be loaded correctly.
-           *
-           * @experimental As of version 1.70.
-           *
-           * @returns Value of property `baseUrl`
-           */
-          getBaseUrl(): sap.ui.core.URI;
           /**
            * Get information about the blocking message in the card.
            *
@@ -826,11 +814,13 @@ declare namespace sap {
             | `{${string}}`;
 
           /**
-           * Defines the base URL of the card manifest. It should be used when manifest property is an object instead
-           * of a URL. If both manifest URL and base URL are defined - the base URL will be used for loading dependencies.
-           * If both manifest URL and base URL are not defined - relative resources might not be loaded correctly.
+           * Defines the base URL of the card manifest. It must be provided when the manifest is an object and not
+           * a URL. The base URL is used to load relatively referenced resources.
            *
-           * @experimental As of version 1.70.
+           * If the base URL is not defined and the manifest URL is defined, the manifest URL is used as the base
+           * URL.
+           * 	 - If both the manifest URL and the base URL are defined, the base URL is used.
+           * 	 - If neither the manifest URL nor the base URL is defined, relative resources will not load correctly.
            */
           baseUrl?:
             | sap.ui.core.URI
@@ -1552,11 +1542,15 @@ declare namespace sap {
           /**
            * Gets current value of property {@link #getBaseUrl baseUrl}.
            *
-           * Defines the base URL of the card manifest. It should be used when manifest property is an object instead
-           * of a URL. If both manifest URL and base URL are defined - the base URL will be used for loading dependencies.
-           * If both manifest URL and base URL are not defined - relative resources might not be loaded correctly.
+           * Defines the base URL of the card manifest. It must be provided when the manifest is an object and not
+           * a URL. The base URL is used to load relatively referenced resources.
+           *
+           * If the base URL is not defined and the manifest URL is defined, the manifest URL is used as the base
+           * URL.
+           * 	 - If both the manifest URL and the base URL are defined, the base URL is used.
+           * 	 - If neither the manifest URL nor the base URL is defined, relative resources will not load correctly.
+           *
            *
-           * @experimental As of version 1.70.
            *
            * @returns Value of property `baseUrl`
            */
@@ -1984,13 +1978,17 @@ declare namespace sap {
           /**
            * Sets a new value for property {@link #getBaseUrl baseUrl}.
            *
-           * Defines the base URL of the card manifest. It should be used when manifest property is an object instead
-           * of a URL. If both manifest URL and base URL are defined - the base URL will be used for loading dependencies.
-           * If both manifest URL and base URL are not defined - relative resources might not be loaded correctly.
+           * Defines the base URL of the card manifest. It must be provided when the manifest is an object and not
+           * a URL. The base URL is used to load relatively referenced resources.
+           *
+           * If the base URL is not defined and the manifest URL is defined, the manifest URL is used as the base
+           * URL.
+           * 	 - If both the manifest URL and the base URL are defined, the base URL is used.
+           * 	 - If neither the manifest URL nor the base URL is defined, relative resources will not load correctly.
+           *
            *
            * When called with a value of `null` or `undefined`, the default value of the property will be restored.
            *
-           * @experimental As of version 1.70.
            *
            * @returns Reference to `this` in order to allow method chaining
            */

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare namespace sap {
   namespace ui {