@aurodesignsystem-dev/auro-formkit 0.0.0-pr593.0

package/components/datepicker/demo/api.md

@@ -0,0 +1,1479 @@
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../docs/api.md) -->
+<!-- The below content is automatically added from ./../docs/api.md -->
+
+# auro-datepicker
+
+## Properties
+
+| Property                          | Attribute                         | Modifiers | Type       | Default                                          | Description                                      |
+|-----------------------------------|-----------------------------------|-----------|------------|--------------------------------------------------|--------------------------------------------------|
+| [autoPlacement](#autoPlacement)                   | `autoPlacement`                   |           | `boolean`  | "false"                                          | If declared, bib's position will be automatically calculated where to appear. |
+| [calendarEndDate](#calendarEndDate)                 | `calendarEndDate`                 |           | `string`   | "undefined"                                      | The last date that may be displayed in the calendar. |
+| [calendarFocusDate](#calendarFocusDate)               | `calendarFocusDate`               |           | `string`   | "value"                                          | The date that will first be visually rendered to the user in the calendar. |
+| [calendarStartDate](#calendarStartDate)               | `calendarStartDate`               |           | `string`   | "undefined"                                      | The first date that may be displayed in the calendar. |
+| [centralDate](#centralDate)                     | `centralDate`                     |           | `string`   |                                                  | The date that determines the currently visible month. |
+| [disabled](#disabled)                        | `disabled`                        |           | `boolean`  | false                                            | If set, disables the datepicker.                 |
+| [error](#error)                           | `error`                           |           | `string`   |                                                  | When defined, sets persistent validity to `customError` and sets the validation message to the attribute value. |
+| [format](#format)                          | `format`                          |           | `string`   | "mm/dd/yyyy"                                     | Specifies the date format. The default is `mm/dd/yyyy`. |
+| [fullscreenBreakpoint](#fullscreenBreakpoint)            | `fullscreenBreakpoint`            |           | `string`   | "sm"                                             | Defines the screen size breakpoint (`xs`, `sm`, `md`, `lg`, `xl`, `disabled`)<br />at which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.<br /><br />When expanded, the dropdown will automatically display in fullscreen mode<br />if the screen size is equal to or smaller than the selected breakpoint. |
+| [inputmode](#inputmode)                       | `inputmode`                       |           | `string`   |                                                  | Exposes inputmode attribute for input.           |
+| [largeFullscreenHeadline](#largeFullscreenHeadline)         | `largeFullscreenHeadline`         |           | `boolean`  | false                                            | If declared, make bib.fullscreen.headline in HeadingDisplay.<br />Otherwise, Heading 600. |
+| [maxDate](#maxDate)                         | `maxDate`                         |           | `string`   |                                                  | Maximum date. All dates after will be disabled.  |
+| [minDate](#minDate)                         | `minDate`                         |           | `string`   |                                                  | Minimum date. All dates before will be disabled. |
+| [monthNames](#monthNames)                      | `monthNames`                      |           | `array`    | ["January","February","March","April","May","June","July","August","September","October","November","December"] | Names of all 12 months to render in the calendar, used for localization of date string in mobile layout. |
+| [noFlip](#noFlip)                          | `noFlip`                          |           | `boolean`  | "false"                                          | If declared, the bib will NOT flip to an alternate position<br />when there isn't enough space in the specified `placement`. |
+| [noValidate](#noValidate)                      | `noValidate`                      |           | `boolean`  | false                                            | If set, disables auto-validation on blur.        |
+| [offset](#offset)                          | `offset`                          |           | `number`   | "0"                                              | Gap between the trigger element and bib.         |
+| [onDark](#onDark)                          | `onDark`                          |           | `boolean`  | false                                            | If declared, onDark styles will be applied to the trigger. |
+| [placement](#placement)                       | `placement`                       |           | `string`   | "bottom-start"                                   | Position where the bib should appear relative to the trigger.<br />Accepted values:<br />"top" \| "right" \| "bottom" \| "left" \|<br />"bottom-start" \| "top-start" \| "top-end" \|<br />"right-start" \| "right-end" \| "bottom-end" \|<br />"left-start" \| "left-end" |
+| [range](#range)                           | `range`                           |           | `boolean`  | false                                            | If set, turns on date range functionality in auro-calendar. |
+| [required](#required)                        | `required`                        |           | `boolean`  | false                                            | Populates the `required` attribute on the input. Used for client-side validation. |
+| [setCustomValidity](#setCustomValidity)               | `setCustomValidity`               |           | `string`   |                                                  | Sets a custom help text message to display for all validityStates. |
+| [setCustomValidityCustomError](#setCustomValidityCustomError)    | `setCustomValidityCustomError`    |           | `string`   |                                                  | Custom help text message to display when validity = `customError`. |
+| [setCustomValidityRangeOverflow](#setCustomValidityRangeOverflow)  | `setCustomValidityRangeOverflow`  |           | `string`   |                                                  | Custom help text message to display when validity = `rangeOverflow`. |
+| [setCustomValidityRangeUnderflow](#setCustomValidityRangeUnderflow) | `setCustomValidityRangeUnderflow` |           | `string`   |                                                  | Custom help text message to display when validity = `rangeUnderflow`. |
+| [setCustomValidityValueMissing](#setCustomValidityValueMissing)   | `setCustomValidityValueMissing`   |           | `string`   |                                                  | Custom help text message to display when validity = `valueMissing`. |
+| [stacked](#stacked)                         | `stacked`                         |           | `boolean`  | false                                            | Set true to make datepicker stacked style.       |
+| [validity](#validity)                        | `validity`                        |           | `string`   | "undefined"                                      | Specifies the `validityState` this element is in. |
+| [value](#value)                           | `value`                           |           | `string`   | "undefined"                                      | Value selected for the datepicker.               |
+| [valueEnd](#valueEnd)                        | `valueEnd`                        |           | `string`   | "undefined"                                      | Value selected for the second datepicker when using date range. |
+| [values](#values)                          |                                   | readonly  | `string[]` |                                                  | A convenience wrapper for `value` and `valueEnd`, uses the new Auro "array value pattern". |
+
+## Methods
+
+| Method     | Type                                   | Description                                      |
+|------------|----------------------------------------|--------------------------------------------------|
+| [focus](#focus)    | `(focusInput: string): void`           | Focuses the datepicker trigger input.<br /><br />**focusInput**: Pass in `endDate` to focus on the return input. No parameter is needed to focus on the depart input. |
+| [reset](#reset)    | `(): void`                             | Resets component to initial state.               |
+| [validate](#validate) | `(force?: boolean \| undefined): void` | Validates value.<br /><br />**force**: Whether to force validation. |
+
+## Events
+
+| Event                           | Type                                             | Description                                      |
+|---------------------------------|--------------------------------------------------|--------------------------------------------------|
+| `auroDatePicker-monthChanged`   | `CustomEvent<{ month: any; year: any; numCalendars: any; }>` | Notifies that the visible calendar month(s) have changed. |
+| `auroDatePicker-newSlotContent` | `CustomEvent<any>`                               | Notifies that new slot content has been added to the datepicker. |
+| `auroDatePicker-toggled`        | `CustomEvent<{ expanded: any; }>`                | Notifies that the calendar dropdown has been opened/closed. |
+| `auroDatePicker-valueSet`       |                                                  | Notifies that the component has a new value set. |
+| `auroFormElement-validated`     |                                                  | Notifies that the component value(s) have been validated. |
+
+## Slots
+
+| Name                       | Description                                      |
+|----------------------------|--------------------------------------------------|
+| `bib.fullscreen.dateLabel` | Defines the content to display above selected dates in the mobile layout. |
+| `bib.fullscreen.headline`  | Defines the headline to display above bib.fullscreen.dateLabels in the mobile layout. |
+| `date_MM_DD_YYYY`          | Defines the content to display in the auro-calendar-cell for the specified date. The content text is colored using the success state token when the `highlight` attribute is applied to the slot. |
+| [fromLabel](#fromLabel)                | Defines the label content for the first input.   |
+| [helpText](#helpText)                 | Defines the content of the helpText.             |
+| `popover_MM_DD_YYYY`       | Defines the content to display in the auro-calendar-cell popover for the specified date. |
+| [toLabel](#toLabel)                  | Defines the label content for the second input when the `range` attribute is used. |
+
+## CSS Shadow Parts
+
+| Part              | Description                                      |
+|-------------------|--------------------------------------------------|
+| [calendar](#calendar)        | Use for customizing the style of the calendar.   |
+| [calendarWrapper](#calendarWrapper) | Use for customizing the style of the calendar container. |
+| [dropdown](#dropdown)        | Use for customizing the style of the dropdown.   |
+| [helpText](#helpText)        | Use for customizing the style of the datepicker help text. |
+| [helpTextSpan](#helpTextSpan)    | Use for customizing the style of the datepicker help text span. |
+| [input](#input)           | Use for customizing the style of the datepicker inputs. |
+| [trigger](#trigger)         | Use for customizing the style of the datepicker trigger. |
+<!-- AURO-GENERATED-CONTENT:END -->
+
+## API Examples
+
+### Basic
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/basic.html -->
+  <auro-datepicker>
+    <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basic.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/basic.html -->
+
+```html
+<auro-datepicker>
+  <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### Basic Range
+
+When used, the datepicker will display two inputs and the component will support selection of dates for a start and end date.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basicRange.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/basicRange.html -->
+  <auro-datepicker range>
+    <span slot="bib.fullscreen.headline">Datepicker Range Headline</span>
+    <span slot="fromLabel">Departure</span>
+    <span slot="toLabel">Return</span>
+    <span slot="bib.fullscreen.dateLabel">Roundtrip</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basicRange.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/basicRange.html -->
+
+```html
+<auro-datepicker range>
+  <span slot="bib.fullscreen.headline">Datepicker Range Headline</span>
+  <span slot="fromLabel">Departure</span>
+  <span slot="toLabel">Return</span>
+  <span slot="bib.fullscreen.dateLabel">Roundtrip</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+### Attribute Examples
+
+#### disabled
+
+If set, disables the datepicker.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/disabled.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/disabled.html -->
+  <auro-datepicker disabled>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/disabled.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/disabled.html -->
+
+```html
+<auro-datepicker disabled>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### error
+
+Use the `error` attribute to apply a persistent custom error that supersedes the HTML5 validation logic.
+
+A custom error message can be set using the `error` attribute, or it can be used in conjuction with the `setCustomValidityCustomError` attribute.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/error.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/error.html -->
+  <auro-datepicker error="Custom error message" id="errorExample">
+    <span slot="bib.fullscreen.headline">Error Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <auro-button id="undefinedValueExampleBtnAddError">Set Error</auro-button>
+  <auro-button id="undefinedValueExampleBtnRemoveError">Remove Error</auro-button>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/error.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/error.html -->
+
+```html
+<auro-datepicker error="Custom error message" id="errorExample">
+  <span slot="bib.fullscreen.headline">Error Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+<auro-button id="undefinedValueExampleBtnAddError">Set Error</auro-button>
+<auro-button id="undefinedValueExampleBtnRemoveError">Remove Error</auro-button>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/error.js) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/error.js -->
+
+```js
+export function errorExample() {
+  const errorExample = document.querySelector('#errorExample');
+
+  document.querySelector('#undefinedValueExampleBtnAddError').addEventListener('click', () => {
+    errorExample.error = 'Custom New Error';
+  })
+
+  document.querySelector('#undefinedValueExampleBtnRemoveError').addEventListener('click', () => {
+    errorExample.removeAttribute('error');
+  })
+}
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### Input Mode
+
+You can manually set the input mode for the input.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/inputmode.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/inputmode.html -->
+  <auro-datepicker inputmode="numeric">
+    <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/inputmode.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/inputmode.html -->
+
+```html
+<auro-datepicker inputmode="numeric">
+  <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### calendarStartDate & calendarEndDate
+
+The `calendarStartDate` and `calendarEndDate` properties may be used to explicitly control which calendar months _may_ be rendered in the calendar.
+
+In <strong>desktop</strong>, the calendar month navigation will be restricted by these dates. In <strong>mobile</strong>, the following logic is used:
+
+- if both `calendarStartDate` and `calendarEndDate` are defined: all months between, including these dates, will be rendered.
+- If only `calendarStartDate` is defined: 12 months will be rendered starting with this value.
+- if only `calendarEndDate` is defined: The current date month through the value of this attribute will be rendered.
+
+Note: This does not restrict setting a value outside of those date constraints. These properties _only_ define which months can be rendered in the calendar. A user may still type any date into the input field. If actual value selection restrictions are needed, see the `minDate` and `maxDate` properties which may be used standalone, or in conjunction with `calendarStartDate` and `calendarEndDate`.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/calendarStartAndEndDate.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/calendarStartAndEndDate.html -->
+  <auro-datepicker calendarStartDate="01/01/2022" calendarEndDate="06/01/2022">
+    <span slot="bib.fullscreen.headline">calendarStartDate & calendarEndDate Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/calendarStartAndEndDate.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/calendarStartAndEndDate.html -->
+
+```html
+<auro-datepicker calendarStartDate="01/01/2022" calendarEndDate="06/01/2022">
+  <span slot="bib.fullscreen.headline">calendarStartDate & calendarEndDate Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### calendarFocusDate
+
+The `calendarFocusDate` controls which calendar month is first presented to the user when they open the dropdown bib.
+
+In <strong>desktop</strong> layout, the first month actually rendered will be the `calendarFocusDate` if defined. Once the user manually navigates the calendar to a different month, the calendar view will remain where the user left off when they close and reopen the bib. If the `calendarFocusDate` attribute is changed, this will re-render the calendar starting at the new date. If `calendarFocusDate` is undefined, the first rendered month will be the current date or the first renderable date defined by `calendarStartDate`.
+
+In <strong>mobile</strong> layout, upon first opening the bib, the vertical list of months will scroll (with no animation) to the month defined by the `calendarFocusDate`. If the user scrolls the list to a different position, the scroll position will remain where the user left off when they close and reopen the bib. If the `calendarFocusDate` is changed, the list will scroll to the new dates month. If `calendarFocusDate` is undefined, the list will start at the top most scroll position.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/calendarFocusDate.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/calendarFocusDate.html -->
+  <auro-datepicker calendarStartDate="01/01/2022" calendarEndDate="12/01/2023" calendarFocusDate="11/01/2022">
+    <span slot="bib.fullscreen.headline">calendarFocusDate Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/calendarFocusDate.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/calendarFocusDate.html -->
+
+```html
+<auro-datepicker calendarStartDate="01/01/2022" calendarEndDate="12/01/2023" calendarFocusDate="11/01/2022">
+  <span slot="bib.fullscreen.headline">calendarFocusDate Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### centralDate
+
+The `centralDate` attribute can be used to force the calendar to navigate to a specific month. WARNING: Do not set the `centralDate` attribute on blur.
+
+#### maxDate
+
+To give a higher limit you can bind a date to the `maxDate` attribute. It is recommended to use the `setCustomValidityRangeOverflow` attribute to define an error message to display when validation fails the maximum date restriction.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/maxDate.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/maxDate.html -->
+  <auro-datepicker maxDate="03/25/2023" setCustomValidityRangeOverflow="Selected date is later than maximum date.">
+    <span slot="bib.fullscreen.headline">maxDate Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/maxDate.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/maxDate.html -->
+
+```html
+<auro-datepicker maxDate="03/25/2023" setCustomValidityRangeOverflow="Selected date is later than maximum date.">
+  <span slot="bib.fullscreen.headline">maxDate Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+Setting the `maxDate` attribute to a date earlier than the auro-datepicker `value` will result in the following changes to the component state:
+
+* `value` will to reset to `undefined`.
+* If the currently viewed calendar month is later than the new `maxDate`, the calendar view will move to the new `maxDate` month.
+
+This example demonstrates that behavior.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/updateMaxDate.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/updateMaxDate.html -->
+  <auro-datepicker id="maxDateExample" setCustomValidityRangeOverflow="Selected date is later than maximum date.">
+    <span slot="bib.fullscreen.headline">maxDate Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <auro-button id="maxDateChange">Change maxDate to Today's Date</auro-button>
+  <auro-button id="resetMaxDate">Reset Datepicker to Initial Example</auro-button>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/updateMaxDate.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/updateMaxDate.html -->
+
+```html
+<auro-datepicker id="maxDateExample" setCustomValidityRangeOverflow="Selected date is later than maximum date.">
+  <span slot="bib.fullscreen.headline">maxDate Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+<auro-button id="maxDateChange">Change maxDate to Today's Date</auro-button>
+<auro-button id="resetMaxDate">Reset Datepicker to Initial Example</auro-button>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/updateMaxDate.js) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/updateMaxDate.js -->
+
+```js
+function formatDateString(date) {
+  /* eslint-disable prefer-template, no-magic-numbers */
+  const dd = String("0" + date.getDate()).slice(-2);
+  const mm = String("0" + (date.getMonth() + 1)).slice(-2);
+  /* eslint-enable prefer-template, no-magic-numbers */
+  const yyyy = date.getFullYear();
+
+  return `${mm}/${dd}/${yyyy}`;
+}
+
+export function updateMaxDateExample() {
+  const maxDateExample = document.getElementById('maxDateExample');
+  const changeMaxDateButton = document.getElementById('maxDateChange');
+  const resetButton = document.getElementById('resetMaxDate');
+
+  const today = formatDateString(new Date());
+
+  let nextWeek = new Date();
+  let addOneWeek = nextWeek.getDate() + 7;
+
+  nextWeek.setDate(addOneWeek);
+  nextWeek = formatDateString(nextWeek);
+
+  maxDateExample.setAttribute('value', nextWeek);
+  maxDateExample.setAttribute('maxDate', nextWeek);
+
+  changeMaxDateButton.addEventListener('click', () => {
+    maxDateExample.setAttribute('maxDate', today);
+  });
+
+  resetButton.addEventListener('click', () => {
+    maxDateExample.setAttribute('value', nextWeek);
+    maxDateExample.setAttribute('maxDate', nextWeek);
+  });
+}
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### minDate
+
+To give a lower limit you can bind a date to the `minDate` attribute. It is recommended to use the `setCustomValidityRangeUnderflow` attribute to define an error message to display when validation fails the minimum date restriction.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/minDate.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/minDate.html -->
+  <auro-datepicker minDate="03/25/2028" setCustomValidityRangeUnderflow="Selected date is earlier than the minimum date.">
+    <span slot="bib.fullscreen.headline">minDate Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/minDate.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/minDate.html -->
+
+```html
+<auro-datepicker minDate="03/25/2028" setCustomValidityRangeUnderflow="Selected date is earlier than the minimum date.">
+  <span slot="bib.fullscreen.headline">minDate Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+Setting the `minDate` attribute to a date later than the auro-datepicker `value` will result in the following changes to the component state:
+
+* `value` will to reset to `undefined`.
+* If the currently viewed calendar month is earlier than the new `minDate`, the calendar view will move to the new `minDate` month.
+
+This example demonstrates that behavior.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/updateMinDate.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/updateMinDate.html -->
+  <auro-datepicker id="minDateExample" setCustomValidityRangeUnderflow="Selected date is earlier than the minimum date.">
+    <span slot="bib.fullscreen.headline">minDate Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <auro-button id="minDateChange">Change minDate to a week from Today</auro-button>
+  <auro-button id="resetMinDate">Reset Datepicker to Initial Example</auro-button>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/updateMinDate.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/updateMinDate.html -->
+
+```html
+<auro-datepicker id="minDateExample" setCustomValidityRangeUnderflow="Selected date is earlier than the minimum date.">
+  <span slot="bib.fullscreen.headline">minDate Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+<auro-button id="minDateChange">Change minDate to a week from Today</auro-button>
+<auro-button id="resetMinDate">Reset Datepicker to Initial Example</auro-button>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/updateMinDate.js) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/updateMinDate.js -->
+
+```js
+function formatDateString(date) {
+  /* eslint-disable prefer-template, no-magic-numbers */
+  const dd = String("0" + date.getDate()).slice(-2);
+  const mm = String("0" + (date.getMonth() + 1)).slice(-2);
+  /* eslint-enable prefer-template, no-magic-numbers */
+  const yyyy = date.getFullYear();
+
+  return `${mm}/${dd}/${yyyy}`;
+}
+
+export function updateMinDateExample() {
+  const minDateExample = document.getElementById('minDateExample');
+  const changeMinDateButton = document.getElementById('minDateChange');
+  const resetButton = document.getElementById('resetMinDate');
+
+  const today = formatDateString(new Date());
+
+  let nextWeek = new Date();
+  let addOneWeek = nextWeek.getDate() + 7;
+
+  nextWeek.setDate(addOneWeek);
+  nextWeek = formatDateString(nextWeek);
+
+  minDateExample.setAttribute('value', today);
+  minDateExample.setAttribute('minDate', today);
+
+  changeMinDateButton.addEventListener('click', () => {
+    minDateExample.setAttribute('minDate', nextWeek);
+  });
+
+  resetButton.addEventListener('click', () => {
+    minDateExample.setAttribute('value', today);
+    minDateExample.setAttribute('minDate', today);
+  });
+
+}
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+</auro-accordion>
+
+#### noValidate
+
+When set, the datepicker will not validate when navigating away from the component.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/noValidate.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/noValidate.html -->
+  <auro-datepicker required noValidate>
+    <span slot="bib.fullscreen.headline">noValidate Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/noValidate.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/noValidate.html -->
+
+```html
+<auro-datepicker required noValidate>
+  <span slot="bib.fullscreen.headline">noValidate Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### required
+
+Populates the `required` attribute on the input. Used for client-side validation.
+
+When the validity check fails the validityState, equals `valueMissing`. The error message for the `valueMissing` validityState can be set to a custom string using the `setCustomValidityValueMissing`. There is no default error message defined.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/required.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/required.html -->
+  <auro-datepicker required setCustomValidityValueMissing="Custom value missing message.">
+    <span slot="bib.fullscreen.headline">Required Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <auro-datepicker required range setCustomValidityValueMissing="Custom value missing message.">
+    <span slot="bib.fullscreen.headline">Required Example</span>
+    <span slot="fromLabel">Departure</span>
+    <span slot="toLabel">Return</span>
+    <span slot="bib.fullscreen.dateLabel">Roundtrip</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/required.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/required.html -->
+
+```html
+<auro-datepicker required setCustomValidityValueMissing="Custom value missing message.">
+  <span slot="bib.fullscreen.headline">Required Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+<auro-datepicker required range setCustomValidityValueMissing="Custom value missing message.">
+  <span slot="bib.fullscreen.headline">Required Example</span>
+  <span slot="fromLabel">Departure</span>
+  <span slot="toLabel">Return</span>
+  <span slot="bib.fullscreen.dateLabel">Roundtrip</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### stacked
+
+Set stacked attribute to make range datepicker stacked style.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/stacked.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/stacked.html -->
+  <auro-datepicker range stacked>
+    <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/stacked.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/stacked.html -->
+
+```html
+<auro-datepicker range stacked>
+  <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+### Customized bib position
+The bib position can be customized with `placement`, `offset`, `flip`, `autoPlacement` attributes.
+
+- `placement` specifies the preferred position where the bib should appear relative to the trigger.
+- `offset` sets the distance between the trigger and the bib.
+- When `autoPlacement` is enabled, smart positioning logic is applied to determine the best placement for the bib. If all sides have sufficient space, the bib will appear in the position specified by `placement`.
+- Unless `noFlip` is enabled, if there isn't enough space for the preferred `placement`, the bib will automatically flip to an alternative position.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/floaterConfig.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/floaterConfig.html -->
+  <div style="width: 400px">
+    <auro-datepicker offset="20" placement="bottom-start" noFlip>
+      <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+      <span slot="fromLabel">bottom-start with 20px offset and noFlip</span>
+      <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+    </auro-datepicker>
+    <auro-datepicker offset="20" placement="bottom-start">
+      <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+      <span slot="fromLabel">bottom-start with 20px offset and flip</span>
+      <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+    </auro-datepicker>
+    <auro-datepicker offset="20" placement="right" autoPlacement noFlip>
+      <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+      <span slot="fromLabel">right with 20px offset, noFlip and autoPlacement</span>
+      <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+    </auro-datepicker>
+  </div>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/floaterConfig.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/floaterConfig.html -->
+
+```html
+<div style="width: 400px">
+  <auro-datepicker offset="20" placement="bottom-start" noFlip>
+    <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+    <span slot="fromLabel">bottom-start with 20px offset and noFlip</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <auro-datepicker offset="20" placement="bottom-start">
+    <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+    <span slot="fromLabel">bottom-start with 20px offset and flip</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <auro-datepicker offset="20" placement="right" autoPlacement noFlip>
+    <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+    <span slot="fromLabel">right with 20px offset, noFlip and autoPlacement</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+</div>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### validity
+
+Specifies the `validityState` the element is in. Upon first interaction, or presetting the `error` attribute, the component will validate on `focusout`. After validation, `validityState` can be queried from the component by using the following JavaScript.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/validity.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/validity.html -->
+  <auro-datepicker required id="validityExample">
+    <span slot="bib.fullscreen.headline">validity Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <auro-button id="validityExampleBtn">Get validity</auro-button>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/validity.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/validity.html -->
+
+```html
+<auro-datepicker required id="validityExample">
+  <span slot="bib.fullscreen.headline">validity Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+<auro-button id="validityExampleBtn">Get validity</auro-button>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/validity.js) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/validity.js -->
+
+```js
+export function validityExample() {
+  const validityExampleExample = document.querySelector('#validityExample');
+  const validityExampleExampleBtn = document.querySelector('#validityExampleBtn');
+
+  validityExampleExampleBtn.addEventListener('click', () => {
+    console.warn('Validity set to:', validityExampleExample.validity);
+    alert(`Validity set to: ${validityExampleExample.validity}`);
+  })
+}
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### value
+
+Value selected for the datepicker. Can be used to pre-set the value of the datepicker. When the `range` attribute is used, `value` is for the first input.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/value.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/value.html -->
+  <auro-datepicker id="valueExample" value="02/02/2022">
+    <span slot="bib.fullscreen.headline">value Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/value.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/value.html -->
+
+```html
+<auro-datepicker id="valueExample" value="02/02/2022">
+  <span slot="bib.fullscreen.headline">value Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### valueEnd
+
+Value of the second input (end date), selected for the datepicker. Can be used to pre-set the value of the datepicker. Only applicable for a datepicker with the `range` attribute.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/valueEnd.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/valueEnd.html -->
+  <auro-datepicker id="valueEndExample" range valueEnd="03/03/2023">
+    <span slot="bib.fullscreen.headline">valueEnd Example</span>
+    <span slot="fromLabel">Departure</span>
+    <span slot="toLabel">Return</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/valueEnd.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/valueEnd.html -->
+
+```html
+<auro-datepicker id="valueEndExample" range valueEnd="03/03/2023">
+  <span slot="bib.fullscreen.headline">valueEnd Example</span>
+  <span slot="fromLabel">Departure</span>
+  <span slot="toLabel">Return</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### format
+
+The `format` attribute is used to define the date format used by the datepicker. The default value is `mm/dd/yyyy`.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/format.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/format.html -->
+  <auro-datepicker format="yyyy/mm/dd">
+    <span slot="bib.fullscreen.headline">Format Headline</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/format.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/format.html -->
+
+```html
+<auro-datepicker format="yyyy/mm/dd">
+  <span slot="bib.fullscreen.headline">Format Headline</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+### Method Examples
+
+#### focus
+
+The focus method will apply focus state to the datepicker's input field.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/focus.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/focus.html -->
+  <auro-datepicker id="focusExampleElem" range>
+    <span slot="bib.fullscreen.headline">Focus Example</span>
+    <span slot="fromLabel">Departure</span>
+    <span slot="toLabel">Return</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <auro-button id="focusExampleBtn">Apply focus to datepicker</auro-button>
+  <auro-button id="focusExampleBtnTwo">Apply focus to the second input in datepicker</auro-button>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/focus.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/focus.html -->
+
+```html
+<auro-datepicker id="focusExampleElem" range>
+  <span slot="bib.fullscreen.headline">Focus Example</span>
+  <span slot="fromLabel">Departure</span>
+  <span slot="toLabel">Return</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+<auro-button id="focusExampleBtn">Apply focus to datepicker</auro-button>
+<auro-button id="focusExampleBtnTwo">Apply focus to the second input in datepicker</auro-button>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/focus.js) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/focus.js -->
+
+```js
+export function focusExample() {
+  const focusExampleElem = document.querySelector('#focusExampleElem');
+  const focusExampleBtn = document.querySelector('#focusExampleBtn');
+  const focusExampleBtnTwo = document.querySelector('#focusExampleBtnTwo');
+
+  focusExampleBtn.addEventListener('click', () => {
+    focusExampleElem.focus();
+  });
+
+  focusExampleBtnTwo.addEventListener('click', () => {
+    focusExampleElem.focus('endDate');
+  });
+}
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+### Slot Examples
+
+#### fromLabel
+
+Sets the label used for the input. When the `range` attribute is used this is the first of two inputs.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/basic.html -->
+  <auro-datepicker>
+    <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basic.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/basic.html -->
+
+```html
+<auro-datepicker>
+  <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### helpText
+
+Sets the help text displayed below the trigger. The `helpText` slot can be used to provide additional context for the combobox. When using the `error` attribute, the `helpText` slot can be used to describe the error.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/helpText.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/helpText.html -->
+  <auro-datepicker>
+    <span slot="bib.fullscreen.headline">helpText Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+    <span slot="helpText">Choose a date must be today or earlier.</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/helpText.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/helpText.html -->
+
+```html
+<auro-datepicker>
+  <span slot="bib.fullscreen.headline">helpText Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  <span slot="helpText">Choose a date must be today or earlier.</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### bib.fullscreen.dateLabel and bib.fullscreen.headline
+
+Sets the headline and the label at the top of the bib when viewed in the mobile layout. 
+To view this demo, set your window to a mobile screen size.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basic.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/basic.html -->
+  <auro-datepicker>
+    <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basic.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/basic.html -->
+
+```html
+<auro-datepicker>
+  <span slot="bib.fullscreen.headline">Datepicker Headline</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### toLabel
+
+Only for use with the `range` attribute. Sets the label for the second input.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/basicRange.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/basicRange.html -->
+  <auro-datepicker range>
+    <span slot="bib.fullscreen.headline">Datepicker Range Headline</span>
+    <span slot="fromLabel">Departure</span>
+    <span slot="toLabel">Return</span>
+    <span slot="bib.fullscreen.dateLabel">Roundtrip</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/basicRange.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/basicRange.html -->
+
+```html
+<auro-datepicker range>
+  <span slot="bib.fullscreen.headline">Datepicker Range Headline</span>
+  <span slot="fromLabel">Departure</span>
+  <span slot="toLabel">Return</span>
+  <span slot="bib.fullscreen.dateLabel">Roundtrip</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### Date Slot
+
+Custom content can be added to any day in the calendar using a `slot` named following the pattern `date_{MM}_{DD}_{YYYY}` (e.g. `date_01_08_2024`).
+
+Adding the `highlight` attribute to the slot will change the slot content's color to `var(--ds-color-text-success-default)`.
+
+Slot content support is limited to text only and a maximum of five (5) characters.
+
+Slot content can be styled using [inline styles](https://www.codecademy.com/article/html-inline-styles) or [CSS Parts](https://css-tricks.com/styling-in-the-shadow-dom-with-css-shadow-parts/) (`part="dateSlot"`).
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/dateSlot.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/dateSlot.html -->
+  <auro-datepicker centralDate="12/03/2023" minDate="12/04/2023" maxDate="12/09/2023">
+    <span slot="bib.fullscreen.headline">dateSlot Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+    <span slot="date_12_03_2023">Sold</span>
+    <span highlight slot="date_12_04_2023">$89</span>
+    <span slot="date_12_05_2023">$100</span>
+    <span slot="date_12_06_2023">$2345</span>
+    <span highlight slot="date_12_07_2023">$149</span>
+    <span highlight slot="date_12_08_2023">$382</span>
+    <span slot="date_12_09_2023">$560</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/dateSlot.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/dateSlot.html -->
+
+```html
+<auro-datepicker centralDate="12/03/2023" minDate="12/04/2023" maxDate="12/09/2023">
+  <span slot="bib.fullscreen.headline">dateSlot Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  <span slot="date_12_03_2023">Sold</span>
+  <span highlight slot="date_12_04_2023">$89</span>
+  <span slot="date_12_05_2023">$100</span>
+  <span slot="date_12_06_2023">$2345</span>
+  <span highlight slot="date_12_07_2023">$149</span>
+  <span highlight slot="date_12_08_2023">$382</span>
+  <span slot="date_12_09_2023">$560</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### Popover Slot
+
+Custom content can be added to any day's `auro-popover` in the calendar using a `slot` named following the pattern `popover_{MM}_{DD}_{YYYY}` (e.g. `popover_01_08_2024`).
+
+The popover slot is intended for use with calendar dates that are `disabled` (e.g. before minimum date or after maximum date).
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/popoverSlot.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/popoverSlot.html -->
+  <auro-datepicker centralDate="12/03/2023" minDate="12/04/2023" maxDate="12/09/2023">
+    <span slot="bib.fullscreen.headline">Popover Slot Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+    <span slot="popover_12_03_2023">Tickets for this day are sold out</span>
+    <span slot="popover_12_04_2023">Tickets for this day are $89</span>
+    <span slot="popover_12_05_2023">Tickets for this day are $100</span>
+    <span slot="popover_12_06_2023">Tickets for this day are $2345</span>
+    <span slot="popover_12_07_2023">Tickets for this day are $149</span>
+    <span slot="popover_12_08_2023">Tickets for this day are $382</span>
+    <span slot="popover_12_09_2023">Tickets for this day are $560</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/popoverSlot.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/popoverSlot.html -->
+
+```html
+<auro-datepicker centralDate="12/03/2023" minDate="12/04/2023" maxDate="12/09/2023">
+  <span slot="bib.fullscreen.headline">Popover Slot Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  <span slot="popover_12_03_2023">Tickets for this day are sold out</span>
+  <span slot="popover_12_04_2023">Tickets for this day are $89</span>
+  <span slot="popover_12_05_2023">Tickets for this day are $100</span>
+  <span slot="popover_12_06_2023">Tickets for this day are $2345</span>
+  <span slot="popover_12_07_2023">Tickets for this day are $149</span>
+  <span slot="popover_12_08_2023">Tickets for this day are $382</span>
+  <span slot="popover_12_09_2023">Tickets for this day are $560</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+### Functional Examples
+
+#### Localization
+
+The datepicker supports localized month names through the `monthNames` property. 
+
+This example demonstrates how to set the `monthNames` property to Korean month names, with a Korean date format.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/localization.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/localization.html -->
+  <auro-datepicker format="yyyy/mm/dd" id="localizationExample">
+    <span slot="bib.fullscreen.headline">Localization Headline</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/localization.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/localization.html -->
+
+```html
+<auro-datepicker format="yyyy/mm/dd" id="localizationExample">
+  <span slot="bib.fullscreen.headline">Localization Headline</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/localization.js) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/localization.js -->
+
+```js
+export function localizationExample() {
+  const localizedDatepicker = document.querySelector("#localizationExample");
+
+  localizedDatepicker.monthNames = ['일월', '이월', '삼월', '사월', '오월', '유월', '칠월', '팔월', '구월', '시월', '십일월', '십이월'];
+}
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### Reset State
+
+Use the `reset()` method to reset the `<auro-datepicker>`'s `value`, `valueEnd` and `validity` state. Doing so will preserve all other attributes and properties.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/resetState.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/resetState.html -->
+  <auro-datepicker id="resetStateExample" range minDate="06/30/2025" calendarStartDate="06/30/2025" calendarFocusDate="06/30/2025" value="02/14/2025" valueEnd="04/05/2025" setCustomValidityRangeUnderflow="The date you entered is too early.">
+    <span slot="bib.fullscreen.headline">Reset Example</span>
+    <span slot="fromLabel">Departure</span>
+    <span slot="toLabel">Return</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <auro-button id="resetStateBtn">Reset</auro-button>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/resetState.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/resetState.html -->
+
+```html
+<auro-datepicker id="resetStateExample" range minDate="06/30/2025" calendarStartDate="06/30/2025" calendarFocusDate="06/30/2025" value="02/14/2025" valueEnd="04/05/2025" setCustomValidityRangeUnderflow="The date you entered is too early.">
+  <span slot="bib.fullscreen.headline">Reset Example</span>
+  <span slot="fromLabel">Departure</span>
+  <span slot="toLabel">Return</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+<auro-button id="resetStateBtn">Reset</auro-button>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/resetState.js) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/resetState.js -->
+
+```js
+export function resetStateExample() {
+  const elem = document.querySelector('#resetStateExample');
+
+  document.querySelector('#resetStateBtn').addEventListener('click', () => {
+    elem.reset();
+  });
+}
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### Dynamic Slot Content
+
+This example demonstrates data driven slot content for days in the calendar. In this example, the slot content is inserted into each `auro-calendar-cell` after the bib of the `auro-datepicker` is opened, simulating an API call on a dynamic data source.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/dynamicSlot.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/dynamicSlot.html -->
+  <auro-datepicker id="slotContentExample" centralDate="12/13/2023" minDate="12/13/2023" maxDate="01/18/2024" range>
+    <span slot="bib.fullscreen.headline">dynamic slot  Example</span>
+    <span slot="fromLabel">Departure</span>
+    <span slot="toLabel">Return</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/dynamicSlot.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/dynamicSlot.html -->
+
+```html
+<auro-datepicker id="slotContentExample" centralDate="12/13/2023" minDate="12/13/2023" maxDate="01/18/2024" range>
+  <span slot="bib.fullscreen.headline">dynamic slot  Example</span>
+  <span slot="fromLabel">Departure</span>
+  <span slot="toLabel">Return</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/dynamicSlot.js) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/dynamicSlot.js -->
+
+```js
+export function populateSlotContentExample() {
+  const populateSlotContentExample = document.querySelector('#slotContentExample');
+
+  // Insert slot content when the datepicker has been opened
+  populateSlotContentExample.addEventListener('auroDatePicker-toggled', (event) => {
+    if (event.detail.expanded) {
+      // Array of object(s) containing key, value pairs defining what slot content to render
+      const data = [
+        {slot: 'date', month: 12, day: 1, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 2, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 3, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 4, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 5, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 6, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 7, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 8, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 9, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 10, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 11, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 12, year: 2023, content: 'Sold'},
+        {slot: 'date', month: 12, day: 13, year: 2023, content: '$560'},
+        {slot: 'date', month: 12, day: 14, year: 2023, content: '$89', highlight: true},
+        {slot: 'date', month: 12, day: 15, year: 2023, content: '$100'},
+        {slot: 'date', month: 12, day: 16, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 17, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 18, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 19, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 20, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 21, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 22, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 23, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 24, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 25, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 26, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 27, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 28, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 29, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 30, year: 2023, content: '$2345'},
+        {slot: 'date', month: 12, day: 31, year: 2023, content: '$2345'},
+        {slot: 'date', month: 1, day: 14, year: 2024, content: '$83', highlight: true},
+        {slot: 'date', month: 1, day: 15, year: 2024, content: '$203'},
+        {slot: 'date', month: 1, day: 16, year: 2024, content: '$4444'},
+        {slot: 'date', month: 1, day: 17, year: 2024, content: '$83', highlight: true},
+        {slot: 'date', month: 1, day: 18, year: 2024, content: '$96', highlight: true},
+        {slot: 'date', month: 1, day: 19, year: 2024, content: 'Sold'},
+        {slot: 'date', month: 1, day: 20, year: 2024, content: 'Sold'},
+        {slot: 'popover', month: 12, day: 1, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 2, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 3, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 4, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 5, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 6, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 7, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 8, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 9, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 10, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 11, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 12, year: 2023, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 12, day: 13, year: 2023, content: 'Tickets for this date are $560'},
+        {slot: 'popover', month: 12, day: 14, year: 2023, content: 'Tickets for this date are $89'},
+        {slot: 'popover', month: 12, day: 15, year: 2023, content: 'Tickets for this date are $100'},
+        {slot: 'popover', month: 12, day: 16, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 17, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 18, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 19, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 20, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 21, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 22, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 23, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 24, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 25, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 26, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 27, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 28, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 29, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 30, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 12, day: 31, year: 2023, content: 'Tickets for this date are $2345'},
+        {slot: 'popover', month: 1, day: 14, year: 2024, content: 'Tickets for this date are $83'},
+        {slot: 'popover', month: 1, day: 15, year: 2024, content: 'Tickets for this date are $203'},
+        {slot: 'popover', month: 1, day: 16, year: 2024, content: 'Tickets for this date are $4444'},
+        {slot: 'popover', month: 1, day: 17, year: 2024, content: 'Tickets for this date are $83'},
+        {slot: 'popover', month: 1, day: 18, year: 2024, content: 'Tickets for this date are $96'},
+        {slot: 'popover', month: 1, day: 19, year: 2024, content: 'Tickets for this date are sold out'},
+        {slot: 'popover', month: 1, day: 20, year: 2024, content: 'Tickets for this date are sold out'}
+      ];
+
+      // For each item in the array, parse the keys into an HTML element and insert it into the DOM
+      data.forEach((item) => {
+        // Create the new element for the slot content
+        const slotElement = document.createElement('span');
+
+        if (item.month.toString().length === 1) {
+          item.month = `0` + item.month;
+        }
+
+        if (item.day.toString().length === 1) {
+          item.day = `0` + item.day;
+        }
+
+        // Create the slot name from the item's keys
+        const slotName = `${item.slot}_${item.month}_${item.day}_${item.year}`;
+
+        // Set the slot name and content
+        slotElement.setAttribute('slot', slotName);
+        slotElement.textContent = item.content;
+
+        // Set the 'highlight' attribute on date slot content
+        if (item.slot === 'date' && item.highlight) {
+          slotElement.setAttribute('highlight', item.highlight);
+        }
+
+        // Append the new element to the DOM
+        populateSlotContentExample.appendChild(slotElement);
+      });
+    }
+
+    populateSlotContentExample.pushSlotContent();
+  });
+}
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+### Watch for value changes
+
+The following example listens for the `auroDatePicker-valueSet` event. Once triggered, `element.value` may be queried for the new value **and** in successful scenarios, an alert will appear. Open the JavaScript console in the browser's developer tools to see the `console.warn` message that appears after the `auroDatePicker-valueSet` event has been triggered.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/alertValue.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/alertValue.html -->
+  <auro-datepicker id="datePickerValueAlert">
+    <span slot="bib.fullscreen.headline">Alert Value Example</span>
+    <span slot="fromLabel">Choose a date</span>
+    <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+  </auro-datepicker>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/alertValue.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/alertValue.html -->
+
+```html
+<auro-datepicker id="datePickerValueAlert">
+  <span slot="bib.fullscreen.headline">Alert Value Example</span>
+  <span slot="fromLabel">Choose a date</span>
+  <span slot="bib.fullscreen.dateLabel">Choose a date</span>
+</auro-datepicker>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/alertValue.js) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/alertValue.js -->
+
+```js
+export function alertValueExample() {
+  const valueAlertExample = document.querySelector('#datePickerValueAlert');
+
+  valueAlertExample.addEventListener('auroDatePicker-valueSet', () => {
+    console.warn('Select value changed to:', valueAlertExample.value);
+    alert(`Select value changed to: ${valueAlertExample.value}`);
+  })
+}
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+#### in Dialog
+
+The component can be in a dialog.
+
+<div class="exampleWrapper">
+  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/inDialog.html) -->
+  <!-- The below content is automatically added from ./../apiExamples/inDialog.html -->
+  <div>
+    <auro-button id="datepicker-dialog-opener">Datepicker in Dialog</auro-button>
+    <auro-dialog id="datepicker-dialog">
+      <span slot="bib.fullscreen.headline">inDialog Example</span>
+      <span slot="header">Datepicker in Dialog</span>
+      <div slot="content">
+        <auro-datepicker />
+      </div>
+    </auro-dialog>
+  </div>
+  <!-- AURO-GENERATED-CONTENT:END -->
+</div>
+<auro-accordion alignRight>
+  <span slot="trigger">See code</span>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/inDialog.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/inDialog.html -->
+
+```html
+<div>
+  <auro-button id="datepicker-dialog-opener">Datepicker in Dialog</auro-button>
+  <auro-dialog id="datepicker-dialog">
+    <span slot="bib.fullscreen.headline">inDialog Example</span>
+    <span slot="header">Datepicker in Dialog</span>
+    <div slot="content">
+      <auro-datepicker />
+    </div>
+  </auro-dialog>
+</div>
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/inDialog.js) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/inDialog.js -->
+
+```js
+export function inDialogExample() {
+  document.querySelector("#datepicker-dialog-opener").addEventListener("click", () => {
+    const dialog = document.querySelector("#datepicker-dialog");
+    dialog.open = true;
+  });
+};
+```
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+
+### Theme Support
+
+The component may be restyled using the following code sample and changing the values of the following token(s).
+
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../src/styles/tokens.scss) -->
+<!-- The below code snippet is automatically added from ./../src/styles/tokens.scss -->
+
+```scss
+/* stylelint-disable color-function-notation */
+
+@import "@aurodesignsystem/design-tokens/dist/alaska/SCSSVariables--alaska";
+@import "@aurodesignsystem/design-tokens/dist/auro-classic/SCSSVariables";
+
+:host {
+  --ds-auro-datepicker-placeholder-color: var(--ds-basic-color-texticon-default, #{$ds-basic-color-texticon-default});
+  --ds-auro-datepicker-range-input-divider-color: var(--ds-basic-color-border-bold, #{$ds-basic-color-border-bold});
+  --ds-auro-calendar-mobile-header-container-color: var(--ds-basic-color-surface-default, #{$ds-basic-color-surface-default});
+  --ds-auro-calendar-mobile-header-divider-color: var(--ds-basic-color-border-divider, #{$ds-basic-color-border-divider});
+  --ds-auro-calendar-mobile-header-text-color: var(--ds-basic-color-texticon-muted, #{$ds-basic-color-texticon-muted});
+  --ds-auro-calendar-nav-btn-border-color: transparent;
+  --ds-auro-calendar-nav-btn-chevron-color: var(--ds-basic-color-brand-primary, #{$ds-basic-color-brand-primary});
+  --ds-auro-calendar-nav-btn-container-color: transparent;
+  --ds-auro-calendar-month-container-color: var(--ds-basic-color-surface-default, #{$ds-basic-color-surface-default});
+  --ds-auro-calendar-month-divider-color: var(--ds-basic-color-border-divider, #{$ds-basic-color-border-divider});
+  --ds-auro-calendar-month-header-color: var(--ds-basic-color-texticon-default, #{$ds-basic-color-texticon-default});
+  --ds-auro-calendar-cell-border-color: transparent;
+  --ds-auro-calendar-cell-container-color: transparent;
+  --ds-auro-calendar-cell-in-range-color: var(--ds-advanced-color-shared-background-muted, #{$ds-advanced-color-shared-background-muted});
+  --ds-auro-calendar-cell-price-text-color: var(--ds-basic-color-texticon-default, #{$ds-basic-color-texticon-default});
+  --ds-auro-calendar-cell-text-color: var(--ds-basic-color-texticon-default, #{$ds-basic-color-texticon-default});
+}
+```
+<!-- AURO-GENERATED-CONTENT:END -->