@sapui5/ts-types-esm 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 module "sap/uxap/library" {
   /**
@@ -136,6 +136,31 @@ declare module "sap/uxap/library" {
      */
     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
+   */
+  export 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.
    *
@@ -4504,7 +4529,11 @@ declare module "sap/uxap/ObjectPageLayout" {
 
   import { BackgroundDesign, IBar } from "sap/m/library";
 
-  import { IHeaderTitle, ObjectPageSubSectionLayout } from "sap/uxap/library";
+  import {
+    IHeaderTitle,
+    ObjectPageSubSectionLayout,
+    ObjectPageLayoutMediaRange,
+  } from "sap/uxap/library";
 
   import { CSSSize, TitleLevel, ID } from "sap/ui/core/library";
 
@@ -4720,6 +4749,59 @@ declare module "sap/uxap/ObjectPageLayout" {
        */
       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`.
@@ -5083,6 +5165,26 @@ declare module "sap/uxap/ObjectPageLayout" {
        */
       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`.
@@ -5221,6 +5323,20 @@ declare module "sap/uxap/ObjectPageLayout" {
        */
       mParameters?: 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?: ObjectPageLayout$BreakpointChangeEventParameters
+    ): this;
     /**
      * Fires event {@link #event:editHeaderButtonPress editHeaderButtonPress} to attached listeners.
      *
@@ -6665,6 +6781,14 @@ declare module "sap/uxap/ObjectPageLayout" {
     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;
   }
 
   /**
@@ -6690,6 +6814,31 @@ declare module "sap/uxap/ObjectPageLayout" {
     ObjectPageLayout
   >;
 
+  /**
+   * Parameters of the ObjectPageLayout#breakpointChange event.
+   */
+  export interface ObjectPageLayout$BreakpointChangeEventParameters {
+    /**
+     * The name of the current media range ("Phone", "Tablet", "Desktop", or "DesktopExtraLarge").
+     */
+    currentRange?:
+      | ObjectPageLayoutMediaRange
+      | keyof typeof ObjectPageLayoutMediaRange;
+
+    /**
+     * The current width of the control in pixels.
+     */
+    currentWidth?: int;
+  }
+
+  /**
+   * Event object of the ObjectPageLayout#breakpointChange event.
+   */
+  export type ObjectPageLayout$BreakpointChangeEvent = Event<
+    ObjectPageLayout$BreakpointChangeEventParameters,
+    ObjectPageLayout
+  >;
+
   /**
    * Parameters 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 module "sap/viz/library" {
   export namespace ui5 {
@@ -9282,8 +9282,7 @@ declare module "sap/viz/ui5/controls/Popover" {
   /**
    * 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.
    */
   export default class Popover extends BaseControl {
     /**
@@ -9475,7 +9474,7 @@ declare module "sap/viz/ui5/controls/Popover" {
   /**
    * 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.
    */
   export interface $PopoverSettings extends $BaseControlSettings {
     /**
@@ -12361,7 +12360,7 @@ declare module "sap/viz/ui5/data/FlattenedDataset" {
      * ```
      *
      *
-     * @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 module "sap/zen/commons/library" {}
 

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare module "sap/zen/crosstab/library" {}
 

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.146.0
+// For Library Version: 1.147.0
 
 declare module "sap/zen/dsh/library" {}
 

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

@@ -1,164 +0,0 @@
-// For Library Version: 1.146.0
-
-declare module "sap/ui/webc/common/library" {}
-
-declare module "sap/ui/webc/common/WebComponent" {
-  import {
-    default as WebComponent1,
-    MetadataOptions as MetadataOptions1,
-    $WebComponentSettings as $WebComponentSettings1,
-  } from "sap/ui/core/webc/WebComponent";
-
-  import WebComponentMetadata from "sap/ui/webc/common/WebComponentMetadata";
-
-  /**
-   * 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!
-   */
-  export default class WebComponent extends WebComponent1 {
-    /**
-     * Constructs and initializes a Web Component Wrapper with the given `sId` and settings.
-     */
-    constructor(
-      /**
-       * Object with initial settings for the new control
-       */
-      mSettings?: $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?: $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, 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(): WebComponentMetadata;
-  }
-  /**
-   * 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
-   */
-  export type MetadataOptions = MetadataOptions1;
-
-  /**
-   * 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!
-   */
-  export interface $WebComponentSettings extends $WebComponentSettings1 {}
-}
-
-declare module "sap/ui/webc/common/WebComponentMetadata" {
-  import WebComponentMetadata1 from "sap/ui/core/webc/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!
-   */
-  export default class WebComponentMetadata extends WebComponentMetadata1 {
-    /**
-     * 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
-    );
-  }
-}
-
-declare namespace sap {
-  interface IUI5DefineDependencyNames {
-    "sap/ui/webc/common/library": undefined;
-
-    "sap/ui/webc/common/WebComponent": undefined;
-
-    "sap/ui/webc/common/WebComponentMetadata": undefined;
-  }
-}