@sapui5/ts-types 1.144.1 → 1.146.0

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.144.0
+// For Library Version: 1.146.0
 
 declare module "sap/suite/ui/commons/collaboration/BaseHelperService" {
   /**
@@ -155,8 +155,6 @@ declare module "sap/suite/ui/commons/collaboration/BaseHelperService" {
 declare module "sap/suite/ui/commons/collaboration/CollaborationHelper" {
   /**
    * CollaborationHelper for collaboration-related functionalities
-   *
-   * @since 1.108
    */
   interface CollaborationHelper {
     /**
@@ -3875,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}}`;
             }
 
             /**
@@ -4699,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}.
                *
@@ -4707,7 +4727,6 @@ declare namespace sap {
                *
                * Default value is `false`.
                *
-               * @since 1.144
                *
                * @returns Value of property `enableOptimizedLineAlgorithm`
                */
@@ -4720,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}.
                *
@@ -4736,7 +4776,6 @@ declare namespace sap {
                *
                * Default value is `false`.
                *
-               * @since 1.144
                *
                * @returns Reference to `this` in order to allow method chaining
                */
@@ -5216,7 +5255,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
              */
@@ -5371,8 +5412,12 @@ declare namespace sap {
             search?: (oEvent: Graph$SearchEvent) => void;
 
             /**
-             * This event is fired when a user drops a node in the graph. This event is available only for the noop
-             * layout.
+             * 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`. 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
              */
@@ -5384,6 +5429,15 @@ declare namespace sap {
              * @since 1.144
              */
             connectionCreated?: (oEvent: Graph$ConnectionCreatedEvent) => void;
+
+            /**
+             * This event is fired when a user presses the delete key on a focused node or line. This event is available
+             * only when the layout algorithm is set to "NoopLayout" and the `enableDragAndDrop` property is set to
+             * `true`.
+             *
+             * @since 1.145
+             */
+            itemDeleted?: (oEvent: Graph$ItemDeletedEvent) => void;
           }
 
           /**
@@ -5809,6 +5863,31 @@ declare namespace sap {
               | sap.ui.base.ManagedObject.PropertyBindingInfo
               | `{${string}}`;
 
+            /**
+             * Determines the port configuration for this node. When set, it overrides the graph-level nodePorts setting.
+             * If not set (defaults to None), the graph-level setting is used. Ports are available only when the layout
+             * algorithm is set to "NoopLayout", and when the drag and drop is enabled.
+             *
+             * @since 1.145
+             */
+            nodePorts?: /* was: sap.suite.ui.commons.networkgraph.NodePorts */
+              | any
+              | sap.ui.base.ManagedObject.PropertyBindingInfo
+              | `{${string}}`;
+
+            /**
+             * Determines whether the 'Create Connection' action button is displayed on this node. When set, it overrides
+             * the graph-level showCreateConnectionButton setting. If set to default (true), the graph-level setting
+             * is used. The button is used to create connections between nodes as an accessible alternative to node
+             * ports.
+             *
+             * @since 1.145
+             */
+            showCreateConnectionButton?:
+              | boolean
+              | sap.ui.base.ManagedObject.PropertyBindingInfo
+              | `{${string}}`;
+
             /**
              * A list of links to be shown in the links area. A link may point to any UI5 control. It's up to the caller
              * to set up all necessary callback functions.
@@ -6095,6 +6174,16 @@ declare namespace sap {
            */
           interface Graph$GraphReadyEventParameters {}
 
+          /**
+           * Parameters of the Graph#itemDeleted event.
+           */
+          interface Graph$ItemDeletedEventParameters {
+            /**
+             * The item (node or line) that is to be deleted.
+             */
+            item?: sap.suite.ui.commons.networkgraph.ElementBase;
+          }
+
           /**
            * Parameters of the Graph#nodeDropped event.
            */
@@ -7438,14 +7527,73 @@ declare namespace sap {
                */
               oListener?: object
             ): this;
+            /**
+             * Attaches event handler `fnFunction` to the {@link #event:itemDeleted itemDeleted} 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.
+             *
+             * This event is fired when a user presses the delete key on a focused node or line. This event is available
+             * only when the layout algorithm is set to "NoopLayout" and the `enableDragAndDrop` property is set to
+             * `true`.
+             *
+             * @since 1.145
+             *
+             * @returns Reference to `this` in order to allow method chaining
+             */
+            attachItemDeleted(
+              /**
+               * 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: Graph$ItemDeletedEvent) => 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:itemDeleted itemDeleted} 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.
+             *
+             * This event is fired when a user presses the delete key on a focused node or line. This event is available
+             * only when the layout algorithm is set to "NoopLayout" and the `enableDragAndDrop` property is set to
+             * `true`.
+             *
+             * @since 1.145
+             *
+             * @returns Reference to `this` in order to allow method chaining
+             */
+            attachItemDeleted(
+              /**
+               * The function to be called when the event occurs
+               */
+              fnFunction: (p1: Graph$ItemDeletedEvent) => 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`.
              *
              * 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.
              *
-             * This event is fired when a user drops a node in the graph. This event is available only for the noop
-             * layout.
+             * 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`. 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
              *
@@ -7473,8 +7621,12 @@ declare namespace sap {
              * 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.
              *
-             * This event is fired when a user drops a node in the graph. This event is available only for the noop
-             * layout.
+             * 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`. 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
              *
@@ -7842,6 +7994,25 @@ declare namespace sap {
                */
               oListener?: object
             ): this;
+            /**
+             * Detaches event handler `fnFunction` from the {@link #event:itemDeleted itemDeleted} 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.145
+             *
+             * @returns Reference to `this` in order to allow method chaining
+             */
+            detachItemDeleted(
+              /**
+               * The function to be called, when the event occurs
+               */
+              fnFunction: (p1: Graph$ItemDeletedEvent) => 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`.
              *
@@ -8001,6 +8172,20 @@ declare namespace sap {
                */
               mParameters?: object
             ): this;
+            /**
+             * Fires event {@link #event:itemDeleted itemDeleted} to attached listeners.
+             *
+             * @since 1.145
+             * @ui5-protected Do not call from applications (only from related classes in the framework)
+             *
+             * @returns Reference to `this` in order to allow method chaining
+             */
+            fireItemDeleted(
+              /**
+               * Parameters to pass along with the event
+               */
+              mParameters?: sap.suite.ui.commons.networkgraph.Graph$ItemDeletedEventParameters
+            ): this;
             /**
              * Fires event {@link #event:nodeDropped nodeDropped} to attached listeners.
              *
@@ -11287,6 +11472,18 @@ declare namespace sap {
              * @returns Value of property `maxWidth`
              */
             getMaxWidth(): int;
+            /**
+             * Gets current value of property {@link #getNodePorts nodePorts}.
+             *
+             * Determines the port configuration for this node. When set, it overrides the graph-level nodePorts setting.
+             * If not set (defaults to None), the graph-level setting is used. Ports are available only when the layout
+             * algorithm is set to "NoopLayout", and when the drag and drop is enabled.
+             *
+             * @since 1.145
+             *
+             * @returns Value of property `nodePorts`
+             */
+            getNodePorts(): /* was: sap.suite.ui.commons.networkgraph.NodePorts */ any;
             /**
              * Gets current value of property {@link #getNodeTitleBackground nodeTitleBackground}.
              *
@@ -11347,6 +11544,21 @@ declare namespace sap {
              * @returns Value of property `showActionLinksButton`
              */
             getShowActionLinksButton(): boolean;
+            /**
+             * Gets current value of property {@link #getShowCreateConnectionButton showCreateConnectionButton}.
+             *
+             * Determines whether the 'Create Connection' action button is displayed on this node. When set, it overrides
+             * the graph-level showCreateConnectionButton setting. If set to default (true), the graph-level setting
+             * is used. The button is used to create connections between nodes as an accessible alternative to node
+             * ports.
+             *
+             * Default value is `true`.
+             *
+             * @since 1.145
+             *
+             * @returns Value of property `showCreateConnectionButton`
+             */
+            getShowCreateConnectionButton(): boolean;
             /**
              * Gets current value of property {@link #getShowDetailButton showDetailButton}.
              *
@@ -11965,6 +12177,25 @@ declare namespace sap {
                */
               iMaxWidth?: int
             ): this;
+            /**
+             * Sets a new value for property {@link #getNodePorts nodePorts}.
+             *
+             * Determines the port configuration for this node. When set, it overrides the graph-level nodePorts setting.
+             * If not set (defaults to None), the graph-level setting is used. Ports are available only when the layout
+             * algorithm is set to "NoopLayout", and when the drag and drop is enabled.
+             *
+             * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+             *
+             * @since 1.145
+             *
+             * @returns Reference to `this` in order to allow method chaining
+             */
+            setNodePorts(
+              /**
+               * New value for property `nodePorts`
+               */
+              sNodePorts: /* was: sap.suite.ui.commons.networkgraph.NodePorts */ any
+            ): this;
             /**
              * Sets a new value for property {@link #getNodeTitleBackground nodeTitleBackground}.
              *
@@ -12039,6 +12270,28 @@ declare namespace sap {
                */
               bShowActionLinksButton?: boolean
             ): this;
+            /**
+             * Sets a new value for property {@link #getShowCreateConnectionButton showCreateConnectionButton}.
+             *
+             * Determines whether the 'Create Connection' action button is displayed on this node. When set, it overrides
+             * the graph-level showCreateConnectionButton setting. If set to default (true), the graph-level setting
+             * is used. The button is used to create connections between nodes as an accessible alternative to node
+             * ports.
+             *
+             * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+             *
+             * Default value is `true`.
+             *
+             * @since 1.145
+             *
+             * @returns Reference to `this` in order to allow method chaining
+             */
+            setShowCreateConnectionButton(
+              /**
+               * New value for property `showCreateConnectionButton`
+               */
+              bShowCreateConnectionButton?: boolean
+            ): this;
             /**
              * Sets a new value for property {@link #getShowDetailButton showDetailButton}.
              *
@@ -12932,6 +13185,24 @@ declare namespace sap {
              */
             White = "White",
           }
+          /**
+           * Defines the arrangement of components in the dependency layout.
+           *
+           * This enum is part of the 'sap/suite/ui/commons/library' module export and must be accessed by the property
+           * 'networkgraph.ComponentArrangement'.
+           *
+           * @since 1.145
+           */
+          enum ComponentArrangement {
+            /**
+             * Components are arranged horizontally.
+             */
+            Horizontal = "Horizontal",
+            /**
+             * Components are arranged vertically.
+             */
+            Vertical = "Vertical",
+          }
           /**
            * Semantic type of the node status.
            *
@@ -13202,6 +13473,14 @@ declare namespace sap {
             Graph
           >;
 
+          /**
+           * Event object of the Graph#itemDeleted event.
+           */
+          type Graph$ItemDeletedEvent = sap.ui.base.Event<
+            Graph$ItemDeletedEventParameters,
+            Graph
+          >;
+
           /**
            * Event object of the Graph#nodeDropped event.
            */
@@ -19968,6 +20247,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;
         }
 
         /**
@@ -20353,8 +20639,6 @@ declare namespace sap {
 
         /**
          * Describes the settings that can be provided to the CloudFilePicker constructor.
-         *
-         * @experimental
          */
         interface $CloudFilePickerSettings extends sap.m.$DialogSettings {
           /**
@@ -23814,6 +24098,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.
          */
@@ -25718,6 +26011,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`.
@@ -25860,6 +26204,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`.
@@ -25905,6 +26268,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.
            *
@@ -29078,10 +29455,7 @@ declare namespace sap {
             sUnit?: string
           ): this;
         }
-        /**
-         * @since 1.101
-         * @experimental
-         */
+
         class CloudFilePicker extends sap.m.Dialog {
           /**
            * Constructor of the CloudFilePicker
@@ -51434,6 +51808,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.
          */