@sapui5/ts-types-esm 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 module "sap/makit/library" {
   /**

package/types/sap.me.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.145.1
+// For Library Version: 1.147.0
 
 declare module "sap/me/library" {
   /**

package/types/sap.ndc.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.145.1
+// For Library Version: 1.147.0
 
 declare module "sap/ndc/library" {}
 

package/types/sap.ovp.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.145.1
+// For Library Version: 1.147.0
 
 declare module "sap/ovp/library" {}
 

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.145.0
+// For Library Version: 1.147.0
 
 declare module "sap/rules/ui/library" {
   /**

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" {
   import BaseObject from "sap/ui/base/Object";
@@ -2840,6 +2840,57 @@ declare module "sap/suite/ui/commons/CalculationBuilder" {
        */
       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`.
@@ -2982,6 +3033,25 @@ declare module "sap/suite/ui/commons/CalculationBuilder" {
        */
       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`.
@@ -3027,6 +3097,20 @@ declare module "sap/suite/ui/commons/CalculationBuilder" {
        */
       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?: CalculationBuilder$FocusChangeEventParameters
+    ): this;
     /**
      * Fires event {@link #event:validateFunction validateFunction} to attached listeners.
      *
@@ -3957,6 +4041,13 @@ declare module "sap/suite/ui/commons/CalculationBuilder" {
      * This event is fired after the expression is validated.
      */
     afterValidation?: (oEvent: Event) => void;
+
+    /**
+     * This event is triggered when the focus leaves the input field.
+     *
+     * @since 1.146
+     */
+    focusChange?: (oEvent: CalculationBuilder$FocusChangeEvent) => void;
   }
 
   /**
@@ -3985,6 +4076,23 @@ declare module "sap/suite/ui/commons/CalculationBuilder" {
     CalculationBuilder
   >;
 
+  /**
+   * Parameters of the CalculationBuilder#focusChange event.
+   */
+  export interface CalculationBuilder$FocusChangeEventParameters {
+    value?: String;
+
+    position?: int;
+  }
+
+  /**
+   * Event object of the CalculationBuilder#focusChange event.
+   */
+  export type CalculationBuilder$FocusChangeEvent = Event<
+    CalculationBuilder$FocusChangeEventParameters,
+    CalculationBuilder
+  >;
+
   /**
    * Parameters of the CalculationBuilder#validateFunction event.
    */
@@ -21024,6 +21132,59 @@ declare module "sap/suite/ui/commons/networkgraph/Graph" {
        */
       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: 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: 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`.
      *
@@ -21031,7 +21192,11 @@ declare module "sap/suite/ui/commons/networkgraph/Graph" {
      * 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
      *
@@ -21060,7 +21225,11 @@ declare module "sap/suite/ui/commons/networkgraph/Graph" {
      * 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
      *
@@ -21447,6 +21616,25 @@ declare module "sap/suite/ui/commons/networkgraph/Graph" {
        */
       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: 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`.
      *
@@ -21620,6 +21808,20 @@ declare module "sap/suite/ui/commons/networkgraph/Graph" {
        */
       mParameters?: 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.
      *
@@ -22769,7 +22971,9 @@ declare module "sap/suite/ui/commons/networkgraph/Graph" {
 
     /**
      * 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
      */
@@ -22900,7 +23104,11 @@ declare module "sap/suite/ui/commons/networkgraph/Graph" {
 
     /**
      * 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
      */
@@ -22921,6 +23129,14 @@ declare module "sap/suite/ui/commons/networkgraph/Graph" {
      * @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: Event) => void;
   }
 
   /**
@@ -23038,6 +23254,19 @@ declare module "sap/suite/ui/commons/networkgraph/Graph" {
     Graph
   >;
 
+  /**
+   * Parameters of the Graph#nodeAdded event.
+   */
+  export interface Graph$NodeAddedEventParameters {}
+
+  /**
+   * Event object of the Graph#nodeAdded event.
+   */
+  export type Graph$NodeAddedEvent = Event<
+    Graph$NodeAddedEventParameters,
+    Graph
+  >;
+
   /**
    * Parameters of the Graph#nodeDropped event.
    */
@@ -25078,6 +25307,19 @@ declare module "sap/suite/ui/commons/networkgraph/layout/NoopLayout" {
      * @returns Metadata object describing this class
      */
     static getMetadata(): 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(): networkgraph.ComponentArrangement;
     /**
      * Gets current value of property {@link #getEnableOptimizedLineAlgorithm enableOptimizedLineAlgorithm}.
      *
@@ -25086,7 +25328,6 @@ declare module "sap/suite/ui/commons/networkgraph/layout/NoopLayout" {
      *
      * Default value is `false`.
      *
-     * @since 1.144
      *
      * @returns Value of property `enableOptimizedLineAlgorithm`
      */
@@ -25099,12 +25340,35 @@ declare module "sap/suite/ui/commons/networkgraph/layout/NoopLayout" {
      */
     getLayoutRenderType(): 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(): 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?:
+        | networkgraph.ComponentArrangement
+        | keyof typeof networkgraph.ComponentArrangement
+    ): this;
     /**
      * Sets a new value for property {@link #getEnableOptimizedLineAlgorithm enableOptimizedLineAlgorithm}.
      *
@@ -25115,7 +25379,6 @@ declare module "sap/suite/ui/commons/networkgraph/layout/NoopLayout" {
      *
      * Default value is `false`.
      *
-     * @since 1.144
      *
      * @returns Reference to `this` in order to allow method chaining
      */
@@ -25133,13 +25396,25 @@ declare module "sap/suite/ui/commons/networkgraph/layout/NoopLayout" {
     /**
      * Enables advanced line routing algorithm that creates orthogonal bends along the pathfinding process for
      * line creation.
-     *
-     * @since 1.144
      */
     enableOptimizedLineAlgorithm?:
       | boolean
       | 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?:
+      | (
+          | networkgraph.ComponentArrangement
+          | keyof typeof networkgraph.ComponentArrangement
+        )
+      | PropertyBindingInfo
+      | `{${string}}`;
   }
 }
 
@@ -29018,6 +29293,20 @@ declare module "sap/suite/ui/commons/networkgraph/util/DependencyLayoutHelper" {
    * 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 {}

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 module "sap/suite/ui/generic/template/library" {
   /**
@@ -386,6 +386,22 @@ declare module "sap/suite/ui/generic/template/AnalyticalListPage/controllerFrame
        */
       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: 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
@@ -1367,6 +1383,15 @@ declare module "sap/suite/ui/generic/template/lib/AppComponent" {
        */
       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}.
      *
@@ -1528,6 +1553,22 @@ declare module "sap/suite/ui/generic/template/lib/AppComponent" {
      * @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}.
      *
@@ -1848,6 +1889,11 @@ declare module "sap/suite/ui/generic/template/lib/AppComponent" {
 
     tableColumnVerticalAlignment?: string | PropertyBindingInfo;
 
+    applyButtonNavigatesImmediately?:
+      | boolean
+      | PropertyBindingInfo
+      | `{${string}}`;
+
     useColumnLayoutForSmartForm?: boolean | PropertyBindingInfo | `{${string}}`;
 
     objectPageColumns?: object | PropertyBindingInfo | `{${string}}`;
@@ -2290,6 +2336,22 @@ declare module "sap/suite/ui/generic/template/ListReport/controllerFrameworkExte
        */
       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: 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
@@ -3000,6 +3062,22 @@ declare module "sap/suite/ui/generic/template/ObjectPage/controllerFrameworkExte
        */
       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: 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 module "sap/suite/ui/microchart/library" {
   /**