@sapui5/ts-types 1.145.1 → 1.147.0

package/types/sap.makit.d.ts

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

package/types/sap.me.d.ts

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

package/types/sap.ndc.d.ts

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

package/types/sap.ovp.d.ts

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

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

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

package/types/sap.sac.df.d.ts

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

package/types/sap.suite.ui.commons.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.145.1
+// For Library Version: 1.147.0
 
 declare module "sap/suite/ui/commons/collaboration/BaseHelperService" {
   /**
@@ -3873,13 +3873,22 @@ declare namespace sap {
               /**
                * Enables advanced line routing algorithm that creates orthogonal bends along the pathfinding process for
                * line creation.
-               *
-               * @since 1.144
                */
               enableOptimizedLineAlgorithm?:
                 | boolean
                 | sap.ui.base.ManagedObject.PropertyBindingInfo
                 | `{${string}}`;
+
+              /**
+               * Defines how separate connected components should be arranged in the graph. Components can be arranged
+               * either horizontally (side-by-side) or vertically (stacked).
+               *
+               * @since 1.146
+               */
+              componentArrangement?:
+                | sap.suite.ui.commons.networkgraph.ComponentArrangement
+                | sap.ui.base.ManagedObject.PropertyBindingInfo
+                | `{${string}}`;
             }
 
             /**
@@ -4697,6 +4706,19 @@ declare namespace sap {
                * @returns Metadata object describing this class
                */
               static getMetadata(): sap.ui.core.ElementMetadata;
+              /**
+               * Gets current value of property {@link #getComponentArrangement componentArrangement}.
+               *
+               * Defines how separate connected components should be arranged in the graph. Components can be arranged
+               * either horizontally (side-by-side) or vertically (stacked).
+               *
+               * Default value is `Horizontal`.
+               *
+               * @since 1.146
+               *
+               * @returns Value of property `componentArrangement`
+               */
+              getComponentArrangement(): sap.suite.ui.commons.networkgraph.ComponentArrangement;
               /**
                * Gets current value of property {@link #getEnableOptimizedLineAlgorithm enableOptimizedLineAlgorithm}.
                *
@@ -4705,7 +4727,6 @@ declare namespace sap {
                *
                * Default value is `false`.
                *
-               * @since 1.144
                *
                * @returns Value of property `enableOptimizedLineAlgorithm`
                */
@@ -4718,12 +4739,33 @@ declare namespace sap {
                */
               getLayoutRenderType(): sap.suite.ui.commons.networkgraph.LayoutRenderType;
               /**
-               * Executes the layout algorithm.
+               * Executes the layout algorithm. Automatically calculates initial positions for unpositioned nodes using
+               * DependencyLayoutHelper, then normalizes line coordinates.
                *
                *
                * @returns Task to get the layout calculated.
                */
               layout(): sap.suite.ui.commons.networkgraph.layout.LayoutTask;
+              /**
+               * Sets a new value for property {@link #getComponentArrangement componentArrangement}.
+               *
+               * Defines how separate connected components should be arranged in the graph. Components can be arranged
+               * either horizontally (side-by-side) or vertically (stacked).
+               *
+               * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+               *
+               * Default value is `Horizontal`.
+               *
+               * @since 1.146
+               *
+               * @returns Reference to `this` in order to allow method chaining
+               */
+              setComponentArrangement(
+                /**
+                 * New value for property `componentArrangement`
+                 */
+                sComponentArrangement?: sap.suite.ui.commons.networkgraph.ComponentArrangement
+              ): this;
               /**
                * Sets a new value for property {@link #getEnableOptimizedLineAlgorithm enableOptimizedLineAlgorithm}.
                *
@@ -4734,7 +4776,6 @@ declare namespace sap {
                *
                * Default value is `false`.
                *
-               * @since 1.144
                *
                * @returns Reference to `this` in order to allow method chaining
                */
@@ -4898,6 +4939,20 @@ declare namespace sap {
              * nodes based on their dependency relationships using topological sorting, cycle detection, and layer-based
              * positioning.
              *
+             * Why a node may be positioned incorrectly after recalculation: After each run, node positions are cached
+             * with a flag indicating whether the user moved them (`bIsUserPositioned`). On the next call, nodes flagged
+             * as user-positioned are preserved as-is, and the algorithm-placed nodes are recalculated. A node appears
+             * in the wrong place if it is unexpectedly treated as user-positioned, most commonly because `clearCache:
+             * true` was passed. It wipes the cache, but leaves the coordinates intact. So every node with non-zero
+             * coordinates is immediately re-classified as user-positioned and freezes, rather than being recalculated.
+             *
+             * Drag and drop recalculation - correct pattern: Call `resetNode(oNode)` for each dragged node, then call
+             * `calculatePositions` without `clearCache` (default `false`). `resetNode` evicts the node from the cache
+             * and zeros its coordinates, so only that node is repositioned; all the other nodes remain stable.
+             *
+             * Sentinel value: Coordinates `(0, 0)` mean "unpositioned". To place a node at the canvas origin, use `(0.1,
+             * 0.1)` or `(1, 1)` instead.
+             *
              * @since 1.144
              */
             interface DependencyLayoutHelper {}
@@ -5214,7 +5269,9 @@ declare namespace sap {
 
             /**
              * Enables the drag and drop of nodes. This property is ignored if the layout property is not set to noop.
-             * If set to `true`, nodes can be dragged and dropped within the graph.
+             * If set to `true`, nodes can be dragged and dropped within the graph. Note: Drag and drop functionality
+             * is only available for nodes. Groups cannot be dragged and dropped, even when NoopLayout is used and enableDragAndDrop
+             * is set to true.
              *
              * @since 1.144
              */
@@ -5370,7 +5427,11 @@ declare namespace sap {
 
             /**
              * This event is fired when a user drops a node in the graph. This event is available only when the layout
-             * algorithm is set to "NoopLayout" and the `enableDragAndDrop` property is set to `true`.
+             * algorithm is set to "NoopLayout" and the `enableDragAndDrop` property is set to `true`. Note: When a
+             * node is dropped near the TOP or LEFT boundary of the graph canvas, its position is automatically adjusted
+             * (clamped) to ensure the node and its elements remain fully visible. This provides better visualization
+             * by preventing nodes from being positioned at coordinates that would make them invisible or partially
+             * hidden.
              *
              * @since 1.144
              */
@@ -5391,6 +5452,14 @@ declare namespace sap {
              * @since 1.145
              */
             itemDeleted?: (oEvent: Graph$ItemDeletedEvent) => void;
+
+            /**
+             * Fired when the user requests to add a node via INSERT or Ctrl+Alt+N. Only available when NoopLayout is
+             * used and enableDragAndDrop is `true`.
+             *
+             * @since 1.148
+             */
+            nodeAdded?: (oEvent: sap.ui.base.Event) => void;
           }
 
           /**
@@ -6137,6 +6206,11 @@ declare namespace sap {
             item?: sap.suite.ui.commons.networkgraph.ElementBase;
           }
 
+          /**
+           * Parameters of the Graph#nodeAdded event.
+           */
+          interface Graph$NodeAddedEventParameters {}
+
           /**
            * Parameters of the Graph#nodeDropped event.
            */
@@ -7535,6 +7609,59 @@ declare namespace sap {
                */
               oListener?: object
             ): this;
+            /**
+             * Attaches event handler `fnFunction` to the {@link #event:nodeAdded nodeAdded} event of this `sap.suite.ui.commons.networkgraph.Graph`.
+             *
+             * 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.suite.ui.commons.networkgraph.Graph` itself.
+             *
+             * Fired when the user requests to add a node via INSERT or Ctrl+Alt+N. Only available when NoopLayout is
+             * used and enableDragAndDrop is `true`.
+             *
+             * @since 1.148
+             *
+             * @returns Reference to `this` in order to allow method chaining
+             */
+            attachNodeAdded(
+              /**
+               * 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.suite.ui.commons.networkgraph.Graph`
+               * itself
+               */
+              oListener?: object
+            ): this;
+            /**
+             * Attaches event handler `fnFunction` to the {@link #event:nodeAdded nodeAdded} event of this `sap.suite.ui.commons.networkgraph.Graph`.
+             *
+             * 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.suite.ui.commons.networkgraph.Graph` itself.
+             *
+             * Fired when the user requests to add a node via INSERT or Ctrl+Alt+N. Only available when NoopLayout is
+             * used and enableDragAndDrop is `true`.
+             *
+             * @since 1.148
+             *
+             * @returns Reference to `this` in order to allow method chaining
+             */
+            attachNodeAdded(
+              /**
+               * 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.suite.ui.commons.networkgraph.Graph`
+               * itself
+               */
+              oListener?: object
+            ): this;
             /**
              * Attaches event handler `fnFunction` to the {@link #event:nodeDropped nodeDropped} event of this `sap.suite.ui.commons.networkgraph.Graph`.
              *
@@ -7542,7 +7669,11 @@ declare namespace sap {
              * otherwise it will be bound to this `sap.suite.ui.commons.networkgraph.Graph` itself.
              *
              * This event is fired when a user drops a node in the graph. This event is available only when the layout
-             * algorithm is set to "NoopLayout" and the `enableDragAndDrop` property is set to `true`.
+             * algorithm is set to "NoopLayout" and the `enableDragAndDrop` property is set to `true`. Note: When a
+             * node is dropped near the TOP or LEFT boundary of the graph canvas, its position is automatically adjusted
+             * (clamped) to ensure the node and its elements remain fully visible. This provides better visualization
+             * by preventing nodes from being positioned at coordinates that would make them invisible or partially
+             * hidden.
              *
              * @since 1.144
              *
@@ -7571,7 +7702,11 @@ declare namespace sap {
              * otherwise it will be bound to this `sap.suite.ui.commons.networkgraph.Graph` itself.
              *
              * This event is fired when a user drops a node in the graph. This event is available only when the layout
-             * algorithm is set to "NoopLayout" and the `enableDragAndDrop` property is set to `true`.
+             * algorithm is set to "NoopLayout" and the `enableDragAndDrop` property is set to `true`. Note: When a
+             * node is dropped near the TOP or LEFT boundary of the graph canvas, its position is automatically adjusted
+             * (clamped) to ensure the node and its elements remain fully visible. This provides better visualization
+             * by preventing nodes from being positioned at coordinates that would make them invisible or partially
+             * hidden.
              *
              * @since 1.144
              *
@@ -7958,6 +8093,25 @@ declare namespace sap {
                */
               oListener?: object
             ): this;
+            /**
+             * Detaches event handler `fnFunction` from the {@link #event:nodeAdded nodeAdded} event of this `sap.suite.ui.commons.networkgraph.Graph`.
+             *
+             * The passed function and listener object must match the ones used for event registration.
+             *
+             * @since 1.148
+             *
+             * @returns Reference to `this` in order to allow method chaining
+             */
+            detachNodeAdded(
+              /**
+               * 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;
             /**
              * Detaches event handler `fnFunction` from the {@link #event:nodeDropped nodeDropped} event of this `sap.suite.ui.commons.networkgraph.Graph`.
              *
@@ -8131,6 +8285,20 @@ declare namespace sap {
                */
               mParameters?: sap.suite.ui.commons.networkgraph.Graph$ItemDeletedEventParameters
             ): this;
+            /**
+             * Fires event {@link #event:nodeAdded nodeAdded} to attached listeners.
+             *
+             * @since 1.148
+             * @ui5-protected Do not call from applications (only from related classes in the framework)
+             *
+             * @returns Reference to `this` in order to allow method chaining
+             */
+            fireNodeAdded(
+              /**
+               * Parameters to pass along with the event
+               */
+              mParameters?: object
+            ): this;
             /**
              * Fires event {@link #event:nodeDropped nodeDropped} to attached listeners.
              *
@@ -13426,6 +13594,14 @@ declare namespace sap {
             Graph
           >;
 
+          /**
+           * Event object of the Graph#nodeAdded event.
+           */
+          type Graph$NodeAddedEvent = sap.ui.base.Event<
+            Graph$NodeAddedEventParameters,
+            Graph
+          >;
+
           /**
            * Event object of the Graph#nodeDropped event.
            */
@@ -20192,6 +20368,13 @@ declare namespace sap {
            * This event is fired after the expression is validated.
            */
           afterValidation?: (oEvent: sap.ui.base.Event) => void;
+
+          /**
+           * This event is triggered when the focus leaves the input field.
+           *
+           * @since 1.146
+           */
+          focusChange?: (oEvent: CalculationBuilder$FocusChangeEvent) => void;
         }
 
         /**
@@ -24036,6 +24219,15 @@ declare namespace sap {
          */
         interface CalculationBuilder$ChangeEventParameters {}
 
+        /**
+         * Parameters of the CalculationBuilder#focusChange event.
+         */
+        interface CalculationBuilder$FocusChangeEventParameters {
+          value?: String;
+
+          position?: int;
+        }
+
         /**
          * Parameters of the CalculationBuilder#validateFunction event.
          */
@@ -25940,6 +26132,57 @@ declare namespace sap {
              */
             oListener?: object
           ): this;
+          /**
+           * Attaches event handler `fnFunction` to the {@link #event:focusChange focusChange} event of this `sap.suite.ui.commons.CalculationBuilder`.
+           *
+           * 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.suite.ui.commons.CalculationBuilder` itself.
+           *
+           * This event is triggered when the focus leaves the input field.
+           *
+           * @since 1.146
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          attachFocusChange(
+            /**
+             * 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: CalculationBuilder$FocusChangeEvent) => void,
+            /**
+             * Context object to call the event handler with. Defaults to this `sap.suite.ui.commons.CalculationBuilder`
+             * itself
+             */
+            oListener?: object
+          ): this;
+          /**
+           * Attaches event handler `fnFunction` to the {@link #event:focusChange focusChange} event of this `sap.suite.ui.commons.CalculationBuilder`.
+           *
+           * 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.suite.ui.commons.CalculationBuilder` itself.
+           *
+           * This event is triggered when the focus leaves the input field.
+           *
+           * @since 1.146
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          attachFocusChange(
+            /**
+             * The function to be called when the event occurs
+             */
+            fnFunction: (p1: CalculationBuilder$FocusChangeEvent) => void,
+            /**
+             * Context object to call the event handler with. Defaults to this `sap.suite.ui.commons.CalculationBuilder`
+             * itself
+             */
+            oListener?: object
+          ): this;
           /**
            * Attaches event handler `fnFunction` to the {@link #event:validateFunction validateFunction} event of
            * this `sap.suite.ui.commons.CalculationBuilder`.
@@ -26082,6 +26325,25 @@ declare namespace sap {
              */
             oListener?: object
           ): this;
+          /**
+           * Detaches event handler `fnFunction` from the {@link #event:focusChange focusChange} event of this `sap.suite.ui.commons.CalculationBuilder`.
+           *
+           * The passed function and listener object must match the ones used for event registration.
+           *
+           * @since 1.146
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          detachFocusChange(
+            /**
+             * The function to be called, when the event occurs
+             */
+            fnFunction: (p1: CalculationBuilder$FocusChangeEvent) => void,
+            /**
+             * Context object on which the given function had to be called
+             */
+            oListener?: object
+          ): this;
           /**
            * Detaches event handler `fnFunction` from the {@link #event:validateFunction validateFunction} event of
            * this `sap.suite.ui.commons.CalculationBuilder`.
@@ -26127,6 +26389,20 @@ declare namespace sap {
              */
             mParameters?: object
           ): this;
+          /**
+           * Fires event {@link #event:focusChange focusChange} to attached listeners.
+           *
+           * @since 1.146
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          fireFocusChange(
+            /**
+             * Parameters to pass along with the event
+             */
+            mParameters?: sap.suite.ui.commons.CalculationBuilder$FocusChangeEventParameters
+          ): this;
           /**
            * Fires event {@link #event:validateFunction validateFunction} to attached listeners.
            *
@@ -51653,6 +51929,14 @@ declare namespace sap {
           CalculationBuilder
         >;
 
+        /**
+         * Event object of the CalculationBuilder#focusChange event.
+         */
+        type CalculationBuilder$FocusChangeEvent = sap.ui.base.Event<
+          CalculationBuilder$FocusChangeEventParameters,
+          CalculationBuilder
+        >;
+
         /**
          * Event object of the CalculationBuilder#validateFunction event.
          */

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.145.1
+// For Library Version: 1.147.0
 
 declare namespace sap {
   namespace suite {
@@ -590,6 +590,22 @@ declare namespace sap {
                  */
                 bReplaceInHistory: boolean
               ): boolean;
+              /**
+               * This method is called by SAP Fiori elements when a Contextmenu open in a new tab is triggered from a
+               * table. Application developers can override this method and perform conditional (internal or external)
+               * navigation from different rows of a table. Such custom navigation should be triggered via corresponding
+               * methods of {@link sap.suite.ui.generic.template.extensionAPI.NavigationController NavigationController}.
+               *
+               * @ui5-protected Do not call from applications (only from related classes in the framework)
+               *
+               * @returns Method should return `true` if framework navigation should be suppressed
+               */
+              onListNavigationExtensionFromContextMenu(
+                /**
+                 * The context of the corresponding table row
+                 */
+                aContext: sap.ui.model.Context[]
+              ): boolean;
               /**
                * This method is called by SAP Fiori elements when the Share functionality is triggered. Application developers
                * can adapt the service URL passed as a parameter to this method. Adapted service URL will be used in the
@@ -1184,6 +1200,11 @@ declare namespace sap {
                 | string
                 | sap.ui.base.ManagedObject.PropertyBindingInfo;
 
+              applyButtonNavigatesImmediately?:
+                | boolean
+                | sap.ui.base.ManagedObject.PropertyBindingInfo
+                | `{${string}}`;
+
               useColumnLayoutForSmartForm?:
                 | boolean
                 | sap.ui.base.ManagedObject.PropertyBindingInfo
@@ -1392,6 +1413,15 @@ declare namespace sap {
                  */
                 mParameters?: object
               ): this;
+              /**
+               * Gets current value of property {@link #getApplyButtonNavigatesImmediately applyButtonNavigatesImmediately}.
+               *
+               * Default value is `false`.
+               *
+               *
+               * @returns Value of property `applyButtonNavigatesImmediately`
+               */
+              getApplyButtonNavigatesImmediately(): boolean;
               /**
                * Gets current value of property {@link #getCollaborationSettings collaborationSettings}.
                *
@@ -1553,6 +1583,22 @@ declare namespace sap {
                * @returns Value of property `useColumnLayoutForSmartForm`
                */
               getUseColumnLayoutForSmartForm(): boolean;
+              /**
+               * Sets a new value for property {@link #getApplyButtonNavigatesImmediately applyButtonNavigatesImmediately}.
+               *
+               * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+               *
+               * Default value is `false`.
+               *
+               *
+               * @returns Reference to `this` in order to allow method chaining
+               */
+              setApplyButtonNavigatesImmediately(
+                /**
+                 * New value for property `applyButtonNavigatesImmediately`
+                 */
+                bApplyButtonNavigatesImmediately?: boolean
+              ): this;
               /**
                * Sets a new value for property {@link #getCollaborationSettings collaborationSettings}.
                *
@@ -2596,6 +2642,22 @@ declare namespace sap {
                  */
                 bReplaceInHistory: boolean
               ): boolean;
+              /**
+               * This method is called by SAP Fiori elements when a Contextmenu open in a new tab is triggered from a
+               * table. Application developers can override this method and perform conditional (internal or external)
+               * navigation from different rows of a table. Such custom navigation should be triggered via corresponding
+               * methods of {@link sap.suite.ui.generic.template.extensionAPI.NavigationController NavigationController}.
+               *
+               * @ui5-protected Do not call from applications (only from related classes in the framework)
+               *
+               * @returns Method should return `true` if framework navigation should be suppressed
+               */
+              onListNavigationExtensionFromContextMenu(
+                /**
+                 * The context of the corresponding table row
+                 */
+                aContext: sap.ui.model.Context[]
+              ): boolean;
               /**
                * This method is called by SAP Fiori elements when the Share functionality is triggered. Application developers
                * can adapt the service URL passed as a parameter to this method. Adapted service URL will be used in the
@@ -3623,6 +3685,22 @@ declare namespace sap {
                  */
                 bReplaceInHistory: boolean
               ): boolean;
+              /**
+               * This method is called by SAP Fiori elements when a Contextmenu open in a new tab is triggered from a
+               * table. Application developers can override this method and perform conditional (internal or external)
+               * navigation from different rows of a table. Such custom navigation should be triggered via corresponding
+               * methods of {@link sap.suite.ui.generic.template.extensionAPI.NavigationController NavigationController}.
+               *
+               * @ui5-protected Do not call from applications (only from related classes in the framework)
+               *
+               * @returns Method should return `true` if framework navigation should be suppressed
+               */
+              onListNavigationExtensionFromContextMenu(
+                /**
+                 * The context of the corresponding table row
+                 */
+                aContext: sap.ui.model.Context[]
+              ): boolean;
               /**
                * This method is called by SAP Fiori elements when the Share functionality is triggered. Application developers
                * can adapt the service URL passed as a parameter to this method. Adapted service URL will be used in the

package/types/sap.suite.ui.microchart.d.ts

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