@ui5/webcomponents 0.0.0-dcd8e5389 → 0.0.0-ddc5fe31b

package/dist/DateComponentBase.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="openui5" />
 import UI5Element from "@ui5/webcomponents-base/dist/UI5Element.js";
 import type I18nBundle from "@ui5/webcomponents-base/dist/i18nBundle.js";
+import DateFormat from "@ui5/webcomponents-localization/dist/DateFormat.js";
 import CalendarType from "@ui5/webcomponents-base/dist/types/CalendarType.js";
 import CalendarDate from "@ui5/webcomponents-localization/dist/dates/CalendarDate.js";
 /**
@@ -13,45 +14,41 @@ import CalendarDate from "@ui5/webcomponents-localization/dist/dates/CalendarDat
  *  - additional common methods
  *
  * @constructor
- * @author SAP SE
- * @alias sap.ui.webc.main.DateComponentBase
- * @extends sap.ui.webc.base.UI5Element
+ * @abstract
+ * @extends UI5Element
  * @public
  */
 declare class DateComponentBase extends UI5Element {
     /**
      * Sets a calendar type used for display.
      * If not set, the calendar type of the global configuration is used.
-     * @type {sap.ui.webc.base.types.CalendarType}
-     * @name sap.ui.webc.main.DateComponentBase.prototype.primaryCalendarType
+     *
+     * @default undefined
      * @public
      */
-    primaryCalendarType?: CalendarType;
+    primaryCalendarType?: `${CalendarType}`;
     /**
      * Defines the secondary calendar type.
      * If not set, the calendar will only show the primary calendar type.
-     * @type {sap.ui.webc.base.types.CalendarType}
-     * @name sap.ui.webc.main.DateComponentBase.prototype.secondaryCalendarType
+     *
      * @since 1.0.0-rc.16
-     * @defaultvalue undefined
+     * @default undefined
      * @public
      */
-    secondaryCalendarType?: CalendarType;
+    secondaryCalendarType?: `${CalendarType}`;
     /**
      * Determines the format, displayed in the input field.
      *
-     * @type {string}
-     * @name sap.ui.webc.main.DateComponentBase.prototype.formatPattern
-     * @defaultvalue ""
+     * @default ""
      * @public
      */
     formatPattern: string;
     /**
      * Determines the minimum date available for selection.
      *
-     * @type {string}
-     * @name sap.ui.webc.main.DateComponentBase.prototype.minDate
-     * @defaultvalue ""
+     * <b>Note:</b> If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).
+     *
+     * @default ""
      * @since 1.0.0-rc.6
      * @public
      */
@@ -59,24 +56,35 @@ declare class DateComponentBase extends UI5Element {
     /**
      * Determines the maximum date available for selection.
      *
-     * @type {string}
-     * @name sap.ui.webc.main.DateComponentBase.prototype.maxDate
-     * @defaultvalue ""
+     * <b>Note:</b> If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).
+     *
+     * @default ""
      * @since 1.0.0-rc.6
      * @public
      */
     maxDate: string;
     static i18nBundle?: I18nBundle;
+    /**
+     * Cached instance of DateFormat with a format pattern of "YYYY-MM-dd".
+     * Used by the getISOFormat method to avoid creating a new DateFormat instance on each call.
+     *
+     * @private
+     */
+    _isoFormatInstance?: DateFormat;
     constructor();
-    get _primaryCalendarType(): CalendarType;
+    get _primaryCalendarType(): CalendarType | "Gregorian" | "Islamic" | "Japanese" | "Buddhist" | "Persian";
+    get _secondaryCalendarType(): CalendarType | "Gregorian" | "Islamic" | "Japanese" | "Buddhist" | "Persian" | undefined;
     get _minDate(): CalendarDate;
     get _maxDate(): CalendarDate;
     get _formatPattern(): string;
     get _isPattern(): boolean;
+    get hasSecondaryCalendarType(): boolean;
+    _getMinMaxCalendarDateFromString(date: string): CalendarDate | undefined;
     _getCalendarDateFromString(value: string): CalendarDate | undefined;
     _getTimeStampFromString(value: string): number | undefined;
     _getStringFromTimestamp(timestamp: number): string;
     getFormat(): import("sap/ui/core/format/DateFormat").default;
+    getISOFormat(): DateFormat;
     static onDefine(): Promise<void>;
 }
 export default DateComponentBase;

package/dist/DateComponentBase.js

@@ -11,7 +11,7 @@ import customElement from "@ui5/webcomponents-base/dist/decorators/customElement
 import property from "@ui5/webcomponents-base/dist/decorators/property.js";
 import { fetchCldr } from "@ui5/webcomponents-base/dist/asset-registries/LocaleData.js";
 import { getI18nBundle } from "@ui5/webcomponents-base/dist/i18nBundle.js";
-import { getCalendarType } from "@ui5/webcomponents-base/dist/config/CalendarType.js";
+import { getCalendarType, getSecondaryCalendarType } from "@ui5/webcomponents-base/dist/config/CalendarType.js";
 import DateFormat from "@ui5/webcomponents-localization/dist/DateFormat.js";
 import getCachedLocaleDataInstance from "@ui5/webcomponents-localization/dist/getCachedLocaleDataInstance.js";
 import CalendarType from "@ui5/webcomponents-base/dist/types/CalendarType.js";
@@ -28,9 +28,8 @@ import { getMaxCalendarDate, getMinCalendarDate } from "@ui5/webcomponents-local
  *  - additional common methods
  *
  * @constructor
- * @author SAP SE
- * @alias sap.ui.webc.main.DateComponentBase
- * @extends sap.ui.webc.base.UI5Element
+ * @abstract
+ * @extends UI5Element
  * @public
  */
 let DateComponentBase = DateComponentBase_1 = class DateComponentBase extends UI5Element {
@@ -41,19 +40,22 @@ let DateComponentBase = DateComponentBase_1 = class DateComponentBase extends UI
         const localeData = getCachedLocaleDataInstance(getLocale());
         return this.primaryCalendarType || getCalendarType() || localeData.getPreferredCalendarType();
     }
+    get _secondaryCalendarType() {
+        return this.secondaryCalendarType || getSecondaryCalendarType();
+    }
     get _minDate() {
-        // <b>Note:</b> Format#parse accepts only boolean type for 2nd and 3rd params,
-        // but has logic related to "undefined" value, so we're calling it with "undefined" and casting to "boolean".
-        const utc = undefined;
-        const strict = undefined;
-        return this.minDate && this.getFormat().parse(this.minDate, utc, strict) ? this._getCalendarDateFromString(this.minDate) : getMinCalendarDate(this._primaryCalendarType);
+        let minDate;
+        if (this.minDate) {
+            minDate = this._getMinMaxCalendarDateFromString(this.minDate);
+        }
+        return minDate || getMinCalendarDate(this._primaryCalendarType);
     }
     get _maxDate() {
-        // <b>Note:</b> Format#parse accepts only boolean type for 2nd and 3rd params,
-        // but has logic related to "undefined" value, so we're calling it with "undefined" and casting to "boolean".
-        const utc = undefined;
-        const strict = undefined;
-        return this.maxDate && this.getFormat().parse(this.maxDate, utc, strict) ? this._getCalendarDateFromString(this.maxDate) : getMaxCalendarDate(this._primaryCalendarType);
+        let maxDate;
+        if (this.maxDate) {
+            maxDate = this._getMinMaxCalendarDateFromString(this.maxDate);
+        }
+        return maxDate || getMaxCalendarDate(this._primaryCalendarType);
     }
     get _formatPattern() {
         return this.formatPattern || "medium"; // get from config
@@ -61,12 +63,20 @@ let DateComponentBase = DateComponentBase_1 = class DateComponentBase extends UI
     get _isPattern() {
         return this._formatPattern !== "medium" && this._formatPattern !== "short" && this._formatPattern !== "long";
     }
+    get hasSecondaryCalendarType() {
+        return !!this.secondaryCalendarType && this.secondaryCalendarType !== this.primaryCalendarType;
+    }
+    _getMinMaxCalendarDateFromString(date) {
+        if (this.getFormat().parse(date)) {
+            return this._getCalendarDateFromString(date);
+        }
+        const jsDate = this.getISOFormat().parse(date);
+        if (jsDate) {
+            return CalendarDate.fromLocalJSDate(jsDate, this._primaryCalendarType);
+        }
+    }
     _getCalendarDateFromString(value) {
-        // <b>Note:</b> Format#parse accepts only boolean type for 2nd and 3rd params,
-        // but has logic related to "undefined" value, so we're calling it with "undefined" and casting to "boolean".
-        const utc = undefined;
-        const strict = undefined;
-        const jsDate = this.getFormat().parse(value, utc, strict);
+        const jsDate = this.getFormat().parse(value);
         if (jsDate) {
             return CalendarDate.fromLocalJSDate(jsDate, this._primaryCalendarType);
         }
@@ -94,6 +104,16 @@ let DateComponentBase = DateComponentBase_1 = class DateComponentBase extends UI
                 calendarType: this._primaryCalendarType,
             });
     }
+    getISOFormat() {
+        if (!this._isoFormatInstance) {
+            this._isoFormatInstance = DateFormat.getDateInstance({
+                strictParsing: true,
+                pattern: "YYYY-MM-dd",
+                calendarType: this._primaryCalendarType,
+            });
+        }
+        return this._isoFormatInstance;
+    }
     static async onDefine() {
         [DateComponentBase_1.i18nBundle] = await Promise.all([
             getI18nBundle("@ui5/webcomponents"),

package/dist/DateComponentBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"DateComponentBase.js","sourceRoot":"","sources":["../src/DateComponentBase.ts"],"names":[],"mappings":"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","sourcesContent":["import UI5Element from \"@ui5/webcomponents-base/dist/UI5Element.js\";\nimport litRender from \"@ui5/webcomponents-base/dist/renderer/LitRenderer.js\";\nimport customElement from \"@ui5/webcomponents-base/dist/decorators/customElement.js\";\nimport property from \"@ui5/webcomponents-base/dist/decorators/property.js\";\nimport { fetchCldr } from \"@ui5/webcomponents-base/dist/asset-registries/LocaleData.js\";\nimport { getI18nBundle } from \"@ui5/webcomponents-base/dist/i18nBundle.js\";\nimport type I18nBundle from \"@ui5/webcomponents-base/dist/i18nBundle.js\";\nimport { getCalendarType } from \"@ui5/webcomponents-base/dist/config/CalendarType.js\";\nimport DateFormat from \"@ui5/webcomponents-localization/dist/DateFormat.js\";\nimport getCachedLocaleDataInstance from \"@ui5/webcomponents-localization/dist/getCachedLocaleDataInstance.js\";\nimport CalendarType from \"@ui5/webcomponents-base/dist/types/CalendarType.js\";\nimport getLocale from \"@ui5/webcomponents-base/dist/locale/getLocale.js\";\nimport CalendarDate from \"@ui5/webcomponents-localization/dist/dates/CalendarDate.js\";\nimport { getMaxCalendarDate, getMinCalendarDate } from \"@ui5/webcomponents-localization/dist/dates/ExtremeDates.js\";\n\n/**\n * @class\n *\n * Abstract class that provides common functionality for date-related components (day picker, month picker, year picker, calendar, date picker, date range picker, date time picker)\n * This includes:\n *  - \"languageAware: true\" metadata setting, CLDR fetch and i18n initialization\n *  - common properties (primaryCalendar, minDate, maxDate and formatPattern) declaration and methods that operate on them\n *  - additional common methods\n *\n * @constructor\n * @author SAP SE\n * @alias sap.ui.webc.main.DateComponentBase\n * @extends sap.ui.webc.base.UI5Element\n * @public\n */\n@customElement({\n\tlanguageAware: true,\n\trenderer: litRender,\n})\nclass DateComponentBase extends UI5Element {\n\t/**\n\t * Sets a calendar type used for display.\n\t * If not set, the calendar type of the global configuration is used.\n\t * @type {sap.ui.webc.base.types.CalendarType}\n\t * @name sap.ui.webc.main.DateComponentBase.prototype.primaryCalendarType\n\t * @public\n\t */\n\t@property({ type: CalendarType })\n\tprimaryCalendarType?: CalendarType;\n\n\t/**\n\t * Defines the secondary calendar type.\n\t * If not set, the calendar will only show the primary calendar type.\n\t * @type {sap.ui.webc.base.types.CalendarType}\n\t * @name sap.ui.webc.main.DateComponentBase.prototype.secondaryCalendarType\n\t * @since 1.0.0-rc.16\n\t * @defaultvalue undefined\n\t * @public\n\t */\n\t@property({ type: CalendarType })\n\tsecondaryCalendarType?: CalendarType;\n\n\t/**\n\t * Determines the format, displayed in the input field.\n\t *\n\t * @type {string}\n\t * @name sap.ui.webc.main.DateComponentBase.prototype.formatPattern\n\t * @defaultvalue \"\"\n\t * @public\n\t */\n\t@property()\n\tformatPattern!: string;\n\n\t/**\n\t * Determines the minimum date available for selection.\n\t *\n\t * @type {string}\n\t * @name sap.ui.webc.main.DateComponentBase.prototype.minDate\n\t * @defaultvalue \"\"\n\t * @since 1.0.0-rc.6\n\t * @public\n\t */\n\t@property()\n\tminDate!: string;\n\n\t/**\n\t * Determines the maximum date available for selection.\n\t *\n\t * @type {string}\n\t * @name sap.ui.webc.main.DateComponentBase.prototype.maxDate\n\t * @defaultvalue \"\"\n\t * @since 1.0.0-rc.6\n\t * @public\n\t */\n\t@property()\n\tmaxDate!: string;\n\n\tstatic i18nBundle?: I18nBundle;\n\n\tconstructor() {\n\t\tsuper();\n\t}\n\n\tget _primaryCalendarType() {\n\t\tconst localeData = getCachedLocaleDataInstance(getLocale());\n\t\treturn this.primaryCalendarType || getCalendarType() || localeData.getPreferredCalendarType();\n\t}\n\n\tget _minDate() {\n\t\t// <b>Note:</b> Format#parse accepts only boolean type for 2nd and 3rd params,\n\t\t// but has logic related to \"undefined\" value, so we're calling it with \"undefined\" and casting to \"boolean\".\n\t\tconst utc = undefined as unknown as boolean;\n\t\tconst strict = undefined as unknown as boolean;\n\t\treturn this.minDate && this.getFormat().parse(this.minDate, utc, strict) ? this._getCalendarDateFromString(this.minDate)! : getMinCalendarDate(this._primaryCalendarType);\n\t}\n\n\tget _maxDate() {\n\t\t// <b>Note:</b> Format#parse accepts only boolean type for 2nd and 3rd params,\n\t\t// but has logic related to \"undefined\" value, so we're calling it with \"undefined\" and casting to \"boolean\".\n\t\tconst utc = undefined as unknown as boolean;\n\t\tconst strict = undefined as unknown as boolean;\n\t\treturn this.maxDate && this.getFormat().parse(this.maxDate, utc, strict) ? this._getCalendarDateFromString(this.maxDate)! : getMaxCalendarDate(this._primaryCalendarType);\n\t}\n\n\tget _formatPattern() {\n\t\treturn this.formatPattern || \"medium\"; // get from config\n\t}\n\n\tget _isPattern() {\n\t\treturn this._formatPattern !== \"medium\" && this._formatPattern !== \"short\" && this._formatPattern !== \"long\";\n\t}\n\n\t_getCalendarDateFromString(value: string) {\n\t\t// <b>Note:</b> Format#parse accepts only boolean type for 2nd and 3rd params,\n\t\t// but has logic related to \"undefined\" value, so we're calling it with \"undefined\" and casting to \"boolean\".\n\t\tconst utc = undefined as unknown as boolean;\n\t\tconst strict = undefined as unknown as boolean;\n\t\tconst jsDate = this.getFormat().parse(value, utc, strict) as Date;\n\t\tif (jsDate) {\n\t\t\treturn CalendarDate.fromLocalJSDate(jsDate, this._primaryCalendarType);\n\t\t}\n\t}\n\n\t_getTimeStampFromString(value: string) {\n\t\tconst calDate = this._getCalendarDateFromString(value);\n\t\tif (calDate) {\n\t\t\treturn calDate.toUTCJSDate().valueOf();\n\t\t}\n\t}\n\n\t_getStringFromTimestamp(timestamp: number) {\n\t\tconst localDate = new Date(timestamp);\n\t\treturn this.getFormat().format(localDate, true);\n\t}\n\n\tgetFormat() {\n\t\treturn this._isPattern\n\t\t\t? DateFormat.getDateInstance({\n\t\t\t\tstrictParsing: true,\n\t\t\t\tpattern: this._formatPattern,\n\t\t\t\tcalendarType: this._primaryCalendarType,\n\t\t\t})\n\t\t\t: DateFormat.getDateInstance({\n\t\t\t\tstrictParsing: true,\n\t\t\t\tstyle: this._formatPattern,\n\t\t\t\tcalendarType: this._primaryCalendarType,\n\t\t\t});\n\t}\n\n\tstatic async onDefine() {\n\t\t[DateComponentBase.i18nBundle] = await Promise.all([\n\t\t\tgetI18nBundle(\"@ui5/webcomponents\"),\n\t\t\tfetchCldr(getLocale().getLanguage(), getLocale().getRegion(), getLocale().getScript()),\n\t\t]);\n\t}\n}\n\nexport default DateComponentBase;\n"]}
+{"version":3,"file":"DateComponentBase.js","sourceRoot":"","sources":["../src/DateComponentBase.ts"],"names":[],"mappings":"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","sourcesContent":["import UI5Element from \"@ui5/webcomponents-base/dist/UI5Element.js\";\nimport litRender from \"@ui5/webcomponents-base/dist/renderer/LitRenderer.js\";\nimport customElement from \"@ui5/webcomponents-base/dist/decorators/customElement.js\";\nimport property from \"@ui5/webcomponents-base/dist/decorators/property.js\";\nimport { fetchCldr } from \"@ui5/webcomponents-base/dist/asset-registries/LocaleData.js\";\nimport { getI18nBundle } from \"@ui5/webcomponents-base/dist/i18nBundle.js\";\nimport type I18nBundle from \"@ui5/webcomponents-base/dist/i18nBundle.js\";\nimport { getCalendarType, getSecondaryCalendarType } from \"@ui5/webcomponents-base/dist/config/CalendarType.js\";\nimport DateFormat from \"@ui5/webcomponents-localization/dist/DateFormat.js\";\nimport getCachedLocaleDataInstance from \"@ui5/webcomponents-localization/dist/getCachedLocaleDataInstance.js\";\nimport CalendarType from \"@ui5/webcomponents-base/dist/types/CalendarType.js\";\nimport getLocale from \"@ui5/webcomponents-base/dist/locale/getLocale.js\";\nimport CalendarDate from \"@ui5/webcomponents-localization/dist/dates/CalendarDate.js\";\nimport { getMaxCalendarDate, getMinCalendarDate } from \"@ui5/webcomponents-localization/dist/dates/ExtremeDates.js\";\n\n/**\n * @class\n *\n * Abstract class that provides common functionality for date-related components (day picker, month picker, year picker, calendar, date picker, date range picker, date time picker)\n * This includes:\n *  - \"languageAware: true\" metadata setting, CLDR fetch and i18n initialization\n *  - common properties (primaryCalendar, minDate, maxDate and formatPattern) declaration and methods that operate on them\n *  - additional common methods\n *\n * @constructor\n * @abstract\n * @extends UI5Element\n * @public\n */\n@customElement({\n\tlanguageAware: true,\n\trenderer: litRender,\n})\nclass DateComponentBase extends UI5Element {\n\t/**\n\t * Sets a calendar type used for display.\n\t * If not set, the calendar type of the global configuration is used.\n\t *\n\t * @default undefined\n\t * @public\n\t */\n\t@property({ type: CalendarType })\n\tprimaryCalendarType?: `${CalendarType}`;\n\n\t/**\n\t * Defines the secondary calendar type.\n\t * If not set, the calendar will only show the primary calendar type.\n\t *\n\t * @since 1.0.0-rc.16\n\t * @default undefined\n\t * @public\n\t */\n\t@property({ type: CalendarType })\n\tsecondaryCalendarType?: `${CalendarType}`;\n\n\t/**\n\t * Determines the format, displayed in the input field.\n\t *\n\t * @default \"\"\n\t * @public\n\t */\n\t@property()\n\tformatPattern!: string;\n\n\t/**\n\t * Determines the minimum date available for selection.\n\t *\n\t * <b>Note:</b> If the formatPattern property is not set, the minDate value must be provided in the ISO date format (YYYY-MM-dd).\n\t *\n\t * @default \"\"\n\t * @since 1.0.0-rc.6\n\t * @public\n\t */\n\t@property()\n\tminDate!: string;\n\n\t/**\n\t * Determines the maximum date available for selection.\n\t *\n\t * <b>Note:</b> If the formatPattern property is not set, the maxDate value must be provided in the ISO date format (YYYY-MM-dd).\n\t *\n\t * @default \"\"\n\t * @since 1.0.0-rc.6\n\t * @public\n\t */\n\t@property()\n\tmaxDate!: string;\n\n\tstatic i18nBundle?: I18nBundle;\n\n\t/**\n\t * Cached instance of DateFormat with a format pattern of \"YYYY-MM-dd\".\n\t * Used by the getISOFormat method to avoid creating a new DateFormat instance on each call.\n\t *\n\t * @private\n\t */\n\t_isoFormatInstance?: DateFormat;\n\n\tconstructor() {\n\t\tsuper();\n\t}\n\n\tget _primaryCalendarType() {\n\t\tconst localeData = getCachedLocaleDataInstance(getLocale());\n\t\treturn this.primaryCalendarType || getCalendarType() || localeData.getPreferredCalendarType();\n\t}\n\n\tget _secondaryCalendarType() {\n\t\treturn this.secondaryCalendarType || getSecondaryCalendarType();\n\t}\n\n\tget _minDate() {\n\t\tlet minDate;\n\n\t\tif (this.minDate) {\n\t\t\tminDate = this._getMinMaxCalendarDateFromString(this.minDate);\n\t\t}\n\n\t\treturn minDate || getMinCalendarDate(this._primaryCalendarType);\n\t}\n\n\tget _maxDate() {\n\t\tlet maxDate;\n\n\t\tif (this.maxDate) {\n\t\t\tmaxDate = this._getMinMaxCalendarDateFromString(this.maxDate)!;\n\t\t}\n\n\t\treturn maxDate || getMaxCalendarDate(this._primaryCalendarType);\n\t}\n\n\tget _formatPattern() {\n\t\treturn this.formatPattern || \"medium\"; // get from config\n\t}\n\n\tget _isPattern() {\n\t\treturn this._formatPattern !== \"medium\" && this._formatPattern !== \"short\" && this._formatPattern !== \"long\";\n\t}\n\n\tget hasSecondaryCalendarType() {\n\t\treturn !!this.secondaryCalendarType && this.secondaryCalendarType !== this.primaryCalendarType;\n\t}\n\n\t_getMinMaxCalendarDateFromString(date: string) {\n\t\tif (this.getFormat().parse(date)) {\n\t\t\treturn this._getCalendarDateFromString(date);\n\t\t}\n\n\t\tconst jsDate = this.getISOFormat().parse(date) as Date;\n\t\tif (jsDate) {\n\t\t\treturn CalendarDate.fromLocalJSDate(jsDate, this._primaryCalendarType);\n\t\t}\n\t}\n\n\t_getCalendarDateFromString(value: string) {\n\t\tconst jsDate = this.getFormat().parse(value) as Date;\n\t\tif (jsDate) {\n\t\t\treturn CalendarDate.fromLocalJSDate(jsDate, this._primaryCalendarType);\n\t\t}\n\t}\n\n\t_getTimeStampFromString(value: string) {\n\t\tconst calDate = this._getCalendarDateFromString(value);\n\t\tif (calDate) {\n\t\t\treturn calDate.toUTCJSDate().valueOf();\n\t\t}\n\t}\n\n\t_getStringFromTimestamp(timestamp: number) {\n\t\tconst localDate = new Date(timestamp);\n\t\treturn this.getFormat().format(localDate, true);\n\t}\n\n\tgetFormat() {\n\t\treturn this._isPattern\n\t\t\t? DateFormat.getDateInstance({\n\t\t\t\tstrictParsing: true,\n\t\t\t\tpattern: this._formatPattern,\n\t\t\t\tcalendarType: this._primaryCalendarType,\n\t\t\t})\n\t\t\t: DateFormat.getDateInstance({\n\t\t\t\tstrictParsing: true,\n\t\t\t\tstyle: this._formatPattern,\n\t\t\t\tcalendarType: this._primaryCalendarType,\n\t\t\t});\n\t}\n\n\tgetISOFormat() {\n\t\tif (!this._isoFormatInstance) {\n\t\t\tthis._isoFormatInstance = DateFormat.getDateInstance({\n\t\t\t\tstrictParsing: true,\n\t\t\t\tpattern: \"YYYY-MM-dd\",\n\t\t\t\tcalendarType: this._primaryCalendarType,\n\t\t\t});\n\t\t}\n\t\treturn this._isoFormatInstance;\n\t}\n\n\tstatic async onDefine() {\n\t\t[DateComponentBase.i18nBundle] = await Promise.all([\n\t\t\tgetI18nBundle(\"@ui5/webcomponents\"),\n\t\t\tfetchCldr(getLocale().getLanguage(), getLocale().getRegion(), getLocale().getScript()),\n\t\t]);\n\t}\n}\n\nexport default DateComponentBase;\n"]}

package/dist/DatePicker.d.ts

@@ -8,13 +8,21 @@ import "@ui5/webcomponents-icons/dist/decline.js";
 import HasPopup from "./types/HasPopup.js";
 import DateComponentBase from "./DateComponentBase.js";
 import ResponsivePopover from "./ResponsivePopover.js";
-import type { CalendarChangeEventDetail } from "./Calendar.js";
+import type { CalendarSelectedDatesChangeEventDetail } from "./Calendar.js";
 import Input from "./Input.js";
 import InputType from "./types/InputType.js";
 import "@ui5/webcomponents-localization/dist/features/calendar/Gregorian.js";
 type DatePickerChangeEventDetail = {
-    dates: Array<number>;
-    values: Array<string>;
+    value: string;
+    valid: boolean;
+};
+type DatePickerValueStateChangeEventDetail = {
+    valueState: `${ValueState}`;
+    valid: boolean;
+};
+type DatePickerInputEventDetail = {
+    value: string;
+    valid: boolean;
 };
 /**
  * @class
@@ -98,19 +106,14 @@ type DatePickerChangeEventDetail = {
  * <code>import "@ui5/webcomponents/dist/DatePicker";</code>
  *
  * @constructor
- * @author SAP SE
- * @alias sap.ui.webc.main.DatePicker
- * @extends sap.ui.webc.main.DateComponentBase
- * @tagname ui5-date-picker
+ * @extends DateComponentBase
  * @public
  */
 declare class DatePicker extends DateComponentBase implements IFormElement {
     /**
      * Defines a formatted date value.
      *
-     * @type {string}
-     * @name sap.ui.webc.main.DatePicker.prototype.value
-     * @defaultvalue ""
+     * @default ""
      * @formEvents change input
      * @formProperty
      * @public
@@ -118,47 +121,30 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
     value: string;
     /**
      * Defines the value state of the component.
-     * <br><br>
-     * Available options are:
-     * <ul>
-     * <li><code>None</code></li>
-     * <li><code>Error</code></li>
-     * <li><code>Warning</code></li>
-     * <li><code>Success</code></li>
-     * <li><code>Information</code></li>
-     * </ul>
-     *
-     * @type {sap.ui.webc.base.types.ValueState}
-     * @name sap.ui.webc.main.DatePicker.prototype.valueState
-     * @defaultvalue "None"
+     *
+     * @default "None"
      * @public
      */
-    valueState: ValueState;
+    valueState: `${ValueState}`;
     /**
      * Defines whether the component is required.
      *
      * @since 1.0.0-rc.9
-     * @type {boolean}
-     * @name sap.ui.webc.main.DatePicker.prototype.required
-     * @defaultvalue false
+     * @default false
      * @public
      */
     required: boolean;
     /**
      * Determines whether the component is displayed as disabled.
      *
-     * @type {boolean}
-     * @name sap.ui.webc.main.DatePicker.prototype.disabled
-     * @defaultvalue false
+     * @default false
      * @public
      */
     disabled: boolean;
     /**
      * Determines whether the component is displayed as read-only.
      *
-     * @type {boolean}
-     * @name sap.ui.webc.main.DatePicker.prototype.readonly
-     * @defaultvalue false
+     * @default false
      * @public
      */
     readonly: boolean;
@@ -170,9 +156,7 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
      * <b>Note:</b> When no placeholder is set, the format pattern is displayed as a placeholder.
      * Passing an empty string as the value of this property will make the component appear empty - without placeholder or format pattern.
      *
-     * @type {string}
-     * @name sap.ui.webc.main.DatePicker.prototype.placeholder
-     * @defaultvalue undefined
+     * @default undefined
      * @public
      */
     placeholder?: string;
@@ -188,9 +172,7 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
      * will be created inside the component so that it can be submitted as
      * part of an HTML form. Do not use this property unless you need to submit a form.
      *
-     * @type {string}
-     * @name sap.ui.webc.main.DatePicker.prototype.name
-     * @defaultvalue ""
+     * @default ""
      * @public
      */
     name: string;
@@ -201,9 +183,7 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
      * <b>Note:</b> For calendars other than Gregorian,
      * the week numbers are not displayed regardless of what is set.
      *
-     * @type {boolean}
-     * @name sap.ui.webc.main.DatePicker.prototype.hideWeekNumbers
-     * @defaultvalue false
+     * @default false
      * @public
      * @since 1.0.0-rc.8
      */
@@ -211,9 +191,7 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
     /**
      * Defines the aria-label attribute for the component.
      *
-     * @type {string}
-     * @name sap.ui.webc.main.DatePicker.prototype.accessibleName
-     * @defaultvalue ""
+     * @default ""
      * @public
      * @since 1.0.0-rc.15
      */
@@ -221,9 +199,7 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
     /**
      * Receives id(or many ids) of the elements that label the component.
      *
-     * @type {string}
-     * @name sap.ui.webc.main.DatePicker.prototype.accessibleNameRef
-     * @defaultvalue ""
+     * @default ""
      * @public
      * @since 1.0.0-rc.15
      */
@@ -240,18 +216,15 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
      * <br>
      * <b>Note:</b> The <code>valueStateMessage</code> would be displayed,
      * when the component is in <code>Information</code>, <code>Warning</code> or <code>Error</code> value state.
-     * @type {HTMLElement}
-     * @name sap.ui.webc.main.DatePicker.prototype.valueStateMessage
+     *
      * @since 1.0.0-rc.7
-     * @slot
      * @public
      */
     valueStateMessage: Array<HTMLElement>;
     /**
      * The slot is used to render native <code>input</code> HTML element within Light DOM to enable form submit,
      * when <code>name</code> property is set.
-     * @type {HTMLElement[]}
-     * @slot
+     *
      * @private
      */
     formSupport: Array<HTMLElement>;
@@ -265,7 +238,7 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
     onBeforeRendering(): void;
     /**
      * Override in derivatives to change calendar selection mode
-     * @returns {string}
+     *
      * @protected
      */
     get _calendarSelectionMode(): string;
@@ -273,72 +246,72 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
      * Used to provide a timestamp to the Calendar (to focus it to a relevant date when open) based on the component's state
      * Override in derivatives to provide the calendar a timestamp based on their properties
      * By default focus the calendar on the selected date if set, or the current day otherwise
+     *
      * @protected
-     * @returns { number } the calendar timestamp
      */
     get _calendarTimestamp(): number;
     /**
      * Used to provide selectedDates to the calendar based on the component's state
      * Override in derivatives to provide different rules for setting the calendar's selected dates
+     *
      * @protected
-     * @returns { array } the selected dates
      */
     get _calendarSelectedDates(): Array<string>;
     _onkeydown(e: KeyboardEvent): void;
     /**
-     *
-     * @param { number } amount
-     * @param { string } unit
+     * @param amount
+     * @param unit
+     * @param preserveDate whether to preserve the day of the month (f.e. 15th of March + 1 month = 15th of April)
      * @protected
      */
-    _modifyDateValue(amount: number, unit: string): void;
+    _modifyDateValue(amount: number, unit: string, preserveDate?: boolean): void;
     _updateValueAndFireEvents(value: string, normalizeValue: boolean, events: Array<string>, updateValue?: boolean): void;
     _updateValueState(): void;
     _toggleAndFocusInput(): void;
     _getInput(): Input;
     /**
      * The ui5-input "submit" event handler - fire change event when the user presses enter
+     *
      * @protected
      */
     _onInputSubmit(): void;
     /**
      * The ui5-input "change" event handler - fire change event when the user focuses out of the input
+     *
      * @protected
      */
     _onInputChange(e: Event): void;
     /**
      * The ui5-input "input" event handler - fire input even when the user types
+     *
      * @protected
      */
     _onInputInput(e: KeyboardEvent): void;
     /**
      * Checks if the provided value is valid and within valid range.
+     *
      * @protected
-     * @param { string } value
-     * @returns { boolean }
+     * @param value
      */
     _checkValueValidity(value: string): boolean;
     _click(e: MouseEvent): void;
     /**
      * Checks if a value is valid against the current date format of the DatePicker.
+     *
      * @public
-     * @method
-     * @name sap.ui.webc.main.DatePicker#isValid
-     * @param { string } [value=""] A value to be tested against the current date format
-     * @returns { boolean }
+     * @param value A value to be tested against the current date format
      */
-    isValid(value?: string): boolean;
+    isValid(value: string): boolean;
     /**
      * Checks if a date is between the minimum and maximum date.
+     *
      * @public
-     * @method
-     * @name sap.ui.webc.main.DatePicker#isInValidRange
-     * @param { string } [value=""] A value to be checked
-     * @returns { boolean }
+     * @param value A value to be checked
      */
-    isInValidRange(value?: string): boolean;
+    isInValidRange(value: string): boolean;
     /**
      * The parser understands many formats, but we need one format
+     *
      * @protected
      */
     normalizeValue(value: string): string;
@@ -363,11 +336,13 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
     get dateAriaDescription(): string;
     /**
      * Defines whether the dialog on mobile should have header
+     *
      * @private
      */
     get _shouldHideHeader(): boolean;
     /**
      * Defines whether the value help icon is hidden
+     *
      * @private
      */
     get _ariaHidden(): boolean;
@@ -376,10 +351,11 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
     get _calendarPickersMode(): CalendarPickersMode;
     /**
      * The user selected a new date in the calendar
-     * @param event
+     *
+     * @param e
      * @protected
      */
-    onSelectedDatesChange(e: CustomEvent<CalendarChangeEventDetail>): void;
+    onSelectedDatesChange(e: CustomEvent<CalendarSelectedDatesChangeEventDetail>): void;
     /**
      * The user clicked the "month" button in the header
      */
@@ -391,45 +367,38 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
     /**
      * Formats a Java Script date object into a string representing a locale date
      * according to the <code>formatPattern</code> property of the DatePicker instance
+     *
      * @public
-     * @method
-     * @name sap.ui.webc.main.DatePicker#formatValue
-     * @param {Date} date A Java Script date object to be formatted as string
-     * @returns {string} The date as string
+     * @param date A Java Script date object to be formatted as string
+     * @returns The date as string
      */
     formatValue(date: Date): string;
     /**
      * Closes the picker.
+     *
      * @public
-     * @method
-     * @name sap.ui.webc.main.DatePicker#closePicker
      */
     closePicker(): void;
     /**
      * Opens the picker.
+     *
      * @public
-     * @async
-     * @method
-     * @name sap.ui.webc.main.DatePicker#openPicker
-     * @returns {Promise} Resolves when the picker is open
+     * @returns Resolves when the picker is open
      */
     openPicker(): Promise<void>;
     togglePicker(): void;
     /**
      * Checks if the picker is open.
+     *
      * @public
-     * @method
-     * @name sap.ui.webc.main.DatePicker#isOpen
-     * @returns {boolean} true if the picker is open, false otherwise
+     * @returns true if the picker is open, false otherwise
      */
     isOpen(): boolean;
     /**
      * Currently selected date represented as a Local JavaScript Date instance.
      *
      * @public
-     * @readonly
-     * @name sap.ui.webc.main.DatePicker.prototype.dateValue
-     * @type { Date }
+     * @default null
      */
     get dateValue(): Date | null;
     get dateValueUTC(): Date | null;
@@ -441,4 +410,4 @@ declare class DatePicker extends DateComponentBase implements IFormElement {
     get type(): InputType;
 }
 export default DatePicker;
-export type { DatePickerChangeEventDetail };
+export type { DatePickerChangeEventDetail, DatePickerInputEventDetail, DatePickerValueStateChangeEventDetail, };