@openui5/ts-types 1.117.1 → 1.119.0

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

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

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.117.1
+// For Library Version: 1.119.0
 
 declare namespace sap {
   namespace ui {
@@ -5444,25 +5444,6 @@ declare namespace sap {
              */
             sSecondaryCalendarType: sap.ui.core.CalendarType
           ): this;
-          /**
-           * @deprecated (since 1.34.0) - replaced by `date` property
-           *
-           * Sets a new value for property {@link #getYear year}.
-           *
-           * The year is initial focused and selected The value must be between 0 and 9999
-           *
-           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
-           *
-           * Default value is `2000`.
-           *
-           * @returns Reference to `this` in order to allow method chaining
-           */
-          setYear(
-            /**
-             * New value for property `year`
-             */
-            iYear?: int
-          ): this;
           /**
            * @since 1.30.0
            *

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

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

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.117.1
+// For Library Version: 1.119.0
 
 declare namespace sap {
   namespace ui {
@@ -16,10 +16,20 @@ declare namespace sap {
        * UI5 library: sap.ui.webc.common
        */
       namespace common {
-        interface $WebComponentSettings extends sap.ui.core.$ControlSettings {}
+        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.
+           */
+          type MetadataOptions = sap.ui.core.webc.WebComponent.MetadataOptions;
+        }
+
+        interface $WebComponentSettings
+          extends sap.ui.core.webc.$WebComponentSettings {}
 
         /**
          * @since 1.92.0
+         * @deprecated (since 1.118.0) - Use sap.ui.core.webc.WebComponent instead!
          * @experimental (since 1.92.0) - The API might change. It is not intended for productive usage yet!
          *
          * Base Class for Web Components. Web Components are agnostic UI elements which can be integrated into the
@@ -27,27 +37,76 @@ declare namespace sap {
          * 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.
          */
-        class WebComponent extends sap.ui.core.Control {
+        class WebComponent extends sap.ui.core.webc.WebComponent {
           /**
            * Constructs and initializes a Web Component Wrapper with the given `sId` and settings.
-           *
-           * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
-           * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
-           * of the syntax of the settings object.
            */
-          constructor();
+          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
+          );
 
           /**
-           * Creates a new subclass of class sap.ui.webc.common.WebComponent with name `sClassName` and enriches it
-           * with the information contained in `oClassInfo`.
+           * 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'
+           *       }
+           *     }
+           *   }
+           * });
+           * ```
            *
-           * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.core.Control.extend}.
            *
            * @returns Created class / constructor function
            */
           static extend<T extends Record<string, unknown>>(
             /**
-             * Name of the class being created
+             * Name of the class to be created
              */
             sClassName: string,
             /**
@@ -55,8 +114,7 @@ declare namespace sap {
              */
             oClassInfo?: sap.ClassInfo<T, sap.ui.webc.common.WebComponent>,
             /**
-             * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
-             * used by this class
+             * Constructor function for the metadata object. If not given, it defaults to `sap.ui.core.ElementMetadata`.
              */
             FNMetaImpl?: Function
           ): Function;
@@ -69,9 +127,11 @@ declare namespace sap {
         }
         /**
          * @since 1.92.0
+         * @deprecated (since 1.118.0) - Use sap.ui.core.webc.WebComponentMetadata instead!
          * @experimental (since 1.92.0) - The API might change. It is not intended for productive usage yet!
          */
-        class WebComponentMetadata extends sap.ui.core.ElementMetadata {
+        class WebComponentMetadata extends sap.ui.core.webc
+          .WebComponentMetadata {
           /**
            * Creates a new metadata object for a WebComponent Wrapper subclass.
            */
@@ -85,24 +145,6 @@ declare namespace sap {
              */
             oClassInfo: object
           );
-
-          /**
-           * Returns the list of public getters, proxied by the Component Wrapper to the component itself
-           */
-          getGetters(): any[];
-          /**
-           * Returns the list of public methods, proxied by the Component Wrapper to the component itself
-           */
-          getMethods(): any[];
-          /**
-           * Retrieves the renderer for the described web component class. Note: this is always the default renderer
-           * and Web Component wrappers should not define their own renderers.
-           */
-          getRenderer(): void;
-          /**
-           * Returns the tag, used to render the Component Wrapper
-           */
-          getTag(): string;
         }
       }
     }