@vaadin/date-time-picker 25.3.0-alpha12 → 25.3.0-alpha14

package/custom-elements.json

@@ -127,6 +127,16 @@
               "description": "A placeholder string for the date field.",
               "attribute": "date-placeholder"
             },
+            {
+              "kind": "field",
+              "name": "defaultTime",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "The time part to set automatically when the user commits a date while\nthe time picker is empty.\n\nSupports same time formats as the `value` property, without the date\npart. Precision exceeding the one defined by `step` is discarded,\ne.g. `09:30:45` is applied as `09:30` with the default `step`.\n\nThe time part is set when a date is committed while the time picker\nis empty — never for programmatic or initial values. A value outside\n`min` / `max` is applied as-is and makes the field invalid.\n\nWhen not set, selecting a date leaves the time part empty. A string\nthat is not a valid ISO 8601 time is ignored and logs a warning.",
+              "attribute": "default-time"
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -437,6 +447,14 @@
               "description": "A placeholder string for the date field.",
               "fieldName": "datePlaceholder"
             },
+            {
+              "name": "default-time",
+              "type": {
+                "text": "string"
+              },
+              "description": "The time part to set automatically when the user commits a date while\nthe time picker is empty.\n\nSupports same time formats as the `value` property, without the date\npart. Precision exceeding the one defined by `step` is discarded,\ne.g. `09:30:45` is applied as `09:30` with the default `step`.\n\nThe time part is set when a date is committed while the time picker\nis empty — never for programmatic or initial values. A value outside\n`min` / `max` is applied as-is and makes the field invalid.\n\nWhen not set, selecting a date leaves the time part empty. A string\nthat is not a valid ISO 8601 time is ignored and logs a warning.",
+              "fieldName": "defaultTime"
+            },
             {
               "name": "disabled",
               "type": {
@@ -772,6 +790,20 @@
                 "module": "src/vaadin-date-time-picker-mixin.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "defaultTime",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "The time part to set automatically when the user commits a date while\nthe time picker is empty.\n\nSupports same time formats as the `value` property, without the date\npart. Precision exceeding the one defined by `step` is discarded,\ne.g. `09:30:45` is applied as `09:30` with the default `step`.\n\nThe time part is set when a date is committed while the time picker\nis empty — never for programmatic or initial values. A value outside\n`min` / `max` is applied as-is and makes the field invalid.\n\nWhen not set, selecting a date leaves the time part empty. A string\nthat is not a valid ISO 8601 time is ignored and logs a warning.",
+              "attribute": "default-time",
+              "inheritedFrom": {
+                "name": "DateTimePickerMixin",
+                "module": "src/vaadin-date-time-picker-mixin.js"
+              }
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -1155,6 +1187,18 @@
                 "module": "src/vaadin-date-time-picker-mixin.js"
               }
             },
+            {
+              "name": "default-time",
+              "type": {
+                "text": "string"
+              },
+              "description": "The time part to set automatically when the user commits a date while\nthe time picker is empty.\n\nSupports same time formats as the `value` property, without the date\npart. Precision exceeding the one defined by `step` is discarded,\ne.g. `09:30:45` is applied as `09:30` with the default `step`.\n\nThe time part is set when a date is committed while the time picker\nis empty — never for programmatic or initial values. A value outside\n`min` / `max` is applied as-is and makes the field invalid.\n\nWhen not set, selecting a date leaves the time part empty. A string\nthat is not a valid ISO 8601 time is ignored and logs a warning.",
+              "fieldName": "defaultTime",
+              "inheritedFrom": {
+                "name": "DateTimePickerMixin",
+                "module": "src/vaadin-date-time-picker-mixin.js"
+              }
+            },
             {
               "name": "disabled",
               "type": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaadin/date-time-picker",
-  "version": "25.3.0-alpha12",
+  "version": "25.3.0-alpha14",
   "publishConfig": {
     "access": "public"
   },
@@ -35,20 +35,20 @@
   ],
   "dependencies": {
     "@open-wc/dedupe-mixin": "^1.3.0",
-    "@vaadin/a11y-base": "25.3.0-alpha12",
-    "@vaadin/component-base": "25.3.0-alpha12",
-    "@vaadin/date-picker": "25.3.0-alpha12",
-    "@vaadin/field-base": "25.3.0-alpha12",
-    "@vaadin/time-picker": "25.3.0-alpha12",
-    "@vaadin/vaadin-themable-mixin": "25.3.0-alpha12",
+    "@vaadin/a11y-base": "25.3.0-alpha14",
+    "@vaadin/component-base": "25.3.0-alpha14",
+    "@vaadin/date-picker": "25.3.0-alpha14",
+    "@vaadin/field-base": "25.3.0-alpha14",
+    "@vaadin/time-picker": "25.3.0-alpha14",
+    "@vaadin/vaadin-themable-mixin": "25.3.0-alpha14",
     "lit": "^3.0.0"
   },
   "devDependencies": {
-    "@vaadin/aura": "25.3.0-alpha12",
-    "@vaadin/chai-plugins": "25.3.0-alpha12",
-    "@vaadin/test-runner-commands": "25.3.0-alpha12",
+    "@vaadin/aura": "25.3.0-alpha14",
+    "@vaadin/chai-plugins": "25.3.0-alpha14",
+    "@vaadin/test-runner-commands": "25.3.0-alpha14",
     "@vaadin/testing-helpers": "^2.0.0",
-    "@vaadin/vaadin-lumo-styles": "25.3.0-alpha12",
+    "@vaadin/vaadin-lumo-styles": "25.3.0-alpha14",
     "sinon": "^22.0.0"
   },
   "customElements": "custom-elements.json",
@@ -56,5 +56,5 @@
     "web-types.json",
     "web-types.lit.json"
   ],
-  "gitHead": "0f0337783efe38332f5dc6a8968f207d2982de4b"
+  "gitHead": "10a01ae7a1e278af50eda7255dbb68dafc0e4caf"
 }

package/src/vaadin-date-time-picker-mixin.d.ts

@@ -119,6 +119,25 @@ export declare class DateTimePickerMixinClass {
    */
   initialPosition: string | null | undefined;
 
+  /**
+   * The time part to set automatically when the user commits a date while
+   * the time picker is empty.
+   *
+   * Supports same time formats as the `value` property, without the date
+   * part. Precision exceeding the one defined by `step` is discarded,
+   * e.g. `09:30:45` is applied as `09:30` with the default `step`.
+   *
+   * The time part is set when a date is committed while the time picker
+   * is empty — never for programmatic or initial values. A value outside
+   * `min` / `max` is applied as-is and makes the field invalid.
+   *
+   * When not set, selecting a date leaves the time part empty. A string
+   * that is not a valid ISO 8601 time is ignored and logs a warning.
+   *
+   * @attr {string} default-time
+   */
+  defaultTime: string | null | undefined;
+
   /**
    * Set true to display ISO-8601 week numbers in the calendar. Notice that
    * displaying week numbers is only supported when `i18n.firstDayOfWeek`

package/src/vaadin-date-time-picker-mixin.js

@@ -9,6 +9,7 @@ import { setOrRemoveAttribute } from '@vaadin/component-base/src/dom-utils.js';
 import { I18nMixin } from '@vaadin/component-base/src/i18n-mixin.js';
 import { SlotController } from '@vaadin/component-base/src/slot-controller.js';
 import { TooltipController } from '@vaadin/component-base/src/tooltip-controller.js';
+import { issueWarning } from '@vaadin/component-base/src/warnings.js';
 import {
   dateEquals,
   formatUTCISODate,
@@ -169,6 +170,28 @@ export const DateTimePickerMixin = (superClass) =>
           sync: true,
         },
 
+        /**
+         * The time part to set automatically when the user commits a date while
+         * the time picker is empty.
+         *
+         * Supports same time formats as the `value` property, without the date
+         * part. Precision exceeding the one defined by `step` is discarded,
+         * e.g. `09:30:45` is applied as `09:30` with the default `step`.
+         *
+         * The time part is set when a date is committed while the time picker
+         * is empty — never for programmatic or initial values. A value outside
+         * `min` / `max` is applied as-is and makes the field invalid.
+         *
+         * When not set, selecting a date leaves the time part empty. A string
+         * that is not a valid ISO 8601 time is ignored and logs a warning.
+         *
+         * @attr {string} default-time
+         */
+        defaultTime: {
+          type: String,
+          sync: true,
+        },
+
         /**
          * Set true to display ISO-8601 week numbers in the calendar. Notice that
          * displaying week numbers is only supported when `i18n.firstDayOfWeek`
@@ -526,6 +549,17 @@ export const DateTimePickerMixin = (superClass) =>
     __changeEventHandler(event) {
       event.stopPropagation();
 
+      if (
+        event.target === this.__datePicker &&
+        this.__datePicker.value &&
+        !(this.__timePicker.value || this.__timePicker.__unparsableValue)
+      ) {
+        const defaultTime = this.__normalizeDefaultTime();
+        if (defaultTime) {
+          this.__timePicker.value = defaultTime;
+        }
+      }
+
       const isAlreadyInvalid = this.invalid;
       const filledPickers = this.__filledPickers;
       if (filledPickers.length === 1 && filledPickers[0].checkValidity() && !isAlreadyInvalid) {
@@ -835,6 +869,16 @@ export const DateTimePickerMixin = (superClass) =>
       return `${dateValue}T${timeValue}`;
     }
 
+    /**
+     * Time object to string (ISO time)
+     * @param {object} timeObj
+     * @return {string} e.g. 'hh:mm', 'hh:mm:ss', 'hh:mm:ss.fff' (depending on precision defined by "step" property)
+     * @private
+     */
+    __formatTimeISO(timeObj) {
+      return formatISOTime(validateTime(timeObj, this.step));
+    }
+
     /**
      * Date object to string (ISO time)
      * @param {Date} date
@@ -842,17 +886,33 @@ export const DateTimePickerMixin = (superClass) =>
      * @private
      */
     __dateToIsoTimeString(date) {
-      return formatISOTime(
-        validateTime(
-          {
-            hours: date.getUTCHours(),
-            minutes: date.getUTCMinutes(),
-            seconds: date.getUTCSeconds(),
-            milliseconds: date.getUTCMilliseconds(),
-          },
-          this.step,
-        ),
-      );
+      return this.__formatTimeISO({
+        hours: date.getUTCHours(),
+        minutes: date.getUTCMinutes(),
+        seconds: date.getUTCSeconds(),
+        milliseconds: date.getUTCMilliseconds(),
+      });
+    }
+
+    /**
+     * `defaultTime` to string (ISO time), or an empty string when unset or unparsable.
+     * @return {string}
+     * @private
+     */
+    __normalizeDefaultTime() {
+      if (!this.defaultTime) {
+        return '';
+      }
+
+      const timeObj = parseISOTime(this.defaultTime);
+      if (!timeObj) {
+        issueWarning(
+          `<vaadin-date-time-picker> Ignored "defaultTime" that is not a valid ISO 8601 time: ${this.defaultTime}`,
+        );
+        return '';
+      }
+
+      return this.__formatTimeISO(timeObj);
     }
 
     /**

package/web-types.json

@@ -1,14 +1,14 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/date-time-picker",
-  "version": "25.3.0-alpha12",
+  "version": "25.3.0-alpha14",
   "description-markup": "markdown",
   "contributions": {
     "html": {
       "elements": [
         {
           "name": "vaadin-date-time-picker",
-          "description": "`<vaadin-date-time-picker>` is a Web Component providing a date time selection field.\n\n```html\n<vaadin-date-time-picker value=\"2019-09-16T15:00\"></vaadin-date-time-picker>\n```\n```js\ndateTimePicker.value = '2019-09-16T15:00';\n```\n\nWhen the selected `value` is changed, a `value-changed` event is triggered.\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name            | Description\n---------------------|----------------\n`label`              | The slotted label element wrapper\n`input-fields`       | The date and time pickers wrapper\n`helper-text`        | The slotted helper text element wrapper\n`error-message`      | The slotted error message element wrapper\n`required-indicator` | The `required` state indicator element\n\nThe following state attributes are available for styling:\n\nAttribute           | Description\n--------------------|---------------------------------\n`disabled`          | Set when the element is disabled\n`focused`           | Set when the element is focused\n`focus-ring`        | Set when the element is keyboard focused\n`readonly`          | Set when the element is readonly\n`invalid`           | Set when the element is invalid\n`has-label`         | Set when the element has a label\n`has-value`         | Set when the element has a value\n`has-helper`        | Set when the element has helper text\n`has-error-message` | Set when the element has an error message\n`has-tooltip`       | Set when the element has a slotted tooltip\n\nThe following custom CSS properties are available for styling:\n\nCustom CSS property                                |\n:--------------------------------------------------|\n| `--vaadin-date-time-picker-gap`                  |\n| `--vaadin-input-field-error-color`               |\n| `--vaadin-input-field-error-font-size`           |\n| `--vaadin-input-field-error-font-weight`         |\n| `--vaadin-input-field-error-line-height`         |\n| `--vaadin-input-field-label-color`               |\n| `--vaadin-input-field-label-font-size`           |\n| `--vaadin-input-field-label-font-weight`         |\n| `--vaadin-input-field-label-line-height`         |\n| `--vaadin-input-field-helper-color`              |\n| `--vaadin-input-field-helper-font-size`          |\n| `--vaadin-input-field-helper-font-weight`        |\n| `--vaadin-input-field-helper-line-height`        |\n| `--vaadin-input-field-required-indicator-color`  |\n| `--vaadin-input-field-required-indicator`        |\n\n### Internal components\n\nThe following components are created by `<vaadin-date-time-picker>` and placed in light DOM:\n\n- [`<vaadin-date-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha12/#/elements/vaadin-date-picker).\n- [`<vaadin-time-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha12/#/elements/vaadin-time-picker).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.\n\n### Change events\n\nDepending on the nature of the value change that the user attempts to commit e.g. by pressing Enter,\nthe component can fire either a `change` event or an `unparsable-change` event:\n\nValue change             | Event\n:------------------------|:------------------\nempty => parsable        | change\nempty => unparsable      | unparsable-change\nparsable => empty        | change\nparsable => parsable     | change\nparsable => unparsable   | change\nunparsable => empty      | unparsable-change\nunparsable => parsable   | change\nunparsable => unparsable | unparsable-change\nincomplete => empty      | unparsable-change\nincomplete => parsable   | change\nincomplete => unparsable | unparsable-change\nempty => incomplete      | unparsable-change\nparsable => incomplete   | change\nunparsable => incomplete | unparsable-change",
+          "description": "`<vaadin-date-time-picker>` is a Web Component providing a date time selection field.\n\n```html\n<vaadin-date-time-picker value=\"2019-09-16T15:00\"></vaadin-date-time-picker>\n```\n```js\ndateTimePicker.value = '2019-09-16T15:00';\n```\n\nWhen the selected `value` is changed, a `value-changed` event is triggered.\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name            | Description\n---------------------|----------------\n`label`              | The slotted label element wrapper\n`input-fields`       | The date and time pickers wrapper\n`helper-text`        | The slotted helper text element wrapper\n`error-message`      | The slotted error message element wrapper\n`required-indicator` | The `required` state indicator element\n\nThe following state attributes are available for styling:\n\nAttribute           | Description\n--------------------|---------------------------------\n`disabled`          | Set when the element is disabled\n`focused`           | Set when the element is focused\n`focus-ring`        | Set when the element is keyboard focused\n`readonly`          | Set when the element is readonly\n`invalid`           | Set when the element is invalid\n`has-label`         | Set when the element has a label\n`has-value`         | Set when the element has a value\n`has-helper`        | Set when the element has helper text\n`has-error-message` | Set when the element has an error message\n`has-tooltip`       | Set when the element has a slotted tooltip\n\nThe following custom CSS properties are available for styling:\n\nCustom CSS property                                |\n:--------------------------------------------------|\n| `--vaadin-date-time-picker-gap`                  |\n| `--vaadin-input-field-error-color`               |\n| `--vaadin-input-field-error-font-size`           |\n| `--vaadin-input-field-error-font-weight`         |\n| `--vaadin-input-field-error-line-height`         |\n| `--vaadin-input-field-label-color`               |\n| `--vaadin-input-field-label-font-size`           |\n| `--vaadin-input-field-label-font-weight`         |\n| `--vaadin-input-field-label-line-height`         |\n| `--vaadin-input-field-helper-color`              |\n| `--vaadin-input-field-helper-font-size`          |\n| `--vaadin-input-field-helper-font-weight`        |\n| `--vaadin-input-field-helper-line-height`        |\n| `--vaadin-input-field-required-indicator-color`  |\n| `--vaadin-input-field-required-indicator`        |\n\n### Internal components\n\nThe following components are created by `<vaadin-date-time-picker>` and placed in light DOM:\n\n- [`<vaadin-date-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha14/#/elements/vaadin-date-picker).\n- [`<vaadin-time-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha14/#/elements/vaadin-time-picker).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.\n\n### Change events\n\nDepending on the nature of the value change that the user attempts to commit e.g. by pressing Enter,\nthe component can fire either a `change` event or an `unparsable-change` event:\n\nValue change             | Event\n:------------------------|:------------------\nempty => parsable        | change\nempty => unparsable      | unparsable-change\nparsable => empty        | change\nparsable => parsable     | change\nparsable => unparsable   | change\nunparsable => empty      | unparsable-change\nunparsable => parsable   | change\nunparsable => unparsable | unparsable-change\nincomplete => empty      | unparsable-change\nincomplete => parsable   | change\nincomplete => unparsable | unparsable-change\nempty => incomplete      | unparsable-change\nparsable => incomplete   | change\nunparsable => incomplete | unparsable-change",
           "attributes": [
             {
               "name": "accessible-description-ref",
@@ -64,6 +64,15 @@
                 ]
               }
             },
+            {
+              "name": "default-time",
+              "description": "The time part to set automatically when the user commits a date while\nthe time picker is empty.\n\nSupports same time formats as the `value` property, without the date\npart. Precision exceeding the one defined by `step` is discarded,\ne.g. `09:30:45` is applied as `09:30` with the default `step`.\n\nThe time part is set when a date is committed while the time picker\nis empty — never for programmatic or initial values. A value outside\n`min` / `max` is applied as-is and makes the field invalid.\n\nWhen not set, selecting a date leaves the time part empty. A string\nthat is not a valid ISO 8601 time is ignored and logs a warning.",
+              "value": {
+                "type": [
+                  "string"
+                ]
+              }
+            },
             {
               "name": "disabled",
               "description": "If true, the user cannot interact with this element.",
@@ -285,6 +294,15 @@
                   ]
                 }
               },
+              {
+                "name": "defaultTime",
+                "description": "The time part to set automatically when the user commits a date while\nthe time picker is empty.\n\nSupports same time formats as the `value` property, without the date\npart. Precision exceeding the one defined by `step` is discarded,\ne.g. `09:30:45` is applied as `09:30` with the default `step`.\n\nThe time part is set when a date is committed while the time picker\nis empty — never for programmatic or initial values. A value outside\n`min` / `max` is applied as-is and makes the field invalid.\n\nWhen not set, selecting a date leaves the time part empty. A string\nthat is not a valid ISO 8601 time is ignored and logs a warning.",
+                "value": {
+                  "type": [
+                    "string"
+                  ]
+                }
+              },
               {
                 "name": "disabled",
                 "description": "If true, the user cannot interact with this element.",
@@ -314,7 +332,7 @@
               },
               {
                 "name": "i18n",
-                "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following structure and default values:\n\n```js\n{\n  // Accessible label to the date picker.\n  // The property works in conjunction with label and accessibleName defined on the field.\n  // If both properties are defined, then accessibleName takes precedence.\n  // Then, the dateLabel value is concatenated with it.\n  dateLabel: undefined;\n\n  // Accessible label to the time picker.\n  // The property works in conjunction with label and accessibleName defined on the field.\n  // If both properties are defined, then accessibleName takes precedence.\n  // Then, the dateLabel value is concatenated with it.\n  timeLabel: undefined;\n}\n```\n\nAdditionally, all i18n properties from\n[`<vaadin-date-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha12/#/elements/vaadin-date-picker) and\n[`<vaadin-time-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha12/#/elements/vaadin-time-picker) are supported.",
+                "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following structure and default values:\n\n```js\n{\n  // Accessible label to the date picker.\n  // The property works in conjunction with label and accessibleName defined on the field.\n  // If both properties are defined, then accessibleName takes precedence.\n  // Then, the dateLabel value is concatenated with it.\n  dateLabel: undefined;\n\n  // Accessible label to the time picker.\n  // The property works in conjunction with label and accessibleName defined on the field.\n  // If both properties are defined, then accessibleName takes precedence.\n  // Then, the dateLabel value is concatenated with it.\n  timeLabel: undefined;\n}\n```\n\nAdditionally, all i18n properties from\n[`<vaadin-date-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha14/#/elements/vaadin-date-picker) and\n[`<vaadin-time-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha14/#/elements/vaadin-time-picker) are supported.",
                 "value": {
                   "type": [
                     "Object"

package/web-types.lit.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/date-time-picker",
-  "version": "25.3.0-alpha12",
+  "version": "25.3.0-alpha14",
   "description-markup": "markdown",
   "framework": "lit",
   "framework-config": {
@@ -16,7 +16,7 @@
       "elements": [
         {
           "name": "vaadin-date-time-picker",
-          "description": "`<vaadin-date-time-picker>` is a Web Component providing a date time selection field.\n\n```html\n<vaadin-date-time-picker value=\"2019-09-16T15:00\"></vaadin-date-time-picker>\n```\n```js\ndateTimePicker.value = '2019-09-16T15:00';\n```\n\nWhen the selected `value` is changed, a `value-changed` event is triggered.\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name            | Description\n---------------------|----------------\n`label`              | The slotted label element wrapper\n`input-fields`       | The date and time pickers wrapper\n`helper-text`        | The slotted helper text element wrapper\n`error-message`      | The slotted error message element wrapper\n`required-indicator` | The `required` state indicator element\n\nThe following state attributes are available for styling:\n\nAttribute           | Description\n--------------------|---------------------------------\n`disabled`          | Set when the element is disabled\n`focused`           | Set when the element is focused\n`focus-ring`        | Set when the element is keyboard focused\n`readonly`          | Set when the element is readonly\n`invalid`           | Set when the element is invalid\n`has-label`         | Set when the element has a label\n`has-value`         | Set when the element has a value\n`has-helper`        | Set when the element has helper text\n`has-error-message` | Set when the element has an error message\n`has-tooltip`       | Set when the element has a slotted tooltip\n\nThe following custom CSS properties are available for styling:\n\nCustom CSS property                                |\n:--------------------------------------------------|\n| `--vaadin-date-time-picker-gap`                  |\n| `--vaadin-input-field-error-color`               |\n| `--vaadin-input-field-error-font-size`           |\n| `--vaadin-input-field-error-font-weight`         |\n| `--vaadin-input-field-error-line-height`         |\n| `--vaadin-input-field-label-color`               |\n| `--vaadin-input-field-label-font-size`           |\n| `--vaadin-input-field-label-font-weight`         |\n| `--vaadin-input-field-label-line-height`         |\n| `--vaadin-input-field-helper-color`              |\n| `--vaadin-input-field-helper-font-size`          |\n| `--vaadin-input-field-helper-font-weight`        |\n| `--vaadin-input-field-helper-line-height`        |\n| `--vaadin-input-field-required-indicator-color`  |\n| `--vaadin-input-field-required-indicator`        |\n\n### Internal components\n\nThe following components are created by `<vaadin-date-time-picker>` and placed in light DOM:\n\n- [`<vaadin-date-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha12/#/elements/vaadin-date-picker).\n- [`<vaadin-time-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha12/#/elements/vaadin-time-picker).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.\n\n### Change events\n\nDepending on the nature of the value change that the user attempts to commit e.g. by pressing Enter,\nthe component can fire either a `change` event or an `unparsable-change` event:\n\nValue change             | Event\n:------------------------|:------------------\nempty => parsable        | change\nempty => unparsable      | unparsable-change\nparsable => empty        | change\nparsable => parsable     | change\nparsable => unparsable   | change\nunparsable => empty      | unparsable-change\nunparsable => parsable   | change\nunparsable => unparsable | unparsable-change\nincomplete => empty      | unparsable-change\nincomplete => parsable   | change\nincomplete => unparsable | unparsable-change\nempty => incomplete      | unparsable-change\nparsable => incomplete   | change\nunparsable => incomplete | unparsable-change",
+          "description": "`<vaadin-date-time-picker>` is a Web Component providing a date time selection field.\n\n```html\n<vaadin-date-time-picker value=\"2019-09-16T15:00\"></vaadin-date-time-picker>\n```\n```js\ndateTimePicker.value = '2019-09-16T15:00';\n```\n\nWhen the selected `value` is changed, a `value-changed` event is triggered.\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name            | Description\n---------------------|----------------\n`label`              | The slotted label element wrapper\n`input-fields`       | The date and time pickers wrapper\n`helper-text`        | The slotted helper text element wrapper\n`error-message`      | The slotted error message element wrapper\n`required-indicator` | The `required` state indicator element\n\nThe following state attributes are available for styling:\n\nAttribute           | Description\n--------------------|---------------------------------\n`disabled`          | Set when the element is disabled\n`focused`           | Set when the element is focused\n`focus-ring`        | Set when the element is keyboard focused\n`readonly`          | Set when the element is readonly\n`invalid`           | Set when the element is invalid\n`has-label`         | Set when the element has a label\n`has-value`         | Set when the element has a value\n`has-helper`        | Set when the element has helper text\n`has-error-message` | Set when the element has an error message\n`has-tooltip`       | Set when the element has a slotted tooltip\n\nThe following custom CSS properties are available for styling:\n\nCustom CSS property                                |\n:--------------------------------------------------|\n| `--vaadin-date-time-picker-gap`                  |\n| `--vaadin-input-field-error-color`               |\n| `--vaadin-input-field-error-font-size`           |\n| `--vaadin-input-field-error-font-weight`         |\n| `--vaadin-input-field-error-line-height`         |\n| `--vaadin-input-field-label-color`               |\n| `--vaadin-input-field-label-font-size`           |\n| `--vaadin-input-field-label-font-weight`         |\n| `--vaadin-input-field-label-line-height`         |\n| `--vaadin-input-field-helper-color`              |\n| `--vaadin-input-field-helper-font-size`          |\n| `--vaadin-input-field-helper-font-weight`        |\n| `--vaadin-input-field-helper-line-height`        |\n| `--vaadin-input-field-required-indicator-color`  |\n| `--vaadin-input-field-required-indicator`        |\n\n### Internal components\n\nThe following components are created by `<vaadin-date-time-picker>` and placed in light DOM:\n\n- [`<vaadin-date-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha14/#/elements/vaadin-date-picker).\n- [`<vaadin-time-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha14/#/elements/vaadin-time-picker).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.\n\n### Change events\n\nDepending on the nature of the value change that the user attempts to commit e.g. by pressing Enter,\nthe component can fire either a `change` event or an `unparsable-change` event:\n\nValue change             | Event\n:------------------------|:------------------\nempty => parsable        | change\nempty => unparsable      | unparsable-change\nparsable => empty        | change\nparsable => parsable     | change\nparsable => unparsable   | change\nunparsable => empty      | unparsable-change\nunparsable => parsable   | change\nunparsable => unparsable | unparsable-change\nincomplete => empty      | unparsable-change\nincomplete => parsable   | change\nincomplete => unparsable | unparsable-change\nempty => incomplete      | unparsable-change\nparsable => incomplete   | change\nunparsable => incomplete | unparsable-change",
           "extension": true,
           "attributes": [
             {
@@ -68,6 +68,13 @@
                 "kind": "expression"
               }
             },
+            {
+              "name": ".defaultTime",
+              "description": "The time part to set automatically when the user commits a date while\nthe time picker is empty.\n\nSupports same time formats as the `value` property, without the date\npart. Precision exceeding the one defined by `step` is discarded,\ne.g. `09:30:45` is applied as `09:30` with the default `step`.\n\nThe time part is set when a date is committed while the time picker\nis empty — never for programmatic or initial values. A value outside\n`min` / `max` is applied as-is and makes the field invalid.\n\nWhen not set, selecting a date leaves the time part empty. A string\nthat is not a valid ISO 8601 time is ignored and logs a warning.",
+              "value": {
+                "kind": "expression"
+              }
+            },
             {
               "name": "?disabled",
               "description": "If true, the user cannot interact with this element.",
@@ -91,7 +98,7 @@
             },
             {
               "name": ".i18n",
-              "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following structure and default values:\n\n```js\n{\n  // Accessible label to the date picker.\n  // The property works in conjunction with label and accessibleName defined on the field.\n  // If both properties are defined, then accessibleName takes precedence.\n  // Then, the dateLabel value is concatenated with it.\n  dateLabel: undefined;\n\n  // Accessible label to the time picker.\n  // The property works in conjunction with label and accessibleName defined on the field.\n  // If both properties are defined, then accessibleName takes precedence.\n  // Then, the dateLabel value is concatenated with it.\n  timeLabel: undefined;\n}\n```\n\nAdditionally, all i18n properties from\n[`<vaadin-date-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha12/#/elements/vaadin-date-picker) and\n[`<vaadin-time-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha12/#/elements/vaadin-time-picker) are supported.",
+              "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following structure and default values:\n\n```js\n{\n  // Accessible label to the date picker.\n  // The property works in conjunction with label and accessibleName defined on the field.\n  // If both properties are defined, then accessibleName takes precedence.\n  // Then, the dateLabel value is concatenated with it.\n  dateLabel: undefined;\n\n  // Accessible label to the time picker.\n  // The property works in conjunction with label and accessibleName defined on the field.\n  // If both properties are defined, then accessibleName takes precedence.\n  // Then, the dateLabel value is concatenated with it.\n  timeLabel: undefined;\n}\n```\n\nAdditionally, all i18n properties from\n[`<vaadin-date-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha14/#/elements/vaadin-date-picker) and\n[`<vaadin-time-picker>`](https://cdn.vaadin.com/vaadin-web-components/25.3.0-alpha14/#/elements/vaadin-time-picker) are supported.",
               "value": {
                 "kind": "expression"
               }