@vaadin/date-picker 23.3.0-alpha5 → 24.0.0-alpha2

package/theme/lumo/vaadin-date-picker-overlay-content-styles.js

@@ -4,6 +4,7 @@ import '@vaadin/vaadin-lumo-styles/spacing.js';
 import '@vaadin/vaadin-lumo-styles/style.js';
 import '@vaadin/vaadin-lumo-styles/typography.js';
 import '@vaadin/button/theme/lumo/vaadin-button.js';
+import './vaadin-date-picker-year-styles.js';
 import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 registerStyles(
@@ -19,9 +20,7 @@ registerStyles(
       cursor: default;
     }
 
-    /* Month scroller */
-
-    [part='months'] {
+    ::slotted([slot='months']) {
       /* Month calendar height:
               header height + margin-bottom
             + weekdays height + margin-bottom
@@ -43,8 +42,7 @@ registerStyles(
       margin-right: 57px;
     }
 
-    /* Year scroller */
-    [part='years'] {
+    ::slotted([slot='years']) {
       /* TODO get rid of fixed magic number */
       --vaadin-infinite-scroller-buffer-width: 97px;
       width: 57px;
@@ -58,15 +56,8 @@ registerStyles(
       cursor: var(--lumo-clickable-cursor);
     }
 
-    [part='year-number']:not([current]),
-    [part='year-separator'] {
-      opacity: 0.7;
-      transition: 0.2s opacity;
-    }
-
-    [part='years']:hover [part='year-number'],
-    [part='years']:hover [part='year-separator'] {
-      opacity: 1;
+    ::slotted([slot='years']:hover) {
+      --_lumo-date-picker-year-opacity: 1;
     }
 
     /* TODO unsupported selector */
@@ -75,14 +66,13 @@ registerStyles(
       display: block;
     }
 
-    /* TODO unsupported selector, should fix this in vaadin-date-picker that it adapts to the
-       * width of the year scroller */
-    #scrollers[desktop] [part='months'] {
+    /* TODO fix this in vaadin-date-picker that it adapts to the width of the year scroller */
+    :host([desktop]) ::slotted([slot='months']) {
       right: auto;
     }
 
     /* Year scroller position indicator */
-    [part='years']::before {
+    ::slotted([slot='years'])::before {
       border: none;
       width: 1em;
       height: 1em;
@@ -94,37 +84,13 @@ registerStyles(
       z-index: 1;
     }
 
-    [part='year-number'],
-    [part='year-separator'] {
-      display: flex;
-      align-items: center;
-      justify-content: center;
-      height: 50%;
-      transform: translateY(-50%);
-    }
-
-    [part='years'] [part='year-separator']::after {
-      color: var(--lumo-disabled-text-color);
-      content: '•';
-    }
-
-    /* Current year */
-
-    [part='years'] [part='year-number'][current] {
-      color: var(--lumo-primary-text-color);
-    }
-
-    /* Toolbar (footer) */
-
     [part='toolbar'] {
       padding: var(--lumo-space-s);
       border-bottom-left-radius: var(--lumo-border-radius-l);
       margin-right: 57px;
     }
 
-    /* Today and Cancel buttons */
-
-    [part='toolbar'] [part\$='button'] {
+    [part='toolbar'] ::slotted(vaadin-button) {
       margin: 0;
     }
 
@@ -177,22 +143,19 @@ registerStyles(
         background-image: none;
       }
 
-      [part='years'] {
-        background-color: var(--lumo-shade-5pct);
-      }
-
       [part='toolbar'],
-      [part='months'] {
+      ::slotted([slot='months']) {
         margin-right: 0;
       }
 
       /* TODO make date-picker adapt to the width of the years part */
-      [part='years'] {
+      ::slotted([slot='years']) {
         --vaadin-infinite-scroller-buffer-width: 90px;
         width: 50px;
+        background-color: var(--lumo-shade-5pct);
       }
 
-      :host([years-visible]) [part='months'] {
+      :host([years-visible]) ::slotted([slot='months']) {
         padding-left: 50px;
       }
     }

package/theme/lumo/vaadin-date-picker-year-styles.js

@@ -0,0 +1,32 @@
+import '@vaadin/vaadin-lumo-styles/color.js';
+import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
+
+registerStyles(
+  'vaadin-date-picker-year',
+  css`
+    :host([current]) [part='year-number'] {
+      color: var(--lumo-primary-text-color);
+    }
+
+    :host(:not([current])) [part='year-number'],
+    [part='year-separator'] {
+      opacity: var(--_lumo-date-picker-year-opacity, 0.7);
+      transition: 0.2s opacity;
+    }
+
+    [part='year-number'],
+    [part='year-separator'] {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      height: 50%;
+      transform: translateY(-50%);
+    }
+
+    [part='year-separator']::after {
+      color: var(--lumo-disabled-text-color);
+      content: '•';
+    }
+  `,
+  { moduleId: 'lumo-date-picker-year' },
+);

package/theme/lumo/vaadin-month-calendar-styles.js

@@ -50,7 +50,7 @@ registerStyles(
 
     /* Date and week number cells */
 
-    [part='date'],
+    [part~='date'],
     [part='week-number'] {
       box-sizing: border-box;
       display: inline-flex;
@@ -60,28 +60,28 @@ registerStyles(
       position: relative;
     }
 
-    [part='date'] {
+    [part~='date'] {
       transition: color 0.1s;
     }
 
-    [part='date']:not(:empty) {
+    [part~='date']:not(:empty) {
       cursor: var(--lumo-clickable-cursor);
     }
 
     :host([week-numbers]) [part='weekday']:not(:empty),
-    :host([week-numbers]) [part='date'] {
+    :host([week-numbers]) [part~='date'] {
       width: calc((100% - var(--lumo-size-xs)) / 7);
     }
 
     /* Today date */
 
-    [part='date'][today] {
+    [part~='date'][part~='today'] {
       color: var(--lumo-primary-text-color);
     }
 
     /* Focused date */
 
-    [part='date']::before {
+    [part~='date']::before {
       content: '';
       position: absolute;
       z-index: -1;
@@ -97,11 +97,11 @@ registerStyles(
       border-radius: var(--lumo-border-radius-m);
     }
 
-    [part='date'][focused]::before {
+    [part~='date'][part~='focused']::before {
       box-shadow: 0 0 0 1px var(--lumo-base-color), 0 0 0 3px var(--lumo-primary-color-50pct);
     }
 
-    :host(:not([focused])) [part='date'][focused]::before {
+    :host(:not([focused])) [part~='date'][part~='focused']::before {
       animation: vaadin-date-picker-month-calendar-focus-date 1.4s infinite;
     }
 
@@ -111,33 +111,33 @@ registerStyles(
       }
     }
 
-    [part='date']:not(:empty):not([disabled]):not([selected]):hover::before {
+    [part~='date']:not(:empty):not([part~='disabled']):not([part~='selected']):hover::before {
       background-color: var(--lumo-primary-color-10pct);
     }
 
-    [part='date'][selected] {
+    [part~='date'][part~='selected'] {
       color: var(--lumo-primary-contrast-color);
     }
 
-    [part='date'][selected]::before {
+    [part~='date'][part~='selected']::before {
       background-color: var(--lumo-primary-color);
     }
 
-    [part='date'][disabled] {
+    [part~='date'][part~='disabled'] {
       color: var(--lumo-disabled-text-color);
     }
 
     @media (pointer: coarse) {
-      [part='date']:hover:not([selected])::before,
-      [part='date'][focused]:not([selected])::before {
+      [part~='date']:hover:not([part~='selected'])::before,
+      [part~='focused']:not([part~='selected'])::before {
         display: none;
       }
 
-      [part='date']:not(:empty):not([disabled]):active::before {
+      [part~='date']:not(:empty):not([part~='disabled']):active::before {
         display: block;
       }
 
-      [part='date'][selected]::before {
+      [part~='date'][part~='selected']::before {
         box-shadow: none;
       }
     }

package/theme/material/vaadin-date-picker-overlay-content-styles.js

@@ -3,6 +3,7 @@ import '@vaadin/vaadin-material-styles/font-icons.js';
 import '@vaadin/vaadin-material-styles/typography.js';
 import '@vaadin/vaadin-material-styles/shadow.js';
 import '@vaadin/button/theme/material/vaadin-button.js';
+import './vaadin-date-picker-year-styles.js';
 import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
 
 registerStyles(
@@ -20,13 +21,10 @@ registerStyles(
       position: absolute;
     }
 
-    /* Fullscreen Toolbar */
-
     [part='overlay-header'] {
       display: flex;
       align-items: baseline;
       position: relative;
-      z-index: 2;
       color: var(--material-body-text-color);
       background: var(--material-secondary-background-color);
       border-bottom: 2px solid var(--material-primary-color);
@@ -89,24 +87,21 @@ registerStyles(
       transform: rotate(90deg);
     }
 
-    /* Month scroller */
-
-    [part='months'] {
+    ::slotted([slot='months']) {
       --vaadin-infinite-scroller-item-height: 328px;
       text-align: center;
     }
 
-    /* Year scroller */
-
-    [part='years'] {
-      z-index: 1;
+    ::slotted([slot='years']) {
       background: var(--material-secondary-text-color);
       color: var(--material-background-color);
+      font-size: var(--material-body-font-size);
+      font-weight: 400;
+      line-height: 1.4;
       text-align: center;
     }
 
-    [part='years']::before {
-      z-index: 2;
+    ::slotted([slot='years'])::before {
       border: 0;
       width: 8px;
       height: 8px;
@@ -114,21 +109,6 @@ registerStyles(
       background: var(--material-background-color);
     }
 
-    [part='year-number'] {
-      font-size: var(--material-small-font-size);
-      line-height: 10px; /* NOTE(platosha): chosen to align years to months */
-    }
-
-    [part='year-separator'] {
-      background-color: currentColor;
-      width: 4px;
-      height: 4px;
-      border-radius: 50%;
-      margin: calc(0.5 * var(--vaadin-infinite-scroller-item-height, 80px) - 0.5 * 10px - 0.5 * 4px) auto;
-    }
-
-    /* Bottom Bar */
-
     [part='toolbar'] {
       display: flex;
       justify-content: flex-end;
@@ -136,16 +116,15 @@ registerStyles(
       border-top: 1px solid var(--material-divider-color);
     }
 
-    [part='cancel-button'] {
+    ::slotted([slot='cancel-button']) {
       order: 1;
     }
 
-    [part='today-button'] {
+    ::slotted([slot='today-button']) {
       order: 2;
     }
 
-    [part='today-button'],
-    [part='cancel-button'] {
+    ::slotted(vaadin-button) {
       margin: 0 4px;
     }
   `,

package/theme/material/vaadin-date-picker-year-styles.js

@@ -0,0 +1,28 @@
+import '@vaadin/vaadin-material-styles/typography.js';
+import { css, registerStyles } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js';
+
+registerStyles(
+  'vaadin-date-picker-year',
+  css`
+    [part='year-number'] {
+      font-size: var(--material-small-font-size);
+      line-height: 10px; /* NOTE(platosha): chosen to align years to months */
+    }
+
+    [part='year-separator'] {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      height: calc(100% - 10px);
+    }
+
+    [part='year-separator']::before {
+      content: '';
+      background-color: currentColor;
+      width: 4px;
+      height: 4px;
+      border-radius: 50%;
+    }
+  `,
+  { moduleId: 'material-date-picker-year' },
+);

package/theme/material/vaadin-month-calendar-styles.js

@@ -35,7 +35,7 @@ registerStyles(
       color: var(--material-disabled-text-color);
     }
 
-    [part='date'] {
+    [part~='date'] {
       position: relative;
       font-size: var(--material-body-font-size);
       line-height: 42px;
@@ -43,7 +43,7 @@ registerStyles(
       cursor: default;
     }
 
-    [part='date']::after {
+    [part~='date']::after {
       content: '';
       position: absolute;
       z-index: -4;
@@ -59,13 +59,13 @@ registerStyles(
 
     /* Today */
 
-    [part='date'][today] {
+    [part~='date'][part~='today'] {
       color: var(--material-primary-text-color);
     }
 
     /* Hover */
 
-    [part='date']:not([disabled]):hover::after {
+    [part~='date']:not([part~='disabled']):hover::after {
       background-color: var(--material-secondary-background-color);
       border-color: var(--material-secondary-background-color);
       z-index: -3;
@@ -73,7 +73,7 @@ registerStyles(
 
     /* Hide for touch devices */
     @media (hover: none) {
-      [part='date']:not([disabled]):hover::after {
+      [part~='date']:not([part~='disabled']):hover::after {
         background-color: transparent;
         border-color: transparent;
         z-index: -4;
@@ -82,12 +82,12 @@ registerStyles(
 
     /* Selected */
 
-    [part='date'][selected] {
+    [part~='date'][part~='selected'] {
       font-weight: 500;
     }
 
-    [part='date']:not([disabled])[selected]::after,
-    [part='date'][selected]::after {
+    [part~='date']:not([part~='disabled'])[part~='selected']::after,
+    [part~='date'][part~='selected']::after {
       background-color: transparent;
       border-color: currentColor;
       z-index: -2;
@@ -95,24 +95,24 @@ registerStyles(
 
     /* Focused */
 
-    [part='date']:not([disabled])[focused],
-    [part='date']:not([disabled]):active {
+    [part~='date']:not([part~='disabled'])[part~='focused'],
+    [part~='date']:not([part~='disabled']):active {
       color: var(--material-primary-contrast-color);
     }
 
-    [part='date']:not([disabled])[focused]::after,
-    [part='date']:not([disabled]):active::after {
+    [part~='date']:not([part~='disabled'])[part~='focused']::after,
+    [part~='date']:not([part~='disabled']):active::after {
       opacity: 0.7;
       background-color: var(--material-primary-color);
       border-color: var(--material-primary-color);
       z-index: -1;
     }
 
-    [part='date'][disabled] {
+    [part~='date'][part~='disabled'] {
       color: var(--material-disabled-text-color);
     }
 
-    :host([focused]) [part='date']:not([disabled])[focused]::after {
+    :host([focused]) [part~='date']:not([part~='disabled'])[part~='focused']::after {
       opacity: 1;
     }
   `,

package/web-types.json

@@ -1,14 +1,14 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@vaadin/date-picker",
-  "version": "23.3.0-alpha5",
+  "version": "24.0.0-alpha2",
   "description-markup": "markdown",
   "contributions": {
     "html": {
       "elements": [
         {
           "name": "vaadin-date-picker-light",
-          "description": "`<vaadin-date-picker-light>` is a customizable version of the `<vaadin-date-picker>` providing\nonly the scrollable month calendar view and leaving the input field definition to the user.\n\nTo create a custom input field, you need to add a child element which has a two-way\ndata-bindable property representing the input value. The property name is expected\nto be `bindValue` by default. See the example below for a simplest possible example\nusing an `<input>` element.\n\n```html\n<vaadin-date-picker-light attr-for-value=\"value\">\n  <input class=\"input\">\n</vaadin-date-picker-light>\n```\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name | Description | Theme for Element\n----------------|----------------|----------------\n`overlay-content` | The overlay element | vaadin-date-picker-light\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/custom-theme/styling-components) documentation.\n\nIn addition to `<vaadin-date-picker-light>` itself, the following\ninternal components are themable:\n\n- `<vaadin-date-picker-overlay>`\n- `<vaadin-date-picker-overlay-content>`\n- `<vaadin-month-calendar>`\n\nNote: the `theme` attribute value set on `<vaadin-date-picker-light>`\nis propagated to the internal themable components listed above.",
+          "description": "`<vaadin-date-picker-light>` is a customizable version of the `<vaadin-date-picker>` providing\nonly the scrollable month calendar view and leaving the input field definition to the user.\n\nTo create a custom input field, you need to add a child element which has a two-way\ndata-bindable property representing the input value. The property name is expected\nto be `bindValue` by default. See the example below for a simplest possible example\nusing an `<input>` element.\n\n```html\n<vaadin-date-picker-light attr-for-value=\"value\">\n  <input class=\"input\">\n</vaadin-date-picker-light>\n```\n\n### Styling\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/custom-theme/styling-components) documentation.\n\nIn addition to `<vaadin-date-picker-light>` itself, the following\ninternal components are themable:\n\n- `<vaadin-date-picker-overlay>`\n- `<vaadin-date-picker-overlay-content>`\n- `<vaadin-month-calendar>`\n\nNote: the `theme` attribute value set on `<vaadin-date-picker-light>`\nis propagated to the internal themable components listed above.",
           "attributes": [
             {
               "name": "value",
@@ -161,7 +161,7 @@
               },
               {
                 "name": "i18n",
-                "description": "The object used to localize this component.\nTo change the default localization, replace the entire\n`i18n` object with a custom one.\n\nTo update individual properties, extend the existing i18n object like so:\n```\ndatePicker.i18n = { ...datePicker.i18n, {\n  formatDate: date => { ... },\n  parseDate: value => { ... },\n}};\n```\n\nThe object has the following JSON structure and default values:\n\n```\n{\n  // An array with the full names of months starting\n  // with January.\n  monthNames: [\n    'January', 'February', 'March', 'April', 'May',\n    'June', 'July', 'August', 'September',\n    'October', 'November', 'December'\n  ],\n\n  // An array of weekday names starting with Sunday. Used\n  // in screen reader announcements.\n  weekdays: [\n    'Sunday', 'Monday', 'Tuesday', 'Wednesday',\n    'Thursday', 'Friday', 'Saturday'\n  ],\n\n  // An array of short weekday names starting with Sunday.\n  // Displayed in the calendar.\n  weekdaysShort: [\n    'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'\n  ],\n\n  // An integer indicating the first day of the week\n  // (0 = Sunday, 1 = Monday, etc.).\n  firstDayOfWeek: 0,\n\n  // Used in screen reader announcements along with week\n  // numbers, if they are displayed.\n  week: 'Week',\n\n  // Translation of the Calendar icon button title.\n  calendar: 'Calendar',\n\n  // Translation of the Today shortcut button text.\n  today: 'Today',\n\n  // Translation of the Cancel button text.\n  cancel: 'Cancel',\n\n  // Used for adjusting the year value when parsing dates with short years.\n  // The year values between 0 and 99 are evaluated and adjusted.\n  // Example: for a referenceDate of 1970-10-30;\n  //   dateToBeParsed: 40-10-30, result: 1940-10-30\n  //   dateToBeParsed: 80-10-30, result: 1980-10-30\n  //   dateToBeParsed: 10-10-30, result: 2010-10-30\n  // Supported date format: ISO 8601 `\"YYYY-MM-DD\"` (default)\n  // The default value is the current date.\n  referenceDate: '',\n\n  // A function to format given `Object` as\n  // date string. Object is in the format `{ day: ..., month: ..., year: ... }`\n  // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n  formatDate: d => {\n    // returns a string representation of the given\n    // object in 'MM/DD/YYYY' -format\n  },\n\n  // A function to parse the given text to an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n  // Must properly parse (at least) text formatted by `formatDate`.\n  // Setting the property to null will disable keyboard input feature.\n  // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n  parseDate: text => {\n    // Parses a string in 'MM/DD/YY', 'MM/DD' or 'DD' -format to\n    // an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n  }\n\n  // A function to format given `monthName` and\n  // `fullYear` integer as calendar title string.\n  formatTitle: (monthName, fullYear) => {\n    return monthName + ' ' + fullYear;\n  }\n}\n```",
+                "description": "The object used to localize this component.\nTo change the default localization, replace the entire\n`i18n` object with a custom one.\n\nTo update individual properties, extend the existing i18n object like so:\n```\ndatePicker.i18n = { ...datePicker.i18n, {\n  formatDate: date => { ... },\n  parseDate: value => { ... },\n}};\n```\n\nThe object has the following JSON structure and default values:\n\n```\n{\n  // An array with the full names of months starting\n  // with January.\n  monthNames: [\n    'January', 'February', 'March', 'April', 'May',\n    'June', 'July', 'August', 'September',\n    'October', 'November', 'December'\n  ],\n\n  // An array of weekday names starting with Sunday. Used\n  // in screen reader announcements.\n  weekdays: [\n    'Sunday', 'Monday', 'Tuesday', 'Wednesday',\n    'Thursday', 'Friday', 'Saturday'\n  ],\n\n  // An array of short weekday names starting with Sunday.\n  // Displayed in the calendar.\n  weekdaysShort: [\n    'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'\n  ],\n\n  // An integer indicating the first day of the week\n  // (0 = Sunday, 1 = Monday, etc.).\n  firstDayOfWeek: 0,\n\n  // Translation of the Today shortcut button text.\n  today: 'Today',\n\n  // Translation of the Cancel button text.\n  cancel: 'Cancel',\n\n  // Used for adjusting the year value when parsing dates with short years.\n  // The year values between 0 and 99 are evaluated and adjusted.\n  // Example: for a referenceDate of 1970-10-30;\n  //   dateToBeParsed: 40-10-30, result: 1940-10-30\n  //   dateToBeParsed: 80-10-30, result: 1980-10-30\n  //   dateToBeParsed: 10-10-30, result: 2010-10-30\n  // Supported date format: ISO 8601 `\"YYYY-MM-DD\"` (default)\n  // The default value is the current date.\n  referenceDate: '',\n\n  // A function to format given `Object` as\n  // date string. Object is in the format `{ day: ..., month: ..., year: ... }`\n  // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n  formatDate: d => {\n    // returns a string representation of the given\n    // object in 'MM/DD/YYYY' -format\n  },\n\n  // A function to parse the given text to an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n  // Must properly parse (at least) text formatted by `formatDate`.\n  // Setting the property to null will disable keyboard input feature.\n  // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n  parseDate: text => {\n    // Parses a string in 'MM/DD/YY', 'MM/DD' or 'DD' -format to\n    // an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n  }\n\n  // A function to format given `monthName` and\n  // `fullYear` integer as calendar title string.\n  formatTitle: (monthName, fullYear) => {\n    return monthName + ' ' + fullYear;\n  }\n}\n```",
                 "value": {
                   "type": [
                     "DatePickerI18n"
@@ -216,7 +216,7 @@
         },
         {
           "name": "vaadin-date-picker",
-          "description": "`<vaadin-date-picker>` is an input field that allows to enter a date by typing or by selecting from a calendar overlay.\n\n```html\n<vaadin-date-picker label=\"Birthday\"></vaadin-date-picker>\n```\n```js\ndatePicker.value = '2016-03-02';\n```\n\nWhen the selected `value` is changed, a `value-changed` event is triggered.\n\n### Styling\n\nThe following custom properties are available for styling:\n\nCustom property                | Description                | Default\n-------------------------------|----------------------------|---------\n`--vaadin-field-default-width` | Default width of the field | `12em`\n\n`<vaadin-date-picker>` provides the same set of shadow DOM parts and state attributes as `<vaadin-text-field>`.\nSee [`<vaadin-text-field>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha5/#/elements/vaadin-text-field) for the styling documentation.\n\nIn addition to `<vaadin-text-field>` parts, the following parts are available for theming:\n\nPart name             | Description\n----------------------|--------------------\n`toggle-button`       | Toggle button\n`overlay-content`     | The overlay element\n\nIn addition to `<vaadin-text-field>` state attributes, the following state attributes are available for theming:\n\nAttribute  | Description                                      | Part name\n-----------|--------------------------------------------------|-----------\n`opened`   | Set when the date selector overlay is opened     | :host\n`today`    | Set on the date corresponding to the current day | date\n`selected` | Set on the selected date                         | date\n\nIf you want to replace the default `<input>` and its container with a custom implementation to get full control\nover the input field, consider using the [`<vaadin-date-picker-light>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha5/#/elements/vaadin-date-picker-light) element.\n\n### Internal components\n\nIn addition to `<vaadin-date-picker>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-date-picker-overlay>` - has the same API as [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha5/#/elements/vaadin-overlay).\n- `<vaadin-date-picker-overlay-content>`\n- `<vaadin-month-calendar>`\n- [`<vaadin-input-container>`](https://cdn.vaadin.com/vaadin-web-components/23.3.0-alpha5/#/elements/vaadin-input-container) - an internal element wrapping the input.\n\nIn order to style the overlay content, use `<vaadin-date-picker-overlay-content>` shadow DOM parts:\n\nPart name             | Description\n----------------------|--------------------\n`overlay-header`      | Fullscreen mode header\n`label`               | Fullscreen mode value/label\n`clear-button`        | Fullscreen mode clear button\n`toggle-button`       | Fullscreen mode toggle button\n`years-toggle-button` | Fullscreen mode years scroller toggle\n`months`              | Months scroller\n`years`               | Years scroller\n`toolbar`             | Footer bar with buttons\n`today-button`        | Today button\n`cancel-button`       | Cancel button\n`month`               | Month calendar\n`year-number`         | Year number\n`year-separator`      | Year separator\n\nIn order to style the month calendar, use `<vaadin-month-calendar>` shadow DOM parts:\n\nPart name             | Description\n----------------------|--------------------\n`month-header`        | Month title\n`weekdays`            | Weekday container\n`weekday`             | Weekday element\n`week-numbers`        | Week numbers container\n`week-number`         | Week number element\n`date`                | Date element\n\nNote: the `theme` attribute value set on `<vaadin-date-picker>` is\npropagated to the internal components listed above.\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/custom-theme/styling-components) documentation.",
+          "description": "`<vaadin-date-picker>` is an input field that allows to enter a date by typing or by selecting from a calendar overlay.\n\n```html\n<vaadin-date-picker label=\"Birthday\"></vaadin-date-picker>\n```\n```js\ndatePicker.value = '2016-03-02';\n```\n\nWhen the selected `value` is changed, a `value-changed` event is triggered.\n\n### Styling\n\nThe following custom properties are available for styling:\n\nCustom property                | Description                | Default\n-------------------------------|----------------------------|---------\n`--vaadin-field-default-width` | Default width of the field | `12em`\n\n`<vaadin-date-picker>` provides the same set of shadow DOM parts and state attributes as `<vaadin-text-field>`.\nSee [`<vaadin-text-field>`](https://cdn.vaadin.com/vaadin-web-components/24.0.0-alpha2/#/elements/vaadin-text-field) for the styling documentation.\n\nIn addition to `<vaadin-text-field>` parts, the following parts are available for theming:\n\nPart name             | Description\n----------------------|--------------------\n`toggle-button`       | Toggle button\n\nIn addition to `<vaadin-text-field>` state attributes, the following state attributes are available for theming:\n\nAttribute  | Description                                      | Part name\n-----------|--------------------------------------------------|-----------\n`opened`   | Set when the date selector overlay is opened     | :host\n\nIf you want to replace the default `<input>` and its container with a custom implementation to get full control\nover the input field, consider using the [`<vaadin-date-picker-light>`](https://cdn.vaadin.com/vaadin-web-components/24.0.0-alpha2/#/elements/vaadin-date-picker-light) element.\n\n### Internal components\n\nIn addition to `<vaadin-date-picker>` itself, the following internal\ncomponents are themable:\n\n- `<vaadin-date-picker-overlay>` - has the same API as [`<vaadin-overlay>`](https://cdn.vaadin.com/vaadin-web-components/24.0.0-alpha2/#/elements/vaadin-overlay).\n- `<vaadin-date-picker-overlay-content>`\n- `<vaadin-date-picker-month-scroller>`\n- `<vaadin-date-picker-year-scroller>`\n- `<vaadin-date-picker-year>`\n- `<vaadin-month-calendar>`\n- [`<vaadin-input-container>`](https://cdn.vaadin.com/vaadin-web-components/24.0.0-alpha2/#/elements/vaadin-input-container) - an internal element wrapping the input.\n\nIn order to style the overlay content, use `<vaadin-date-picker-overlay-content>` shadow DOM parts:\n\nPart name             | Description\n----------------------|--------------------\n`overlay-header`      | Fullscreen mode header\n`label`               | Fullscreen mode value/label\n`clear-button`        | Fullscreen mode clear button\n`toggle-button`       | Fullscreen mode toggle button\n`years-toggle-button` | Fullscreen mode years scroller toggle\n`toolbar`             | Footer bar with slotted buttons\n\nThe following state attributes are available on the `<vaadin-date-picker-overlay-content>` element:\n\nAttribute       | Description\n----------------|-------------------------------------------------\n`desktop`       | Set when the overlay content is in desktop mode\n`fullscreen`    | Set when the overlay content is in fullscreen mode\n`years-visible` | Set when the year scroller is visible in fullscreen mode\n\nIn order to style the month calendar, use `<vaadin-month-calendar>` shadow DOM parts:\n\nPart name             | Description\n----------------------|--------------------\n`month-header`        | Month title\n`weekdays`            | Weekday container\n`weekday`             | Weekday element\n`week-numbers`        | Week numbers container\n`week-number`         | Week number element\n`date`                | Date element\n`disabled`            | Disabled date element\n`focused`             | Focused date element\n`selected`            | Selected date element\n`today`               | Date element corresponding to the current day\n\nIn order to style year scroller elements, use `<vaadin-date-picker-year>` shadow DOM parts:\n\nPart name             | Description\n----------------------|--------------------\n`year-number`         | Year number\n`year-separator`      | Year separator\n\nNote: the `theme` attribute value set on `<vaadin-date-picker>` is\npropagated to the internal components listed above.\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/custom-theme/styling-components) documentation.",
           "attributes": [
             {
               "name": "disabled",
@@ -668,7 +668,7 @@
               },
               {
                 "name": "i18n",
-                "description": "The object used to localize this component.\nTo change the default localization, replace the entire\n`i18n` object with a custom one.\n\nTo update individual properties, extend the existing i18n object like so:\n```\ndatePicker.i18n = { ...datePicker.i18n, {\n  formatDate: date => { ... },\n  parseDate: value => { ... },\n}};\n```\n\nThe object has the following JSON structure and default values:\n\n```\n{\n  // An array with the full names of months starting\n  // with January.\n  monthNames: [\n    'January', 'February', 'March', 'April', 'May',\n    'June', 'July', 'August', 'September',\n    'October', 'November', 'December'\n  ],\n\n  // An array of weekday names starting with Sunday. Used\n  // in screen reader announcements.\n  weekdays: [\n    'Sunday', 'Monday', 'Tuesday', 'Wednesday',\n    'Thursday', 'Friday', 'Saturday'\n  ],\n\n  // An array of short weekday names starting with Sunday.\n  // Displayed in the calendar.\n  weekdaysShort: [\n    'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'\n  ],\n\n  // An integer indicating the first day of the week\n  // (0 = Sunday, 1 = Monday, etc.).\n  firstDayOfWeek: 0,\n\n  // Used in screen reader announcements along with week\n  // numbers, if they are displayed.\n  week: 'Week',\n\n  // Translation of the Calendar icon button title.\n  calendar: 'Calendar',\n\n  // Translation of the Today shortcut button text.\n  today: 'Today',\n\n  // Translation of the Cancel button text.\n  cancel: 'Cancel',\n\n  // Used for adjusting the year value when parsing dates with short years.\n  // The year values between 0 and 99 are evaluated and adjusted.\n  // Example: for a referenceDate of 1970-10-30;\n  //   dateToBeParsed: 40-10-30, result: 1940-10-30\n  //   dateToBeParsed: 80-10-30, result: 1980-10-30\n  //   dateToBeParsed: 10-10-30, result: 2010-10-30\n  // Supported date format: ISO 8601 `\"YYYY-MM-DD\"` (default)\n  // The default value is the current date.\n  referenceDate: '',\n\n  // A function to format given `Object` as\n  // date string. Object is in the format `{ day: ..., month: ..., year: ... }`\n  // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n  formatDate: d => {\n    // returns a string representation of the given\n    // object in 'MM/DD/YYYY' -format\n  },\n\n  // A function to parse the given text to an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n  // Must properly parse (at least) text formatted by `formatDate`.\n  // Setting the property to null will disable keyboard input feature.\n  // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n  parseDate: text => {\n    // Parses a string in 'MM/DD/YY', 'MM/DD' or 'DD' -format to\n    // an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n  }\n\n  // A function to format given `monthName` and\n  // `fullYear` integer as calendar title string.\n  formatTitle: (monthName, fullYear) => {\n    return monthName + ' ' + fullYear;\n  }\n}\n```",
+                "description": "The object used to localize this component.\nTo change the default localization, replace the entire\n`i18n` object with a custom one.\n\nTo update individual properties, extend the existing i18n object like so:\n```\ndatePicker.i18n = { ...datePicker.i18n, {\n  formatDate: date => { ... },\n  parseDate: value => { ... },\n}};\n```\n\nThe object has the following JSON structure and default values:\n\n```\n{\n  // An array with the full names of months starting\n  // with January.\n  monthNames: [\n    'January', 'February', 'March', 'April', 'May',\n    'June', 'July', 'August', 'September',\n    'October', 'November', 'December'\n  ],\n\n  // An array of weekday names starting with Sunday. Used\n  // in screen reader announcements.\n  weekdays: [\n    'Sunday', 'Monday', 'Tuesday', 'Wednesday',\n    'Thursday', 'Friday', 'Saturday'\n  ],\n\n  // An array of short weekday names starting with Sunday.\n  // Displayed in the calendar.\n  weekdaysShort: [\n    'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'\n  ],\n\n  // An integer indicating the first day of the week\n  // (0 = Sunday, 1 = Monday, etc.).\n  firstDayOfWeek: 0,\n\n  // Translation of the Today shortcut button text.\n  today: 'Today',\n\n  // Translation of the Cancel button text.\n  cancel: 'Cancel',\n\n  // Used for adjusting the year value when parsing dates with short years.\n  // The year values between 0 and 99 are evaluated and adjusted.\n  // Example: for a referenceDate of 1970-10-30;\n  //   dateToBeParsed: 40-10-30, result: 1940-10-30\n  //   dateToBeParsed: 80-10-30, result: 1980-10-30\n  //   dateToBeParsed: 10-10-30, result: 2010-10-30\n  // Supported date format: ISO 8601 `\"YYYY-MM-DD\"` (default)\n  // The default value is the current date.\n  referenceDate: '',\n\n  // A function to format given `Object` as\n  // date string. Object is in the format `{ day: ..., month: ..., year: ... }`\n  // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n  formatDate: d => {\n    // returns a string representation of the given\n    // object in 'MM/DD/YYYY' -format\n  },\n\n  // A function to parse the given text to an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n  // Must properly parse (at least) text formatted by `formatDate`.\n  // Setting the property to null will disable keyboard input feature.\n  // Note: The argument month is 0-based. This means that January = 0 and December = 11.\n  parseDate: text => {\n    // Parses a string in 'MM/DD/YY', 'MM/DD' or 'DD' -format to\n    // an `Object` in the format `{ day: ..., month: ..., year: ... }`.\n  }\n\n  // A function to format given `monthName` and\n  // `fullYear` integer as calendar title string.\n  formatTitle: (monthName, fullYear) => {\n    return monthName + ' ' + fullYear;\n  }\n}\n```",
                 "value": {
                   "type": [
                     "DatePickerI18n"