@aurodesignsystem-dev/auro-formkit 0.0.0-pr1628.2 → 0.0.0-pr1628.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/components/checkbox/demo/customize.min.js +1 -1
  2. package/components/checkbox/demo/getting-started.min.js +1 -1
  3. package/components/checkbox/demo/index.min.js +1 -1
  4. package/components/checkbox/dist/index.js +1 -1
  5. package/components/checkbox/dist/registered.js +1 -1
  6. package/components/combobox/demo/customize.min.js +3 -3
  7. package/components/combobox/demo/getting-started.min.js +3 -3
  8. package/components/combobox/demo/index.min.js +3 -3
  9. package/components/combobox/dist/index.js +3 -3
  10. package/components/combobox/dist/registered.js +3 -3
  11. package/components/counter/demo/customize.min.js +2 -2
  12. package/components/counter/demo/getting-started.min.js +2 -2
  13. package/components/counter/demo/index.min.js +2 -2
  14. package/components/counter/dist/index.js +2 -2
  15. package/components/counter/dist/registered.js +2 -2
  16. package/components/datepicker/demo/accessibility.md +3 -3
  17. package/components/datepicker/demo/api.md +3 -3
  18. package/components/datepicker/demo/customize.md +10 -10
  19. package/components/datepicker/demo/customize.min.js +30 -18
  20. package/components/datepicker/demo/design.md +9 -9
  21. package/components/datepicker/demo/getting-started.md +3 -3
  22. package/components/datepicker/demo/getting-started.min.js +30 -18
  23. package/components/datepicker/demo/index.md +3 -3
  24. package/components/datepicker/demo/index.min.js +30 -18
  25. package/components/datepicker/demo/voiceover.md +1 -1
  26. package/components/datepicker/dist/auro-calendar.d.ts +1 -1
  27. package/components/datepicker/dist/auro-datepicker.d.ts +3 -3
  28. package/components/datepicker/dist/datepickerKeyboardStrategy.d.ts +3 -0
  29. package/components/datepicker/dist/index.js +30 -18
  30. package/components/datepicker/dist/registered.js +30 -18
  31. package/components/datepicker/dist/utilities.d.ts +3 -0
  32. package/components/datepicker/dist/utilitiesCalendar.d.ts +3 -0
  33. package/components/datepicker/dist/utilitiesCalendarRender.d.ts +3 -0
  34. package/components/datepicker/dist/vendor/wc-range-datepicker/range-datepicker-calendar.d.ts +4 -4
  35. package/components/datepicker/dist/vendor/wc-range-datepicker/range-datepicker.d.ts +7 -7
  36. package/components/dropdown/demo/customize.min.js +1 -1
  37. package/components/dropdown/demo/getting-started.min.js +2 -2
  38. package/components/dropdown/demo/index.min.js +1 -1
  39. package/components/dropdown/dist/index.js +1 -1
  40. package/components/dropdown/dist/registered.js +1 -1
  41. package/components/form/demo/customize.min.js +40 -28
  42. package/components/form/demo/getting-started.min.js +40 -28
  43. package/components/form/demo/index.min.js +40 -28
  44. package/components/form/demo/registerDemoDeps.min.js +40 -28
  45. package/components/input/demo/customize.min.js +1 -1
  46. package/components/input/demo/getting-started.min.js +1 -1
  47. package/components/input/demo/index.min.js +1 -1
  48. package/components/input/dist/index.js +1 -1
  49. package/components/input/dist/registered.js +1 -1
  50. package/components/radio/demo/customize.min.js +1 -1
  51. package/components/radio/demo/getting-started.min.js +1 -1
  52. package/components/radio/demo/index.min.js +1 -1
  53. package/components/radio/dist/index.js +1 -1
  54. package/components/radio/dist/registered.js +1 -1
  55. package/components/select/demo/customize.min.js +2 -2
  56. package/components/select/demo/getting-started.min.js +2 -2
  57. package/components/select/demo/index.min.js +2 -2
  58. package/components/select/dist/index.js +2 -2
  59. package/components/select/dist/registered.js +2 -2
  60. package/custom-elements.json +12 -11
  61. package/package.json +1 -1
@@ -1381,7 +1381,7 @@ class AuroHelpText extends i$2 {
1381
1381
  }
1382
1382
  }
1383
1383
 
1384
- var formkitVersion = '202611081803';
1384
+ var formkitVersion = '202611081821';
1385
1385
 
1386
1386
  // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
1387
1387
  // See LICENSE in the project root for license information.
@@ -1381,7 +1381,7 @@ class AuroHelpText extends i$2 {
1381
1381
  }
1382
1382
  }
1383
1383
 
1384
- var formkitVersion = '202611081803';
1384
+ var formkitVersion = '202611081821';
1385
1385
 
1386
1386
  // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
1387
1387
  // See LICENSE in the project root for license information.
@@ -1381,7 +1381,7 @@ class AuroHelpText extends i$2 {
1381
1381
  }
1382
1382
  }
1383
1383
 
1384
- var formkitVersion = '202611081803';
1384
+ var formkitVersion = '202611081821';
1385
1385
 
1386
1386
  // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
1387
1387
  // See LICENSE in the project root for license information.
@@ -1334,7 +1334,7 @@ class AuroHelpText extends LitElement {
1334
1334
  }
1335
1335
  }
1336
1336
 
1337
- var formkitVersion = '202611081803';
1337
+ var formkitVersion = '202611081821';
1338
1338
 
1339
1339
  // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
1340
1340
  // See LICENSE in the project root for license information.
@@ -1334,7 +1334,7 @@ class AuroHelpText extends LitElement {
1334
1334
  }
1335
1335
  }
1336
1336
 
1337
- var formkitVersion = '202611081803';
1337
+ var formkitVersion = '202611081821';
1338
1338
 
1339
1339
  // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
1340
1340
  // See LICENSE in the project root for license information.
@@ -5299,7 +5299,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
5299
5299
  }
5300
5300
  };
5301
5301
 
5302
- var formkitVersion$2 = '202611081803';
5302
+ var formkitVersion$2 = '202611081821';
5303
5303
 
5304
5304
  /**
5305
5305
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -19480,7 +19480,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
19480
19480
  }
19481
19481
  };
19482
19482
 
19483
- var formkitVersion$1 = '202611081803';
19483
+ var formkitVersion$1 = '202611081821';
19484
19484
 
19485
19485
  // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
19486
19486
  // See LICENSE in the project root for license information.
@@ -20766,7 +20766,7 @@ class AuroBibtemplate extends i$3 {
20766
20766
  }
20767
20767
  }
20768
20768
 
20769
- var formkitVersion = '202611081803';
20769
+ var formkitVersion = '202611081821';
20770
20770
 
20771
20771
  var styleCss$3 = i$6`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock{display:block}.util_displayFlex{display:flex}.util_displayHidden{display:none}.util_displayHiddenVisually{position:absolute;overflow:hidden;clip:rect(1px, 1px, 1px, 1px);width:1px;height:1px;padding:0;border:0}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
20772
20772
 
@@ -5299,7 +5299,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
5299
5299
  }
5300
5300
  };
5301
5301
 
5302
- var formkitVersion$2 = '202611081803';
5302
+ var formkitVersion$2 = '202611081821';
5303
5303
 
5304
5304
  /**
5305
5305
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -19480,7 +19480,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
19480
19480
  }
19481
19481
  };
19482
19482
 
19483
- var formkitVersion$1 = '202611081803';
19483
+ var formkitVersion$1 = '202611081821';
19484
19484
 
19485
19485
  // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
19486
19486
  // See LICENSE in the project root for license information.
@@ -20766,7 +20766,7 @@ class AuroBibtemplate extends i$3 {
20766
20766
  }
20767
20767
  }
20768
20768
 
20769
- var formkitVersion = '202611081803';
20769
+ var formkitVersion = '202611081821';
20770
20770
 
20771
20771
  var styleCss$3 = i$6`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock{display:block}.util_displayFlex{display:flex}.util_displayHidden{display:none}.util_displayHiddenVisually{position:absolute;overflow:hidden;clip:rect(1px, 1px, 1px, 1px);width:1px;height:1px;padding:0;border:0}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
20772
20772
 
@@ -5314,7 +5314,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
5314
5314
  }
5315
5315
  };
5316
5316
 
5317
- var formkitVersion$2 = '202611081803';
5317
+ var formkitVersion$2 = '202611081821';
5318
5318
 
5319
5319
  /**
5320
5320
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -19495,7 +19495,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
19495
19495
  }
19496
19496
  };
19497
19497
 
19498
- var formkitVersion$1 = '202611081803';
19498
+ var formkitVersion$1 = '202611081821';
19499
19499
 
19500
19500
  // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
19501
19501
  // See LICENSE in the project root for license information.
@@ -20781,7 +20781,7 @@ class AuroBibtemplate extends i$3 {
20781
20781
  }
20782
20782
  }
20783
20783
 
20784
- var formkitVersion = '202611081803';
20784
+ var formkitVersion = '202611081821';
20785
20785
 
20786
20786
  var styleCss$3 = i$6`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock{display:block}.util_displayFlex{display:flex}.util_displayHidden{display:none}.util_displayHiddenVisually{position:absolute;overflow:hidden;clip:rect(1px, 1px, 1px, 1px);width:1px;height:1px;padding:0;border:0}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
20787
20787
 
@@ -5232,7 +5232,7 @@ let AuroHelpText$2 = class AuroHelpText extends LitElement {
5232
5232
  }
5233
5233
  };
5234
5234
 
5235
- var formkitVersion$2 = '202611081803';
5235
+ var formkitVersion$2 = '202611081821';
5236
5236
 
5237
5237
  /**
5238
5238
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -19406,7 +19406,7 @@ let AuroHelpText$1 = class AuroHelpText extends LitElement {
19406
19406
  }
19407
19407
  };
19408
19408
 
19409
- var formkitVersion$1 = '202611081803';
19409
+ var formkitVersion$1 = '202611081821';
19410
19410
 
19411
19411
  // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
19412
19412
  // See LICENSE in the project root for license information.
@@ -20692,7 +20692,7 @@ class AuroBibtemplate extends LitElement {
20692
20692
  }
20693
20693
  }
20694
20694
 
20695
- var formkitVersion = '202611081803';
20695
+ var formkitVersion = '202611081821';
20696
20696
 
20697
20697
  var styleCss$1 = css`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock{display:block}.util_displayFlex{display:flex}.util_displayHidden{display:none}.util_displayHiddenVisually{position:absolute;overflow:hidden;clip:rect(1px, 1px, 1px, 1px);width:1px;height:1px;padding:0;border:0}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
20698
20698
 
@@ -5232,7 +5232,7 @@ let AuroHelpText$2 = class AuroHelpText extends LitElement {
5232
5232
  }
5233
5233
  };
5234
5234
 
5235
- var formkitVersion$2 = '202611081803';
5235
+ var formkitVersion$2 = '202611081821';
5236
5236
 
5237
5237
  /**
5238
5238
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -19406,7 +19406,7 @@ let AuroHelpText$1 = class AuroHelpText extends LitElement {
19406
19406
  }
19407
19407
  };
19408
19408
 
19409
- var formkitVersion$1 = '202611081803';
19409
+ var formkitVersion$1 = '202611081821';
19410
19410
 
19411
19411
  // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
19412
19412
  // See LICENSE in the project root for license information.
@@ -20692,7 +20692,7 @@ class AuroBibtemplate extends LitElement {
20692
20692
  }
20693
20693
  }
20694
20694
 
20695
- var formkitVersion = '202611081803';
20695
+ var formkitVersion = '202611081821';
20696
20696
 
20697
20697
  var styleCss$1 = css`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock{display:block}.util_displayFlex{display:flex}.util_displayHidden{display:none}.util_displayHiddenVisually{position:absolute;overflow:hidden;clip:rect(1px, 1px, 1px, 1px);width:1px;height:1px;padding:0;border:0}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
20698
20698
 
@@ -1166,7 +1166,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$1 {
1166
1166
  }
1167
1167
  };
1168
1168
 
1169
- var formkitVersion$1 = '202611081803';
1169
+ var formkitVersion$1 = '202611081821';
1170
1170
 
1171
1171
  // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
1172
1172
  // See LICENSE in the project root for license information.
@@ -5781,7 +5781,7 @@ class AuroHelpText extends i$1 {
5781
5781
  }
5782
5782
  }
5783
5783
 
5784
- var formkitVersion = '202611081803';
5784
+ var formkitVersion = '202611081821';
5785
5785
 
5786
5786
  /**
5787
5787
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -1164,7 +1164,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$2 {
1164
1164
  }
1165
1165
  };
1166
1166
 
1167
- var formkitVersion$1 = '202611081803';
1167
+ var formkitVersion$1 = '202611081821';
1168
1168
 
1169
1169
  // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
1170
1170
  // See LICENSE in the project root for license information.
@@ -5779,7 +5779,7 @@ class AuroHelpText extends i$2 {
5779
5779
  }
5780
5780
  }
5781
5781
 
5782
- var formkitVersion = '202611081803';
5782
+ var formkitVersion = '202611081821';
5783
5783
 
5784
5784
  /**
5785
5785
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -1164,7 +1164,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$2 {
1164
1164
  }
1165
1165
  };
1166
1166
 
1167
- var formkitVersion$1 = '202611081803';
1167
+ var formkitVersion$1 = '202611081821';
1168
1168
 
1169
1169
  // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
1170
1170
  // See LICENSE in the project root for license information.
@@ -5779,7 +5779,7 @@ class AuroHelpText extends i$2 {
5779
5779
  }
5780
5780
  }
5781
5781
 
5782
- var formkitVersion = '202611081803';
5782
+ var formkitVersion = '202611081821';
5783
5783
 
5784
5784
  /**
5785
5785
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -1114,7 +1114,7 @@ let AuroHelpText$1 = class AuroHelpText extends LitElement {
1114
1114
  }
1115
1115
  };
1116
1116
 
1117
- var formkitVersion$1 = '202611081803';
1117
+ var formkitVersion$1 = '202611081821';
1118
1118
 
1119
1119
  // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
1120
1120
  // See LICENSE in the project root for license information.
@@ -5711,7 +5711,7 @@ class AuroHelpText extends LitElement {
5711
5711
  }
5712
5712
  }
5713
5713
 
5714
- var formkitVersion = '202611081803';
5714
+ var formkitVersion = '202611081821';
5715
5715
 
5716
5716
  /**
5717
5717
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -1114,7 +1114,7 @@ let AuroHelpText$1 = class AuroHelpText extends LitElement {
1114
1114
  }
1115
1115
  };
1116
1116
 
1117
- var formkitVersion$1 = '202611081803';
1117
+ var formkitVersion$1 = '202611081821';
1118
1118
 
1119
1119
  // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
1120
1120
  // See LICENSE in the project root for license information.
@@ -5711,7 +5711,7 @@ class AuroHelpText extends LitElement {
5711
5711
  }
5712
5712
  }
5713
5713
 
5714
- var formkitVersion = '202611081803';
5714
+ var formkitVersion = '202611081821';
5715
5715
 
5716
5716
  /**
5717
5717
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -13,7 +13,7 @@ The trigger contains one or two `<auro-input>` elements (depending on whether `r
13
13
  | Attribute | Value | Description |
14
14
  |---|---|---|
15
15
  | `<label for>` | slot text | The input gets its accessible name from a `<label>` that holds the `fromLabel` or `toLabel` slot content. |
16
- | `aria-invalid` | `true` / `false` | Reflects whether the current value fails validation. |
16
+ | `aria-invalid` | `true` / `false` | Set to `true` when the value fails validation and `false` when it passes. It's also `true` before the datepicker is first validated, so screen readers can announce a new, empty datepicker as invalid. |
17
17
 
18
18
  <auro-header level="3" id="clearButton">Clear button</auro-header>
19
19
  The clear button (shown when the input has a value) exposes:
@@ -31,7 +31,7 @@ The calendar uses the WAI-ARIA grid pattern for screen reader navigation:
31
31
 
32
32
  | Attribute | Applied to | Description |
33
33
  |---|---|---|
34
- | `role="grid"` | Calendar table | Identifies the calendar as a grid. The month heading is rendered as visible text adjacent to the grid but is excluded from the accessibility tree (announcements are handled via the live region described below). |
34
+ | `role="grid"` | Calendar table | Identifies each month's days as a grid. The month heading above the grid is visible text that screen readers can reach, but it isn't linked to the grid as its name. The live region described below announces month changes. |
35
35
  | `role="rowgroup"` | Body group | Groups the week rows. |
36
36
  | `role="row"` | Week row | Groups each week of date cells. |
37
37
  | `role="columnheader"` | Day-of-week header | Each weekday cell in the header row exposes the abbreviated day name as visible text and the full localized day name via `aria-label`, for example `aria-label="Sunday"`. |
@@ -62,7 +62,7 @@ When the calendar bib opens, focus moves to the calendar grid wrapper (`#calenda
62
62
  <auro-header level="2" id="screenReaderAnnouncements">Screen reader announcements</auro-header>
63
63
  - **Date selection**: When a date is selected, the calendar's live region (`aria-live="assertive"`) announces the formatted date followed by "selected", for example "Wednesday, January 15, 2025, selected". For range datepickers, both the start and end date selections are announced, with the `rangeLabelStart` or `rangeLabelEnd` text.
64
64
  - **Debounced navigation announcement**: During arrow-key navigation, a debounced live region (150 ms) announces the full date context (date, slot content, range position, availability) after the user pauses. This prevents overlapping announcements during rapid navigation.
65
- - **Date cell labels**: Each date cell has an `aria-label` on the host element with the full localized label, including any date slot content, such as a price. VoiceOver reads this content instead of `aria-label`, which iOS VoiceOver does not reliably announce on buttons.
65
+ - **Date cell labels**: Each date cell has an `aria-label` on the host element with the full localized label, including any date slot content, such as a price. The cell's button content is hidden from screen readers, so the date isn't read twice.
66
66
  - **Validation errors**: When a validation error occurs, the error message is rendered with `role="alert"` and `aria-live="assertive"`, causing it to be announced immediately without requiring focus.
67
67
  - **Help text**: The help text isn't currently linked to the inputs with `aria-describedby`, so screen readers don't announce it when an input gets focus.
68
68
 
@@ -10,7 +10,7 @@ A date field that lets people type a date or choose it from a calendar, includin
10
10
  - **Limits and unavailable dates**: `minDate` and `maxDate` turn off dates outside a range, and `blackoutDates` marks single dates people can't select.
11
11
  - **Validation**: `required` shows an error when no date is chosen, and the `setCustomValidity` attributes replace the built-in error messages.
12
12
  - **Content on dates**: The `date_YYYY_MM_DD` and `popover_YYYY_MM_DD` slots add content to a date in the calendar, such as a price.
13
- - **Localization**: `locale` sets the date format and the month and weekday names, and attributes and slots let you translate every other label.
13
+ - **Localization**: `locale` sets the date format and the month and weekday names, and attributes and slots let you translate most other text, except the calendar's Done button and the word "selected" in screen reader announcements.
14
14
  - **Fullscreen on small screens**: `fullscreenBreakpoint` sets the screen size at or below which the calendar opens fullscreen.
15
15
 
16
16
  **Example**
@@ -38,9 +38,9 @@ A date field that lets people type a date or choose it from a calendar, includin
38
38
  | placeholderEndDate | placeholderenddate | | string | | ui | `range` | Sets the hint text shown in the end date input of a range when it's empty. When not set, the end date input uses `placeholder`. |
39
39
  | placement | placement | | `top` \| `right` \| `bottom` \| `left` \| `bottom-start` \| `top-start` \| `top-end` \| `right-start` \| `right-end` \| `bottom-end` \| `left-start` \| `left-end` | `bottom-start` | ui | | Sets where the calendar dropdown opens relative to the input, such as `bottom-start` (below the input, lined up with its start edge). The dropdown still flips to the opposite side when it doesn't fit, unless `noFlip` is set. |
40
40
  | referenceDates | referencedates | | string[] | | ui | | Sets dates to mark in the calendar for comparison, such as the dates of an earlier trip, as an array of ISO date strings (`YYYY-MM-DD`). Marked dates get an outline. Add `popover_YYYY_MM_DD` content to explain why each date is marked. |
41
- | shape | shape | | `box` \| `classic` \| `pill` \| `pill-left` \| `pill-right` \| `rounded` \| `snowflake` | `classic` | ui | | Sets the shape of the datepicker. |
41
+ | shape | shape | | `box` \| `classic` \| `pill` \| `pill-left` \| `pill-right` \| `rounded` \| `snowflake` | `classic` | ui | | Sets the shape of the date field. Use `classic` (the default) with the `classic` layout, and `snowflake` with the `snowflake` layout. |
42
42
  | shift | shift | | boolean | `false` | ui | | Moves the calendar dropdown along the input's edge so the edge of the screen doesn't cut it off. |
43
- | size | size | | `xs` \| `sm` \| `md` \| `lg` \| `xl` | `lg` | ui | | Sets the size of the datepicker. |
43
+ | size | size | | `xs` \| `sm` \| `md` \| `lg` \| `xl` | `lg` | ui | | Sets the height of the date field, from `xs`, the shortest, to `xl`, the tallest. The `classic` and `snowflake` shapes have a fixed height, so `size` doesn't change them. The `rounded` shape supports only `lg`, and the `pill`, `pill-left`, and `pill-right` shapes support only `md` and `xl`. |
44
44
  | stacked | stacked | | boolean | `false` | ui | | Doesn't currently change the datepicker's appearance or behavior. |
45
45
  | autoPlacement | autoplacement | | boolean | `false` | ui | | Deprecated: Use `placement` instead.<br>Places the calendar dropdown on whichever side of the input has the most space. The dropdown already flips to the opposite side when it doesn't fit, unless `noFlip` is set. |
46
46
  | onDark | ondark | | boolean | `false` | ui | | Deprecated: Use `appearance="inverse"` instead.<br>Switches the datepicker to colors designed for dark backgrounds. |
@@ -121,17 +121,17 @@
121
121
  </tr>
122
122
  </thead>
123
123
  <tbody>
124
- <tr><td><code>dropdown</code></td><td>The outer dropdown container.</td></tr>
125
- <tr><td><code>trigger</code></td><td>The trigger content container.</td></tr>
124
+ <tr><td><code>dropdown</code></td><td>The dropdown that holds the trigger, the calendar, and the help text.</td></tr>
125
+ <tr><td><code>trigger</code></td><td>The <code>&lt;div&gt;</code> in the dropdown's trigger that holds the calendar icon, the inputs, and the clear button or error icon.</td></tr>
126
126
  <tr><td><code>wrapper</code></td><td>The container inside <code>trigger</code> that lays out the calendar icon, the inputs, and the clear button or error icon.</td></tr>
127
127
  <tr><td><code>mainLabel</code></td><td>The label for the whole datepicker, rendered only when <code>layout="snowflake"</code>.</td></tr>
128
128
  <tr><td><code>inputSection</code></td><td>The container that holds the date inputs.</td></tr>
129
129
  <tr><td><code>accentIcon</code></td><td>The calendar icon shown before the inputs in the <code>snowflake</code> layout. The <code>classic</code> layout hides it and shows the start date input's own calendar icon instead.</td></tr>
130
- <tr><td><code>input</code></td><td>The date input element(s).</td></tr>
130
+ <tr><td><code>input</code></td><td>Each date input: one, or two when <code>range</code> is set.</td></tr>
131
131
  <tr><td><code>calendarWrapper</code></td><td>The container in the dropdown that holds the calendar.</td></tr>
132
- <tr><td><code>calendar</code></td><td>The calendar element.</td></tr>
133
- <tr><td><code>helpTextSpan</code></td><td>The help text container wrapper.</td></tr>
134
- <tr><td><code>helpText</code></td><td>The help text element.</td></tr>
132
+ <tr><td><code>calendar</code></td><td>The calendar in the dropdown, with the month grids, the previous and next month buttons, and the Done button.</td></tr>
133
+ <tr><td><code>helpTextSpan</code></td><td>The <code>&lt;div&gt;</code> that holds the help text or error message.</td></tr>
134
+ <tr><td><code>helpText</code></td><td>The <code>&lt;p&gt;</code> inside <code>helpTextSpan</code> that holds the help text or error message.</td></tr>
135
135
  </tbody>
136
136
  </table>
137
137
  <!-- AURO-GENERATED-CONTENT:END -->
@@ -268,10 +268,10 @@
268
268
  <auro-header level="3" id="localization">Localization</auro-header>
269
269
  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../docs/partials/customize/localization.md) -->
270
270
  <!-- The below content is automatically added from ./../docs/partials/customize/localization.md -->
271
- <p>The component supports complete localization, including visible strings, screen reader announcements, and locale-based date formatting.</p>
271
+ <p>The component supports localization of the date format, the calendar's month and weekday names, and most visible strings and screen reader announcements. A few strings don't currently have a slot or attribute, such as the calendar's Done button and the word "selected" in date selection announcements, so they're always in English.</p>
272
272
  <auro-header level="4" id="localizationTrigger">Trigger</auro-header>
273
273
  <auro-header level="5" id="localizationTriggerVisibleStrings">Visible strings</auro-header>
274
- <p>The visible strings rendered in the input, trigger, and fullscreen calendar aren't derived from <code>locale</code>. They're 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>
274
+ <p>The visible strings rendered in the input, trigger, and fullscreen calendar aren't derived from <code>locale</code>. Most of them 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>
275
275
  <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/localization-visible-strings.html) -->
276
276
  <!-- The below content is automatically added from ./../apiExamples/localization-visible-strings.html -->
277
277
  <pre class="language-diff"><code class="language-diff"> &lt;auro-datepicker&gt;
@@ -491,7 +491,7 @@
491
491
  navLabelNextMonth="Nächster Monat"
492
492
  calendarGridLabel="Kalendertage des Monats">
493
493
  <span slot="ariaLabel.bib.close">Kalender schließen</span>
494
- <span slot="fromLabel">Abreisedatum (geerbt aus `data-locale="de-DE"`)</span>
494
+ <span slot="fromLabel">Abreisedatum (geerbt aus <code>data-locale="de-DE"</code>)</span>
495
495
  <span slot="toLabel">Rückkehrdatum</span>
496
496
  <span slot="helpText">Hilfetext</span>
497
497
  <span slot="optionalFromLabel">(freiwillig)</span>
@@ -591,7 +591,7 @@
591
591
  navLabelNextMonth="Nächster Monat"
592
592
  calendarGridLabel="Kalendertage des Monats"&gt;
593
593
  &lt;span slot="ariaLabel.bib.close"&gt;Kalender schließen&lt;/span&gt;
594
- &lt;span slot="fromLabel"&gt;Abreisedatum (geerbt aus `data-locale="de-DE"`)&lt;/span&gt;
594
+ &lt;span slot="fromLabel"&gt;Abreisedatum (geerbt aus &lt;code&gt;data-locale="de-DE"&lt;/code&gt;)&lt;/span&gt;
595
595
  &lt;span slot="toLabel"&gt;Rückkehrdatum&lt;/span&gt;
596
596
  &lt;span slot="helpText"&gt;Hilfetext&lt;/span&gt;
597
597
  &lt;span slot="optionalFromLabel"&gt;(freiwillig)&lt;/span&gt;