@aurodesignsystem-dev/auro-formkit 0.0.0-pr1510.3 → 0.0.0-pr1511.0

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 (128) hide show
  1. package/components/checkbox/demo/customize.js +22 -0
  2. package/components/checkbox/demo/customize.min.js +1 -1
  3. package/components/checkbox/demo/demo-support.js +1 -0
  4. package/components/checkbox/demo/getting-started.js +22 -0
  5. package/components/checkbox/demo/getting-started.min.js +1 -1
  6. package/components/checkbox/demo/index.js +8 -0
  7. package/components/checkbox/demo/index.min.js +1 -1
  8. package/components/checkbox/demo/styles.scss +1 -0
  9. package/components/checkbox/dist/index.js +1 -1
  10. package/components/checkbox/dist/registered.js +1 -1
  11. package/components/combobox/demo/customize.js +24 -0
  12. package/components/combobox/demo/customize.min.js +4 -3
  13. package/components/combobox/demo/demo-support.js +1 -0
  14. package/components/combobox/demo/getting-started.js +21 -0
  15. package/components/combobox/demo/getting-started.min.js +4 -3
  16. package/components/combobox/demo/index.js +23 -0
  17. package/components/combobox/demo/index.min.js +4 -3
  18. package/components/combobox/demo/styles.scss +1 -0
  19. package/components/combobox/dist/index.js +4 -3
  20. package/components/combobox/dist/registered.js +4 -3
  21. package/components/counter/demo/customize.js +21 -0
  22. package/components/counter/demo/customize.min.js +3 -2
  23. package/components/counter/demo/demo-support.js +1 -0
  24. package/components/counter/demo/index.js +21 -0
  25. package/components/counter/demo/index.min.js +3 -2
  26. package/components/counter/demo/styles.scss +1 -0
  27. package/components/counter/dist/index.js +3 -2
  28. package/components/counter/dist/registered.js +3 -2
  29. package/components/datepicker/demo/accessibility.md +1 -2
  30. package/components/datepicker/demo/api.md +62 -63
  31. package/components/datepicker/demo/customize.js +17 -0
  32. package/components/datepicker/demo/customize.md +1 -12
  33. package/components/datepicker/demo/customize.min.js +200 -608
  34. package/components/datepicker/demo/demo-support.js +1 -0
  35. package/components/datepicker/demo/index.js +23 -0
  36. package/components/datepicker/demo/index.min.js +200 -608
  37. package/components/datepicker/demo/styles.scss +1 -0
  38. package/components/datepicker/dist/index.js +200 -608
  39. package/components/datepicker/dist/registered.js +200 -608
  40. package/components/datepicker/dist/{auro-calendar-cell.d.ts → src/auro-calendar-cell.d.ts} +3 -14
  41. package/components/datepicker/dist/{auro-calendar.d.ts → src/auro-calendar.d.ts} +6 -90
  42. package/components/datepicker/dist/{auro-datepicker.d.ts → src/auro-datepicker.d.ts} +5 -78
  43. package/components/dropdown/demo/customize.js +9 -0
  44. package/components/dropdown/demo/customize.min.js +2 -1
  45. package/components/dropdown/demo/demo-support.js +1 -0
  46. package/components/dropdown/demo/getting-started.js +9 -0
  47. package/components/dropdown/demo/getting-started.min.js +2 -1
  48. package/components/dropdown/demo/index.js +16 -0
  49. package/components/dropdown/demo/index.min.js +2 -1
  50. package/components/dropdown/demo/styles.scss +1 -0
  51. package/components/dropdown/dist/index.js +2 -1
  52. package/components/dropdown/dist/registered.js +2 -1
  53. package/components/form/demo/customize.js +28 -0
  54. package/components/form/demo/customize.min.js +348 -677
  55. package/components/form/demo/demo-support.js +1 -0
  56. package/components/form/demo/getting-started.js +9 -0
  57. package/components/form/demo/getting-started.min.js +348 -677
  58. package/components/form/demo/index.js +5 -0
  59. package/components/form/demo/index.min.js +348 -677
  60. package/components/form/demo/registerDemoDeps.js +23 -0
  61. package/components/form/demo/registerDemoDeps.min.js +348 -677
  62. package/components/form/demo/styles.scss +1 -0
  63. package/components/input/demo/customize.js +25 -0
  64. package/components/input/demo/customize.min.js +1 -1
  65. package/components/input/demo/demo-support.js +1 -0
  66. package/components/input/demo/getting-started.js +8 -0
  67. package/components/input/demo/getting-started.min.js +1 -1
  68. package/components/input/demo/index.js +8 -0
  69. package/components/input/demo/index.min.js +1 -1
  70. package/components/input/demo/styles.css +974 -0
  71. package/components/input/demo/styles.scss +1 -0
  72. package/components/input/dist/index.js +1 -1
  73. package/components/input/dist/registered.js +1 -1
  74. package/components/menu/demo/demo-support.js +1 -0
  75. package/components/menu/demo/index.js +25 -0
  76. package/components/menu/demo/styles.scss +1 -0
  77. package/components/radio/demo/customize.js +22 -0
  78. package/components/radio/demo/customize.min.js +1 -1
  79. package/components/radio/demo/demo-support.js +1 -0
  80. package/components/radio/demo/getting-started.js +24 -0
  81. package/components/radio/demo/getting-started.min.js +1 -1
  82. package/components/radio/demo/index.js +8 -0
  83. package/components/radio/demo/index.min.js +1 -1
  84. package/components/radio/demo/styles.scss +1 -0
  85. package/components/radio/dist/index.js +1 -1
  86. package/components/radio/dist/registered.js +1 -1
  87. package/components/select/demo/customize.js +11 -0
  88. package/components/select/demo/customize.min.js +132 -55
  89. package/components/select/demo/demo-support.js +1 -0
  90. package/components/select/demo/getting-started.js +26 -0
  91. package/components/select/demo/getting-started.min.js +132 -55
  92. package/components/select/demo/index.js +11 -0
  93. package/components/select/demo/index.min.js +132 -55
  94. package/components/select/demo/keyboard-behavior.md +18 -4
  95. package/components/select/demo/styles.scss +1 -0
  96. package/components/select/dist/auro-select.d.ts +20 -8
  97. package/components/select/dist/index.js +132 -55
  98. package/components/select/dist/registered.js +132 -55
  99. package/custom-elements.json +577 -863
  100. package/package.json +2 -6
  101. package/components/datepicker/dist/blackoutUtils.d.ts +0 -43
  102. /package/components/datepicker/dist/{auro-calendar-month.d.ts → src/auro-calendar-month.d.ts} +0 -0
  103. /package/components/datepicker/dist/{buttonVersion.d.ts → src/buttonVersion.d.ts} +0 -0
  104. /package/components/datepicker/dist/{datepickerKeyboardStrategy.d.ts → src/datepickerKeyboardStrategy.d.ts} +0 -0
  105. /package/components/datepicker/dist/{iconVersion.d.ts → src/iconVersion.d.ts} +0 -0
  106. /package/components/datepicker/dist/{index.d.ts → src/index.d.ts} +0 -0
  107. /package/components/datepicker/dist/{popoverVersion.d.ts → src/popoverVersion.d.ts} +0 -0
  108. /package/components/datepicker/dist/{styles → src/styles}/classic/color-css.d.ts +0 -0
  109. /package/components/datepicker/dist/{styles → src/styles}/classic/style-css.d.ts +0 -0
  110. /package/components/datepicker/dist/{styles → src/styles}/color-calendar-css.d.ts +0 -0
  111. /package/components/datepicker/dist/{styles → src/styles}/color-cell-css.d.ts +0 -0
  112. /package/components/datepicker/dist/{styles → src/styles}/color-css.d.ts +0 -0
  113. /package/components/datepicker/dist/{styles → src/styles}/color-month-css.d.ts +0 -0
  114. /package/components/datepicker/dist/{styles → src/styles}/shapeSize-css.d.ts +0 -0
  115. /package/components/datepicker/dist/{styles → src/styles}/snowflake/color-css.d.ts +0 -0
  116. /package/components/datepicker/dist/{styles → src/styles}/snowflake/style-css.d.ts +0 -0
  117. /package/components/datepicker/dist/{styles → src/styles}/style-auro-calendar-cell-css.d.ts +0 -0
  118. /package/components/datepicker/dist/{styles → src/styles}/style-auro-calendar-css.d.ts +0 -0
  119. /package/components/datepicker/dist/{styles → src/styles}/style-auro-calendar-month-css.d.ts +0 -0
  120. /package/components/datepicker/dist/{styles → src/styles}/style-css.d.ts +0 -0
  121. /package/components/datepicker/dist/{styles → src/styles}/tokens-css.d.ts +0 -0
  122. /package/components/datepicker/dist/{utilities.d.ts → src/utilities.d.ts} +0 -0
  123. /package/components/datepicker/dist/{utilitiesCalendar.d.ts → src/utilitiesCalendar.d.ts} +0 -0
  124. /package/components/datepicker/dist/{utilitiesCalendarRender.d.ts → src/utilitiesCalendarRender.d.ts} +0 -0
  125. /package/components/datepicker/dist/{vendor → src/vendor}/wc-range-datepicker/day.d.ts +0 -0
  126. /package/components/datepicker/dist/{vendor → src/vendor}/wc-range-datepicker/range-datepicker-calendar.d.ts +0 -0
  127. /package/components/datepicker/dist/{vendor → src/vendor}/wc-range-datepicker/range-datepicker-cell.d.ts +0 -0
  128. /package/components/datepicker/dist/{vendor → src/vendor}/wc-range-datepicker/range-datepicker.d.ts +0 -0
@@ -4,35 +4,35 @@
4
4
  "modules": [
5
5
  {
6
6
  "kind": "javascript-module",
7
- "path": "components/checkbox/src/auro-checkbox-group.js",
7
+ "path": "components/bibtemplate/src/auro-bibtemplate.js",
8
8
  "declarations": [
9
9
  {
10
10
  "kind": "class",
11
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
12
- "name": "AuroCheckboxGroup",
11
+ "description": "The `auro-bibtemplate` element provides users a template for creating modal dialog elements.",
12
+ "name": "AuroBibtemplate",
13
13
  "slots": [
14
14
  {
15
- "description": "Allows for the legend to be overridden.",
16
- "name": "legend"
15
+ "description": "The default slot for the main content.",
16
+ "name": "default"
17
17
  },
18
18
  {
19
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
20
- "name": "optionalLabel"
19
+ "description": "Slot for the header content.",
20
+ "name": "header"
21
21
  },
22
22
  {
23
- "description": "Allows for the helper text to be overridden.",
24
- "name": "helpText"
23
+ "description": "Slot for the subheader content.",
24
+ "name": "subheader"
25
25
  },
26
26
  {
27
- "description": "The default slot for the checkbox items.",
28
- "name": "default"
27
+ "description": "Slot for the footer content.",
28
+ "name": "footer"
29
+ },
30
+ {
31
+ "description": "Slot for the close button aria-label.",
32
+ "name": "ariaLabel.close"
29
33
  }
30
34
  ],
31
35
  "members": [
32
- {
33
- "kind": "method",
34
- "name": "_initializeDefaults"
35
- },
36
36
  {
37
37
  "kind": "method",
38
38
  "name": "register",
@@ -40,8 +40,8 @@
40
40
  "parameters": [
41
41
  {
42
42
  "name": "name",
43
- "default": "\"auro-checkbox-group\"",
44
- "description": "The name of the element that you want to register.",
43
+ "default": "\"auro-bibtemplate\"",
44
+ "description": "The name of element that you want to register to.",
45
45
  "optional": true,
46
46
  "type": {
47
47
  "text": "string"
@@ -52,25 +52,17 @@
52
52
  },
53
53
  {
54
54
  "kind": "method",
55
- "name": "handleValueUpdate",
55
+ "name": "preventBodyScroll",
56
56
  "parameters": [
57
57
  {
58
- "name": "value",
59
- "description": "The value of the checkbox.",
60
- "type": {
61
- "text": "String"
62
- }
63
- },
64
- {
65
- "name": "selected",
66
- "description": "The checked state of the checkbox.",
58
+ "name": "event",
59
+ "description": "The touchmove event.",
67
60
  "type": {
68
- "text": "Boolean"
61
+ "text": "Event"
69
62
  }
70
63
  }
71
64
  ],
72
- "description": "Helper method to handle checkbox value changing.",
73
- "privacy": "private",
65
+ "description": "Prevents scrolling of the body when touching empty areas of the component.",
74
66
  "return": {
75
67
  "type": {
76
68
  "text": "void"
@@ -79,9 +71,8 @@
79
71
  },
80
72
  {
81
73
  "kind": "method",
82
- "name": "handlePreselectedItems",
83
- "description": "Helper method that handles the state of preselected checkboxes.",
84
- "privacy": "private",
74
+ "name": "focusCloseButton",
75
+ "description": "Focuses the close button inside the bibtemplate's shadow DOM.\nUsed by parent components to set initial focus when the fullscreen dialog opens.",
85
76
  "return": {
86
77
  "type": {
87
78
  "text": "void"
@@ -90,308 +81,213 @@
90
81
  },
91
82
  {
92
83
  "kind": "method",
93
- "name": "handleItems",
94
- "description": "Helper method that handles the state of checkboxes.",
95
- "privacy": "private",
96
- "return": {
97
- "type": {
98
- "text": "void"
99
- }
100
- }
84
+ "name": "onCloseButtonClick"
101
85
  },
102
86
  {
103
87
  "kind": "method",
104
- "name": "reset",
105
- "description": "Resets component to initial state.",
88
+ "name": "exposeCssParts",
89
+ "description": "Exposes CSS parts for styling from parent components.",
106
90
  "return": {
107
91
  "type": {
108
92
  "text": "void"
109
93
  }
110
94
  }
111
95
  },
112
- {
113
- "kind": "method",
114
- "name": "validate",
115
- "parameters": [
116
- {
117
- "name": "force",
118
- "default": "false",
119
- "description": "Whether to force validation.",
120
- "optional": true,
121
- "type": {
122
- "text": "boolean"
123
- }
124
- }
125
- ],
126
- "description": "Validates value."
127
- },
128
- {
129
- "kind": "field",
130
- "name": "appearance",
131
- "privacy": "public",
132
- "type": {
133
- "text": "'default' | 'inverse'"
134
- },
135
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
136
- "default": "'default'",
137
- "attribute": "appearance",
138
- "reflects": true
139
- },
140
96
  {
141
97
  "kind": "field",
142
- "name": "disabled",
98
+ "name": "large",
143
99
  "privacy": "public",
144
100
  "type": {
145
101
  "text": "boolean"
146
102
  },
147
- "description": "If set, disables the checkbox group.",
148
- "attribute": "disabled",
103
+ "default": "false",
104
+ "attribute": "large",
149
105
  "reflects": true
150
106
  },
151
107
  {
152
108
  "kind": "field",
153
- "name": "error",
154
- "privacy": "public",
155
- "type": {
156
- "text": "string"
157
- },
158
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
159
- "attribute": "error",
160
- "reflects": true
109
+ "name": "iconTag",
110
+ "privacy": "private"
161
111
  },
162
112
  {
163
113
  "kind": "field",
164
- "name": "horizontal",
165
- "privacy": "public",
166
- "type": {
167
- "text": "boolean"
168
- },
169
- "description": "If set, checkboxes will be aligned horizontally.",
170
- "attribute": "horizontal",
171
- "reflects": true
114
+ "name": "headerTag",
115
+ "privacy": "private"
172
116
  },
173
117
  {
174
118
  "kind": "field",
175
- "name": "noValidate",
176
- "privacy": "public",
177
- "type": {
178
- "text": "boolean"
179
- },
180
- "description": "If set, disables auto-validation on blur.",
181
- "attribute": "noValidate",
182
- "reflects": true
119
+ "name": "buttonTag",
120
+ "privacy": "private"
183
121
  },
184
122
  {
185
123
  "kind": "field",
186
- "name": "onDark",
124
+ "name": "isFullscreen",
187
125
  "privacy": "public",
188
126
  "type": {
189
127
  "text": "boolean"
190
128
  },
191
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
192
- "attribute": "onDark",
129
+ "attribute": "isFullscreen",
193
130
  "reflects": true
194
131
  },
195
132
  {
196
133
  "kind": "field",
197
- "name": "required",
134
+ "name": "showFooter",
198
135
  "privacy": "public",
199
136
  "type": {
200
137
  "text": "boolean"
201
138
  },
202
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
203
- "attribute": "required",
204
- "reflects": true
205
- },
206
- {
207
- "kind": "field",
208
- "name": "setCustomValidity",
209
- "privacy": "public",
210
- "type": {
211
- "text": "string"
212
- },
213
- "description": "Sets a custom help text message to display for all validityStates.",
214
- "attribute": "setCustomValidity"
215
- },
216
- {
217
- "kind": "field",
218
- "name": "setCustomValidityCustomError",
219
- "privacy": "public",
220
- "type": {
221
- "text": "string"
222
- },
223
- "description": "Custom help text message to display when validity = `customError`.",
224
- "attribute": "setCustomValidityCustomError"
225
- },
226
- {
227
- "kind": "field",
228
- "name": "setCustomValidityValueMissing",
229
- "privacy": "public",
230
- "type": {
231
- "text": "string"
232
- },
233
- "description": "Custom help text message to display when validity = `valueMissing`.",
234
- "attribute": "setCustomValidityValueMissing"
235
- },
236
- {
237
- "kind": "field",
238
- "name": "validity",
239
- "privacy": "public",
240
- "type": {
241
- "text": "string"
242
- },
243
- "description": "Specifies the `validityState` this element is in.",
244
- "attribute": "validity",
139
+ "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
140
+ "attribute": "showFooter",
245
141
  "reflects": true
246
142
  }
247
143
  ],
248
144
  "events": [
249
145
  {
250
- "name": "input",
146
+ "name": "close-click",
251
147
  "type": {
252
- "text": "CustomEvent"
148
+ "text": "Event"
253
149
  }
254
150
  },
255
151
  {
256
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
257
- "name": "auroFormElement-validated"
152
+ "name": "auro-bibtemplate-connected",
153
+ "type": {
154
+ "text": "CustomEvent"
155
+ }
258
156
  }
259
157
  ],
260
158
  "attributes": [
261
159
  {
262
- "name": "appearance",
263
- "type": {
264
- "text": "'default' | 'inverse'"
265
- },
266
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
267
- "default": "'default'",
268
- "fieldName": "appearance"
269
- },
270
- {
271
- "name": "disabled",
272
- "type": {
273
- "text": "boolean"
274
- },
275
- "description": "If set, disables the checkbox group.",
276
- "fieldName": "disabled"
277
- },
278
- {
279
- "name": "error",
280
- "type": {
281
- "text": "string"
282
- },
283
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
284
- "fieldName": "error"
285
- },
286
- {
287
- "name": "horizontal",
288
- "type": {
289
- "text": "boolean"
290
- },
291
- "description": "If set, checkboxes will be aligned horizontally.",
292
- "fieldName": "horizontal"
293
- },
294
- {
295
- "name": "noValidate",
160
+ "name": "isFullscreen",
296
161
  "type": {
297
162
  "text": "boolean"
298
163
  },
299
- "description": "If set, disables auto-validation on blur.",
300
- "fieldName": "noValidate"
164
+ "fieldName": "isFullscreen"
301
165
  },
302
166
  {
303
- "name": "onDark",
167
+ "name": "large",
304
168
  "type": {
305
169
  "text": "boolean"
306
170
  },
307
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
308
- "fieldName": "onDark"
171
+ "default": "false",
172
+ "fieldName": "large"
309
173
  },
310
174
  {
311
- "name": "required",
175
+ "name": "showFooter",
312
176
  "type": {
313
177
  "text": "boolean"
314
178
  },
315
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
316
- "fieldName": "required"
317
- },
318
- {
319
- "name": "setCustomValidity",
320
- "type": {
321
- "text": "string"
322
- },
323
- "description": "Sets a custom help text message to display for all validityStates.",
324
- "fieldName": "setCustomValidity"
325
- },
326
- {
327
- "name": "setCustomValidityCustomError",
328
- "type": {
329
- "text": "string"
330
- },
331
- "description": "Custom help text message to display when validity = `customError`.",
332
- "fieldName": "setCustomValidityCustomError"
333
- },
334
- {
335
- "name": "setCustomValidityValueMissing",
336
- "type": {
337
- "text": "string"
338
- },
339
- "description": "Custom help text message to display when validity = `valueMissing`.",
340
- "fieldName": "setCustomValidityValueMissing"
341
- },
342
- {
343
- "name": "validity",
344
- "type": {
345
- "text": "string"
346
- },
347
- "description": "Specifies the `validityState` this element is in.",
348
- "fieldName": "validity"
179
+ "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
180
+ "fieldName": "showFooter"
349
181
  }
350
182
  ],
351
183
  "superclass": {
352
184
  "name": "LitElement",
353
185
  "package": "lit"
354
186
  },
355
- "tagName": "auro-checkbox-group",
187
+ "tagName": "auro-bibtemplate",
356
188
  "customElement": true
357
189
  }
358
190
  ],
359
191
  "exports": [
360
192
  {
361
193
  "kind": "js",
362
- "name": "AuroCheckboxGroup",
194
+ "name": "AuroBibtemplate",
363
195
  "declaration": {
364
- "name": "AuroCheckboxGroup",
365
- "module": "components/checkbox/src/auro-checkbox-group.js"
196
+ "name": "AuroBibtemplate",
197
+ "module": "components/bibtemplate/src/auro-bibtemplate.js"
366
198
  }
367
199
  }
368
200
  ]
369
201
  },
370
202
  {
371
203
  "kind": "javascript-module",
372
- "path": "components/checkbox/src/auro-checkbox.js",
204
+ "path": "components/bibtemplate/src/buttonVersion.js",
205
+ "declarations": [],
206
+ "exports": [
207
+ {
208
+ "kind": "js",
209
+ "name": "default",
210
+ "declaration": {
211
+ "name": "12.3.2",
212
+ "module": "components/bibtemplate/src/buttonVersion.js"
213
+ }
214
+ }
215
+ ]
216
+ },
217
+ {
218
+ "kind": "javascript-module",
219
+ "path": "components/bibtemplate/src/headerVersion.js",
220
+ "declarations": [],
221
+ "exports": [
222
+ {
223
+ "kind": "js",
224
+ "name": "default",
225
+ "declaration": {
226
+ "name": "5.0.1",
227
+ "module": "components/bibtemplate/src/headerVersion.js"
228
+ }
229
+ }
230
+ ]
231
+ },
232
+ {
233
+ "kind": "javascript-module",
234
+ "path": "components/bibtemplate/src/iconVersion.js",
235
+ "declarations": [],
236
+ "exports": [
237
+ {
238
+ "kind": "js",
239
+ "name": "default",
240
+ "declaration": {
241
+ "name": "9.2.0",
242
+ "module": "components/bibtemplate/src/iconVersion.js"
243
+ }
244
+ }
245
+ ]
246
+ },
247
+ {
248
+ "kind": "javascript-module",
249
+ "path": "components/bibtemplate/src/index.js",
250
+ "declarations": [],
251
+ "exports": [
252
+ {
253
+ "kind": "js",
254
+ "name": "AuroBibtemplate",
255
+ "declaration": {
256
+ "name": "AuroBibtemplate",
257
+ "module": "components/bibtemplate/src/index.js"
258
+ }
259
+ }
260
+ ]
261
+ },
262
+ {
263
+ "kind": "javascript-module",
264
+ "path": "components/bibtemplate/src/registered.js",
265
+ "declarations": [],
266
+ "exports": []
267
+ },
268
+ {
269
+ "kind": "javascript-module",
270
+ "path": "components/checkbox/src/auro-checkbox-group.js",
373
271
  "declarations": [
374
272
  {
375
273
  "kind": "class",
376
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
377
- "name": "AuroCheckbox",
378
- "cssParts": [
274
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
275
+ "name": "AuroCheckboxGroup",
276
+ "slots": [
379
277
  {
380
- "description": "apply css to a specific checkbox.",
381
- "name": "checkbox"
278
+ "description": "Allows for the legend to be overridden.",
279
+ "name": "legend"
382
280
  },
383
281
  {
384
- "description": "apply css to a specific checkbox's input.",
385
- "name": "checkbox-input"
282
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
283
+ "name": "optionalLabel"
386
284
  },
387
285
  {
388
- "description": "apply css to a specific checkbox's label.",
389
- "name": "checkbox-label"
390
- }
391
- ],
392
- "slots": [
286
+ "description": "Allows for the helper text to be overridden.",
287
+ "name": "helpText"
288
+ },
393
289
  {
394
- "description": "The default slot for the checkbox label.",
290
+ "description": "The default slot for the checkbox items.",
395
291
  "name": "default"
396
292
  }
397
293
  ],
@@ -407,8 +303,8 @@
407
303
  "parameters": [
408
304
  {
409
305
  "name": "name",
410
- "default": "\"auro-checkbox\"",
411
- "description": "The name of element that you want to register to.",
306
+ "default": "\"auro-checkbox-group\"",
307
+ "description": "The name of the element that you want to register.",
412
308
  "optional": true,
413
309
  "type": {
414
310
  "text": "string"
@@ -419,37 +315,24 @@
419
315
  },
420
316
  {
421
317
  "kind": "method",
422
- "name": "handleChange",
318
+ "name": "handleValueUpdate",
423
319
  "parameters": [
424
320
  {
425
- "name": "event",
426
- "description": "The change event from the checkbox input.",
321
+ "name": "value",
322
+ "description": "The value of the checkbox.",
427
323
  "type": {
428
- "text": "Event"
324
+ "text": "String"
429
325
  }
430
- }
431
- ],
432
- "description": "Handles the change event for the checkbox input.\nUpdates the checked state and dispatches a corresponding custom event.\nThis custom event is only for the purpose of supporting IE.",
433
- "privacy": "private",
434
- "return": {
435
- "type": {
436
- "text": "void"
437
- }
438
- }
439
- },
440
- {
441
- "kind": "method",
442
- "name": "handleInput",
443
- "parameters": [
326
+ },
444
327
  {
445
- "name": "event",
446
- "description": "The input event from the checkbox input.",
328
+ "name": "selected",
329
+ "description": "The checked state of the checkbox.",
447
330
  "type": {
448
- "text": "Event"
331
+ "text": "Boolean"
449
332
  }
450
333
  }
451
334
  ],
452
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
335
+ "description": "Helper method to handle checkbox value changing.",
453
336
  "privacy": "private",
454
337
  "return": {
455
338
  "type": {
@@ -459,8 +342,8 @@
459
342
  },
460
343
  {
461
344
  "kind": "method",
462
- "name": "handleFocusin",
463
- "description": "Function to support",
345
+ "name": "handlePreselectedItems",
346
+ "description": "Helper method that handles the state of preselected checkboxes.",
464
347
  "privacy": "private",
465
348
  "return": {
466
349
  "type": {
@@ -470,12 +353,12 @@
470
353
  },
471
354
  {
472
355
  "kind": "method",
473
- "name": "generateIconHtml",
474
- "description": "Function to generate checkmark svg.",
356
+ "name": "handleItems",
357
+ "description": "Helper method that handles the state of checkboxes.",
475
358
  "privacy": "private",
476
359
  "return": {
477
360
  "type": {
478
- "text": "HTMLElement"
361
+ "text": "void"
479
362
  }
480
363
  }
481
364
  },
@@ -491,34 +374,19 @@
491
374
  },
492
375
  {
493
376
  "kind": "method",
494
- "name": "updateAriaLabel",
495
- "description": "Updates the aria-label based on slot content.",
496
- "privacy": "private",
497
- "return": {
498
- "type": {
499
- "text": "void"
500
- }
501
- }
502
- },
503
- {
504
- "kind": "method",
505
- "name": "handleKeyDown",
377
+ "name": "validate",
506
378
  "parameters": [
507
379
  {
508
- "name": "event",
509
- "description": "The keydown event from the checkbox input.",
380
+ "name": "force",
381
+ "default": "false",
382
+ "description": "Whether to force validation.",
383
+ "optional": true,
510
384
  "type": {
511
- "text": "KeyboardEvent"
385
+ "text": "boolean"
512
386
  }
513
387
  }
514
388
  ],
515
- "description": "Handles keydown event to toggle the checkbox with Space key.",
516
- "privacy": "private",
517
- "return": {
518
- "type": {
519
- "text": "void"
520
- }
521
- }
389
+ "description": "Validates value."
522
390
  },
523
391
  {
524
392
  "kind": "field",
@@ -532,17 +400,6 @@
532
400
  "attribute": "appearance",
533
401
  "reflects": true
534
402
  },
535
- {
536
- "kind": "field",
537
- "name": "checked",
538
- "privacy": "public",
539
- "type": {
540
- "text": "boolean"
541
- },
542
- "description": "If set to true, the checkbox will be filled with a checkmark.",
543
- "attribute": "checked",
544
- "reflects": true
545
- },
546
403
  {
547
404
  "kind": "field",
548
405
  "name": "disabled",
@@ -550,7 +407,7 @@
550
407
  "type": {
551
408
  "text": "boolean"
552
409
  },
553
- "description": "If set to true, the checkbox will not be clickable.",
410
+ "description": "If set, disables the checkbox group.",
554
411
  "attribute": "disabled",
555
412
  "reflects": true
556
413
  },
@@ -559,41 +416,33 @@
559
416
  "name": "error",
560
417
  "privacy": "public",
561
418
  "type": {
562
- "text": "boolean"
419
+ "text": "string"
563
420
  },
564
- "description": "If set to true, the checkbox will be displayed with an error state.",
421
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
565
422
  "attribute": "error",
566
423
  "reflects": true
567
424
  },
568
425
  {
569
426
  "kind": "field",
570
- "name": "id",
427
+ "name": "horizontal",
571
428
  "privacy": "public",
572
429
  "type": {
573
- "text": "string"
430
+ "text": "boolean"
574
431
  },
575
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
576
- "attribute": "id",
432
+ "description": "If set, checkboxes will be aligned horizontally.",
433
+ "attribute": "horizontal",
577
434
  "reflects": true
578
435
  },
579
436
  {
580
437
  "kind": "field",
581
- "name": "inputId",
582
- "privacy": "private",
583
- "type": {
584
- "text": "string"
585
- },
586
- "description": "The id for input node."
587
- },
588
- {
589
- "kind": "field",
590
- "name": "name",
438
+ "name": "noValidate",
591
439
  "privacy": "public",
592
440
  "type": {
593
- "text": "string"
441
+ "text": "boolean"
594
442
  },
595
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
596
- "attribute": "name"
443
+ "description": "If set, disables auto-validation on blur.",
444
+ "attribute": "noValidate",
445
+ "reflects": true
597
446
  },
598
447
  {
599
448
  "kind": "field",
@@ -608,94 +457,67 @@
608
457
  },
609
458
  {
610
459
  "kind": "field",
611
- "name": "touched",
612
- "privacy": "private",
460
+ "name": "required",
461
+ "privacy": "public",
613
462
  "type": {
614
463
  "text": "boolean"
615
464
  },
616
- "description": "Indicates whether the checkbox has been interacted with."
465
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
466
+ "attribute": "required",
467
+ "reflects": true
617
468
  },
618
469
  {
619
470
  "kind": "field",
620
- "name": "value",
471
+ "name": "setCustomValidity",
621
472
  "privacy": "public",
622
473
  "type": {
623
474
  "text": "string"
624
475
  },
625
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
626
- "attribute": "value"
476
+ "description": "Sets a custom help text message to display for all validityStates.",
477
+ "attribute": "setCustomValidity"
627
478
  },
628
479
  {
629
480
  "kind": "field",
630
- "name": "tabIndex",
631
- "privacy": "private",
632
- "type": {
633
- "text": "number"
634
- },
635
- "description": "The tabindex attribute for the checkbox.",
636
- "attribute": "tabindex",
637
- "reflects": true
638
- },
639
- {
640
- "kind": "field",
641
- "name": "ariaChecked",
642
- "privacy": "private",
481
+ "name": "setCustomValidityCustomError",
482
+ "privacy": "public",
643
483
  "type": {
644
484
  "text": "string"
645
485
  },
646
- "description": "The aria-checked attribute for the checkbox.",
647
- "attribute": "aria-checked",
648
- "reflects": true
486
+ "description": "Custom help text message to display when validity = `customError`.",
487
+ "attribute": "setCustomValidityCustomError"
649
488
  },
650
489
  {
651
490
  "kind": "field",
652
- "name": "ariaDisabled",
653
- "privacy": "private",
491
+ "name": "setCustomValidityValueMissing",
492
+ "privacy": "public",
654
493
  "type": {
655
494
  "text": "string"
656
495
  },
657
- "description": "The aria-disabled attribute for the checkbox.",
658
- "attribute": "aria-disabled",
659
- "reflects": true
496
+ "description": "Custom help text message to display when validity = `valueMissing`.",
497
+ "attribute": "setCustomValidityValueMissing"
660
498
  },
661
499
  {
662
500
  "kind": "field",
663
- "name": "role",
664
- "privacy": "private",
501
+ "name": "validity",
502
+ "privacy": "public",
665
503
  "type": {
666
504
  "text": "string"
667
505
  },
668
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
669
- "attribute": "role",
506
+ "description": "Specifies the `validityState` this element is in.",
507
+ "attribute": "validity",
670
508
  "reflects": true
671
509
  }
672
510
  ],
673
511
  "events": [
674
512
  {
675
- "name": "auroCheckbox-input",
676
- "type": {
677
- "text": "CustomEvent"
678
- }
679
- },
680
- {
681
- "name": "auroCheckbox-focusin",
682
- "type": {
683
- "text": "CustomEvent"
684
- }
685
- },
686
- {
687
- "name": "auroCheckbox-focusout",
513
+ "name": "input",
688
514
  "type": {
689
515
  "text": "CustomEvent"
690
516
  }
691
517
  },
692
518
  {
693
- "description": "(Deprecated) Notifies when checked value is changed.",
694
- "name": "change"
695
- },
696
- {
697
- "description": "Notifies when when checked value is changed by user's interface.",
698
- "name": "input"
519
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
520
+ "name": "auroFormElement-validated"
699
521
  }
700
522
  ],
701
523
  "attributes": [
@@ -708,45 +530,37 @@
708
530
  "default": "'default'",
709
531
  "fieldName": "appearance"
710
532
  },
711
- {
712
- "name": "checked",
713
- "type": {
714
- "text": "boolean"
715
- },
716
- "description": "If set to true, the checkbox will be filled with a checkmark.",
717
- "fieldName": "checked"
718
- },
719
533
  {
720
534
  "name": "disabled",
721
535
  "type": {
722
536
  "text": "boolean"
723
537
  },
724
- "description": "If set to true, the checkbox will not be clickable.",
538
+ "description": "If set, disables the checkbox group.",
725
539
  "fieldName": "disabled"
726
540
  },
727
541
  {
728
542
  "name": "error",
729
543
  "type": {
730
- "text": "boolean"
544
+ "text": "string"
731
545
  },
732
- "description": "If set to true, the checkbox will be displayed with an error state.",
546
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
733
547
  "fieldName": "error"
734
548
  },
735
549
  {
736
- "name": "id",
550
+ "name": "horizontal",
737
551
  "type": {
738
- "text": "string"
552
+ "text": "boolean"
739
553
  },
740
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
741
- "fieldName": "id"
554
+ "description": "If set, checkboxes will be aligned horizontally.",
555
+ "fieldName": "horizontal"
742
556
  },
743
557
  {
744
- "name": "name",
558
+ "name": "noValidate",
745
559
  "type": {
746
- "text": "string"
560
+ "text": "boolean"
747
561
  },
748
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
749
- "fieldName": "name"
562
+ "description": "If set, disables auto-validation on blur.",
563
+ "fieldName": "noValidate"
750
564
  },
751
565
  {
752
566
  "name": "onDark",
@@ -757,125 +571,98 @@
757
571
  "fieldName": "onDark"
758
572
  },
759
573
  {
760
- "name": "value",
574
+ "name": "required",
761
575
  "type": {
762
- "text": "string"
576
+ "text": "boolean"
763
577
  },
764
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
765
- "fieldName": "value"
578
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
579
+ "fieldName": "required"
766
580
  },
767
581
  {
768
- "name": "tabindex",
582
+ "name": "setCustomValidity",
769
583
  "type": {
770
- "text": "number"
584
+ "text": "string"
771
585
  },
772
- "description": "The tabindex attribute for the checkbox.",
773
- "fieldName": "tabIndex"
586
+ "description": "Sets a custom help text message to display for all validityStates.",
587
+ "fieldName": "setCustomValidity"
774
588
  },
775
589
  {
776
- "name": "aria-checked",
590
+ "name": "setCustomValidityCustomError",
777
591
  "type": {
778
592
  "text": "string"
779
593
  },
780
- "description": "The aria-checked attribute for the checkbox.",
781
- "fieldName": "ariaChecked"
594
+ "description": "Custom help text message to display when validity = `customError`.",
595
+ "fieldName": "setCustomValidityCustomError"
782
596
  },
783
597
  {
784
- "name": "aria-disabled",
598
+ "name": "setCustomValidityValueMissing",
785
599
  "type": {
786
600
  "text": "string"
787
601
  },
788
- "description": "The aria-disabled attribute for the checkbox.",
789
- "fieldName": "ariaDisabled"
602
+ "description": "Custom help text message to display when validity = `valueMissing`.",
603
+ "fieldName": "setCustomValidityValueMissing"
790
604
  },
791
605
  {
792
- "name": "role",
606
+ "name": "validity",
793
607
  "type": {
794
608
  "text": "string"
795
609
  },
796
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
797
- "fieldName": "role"
610
+ "description": "Specifies the `validityState` this element is in.",
611
+ "fieldName": "validity"
798
612
  }
799
613
  ],
800
614
  "superclass": {
801
615
  "name": "LitElement",
802
616
  "package": "lit"
803
617
  },
804
- "tagName": "auro-checkbox",
618
+ "tagName": "auro-checkbox-group",
805
619
  "customElement": true
806
620
  }
807
621
  ],
808
622
  "exports": [
809
- {
810
- "kind": "js",
811
- "name": "AuroCheckbox",
812
- "declaration": {
813
- "name": "AuroCheckbox",
814
- "module": "components/checkbox/src/auro-checkbox.js"
815
- }
816
- }
817
- ]
818
- },
819
- {
820
- "kind": "javascript-module",
821
- "path": "components/checkbox/src/index.js",
822
- "declarations": [],
823
- "exports": [
824
- {
825
- "kind": "js",
826
- "name": "AuroCheckbox",
827
- "declaration": {
828
- "name": "AuroCheckbox",
829
- "module": "components/checkbox/src/index.js"
830
- }
831
- },
832
623
  {
833
624
  "kind": "js",
834
625
  "name": "AuroCheckboxGroup",
835
626
  "declaration": {
836
627
  "name": "AuroCheckboxGroup",
837
- "module": "components/checkbox/src/index.js"
628
+ "module": "components/checkbox/src/auro-checkbox-group.js"
838
629
  }
839
630
  }
840
631
  ]
841
632
  },
842
633
  {
843
634
  "kind": "javascript-module",
844
- "path": "components/checkbox/src/registered.js",
845
- "declarations": [],
846
- "exports": []
847
- },
848
- {
849
- "kind": "javascript-module",
850
- "path": "components/bibtemplate/src/auro-bibtemplate.js",
635
+ "path": "components/checkbox/src/auro-checkbox.js",
851
636
  "declarations": [
852
637
  {
853
638
  "kind": "class",
854
- "description": "The `auro-bibtemplate` element provides users a template for creating modal dialog elements.",
855
- "name": "AuroBibtemplate",
856
- "slots": [
857
- {
858
- "description": "The default slot for the main content.",
859
- "name": "default"
860
- },
639
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
640
+ "name": "AuroCheckbox",
641
+ "cssParts": [
861
642
  {
862
- "description": "Slot for the header content.",
863
- "name": "header"
643
+ "description": "apply css to a specific checkbox.",
644
+ "name": "checkbox"
864
645
  },
865
646
  {
866
- "description": "Slot for the subheader content.",
867
- "name": "subheader"
647
+ "description": "apply css to a specific checkbox's input.",
648
+ "name": "checkbox-input"
868
649
  },
869
650
  {
870
- "description": "Slot for the footer content.",
871
- "name": "footer"
872
- },
651
+ "description": "apply css to a specific checkbox's label.",
652
+ "name": "checkbox-label"
653
+ }
654
+ ],
655
+ "slots": [
873
656
  {
874
- "description": "Slot for the close button aria-label.",
875
- "name": "ariaLabel.close"
657
+ "description": "The default slot for the checkbox label.",
658
+ "name": "default"
876
659
  }
877
660
  ],
878
661
  "members": [
662
+ {
663
+ "kind": "method",
664
+ "name": "_initializeDefaults"
665
+ },
879
666
  {
880
667
  "kind": "method",
881
668
  "name": "register",
@@ -883,7 +670,7 @@
883
670
  "parameters": [
884
671
  {
885
672
  "name": "name",
886
- "default": "\"auro-bibtemplate\"",
673
+ "default": "\"auro-checkbox\"",
887
674
  "description": "The name of element that you want to register to.",
888
675
  "optional": true,
889
676
  "type": {
@@ -895,17 +682,18 @@
895
682
  },
896
683
  {
897
684
  "kind": "method",
898
- "name": "preventBodyScroll",
685
+ "name": "handleChange",
899
686
  "parameters": [
900
687
  {
901
688
  "name": "event",
902
- "description": "The touchmove event.",
689
+ "description": "The change event from the checkbox input.",
903
690
  "type": {
904
691
  "text": "Event"
905
692
  }
906
693
  }
907
694
  ],
908
- "description": "Prevents scrolling of the body when touching empty areas of the component.",
695
+ "description": "Handles the change event for the checkbox input.\nUpdates the checked state and dispatches a corresponding custom event.\nThis custom event is only for the purpose of supporting IE.",
696
+ "privacy": "private",
909
697
  "return": {
910
698
  "type": {
911
699
  "text": "void"
@@ -914,8 +702,18 @@
914
702
  },
915
703
  {
916
704
  "kind": "method",
917
- "name": "focusCloseButton",
918
- "description": "Focuses the close button inside the bibtemplate's shadow DOM.\nUsed by parent components to set initial focus when the fullscreen dialog opens.",
705
+ "name": "handleInput",
706
+ "parameters": [
707
+ {
708
+ "name": "event",
709
+ "description": "The input event from the checkbox input.",
710
+ "type": {
711
+ "text": "Event"
712
+ }
713
+ }
714
+ ],
715
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
716
+ "privacy": "private",
919
717
  "return": {
920
718
  "type": {
921
719
  "text": "void"
@@ -924,12 +722,30 @@
924
722
  },
925
723
  {
926
724
  "kind": "method",
927
- "name": "onCloseButtonClick"
725
+ "name": "handleFocusin",
726
+ "description": "Function to support",
727
+ "privacy": "private",
728
+ "return": {
729
+ "type": {
730
+ "text": "void"
731
+ }
732
+ }
928
733
  },
929
734
  {
930
735
  "kind": "method",
931
- "name": "exposeCssParts",
932
- "description": "Exposes CSS parts for styling from parent components.",
736
+ "name": "generateIconHtml",
737
+ "description": "Function to generate checkmark svg.",
738
+ "privacy": "private",
739
+ "return": {
740
+ "type": {
741
+ "text": "HTMLElement"
742
+ }
743
+ }
744
+ },
745
+ {
746
+ "kind": "method",
747
+ "name": "reset",
748
+ "description": "Resets component to initial state.",
933
749
  "return": {
934
750
  "type": {
935
751
  "text": "void"
@@ -937,174 +753,358 @@
937
753
  }
938
754
  },
939
755
  {
940
- "kind": "field",
941
- "name": "large",
942
- "privacy": "public",
943
- "type": {
944
- "text": "boolean"
945
- },
946
- "default": "false",
947
- "attribute": "large",
948
- "reflects": true
756
+ "kind": "method",
757
+ "name": "updateAriaLabel",
758
+ "description": "Updates the aria-label based on slot content.",
759
+ "privacy": "private",
760
+ "return": {
761
+ "type": {
762
+ "text": "void"
763
+ }
764
+ }
949
765
  },
950
766
  {
951
- "kind": "field",
952
- "name": "iconTag",
953
- "privacy": "private"
767
+ "kind": "method",
768
+ "name": "handleKeyDown",
769
+ "parameters": [
770
+ {
771
+ "name": "event",
772
+ "description": "The keydown event from the checkbox input.",
773
+ "type": {
774
+ "text": "KeyboardEvent"
775
+ }
776
+ }
777
+ ],
778
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
779
+ "privacy": "private",
780
+ "return": {
781
+ "type": {
782
+ "text": "void"
783
+ }
784
+ }
954
785
  },
955
786
  {
956
787
  "kind": "field",
957
- "name": "headerTag",
958
- "privacy": "private"
788
+ "name": "appearance",
789
+ "privacy": "public",
790
+ "type": {
791
+ "text": "'default' | 'inverse'"
792
+ },
793
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
794
+ "default": "'default'",
795
+ "attribute": "appearance",
796
+ "reflects": true
959
797
  },
960
798
  {
961
799
  "kind": "field",
962
- "name": "buttonTag",
963
- "privacy": "private"
800
+ "name": "checked",
801
+ "privacy": "public",
802
+ "type": {
803
+ "text": "boolean"
804
+ },
805
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
806
+ "attribute": "checked",
807
+ "reflects": true
964
808
  },
965
809
  {
966
810
  "kind": "field",
967
- "name": "isFullscreen",
811
+ "name": "disabled",
968
812
  "privacy": "public",
969
813
  "type": {
970
814
  "text": "boolean"
971
815
  },
972
- "attribute": "isFullscreen",
816
+ "description": "If set to true, the checkbox will not be clickable.",
817
+ "attribute": "disabled",
973
818
  "reflects": true
974
819
  },
975
820
  {
976
821
  "kind": "field",
977
- "name": "showFooter",
822
+ "name": "error",
978
823
  "privacy": "public",
979
824
  "type": {
980
825
  "text": "boolean"
981
826
  },
982
- "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
983
- "attribute": "showFooter",
827
+ "description": "If set to true, the checkbox will be displayed with an error state.",
828
+ "attribute": "error",
829
+ "reflects": true
830
+ },
831
+ {
832
+ "kind": "field",
833
+ "name": "id",
834
+ "privacy": "public",
835
+ "type": {
836
+ "text": "string"
837
+ },
838
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
839
+ "attribute": "id",
840
+ "reflects": true
841
+ },
842
+ {
843
+ "kind": "field",
844
+ "name": "inputId",
845
+ "privacy": "private",
846
+ "type": {
847
+ "text": "string"
848
+ },
849
+ "description": "The id for input node."
850
+ },
851
+ {
852
+ "kind": "field",
853
+ "name": "name",
854
+ "privacy": "public",
855
+ "type": {
856
+ "text": "string"
857
+ },
858
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
859
+ "attribute": "name"
860
+ },
861
+ {
862
+ "kind": "field",
863
+ "name": "onDark",
864
+ "privacy": "public",
865
+ "type": {
866
+ "text": "boolean"
867
+ },
868
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
869
+ "attribute": "onDark",
870
+ "reflects": true
871
+ },
872
+ {
873
+ "kind": "field",
874
+ "name": "touched",
875
+ "privacy": "private",
876
+ "type": {
877
+ "text": "boolean"
878
+ },
879
+ "description": "Indicates whether the checkbox has been interacted with."
880
+ },
881
+ {
882
+ "kind": "field",
883
+ "name": "value",
884
+ "privacy": "public",
885
+ "type": {
886
+ "text": "string"
887
+ },
888
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
889
+ "attribute": "value"
890
+ },
891
+ {
892
+ "kind": "field",
893
+ "name": "tabIndex",
894
+ "privacy": "private",
895
+ "type": {
896
+ "text": "number"
897
+ },
898
+ "description": "The tabindex attribute for the checkbox.",
899
+ "attribute": "tabindex",
900
+ "reflects": true
901
+ },
902
+ {
903
+ "kind": "field",
904
+ "name": "ariaChecked",
905
+ "privacy": "private",
906
+ "type": {
907
+ "text": "string"
908
+ },
909
+ "description": "The aria-checked attribute for the checkbox.",
910
+ "attribute": "aria-checked",
911
+ "reflects": true
912
+ },
913
+ {
914
+ "kind": "field",
915
+ "name": "ariaDisabled",
916
+ "privacy": "private",
917
+ "type": {
918
+ "text": "string"
919
+ },
920
+ "description": "The aria-disabled attribute for the checkbox.",
921
+ "attribute": "aria-disabled",
922
+ "reflects": true
923
+ },
924
+ {
925
+ "kind": "field",
926
+ "name": "role",
927
+ "privacy": "private",
928
+ "type": {
929
+ "text": "string"
930
+ },
931
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
932
+ "attribute": "role",
984
933
  "reflects": true
985
934
  }
986
935
  ],
987
936
  "events": [
988
937
  {
989
- "name": "close-click",
938
+ "name": "auroCheckbox-input",
990
939
  "type": {
991
- "text": "Event"
940
+ "text": "CustomEvent"
992
941
  }
993
942
  },
994
943
  {
995
- "name": "auro-bibtemplate-connected",
944
+ "name": "auroCheckbox-focusin",
945
+ "type": {
946
+ "text": "CustomEvent"
947
+ }
948
+ },
949
+ {
950
+ "name": "auroCheckbox-focusout",
996
951
  "type": {
997
952
  "text": "CustomEvent"
998
953
  }
954
+ },
955
+ {
956
+ "description": "(Deprecated) Notifies when checked value is changed.",
957
+ "name": "change"
958
+ },
959
+ {
960
+ "description": "Notifies when when checked value is changed by user's interface.",
961
+ "name": "input"
999
962
  }
1000
963
  ],
1001
964
  "attributes": [
1002
965
  {
1003
- "name": "isFullscreen",
966
+ "name": "appearance",
967
+ "type": {
968
+ "text": "'default' | 'inverse'"
969
+ },
970
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
971
+ "default": "'default'",
972
+ "fieldName": "appearance"
973
+ },
974
+ {
975
+ "name": "checked",
1004
976
  "type": {
1005
977
  "text": "boolean"
1006
978
  },
1007
- "fieldName": "isFullscreen"
979
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
980
+ "fieldName": "checked"
1008
981
  },
1009
982
  {
1010
- "name": "large",
983
+ "name": "disabled",
1011
984
  "type": {
1012
985
  "text": "boolean"
1013
986
  },
1014
- "default": "false",
1015
- "fieldName": "large"
987
+ "description": "If set to true, the checkbox will not be clickable.",
988
+ "fieldName": "disabled"
1016
989
  },
1017
990
  {
1018
- "name": "showFooter",
991
+ "name": "error",
1019
992
  "type": {
1020
993
  "text": "boolean"
1021
994
  },
1022
- "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
1023
- "fieldName": "showFooter"
995
+ "description": "If set to true, the checkbox will be displayed with an error state.",
996
+ "fieldName": "error"
997
+ },
998
+ {
999
+ "name": "id",
1000
+ "type": {
1001
+ "text": "string"
1002
+ },
1003
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
1004
+ "fieldName": "id"
1005
+ },
1006
+ {
1007
+ "name": "name",
1008
+ "type": {
1009
+ "text": "string"
1010
+ },
1011
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
1012
+ "fieldName": "name"
1013
+ },
1014
+ {
1015
+ "name": "onDark",
1016
+ "type": {
1017
+ "text": "boolean"
1018
+ },
1019
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1020
+ "fieldName": "onDark"
1021
+ },
1022
+ {
1023
+ "name": "value",
1024
+ "type": {
1025
+ "text": "string"
1026
+ },
1027
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1028
+ "fieldName": "value"
1029
+ },
1030
+ {
1031
+ "name": "tabindex",
1032
+ "type": {
1033
+ "text": "number"
1034
+ },
1035
+ "description": "The tabindex attribute for the checkbox.",
1036
+ "fieldName": "tabIndex"
1037
+ },
1038
+ {
1039
+ "name": "aria-checked",
1040
+ "type": {
1041
+ "text": "string"
1042
+ },
1043
+ "description": "The aria-checked attribute for the checkbox.",
1044
+ "fieldName": "ariaChecked"
1045
+ },
1046
+ {
1047
+ "name": "aria-disabled",
1048
+ "type": {
1049
+ "text": "string"
1050
+ },
1051
+ "description": "The aria-disabled attribute for the checkbox.",
1052
+ "fieldName": "ariaDisabled"
1053
+ },
1054
+ {
1055
+ "name": "role",
1056
+ "type": {
1057
+ "text": "string"
1058
+ },
1059
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
1060
+ "fieldName": "role"
1024
1061
  }
1025
1062
  ],
1026
1063
  "superclass": {
1027
1064
  "name": "LitElement",
1028
1065
  "package": "lit"
1029
1066
  },
1030
- "tagName": "auro-bibtemplate",
1067
+ "tagName": "auro-checkbox",
1031
1068
  "customElement": true
1032
1069
  }
1033
1070
  ],
1034
1071
  "exports": [
1035
1072
  {
1036
1073
  "kind": "js",
1037
- "name": "AuroBibtemplate",
1038
- "declaration": {
1039
- "name": "AuroBibtemplate",
1040
- "module": "components/bibtemplate/src/auro-bibtemplate.js"
1041
- }
1042
- }
1043
- ]
1044
- },
1045
- {
1046
- "kind": "javascript-module",
1047
- "path": "components/bibtemplate/src/buttonVersion.js",
1048
- "declarations": [],
1049
- "exports": [
1050
- {
1051
- "kind": "js",
1052
- "name": "default",
1053
- "declaration": {
1054
- "name": "12.3.2",
1055
- "module": "components/bibtemplate/src/buttonVersion.js"
1056
- }
1057
- }
1058
- ]
1059
- },
1060
- {
1061
- "kind": "javascript-module",
1062
- "path": "components/bibtemplate/src/headerVersion.js",
1063
- "declarations": [],
1064
- "exports": [
1065
- {
1066
- "kind": "js",
1067
- "name": "default",
1068
- "declaration": {
1069
- "name": "5.0.1",
1070
- "module": "components/bibtemplate/src/headerVersion.js"
1071
- }
1072
- }
1073
- ]
1074
- },
1075
- {
1076
- "kind": "javascript-module",
1077
- "path": "components/bibtemplate/src/iconVersion.js",
1078
- "declarations": [],
1079
- "exports": [
1080
- {
1081
- "kind": "js",
1082
- "name": "default",
1074
+ "name": "AuroCheckbox",
1083
1075
  "declaration": {
1084
- "name": "9.2.0",
1085
- "module": "components/bibtemplate/src/iconVersion.js"
1076
+ "name": "AuroCheckbox",
1077
+ "module": "components/checkbox/src/auro-checkbox.js"
1086
1078
  }
1087
1079
  }
1088
1080
  ]
1089
1081
  },
1090
1082
  {
1091
1083
  "kind": "javascript-module",
1092
- "path": "components/bibtemplate/src/index.js",
1084
+ "path": "components/checkbox/src/index.js",
1093
1085
  "declarations": [],
1094
1086
  "exports": [
1095
1087
  {
1096
1088
  "kind": "js",
1097
- "name": "AuroBibtemplate",
1089
+ "name": "AuroCheckbox",
1098
1090
  "declaration": {
1099
- "name": "AuroBibtemplate",
1100
- "module": "components/bibtemplate/src/index.js"
1091
+ "name": "AuroCheckbox",
1092
+ "module": "components/checkbox/src/index.js"
1093
+ }
1094
+ },
1095
+ {
1096
+ "kind": "js",
1097
+ "name": "AuroCheckboxGroup",
1098
+ "declaration": {
1099
+ "name": "AuroCheckboxGroup",
1100
+ "module": "components/checkbox/src/index.js"
1101
1101
  }
1102
1102
  }
1103
1103
  ]
1104
1104
  },
1105
1105
  {
1106
1106
  "kind": "javascript-module",
1107
- "path": "components/bibtemplate/src/registered.js",
1107
+ "path": "components/checkbox/src/registered.js",
1108
1108
  "declarations": [],
1109
1109
  "exports": []
1110
1110
  },
@@ -4577,7 +4577,7 @@
4577
4577
  {
4578
4578
  "kind": "method",
4579
4579
  "name": "updateHostAria",
4580
- "description": "Sets host-level ARIA so each cell exposes its date, selection state,\nand blackout status to assistive tech browsing the month grid.",
4580
+ "description": "Updates ARIA attributes on the host element so that\nariaActiveDescendantElement can expose cell info to the SR.",
4581
4581
  "privacy": "private",
4582
4582
  "return": {
4583
4583
  "type": {
@@ -4598,7 +4598,7 @@
4598
4598
  {
4599
4599
  "kind": "method",
4600
4600
  "name": "setActive",
4601
- "description": "Imperatively marks this cell as active without triggering a Lit re-render.\nButtons stay tabindex=\"-1\" because DOM focus stays on the grid wrapper —\narrow keys move the active cell imperatively and the live region carries\nthe SR announcement.",
4601
+ "description": "Imperatively marks this cell as active without triggering a Lit re-render.\nNote: buttons stay tabindex=\"-1\" because the grid uses aria-activedescendant.",
4602
4602
  "return": {
4603
4603
  "type": {
4604
4604
  "text": "void"
@@ -4743,7 +4743,6 @@
4743
4743
  "type": {
4744
4744
  "text": "array"
4745
4745
  },
4746
- "deprecated": "Propagated from the legacy `auro-calendar.disabledDays`\nUnix-timestamp array. The cell honors it for backward compatibility\n(see the divergence-check fallback inside `isBlackout`), but\nconsumers should migrate to `auro-datepicker.blackoutDates`\n(YYYY-MM-DD ISO strings). The calendar emits a one-time\ndeprecation warning the first time a non-empty value is observed.",
4747
4746
  "default": "[]",
4748
4747
  "attribute": "disabledDays"
4749
4748
  },
@@ -4903,7 +4902,6 @@
4903
4902
  "type": {
4904
4903
  "text": "array"
4905
4904
  },
4906
- "deprecated": "Propagated from the legacy `auro-calendar.disabledDays`\nUnix-timestamp array. The cell honors it for backward compatibility\n(see the divergence-check fallback inside `isBlackout`), but\nconsumers should migrate to `auro-datepicker.blackoutDates`\n(YYYY-MM-DD ISO strings). The calendar emits a one-time\ndeprecation warning the first time a non-empty value is observed.",
4907
4905
  "default": "[]",
4908
4906
  "fieldName": "disabledDays"
4909
4907
  },
@@ -5308,26 +5306,6 @@
5308
5306
  }
5309
5307
  }
5310
5308
  },
5311
- {
5312
- "kind": "method",
5313
- "name": "_afterMonthRender",
5314
- "parameters": [
5315
- {
5316
- "name": "callback",
5317
- "description": "Runs once after the month re-render and\nthe cells' button caches have refreshed.",
5318
- "type": {
5319
- "text": "() => void"
5320
- }
5321
- }
5322
- ],
5323
- "description": "Schedules `callback` two animation frames out, giving the child\n`auro-formkit-calendar-month` and `auro-formkit-calendar-cell` elements\na full render-and-paint cycle to settle before the callback reads or\nmutates DOM.\n\nWhy two frames, not one:\n1. Lit batches property updates and renders in a microtask, so frame N\n schedules the render but the new DOM may not be painted yet.\n2. Cells re-cache `_cachedButton` inside their own `updateComplete.then`,\n which also lands a tick later. Reading buttons from frame N+1\n (after both renders + cache refresh have flushed) reliably hits the\n new month's cells.\n\nUsed by every code path that calls `handleNextMonth`/`handlePrevMonth`\nand then needs to inspect the freshly-rendered cells (cross-month\nkeyboard nav, boundary events, `updateActiveCellForVisibleMonth`).\nDo NOT collapse to a single rAF — it intermittently lands before\n`_cachedButton` is refreshed, which silently breaks focus restoration\nand `setActiveCell` lookups.",
5324
- "privacy": "private",
5325
- "return": {
5326
- "type": {
5327
- "text": "void"
5328
- }
5329
- }
5330
- },
5331
5309
  {
5332
5310
  "kind": "method",
5333
5311
  "name": "renderAllCalendars",
@@ -5379,40 +5357,6 @@
5379
5357
  }
5380
5358
  }
5381
5359
  },
5382
- {
5383
- "kind": "method",
5384
- "name": "pickNearestCell",
5385
- "parameters": [
5386
- {
5387
- "name": "cells",
5388
- "description": "Focusable cells from getAllFocusableCells.",
5389
- "type": {
5390
- "text": "Array"
5391
- }
5392
- },
5393
- {
5394
- "name": "targetTs",
5395
- "description": "Desired Unix timestamp (seconds).",
5396
- "type": {
5397
- "text": "Number"
5398
- }
5399
- },
5400
- {
5401
- "name": "direction",
5402
- "description": "Navigation direction.",
5403
- "type": {
5404
- "text": "'next'|'prev'"
5405
- }
5406
- }
5407
- ],
5408
- "description": "Picks the focusable cell whose date is closest to targetTs. Used as a\nfallback after a month-boundary nav when the exact target date isn't\nfocusable — typically because the month re-render lagged or the date\nwas filtered out by isOutOfRange. When two cells are equidistant, the\nnavigation direction breaks the tie so the user moves the way they\npressed (forward → later cell, backward → earlier cell).",
5409
- "privacy": "private",
5410
- "return": {
5411
- "type": {
5412
- "text": "Object|null"
5413
- }
5414
- }
5415
- },
5416
5360
  {
5417
5361
  "kind": "method",
5418
5362
  "name": "getAllFocusableCells",
@@ -5436,7 +5380,7 @@
5436
5380
  }
5437
5381
  }
5438
5382
  ],
5439
- "description": "Sets the active cell across all months. Only one cell has tabindex=\"0\" at a time.\nUses imperative DOM manipulation — no Lit re-render triggered. DOM focus\nstays on the grid wrapper; the live region (see getOrCreateLiveRegion)\nis what announces the active cell to assistive tech.",
5383
+ "description": "Sets the active cell across all months. Only one cell has tabindex=\"0\" at a time.\nUses imperative DOM manipulation — no Lit re-render triggered.\nAlso updates ariaActiveDescendantElement on the grid wrapper so\nscreen readers announce the active cell without moving DOM focus.",
5440
5384
  "return": {
5441
5385
  "type": {
5442
5386
  "text": "void"
@@ -5475,39 +5419,6 @@
5475
5419
  }
5476
5420
  }
5477
5421
  },
5478
- {
5479
- "kind": "method",
5480
- "name": "_getBlackoutSet",
5481
- "description": "Returns a memoized Set of blackout timestamps (seconds) drawn from both\nthe legacy `disabledDays` array and the datepicker's ISO `blackoutDates`.\nThe cache invalidates when either source array's reference changes, which\nmatches Lit's own reactive identity semantics for array properties.",
5482
- "privacy": "private",
5483
- "return": {
5484
- "type": {
5485
- "text": "Set<Number>"
5486
- }
5487
- }
5488
- },
5489
- {
5490
- "kind": "field",
5491
- "name": "_warnedDisabledDaysDeprecation",
5492
- "type": {
5493
- "text": "boolean"
5494
- },
5495
- "static": true,
5496
- "default": "false",
5497
- "description": "Per-class flag that gates the `disabledDays` deprecation warning so it\nfires exactly once per page no matter how many calendars or rebuild\ncycles encounter the legacy array.",
5498
- "privacy": "private"
5499
- },
5500
- {
5501
- "kind": "method",
5502
- "name": "_warnDisabledDaysDeprecated",
5503
- "description": "One-time `console.debug` directing consumers from the legacy\n`disabledDays` Unix-timestamp API to the ISO `blackoutDates` API. Fires\nthe first time `_getBlackoutSet` rebuilds from a non-empty\n`disabledDays`; subsequent calls (on this or any other AuroCalendar\ninstance on the page) are silent.",
5504
- "privacy": "private",
5505
- "return": {
5506
- "type": {
5507
- "text": "void"
5508
- }
5509
- }
5510
- },
5511
5422
  {
5512
5423
  "kind": "method",
5513
5424
  "name": "computeActiveDate",
@@ -5562,7 +5473,7 @@
5562
5473
  }
5563
5474
  }
5564
5475
  ],
5565
- "description": "Handles arrow key navigation on the calendar grid wrapper.\nFocus stays on the grid wrapper; only the visual active-cell indicator\nchanges. The live region announces the new active cell.",
5476
+ "description": "Handles arrow key navigation on the calendar grid wrapper.\nFocus stays on the grid wrapper; only ariaActiveDescendantElement\nand the visual active-cell indicator change.",
5566
5477
  "privacy": "private",
5567
5478
  "return": {
5568
5479
  "type": {
@@ -5682,7 +5593,7 @@
5682
5593
  }
5683
5594
  }
5684
5595
  ],
5685
- "description": "Checks whether a given date is a blackout date. Delegates to the\nmemoized `_getBlackoutSet` so the YYYY-MM-DD parsing and the\nlegacy/ISO merge rules live in exactly one place (see `blackoutUtils.js`).",
5596
+ "description": "Checks whether a given date is a blackout date.",
5686
5597
  "privacy": "private",
5687
5598
  "return": {
5688
5599
  "type": {
@@ -5793,33 +5704,6 @@
5793
5704
  }
5794
5705
  }
5795
5706
  },
5796
- {
5797
- "kind": "method",
5798
- "name": "_deliverAnnouncement",
5799
- "parameters": [
5800
- {
5801
- "name": "dateStr",
5802
- "description": "The localized date string to announce.",
5803
- "type": {
5804
- "text": "String"
5805
- }
5806
- },
5807
- {
5808
- "name": "attempts",
5809
- "description": "Number of prior retry attempts.",
5810
- "type": {
5811
- "text": "Number"
5812
- }
5813
- }
5814
- ],
5815
- "description": "Writes `dateStr` to the live region. If the dropdown's dialog hasn't\nmounted yet (so getOrCreateLiveRegion can't attach), retries on the\nnext animation frame up to MAX_LIVE_REGION_RETRIES instead of silently\ndropping the announcement. The retry uses the same `_announceRafId`\nthe double-rAF below uses, so a newer announceSelection call (or\ndisconnectedCallback) cancels any in-flight retry.",
5816
- "privacy": "private",
5817
- "return": {
5818
- "type": {
5819
- "text": "void"
5820
- }
5821
- }
5822
- },
5823
5707
  {
5824
5708
  "kind": "method",
5825
5709
  "name": "announceFocusDebounced",
@@ -6004,7 +5888,7 @@
6004
5888
  "type": {
6005
5889
  "text": "array"
6006
5890
  },
6007
- "deprecated": "Use `auro-datepicker.blackoutDates` (an array of\n`YYYY-MM-DD` ISO strings) instead. This legacy array of Unix\ntimestamps is still honored for backward compatibility but emits a\none-time `console.debug` the first time a non-empty value is observed.\nSupport will be removed in a future major release.",
5891
+ "description": "Legacy array of disabled-date timestamps.",
6008
5892
  "privacy": "private",
6009
5893
  "default": "[]"
6010
5894
  },
@@ -6706,13 +6590,13 @@
6706
6590
  "parameters": [
6707
6591
  {
6708
6592
  "name": "time",
6709
- "description": "Unix timestamp (seconds), local midnight of the day.",
6593
+ "description": "Unix timestamp in seconds.",
6710
6594
  "type": {
6711
6595
  "text": "number"
6712
6596
  }
6713
6597
  }
6714
6598
  ],
6715
- "description": "Converts a Unix timestamp (seconds) from the vendored range-datepicker\n(`src/vendor/wc-range-datepicker/day.js`) to an ISO date string.\n\nTimezone contract:\n- INPUT: `time` is assumed to be the seconds-since-epoch of **local\n midnight** for the intended calendar day. The vendor's Day constructor\n builds it via `date-fns format(date, 't')` from a locally-constructed\n Date, so this assumption currently holds end-to-end.\n- OUTPUT: `dateFormatter.toISOFormatString` reads the Date's local\n getFullYear/getMonth/getDate components, so the returned YYYY-MM-DD\n string matches the local calendar day.\n\nIf the vendor ever switches to emitting UTC-midnight timestamps, this\nconversion will silently shift the returned date by one day in zones\nwest of UTC. Any vendor swap should re-verify this contract; the TZ\nregression suite (`npm run test:hst`, UTC-10) will catch the symptom.",
6599
+ "description": "Converts a Unix timestamp (seconds) from the vendor calendar to an ISO date string.",
6716
6600
  "privacy": "private",
6717
6601
  "return": {
6718
6602
  "type": {
@@ -6988,34 +6872,6 @@
6988
6872
  },
6989
6873
  "readonly": true
6990
6874
  },
6991
- {
6992
- "kind": "field",
6993
- "name": "_warnedInvalidLocales",
6994
- "static": true,
6995
- "default": "new Set()",
6996
- "description": "Per-class dedup set used by `_warnInvalidLocale`. Static so the dedup\nspans every datepicker instance on the page; lives on the class (not\nat module scope) so it stays an encapsulated implementation detail of\nthis component and does not interfere with WCA's class-JSDoc\nattachment.",
6997
- "privacy": "private"
6998
- },
6999
- {
7000
- "kind": "method",
7001
- "name": "_warnInvalidLocale",
7002
- "parameters": [
7003
- {
7004
- "name": "badLocale",
7005
- "description": "The locale value that failed.",
7006
- "type": {
7007
- "text": "string|undefined"
7008
- }
7009
- }
7010
- ],
7011
- "description": "Logs a one-time `console.debug` when an unsupported locale falls back to\nen-US. Deduped by the offending tag so noisy re-renders that resurface\nthe same bad value stay quiet, but each new bad value still signals so\nconsumers can spot the typo or missing tag.",
7012
- "privacy": "private",
7013
- "return": {
7014
- "type": {
7015
- "text": "void"
7016
- }
7017
- }
7018
- },
7019
6875
  {
7020
6876
  "kind": "method",
7021
6877
  "name": "handleSlotToSlot",
@@ -7380,23 +7236,11 @@
7380
7236
  "type": {
7381
7237
  "text": "string"
7382
7238
  },
7383
- "description": "Label announced for cells after a fully selected range (both\n`dateFrom` and `dateTo` are set). While a range is still being\npicked (`dateFrom` set, `dateTo` unset), focused cells past the\nstart use `rangeLabelEndPreview` instead.",
7239
+ "description": "Label announced for cells after the range (or after start when no end is selected).",
7384
7240
  "default": "'after range'",
7385
7241
  "attribute": "rangeLabelAfterRange",
7386
7242
  "reflects": true
7387
7243
  },
7388
- {
7389
- "kind": "field",
7390
- "name": "rangeLabelEndPreview",
7391
- "privacy": "public",
7392
- "type": {
7393
- "text": "string"
7394
- },
7395
- "description": "Label announced for the focused cell while previewing a range end\n(dateFrom set, dateTo not yet selected). Tells AT users that\npressing Enter would commit this cell as the range end.",
7396
- "default": "'previewing range end'",
7397
- "attribute": "rangeLabelEndPreview",
7398
- "reflects": true
7399
- },
7400
7244
  {
7401
7245
  "kind": "field",
7402
7246
  "name": "blackoutDates",
@@ -7736,13 +7580,6 @@
7736
7580
  "name": "helpTextTag",
7737
7581
  "privacy": "private"
7738
7582
  },
7739
- {
7740
- "kind": "field",
7741
- "name": "_listenerAbortController",
7742
- "description": "Single AbortController shared by every listener registered in the\nconfigure* methods. Lets disconnectedCallback tear all of them down\nwith one abort() call.\n\nThe genuine leak risk is the listeners attached to children that can\noutlive the host if they get reparented — `this.dropdown`,\n`this.calendar`, and the inputs inside the dropdown's slot.\nListeners attached to `this` (e.g. focusin/focusout on the host)\nform a self-contained reference graph that the GC can collect with\nthe host anyway, but they share the same signal so the cleanup\npattern stays uniform across all configure* sites.",
7743
- "privacy": "private",
7744
- "default": "new AbortController()"
7745
- },
7746
7583
  {
7747
7584
  "kind": "field",
7748
7585
  "name": "layout",
@@ -7913,7 +7750,7 @@
7913
7750
  "type": {
7914
7751
  "text": "array"
7915
7752
  },
7916
- "description": "Dates that the user should have for reference as part of their decision-making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
7753
+ "description": "Dates that the user should have for reference as part of their decision making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
7917
7754
  "attribute": "referenceDates",
7918
7755
  "reflects": true
7919
7756
  },
@@ -8353,7 +8190,7 @@
8353
8190
  "type": {
8354
8191
  "text": "string"
8355
8192
  },
8356
- "description": "Label announced for cells after a fully selected range (both\n`dateFrom` and `dateTo` are set). While a range is still being\npicked (`dateFrom` set, `dateTo` unset), focused cells past the\nstart use `rangeLabelEndPreview` instead.",
8193
+ "description": "Label announced for cells after the range (or after start when no end is selected).",
8357
8194
  "default": "'after range'",
8358
8195
  "fieldName": "rangeLabelAfterRange"
8359
8196
  },
@@ -8375,15 +8212,6 @@
8375
8212
  "default": "'range end'",
8376
8213
  "fieldName": "rangeLabelEnd"
8377
8214
  },
8378
- {
8379
- "name": "rangeLabelEndPreview",
8380
- "type": {
8381
- "text": "string"
8382
- },
8383
- "description": "Label announced for the focused cell while previewing a range end\n(dateFrom set, dateTo not yet selected). Tells AT users that\npressing Enter would commit this cell as the range end.",
8384
- "default": "'previewing range end'",
8385
- "fieldName": "rangeLabelEndPreview"
8386
- },
8387
8215
  {
8388
8216
  "name": "rangeLabelInRange",
8389
8217
  "type": {
@@ -8407,7 +8235,7 @@
8407
8235
  "type": {
8408
8236
  "text": "array"
8409
8237
  },
8410
- "description": "Dates that the user should have for reference as part of their decision-making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
8238
+ "description": "Dates that the user should have for reference as part of their decision making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
8411
8239
  "fieldName": "referenceDates"
8412
8240
  },
8413
8241
  {
@@ -8557,116 +8385,6 @@
8557
8385
  }
8558
8386
  ]
8559
8387
  },
8560
- {
8561
- "kind": "javascript-module",
8562
- "path": "components/datepicker/src/blackoutUtils.js",
8563
- "declarations": [
8564
- {
8565
- "kind": "function",
8566
- "name": "parseIsoToTimestamp",
8567
- "parameters": [
8568
- {
8569
- "name": "isoStr",
8570
- "description": "Date string in `YYYY-MM-DD` format.",
8571
- "type": {
8572
- "text": "string"
8573
- }
8574
- }
8575
- ],
8576
- "description": "Converts a `YYYY-MM-DD` ISO date string to a Unix timestamp (seconds)\nrepresenting local midnight on that calendar day. Returns `null` for\ninputs that don't parse to a finite timestamp.\n\nUses the `new Date(year, monthIndex, day)` constructor (NOT\n`new Date(isoStr)`) so the result is local-midnight rather than UTC\nmidnight — required to keep the calendar grid aligned with the user's\nlocal calendar day in negative-offset timezones.",
8577
- "return": {
8578
- "type": {
8579
- "text": "number|null"
8580
- }
8581
- }
8582
- },
8583
- {
8584
- "kind": "function",
8585
- "name": "buildBlackoutSet",
8586
- "parameters": [
8587
- {
8588
- "name": "disabledDays",
8589
- "description": "Legacy timestamp array.",
8590
- "type": {
8591
- "text": "Array<string|number>|undefined"
8592
- }
8593
- },
8594
- {
8595
- "name": "blackoutDates",
8596
- "description": "ISO `YYYY-MM-DD` array.",
8597
- "type": {
8598
- "text": "Array<string>|undefined"
8599
- }
8600
- }
8601
- ],
8602
- "description": "Builds a `Set<number>` of seconds-since-epoch timestamps covering both the\nlegacy `disabledDays` (already-numeric) array and the ISO `blackoutDates`\narray. Use this for O(1) membership checks in hot paths.",
8603
- "return": {
8604
- "type": {
8605
- "text": "Set<number>"
8606
- }
8607
- }
8608
- },
8609
- {
8610
- "kind": "function",
8611
- "name": "isBlackoutTimestamp",
8612
- "parameters": [
8613
- {
8614
- "name": "dateTs",
8615
- "description": "Unix timestamp (seconds) to test.",
8616
- "type": {
8617
- "text": "number"
8618
- }
8619
- },
8620
- {
8621
- "name": "disabledDays",
8622
- "description": "Legacy timestamp array.",
8623
- "type": {
8624
- "text": "Array<string|number>|undefined"
8625
- }
8626
- },
8627
- {
8628
- "name": "blackoutDates",
8629
- "description": "ISO `YYYY-MM-DD` array.",
8630
- "type": {
8631
- "text": "Array<string>|undefined"
8632
- }
8633
- }
8634
- ],
8635
- "description": "One-shot membership test for a single timestamp against both blackout\nsources. Allocates a Set on each call; only use this in cold paths\n(e.g. the pre-`firstUpdated` cell fallback). Hot paths should hold the\nSet returned from `buildBlackoutSet` and `.has(ts)` directly.",
8636
- "return": {
8637
- "type": {
8638
- "text": "boolean"
8639
- }
8640
- }
8641
- }
8642
- ],
8643
- "exports": [
8644
- {
8645
- "kind": "js",
8646
- "name": "parseIsoToTimestamp",
8647
- "declaration": {
8648
- "name": "parseIsoToTimestamp",
8649
- "module": "components/datepicker/src/blackoutUtils.js"
8650
- }
8651
- },
8652
- {
8653
- "kind": "js",
8654
- "name": "buildBlackoutSet",
8655
- "declaration": {
8656
- "name": "buildBlackoutSet",
8657
- "module": "components/datepicker/src/blackoutUtils.js"
8658
- }
8659
- },
8660
- {
8661
- "kind": "js",
8662
- "name": "isBlackoutTimestamp",
8663
- "declaration": {
8664
- "name": "isBlackoutTimestamp",
8665
- "module": "components/datepicker/src/blackoutUtils.js"
8666
- }
8667
- }
8668
- ]
8669
- },
8670
8388
  {
8671
8389
  "kind": "javascript-module",
8672
8390
  "path": "components/datepicker/src/buttonVersion.js",
@@ -18917,6 +18635,18 @@
18917
18635
  }
18918
18636
  }
18919
18637
  },
18638
+ {
18639
+ "kind": "method",
18640
+ "name": "_syncLabelText",
18641
+ "description": "Reads the current label slot text and pushes it to the dropdown bib\n(for dialog naming) and the menu (for listbox aria-label). Safe to call\nbefore either child has been wired up — each branch self-guards.",
18642
+ "privacy": "private"
18643
+ },
18644
+ {
18645
+ "kind": "method",
18646
+ "name": "_observeLabelChanges",
18647
+ "description": "Keeps the dialog/menu accessible names in sync when consumers mutate the\nlabel slot at runtime (e.g., i18n locale swap). `slotchange` alone is\ninsufficient — it doesn't fire when textContent of an already-assigned\nslotted node changes, which is the common case. We scope the observer to\nthe label node itself (not the whole host subtree) so option-content\nmutations don't trigger label re-syncs, and re-target on `slotchange`\nwhen consumers add or replace the label element.",
18648
+ "privacy": "private"
18649
+ },
18920
18650
  {
18921
18651
  "kind": "method",
18922
18652
  "name": "register",
@@ -19635,15 +19365,6 @@
19635
19365
  "module": "components/layoutElement/src/auroElement.js"
19636
19366
  }
19637
19367
  },
19638
- {
19639
- "kind": "field",
19640
- "name": "options",
19641
- "privacy": "private",
19642
- "type": {
19643
- "text": "array"
19644
- },
19645
- "attribute": "options"
19646
- },
19647
19368
  {
19648
19369
  "kind": "field",
19649
19370
  "name": "optionSelected",
@@ -20012,13 +19733,6 @@
20012
19733
  "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
20013
19734
  "fieldName": "onDark"
20014
19735
  },
20015
- {
20016
- "name": "options",
20017
- "type": {
20018
- "text": "array"
20019
- },
20020
- "fieldName": "options"
20021
- },
20022
19736
  {
20023
19737
  "name": "optionSelected",
20024
19738
  "type": {
@@ -20196,7 +19910,7 @@
20196
19910
  "type": {
20197
19911
  "text": "object"
20198
19912
  },
20199
- "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { // Always clear the type-ahead buffer — Escape is a universal cancel. // Safe to call when the buffer is empty. // eslint-disable-next-line no-underscore-dangle if (typeof component._clearTypeaheadBuffer === 'function') { // eslint-disable-next-line no-underscore-dangle component._clearTypeaheadBuffer(); } if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getEnabledOptions returns a fresh filtered array. const lastOption = getEnabledOptions(component.menu).pop(); if (lastOption) { component.menu.updateActiveOption(lastOption); } }, Enter(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getEnabledOptions(component.menu); if (firstOption) { component.menu.updateActiveOption(firstOption); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { // Space resolves to either typeahead-buffer extension or bib toggle // depending on whether a type-ahead buffer is active. Mirrors native // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space // is a search character (e.g. \"San Francisco\"); otherwise it toggles. if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) { component.updateActiveOptionBasedOnKey(evt.key); return; } if (ctx.isExpanded) { component.dropdown.hide(); } else { component.dropdown.show(); } return; } component.updateActiveOptionBasedOnKey(evt.key); }, }"
19913
+ "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { // Always clear the type-ahead buffer — Escape is a universal cancel. // Safe to call when the buffer is empty. // eslint-disable-next-line no-underscore-dangle if (typeof component._clearTypeaheadBuffer === 'function') { // eslint-disable-next-line no-underscore-dangle component._clearTypeaheadBuffer(); } if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getEnabledOptions returns a fresh filtered array. const lastOption = getEnabledOptions(component.menu).pop(); if (!lastOption) { return; } if (!ctx.isExpanded) { component.dropdown.show(); } component.menu.updateActiveOption(lastOption); }, Enter(component, evt, ctx) { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit. Matches APG select-only combobox // and native <select> behavior: Enter opens the listbox when closed, selects // the active option when open — it does not submit a parent form. evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getEnabledOptions(component.menu); if (!firstOption) { return; } if (!ctx.isExpanded) { component.dropdown.show(); } component.menu.updateActiveOption(firstOption); }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { // Space resolves to either typeahead-buffer extension or bib toggle // depending on whether a type-ahead buffer is active. Mirrors native // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space // is a search character (e.g. \"San Francisco\"); otherwise it toggles. if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) { component.updateActiveOptionBasedOnKey(evt.key); return; } if (ctx.isExpanded) { component.dropdown.hide(); } else { component.dropdown.show(); } return; } component.updateActiveOptionBasedOnKey(evt.key); }, }"
20200
19914
  }
20201
19915
  ],
20202
19916
  "exports": [