@sapui5/ts-types 1.147.2 → 1.148.0

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.147.1
+// For Library Version: 1.148.0
 
 declare namespace sap {
   namespace ui {
@@ -21160,6 +21160,14 @@ declare namespace sap {
            * @returns Value of property `defaultSelectionVariantName`
            */
           getDefaultSelectionVariantName(): string;
+          /**
+           * Returns the currently configured default values as a map of property names to condition ranges.
+           *
+           * @since 1.148
+           *
+           * @returns Map of property names to their condition ranges
+           */
+          getDefaultValues(): Object;
           /**
            * Reads the descriptions for given filters and value keys.
            *
@@ -21708,6 +21716,38 @@ declare namespace sap {
              */
             sDefaultSelectionVariantName?: string
           ): this;
+          /**
+           * Configures which filter fields support the DefaultValues operation and sets their predefined conditions.
+           * Only the listed fields will have DefaultValues support enabled. Can be called before the SmartFilterBar
+           * is initialized; the configuration will be applied once initialization completes.
+           *
+           * @since 1.148
+           */
+          setDefaultValues(
+            /**
+             * Map of property names to their condition ranges, e.g.
+             * ```javascript
+             *
+             * {
+             *   "Field1": [
+             *     { Sign: "I", Option: "EQ", Low: "value", High: null }
+             *   ],
+             *   "Field2": [
+             *     { Sign: "I", Option: "BT", Low: "low", High: "high" }
+             *   ]
+             * }
+             * ```
+             *  Each key is a filter field property name. Each value is an array of condition objects with:
+             * 	 - `Sign` - "I" (include) or "E" (exclude)
+             * 	 - `Option` - Operator such as "EQ", "BT", "CP", "GT", "LT", etc.
+             * 	 - `Low` - The low value of the condition
+             * 	 - `High` - The high value (used with "BT" operator, otherwise `null`)
+             */
+            oFieldConditions: Record<
+              string,
+              /* was: sap.ui.comp.smartfilterbar.SelectOptionType */ any[]
+            >
+          ): void;
           /**
            * Sets a new value for property {@link #getEnableBasicSearch enableBasicSearch}.
            *
@@ -31538,6 +31578,21 @@ declare namespace sap {
             | sap.ui.base.ManagedObject.PropertyBindingInfo
             | `{${string}}`;
 
+          /**
+           * Defines default values shown in the export dialog.
+           *
+           * Configure default values that are displayed in the export dialog. For example, the `fileName` property
+           * of {@link sap.ui.export.TableExportSettings} defines the default file name shown in the export dialog.
+           * If not specified, the table header is used.
+           *
+           * **Note:** These values are defaults shown to the user. The user can still modify them before export.
+           * If the user modifies a value in the dialog, the user choice takes precedence and is not overridden by
+           * event handlers.
+           *
+           * @since 1.148
+           */
+          defaultExportSettings?: sap.ui.export.TableExportSettings;
+
           /**
            * A toolbar that can be added by the user to define their own custom buttons, icons, etc. If this is specified,
            * the SmartTable control does not create an additional toolbar, but makes use of this one.
@@ -31814,7 +31869,7 @@ declare namespace sap {
           /**
            * Filter settings that will be contained in the exported file
            */
-          filterSettings?: /* was: sap.ui.export.util.Filter */ any[];
+          filterSettings?: sap.ui.export.util.Filter[];
         }
 
         /**
@@ -32944,6 +32999,14 @@ declare namespace sap {
            * @returns Reference to `this` in order to allow method chaining
            */
           destroyDataStateIndicator(): this;
+          /**
+           * Destroys the defaultExportSettings in the aggregation {@link #getDefaultExportSettings defaultExportSettings}.
+           *
+           * @since 1.148
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          destroyDefaultExportSettings(): this;
           /**
            * Destroys all the filterControlConfiguration in the aggregation {@link #getFilterControlConfiguration filterControlConfiguration}.
            *
@@ -33643,6 +33706,22 @@ declare namespace sap {
            * @returns array of column keys
            */
           getDeactivatedColumns(): string[];
+          /**
+           * Gets content of aggregation {@link #getDefaultExportSettings defaultExportSettings}.
+           *
+           * Defines default values shown in the export dialog.
+           *
+           * Configure default values that are displayed in the export dialog. For example, the `fileName` property
+           * of {@link sap.ui.export.TableExportSettings} defines the default file name shown in the export dialog.
+           * If not specified, the table header is used.
+           *
+           * **Note:** These values are defaults shown to the user. The user can still modify them before export.
+           * If the user modifies a value in the dialog, the user choice takes precedence and is not overridden by
+           * event handlers.
+           *
+           * @since 1.148
+           */
+          getDefaultExportSettings(): sap.ui.export.TableExportSettings;
           /**
            * Gets current value of property {@link #getDemandPopin demandPopin}.
            *
@@ -34583,6 +34662,19 @@ declare namespace sap {
              */
             oDataStateIndicator: sap.m.plugins.DataStateIndicator
           ): this;
+          /**
+           * Sets the aggregated {@link #getDefaultExportSettings defaultExportSettings}.
+           *
+           * @since 1.148
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setDefaultExportSettings(
+            /**
+             * The defaultExportSettings to set
+             */
+            oDefaultExportSettings: sap.ui.export.TableExportSettings
+          ): this;
           /**
            * Sets a new value for property {@link #getDemandPopin demandPopin}.
            *
@@ -34915,10 +35007,10 @@ declare namespace sap {
             sLevel: string
           ): sap.ui.comp.smarttable.SmartTable;
           /**
-           * Sets the value for the `headerSty;e` property.
+           * Sets the value for the `headerStyle` property.
            *
            *
-           * @returns Reference to this in order to allow method chaining
+           * @returns Reference to `this` in order to allow method chaining
            */
           setHeaderStyle(
             /**
@@ -39393,6 +39485,26 @@ declare namespace sap {
             | sap.ui.base.ManagedObject.PropertyBindingInfo
             | `{${string}}`;
 
+          /**
+           * Structure containing field names that use the DefaultValues operation.
+           *
+           *
+           * ```javascript
+           *
+           * {
+           * 	Fields: [
+           * 		{
+           * 			PropertyName: string
+           * 		}
+           * 	]
+           * }
+           * ```
+           */
+          defaultValues?:
+            | object
+            | sap.ui.base.ManagedObject.PropertyBindingInfo
+            | `{${string}}`;
+
           /**
            * Structure containing table related settings. The properties might be related to a specific table type
            * and will be ignored if a different table type is used.
@@ -39466,6 +39578,19 @@ declare namespace sap {
             mSettings?: sap.ui.comp.state.$UIStateSettings
           );
 
+          /**
+           * Scans the filter model data for fields that have a DefaultValues range.
+           *
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
+           *
+           * @returns the defaultValues structure or null
+           */
+          static calcDefaultValues(
+            /**
+             * the filter provider model data
+             */
+            mData: Record<string, any>
+          ): object | null;
           /**
            * Constructs the value state out of a given selection variant and the current model data
            *
@@ -39543,6 +39668,23 @@ declare namespace sap {
              */
             aIgnoreSelOptionNames: Object[]
           ): Record<string, Object[]>;
+          /**
+           * Enriches the internal filter bar value format with DefaultValues skeleton ranges.
+           *
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
+           *
+           * @returns enriched the filter bar inner data format
+           */
+          static enrichWithDefaultValues(
+            /**
+             * the filter bar inner data format
+             */
+            sPayload: string,
+            /**
+             * DefaultValues field information
+             */
+            oDefaultValues: object
+          ): string;
           /**
            * Enriches the internal filter bar value format with the semantic date information.
            *
@@ -39608,6 +39750,28 @@ declare namespace sap {
            * @returns Metadata object describing this class
            */
           static getMetadata(): sap.ui.base.ManagedObjectMetadata;
+          /**
+           * Gets current value of property {@link #getDefaultValues defaultValues}.
+           *
+           * Structure containing field names that use the DefaultValues operation.
+           *
+           *
+           * ```javascript
+           *
+           * {
+           * 	Fields: [
+           * 		{
+           * 			PropertyName: string
+           * 		}
+           * 	]
+           * }
+           * ```
+           *
+           *
+           *
+           * @returns Value of property `defaultValues`
+           */
+          getDefaultValues(): object;
           /**
            * Gets current value of property {@link #getOrderedItems orderedItems}.
            *
@@ -39778,6 +39942,35 @@ declare namespace sap {
            * @returns Value of property `variantName`
            */
           getVariantName(): string;
+          /**
+           * Sets a new value for property {@link #getDefaultValues defaultValues}.
+           *
+           * Structure containing field names that use the DefaultValues operation.
+           *
+           *
+           * ```javascript
+           *
+           * {
+           * 	Fields: [
+           * 		{
+           * 			PropertyName: string
+           * 		}
+           * 	]
+           * }
+           * ```
+           *
+           *
+           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+           *
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setDefaultValues(
+            /**
+             * New value for property `defaultValues`
+             */
+            oDefaultValues: object
+          ): this;
           /**
            * Sets a new value for property {@link #getOrderedItems orderedItems}.
            *

package/types/{core-1.147.0-d.ts → sap.ui.core.d.ts}

@@ -279,7 +279,7 @@ declare namespace sap {
     "sap/ui/thirdparty/qunit-2": undefined;
   }
 }
-// For Library Version: 1.147.0
+// For Library Version: 1.148.0
 
 declare module "sap/base/assert" {
   /**
@@ -2841,6 +2841,30 @@ declare module "sap/base/util/array/uniqueSort" {
   ): any[];
 }
 
+declare module "sap/base/util/clamp" {
+  /**
+   * Returns a value clamped between an upper bound 'max' and lower bound 'min'.
+   *
+   * @since 1.130
+   *
+   * @returns clamped value
+   */
+  export default function clamp(
+    /**
+     * value
+     */
+    val: number,
+    /**
+     * lower bound
+     */
+    min: number,
+    /**
+     * upper bound
+     */
+    max: number
+  ): number;
+}
+
 declare module "sap/base/util/deepClone" {
   /**
    * Creates a deep clone of the source value.
@@ -26456,7 +26480,7 @@ declare namespace sap {
              * The parent route - if a parent route is given, the `routeMatched` event of this route will also trigger
              * the `routeMatched` of the parent and it will also create the view of the parent (if provided).
              */
-            oParent: sap.ui.core.routing.Route
+            oParent?: sap.ui.core.routing.Route
           ): void;
           /**
            * Attaches event handler `fnFunction` to the {@link #event:beforeRouteMatched beforeRouteMatched} event
@@ -28140,8 +28164,8 @@ declare namespace sap {
            *     browser is product/settings and no arguments will be passed to the events of the route.
            *
            * 	 -  mandatory parameters: "pattern" : "product/{id}" - {id} is a mandatory parameter, e. g. the following
-           *     hashes would match: product/5, product/3. The pattenMatched event will get 5 or 3 passed as id in its
-           *     arguments.The hash product/ will not match.
+           *     hashes would match: product/5, product/3. The patternMatched event will get 5 or 3 passed as id in its
+           *     arguments. The hash product/ will not match.
            *
            * 	 -  optional parameters: "pattern" : "product/{id}/detail/:detailId:" - :detailId: is an optional parameter,
            *     e. g. the following hashes would match: product/5/detail, product/3/detail/2
@@ -33171,7 +33195,7 @@ declare namespace sap {
           /**
            * Received pcpFields as a key-value map.
            */
-          pcpFields?: string;
+          pcpFields?: Record<string, string>;
         }
 
         /**
@@ -33229,7 +33253,7 @@ declare namespace sap {
             /**
              * array of protocols as strings, a single protocol as a string. Protocol(s) should be selected from {@link sap.ui.core.ws.SapPcpWebSocket.SUPPORTED_PROTOCOLS}.
              */
-            aProtocols?: any[]
+            vProtocols?: string | string[]
           );
 
           /**
@@ -33292,7 +33316,7 @@ declare namespace sap {
             /**
              * additional pcp-fields as key-value map
              */
-            oPcpFields?: object
+            oPcpFields?: Record<string, any>
           ): this;
         }
         /**
@@ -33310,7 +33334,7 @@ declare namespace sap {
             /**
              * array of protocols as strings, a single protocol as a string
              */
-            aProtocols?: any[]
+            vProtocols?: string | string[]
           );
 
           /**
@@ -38722,7 +38746,8 @@ declare namespace sap {
          *
          * @since 1.56.0
          *
-         * @returns A Promise that resolves with the newly created component instance
+         * @returns A Promise that resolves with the newly created component instance, or rejects with an error
+         * if the component could not be created
          */
         static create(
           /**
@@ -42595,7 +42620,12 @@ declare namespace sap {
          *
          * @returns reference to the instance itself
          */
-        unbindElement(sModelName: string): sap.ui.base.ManagedObject;
+        unbindElement(
+          /**
+           * Name of the model to remove the context for.
+           */
+          sModelName?: string
+        ): sap.ui.base.ManagedObject;
       }
       /**
        * @since 0.8.6
@@ -56260,6 +56290,16 @@ declare namespace sap {
            * @returns Metadata object describing this class
            */
           static getMetadata(): sap.ui.base.Metadata;
+          /**
+           * Sets the value for this `JSONPropertyBinding` if the binding is not suspended. If a new value is set,
+           * an {@link sap.ui.model.Model#propertyChange} event is fired with change reason {@link sap.ui.model.ChangeReason.Binding Binding}.
+           */
+          setValue(
+            /**
+             * The value to set for this binding
+             */
+            vValue: any
+          ): void;
         }
         /**
          * Tree binding implementation for JSON model. See {@link sap.ui.model.json.JSONModel#bindTree}
@@ -65914,9 +65954,10 @@ declare namespace sap {
              *
              * @returns A promise which is resolved without a defined result in case of success, or rejected with an
              * instance of `Error` in case of failure, for example if the annotation belongs to the read-only namespace
-             * "@$ui5.*". With `bRetry` it is only rejected with an `Error` instance where `oError.canceled === true`
-             * when the entity has been deleted while the request was pending or the property has been reset via the
-             * methods
+             * "@$ui5.*", or if `sGroupId` is `null` and the outdated flag at the header context would be set or the
+             * grand total would be affected. With `bRetry` it is only rejected with an `Error` instance where `oError.canceled
+             * === true` when the entity has been deleted while the request was pending or the property has been reset
+             * via the methods
              * 	 {@link sap.ui.model.odata.v4.ODataModel#resetChanges}  {@link sap.ui.model.odata.v4.ODataContextBinding#resetChanges }
              * or  {@link sap.ui.model.odata.v4.ODataListBinding#resetChanges}.
              */
@@ -79282,10 +79323,9 @@ declare namespace sap {
            */
           vFilter?: sap.ui.model.Filter[] | sap.ui.model.Filter,
           /**
-           * The type of the application filters to replace
+           * The type of the application filters to replace, see {@link sap.ui.model.FilterType}
            */
-          sFilterType?: /* was: sap.ui.model.FilterType.Application */
-          any | /* was: sap.ui.model.FilterType.ApplicationBound */ any
+          sFilterType?: "Application" | "ApplicationBound"
         ): sap.ui.model.Filter[] | sap.ui.model.Filter | undefined;
         /**
          * Detaches event handler `fnFunction` from the {@link #event:filter filter} event of this `sap.ui.model.ListBinding`.
@@ -81395,10 +81435,9 @@ declare namespace sap {
            */
           vFilter?: sap.ui.model.Filter[] | sap.ui.model.Filter,
           /**
-           * The type of the application filters to replace
+           * The type of the application filters to replace, see {@link sap.ui.model.FilterType}
            */
-          sFilterType?: /* was: sap.ui.model.FilterType.Application */
-          any | /* was: sap.ui.model.FilterType.ApplicationBound */ any
+          sFilterType?: "Application" | "ApplicationBound"
         ): sap.ui.model.Filter[] | sap.ui.model.Filter | undefined;
         /**
          * Detaches event handler `fnFunction` from the {@link #event:_filter _filter} event of this `sap.ui.model.TreeBinding`.

package/types/{dt-1.147.0-d.ts → sap.ui.dt.d.ts}

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

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.147.1
+// For Library Version: 1.148.0
 
 declare namespace sap {
   namespace ui {
@@ -162,6 +162,27 @@ declare namespace sap {
           ): void;
         }
       }
+      /**
+       * Describes the settings that can be provided to the TableExportSettings constructor.
+       */
+      interface $TableExportSettingsSettings
+        extends sap.ui.core.$ElementSettings {
+        /**
+         * The default file name shown in the export dialog.
+         *
+         * If not specified, the table header is used as the file name.
+         *
+         * File Name Restrictions: The following characters are not allowed in the file name: `\ / : | ? " * <
+         * >`
+         *
+         * The file name must not exceed 256 characters. A warning is shown if it exceeds 100 characters, as long
+         * file names may prevent the spreadsheet from opening correctly.
+         *
+         * The proper file extension is appended automatically based on the selected file type if not already present.
+         */
+        fileName?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
+      }
+
       /**
        * Parameters of the ExportBase#beforeExport event.
        */
@@ -843,6 +864,125 @@ declare namespace sap {
             | sap.ui.model.TreeBinding
         ): object | null;
       }
+      /**
+       * Defines default values shown in the export dialog of a table control, for example {@link sap.ui.mdc.Table }
+       * or {@link sap.ui.comp.smarttable.SmartTable}.
+       *
+       * **Note:** These values are defaults shown to the user. The user can still modify them before export.
+       * If the user modifies a value in the dialog, the user choice takes precedence and is not overridden by
+       * event handlers.
+       *
+       * @since 1.148
+       */
+      class TableExportSettings extends sap.ui.core.Element {
+        /**
+         * Constructor for a new TableExportSettings.
+         *
+         * 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(
+          /**
+           * Initial settings for the new element
+           */
+          mSettings?: sap.ui.export.$TableExportSettingsSettings
+        );
+        /**
+         * Constructor for a new TableExportSettings.
+         *
+         * 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(
+          /**
+           * Optional ID for the new object; generated automatically if no non-empty ID is given
+           */
+          sId?: string,
+          /**
+           * Initial settings for the new element
+           */
+          mSettings?: sap.ui.export.$TableExportSettingsSettings
+        );
+
+        /**
+         * Creates a new subclass of class sap.ui.export.TableExportSettings with name `sClassName` and enriches
+         * it with the information contained in `oClassInfo`.
+         *
+         * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.core.Element.extend}.
+         *
+         *
+         * @returns Created class / constructor function
+         */
+        static extend<T extends Record<string, unknown>>(
+          /**
+           * Name of the class being created
+           */
+          sClassName: string,
+          /**
+           * Object literal with information about the class
+           */
+          oClassInfo?: sap.ClassInfo<T, sap.ui.export.TableExportSettings>,
+          /**
+           * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
+           * used by this class
+           */
+          FNMetaImpl?: Function
+        ): Function;
+        /**
+         * Returns a metadata object for class sap.ui.export.TableExportSettings.
+         *
+         *
+         * @returns Metadata object describing this class
+         */
+        static getMetadata(): sap.ui.core.ElementMetadata;
+        /**
+         * Gets current value of property {@link #getFileName fileName}.
+         *
+         * The default file name shown in the export dialog.
+         *
+         * If not specified, the table header is used as the file name.
+         *
+         * File Name Restrictions: The following characters are not allowed in the file name: `\ / : | ? " * <
+         * >`
+         *
+         * The file name must not exceed 256 characters. A warning is shown if it exceeds 100 characters, as long
+         * file names may prevent the spreadsheet from opening correctly.
+         *
+         * The proper file extension is appended automatically based on the selected file type if not already present.
+         *
+         *
+         * @returns Value of property `fileName`
+         */
+        getFileName(): string;
+        /**
+         * Sets a new value for property {@link #getFileName fileName}.
+         *
+         * The default file name shown in the export dialog.
+         *
+         * If not specified, the table header is used as the file name.
+         *
+         * File Name Restrictions: The following characters are not allowed in the file name: `\ / : | ? " * <
+         * >`
+         *
+         * The file name must not exceed 256 characters. A warning is shown if it exceeds 100 characters, as long
+         * file names may prevent the spreadsheet from opening correctly.
+         *
+         * The proper file extension is appended automatically based on the selected file type if not already present.
+         *
+         * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+         *
+         *
+         * @returns Reference to `this` in order to allow method chaining
+         */
+        setFileName(
+          /**
+           * New value for property `fileName`
+           */
+          sFileName: string
+        ): this;
+      }
       /**
        * EDM data types for document export.
        *
@@ -1176,6 +1316,8 @@ declare namespace sap {
 
     "sap/ui/export/Spreadsheet": undefined;
 
+    "sap/ui/export/TableExportSettings": undefined;
+
     "sap/ui/export/util/Filter": undefined;
   }
 }

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

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

package/types/sap.ui.generic.app.d.ts

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

package/types/sap.ui.generic.template.d.ts

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

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.147.1
+// For Library Version: 1.148.0
 
 declare module "sap/ui/geomap/gen/sap_webcomponents/geomap" {
   /**