@sapui5/ts-types 1.146.0 → 1.147.0

package/types/sap.ushell_abap.d.ts

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

package/types/sap.uxap.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare namespace sap {
   /**
@@ -1080,6 +1080,16 @@ declare namespace sap {
       subSectionVisibilityChange?: (
         oEvent: ObjectPageLayout$SubSectionVisibilityChangeEvent
       ) => void;
+
+      /**
+       * Fired when the media range of the control changes, allowing the application to adjust the UI accordingly
+       * (e.g., change Avatar sizes responsively).
+       *
+       * @since 1.147
+       */
+      breakpointChange?: (
+        oEvent: ObjectPageLayout$BreakpointChangeEvent
+      ) => void;
     }
 
     /**
@@ -1387,6 +1397,21 @@ declare namespace sap {
       subSection?: sap.uxap.ObjectPageSubSection;
     }
 
+    /**
+     * Parameters of the ObjectPageLayout#breakpointChange event.
+     */
+    interface ObjectPageLayout$BreakpointChangeEventParameters {
+      /**
+       * The name of the current media range ("Phone", "Tablet", "Desktop", or "DesktopExtraLarge").
+       */
+      currentRange?: sap.uxap.ObjectPageLayoutMediaRange;
+
+      /**
+       * The current width of the control in pixels.
+       */
+      currentWidth?: int;
+    }
+
     /**
      * Parameters of the ObjectPageLayout#editHeaderButtonPress event.
      */
@@ -5174,6 +5199,59 @@ declare namespace sap {
          */
         oListener?: object
       ): this;
+      /**
+       * Attaches event handler `fnFunction` to the {@link #event:breakpointChange breakpointChange} event of
+       * this `sap.uxap.ObjectPageLayout`.
+       *
+       * 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.uxap.ObjectPageLayout` itself.
+       *
+       * Fired when the media range of the control changes, allowing the application to adjust the UI accordingly
+       * (e.g., change Avatar sizes responsively).
+       *
+       * @since 1.147
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      attachBreakpointChange(
+        /**
+         * 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: ObjectPageLayout$BreakpointChangeEvent) => void,
+        /**
+         * Context object to call the event handler with. Defaults to this `sap.uxap.ObjectPageLayout` itself
+         */
+        oListener?: object
+      ): this;
+      /**
+       * Attaches event handler `fnFunction` to the {@link #event:breakpointChange breakpointChange} event of
+       * this `sap.uxap.ObjectPageLayout`.
+       *
+       * 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.uxap.ObjectPageLayout` itself.
+       *
+       * Fired when the media range of the control changes, allowing the application to adjust the UI accordingly
+       * (e.g., change Avatar sizes responsively).
+       *
+       * @since 1.147
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      attachBreakpointChange(
+        /**
+         * The function to be called when the event occurs
+         */
+        fnFunction: (p1: ObjectPageLayout$BreakpointChangeEvent) => void,
+        /**
+         * Context object to call the event handler with. Defaults to this `sap.uxap.ObjectPageLayout` itself
+         */
+        oListener?: object
+      ): this;
       /**
        * Attaches event handler `fnFunction` to the {@link #event:editHeaderButtonPress editHeaderButtonPress }
        * event of this `sap.uxap.ObjectPageLayout`.
@@ -5537,6 +5615,26 @@ declare namespace sap {
          */
         oListener?: object
       ): this;
+      /**
+       * Detaches event handler `fnFunction` from the {@link #event:breakpointChange breakpointChange} event of
+       * this `sap.uxap.ObjectPageLayout`.
+       *
+       * The passed function and listener object must match the ones used for event registration.
+       *
+       * @since 1.147
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      detachBreakpointChange(
+        /**
+         * The function to be called, when the event occurs
+         */
+        fnFunction: (p1: ObjectPageLayout$BreakpointChangeEvent) => void,
+        /**
+         * Context object on which the given function had to be called
+         */
+        oListener?: object
+      ): this;
       /**
        * Detaches event handler `fnFunction` from the {@link #event:editHeaderButtonPress editHeaderButtonPress }
        * event of this `sap.uxap.ObjectPageLayout`.
@@ -5675,6 +5773,20 @@ declare namespace sap {
          */
         mParameters?: sap.uxap.ObjectPageLayout$BeforeNavigateEventParameters
       ): boolean;
+      /**
+       * Fires event {@link #event:breakpointChange breakpointChange} to attached listeners.
+       *
+       * @since 1.147
+       * @ui5-protected Do not call from applications (only from related classes in the framework)
+       *
+       * @returns Reference to `this` in order to allow method chaining
+       */
+      fireBreakpointChange(
+        /**
+         * Parameters to pass along with the event
+         */
+        mParameters?: sap.uxap.ObjectPageLayout$BreakpointChangeEventParameters
+      ): this;
       /**
        * Fires event {@link #event:editHeaderButtonPress editHeaderButtonPress} to attached listeners.
        *
@@ -8090,6 +8202,31 @@ declare namespace sap {
        */
       Square = "Square",
     }
+    /**
+     * Defines the media breakpoints for ObjectPageLayout.
+     *
+     * This enum is part of the 'sap/uxap/library' module export and must be accessed by the property 'ObjectPageLayoutMediaRange'.
+     *
+     * @since 1.147
+     */
+    enum ObjectPageLayoutMediaRange {
+      /**
+       * Desktop breakpoint (1025px to 1439px).
+       */
+      Desktop = "Desktop",
+      /**
+       * Extra large desktop breakpoint (1440px and above).
+       */
+      DesktopExtraLarge = "DesktopExtraLarge",
+      /**
+       * Phone breakpoint (up to 600px).
+       */
+      Phone = "Phone",
+      /**
+       * Tablet breakpoint (601px to 1024px).
+       */
+      Tablet = "Tablet",
+    }
     /**
      * Used by the `ObjectPagSubSection` control to define which layout to apply.
      *
@@ -8168,6 +8305,14 @@ declare namespace sap {
       ObjectPageLayout
     >;
 
+    /**
+     * Event object of the ObjectPageLayout#breakpointChange event.
+     */
+    type ObjectPageLayout$BreakpointChangeEvent = sap.ui.base.Event<
+      ObjectPageLayout$BreakpointChangeEventParameters,
+      ObjectPageLayout
+    >;
+
     /**
      * Event object of the ObjectPageLayout#editHeaderButtonPress event.
      */

package/types/sap.viz.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare namespace sap {
   /**
@@ -612,7 +612,7 @@ declare namespace sap {
         /**
          * Describes the settings that can be provided to the Popover constructor.
          *
-         * @experimental As of version 1.22.0. API is not finished yet and might change completely
+         * @experimental As of version 1.22.
          */
         interface $PopoverSettings
           extends sap.viz.ui5.controls.common.$BaseControlSettings {
@@ -871,8 +871,7 @@ declare namespace sap {
         /**
          * Viz Chart Popover
          *
-         * @since 1.22.0
-         * @experimental As of version 1.22.0. API is not finished yet and might change completely
+         * @experimental As of version 1.22.
          */
         class Popover extends sap.viz.ui5.controls.common.BaseControl {
           /**
@@ -3795,7 +3794,7 @@ declare namespace sap {
            * ```
            *
            *
-           * @experimental As of version 1.16.6. Might later be integrated into the selectData event.
+           * @experimental As of version 1.16.
            *
            * @returns the model context for the given criteria or undefined.
            */

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

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

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

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

package/types/sap.zen.crosstab.d.ts

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

package/types/sap.zen.dsh.d.ts

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

package/types/sap.ui.webc.common.d.ts

@@ -1,173 +0,0 @@
-// For Library Version: 1.146.0
-
-declare namespace sap {
-  namespace ui {
-    /**
-     * Namespace for UI5 Web Components Retrofit libraries
-     *
-     * @since 1.92.0
-     * @deprecated As of version 1.120. this Web Components consumption model has been discarded. An alternative
-     * consumption model is planned for the future.
-     * @experimental As of version 1.92.0.
-     */
-    namespace webc {
-      /**
-       * UI5 library: sap.ui.webc.common
-       *
-       * @since 1.92.0
-       * @deprecated As of version 1.120. this Web Components consumption model has been discarded. An alternative
-       * consumption model is planned for the future.
-       * @experimental As of version 1.92.0.
-       */
-      namespace common {
-        namespace WebComponent {
-          /**
-           * The structure of the "metadata" object which is passed when inheriting from sap.ui.core.Element using
-           * its static "extend" method. See {@link sap.ui.core.Element.extend} for details on its usage.
-           *
-           * @deprecated As of version 1.118.0. because it is part of the deprecated package sap.ui.webc.common.WebComponent
-           */
-          type MetadataOptions = sap.ui.core.webc.WebComponent.MetadataOptions;
-        }
-        /**
-         * Describes the settings that can be provided to the WebComponent constructor.
-         *
-         * @deprecated As of version 1.118.0. Use sap.ui.core.webc.WebComponent instead!
-         * @experimental As of version 1.92.0. The API might change. It is not intended for productive usage yet!
-         */
-        interface $WebComponentSettings
-          extends sap.ui.core.webc.$WebComponentSettings {}
-
-        /**
-         * Base Class for Web Components. Web Components are agnostic UI elements which can be integrated into the
-         * UI5 programming model by using this wrapper control. This wrapper control takes care to propagate the
-         * properties, the aggregations and the events. It also ensures to render the control and put the aggregated
-         * controls in the dedicated slots of the Web Component.
-         *
-         * @since 1.92.0
-         * @deprecated As of version 1.118.0. Use sap.ui.core.webc.WebComponent instead!
-         * @experimental As of version 1.92.0. The API might change. It is not intended for productive usage yet!
-         */
-        class WebComponent extends sap.ui.core.webc.WebComponent {
-          /**
-           * Constructs and initializes a Web Component Wrapper with the given `sId` and settings.
-           */
-          constructor(
-            /**
-             * Object with initial settings for the new control
-             */
-            mSettings?: sap.ui.webc.common.$WebComponentSettings
-          );
-          /**
-           * Constructs and initializes a Web Component Wrapper with the given `sId` and settings.
-           */
-          constructor(
-            /**
-             * Optional ID for the new control; generated automatically if no non-empty ID is given Note: this can be
-             * omitted, no matter whether `mSettings` will be given or not!
-             */
-            sId?: string,
-            /**
-             * Object with initial settings for the new control
-             */
-            mSettings?: sap.ui.webc.common.$WebComponentSettings
-          );
-
-          /**
-           * Defines a new subclass of WebComponent with the name `sClassName` and enriches it with the information
-           * contained in `oClassInfo`.
-           *
-           * `oClassInfo` can contain the same information that {@link sap.ui.base.ManagedObject.extend} already accepts,
-           * plus the `dnd` property in the metadata object literal to configure drag-and-drop behavior (see {@link sap.ui.core.webc.WebComponent.MetadataOptions MetadataOptions }
-           * for details). Objects describing aggregations can also have a `dnd` property when used for a class extending
-           * `WebComponent` (see {@link sap.ui.base.ManagedObject.MetadataOptions.AggregationDnD AggregationDnD}).
-           *
-           * Example:
-           * ```javascript
-           *
-           * WebComponent.extend('sap.mylib.MyElement', {
-           *   metadata : {
-           *     library : 'sap.mylib',
-           *     tag : 'my-webcomponent',
-           *     properties : {
-           *       value : 'string',
-           *       width : {
-           *         type: 'sap.ui.core.CSSSize',
-           *         mapping: 'style'
-           *       }
-           *     },
-           *     defaultAggregation: "content",
-           *     aggregations : {
-           *       content : {
-           *         type: 'sap.ui.core.Control',
-           *         multiple : true
-           *       },
-           *       header : {
-           *         type : 'sap.ui.core.Control',
-           *         multiple : false,
-           *         slot: 'header'
-           *       }
-           *     }
-           *   }
-           * });
-           * ```
-           *
-           *
-           *
-           * @returns Created class / constructor function
-           */
-          static extend<T extends Record<string, unknown>>(
-            /**
-             * Name of the class to be created
-             */
-            sClassName: string,
-            /**
-             * Object literal with information about the class
-             */
-            oClassInfo?: sap.ClassInfo<T, sap.ui.webc.common.WebComponent>,
-            /**
-             * Constructor function for the metadata object. If not given, it defaults to `sap.ui.core.ElementMetadata`.
-             */
-            FNMetaImpl?: Function
-          ): Function;
-          /**
-           * Returns a metadata object for class sap.ui.webc.common.WebComponent.
-           *
-           *
-           * @returns Metadata object describing this class
-           */
-          static getMetadata(): sap.ui.webc.common.WebComponentMetadata;
-        }
-        /**
-         * @since 1.92.0
-         * @deprecated As of version 1.118.0. Use sap.ui.core.webc.WebComponentMetadata instead!
-         * @experimental As of version 1.92.0. The API might change. It is not intended for productive usage yet!
-         */
-        class WebComponentMetadata extends sap.ui.core.webc
-          .WebComponentMetadata {
-          /**
-           * Creates a new metadata object for a WebComponent Wrapper subclass.
-           */
-          constructor(
-            /**
-             * fully qualified name of the class that is described by this metadata object
-             */
-            sClassName: string,
-            /**
-             * static info to construct the metadata from
-             */
-            oClassInfo: object
-          );
-        }
-      }
-    }
-  }
-
-  interface IUI5DefineDependencyNames {
-    "sap/ui/webc/common/library": undefined;
-
-    "sap/ui/webc/common/WebComponent": undefined;
-
-    "sap/ui/webc/common/WebComponentMetadata": undefined;
-  }
-}