@openui5/ts-types 1.145.0 → 1.146.0

package/types/sap.m.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.145.0
+// For Library Version: 1.146.0
 
 declare module "sap/m/p13n/Engine" {
   /**
@@ -28010,8 +28010,10 @@ declare namespace sap {
        * Defines how many pages are displayed in the visible area of the `Carousel` control. Value should be a
        * positive number.
        *
-       * **Note:** When this property is set to something different than the default value, the `loop` property
+       * **Note:** When this property is set to something different from the default value, the `loop` property
        * of `Carousel` is ignored.
+       *
+       * **Note:** This property is ignored when the `responsive` property is set to `true`.
        */
       visiblePagesCount?:
         | int
@@ -28031,6 +28033,35 @@ declare namespace sap {
         | sap.m.CarouselScrollMode
         | sap.ui.base.ManagedObject.PropertyBindingInfo
         | `{${string}}`;
+
+      /**
+       * Activates the responsive layout mode, where the number of visible carousel pages automatically adjusts
+       * based on the available width and the specified page width.
+       *
+       * When this option is enabled, the carousel dynamically calculates and displays as many items as can fit
+       * within the viewport while adhering to the `minPageWidth` constraint.
+       *
+       * **Note:** Enabling this option overrides the `visiblePagesCount` property and disables the `loop` functionality
+       * of the carousel.
+       */
+      responsive?:
+        | boolean
+        | sap.ui.base.ManagedObject.PropertyBindingInfo
+        | `{${string}}`;
+
+      /**
+       * Defines the minimum width, in pixels, for each page to be displayed in the `Carousel` control.
+       *
+       * This property is used as a constraint when `responsive` mode is enabled, ensuring that pages are never
+       * rendered smaller than this specified width. The carousel automatically calculates the number of pages
+       * that can fit within the available viewport while respecting the specified minimum width requirement.
+       *
+       * **Note:** This property is only effective when the `responsive` property is set to `true`.
+       */
+      minPageWidth?:
+        | int
+        | sap.ui.base.ManagedObject.PropertyBindingInfo
+        | `{${string}}`;
     }
 
     /**
@@ -30858,6 +30889,7 @@ declare namespace sap {
        * 	 - `strong`
        * 	 - `span`
        * 	 - `u`
+       * 	 - `s`
        * 	 - `dl`
        * 	 - `dt`
        * 	 - `dd`
@@ -31836,8 +31868,7 @@ declare namespace sap {
       /**
        * Specifies the interaction mode.
        *
-       * @experimental As of version 1.121. Disclaimer: this property is in a beta state - incompatible API changes
-       * may be done before its official public release. Use at your own discretion.
+       * @experimental As of version 1.121.
        */
       interactionMode?:
         | sap.m.IconTabFilterInteractionMode
@@ -34220,6 +34251,13 @@ declare namespace sap {
        */
       closed?: (oEvent: sap.ui.base.Event) => void;
 
+      /**
+       * Fired when the menu is opened.
+       *
+       * @since 1.146
+       */
+      open?: (oEvent: sap.ui.base.Event) => void;
+
       /**
        * Fired before the menu is closed. This event can be prevented which effectively prevents the menu from
        * closing.
@@ -43559,8 +43597,7 @@ declare namespace sap {
         | `{${string}}`;
 
       /**
-       * Enables alternating table row colors. **Note:** This property can only be used with the Belize and Belize
-       * Deep themes. Alternate row coloring is not available for the High Contrast Black/White themes.
+       * Enables alternating table row colors.
        *
        * @since 1.52
        */
@@ -45932,6 +45969,11 @@ declare namespace sap {
        */
       manageCancel?: (oEvent: sap.ui.base.Event) => void;
 
+      /**
+       * This event is fired when users opens the Manage Views dialog.
+       */
+      manageOpen?: (oEvent: sap.ui.base.Event) => void;
+
       /**
        * This event is fired when users apply changes variant information in the Manage Views dialog. Some
        * of the parameters may be ommitted, depending on user selection.
@@ -47600,6 +47642,11 @@ declare namespace sap {
       item?: sap.m.IMenuItem;
     }
 
+    /**
+     * Parameters of the Menu#open event.
+     */
+    interface Menu$OpenEventParameters {}
+
     /**
      * Parameters of the MenuButton#beforeMenuOpen event.
      */
@@ -50401,6 +50448,11 @@ declare namespace sap {
      */
     interface VariantManagement$ManageCancelEventParameters {}
 
+    /**
+     * Parameters of the VariantManagement#manageOpen event.
+     */
+    interface VariantManagement$ManageOpenEventParameters {}
+
     /**
      * Parameters of the VariantManagement#save event.
      */
@@ -58780,6 +58832,8 @@ declare namespace sap {
      *     the navigation arrows.
      * 	 - On desktop, navigation is done with the navigation arrows.
      * 	 - The paging indicator (when activated) is visible on each form factor.
+     * 	 - When using {@link sap.m.CarouselLayout CarouselLayout} with the `responsive` property set to `true`,
+     *     the number of visible pages adjusts automatically based on the available width and the specified `minPageWidth`.
      */
     class Carousel extends sap.ui.core.Control {
       /**
@@ -59750,6 +59804,41 @@ declare namespace sap {
        * @returns Metadata object describing this class
        */
       static getMetadata(): sap.ui.base.ManagedObjectMetadata;
+      /**
+       * Gets current value of property {@link #getMinPageWidth minPageWidth}.
+       *
+       * Defines the minimum width, in pixels, for each page to be displayed in the `Carousel` control.
+       *
+       * This property is used as a constraint when `responsive` mode is enabled, ensuring that pages are never
+       * rendered smaller than this specified width. The carousel automatically calculates the number of pages
+       * that can fit within the available viewport while respecting the specified minimum width requirement.
+       *
+       * **Note:** This property is only effective when the `responsive` property is set to `true`.
+       *
+       * Default value is `148`.
+       *
+       *
+       * @returns Value of property `minPageWidth`
+       */
+      getMinPageWidth(): int;
+      /**
+       * Gets current value of property {@link #getResponsive responsive}.
+       *
+       * Activates the responsive layout mode, where the number of visible carousel pages automatically adjusts
+       * based on the available width and the specified page width.
+       *
+       * When this option is enabled, the carousel dynamically calculates and displays as many items as can fit
+       * within the viewport while adhering to the `minPageWidth` constraint.
+       *
+       * **Note:** Enabling this option overrides the `visiblePagesCount` property and disables the `loop` functionality
+       * of the carousel.
+       *
+       * Default value is `false`.
+       *
+       *
+       * @returns Value of property `responsive`
+       */
+      getResponsive(): boolean;
       /**
        * Gets current value of property {@link #getScrollMode scrollMode}.
        *
@@ -59772,15 +59861,66 @@ declare namespace sap {
        * Defines how many pages are displayed in the visible area of the `Carousel` control. Value should be a
        * positive number.
        *
-       * **Note:** When this property is set to something different than the default value, the `loop` property
+       * **Note:** When this property is set to something different from the default value, the `loop` property
        * of `Carousel` is ignored.
        *
+       * **Note:** This property is ignored when the `responsive` property is set to `true`.
+       *
        * Default value is `1`.
        *
        *
        * @returns Value of property `visiblePagesCount`
        */
       getVisiblePagesCount(): int;
+      /**
+       * Sets a new value for property {@link #getMinPageWidth minPageWidth}.
+       *
+       * Defines the minimum width, in pixels, for each page to be displayed in the `Carousel` control.
+       *
+       * This property is used as a constraint when `responsive` mode is enabled, ensuring that pages are never
+       * rendered smaller than this specified width. The carousel automatically calculates the number of pages
+       * that can fit within the available viewport while respecting the specified minimum width requirement.
+       *
+       * **Note:** This property is only effective when the `responsive` property is set to `true`.
+       *
+       * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+       *
+       * Default value is `148`.
+       *
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      setMinPageWidth(
+        /**
+         * New value for property `minPageWidth`
+         */
+        iMinPageWidth?: int
+      ): this;
+      /**
+       * Sets a new value for property {@link #getResponsive responsive}.
+       *
+       * Activates the responsive layout mode, where the number of visible carousel pages automatically adjusts
+       * based on the available width and the specified page width.
+       *
+       * When this option is enabled, the carousel dynamically calculates and displays as many items as can fit
+       * within the viewport while adhering to the `minPageWidth` constraint.
+       *
+       * **Note:** Enabling this option overrides the `visiblePagesCount` property and disables the `loop` functionality
+       * of the carousel.
+       *
+       * 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
+       */
+      setResponsive(
+        /**
+         * New value for property `responsive`
+         */
+        bResponsive?: boolean
+      ): this;
       /**
        * Sets a new value for property {@link #getScrollMode scrollMode}.
        *
@@ -59810,9 +59950,11 @@ declare namespace sap {
        * Defines how many pages are displayed in the visible area of the `Carousel` control. Value should be a
        * positive number.
        *
-       * **Note:** When this property is set to something different than the default value, the `loop` property
+       * **Note:** When this property is set to something different from the default value, the `loop` property
        * of `Carousel` is ignored.
        *
+       * **Note:** This property is ignored when the `responsive` property is set to `true`.
+       *
        * When called with a value of `null` or `undefined`, the default value of the property will be restored.
        *
        * Default value is `1`.
@@ -75550,6 +75692,7 @@ declare namespace sap {
        * 	 - `strong`
        * 	 - `span`
        * 	 - `u`
+       * 	 - `s`
        * 	 - `dl`
        * 	 - `dt`
        * 	 - `dd`
@@ -79790,8 +79933,7 @@ declare namespace sap {
        *
        * Default value is `Auto`.
        *
-       * @experimental As of version 1.121. Disclaimer: this property is in a beta state - incompatible API changes
-       * may be done before its official public release. Use at your own discretion.
+       * @experimental As of version 1.121.
        *
        * @returns Value of property `interactionMode`
        */
@@ -80094,8 +80236,7 @@ declare namespace sap {
        *
        * Default value is `Auto`.
        *
-       * @experimental As of version 1.121. Disclaimer: this property is in a beta state - incompatible API changes
-       * may be done before its official public release. Use at your own discretion.
+       * @experimental As of version 1.121.
        *
        * @returns Reference to `this` in order to allow method chaining
        */
@@ -92810,6 +92951,55 @@ declare namespace sap {
          */
         oListener?: object
       ): this;
+      /**
+       * Attaches event handler `fnFunction` to the {@link #event:open open} event of this `sap.m.Menu`.
+       *
+       * 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.m.Menu` itself.
+       *
+       * Fired when the menu is opened.
+       *
+       * @since 1.146
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      attachOpen(
+        /**
+         * 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.m.Menu` itself
+         */
+        oListener?: object
+      ): this;
+      /**
+       * Attaches event handler `fnFunction` to the {@link #event:open open} event of this `sap.m.Menu`.
+       *
+       * 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.m.Menu` itself.
+       *
+       * Fired when the menu is opened.
+       *
+       * @since 1.146
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      attachOpen(
+        /**
+         * 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.m.Menu` itself
+         */
+        oListener?: object
+      ): this;
       /**
        * Binds aggregation {@link #getItems items} to model data.
        *
@@ -92899,6 +93089,25 @@ declare namespace sap {
          */
         oListener?: object
       ): this;
+      /**
+       * Detaches event handler `fnFunction` from the {@link #event:open open} event of this `sap.m.Menu`.
+       *
+       * 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
+       */
+      detachOpen(
+        /**
+         * 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;
       /**
        * Fires event {@link #event:beforeClose beforeClose} to attached listeners.
        *
@@ -92942,6 +93151,20 @@ declare namespace sap {
          */
         mParameters?: sap.m.Menu$ItemSelectedEventParameters
       ): this;
+      /**
+       * Fires event {@link #event:open open} 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
+       */
+      fireOpen(
+        /**
+         * Parameters to pass along with the event
+         */
+        mParameters?: object
+      ): this;
       /**
        * Gets content of aggregation {@link #getItems items}.
        *
@@ -146535,8 +146758,7 @@ declare namespace sap {
       /**
        * Gets current value of property {@link #getAlternateRowColors alternateRowColors}.
        *
-       * Enables alternating table row colors. **Note:** This property can only be used with the Belize and Belize
-       * Deep themes. Alternate row coloring is not available for the High Contrast Black/White themes.
+       * Enables alternating table row colors.
        *
        * Default value is `false`.
        *
@@ -146759,8 +146981,7 @@ declare namespace sap {
       /**
        * Sets a new value for property {@link #getAlternateRowColors alternateRowColors}.
        *
-       * Enables alternating table row colors. **Note:** This property can only be used with the Belize and Belize
-       * Deep themes. Alternate row coloring is not available for the High Contrast Black/White themes.
+       * Enables alternating table row colors.
        *
        * When called with a value of `null` or `undefined`, the default value of the property will be restored.
        *
@@ -160551,6 +160772,53 @@ declare namespace sap {
          */
         oListener?: object
       ): this;
+      /**
+       * Attaches event handler `fnFunction` to the {@link #event:manageOpen manageOpen} event of this `sap.m.VariantManagement`.
+       *
+       * 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.m.VariantManagement` itself.
+       *
+       * This event is fired when users opens the Manage Views dialog.
+       *
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      attachManageOpen(
+        /**
+         * 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.m.VariantManagement` itself
+         */
+        oListener?: object
+      ): this;
+      /**
+       * Attaches event handler `fnFunction` to the {@link #event:manageOpen manageOpen} event of this `sap.m.VariantManagement`.
+       *
+       * 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.m.VariantManagement` itself.
+       *
+       * This event is fired when users opens the Manage Views dialog.
+       *
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      attachManageOpen(
+        /**
+         * 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.m.VariantManagement` itself
+         */
+        oListener?: object
+      ): this;
       /**
        * Attaches event handler `fnFunction` to the {@link #event:save save} event of this `sap.m.VariantManagement`.
        *
@@ -160706,6 +160974,24 @@ declare namespace sap {
          */
         oListener?: object
       ): this;
+      /**
+       * Detaches event handler `fnFunction` from the {@link #event:manageOpen manageOpen} event of this `sap.m.VariantManagement`.
+       *
+       * The passed function and listener object must match the ones used for event registration.
+       *
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      detachManageOpen(
+        /**
+         * 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:save save} event of this `sap.m.VariantManagement`.
        *
@@ -160781,6 +161067,19 @@ declare namespace sap {
          */
         mParameters?: object
       ): this;
+      /**
+       * Fires event {@link #event:manageOpen manageOpen} to attached listeners.
+       *
+       * @ui5-protected Do not call from applications (only from related classes in the framework)
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      fireManageOpen(
+        /**
+         * Parameters to pass along with the event
+         */
+        mParameters?: object
+      ): this;
       /**
        * Fires event {@link #event:save save} to attached listeners.
        *
@@ -167426,8 +167725,6 @@ declare namespace sap {
        * feature works under the Browser's Cross-Origin Resource Sharing (CORS) policy. This means that a web
        * application using those APIs can only request resources from the same origin the application was loaded
        * from unless the response from other origins includes the right CORS headers.
-       *
-       * @experimental As of version 1.106.
        */
       InlineSvg = "InlineSvg",
     }
@@ -170608,6 +170905,11 @@ declare namespace sap {
       Menu
     >;
 
+    /**
+     * Event object of the Menu#open event.
+     */
+    type Menu$OpenEvent = sap.ui.base.Event<Menu$OpenEventParameters, Menu>;
+
     /**
      * Event object of the MenuButton#beforeMenuOpen event.
      */
@@ -172219,6 +172521,14 @@ declare namespace sap {
       VariantManagement
     >;
 
+    /**
+     * Event object of the VariantManagement#manageOpen event.
+     */
+    type VariantManagement$ManageOpenEvent = sap.ui.base.Event<
+      VariantManagement$ManageOpenEventParameters,
+      VariantManagement
+    >;
+
     /**
      * Event object of the VariantManagement#save event.
      */

package/types/sap.tnt.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.145.0
+// For Library Version: 1.146.0
 
 declare namespace sap {
   /**
@@ -207,8 +207,6 @@ declare namespace sap {
        * 	 - Items that trigger actions (with design "Action") should not be selectable.
        *
        * @since 1.116
-       * @experimental As of version 1.116. Disclaimer: this property is in a beta state - incompatible API changes
-       * may be done before its official public release.
        */
       selectable?:
         | boolean
@@ -242,7 +240,6 @@ declare namespace sap {
        * sub-items cannot be added.
        *
        * @since 1.133.0
-       * @experimental Behavior might change.
        */
       design?:
         | sap.tnt.NavigationListItemDesign
@@ -1736,7 +1733,6 @@ declare namespace sap {
        * Default value is `Default`.
        *
        * @since 1.133.0
-       * @experimental Behavior might change.
        *
        * @returns Value of property `design`
        */
@@ -1788,8 +1784,6 @@ declare namespace sap {
        * Default value is `true`.
        *
        * @since 1.116
-       * @experimental As of version 1.116. Disclaimer: this property is in a beta state - incompatible API changes
-       * may be done before its official public release.
        *
        * @returns Value of property `selectable`
        */
@@ -1905,7 +1899,6 @@ declare namespace sap {
        * Default value is `Default`.
        *
        * @since 1.133.0
-       * @experimental Behavior might change.
        *
        * @returns Reference to `this` in order to allow method chaining
        */
@@ -1972,8 +1965,6 @@ declare namespace sap {
        * Default value is `true`.
        *
        * @since 1.116
-       * @experimental As of version 1.116. Disclaimer: this property is in a beta state - incompatible API changes
-       * may be done before its official public release.
        *
        * @returns Reference to `this` in order to allow method chaining
        */
@@ -2788,10 +2779,14 @@ declare namespace sap {
      * 	 - If an app implements side navigation in addition to the tool header menu, the menu icon must be the
      *     first item on the left-hand side of the tool header.
      * 	 - The app menu and the side navigation must not have any dependencies and must work independently.
-     *      Horizon theme specifics: Only the following controls are supported: sap.m.Button, sap.m.Image,
-     *     sap.m.Title, sap.m.Text, sap.m.SearchField, sap.m.Avatar. Fiori 3 theme specifics: In Fiori 3 Default
-     *     theme the ToolHeader is with dark design unlike most of the other controls. This defines the usage of
-     *     limited controls inside it, which will result in good design combination.
+     *
+     * 	 - Not recommended: In accordance with the UX Consistency initiative, it is recommended to use the seamlessly
+     *     integrated UI5 Web Components' ui5-shellbar, as demonstrated in this UXC
+     *     integration sample app with UXC integration
+     *     sample source code.  Horizon theme specifics: Only the following controls are supported: sap.m.Button,
+     *     sap.m.Image, sap.m.Title, sap.m.Text, sap.m.SearchField, sap.m.Avatar. Fiori 3 theme specifics: In Fiori
+     *     3 Default theme the ToolHeader is with dark design unlike most of the other controls. This defines the
+     *     usage of limited controls inside it, which will result in good design combination.
      *  The ToolHeader stylizes the contained controls with the Shell color parameters, to match the dark design
      * requirement. However, that's not a dark theme.
      *
@@ -3452,7 +3447,6 @@ declare namespace sap {
      * This enum is part of the 'sap/tnt/library' module export and must be accessed by the property 'NavigationListItemDesign'.
      *
      * @since 1.133.0
-     * @experimental Behavior might change.
      */
     enum NavigationListItemDesign {
       /**
@@ -3485,7 +3479,6 @@ declare namespace sap {
      * This enum is part of the 'sap/tnt/library' module export and must be accessed by the property 'SideNavigationDesign'.
      *
      * @since 1.134.0
-     * @experimental Behavior might change.
      */
     enum SideNavigationDesign {
       /**

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

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

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

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