@aurodesignsystem-dev/auro-formkit 0.0.0-pr1492.4 → 0.0.0-pr1493.0

package/components/datepicker/demo/customize.md

@@ -5,80 +5,27 @@
 <span slot="mobileToggleCollapsed">View More</span>
 <span slot="mobileToggleExpanded">View Less</span>
 <auro-anchorlink fluid href="#appearance">Appearance</auro-anchorlink>
-<auro-anchorlink fluid href="#layout" class="level2 body-xs">Shape, Size & Layout</auro-anchorlink>
-<auro-anchorlink fluid href="#background" class="level2 body-xs">Light vs. Dark Background</auro-anchorlink>
 <auro-anchorlink fluid href="#placement" class="level2 body-xs">Bib Placement</auro-anchorlink>
+<auro-anchorlink fluid href="#cssParts" class="level2 body-xs">CSS Shadow Parts</auro-anchorlink>
 <auro-anchorlink fluid href="#breakpoint" class="level2 body-xs">Fullscreen Breakpoint</auro-anchorlink>
+<auro-anchorlink fluid href="#background" class="level2 body-xs">Light vs. Dark Background</auro-anchorlink>
+<auro-anchorlink fluid href="#localization" class="level2 body-xs">Localization</auro-anchorlink>
+<auro-anchorlink fluid href="#layout" class="level2 body-xs">Shape, Size & Layout</auro-anchorlink>
 <auro-anchorlink fluid href="#cssTokens" class="level2 body-xs">Tokens</auro-anchorlink>
-<auro-anchorlink fluid href="#cssParts" class="level2 body-xs">CSS Shadow Parts</auro-anchorlink>
 <auro-anchorlink fluid href="#customBehavior">Behavior</auro-anchorlink>
-<auro-anchorlink fluid href="#inputMode" class="level2 body-xs">Input Mode</auro-anchorlink>
+<auro-anchorlink fluid href="#customValidation" class="level2 body-xs">Custom Validation</auro-anchorlink>
 <auro-anchorlink fluid href="#disableComponent" class="level2 body-xs">Disable Component</auro-anchorlink>
-<auro-anchorlink fluid href="#requireSelection" class="level2 body-xs">Require Selection</auro-anchorlink>
 <auro-anchorlink fluid href="#forceError" class="level2 body-xs">Force Error State</auro-anchorlink>
-<auro-anchorlink fluid href="#customValidation" class="level2 body-xs">Custom Validation</auro-anchorlink>
-<auro-anchorlink fluid href="#noValidate" class="level2 body-xs">No Validation</auro-anchorlink>
+<auro-anchorlink fluid href="#inputMode" class="level2 body-xs">Input Mode</auro-anchorlink>
 <auro-anchorlink fluid href="#minMaxDate" class="level2 body-xs">Min/Max Date</auro-anchorlink>
-<auro-anchorlink fluid href="#regionalDate" class="level2 body-xs">Regional Date</auro-anchorlink>
+<auro-anchorlink fluid href="#noValidate" class="level2 body-xs">No Validation</auro-anchorlink>
+<auro-anchorlink fluid href="#requireSelection" class="level2 body-xs">Require Selection</auro-anchorlink>
 </auro-nav>
 </nav>
 <div class="mainContent">
 <div class="scrollWrapper">
 <section>
 <auro-header level="2" id="appearance">Appearance</auro-header>
-<auro-header level="3" id="layout">Shape, Size & Layout</auro-header>
-<p>The <code>shape</code>, <code>size</code> and <code>layout</code> attributes work in collaboration to control the overall architecture of the component.</p>
-<p>See the <a href="./design.html">Design page</a> for a detailed breakdown.</p>
-<auro-header level="3" id="background">Light vs. Dark Background</auro-header>
-<p>The <code>appearance</code> attribute defines whether the component renders on lighter or darker backgrounds. Supported values are <code>default</code> and <code>inverse</code>. The default value is <code>default</code>.</p>
-<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="ariaLabel.bib.close">Close Calendar</span>
-<span slot="bib.fullscreen.headline">Datepicker Headline</span>
-<span slot="fromLabel">Choose a date</span>
-<span slot="bib.fullscreen.fromLabel">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 -->
-
-<pre class="language-html"><code class="language-html">&lt;auro-datepicker&gt;
-  &lt;span slot="ariaLabel.bib.close"&gt;Close Calendar&lt;/span&gt;
-  &lt;span slot="bib.fullscreen.headline"&gt;Datepicker Headline&lt;/span&gt;
-  &lt;span slot="fromLabel"&gt;Choose a date&lt;/span&gt;
-  &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
-&lt;/auro-datepicker&gt;</code></pre>
-<!-- AURO-GENERATED-CONTENT:END -->
-</auro-accordion>
-<div class="exampleWrapper--ondark">
-<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse.html) -->
-<!-- The below content is automatically added from ./../apiExamples/appearance-inverse.html -->
-<auro-datepicker appearance="inverse">
-<span slot="ariaLabel.bib.close">Close Calendar</span>
-<span slot="bib.fullscreen.headline">Datepicker Headline</span>
-<span slot="fromLabel">Choose a date</span>
-<span slot="bib.fullscreen.fromLabel">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/appearance-inverse.html) -->
-<!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse.html -->
-
-<pre class="language-html"><code class="language-html">&lt;auro-datepicker appearance="inverse"&gt;
-  &lt;span slot="ariaLabel.bib.close"&gt;Close Calendar&lt;/span&gt;
-  &lt;span slot="bib.fullscreen.headline"&gt;Datepicker Headline&lt;/span&gt;
-  &lt;span slot="fromLabel"&gt;Choose a date&lt;/span&gt;
-  &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
-&lt;/auro-datepicker&gt;</code></pre>
-<!-- AURO-GENERATED-CONTENT:END -->
-</auro-accordion>
 <auro-header level="3" id="placement">Bib Placement</auro-header>
 <p>The bib position can be customized with <code>placement</code>, <code>offset</code>, <code>flip</code>, <code>autoPlacement</code>, and <code>shift</code> attributes.</p>
 <div class="exampleWrapper">
@@ -153,6 +100,78 @@
 &lt;/div&gt;</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>
+</section>
+<section>
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../docs/partials/customize/css-parts.md) -->
+<!-- The below content is automatically added from ./../docs/partials/customize/css-parts.md -->
+<auro-header level="3" id="cssParts">CSS Shadow Parts</auro-header>
+<p>CSS Shadow Parts allow you to style elements inside a web component's shadow DOM using the <code>::part()</code> pseudo-element. The following parts are exposed by <code>&lt;auro-datepicker&gt;</code>.</p>
+<table class="auro_table">
+<thead>
+<tr>
+<th>Part</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr><td><code>dropdown</code></td><td>The outer dropdown container.</td></tr>
+<tr><td><code>trigger</code></td><td>The trigger content container.</td></tr>
+<tr><td><code>input</code></td><td>The date input element(s).</td></tr>
+<tr><td><code>calendarWrapper</code></td><td>The calendar bib sizing container.</td></tr>
+<tr><td><code>calendar</code></td><td>The calendar element.</td></tr>
+<tr><td><code>helpTextSpan</code></td><td>The help text container wrapper.</td></tr>
+<tr><td><code>helpText</code></td><td>The help text element.</td></tr>
+</tbody>
+</table>
+<!-- AURO-GENERATED-CONTENT:END -->
+<div class="exampleWrapper">
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/css-parts.html) -->
+<!-- The below content is automatically added from ../apiExamples/css-parts.html -->
+<style>
+  auro-datepicker.css-parts-demo::part(trigger) {
+    border-color: orange;
+  }
+  auro-datepicker.css-parts-demo::part(helpText) {
+    color: green;
+  }
+  auro-datepicker.css-parts-demo::part(calendarWrapper) {
+    max-height: 400px;
+  }
+</style>
+<auro-datepicker class="css-parts-demo">
+<span slot="fromLabel">CSS Parts Example</span>
+<span slot="helpText">This datepicker has custom styles applied via CSS Shadow Parts.</span>
+<span slot="bib.fullscreen.headline">Select Date</span>
+<span slot="bib.fullscreen.fromLabel">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/css-parts.html) -->
+<!-- The below code snippet is automatically added from ../apiExamples/css-parts.html -->
+
+<pre class="language-html"><code class="language-html">&lt;style&gt;
+  auro-datepicker.css-parts-demo::part(trigger) {
+    border-color: orange;
+  }
+  auro-datepicker.css-parts-demo::part(helpText) {
+    color: green;
+  }
+  auro-datepicker.css-parts-demo::part(calendarWrapper) {
+    max-height: 400px;
+  }
+&lt;/style&gt;
+&lt;auro-datepicker class="css-parts-demo"&gt;
+  &lt;span slot="fromLabel"&gt;CSS Parts Example&lt;/span&gt;
+  &lt;span slot="helpText"&gt;This datepicker has custom styles applied via CSS Shadow Parts.&lt;/span&gt;
+  &lt;span slot="bib.fullscreen.headline"&gt;Select Date&lt;/span&gt;
+  &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
+&lt;/auro-datepicker&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+</section>
+<section>
 <auro-header level="3" id="breakpoint">Fullscreen Breakpoint</auro-header>
 <p>The <code>fullscreenBreakpoint</code> attribute defines the screen size breakpoint at which the dropdown switches to fullscreen mode on mobile. Supported values are <code>xs</code>, <code>sm</code>, <code>md</code>, <code>lg</code>, <code>xl</code>, and <code>disabled</code>. The default value is <code>sm</code>.</p>
 <div class="exampleWrapper">
@@ -181,6 +200,294 @@
 </auro-accordion>
 </section>
 <section>
+<auro-header level="3" id="background">Light vs. Dark Background</auro-header>
+<p>The <code>appearance</code> attribute defines whether the component renders on lighter or darker backgrounds. Supported values are <code>default</code> and <code>inverse</code>. The default value is <code>default</code>.</p>
+<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="ariaLabel.bib.close">Close Calendar</span>
+<span slot="bib.fullscreen.headline">Datepicker Headline</span>
+<span slot="fromLabel">Choose a date</span>
+<span slot="bib.fullscreen.fromLabel">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 -->
+
+<pre class="language-html"><code class="language-html">&lt;auro-datepicker&gt;
+  &lt;span slot="ariaLabel.bib.close"&gt;Close Calendar&lt;/span&gt;
+  &lt;span slot="bib.fullscreen.headline"&gt;Datepicker Headline&lt;/span&gt;
+  &lt;span slot="fromLabel"&gt;Choose a date&lt;/span&gt;
+  &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
+&lt;/auro-datepicker&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+<div class="exampleWrapper--ondark">
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/appearance-inverse.html) -->
+<!-- The below content is automatically added from ./../apiExamples/appearance-inverse.html -->
+<auro-datepicker appearance="inverse">
+<span slot="ariaLabel.bib.close">Close Calendar</span>
+<span slot="bib.fullscreen.headline">Datepicker Headline</span>
+<span slot="fromLabel">Choose a date</span>
+<span slot="bib.fullscreen.fromLabel">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/appearance-inverse.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/appearance-inverse.html -->
+
+<pre class="language-html"><code class="language-html">&lt;auro-datepicker appearance="inverse"&gt;
+  &lt;span slot="ariaLabel.bib.close"&gt;Close Calendar&lt;/span&gt;
+  &lt;span slot="bib.fullscreen.headline"&gt;Datepicker Headline&lt;/span&gt;
+  &lt;span slot="fromLabel"&gt;Choose a date&lt;/span&gt;
+  &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
+&lt;/auro-datepicker&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+</section>
+<section>
+<auro-header level="3" id="localization">Localization</auro-header>
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../docs/partials/customize/localization.md) -->
+<!-- The below content is automatically added from ./../docs/partials/customize/localization.md -->
+<p>The component supports complete localization, including visible strings, screen reader announcements and locale based date formatting.</p>
+<auro-header level="4" id="localizationTrigger">Trigger</auro-header>
+<auro-header level="4" id="localizationTriggerVisibleStrings">Trigger Visible strings</auro-header>
+<p>The visible strings rendered in the input, trigger, and fullscreen bib are not derived from <code>locale</code> — they are projected through named slots so each language can supply its own translation. Pass a <code>&lt;span&gt;</code> with the matching <code>slot</code> attribute for every string you need to localize.</p>
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/localization-visible-strings.html) -->
+<!-- The below content is automatically added from ./../apiExamples/localization-visible-strings.html -->
+
+<pre class="language-diff"><code class="language-diff">  &lt;auro-datepicker&gt;
++   &lt;span slot="fromLabel"&gt;Abreisedatum&lt;/span&gt;
++   &lt;span slot="helpText"&gt;Wählen Sie ein Datum&lt;/span&gt;
++   &lt;span slot="optionalLabel"&gt;(freiwillig)&lt;/span&gt;
++   &lt;span slot="bib.fullscreen.headline"&gt;Datum auswählen&lt;/span&gt;
++   &lt;span slot="bib.fullscreen.fromLabel"&gt;Abreisedatum&lt;/span&gt;
+  &lt;/auro-datepicker&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+<auro-header level="4" id="localizationCalendar">Calendar</auro-header>
+<auro-header level="4" id="localizationCalendarVisibleStrings">Visible strings</auro-header>
+<p>By default, the calendar weekday names rendered above the day grid and the month names rendered in the calendar header are derived from the active <code>locale</code> using the browser's <auro-hyperlink href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl" target="_blank">Intl</auro-hyperlink> API, so they update automatically when <code>locale</code> changes. Use the <code>monthNames</code> attribute to override the derived month names — for example, to supply a translation the browser does not produce or to support a locale the browser does not recognize.</p>
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/localization-calendar-strings.html) -->
+<!-- The below content is automatically added from ./../apiExamples/localization-calendar-strings.html -->
+
+<pre class="language-diff"><code class="language-diff">- &lt;auro-datepicker&gt;
++ &lt;auro-datepicker monthNames='["Januar","Februar","März","April","Mai","Juni","Juli","August","September","Oktober","November","Dezember"]'&gt;
+    &lt;span slot="fromLabel"&gt;Abreisedatum&lt;/span&gt;
+    &lt;span slot="helpText"&gt;Wählen Sie ein Datum&lt;/span&gt;
+  &lt;/auro-datepicker&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+<auro-header level="4" id="localizationCalendarA11yStrings">Screen reader strings</auro-header>
+<p>Assistive-technology announcements — range descriptors (<code>rangeLabelStart</code>, <code>rangeLabelEnd</code>, <code>rangeLabelBeforeRange</code>, <code>rangeLabelInRange</code>, <code>rangeLabelAfterRange</code>), month navigation labels (<code>navLabelPrevMonth</code>, <code>navLabelNextMonth</code>), and the calendar grid label (<code>calendarGridLabel</code>) — are exposed as individual attributes so they can be translated independently of the visible UI. These strings are not derived from <code>locale</code>; supply translated values for every language you support.</p>
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/localization-screenreader-strings.html) -->
+<!-- The below content is automatically added from ./../apiExamples/localization-screenreader-strings.html -->
+
+<pre class="language-diff"><code class="language-diff">  &lt;auro-datepicker
+    locale="de-DE"
+    range
++   rangeLabelStart="Startdatum"
++   rangeLabelEnd="Enddatum"
++   rangeLabelBeforeRange="vor dem Zeitraum"
++   rangeLabelInRange="im Zeitraum"
++   rangeLabelAfterRange="nach dem Zeitraum"
++   navLabelPrevMonth="Vorheriger Monat"
++   navLabelNextMonth="Nächster Monat"
++   calendarGridLabel="Kalendertage des Monats"&gt;
+    &lt;span slot="fromLabel"&gt;Abreise&lt;/span&gt;
+    &lt;span slot="toLabel"&gt;Rückkehr&lt;/span&gt;
+    &lt;span slot="helpText"&gt;Wählen Sie einen Zeitraum&lt;/span&gt;
+  &lt;/auro-datepicker&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+<auro-header level="4" id="localizationDateFormatting">Date formatting</auro-header>
+<p>The <code>locale</code> attribute drives the date format used by the input and the calendar. Setting <code>locale</code> automatically selects the regional format (for example <code>en-US</code> → <code>mm/dd/yyyy</code>, <code>de-DE</code> → <code>dd.mm.yyyy</code>, <code>ja-JP</code> → <code>yyyy/mm/dd</code>), derived from the browser's <code>Intl</code> API, so <code>format</code> does not need to be set manually.</p>
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/localization-locale.html) -->
+<!-- The below content is automatically added from ./../apiExamples/localization-locale.html -->
+
+<pre class="language-diff"><code class="language-diff">- &lt;auro-datepicker&gt;
++ &lt;auro-datepicker locale="de-DE"&gt;
+    &lt;span slot="fromLabel"&gt;Deutsches Datum&lt;/span&gt;
+    &lt;span slot="helpText"&gt;Hilfetext&lt;/span&gt;
+    &lt;span slot="optionalLabel"&gt;(freiwillig)&lt;/span&gt;
+  &lt;/auro-datepicker&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+<p>If no <code>locale</code> attribute is present, the component walks up the DOM looking for the nearest ancestor with a <code>data-locale</code> attribute; if none is found, it defaults to <code>en-US</code>.</p>
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/localization-locale-inherited.html) -->
+<!-- The below content is automatically added from ./../apiExamples/localization-locale-inherited.html -->
+
+<pre class="language-diff"><code class="language-diff">+ &lt;div data-locale="ja-JP"&gt;
+    &lt;auro-datepicker&gt;
+      &lt;span slot="fromLabel"&gt;継承された ja-JP 日付形式&lt;/span&gt;
+      &lt;span slot="helpText"&gt;ヘルプテキスト&lt;/span&gt;
+      &lt;span slot="optionalLabel"&gt;（任意）&lt;/span&gt;
+    &lt;/auro-datepicker&gt;
++ &lt;/div&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+<p>If <code>format</code> is set alongside <code>locale</code>, <code>format</code> always wins.</p>
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/localization-locale-formatted.html) -->
+<!-- The below content is automatically added from ./../apiExamples/localization-locale-formatted.html -->
+
+<pre class="language-diff"><code class="language-diff">  &lt;auro-datepicker
++   locale="de-DE"
++   format="mm/dd/yyyy"&gt;
+    &lt;span slot="fromLabel"&gt;Deutsches Datum mit mm/dd/yyyy-Format&lt;/span&gt;
+    &lt;span slot="helpText"&gt;Hilfetext&lt;/span&gt;
+    &lt;span slot="optionalLabel"&gt;(freiwillig)&lt;/span&gt;
+  &lt;/auro-datepicker&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+<div class="exampleWrapper">
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/locale.html) -->
+<!-- The below content is automatically added from ./../apiExamples/locale.html -->
+<div data-locale="de-DE">
+<auro-header level="4" >de-DE Example</auro-header>
+<auro-datepicker
+    locale="de-DE"
+    range
+    rangeLabelStart="Startdatum"
+    rangeLabelEnd="Enddatum"
+    rangeLabelBeforeRange="vor dem Zeitraum"
+    rangeLabelInRange="im Zeitraum"
+    rangeLabelAfterRange="nach dem Zeitraum"
+    navLabelPrevMonth="Vorheriger Monat"
+    navLabelNextMonth="Nächster Monat"
+    calendarGridLabel="Kalendertage des Monats">
+<span slot="fromLabel">Deutsches Datum</span>
+<span slot="helpText">Hilfetext</span>
+<span slot="optionalLabel">(freiwillig)</span>
+</auro-datepicker>
+<auro-header level="4" >zh-CN Example</auro-header>
+<auro-datepicker
+    locale="zh-CN"
+    range
+    rangeLabelStart="开始日期"
+    rangeLabelEnd="结束日期"
+    rangeLabelBeforeRange="在此期间之前"
+    rangeLabelInRange="在此期间内"
+    rangeLabelAfterRange="在此期间之后"
+    navLabelPrevMonth="上个月"
+    navLabelNextMonth="下个月"
+    calendarGridLabel="本月的日历天数">
+<span slot="fromLabel">中文日期</span>
+<span slot="helpText">帮助文本</span>
+<span slot="optionalLabel">（可选）</span>
+</auro-datepicker>
+<auro-header level="4">Inherited de-DE date-locale Example</auro-header>
+<auro-datepicker
+    range
+    rangeLabelStart="Startdatum"
+    rangeLabelEnd="Enddatum"
+    rangeLabelBeforeRange="vor dem Zeitraum"
+    rangeLabelInRange="im Zeitraum"
+    rangeLabelAfterRange="nach dem Zeitraum"
+    navLabelPrevMonth="Vorheriger Monat"
+    navLabelNextMonth="Nächster Monat"
+    calendarGridLabel="Kalendertage des Monats">
+<span slot="fromLabel">Nächstes `data-locale`-Attributformat (`de-DE` in diesem Fall)</span>
+<span slot="helpText">Hilfetext</span>
+<span slot="optionalLabel">(freiwillig)</span>
+</auro-datepicker>
+<auro-header level="4" >ja-JP with `mm/dd/yyyy` format Example</auro-header>
+<auro-datepicker
+    locale="ja-JP"
+    format="mm/dd/yyyy"
+    range
+    rangeLabelStart="開始日"
+    rangeLabelEnd="終了日"
+    rangeLabelBeforeRange="この期間の前"
+    rangeLabelInRange="この期間内"
+    rangeLabelAfterRange="この期間の後"
+    navLabelPrevMonth="前の月"
+    navLabelNextMonth="次の月"
+    calendarGridLabel="カレンダーの日付">
+<span slot="fromLabel">明示的な mm/dd/yyyy 形式の ja-JP ロケール</span>
+<span slot="helpText">ヘルプテキスト</span>
+<span slot="optionalLabel">（任意）</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/locale.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/locale.html -->
+<pre class="language-html"><code class="language-html">&lt;div data-locale="de-DE"&gt;
+  &lt;auro-header level="4" &gt;de-DE Example&lt;/auro-header&gt;
+  &lt;auro-datepicker
+    locale="de-DE"
+    range
+    rangeLabelStart="Startdatum"
+    rangeLabelEnd="Enddatum"
+    rangeLabelBeforeRange="vor dem Zeitraum"
+    rangeLabelInRange="im Zeitraum"
+    rangeLabelAfterRange="nach dem Zeitraum"
+    navLabelPrevMonth="Vorheriger Monat"
+    navLabelNextMonth="Nächster Monat"
+    calendarGridLabel="Kalendertage des Monats"&gt;
+    &lt;span slot="fromLabel"&gt;Deutsches Datum&lt;/span&gt;
+    &lt;span slot="helpText"&gt;Hilfetext&lt;/span&gt;
+    &lt;span slot="optionalLabel"&gt;(freiwillig)&lt;/span&gt;
+  &lt;/auro-datepicker&gt;
+  &lt;auro-header level="4" &gt;zh-CN Example&lt;/auro-header&gt;
+  &lt;auro-datepicker
+    locale="zh-CN"
+    range
+    rangeLabelStart="开始日期"
+    rangeLabelEnd="结束日期"
+    rangeLabelBeforeRange="在此期间之前"
+    rangeLabelInRange="在此期间内"
+    rangeLabelAfterRange="在此期间之后"
+    navLabelPrevMonth="上个月"
+    navLabelNextMonth="下个月"
+    calendarGridLabel="本月的日历天数"&gt;
+    &lt;span slot="fromLabel"&gt;中文日期&lt;/span&gt;
+    &lt;span slot="helpText"&gt;帮助文本&lt;/span&gt;
+    &lt;span slot="optionalLabel"&gt;（可选）&lt;/span&gt;
+  &lt;/auro-datepicker&gt;
+  &lt;auro-header level="4"&gt;Inherited de-DE date-locale Example&lt;/auro-header&gt;
+  &lt;auro-datepicker
+    range
+    rangeLabelStart="Startdatum"
+    rangeLabelEnd="Enddatum"
+    rangeLabelBeforeRange="vor dem Zeitraum"
+    rangeLabelInRange="im Zeitraum"
+    rangeLabelAfterRange="nach dem Zeitraum"
+    navLabelPrevMonth="Vorheriger Monat"
+    navLabelNextMonth="Nächster Monat"
+    calendarGridLabel="Kalendertage des Monats"&gt;
+    &lt;span slot="fromLabel"&gt;Nächstes `data-locale`-Attributformat (`de-DE` in diesem Fall)&lt;/span&gt;
+    &lt;span slot="helpText"&gt;Hilfetext&lt;/span&gt;
+    &lt;span slot="optionalLabel"&gt;(freiwillig)&lt;/span&gt;
+  &lt;/auro-datepicker&gt;
+  &lt;auro-header level="4" &gt;ja-JP with `mm/dd/yyyy` format Example&lt;/auro-header&gt;
+  &lt;auro-datepicker
+    locale="ja-JP"
+    format="mm/dd/yyyy"
+    range
+    rangeLabelStart="開始日"
+    rangeLabelEnd="終了日"
+    rangeLabelBeforeRange="この期間の前"
+    rangeLabelInRange="この期間内"
+    rangeLabelAfterRange="この期間の後"
+    navLabelPrevMonth="前の月"
+    navLabelNextMonth="次の月"
+    calendarGridLabel="カレンダーの日付"&gt;
+    &lt;span slot="fromLabel"&gt;明示的な mm/dd/yyyy 形式の ja-JP ロケール&lt;/span&gt;
+    &lt;span slot="helpText"&gt;ヘルプテキスト&lt;/span&gt;
+    &lt;span slot="optionalLabel"&gt;（任意）&lt;/span&gt;
+  &lt;/auro-datepicker&gt;
+&lt;/div&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+<!-- AURO-GENERATED-CONTENT:END -->
+<auro-header level="3" id="layout">Shape, Size & Layout</auro-header>
+<p>The <code>shape</code>, <code>size</code> and <code>layout</code> attributes work in collaboration to control the overall architecture of the component.</p>
+<p>See the <a href="./design.html">Design page</a> for a detailed breakdown.</p>
+</section>
+<section>
 <auro-header level="3" id="cssTokens">Tokens</auro-header>
 <p>The component may be restyled by changing the values of the following token(s) for the datepicker, dropdown, and input</p>
 <auro-header level="4" id="cssTokensDatepicker">Datepicker</auro-header>
@@ -278,40 +585,6 @@
   --ds-auro-dropdownbib-text-color: var(--ds-basic-color-texticon-inverse, #{v.$ds-basic-color-texticon-inverse});
 }</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
-<auro-header level="4" id="cssTokensInput">Input</auro-header>
-<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../../input/src/styles/tokens.scss) -->
-<!-- The below code snippet is automatically added from ./../../input/src/styles/tokens.scss -->
-
-<pre class="language-scss"><code class="language-scss">/* stylelint-disable custom-property-empty-line-before */
-​
-@use "@aurodesignsystem/design-tokens/dist/themes/alaska/SCSSVariables--alaska" as v;
-​
-:host(:not([ondark])),
-:host(:not([appearance="inverse"])) {
-  --ds-auro-input-border-color: var(--ds-basic-color-border-bold, #{v.$ds-basic-color-border-bold});
-  --ds-auro-input-container-color: var(--ds-basic-color-surface-default, #{v.$ds-basic-color-surface-default});
-  --ds-auro-input-caret-color: var(--ds-advanced-color-state-focused, #{v.$ds-advanced-color-state-focused});
-  --ds-auro-input-label-text-color: var(--ds-basic-color-texticon-muted, #{v.$ds-basic-color-texticon-muted});
-  --ds-auro-input-placeholder-text-color: var(--ds-basic-color-texticon-default, #{v.$ds-basic-color-texticon-default});
-  --ds-auro-input-text-color: var(--ds-basic-color-texticon-default, #{v.$ds-basic-color-texticon-default});
-  --ds-auro-input-error-icon-color: var(--ds-basic-color-status-error, #{v.$ds-basic-color-status-error});
-​
-  --ds-auro-input-outline-color: transparent;
-}
-​
-:host([ondark]),
-:host([appearance="inverse"]) {
-  --ds-auro-input-border-color: var(--ds-basic-color-border-inverse, #{v.$ds-basic-color-border-inverse});
-  --ds-auro-input-container-color: var(--ds-advanced-color-shared-background-inverse, #{v.$ds-advanced-color-shared-background-inverse});
-  --ds-auro-input-caret-color: var(--ds-advanced-color-state-focused-inverse, #{v.$ds-advanced-color-state-focused-inverse});
-  --ds-auro-input-label-text-color: var(--ds-basic-color-texticon-inverse-muted, #{v.$ds-basic-color-texticon-inverse-muted});
-  --ds-auro-input-placeholder-text-color: var(--ds-basic-color-texticon-inverse, #{v.$ds-basic-color-texticon-inverse});
-  --ds-auro-input-text-color: var(--ds-basic-color-texticon-inverse, #{v.$ds-basic-color-texticon-inverse});
-  --ds-auro-input-error-icon-color: var(--ds-advanced-color-state-error-inverse, #{v.$ds-advanced-color-state-error-inverse});
-​
-  --ds-auro-input-outline-color: transparent;
-}</code></pre>
-<!-- AURO-GENERATED-CONTENT:END -->
 <auro-header level="4" id="cssTokensExample">Example</auro-header>
 <p>The following example demonstrates overriding all available datepicker, dropdown, input, and calendar tokens.</p>
 <div class="exampleWrapper">
@@ -410,86 +683,50 @@
 &lt;/auro-datepicker&gt;</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>
-</section>
-<section>
-<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../docs/partials/customize/css-parts.md) -->
-<!-- The below content is automatically added from ./../docs/partials/customize/css-parts.md -->
-<auro-header level="3" id="cssParts">CSS Shadow Parts</auro-header>
-<p>CSS Shadow Parts allow you to style elements inside a web component's shadow DOM using the <code>::part()</code> pseudo-element. The following parts are exposed by <code>&lt;auro-datepicker&gt;</code>.</p>
-<table class="auro_table">
-<thead>
-<tr>
-<th>Part</th>
-<th>Description</th>
-</tr>
-</thead>
-<tbody>
-<tr><td><code>dropdown</code></td><td>The outer dropdown container.</td></tr>
-<tr><td><code>trigger</code></td><td>The trigger content container.</td></tr>
-<tr><td><code>input</code></td><td>The date input element(s).</td></tr>
-<tr><td><code>calendarWrapper</code></td><td>The calendar bib sizing container.</td></tr>
-<tr><td><code>calendar</code></td><td>The calendar element.</td></tr>
-<tr><td><code>helpTextSpan</code></td><td>The help text container wrapper.</td></tr>
-<tr><td><code>helpText</code></td><td>The help text element.</td></tr>
-</tbody>
-</table>
-<!-- AURO-GENERATED-CONTENT:END -->
-<div class="exampleWrapper">
-<!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/css-parts.html) -->
-<!-- The below content is automatically added from ../apiExamples/css-parts.html -->
-<style>
-  auro-datepicker.css-parts-demo::part(trigger) {
-    border-color: orange;
-  }
-  auro-datepicker.css-parts-demo::part(helpText) {
-    color: green;
-  }
-  auro-datepicker.css-parts-demo::part(calendarWrapper) {
-    max-height: 400px;
-  }
-</style>
-<auro-datepicker class="css-parts-demo">
-<span slot="fromLabel">CSS Parts Example</span>
-<span slot="helpText">This datepicker has custom styles applied via CSS Shadow Parts.</span>
-<span slot="bib.fullscreen.headline">Select Date</span>
-<span slot="bib.fullscreen.fromLabel">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/css-parts.html) -->
-<!-- The below code snippet is automatically added from ../apiExamples/css-parts.html -->
+<auro-header level="4" id="cssTokensInput">Input</auro-header>
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../../input/src/styles/tokens.scss) -->
+<!-- The below code snippet is automatically added from ./../../input/src/styles/tokens.scss -->
 
-<pre class="language-html"><code class="language-html">&lt;style&gt;
-  auro-datepicker.css-parts-demo::part(trigger) {
-    border-color: orange;
-  }
-  auro-datepicker.css-parts-demo::part(helpText) {
-    color: green;
-  }
-  auro-datepicker.css-parts-demo::part(calendarWrapper) {
-    max-height: 400px;
-  }
-&lt;/style&gt;
-&lt;auro-datepicker class="css-parts-demo"&gt;
-  &lt;span slot="fromLabel"&gt;CSS Parts Example&lt;/span&gt;
-  &lt;span slot="helpText"&gt;This datepicker has custom styles applied via CSS Shadow Parts.&lt;/span&gt;
-  &lt;span slot="bib.fullscreen.headline"&gt;Select Date&lt;/span&gt;
-  &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
-&lt;/auro-datepicker&gt;</code></pre>
+<pre class="language-scss"><code class="language-scss">/* stylelint-disable custom-property-empty-line-before */
+​
+@use "@aurodesignsystem/design-tokens/dist/themes/alaska/SCSSVariables--alaska" as v;
+​
+:host(:not([ondark])),
+:host(:not([appearance="inverse"])) {
+  --ds-auro-input-border-color: var(--ds-basic-color-border-bold, #{v.$ds-basic-color-border-bold});
+  --ds-auro-input-container-color: var(--ds-basic-color-surface-default, #{v.$ds-basic-color-surface-default});
+  --ds-auro-input-caret-color: var(--ds-advanced-color-state-focused, #{v.$ds-advanced-color-state-focused});
+  --ds-auro-input-label-text-color: var(--ds-basic-color-texticon-muted, #{v.$ds-basic-color-texticon-muted});
+  --ds-auro-input-placeholder-text-color: var(--ds-basic-color-texticon-default, #{v.$ds-basic-color-texticon-default});
+  --ds-auro-input-text-color: var(--ds-basic-color-texticon-default, #{v.$ds-basic-color-texticon-default});
+  --ds-auro-input-error-icon-color: var(--ds-basic-color-status-error, #{v.$ds-basic-color-status-error});
+​
+  --ds-auro-input-outline-color: transparent;
+}
+​
+:host([ondark]),
+:host([appearance="inverse"]) {
+  --ds-auro-input-border-color: var(--ds-basic-color-border-inverse, #{v.$ds-basic-color-border-inverse});
+  --ds-auro-input-container-color: var(--ds-advanced-color-shared-background-inverse, #{v.$ds-advanced-color-shared-background-inverse});
+  --ds-auro-input-caret-color: var(--ds-advanced-color-state-focused-inverse, #{v.$ds-advanced-color-state-focused-inverse});
+  --ds-auro-input-label-text-color: var(--ds-basic-color-texticon-inverse-muted, #{v.$ds-basic-color-texticon-inverse-muted});
+  --ds-auro-input-placeholder-text-color: var(--ds-basic-color-texticon-inverse, #{v.$ds-basic-color-texticon-inverse});
+  --ds-auro-input-text-color: var(--ds-basic-color-texticon-inverse, #{v.$ds-basic-color-texticon-inverse});
+  --ds-auro-input-error-icon-color: var(--ds-advanced-color-state-error-inverse, #{v.$ds-advanced-color-state-error-inverse});
+​
+  --ds-auro-input-outline-color: transparent;
+}</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
-</auro-accordion>
 </section>
 <section>
 <auro-header level="2" id="customBehavior">Behavior</auro-header>
-<auro-header level="3" id="inputMode">Input Mode</auro-header>
-<p>The <code>inputmode</code> attribute controls which virtual keyboard layout is presented on mobile devices.</p>
+<auro-header level="3" id="customValidation">Custom Validation</auro-header>
+<p>Use the <code>validity</code> attribute with a custom error message to provide specific feedback.</p>
 <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>
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/validity.html) -->
+<!-- The below content is automatically added from ./../apiExamples/validity.html -->
+<auro-datepicker required setCustomValidityValueMissing="Please select a departure date.">
+<span slot="bib.fullscreen.headline">validity Example</span>
 <span slot="fromLabel">Choose a date</span>
 <span slot="bib.fullscreen.fromLabel">Choose a date</span>
 </auro-datepicker>
@@ -497,11 +734,11 @@
 </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 -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/validity.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/validity.html -->
 
-<pre class="language-html"><code class="language-html">&lt;auro-datepicker inputmode="numeric"&gt;
-  &lt;span slot="bib.fullscreen.headline"&gt;Datepicker Headline&lt;/span&gt;
+<pre class="language-html"><code class="language-html">&lt;auro-datepicker required setCustomValidityValueMissing="Please select a departure date."&gt;
+  &lt;span slot="bib.fullscreen.headline"&gt;validity Example&lt;/span&gt;
   &lt;span slot="fromLabel"&gt;Choose a date&lt;/span&gt;
   &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
 &lt;/auro-datepicker&gt;</code></pre>
@@ -529,46 +766,6 @@
 &lt;/auro-datepicker&gt;</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>
-<auro-header level="3" id="requireSelection">Require Selection</auro-header>
-<p>Use the <code>required</code> attribute to require a date selection before form submission.</p>
-<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>
-<span slot="bib.fullscreen.headline">Required Example</span>
-<span slot="fromLabel">Choose a date</span>
-<span slot="bib.fullscreen.fromLabel">Choose a date</span>
-</auro-datepicker>
-<br />
-<auro-datepicker required range>
-<span slot="bib.fullscreen.headline">Required Example</span>
-<span slot="fromLabel">Departure</span>
-<span slot="toLabel">Return</span>
-<span slot="bib.fullscreen.fromLabel">Departure</span>
-<span slot="bib.fullscreen.toLabel">Return</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 -->
-
-<pre class="language-html"><code class="language-html">&lt;auro-datepicker required&gt;
-  &lt;span slot="bib.fullscreen.headline"&gt;Required Example&lt;/span&gt;
-  &lt;span slot="fromLabel"&gt;Choose a date&lt;/span&gt;
-  &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
-&lt;/auro-datepicker&gt;
-&lt;br /&gt;
-&lt;auro-datepicker required range&gt;
-  &lt;span slot="bib.fullscreen.headline"&gt;Required Example&lt;/span&gt;
-  &lt;span slot="fromLabel"&gt;Departure&lt;/span&gt;
-  &lt;span slot="toLabel"&gt;Return&lt;/span&gt;
-  &lt;span slot="bib.fullscreen.fromLabel"&gt;Departure&lt;/span&gt;
-  &lt;span slot="bib.fullscreen.toLabel"&gt;Return&lt;/span&gt;
-&lt;/auro-datepicker&gt;</code></pre>
-<!-- AURO-GENERATED-CONTENT:END -->
-</auro-accordion>
 <auro-header level="3" id="forceError">Force Error State</auro-header>
 <p>Use the <code>error</code> attribute to force the component into an error state with a custom message.</p>
 <div class="exampleWrapper">
@@ -599,37 +796,13 @@
 &lt;/auro-datepicker&gt;</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>
-<auro-header level="3" id="customValidation">Custom Validation</auro-header>
-<p>Use the <code>validity</code> attribute with a custom error message to provide specific feedback.</p>
-<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 setCustomValidityValueMissing="Please select a departure date.">
-<span slot="bib.fullscreen.headline">validity Example</span>
-<span slot="fromLabel">Choose a date</span>
-<span slot="bib.fullscreen.fromLabel">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/validity.html) -->
-<!-- The below code snippet is automatically added from ./../apiExamples/validity.html -->
-
-<pre class="language-html"><code class="language-html">&lt;auro-datepicker required setCustomValidityValueMissing="Please select a departure date."&gt;
-  &lt;span slot="bib.fullscreen.headline"&gt;validity Example&lt;/span&gt;
-  &lt;span slot="fromLabel"&gt;Choose a date&lt;/span&gt;
-  &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
-&lt;/auro-datepicker&gt;</code></pre>
-<!-- AURO-GENERATED-CONTENT:END -->
-</auro-accordion>
-<auro-header level="3" id="noValidate">No Validation</auro-header>
-<p>Use the <code>noValidate</code> attribute to disable all validation on the component.</p>
+<auro-header level="3" id="inputMode">Input Mode</auro-header>
+<p>The <code>inputmode</code> attribute controls which virtual keyboard layout is presented on mobile devices.</p>
 <div class="exampleWrapper">
-<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/no-validate.html) -->
-<!-- The below content is automatically added from ./../apiExamples/no-validate.html -->
-<auro-datepicker required noValidate>
-<span slot="bib.fullscreen.headline">noValidate Example</span>
+<!-- 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.fromLabel">Choose a date</span>
 </auro-datepicker>
@@ -637,11 +810,11 @@
 </div>
 <auro-accordion alignRight>
 <span slot="trigger">See code</span>
-<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/no-validate.html) -->
-<!-- The below code snippet is automatically added from ./../apiExamples/no-validate.html -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/inputmode.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/inputmode.html -->
 
-<pre class="language-html"><code class="language-html">&lt;auro-datepicker required noValidate&gt;
-  &lt;span slot="bib.fullscreen.headline"&gt;noValidate Example&lt;/span&gt;
+<pre class="language-html"><code class="language-html">&lt;auro-datepicker inputmode="numeric"&gt;
+  &lt;span slot="bib.fullscreen.headline"&gt;Datepicker Headline&lt;/span&gt;
   &lt;span slot="fromLabel"&gt;Choose a date&lt;/span&gt;
   &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
 &lt;/auro-datepicker&gt;</code></pre>
@@ -693,65 +866,68 @@
 &lt;/auro-datepicker&gt;</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>
-<auro-header level="3" id="localization">Localization</auro-header>
-<auro-header level="4" id="regionalDate">Regional Date</auro-header>
-<p>When the <code>locale</code> attribute is set, the component automatically derives the correct date format for that region — no need to set <code>format</code> manually. For example, <code>locale="en-US"</code> produces <code>mm/dd/yyyy</code>, <code>locale="de-DE"</code> produces <code>dd.mm.yyyy</code>, and <code>locale="ja-JP"</code> produces <code>yyyy/mm/dd</code>.</p>
-<p>If <code>format</code> is explicitly set alongside <code>locale</code>, <code>format</code> always wins. Use this when a specific format is required regardless of region.</p>
-<p>If no <code>locale</code> attribute is set on the element, the component walks up the DOM looking for the nearest ancestor with a <code>data-locale</code> attribute and uses that value. If none is found, it defaults to <code>en-US</code>.</p>
+<auro-header level="3" id="noValidate">No Validation</auro-header>
+<p>Use the <code>noValidate</code> attribute to disable all validation on the component.</p>
 <div class="exampleWrapper">
-<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/locale.html) -->
-<!-- The below content is automatically added from ./../apiExamples/locale.html -->
-<div data-locale="de-DE">
-<auro-datepicker locale="en-US">
-<span slot="fromLabel">en-US Date</span>
-<span slot="helpText">Help Text</span>
-</auro-datepicker>
-<auro-datepicker locale="de-DE">
-<span slot="fromLabel">de-DE Date</span>
-<span slot="helpText">Help Text</span>
-</auro-datepicker>
-<auro-datepicker locale="zh-CN">
-<span slot="fromLabel">zh-CN Date</span>
-<span slot="helpText">Help Text</span>
-</auro-datepicker>
-<auro-datepicker>
-<span slot="fromLabel">Nearest `data-locale` attribute format (`de-DE` in this case)</span>
-<span slot="helpText">Help Text</span>
-</auro-datepicker>
-<auro-datepicker locale="ja-JP" format="mm/dd/yyyy">
-<span slot="fromLabel">ja-JP locale with explicit mm/dd/yyyy format</span>
-<span slot="helpText">Help Text</span>
+<!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/no-validate.html) -->
+<!-- The below content is automatically added from ./../apiExamples/no-validate.html -->
+<auro-datepicker required noValidate>
+<span slot="bib.fullscreen.headline">noValidate Example</span>
+<span slot="fromLabel">Choose a date</span>
+<span slot="bib.fullscreen.fromLabel">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/no-validate.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/no-validate.html -->
+
+<pre class="language-html"><code class="language-html">&lt;auro-datepicker required noValidate&gt;
+  &lt;span slot="bib.fullscreen.headline"&gt;noValidate Example&lt;/span&gt;
+  &lt;span slot="fromLabel"&gt;Choose a date&lt;/span&gt;
+  &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
+&lt;/auro-datepicker&gt;</code></pre>
+<!-- AURO-GENERATED-CONTENT:END -->
+</auro-accordion>
+<auro-header level="3" id="requireSelection">Require Selection</auro-header>
+<p>Use the <code>required</code> attribute to require a date selection before form submission.</p>
+<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>
+<span slot="bib.fullscreen.headline">Required Example</span>
+<span slot="fromLabel">Choose a date</span>
+<span slot="bib.fullscreen.fromLabel">Choose a date</span>
+</auro-datepicker>
+<br />
+<auro-datepicker required range>
+<span slot="bib.fullscreen.headline">Required Example</span>
+<span slot="fromLabel">Departure</span>
+<span slot="toLabel">Return</span>
+<span slot="bib.fullscreen.fromLabel">Departure</span>
+<span slot="bib.fullscreen.toLabel">Return</span>
+</auro-datepicker>
 <!-- AURO-GENERATED-CONTENT:END -->
 </div>
 <auro-accordion alignRight>
 <span slot="trigger">See code</span>
-<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/locale.html) -->
-<!-- The below code snippet is automatically added from ./../apiExamples/locale.html -->
+<!-- AURO-GENERATED-CONTENT:START (CODE:src=./../apiExamples/required.html) -->
+<!-- The below code snippet is automatically added from ./../apiExamples/required.html -->
 
-<pre class="language-html"><code class="language-html">&lt;div data-locale="de-DE"&gt;
-  &lt;auro-datepicker locale="en-US"&gt;
-    &lt;span slot="fromLabel"&gt;en-US Date&lt;/span&gt;
-    &lt;span slot="helpText"&gt;Help Text&lt;/span&gt;
-  &lt;/auro-datepicker&gt;
-  &lt;auro-datepicker locale="de-DE"&gt;
-    &lt;span slot="fromLabel"&gt;de-DE Date&lt;/span&gt;
-    &lt;span slot="helpText"&gt;Help Text&lt;/span&gt;
-  &lt;/auro-datepicker&gt;
-  &lt;auro-datepicker locale="zh-CN"&gt;
-    &lt;span slot="fromLabel"&gt;zh-CN Date&lt;/span&gt;
-    &lt;span slot="helpText"&gt;Help Text&lt;/span&gt;
-  &lt;/auro-datepicker&gt;
-  &lt;auro-datepicker&gt;
-    &lt;span slot="fromLabel"&gt;Nearest `data-locale` attribute format (`de-DE` in this case)&lt;/span&gt;
-    &lt;span slot="helpText"&gt;Help Text&lt;/span&gt;
-  &lt;/auro-datepicker&gt;
-  &lt;auro-datepicker locale="ja-JP" format="mm/dd/yyyy"&gt;
-    &lt;span slot="fromLabel"&gt;ja-JP locale with explicit mm/dd/yyyy format&lt;/span&gt;
-    &lt;span slot="helpText"&gt;Help Text&lt;/span&gt;
-  &lt;/auro-datepicker&gt;
-&lt;/div&gt;</code></pre>
+<pre class="language-html"><code class="language-html">&lt;auro-datepicker required&gt;
+  &lt;span slot="bib.fullscreen.headline"&gt;Required Example&lt;/span&gt;
+  &lt;span slot="fromLabel"&gt;Choose a date&lt;/span&gt;
+  &lt;span slot="bib.fullscreen.fromLabel"&gt;Choose a date&lt;/span&gt;
+&lt;/auro-datepicker&gt;
+&lt;br /&gt;
+&lt;auro-datepicker required range&gt;
+  &lt;span slot="bib.fullscreen.headline"&gt;Required Example&lt;/span&gt;
+  &lt;span slot="fromLabel"&gt;Departure&lt;/span&gt;
+  &lt;span slot="toLabel"&gt;Return&lt;/span&gt;
+  &lt;span slot="bib.fullscreen.fromLabel"&gt;Departure&lt;/span&gt;
+  &lt;span slot="bib.fullscreen.toLabel"&gt;Return&lt;/span&gt;
+&lt;/auro-datepicker&gt;</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>
 </section>