@aurodesignsystem-dev/auro-formkit 0.0.0-pr1509.0 → 0.0.0-pr1510.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 (50) 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 +4 -19
  7. package/components/combobox/demo/getting-started.min.js +4 -19
  8. package/components/combobox/demo/index.min.js +4 -19
  9. package/components/combobox/dist/index.js +4 -19
  10. package/components/combobox/dist/registered.js +4 -19
  11. package/components/counter/demo/customize.min.js +2 -2
  12. package/components/counter/demo/index.min.js +2 -2
  13. package/components/counter/dist/index.js +2 -2
  14. package/components/counter/dist/registered.js +2 -2
  15. package/components/datepicker/demo/accessibility.md +2 -1
  16. package/components/datepicker/demo/api.md +63 -62
  17. package/components/datepicker/demo/customize.md +12 -1
  18. package/components/datepicker/demo/customize.min.js +456 -183
  19. package/components/datepicker/demo/index.min.js +456 -183
  20. package/components/datepicker/dist/index.js +456 -183
  21. package/components/datepicker/dist/registered.js +456 -183
  22. package/components/datepicker/dist/src/auro-calendar-cell.d.ts +14 -3
  23. package/components/datepicker/dist/src/auro-calendar.d.ts +87 -5
  24. package/components/datepicker/dist/src/auro-datepicker.d.ts +73 -3
  25. package/components/dropdown/demo/customize.min.js +1 -1
  26. package/components/dropdown/demo/getting-started.min.js +1 -1
  27. package/components/dropdown/demo/index.min.js +1 -1
  28. package/components/dropdown/dist/index.js +1 -1
  29. package/components/dropdown/dist/registered.js +1 -1
  30. package/components/form/demo/customize.min.js +474 -231
  31. package/components/form/demo/getting-started.min.js +474 -231
  32. package/components/form/demo/index.min.js +474 -231
  33. package/components/form/demo/registerDemoDeps.min.js +474 -231
  34. package/components/input/demo/customize.min.js +2 -17
  35. package/components/input/demo/getting-started.min.js +2 -17
  36. package/components/input/demo/index.min.js +2 -17
  37. package/components/input/dist/index.js +2 -17
  38. package/components/input/dist/registered.js +2 -17
  39. package/components/radio/demo/customize.min.js +1 -1
  40. package/components/radio/demo/getting-started.min.js +1 -1
  41. package/components/radio/demo/index.min.js +1 -1
  42. package/components/radio/dist/index.js +1 -1
  43. package/components/radio/dist/registered.js +1 -1
  44. package/components/select/demo/customize.min.js +2 -2
  45. package/components/select/demo/getting-started.min.js +2 -2
  46. package/components/select/demo/index.min.js +2 -2
  47. package/components/select/dist/index.js +2 -2
  48. package/components/select/dist/registered.js +2 -2
  49. package/custom-elements.json +1868 -1696
  50. package/package.json +2 -1
package/custom-elements.json CHANGED
@@ -4,35 +4,35 @@
4
4
  "modules": [
5
5
  {
6
6
  "kind": "javascript-module",
7
- "path": "components/bibtemplate/src/auro-bibtemplate.js",
7
+ "path": "components/checkbox/src/auro-checkbox-group.js",
8
8
  "declarations": [
9
9
  {
10
10
  "kind": "class",
11
- "description": "The `auro-bibtemplate` element provides users a template for creating modal dialog elements.",
12
- "name": "AuroBibtemplate",
11
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
12
+ "name": "AuroCheckboxGroup",
13
13
  "slots": [
14
14
  {
15
- "description": "The default slot for the main content.",
16
- "name": "default"
17
- },
18
- {
19
- "description": "Slot for the header content.",
20
- "name": "header"
15
+ "description": "Allows for the legend to be overridden.",
16
+ "name": "legend"
21
17
  },
22
18
  {
23
- "description": "Slot for the subheader content.",
24
- "name": "subheader"
19
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
20
+ "name": "optionalLabel"
25
21
  },
26
22
  {
27
- "description": "Slot for the footer content.",
28
- "name": "footer"
23
+ "description": "Allows for the helper text to be overridden.",
24
+ "name": "helpText"
29
25
  },
30
26
  {
31
- "description": "Slot for the close button aria-label.",
32
- "name": "ariaLabel.close"
27
+ "description": "The default slot for the checkbox items.",
28
+ "name": "default"
33
29
  }
34
30
  ],
35
31
  "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-bibtemplate\"",
44
- "description": "The name of element that you want to register to.",
43
+ "default": "\"auro-checkbox-group\"",
44
+ "description": "The name of the element that you want to register.",
45
45
  "optional": true,
46
46
  "type": {
47
47
  "text": "string"
@@ -52,17 +52,25 @@
52
52
  },
53
53
  {
54
54
  "kind": "method",
55
- "name": "preventBodyScroll",
55
+ "name": "handleValueUpdate",
56
56
  "parameters": [
57
57
  {
58
- "name": "event",
59
- "description": "The touchmove event.",
58
+ "name": "value",
59
+ "description": "The value of the checkbox.",
60
60
  "type": {
61
- "text": "Event"
61
+ "text": "String"
62
+ }
63
+ },
64
+ {
65
+ "name": "selected",
66
+ "description": "The checked state of the checkbox.",
67
+ "type": {
68
+ "text": "Boolean"
62
69
  }
63
70
  }
64
71
  ],
65
- "description": "Prevents scrolling of the body when touching empty areas of the component.",
72
+ "description": "Helper method to handle checkbox value changing.",
73
+ "privacy": "private",
66
74
  "return": {
67
75
  "type": {
68
76
  "text": "void"
@@ -71,8 +79,9 @@
71
79
  },
72
80
  {
73
81
  "kind": "method",
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.",
82
+ "name": "handlePreselectedItems",
83
+ "description": "Helper method that handles the state of preselected checkboxes.",
84
+ "privacy": "private",
76
85
  "return": {
77
86
  "type": {
78
87
  "text": "void"
@@ -81,266 +90,315 @@
81
90
  },
82
91
  {
83
92
  "kind": "method",
84
- "name": "onCloseButtonClick"
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
+ }
85
101
  },
86
102
  {
87
103
  "kind": "method",
88
- "name": "exposeCssParts",
89
- "description": "Exposes CSS parts for styling from parent components.",
104
+ "name": "reset",
105
+ "description": "Resets component to initial state.",
90
106
  "return": {
91
107
  "type": {
92
108
  "text": "void"
93
109
  }
94
110
  }
95
111
  },
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
+ },
96
128
  {
97
129
  "kind": "field",
98
- "name": "large",
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
+ {
141
+ "kind": "field",
142
+ "name": "disabled",
99
143
  "privacy": "public",
100
144
  "type": {
101
145
  "text": "boolean"
102
146
  },
103
- "default": "false",
104
- "attribute": "large",
147
+ "description": "If set, disables the checkbox group.",
148
+ "attribute": "disabled",
105
149
  "reflects": true
106
150
  },
107
151
  {
108
152
  "kind": "field",
109
- "name": "iconTag",
110
- "privacy": "private"
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
111
161
  },
112
162
  {
113
163
  "kind": "field",
114
- "name": "headerTag",
115
- "privacy": "private"
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
116
172
  },
117
173
  {
118
174
  "kind": "field",
119
- "name": "buttonTag",
120
- "privacy": "private"
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
121
183
  },
122
184
  {
123
185
  "kind": "field",
124
- "name": "isFullscreen",
186
+ "name": "onDark",
125
187
  "privacy": "public",
126
188
  "type": {
127
189
  "text": "boolean"
128
190
  },
129
- "attribute": "isFullscreen",
191
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
192
+ "attribute": "onDark",
130
193
  "reflects": true
131
194
  },
132
195
  {
133
196
  "kind": "field",
134
- "name": "showFooter",
197
+ "name": "required",
135
198
  "privacy": "public",
136
199
  "type": {
137
200
  "text": "boolean"
138
201
  },
139
- "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
140
- "attribute": "showFooter",
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",
141
245
  "reflects": true
142
246
  }
143
247
  ],
144
248
  "events": [
145
249
  {
146
- "name": "close-click",
250
+ "name": "input",
147
251
  "type": {
148
- "text": "Event"
252
+ "text": "CustomEvent"
149
253
  }
150
254
  },
151
255
  {
152
- "name": "auro-bibtemplate-connected",
153
- "type": {
154
- "text": "CustomEvent"
155
- }
256
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
257
+ "name": "auroFormElement-validated"
156
258
  }
157
259
  ],
158
260
  "attributes": [
159
261
  {
160
- "name": "isFullscreen",
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",
161
272
  "type": {
162
273
  "text": "boolean"
163
274
  },
164
- "fieldName": "isFullscreen"
275
+ "description": "If set, disables the checkbox group.",
276
+ "fieldName": "disabled"
165
277
  },
166
278
  {
167
- "name": "large",
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",
168
288
  "type": {
169
289
  "text": "boolean"
170
290
  },
171
- "default": "false",
172
- "fieldName": "large"
291
+ "description": "If set, checkboxes will be aligned horizontally.",
292
+ "fieldName": "horizontal"
173
293
  },
174
294
  {
175
- "name": "showFooter",
295
+ "name": "noValidate",
176
296
  "type": {
177
297
  "text": "boolean"
178
298
  },
179
- "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
180
- "fieldName": "showFooter"
181
- }
182
- ],
183
- "superclass": {
184
- "name": "LitElement",
185
- "package": "lit"
186
- },
187
- "tagName": "auro-bibtemplate",
188
- "customElement": true
189
- }
190
- ],
191
- "exports": [
192
- {
193
- "kind": "js",
194
- "name": "AuroBibtemplate",
195
- "declaration": {
196
- "name": "AuroBibtemplate",
197
- "module": "components/bibtemplate/src/auro-bibtemplate.js"
198
- }
199
- }
200
- ]
201
- },
202
- {
203
- "kind": "javascript-module",
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
- }
299
+ "description": "If set, disables auto-validation on blur.",
300
+ "fieldName": "noValidate"
301
+ },
302
+ {
303
+ "name": "onDark",
304
+ "type": {
305
+ "text": "boolean"
306
+ },
307
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
308
+ "fieldName": "onDark"
309
+ },
310
+ {
311
+ "name": "required",
312
+ "type": {
313
+ "text": "boolean"
314
+ },
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"
349
+ }
350
+ ],
351
+ "superclass": {
352
+ "name": "LitElement",
353
+ "package": "lit"
354
+ },
355
+ "tagName": "auro-checkbox-group",
356
+ "customElement": true
244
357
  }
245
- ]
246
- },
247
- {
248
- "kind": "javascript-module",
249
- "path": "components/bibtemplate/src/index.js",
250
- "declarations": [],
358
+ ],
251
359
  "exports": [
252
360
  {
253
361
  "kind": "js",
254
- "name": "AuroBibtemplate",
362
+ "name": "AuroCheckboxGroup",
255
363
  "declaration": {
256
- "name": "AuroBibtemplate",
257
- "module": "components/bibtemplate/src/index.js"
364
+ "name": "AuroCheckboxGroup",
365
+ "module": "components/checkbox/src/auro-checkbox-group.js"
258
366
  }
259
367
  }
260
368
  ]
261
369
  },
262
370
  {
263
371
  "kind": "javascript-module",
264
- "path": "components/bibtemplate/src/registered.js",
265
- "declarations": [],
266
- "exports": []
267
- },
268
- {
269
- "kind": "javascript-module",
270
- "path": "components/combobox/src/auro-combobox.js",
372
+ "path": "components/checkbox/src/auro-checkbox.js",
271
373
  "declarations": [
272
374
  {
273
375
  "kind": "class",
274
- "description": "The `auro-combobox` element provides users with a way to select an option from a list of filtered or suggested options based on user input.",
275
- "name": "AuroCombobox",
276
- "slots": [
277
- {
278
- "description": "Default slot for the menu content.",
279
- "name": ""
280
- },
281
- {
282
- "type": {
283
- "text": "HTMLSlotElement"
284
- },
285
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
286
- "name": "optionalLabel"
287
- },
288
- {
289
- "description": "Sets aria-label on clear button",
290
- "name": "ariaLabel.input.clear"
291
- },
292
- {
293
- "description": "Sets aria-label on close button in fullscreen bib",
294
- "name": "ariaLabel.bib.close"
295
- },
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": [
296
379
  {
297
- "description": "Defines the headline to display above menu-options",
298
- "name": "bib.fullscreen.headline"
380
+ "description": "apply css to a specific checkbox.",
381
+ "name": "checkbox"
299
382
  },
300
383
  {
301
- "description": "Defines the content of the label.",
302
- "name": "label"
384
+ "description": "apply css to a specific checkbox's input.",
385
+ "name": "checkbox-input"
303
386
  },
304
387
  {
305
- "description": "Defines the content of the helpText.",
306
- "name": "helpText"
307
- },
388
+ "description": "apply css to a specific checkbox's label.",
389
+ "name": "checkbox-label"
390
+ }
391
+ ],
392
+ "slots": [
308
393
  {
309
- "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
310
- "name": "displayValue"
394
+ "description": "The default slot for the checkbox label.",
395
+ "name": "default"
311
396
  }
312
397
  ],
313
398
  "members": [
314
399
  {
315
400
  "kind": "method",
316
- "name": "_initializeDefaults",
317
- "privacy": "private",
318
- "return": {
319
- "type": {
320
- "text": "void"
321
- }
322
- }
323
- },
324
- {
325
- "kind": "field",
326
- "name": "inputValue",
327
- "description": "Returns the current value of the input element within the combobox.",
328
- "return": {
329
- "type": {
330
- "text": "string|undefined"
331
- }
332
- },
333
- "readonly": true
334
- },
335
- {
336
- "kind": "method",
337
- "name": "isValid",
338
- "description": "Checks if the element is valid.",
339
- "return": {
340
- "type": {
341
- "text": "boolean"
342
- }
343
- }
401
+ "name": "_initializeDefaults"
344
402
  },
345
403
  {
346
404
  "kind": "method",
@@ -349,8 +407,8 @@
349
407
  "parameters": [
350
408
  {
351
409
  "name": "name",
352
- "default": "'auro-combobox'",
353
- "description": "The name of the element that you want to register.",
410
+ "default": "\"auro-checkbox\"",
411
+ "description": "The name of element that you want to register to.",
354
412
  "optional": true,
355
413
  "type": {
356
414
  "text": "string"
@@ -361,8 +419,17 @@
361
419
  },
362
420
  {
363
421
  "kind": "method",
364
- "name": "activateFirstEnabledAvailableOption",
365
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
422
+ "name": "handleChange",
423
+ "parameters": [
424
+ {
425
+ "name": "event",
426
+ "description": "The change event from the checkbox input.",
427
+ "type": {
428
+ "text": "Event"
429
+ }
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.",
366
433
  "privacy": "private",
367
434
  "return": {
368
435
  "type": {
@@ -372,8 +439,17 @@
372
439
  },
373
440
  {
374
441
  "kind": "method",
375
- "name": "activateLastEnabledAvailableOption",
376
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
442
+ "name": "handleInput",
443
+ "parameters": [
444
+ {
445
+ "name": "event",
446
+ "description": "The input event from the checkbox input.",
447
+ "type": {
448
+ "text": "Event"
449
+ }
450
+ }
451
+ ],
452
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
377
453
  "privacy": "private",
378
454
  "return": {
379
455
  "type": {
@@ -383,14 +459,8 @@
383
459
  },
384
460
  {
385
461
  "kind": "method",
386
- "name": "updateFilter",
387
- "description": "Updates the filter for the available options based on the input value.",
388
- "privacy": "private"
389
- },
390
- {
391
- "kind": "method",
392
- "name": "syncValuesAndStates",
393
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
462
+ "name": "handleFocusin",
463
+ "description": "Function to support",
394
464
  "privacy": "private",
395
465
  "return": {
396
466
  "type": {
@@ -400,24 +470,19 @@
400
470
  },
401
471
  {
402
472
  "kind": "method",
403
- "name": "updateTriggerTextDisplay",
404
- "parameters": [
405
- {
406
- "name": "label",
407
- "description": "The label of the selected option.",
408
- "type": {
409
- "text": "string"
410
- }
473
+ "name": "generateIconHtml",
474
+ "description": "Function to generate checkmark svg.",
475
+ "privacy": "private",
476
+ "return": {
477
+ "type": {
478
+ "text": "HTMLElement"
411
479
  }
412
- ],
413
- "description": "Update displayValue or input.value, it's called when making a selection.",
414
- "privacy": "private"
480
+ }
415
481
  },
416
482
  {
417
483
  "kind": "method",
418
- "name": "handleMenuOptions",
419
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
420
- "privacy": "private",
484
+ "name": "reset",
485
+ "description": "Resets component to initial state.",
421
486
  "return": {
422
487
  "type": {
423
488
  "text": "void"
@@ -426,8 +491,8 @@
426
491
  },
427
492
  {
428
493
  "kind": "method",
429
- "name": "generateOptionsArray",
430
- "description": "Determines the element error state based on the `required` attribute and input value.",
494
+ "name": "updateAriaLabel",
495
+ "description": "Updates the aria-label based on slot content.",
431
496
  "privacy": "private",
432
497
  "return": {
433
498
  "type": {
@@ -437,8 +502,18 @@
437
502
  },
438
503
  {
439
504
  "kind": "method",
440
- "name": "hideBib",
441
- "description": "Hides the dropdown bib if its open.",
505
+ "name": "handleKeyDown",
506
+ "parameters": [
507
+ {
508
+ "name": "event",
509
+ "description": "The keydown event from the checkbox input.",
510
+ "type": {
511
+ "text": "KeyboardEvent"
512
+ }
513
+ }
514
+ ],
515
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
516
+ "privacy": "private",
442
517
  "return": {
443
518
  "type": {
444
519
  "text": "void"
@@ -446,1283 +521,901 @@
446
521
  }
447
522
  },
448
523
  {
449
- "kind": "method",
450
- "name": "showBib",
451
- "description": "Shows the dropdown bib if there are options to show.",
452
- "return": {
453
- "type": {
454
- "text": "void"
455
- }
456
- }
524
+ "kind": "field",
525
+ "name": "appearance",
526
+ "privacy": "public",
527
+ "type": {
528
+ "text": "'default' | 'inverse'"
529
+ },
530
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
531
+ "default": "'default'",
532
+ "attribute": "appearance",
533
+ "reflects": true
457
534
  },
458
535
  {
459
- "kind": "method",
460
- "name": "configureDropdown",
461
- "description": "Binds all behavior needed to the dropdown after rendering.",
462
- "privacy": "private",
463
- "return": {
464
- "type": {
465
- "text": "void"
466
- }
467
- }
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
468
545
  },
469
546
  {
470
- "kind": "method",
471
- "name": "setClearBtnFocus",
472
- "privacy": "private"
547
+ "kind": "field",
548
+ "name": "disabled",
549
+ "privacy": "public",
550
+ "type": {
551
+ "text": "boolean"
552
+ },
553
+ "description": "If set to true, the checkbox will not be clickable.",
554
+ "attribute": "disabled",
555
+ "reflects": true
473
556
  },
474
557
  {
475
- "kind": "method",
476
- "name": "setTriggerInputFocus",
477
- "privacy": "private"
558
+ "kind": "field",
559
+ "name": "error",
560
+ "privacy": "public",
561
+ "type": {
562
+ "text": "boolean"
563
+ },
564
+ "description": "If set to true, the checkbox will be displayed with an error state.",
565
+ "attribute": "error",
566
+ "reflects": true
478
567
  },
479
568
  {
480
- "kind": "method",
481
- "name": "setInputFocus",
482
- "privacy": "private"
569
+ "kind": "field",
570
+ "name": "id",
571
+ "privacy": "public",
572
+ "type": {
573
+ "text": "string"
574
+ },
575
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
576
+ "attribute": "id",
577
+ "reflects": true
483
578
  },
484
579
  {
485
- "kind": "method",
486
- "name": "updateBibDialogRole",
487
- "description": "Suppresses or restores dialog semantics on the bib's dialog element.\nOn desktop (non-fullscreen), VoiceOver verbosely announces \"listbox inside\nof a dialog\" which disrupts combobox usage. Setting role=\"presentation\"\nsuppresses this. In fullscreen mode, dialog semantics are restored.",
488
- "privacy": "private"
580
+ "kind": "field",
581
+ "name": "inputId",
582
+ "privacy": "private",
583
+ "type": {
584
+ "text": "string"
585
+ },
586
+ "description": "The id for input node."
489
587
  },
490
588
  {
491
- "kind": "method",
492
- "name": "updateMenuShapeSize",
493
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
494
- "privacy": "private"
589
+ "kind": "field",
590
+ "name": "name",
591
+ "privacy": "public",
592
+ "type": {
593
+ "text": "string"
594
+ },
595
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
596
+ "attribute": "name"
495
597
  },
496
598
  {
497
- "kind": "method",
498
- "name": "_getAnnouncementRoot",
499
- "description": "Returns the shadow root containing the live region for screen reader announcements.\nWhen the bib is open in fullscreen modal mode, everything outside the <dialog>\nis inert, so we target the bib's own shadow root instead of the host's.",
599
+ "kind": "field",
600
+ "name": "onDark",
601
+ "privacy": "public",
602
+ "type": {
603
+ "text": "boolean"
604
+ },
605
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
606
+ "attribute": "onDark",
607
+ "reflects": true
608
+ },
609
+ {
610
+ "kind": "field",
611
+ "name": "touched",
500
612
  "privacy": "private",
501
- "return": {
502
- "type": {
503
- "text": "ShadowRoot"
504
- }
505
- }
613
+ "type": {
614
+ "text": "boolean"
615
+ },
616
+ "description": "Indicates whether the checkbox has been interacted with."
506
617
  },
507
618
  {
508
- "kind": "method",
509
- "name": "configureMenu",
510
- "description": "Binds all behavior needed to the menu after rendering.",
619
+ "kind": "field",
620
+ "name": "value",
621
+ "privacy": "public",
622
+ "type": {
623
+ "text": "string"
624
+ },
625
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
626
+ "attribute": "value"
627
+ },
628
+ {
629
+ "kind": "field",
630
+ "name": "tabIndex",
511
631
  "privacy": "private",
512
- "return": {
513
- "type": {
514
- "text": "void"
515
- }
516
- }
632
+ "type": {
633
+ "text": "number"
634
+ },
635
+ "description": "The tabindex attribute for the checkbox.",
636
+ "attribute": "tabindex",
637
+ "reflects": true
517
638
  },
518
639
  {
519
- "kind": "method",
520
- "name": "configureInput",
521
- "description": "Binds all behavior needed to the input after rendering.",
640
+ "kind": "field",
641
+ "name": "ariaChecked",
522
642
  "privacy": "private",
523
- "return": {
524
- "type": {
525
- "text": "void"
526
- }
527
- }
643
+ "type": {
644
+ "text": "string"
645
+ },
646
+ "description": "The aria-checked attribute for the checkbox.",
647
+ "attribute": "aria-checked",
648
+ "reflects": true
528
649
  },
529
650
  {
530
- "kind": "method",
531
- "name": "handleMenuLoadingChange",
532
- "parameters": [
533
- {
534
- "name": "event",
535
- "description": "The event object containing details about the loading state change.",
536
- "type": {
537
- "text": "CustomEvent"
538
- }
539
- },
540
- {
541
- "description": "Indicates whether the menu is currently loading.",
542
- "name": "event.detail.loading",
543
- "type": {
544
- "text": "boolean"
545
- }
546
- },
547
- {
548
- "description": "Indicates if there are loading placeholders present.",
549
- "name": "event.detail.hasLoadingPlaceholder",
550
- "type": {
551
- "text": "boolean"
552
- }
553
- }
554
- ],
555
- "description": "Manages the visibility of the dropdown based on loading state changes.\n\nThis method listens for loading state changes and adjusts the visibility of the dropdown accordingly.\nIf the dropdown is visible and loading is true without any loading placeholders, it hides the dropdown\nand sets a flag to indicate it is hidden while loading. If loading is false and the dropdown was previously\nhidden, it checks if the active element is within the dropdown and shows it again if true.",
651
+ "kind": "field",
652
+ "name": "ariaDisabled",
556
653
  "privacy": "private",
557
- "return": {
558
- "type": {
559
- "text": "void"
560
- }
561
- }
654
+ "type": {
655
+ "text": "string"
656
+ },
657
+ "description": "The aria-disabled attribute for the checkbox.",
658
+ "attribute": "aria-disabled",
659
+ "reflects": true
562
660
  },
563
661
  {
564
- "kind": "method",
565
- "name": "handleInputValueChange",
566
- "parameters": [
567
- {
568
- "name": "event",
569
- "description": "The input event triggered by the input element.",
570
- "type": {
571
- "text": "Event"
572
- }
573
- }
574
- ],
575
- "description": "Handle changes to the input value and trigger changes that should result.",
662
+ "kind": "field",
663
+ "name": "role",
576
664
  "privacy": "private",
577
- "return": {
578
- "type": {
579
- "text": "void"
580
- }
665
+ "type": {
666
+ "text": "string"
667
+ },
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",
670
+ "reflects": true
671
+ }
672
+ ],
673
+ "events": [
674
+ {
675
+ "name": "auroCheckbox-input",
676
+ "type": {
677
+ "text": "CustomEvent"
581
678
  }
582
679
  },
583
680
  {
584
- "kind": "method",
585
- "name": "configureCombobox",
586
- "description": "Binds all behavior needed to the combobox after rendering.",
587
- "privacy": "private",
588
- "return": {
589
- "type": {
590
- "text": "void"
591
- }
681
+ "name": "auroCheckbox-focusin",
682
+ "type": {
683
+ "text": "CustomEvent"
592
684
  }
593
685
  },
594
686
  {
595
- "kind": "method",
596
- "name": "focus",
597
- "description": "Focuses the combobox trigger input.",
598
- "return": {
599
- "type": {
600
- "text": "void"
601
- }
602
- }
603
- },
604
- {
605
- "kind": "method",
606
- "name": "setMenuValue",
607
- "parameters": [
608
- {
609
- "name": "value",
610
- "description": "The value to set on the menu.",
611
- "type": {
612
- "text": "string"
613
- }
614
- }
615
- ],
616
- "description": "Sets the menu value if menu is available.",
617
- "return": {
618
- "type": {
619
- "text": "void"
620
- }
621
- }
622
- },
623
- {
624
- "kind": "method",
625
- "name": "reset",
626
- "description": "Resets component to initial state.",
627
- "return": {
628
- "type": {
629
- "text": "void"
630
- }
631
- }
632
- },
633
- {
634
- "kind": "method",
635
- "name": "clear",
636
- "description": "Clears the current value of the combobox.",
637
- "return": {
638
- "type": {
639
- "text": "void"
640
- }
641
- }
642
- },
643
- {
644
- "kind": "method",
645
- "name": "validate",
646
- "parameters": [
647
- {
648
- "name": "force",
649
- "default": "false",
650
- "description": "Whether to force validation.",
651
- "optional": true,
652
- "type": {
653
- "text": "boolean"
654
- }
655
- }
656
- ],
657
- "description": "Validates value."
658
- },
659
- {
660
- "kind": "method",
661
- "name": "transportAssignedNodes",
662
- "parameters": [
663
- {
664
- "name": "slot",
665
- "description": "The slot element containing the nodes to apply.",
666
- "type": {
667
- "text": "HTMLSlotElement"
668
- }
669
- },
670
- {
671
- "name": "target",
672
- "description": "The target element to apply the nodes to.",
673
- "type": {
674
- "text": "HTMLElement"
675
- }
676
- },
677
- {
678
- "name": "newSlotName",
679
- "description": "The new slot name for the applied nodes.",
680
- "type": {
681
- "text": "string"
682
- }
683
- }
684
- ],
685
- "description": "Applies slotted nodes to a target element with a new slot name.",
686
- "privacy": "private",
687
- "return": {
688
- "type": {
689
- "text": "void"
690
- }
687
+ "name": "auroCheckbox-focusout",
688
+ "type": {
689
+ "text": "CustomEvent"
691
690
  }
692
691
  },
693
692
  {
694
- "kind": "method",
695
- "name": "updateActiveOption",
696
- "parameters": [
697
- {
698
- "name": "index",
699
- "description": "Index of the option to make active.",
700
- "type": {
701
- "text": "number"
702
- }
703
- }
704
- ],
705
- "description": "Updates the active option in the menu."
693
+ "description": "(Deprecated) Notifies when checked value is changed.",
694
+ "name": "change"
706
695
  },
707
696
  {
708
- "kind": "method",
709
- "name": "handleSlotChange",
710
- "parameters": [
711
- {
712
- "name": "event",
713
- "description": "`slotchange` event.",
714
- "type": {
715
- "text": "Event"
716
- }
717
- }
718
- ],
719
- "description": "Watch for slot changes and recalculate the menuoptions.",
720
- "privacy": "private",
721
- "return": {
722
- "type": {
723
- "text": "void"
724
- }
725
- }
726
- },
697
+ "description": "Notifies when when checked value is changed by user's interface.",
698
+ "name": "input"
699
+ }
700
+ ],
701
+ "attributes": [
727
702
  {
728
- "kind": "field",
729
703
  "name": "appearance",
730
- "privacy": "public",
731
704
  "type": {
732
- "text": "string"
705
+ "text": "'default' | 'inverse'"
733
706
  },
734
707
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
735
708
  "default": "'default'",
736
- "attribute": "appearance",
737
- "reflects": true
709
+ "fieldName": "appearance"
738
710
  },
739
711
  {
740
- "kind": "field",
741
- "name": "autocomplete",
742
- "privacy": "public",
712
+ "name": "checked",
743
713
  "type": {
744
- "text": "string"
714
+ "text": "boolean"
745
715
  },
746
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
747
- "attribute": "autocomplete",
748
- "reflects": true
716
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
717
+ "fieldName": "checked"
749
718
  },
750
719
  {
751
- "kind": "field",
752
- "name": "autoPlacement",
753
- "privacy": "public",
720
+ "name": "disabled",
754
721
  "type": {
755
722
  "text": "boolean"
756
723
  },
757
- "description": "If declared, bib's position will be automatically calculated where to appear.",
758
- "attribute": "autoPlacement",
759
- "reflects": true
724
+ "description": "If set to true, the checkbox will not be clickable.",
725
+ "fieldName": "disabled"
760
726
  },
761
727
  {
762
- "kind": "field",
763
- "name": "availableOptions",
764
- "privacy": "private",
728
+ "name": "error",
765
729
  "type": {
766
- "text": "array"
730
+ "text": "boolean"
767
731
  },
768
- "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
769
- "attribute": "availableOptions"
732
+ "description": "If set to true, the checkbox will be displayed with an error state.",
733
+ "fieldName": "error"
770
734
  },
771
735
  {
772
- "kind": "field",
773
- "name": "behavior",
774
- "privacy": "public",
736
+ "name": "id",
775
737
  "type": {
776
- "text": "'filter' | 'suggestion'"
738
+ "text": "string"
777
739
  },
778
- "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
779
- "default": "'suggestion'",
780
- "attribute": "behavior",
781
- "reflects": true
740
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
741
+ "fieldName": "id"
782
742
  },
783
743
  {
784
- "kind": "field",
785
- "name": "checkmark",
786
- "privacy": "public",
744
+ "name": "name",
787
745
  "type": {
788
- "text": "boolean"
746
+ "text": "string"
789
747
  },
790
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
791
- "attribute": "checkmark",
792
- "reflects": true
748
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
749
+ "fieldName": "name"
793
750
  },
794
751
  {
795
- "kind": "field",
796
- "name": "disabled",
797
- "privacy": "public",
752
+ "name": "onDark",
798
753
  "type": {
799
754
  "text": "boolean"
800
755
  },
801
- "description": "If set, disables the combobox.",
802
- "attribute": "disabled",
803
- "reflects": true
756
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
757
+ "fieldName": "onDark"
804
758
  },
805
759
  {
806
- "kind": "field",
807
- "name": "dropdownId",
808
- "privacy": "private",
760
+ "name": "value",
809
761
  "type": {
810
762
  "text": "string"
811
763
  },
812
- "description": "ID for the dropdown."
813
- },
814
- {
815
- "kind": "field",
816
- "name": "dropdownOpen",
817
- "privacy": "private",
818
- "type": {
819
- "text": "boolean"
820
- },
821
- "description": "Whether or not the dropdown is open."
764
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
765
+ "fieldName": "value"
822
766
  },
823
767
  {
824
- "kind": "field",
825
- "name": "dvInputOnly",
826
- "privacy": "public",
768
+ "name": "tabindex",
827
769
  "type": {
828
- "text": "boolean"
770
+ "text": "number"
829
771
  },
830
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
831
- "attribute": "dvInputOnly",
832
- "reflects": true
772
+ "description": "The tabindex attribute for the checkbox.",
773
+ "fieldName": "tabIndex"
833
774
  },
834
775
  {
835
- "kind": "field",
836
- "name": "error",
837
- "privacy": "public",
776
+ "name": "aria-checked",
838
777
  "type": {
839
778
  "text": "string"
840
779
  },
841
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
842
- "attribute": "error",
843
- "reflects": true
780
+ "description": "The aria-checked attribute for the checkbox.",
781
+ "fieldName": "ariaChecked"
844
782
  },
845
783
  {
846
- "kind": "field",
847
- "name": "format",
848
- "privacy": "public",
784
+ "name": "aria-disabled",
849
785
  "type": {
850
786
  "text": "string"
851
787
  },
852
- "description": "Specifies the input mask format.",
853
- "attribute": "format",
854
- "reflects": true
788
+ "description": "The aria-disabled attribute for the checkbox.",
789
+ "fieldName": "ariaDisabled"
855
790
  },
856
791
  {
857
- "kind": "field",
858
- "name": "inputmode",
859
- "privacy": "public",
792
+ "name": "role",
860
793
  "type": {
861
794
  "text": "string"
862
795
  },
863
- "description": "Exposes inputmode attribute for input.",
864
- "attribute": "inputmode",
865
- "reflects": true
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"
798
+ }
799
+ ],
800
+ "superclass": {
801
+ "name": "LitElement",
802
+ "package": "lit"
803
+ },
804
+ "tagName": "auro-checkbox",
805
+ "customElement": true
806
+ }
807
+ ],
808
+ "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
+ {
833
+ "kind": "js",
834
+ "name": "AuroCheckboxGroup",
835
+ "declaration": {
836
+ "name": "AuroCheckboxGroup",
837
+ "module": "components/checkbox/src/index.js"
838
+ }
839
+ }
840
+ ]
841
+ },
842
+ {
843
+ "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",
851
+ "declarations": [
852
+ {
853
+ "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"
866
860
  },
867
861
  {
868
- "kind": "field",
869
- "name": "layout",
870
- "privacy": "public",
871
- "type": {
872
- "text": "string"
873
- },
874
- "description": "Sets the layout of the combobox.",
875
- "default": "'classic'",
876
- "attribute": "layout",
877
- "reflects": true,
878
- "inheritedFrom": {
879
- "name": "AuroElement",
880
- "module": "components/layoutElement/src/auroElement.js"
862
+ "description": "Slot for the header content.",
863
+ "name": "header"
864
+ },
865
+ {
866
+ "description": "Slot for the subheader content.",
867
+ "name": "subheader"
868
+ },
869
+ {
870
+ "description": "Slot for the footer content.",
871
+ "name": "footer"
872
+ },
873
+ {
874
+ "description": "Slot for the close button aria-label.",
875
+ "name": "ariaLabel.close"
876
+ }
877
+ ],
878
+ "members": [
879
+ {
880
+ "kind": "method",
881
+ "name": "register",
882
+ "static": true,
883
+ "parameters": [
884
+ {
885
+ "name": "name",
886
+ "default": "\"auro-bibtemplate\"",
887
+ "description": "The name of element that you want to register to.",
888
+ "optional": true,
889
+ "type": {
890
+ "text": "string"
891
+ }
892
+ }
893
+ ],
894
+ "description": "This will register this element with the browser."
895
+ },
896
+ {
897
+ "kind": "method",
898
+ "name": "preventBodyScroll",
899
+ "parameters": [
900
+ {
901
+ "name": "event",
902
+ "description": "The touchmove event.",
903
+ "type": {
904
+ "text": "Event"
905
+ }
906
+ }
907
+ ],
908
+ "description": "Prevents scrolling of the body when touching empty areas of the component.",
909
+ "return": {
910
+ "type": {
911
+ "text": "void"
912
+ }
881
913
  }
882
914
  },
883
915
  {
884
- "kind": "field",
885
- "name": "matchWidth",
886
- "privacy": "private",
887
- "type": {
888
- "text": "boolean"
889
- },
890
- "description": "If declared, the popover and trigger will be set to the same width.",
891
- "attribute": "matchWidth",
892
- "reflects": true
916
+ "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.",
919
+ "return": {
920
+ "type": {
921
+ "text": "void"
922
+ }
923
+ }
924
+ },
925
+ {
926
+ "kind": "method",
927
+ "name": "onCloseButtonClick"
928
+ },
929
+ {
930
+ "kind": "method",
931
+ "name": "exposeCssParts",
932
+ "description": "Exposes CSS parts for styling from parent components.",
933
+ "return": {
934
+ "type": {
935
+ "text": "void"
936
+ }
937
+ }
893
938
  },
894
939
  {
895
940
  "kind": "field",
896
- "name": "noFilter",
941
+ "name": "large",
897
942
  "privacy": "public",
898
943
  "type": {
899
944
  "text": "boolean"
900
945
  },
901
- "description": "If set, combobox will not filter menuoptions based on input.",
902
- "attribute": "noFilter",
946
+ "default": "false",
947
+ "attribute": "large",
903
948
  "reflects": true
904
949
  },
905
950
  {
906
951
  "kind": "field",
907
- "name": "noFlip",
908
- "privacy": "public",
909
- "type": {
910
- "text": "boolean"
911
- },
912
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
913
- "attribute": "noFlip",
914
- "reflects": true
952
+ "name": "iconTag",
953
+ "privacy": "private"
915
954
  },
916
955
  {
917
956
  "kind": "field",
918
- "name": "shift",
919
- "privacy": "public",
920
- "type": {
921
- "text": "boolean"
922
- },
923
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
924
- "attribute": "shift",
925
- "reflects": true
957
+ "name": "headerTag",
958
+ "privacy": "private"
926
959
  },
927
960
  {
928
961
  "kind": "field",
929
- "name": "noValidate",
930
- "privacy": "public",
931
- "type": {
932
- "text": "boolean"
933
- },
934
- "description": "If set, disables auto-validation on blur.",
935
- "attribute": "noValidate",
936
- "reflects": true
962
+ "name": "buttonTag",
963
+ "privacy": "private"
937
964
  },
938
965
  {
939
966
  "kind": "field",
940
- "name": "offset",
967
+ "name": "isFullscreen",
941
968
  "privacy": "public",
942
969
  "type": {
943
- "text": "number"
970
+ "text": "boolean"
944
971
  },
945
- "description": "Gap between the trigger element and bib.",
946
- "default": "0",
947
- "attribute": "offset",
972
+ "attribute": "isFullscreen",
948
973
  "reflects": true
949
974
  },
950
975
  {
951
976
  "kind": "field",
952
- "name": "onDark",
977
+ "name": "showFooter",
953
978
  "privacy": "public",
954
979
  "type": {
955
980
  "text": "boolean"
956
981
  },
957
- "attribute": "onDark",
958
- "reflects": true,
959
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
960
- "inheritedFrom": {
961
- "name": "AuroElement",
962
- "module": "components/layoutElement/src/auroElement.js"
982
+ "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
983
+ "attribute": "showFooter",
984
+ "reflects": true
985
+ }
986
+ ],
987
+ "events": [
988
+ {
989
+ "name": "close-click",
990
+ "type": {
991
+ "text": "Event"
963
992
  }
964
993
  },
965
994
  {
966
- "kind": "field",
967
- "name": "optionSelected",
968
- "privacy": "public",
995
+ "name": "auro-bibtemplate-connected",
969
996
  "type": {
970
- "text": "HTMLElement"
997
+ "text": "CustomEvent"
998
+ }
999
+ }
1000
+ ],
1001
+ "attributes": [
1002
+ {
1003
+ "name": "isFullscreen",
1004
+ "type": {
1005
+ "text": "boolean"
971
1006
  },
972
- "description": "Specifies the current selected option.",
973
- "attribute": "optionSelected"
1007
+ "fieldName": "isFullscreen"
974
1008
  },
975
1009
  {
976
- "kind": "field",
977
- "name": "persistInput",
978
- "privacy": "public",
1010
+ "name": "large",
979
1011
  "type": {
980
1012
  "text": "boolean"
981
1013
  },
982
- "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
983
- "attribute": "persistInput",
984
- "reflects": true
1014
+ "default": "false",
1015
+ "fieldName": "large"
985
1016
  },
986
1017
  {
987
- "kind": "field",
988
- "name": "placement",
989
- "privacy": "public",
1018
+ "name": "showFooter",
990
1019
  "type": {
991
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1020
+ "text": "boolean"
992
1021
  },
993
- "description": "Position where the bib should appear relative to the trigger.",
994
- "default": "'bottom-start'",
995
- "attribute": "placement",
996
- "reflects": true
997
- },
998
- {
999
- "kind": "field",
1000
- "name": "placeholder",
1001
- "privacy": "public",
1002
- "type": {
1003
- "text": "string"
1004
- },
1005
- "description": "Define custom placeholder text, only supported by date input formats.",
1006
- "attribute": "placeholder",
1007
- "reflects": true
1008
- },
1009
- {
1010
- "kind": "field",
1011
- "name": "required",
1012
- "privacy": "public",
1013
- "type": {
1014
- "text": "boolean"
1015
- },
1016
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1017
- "attribute": "required",
1018
- "reflects": true
1019
- },
1020
- {
1021
- "kind": "field",
1022
- "name": "setCustomValidity",
1023
- "privacy": "public",
1024
- "type": {
1025
- "text": "string"
1026
- },
1027
- "description": "Sets a custom help text message to display for all validityStates.",
1028
- "attribute": "setCustomValidity"
1029
- },
1030
- {
1031
- "kind": "field",
1032
- "name": "setCustomValidityCustomError",
1033
- "privacy": "public",
1034
- "type": {
1035
- "text": "string"
1036
- },
1037
- "description": "Custom help text message to display when validity = `customError`.",
1038
- "attribute": "setCustomValidityCustomError"
1039
- },
1040
- {
1041
- "kind": "field",
1042
- "name": "setCustomValidityValueMissing",
1043
- "privacy": "public",
1044
- "type": {
1045
- "text": "string"
1046
- },
1047
- "description": "Custom help text message to display when validity = `valueMissing`.",
1048
- "attribute": "setCustomValidityValueMissing"
1049
- },
1050
- {
1051
- "kind": "field",
1052
- "name": "setCustomValidityValueMissingFilter",
1053
- "privacy": "public",
1054
- "type": {
1055
- "text": "string"
1056
- },
1057
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1058
- "attribute": "setCustomValidityValueMissingFilter"
1059
- },
1060
- {
1061
- "kind": "field",
1062
- "name": "touched",
1063
- "privacy": "private",
1064
- "type": {
1065
- "text": "boolean"
1066
- },
1067
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1068
- },
1069
- {
1070
- "kind": "field",
1071
- "name": "triggerIcon",
1072
- "privacy": "public",
1073
- "type": {
1074
- "text": "boolean"
1075
- },
1076
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1077
- "attribute": "triggerIcon",
1078
- "reflects": true
1079
- },
1080
- {
1081
- "kind": "field",
1082
- "name": "type",
1083
- "privacy": "public",
1084
- "type": {
1085
- "text": "string"
1086
- },
1087
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1088
- "attribute": "type",
1089
- "reflects": true
1090
- },
1091
- {
1092
- "kind": "field",
1093
- "name": "typedValue",
1094
- "privacy": "public",
1095
- "type": {
1096
- "text": "string"
1097
- },
1098
- "description": "Specifies the value of the input element within the combobox.",
1099
- "attribute": "typedValue",
1100
- "reflects": true
1101
- },
1102
- {
1103
- "kind": "field",
1104
- "name": "validity",
1105
- "privacy": "public",
1106
- "type": {
1107
- "text": "string"
1108
- },
1109
- "description": "Specifies the `validityState` this element is in.",
1110
- "attribute": "validity",
1111
- "reflects": true
1112
- },
1113
- {
1114
- "kind": "field",
1115
- "name": "value",
1116
- "privacy": "public",
1117
- "type": {
1118
- "text": "string"
1119
- },
1120
- "description": "Value selected for the dropdown menu.",
1121
- "attribute": "value"
1122
- },
1123
- {
1124
- "kind": "field",
1125
- "name": "largeFullscreenHeadline",
1126
- "privacy": "public",
1127
- "type": {
1128
- "text": "boolean"
1129
- },
1130
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1131
- "attribute": "largeFullscreenHeadline",
1132
- "reflects": true
1133
- },
1134
- {
1135
- "kind": "field",
1136
- "name": "fullscreenBreakpoint",
1137
- "privacy": "public",
1138
- "type": {
1139
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1140
- },
1141
- "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
1142
- "default": "'sm'",
1143
- "attribute": "fullscreenBreakpoint",
1144
- "reflects": true
1145
- },
1146
- {
1147
- "kind": "field",
1148
- "name": "optionActive",
1149
- "privacy": "private",
1150
- "type": {
1151
- "text": "object"
1152
- },
1153
- "description": "Specifies the currently active option."
1154
- },
1155
- {
1156
- "kind": "field",
1157
- "name": "triggerExpandedState",
1158
- "privacy": "private",
1159
- "type": {
1160
- "text": "boolean"
1161
- },
1162
- "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1163
- },
1164
- {
1165
- "kind": "field",
1166
- "name": "componentHasFocus",
1167
- "description": "Returns true if the element has focus.",
1168
- "privacy": "private",
1169
- "return": {
1170
- "type": {
1171
- "text": "boolean"
1172
- }
1173
- },
1174
- "readonly": true,
1175
- "inheritedFrom": {
1176
- "name": "AuroElement",
1177
- "module": "components/layoutElement/src/auroElement.js"
1178
- }
1179
- },
1180
- {
1181
- "kind": "method",
1182
- "name": "resetShapeClasses",
1183
- "inheritedFrom": {
1184
- "name": "AuroElement",
1185
- "module": "components/layoutElement/src/auroElement.js"
1186
- }
1187
- },
1188
- {
1189
- "kind": "method",
1190
- "name": "resetLayoutClasses",
1191
- "inheritedFrom": {
1192
- "name": "AuroElement",
1193
- "module": "components/layoutElement/src/auroElement.js"
1194
- }
1195
- },
1196
- {
1197
- "kind": "method",
1198
- "name": "updateComponentArchitecture",
1199
- "inheritedFrom": {
1200
- "name": "AuroElement",
1201
- "module": "components/layoutElement/src/auroElement.js"
1202
- }
1203
- },
1204
- {
1205
- "kind": "field",
1206
- "name": "shape",
1207
- "privacy": "public",
1208
- "type": {
1209
- "text": "string"
1210
- },
1211
- "attribute": "shape",
1212
- "reflects": true,
1213
- "inheritedFrom": {
1214
- "name": "AuroElement",
1215
- "module": "components/layoutElement/src/auroElement.js"
1216
- }
1217
- },
1218
- {
1219
- "kind": "field",
1220
- "name": "size",
1221
- "privacy": "public",
1222
- "type": {
1223
- "text": "string"
1224
- },
1225
- "attribute": "size",
1226
- "reflects": true,
1227
- "inheritedFrom": {
1228
- "name": "AuroElement",
1229
- "module": "components/layoutElement/src/auroElement.js"
1230
- }
1231
- }
1232
- ],
1233
- "events": [
1234
- {
1235
- "name": "inputValue",
1236
- "type": {
1237
- "text": "CustomEvent"
1238
- },
1239
- "description": "Notifies that the components internal HTML5 input value has changed."
1240
- },
1241
- {
1242
- "name": "input",
1243
- "type": {
1244
- "text": "CustomEvent"
1245
- },
1246
- "description": "Notifies that the component has a new value set."
1247
- },
1248
- {
1249
- "name": "auroCombobox-valueSet",
1250
- "type": {
1251
- "text": "CustomEvent"
1252
- },
1253
- "description": "(Deprecated) Notifies that the component has a new value set."
1254
- },
1255
- {
1256
- "description": "Notifies that the component value(s) have been validated.",
1257
- "name": "auroFormElement-validated"
1022
+ "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
1023
+ "fieldName": "showFooter"
1258
1024
  }
1259
1025
  ],
1260
- "attributes": [
1261
- {
1262
- "name": "appearance",
1263
- "type": {
1264
- "text": "string"
1265
- },
1266
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1267
- "default": "'default'",
1268
- "fieldName": "appearance"
1269
- },
1270
- {
1271
- "name": "autocomplete",
1272
- "type": {
1273
- "text": "string"
1274
- },
1275
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1276
- "fieldName": "autocomplete"
1277
- },
1278
- {
1279
- "name": "autoPlacement",
1280
- "type": {
1281
- "text": "boolean"
1282
- },
1283
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1284
- "fieldName": "autoPlacement"
1285
- },
1286
- {
1287
- "name": "availableOptions",
1288
- "type": {
1289
- "text": "array"
1290
- },
1291
- "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
1292
- "fieldName": "availableOptions"
1293
- },
1294
- {
1295
- "name": "behavior",
1296
- "type": {
1297
- "text": "'filter' | 'suggestion'"
1298
- },
1299
- "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
1300
- "default": "'suggestion'",
1301
- "fieldName": "behavior"
1302
- },
1303
- {
1304
- "name": "checkmark",
1305
- "type": {
1306
- "text": "boolean"
1307
- },
1308
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1309
- "fieldName": "checkmark"
1310
- },
1311
- {
1312
- "name": "disabled",
1313
- "type": {
1314
- "text": "boolean"
1315
- },
1316
- "description": "If set, disables the combobox.",
1317
- "fieldName": "disabled"
1318
- },
1319
- {
1320
- "name": "dvInputOnly",
1321
- "type": {
1322
- "text": "boolean"
1323
- },
1324
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1325
- "fieldName": "dvInputOnly"
1326
- },
1327
- {
1328
- "name": "error",
1329
- "type": {
1330
- "text": "string"
1331
- },
1332
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1333
- "fieldName": "error"
1334
- },
1335
- {
1336
- "name": "format",
1337
- "type": {
1338
- "text": "string"
1339
- },
1340
- "description": "Specifies the input mask format.",
1341
- "fieldName": "format"
1342
- },
1343
- {
1344
- "name": "inputmode",
1345
- "type": {
1346
- "text": "string"
1347
- },
1348
- "description": "Exposes inputmode attribute for input.",
1349
- "fieldName": "inputmode"
1350
- },
1026
+ "superclass": {
1027
+ "name": "LitElement",
1028
+ "package": "lit"
1029
+ },
1030
+ "tagName": "auro-bibtemplate",
1031
+ "customElement": true
1032
+ }
1033
+ ],
1034
+ "exports": [
1035
+ {
1036
+ "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",
1083
+ "declaration": {
1084
+ "name": "9.2.0",
1085
+ "module": "components/bibtemplate/src/iconVersion.js"
1086
+ }
1087
+ }
1088
+ ]
1089
+ },
1090
+ {
1091
+ "kind": "javascript-module",
1092
+ "path": "components/bibtemplate/src/index.js",
1093
+ "declarations": [],
1094
+ "exports": [
1095
+ {
1096
+ "kind": "js",
1097
+ "name": "AuroBibtemplate",
1098
+ "declaration": {
1099
+ "name": "AuroBibtemplate",
1100
+ "module": "components/bibtemplate/src/index.js"
1101
+ }
1102
+ }
1103
+ ]
1104
+ },
1105
+ {
1106
+ "kind": "javascript-module",
1107
+ "path": "components/bibtemplate/src/registered.js",
1108
+ "declarations": [],
1109
+ "exports": []
1110
+ },
1111
+ {
1112
+ "kind": "javascript-module",
1113
+ "path": "components/combobox/src/auro-combobox.js",
1114
+ "declarations": [
1115
+ {
1116
+ "kind": "class",
1117
+ "description": "The `auro-combobox` element provides users with a way to select an option from a list of filtered or suggested options based on user input.",
1118
+ "name": "AuroCombobox",
1119
+ "slots": [
1351
1120
  {
1352
- "name": "layout",
1353
- "type": {
1354
- "text": "string"
1355
- },
1356
- "description": "Sets the layout of the combobox.",
1357
- "default": "'classic'",
1358
- "fieldName": "layout",
1359
- "inheritedFrom": {
1360
- "name": "AuroElement",
1361
- "module": "components/layoutElement/src/auroElement.js"
1362
- }
1121
+ "description": "Default slot for the menu content.",
1122
+ "name": ""
1363
1123
  },
1364
1124
  {
1365
- "name": "matchWidth",
1366
1125
  "type": {
1367
- "text": "boolean"
1126
+ "text": "HTMLSlotElement"
1368
1127
  },
1369
- "description": "If declared, the popover and trigger will be set to the same width.",
1370
- "fieldName": "matchWidth"
1128
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1129
+ "name": "optionalLabel"
1371
1130
  },
1372
1131
  {
1373
- "name": "noFilter",
1374
- "type": {
1375
- "text": "boolean"
1376
- },
1377
- "description": "If set, combobox will not filter menuoptions based on input.",
1378
- "fieldName": "noFilter"
1132
+ "description": "Sets aria-label on clear button",
1133
+ "name": "ariaLabel.input.clear"
1379
1134
  },
1380
1135
  {
1381
- "name": "noFlip",
1382
- "type": {
1383
- "text": "boolean"
1384
- },
1385
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1386
- "fieldName": "noFlip"
1136
+ "description": "Sets aria-label on close button in fullscreen bib",
1137
+ "name": "ariaLabel.bib.close"
1387
1138
  },
1388
1139
  {
1389
- "name": "shift",
1390
- "type": {
1391
- "text": "boolean"
1392
- },
1393
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1394
- "fieldName": "shift"
1140
+ "description": "Defines the headline to display above menu-options",
1141
+ "name": "bib.fullscreen.headline"
1395
1142
  },
1396
1143
  {
1397
- "name": "noValidate",
1398
- "type": {
1399
- "text": "boolean"
1400
- },
1401
- "description": "If set, disables auto-validation on blur.",
1402
- "fieldName": "noValidate"
1144
+ "description": "Defines the content of the label.",
1145
+ "name": "label"
1403
1146
  },
1404
1147
  {
1405
- "name": "offset",
1406
- "type": {
1407
- "text": "number"
1408
- },
1409
- "description": "Gap between the trigger element and bib.",
1410
- "default": "0",
1411
- "fieldName": "offset"
1148
+ "description": "Defines the content of the helpText.",
1149
+ "name": "helpText"
1412
1150
  },
1413
1151
  {
1414
- "name": "onDark",
1415
- "type": {
1416
- "text": "boolean"
1417
- },
1418
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1419
- "fieldName": "onDark"
1420
- },
1152
+ "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
1153
+ "name": "displayValue"
1154
+ }
1155
+ ],
1156
+ "members": [
1421
1157
  {
1422
- "name": "optionSelected",
1423
- "type": {
1424
- "text": "HTMLElement"
1425
- },
1426
- "description": "Specifies the current selected option.",
1427
- "fieldName": "optionSelected"
1158
+ "kind": "method",
1159
+ "name": "_initializeDefaults",
1160
+ "privacy": "private",
1161
+ "return": {
1162
+ "type": {
1163
+ "text": "void"
1164
+ }
1165
+ }
1428
1166
  },
1429
1167
  {
1430
- "name": "persistInput",
1431
- "type": {
1432
- "text": "boolean"
1168
+ "kind": "field",
1169
+ "name": "inputValue",
1170
+ "description": "Returns the current value of the input element within the combobox.",
1171
+ "return": {
1172
+ "type": {
1173
+ "text": "string|undefined"
1174
+ }
1433
1175
  },
1434
- "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
1435
- "fieldName": "persistInput"
1176
+ "readonly": true
1436
1177
  },
1437
1178
  {
1438
- "name": "placement",
1439
- "type": {
1440
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1441
- },
1442
- "description": "Position where the bib should appear relative to the trigger.",
1443
- "default": "'bottom-start'",
1444
- "fieldName": "placement"
1179
+ "kind": "method",
1180
+ "name": "isValid",
1181
+ "description": "Checks if the element is valid.",
1182
+ "return": {
1183
+ "type": {
1184
+ "text": "boolean"
1185
+ }
1186
+ }
1445
1187
  },
1446
1188
  {
1447
- "name": "placeholder",
1448
- "type": {
1449
- "text": "string"
1450
- },
1451
- "description": "Define custom placeholder text, only supported by date input formats.",
1452
- "fieldName": "placeholder"
1189
+ "kind": "method",
1190
+ "name": "register",
1191
+ "static": true,
1192
+ "parameters": [
1193
+ {
1194
+ "name": "name",
1195
+ "default": "'auro-combobox'",
1196
+ "description": "The name of the element that you want to register.",
1197
+ "optional": true,
1198
+ "type": {
1199
+ "text": "string"
1200
+ }
1201
+ }
1202
+ ],
1203
+ "description": "This will register this element with the browser."
1453
1204
  },
1454
1205
  {
1455
- "name": "required",
1456
- "type": {
1457
- "text": "boolean"
1458
- },
1459
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1460
- "fieldName": "required"
1206
+ "kind": "method",
1207
+ "name": "activateFirstEnabledAvailableOption",
1208
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
1209
+ "privacy": "private",
1210
+ "return": {
1211
+ "type": {
1212
+ "text": "void"
1213
+ }
1214
+ }
1461
1215
  },
1462
1216
  {
1463
- "name": "setCustomValidity",
1464
- "type": {
1465
- "text": "string"
1466
- },
1467
- "description": "Sets a custom help text message to display for all validityStates.",
1468
- "fieldName": "setCustomValidity"
1217
+ "kind": "method",
1218
+ "name": "activateLastEnabledAvailableOption",
1219
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
1220
+ "privacy": "private",
1221
+ "return": {
1222
+ "type": {
1223
+ "text": "void"
1224
+ }
1225
+ }
1469
1226
  },
1470
1227
  {
1471
- "name": "setCustomValidityCustomError",
1472
- "type": {
1473
- "text": "string"
1474
- },
1475
- "description": "Custom help text message to display when validity = `customError`.",
1476
- "fieldName": "setCustomValidityCustomError"
1228
+ "kind": "method",
1229
+ "name": "updateFilter",
1230
+ "description": "Updates the filter for the available options based on the input value.",
1231
+ "privacy": "private"
1477
1232
  },
1478
1233
  {
1479
- "name": "setCustomValidityValueMissing",
1480
- "type": {
1481
- "text": "string"
1482
- },
1483
- "description": "Custom help text message to display when validity = `valueMissing`.",
1484
- "fieldName": "setCustomValidityValueMissing"
1234
+ "kind": "method",
1235
+ "name": "syncValuesAndStates",
1236
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1237
+ "privacy": "private",
1238
+ "return": {
1239
+ "type": {
1240
+ "text": "void"
1241
+ }
1242
+ }
1485
1243
  },
1486
1244
  {
1487
- "name": "setCustomValidityValueMissingFilter",
1488
- "type": {
1489
- "text": "string"
1490
- },
1491
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1492
- "fieldName": "setCustomValidityValueMissingFilter"
1245
+ "kind": "method",
1246
+ "name": "updateTriggerTextDisplay",
1247
+ "parameters": [
1248
+ {
1249
+ "name": "label",
1250
+ "description": "The label of the selected option.",
1251
+ "type": {
1252
+ "text": "string"
1253
+ }
1254
+ }
1255
+ ],
1256
+ "description": "Update displayValue or input.value, it's called when making a selection.",
1257
+ "privacy": "private"
1493
1258
  },
1494
1259
  {
1495
- "name": "triggerIcon",
1496
- "type": {
1497
- "text": "boolean"
1498
- },
1499
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1500
- "fieldName": "triggerIcon"
1260
+ "kind": "method",
1261
+ "name": "handleMenuOptions",
1262
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1263
+ "privacy": "private",
1264
+ "return": {
1265
+ "type": {
1266
+ "text": "void"
1267
+ }
1268
+ }
1501
1269
  },
1502
1270
  {
1503
- "name": "type",
1504
- "type": {
1505
- "text": "string"
1506
- },
1507
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1508
- "fieldName": "type"
1271
+ "kind": "method",
1272
+ "name": "generateOptionsArray",
1273
+ "description": "Determines the element error state based on the `required` attribute and input value.",
1274
+ "privacy": "private",
1275
+ "return": {
1276
+ "type": {
1277
+ "text": "void"
1278
+ }
1279
+ }
1509
1280
  },
1510
1281
  {
1511
- "name": "typedValue",
1512
- "type": {
1513
- "text": "string"
1514
- },
1515
- "description": "Specifies the value of the input element within the combobox.",
1516
- "fieldName": "typedValue"
1282
+ "kind": "method",
1283
+ "name": "hideBib",
1284
+ "description": "Hides the dropdown bib if its open.",
1285
+ "return": {
1286
+ "type": {
1287
+ "text": "void"
1288
+ }
1289
+ }
1517
1290
  },
1518
1291
  {
1519
- "name": "validity",
1520
- "type": {
1521
- "text": "string"
1522
- },
1523
- "description": "Specifies the `validityState` this element is in.",
1524
- "fieldName": "validity"
1292
+ "kind": "method",
1293
+ "name": "showBib",
1294
+ "description": "Shows the dropdown bib if there are options to show.",
1295
+ "return": {
1296
+ "type": {
1297
+ "text": "void"
1298
+ }
1299
+ }
1525
1300
  },
1526
1301
  {
1527
- "name": "value",
1528
- "type": {
1529
- "text": "string"
1530
- },
1531
- "description": "Value selected for the dropdown menu.",
1532
- "fieldName": "value"
1302
+ "kind": "method",
1303
+ "name": "configureDropdown",
1304
+ "description": "Binds all behavior needed to the dropdown after rendering.",
1305
+ "privacy": "private",
1306
+ "return": {
1307
+ "type": {
1308
+ "text": "void"
1309
+ }
1310
+ }
1533
1311
  },
1534
1312
  {
1535
- "name": "largeFullscreenHeadline",
1536
- "type": {
1537
- "text": "boolean"
1538
- },
1539
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1540
- "fieldName": "largeFullscreenHeadline"
1313
+ "kind": "method",
1314
+ "name": "setClearBtnFocus",
1315
+ "privacy": "private"
1541
1316
  },
1542
1317
  {
1543
- "name": "fullscreenBreakpoint",
1544
- "type": {
1545
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1546
- },
1547
- "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
1548
- "default": "'sm'",
1549
- "fieldName": "fullscreenBreakpoint"
1318
+ "kind": "method",
1319
+ "name": "setTriggerInputFocus",
1320
+ "privacy": "private"
1550
1321
  },
1551
1322
  {
1552
- "name": "shape",
1553
- "type": {
1554
- "text": "string"
1555
- },
1556
- "fieldName": "shape",
1557
- "inheritedFrom": {
1558
- "name": "AuroElement",
1559
- "module": "components/layoutElement/src/auroElement.js"
1560
- }
1323
+ "kind": "method",
1324
+ "name": "setInputFocus",
1325
+ "privacy": "private"
1561
1326
  },
1562
1327
  {
1563
- "name": "size",
1564
- "type": {
1565
- "text": "string"
1566
- },
1567
- "fieldName": "size",
1568
- "inheritedFrom": {
1569
- "name": "AuroElement",
1570
- "module": "components/layoutElement/src/auroElement.js"
1571
- }
1328
+ "kind": "method",
1329
+ "name": "updateBibDialogRole",
1330
+ "description": "Suppresses or restores dialog semantics on the bib's dialog element.\nOn desktop (non-fullscreen), VoiceOver verbosely announces \"listbox inside\nof a dialog\" which disrupts combobox usage. Setting role=\"presentation\"\nsuppresses this. In fullscreen mode, dialog semantics are restored.",
1331
+ "privacy": "private"
1572
1332
  },
1573
1333
  {
1574
- "name": "ondark",
1575
- "type": {
1576
- "text": "boolean"
1577
- },
1578
- "fieldName": "onDark",
1579
- "inheritedFrom": {
1580
- "name": "AuroElement",
1581
- "module": "components/layoutElement/src/auroElement.js"
1582
- }
1583
- }
1584
- ],
1585
- "superclass": {
1586
- "name": "AuroElement",
1587
- "module": "/components/layoutElement/src/auroElement.js"
1588
- },
1589
- "tagName": "auro-combobox",
1590
- "customElement": true
1591
- }
1592
- ],
1593
- "exports": [
1594
- {
1595
- "kind": "js",
1596
- "name": "AuroCombobox",
1597
- "declaration": {
1598
- "name": "AuroCombobox",
1599
- "module": "components/combobox/src/auro-combobox.js"
1600
- }
1601
- }
1602
- ]
1603
- },
1604
- {
1605
- "kind": "javascript-module",
1606
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1607
- "declarations": [
1608
- {
1609
- "kind": "variable",
1610
- "name": "comboboxKeyboardStrategy",
1611
- "type": {
1612
- "text": "object"
1613
- },
1614
- "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { navigateArrow(component, 'down'); } } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
1615
- }
1616
- ],
1617
- "exports": [
1618
- {
1619
- "kind": "js",
1620
- "name": "comboboxKeyboardStrategy",
1621
- "declaration": {
1622
- "name": "comboboxKeyboardStrategy",
1623
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1624
- }
1625
- }
1626
- ]
1627
- },
1628
- {
1629
- "kind": "javascript-module",
1630
- "path": "components/combobox/src/index.js",
1631
- "declarations": [],
1632
- "exports": [
1633
- {
1634
- "kind": "js",
1635
- "name": "AuroCombobox",
1636
- "declaration": {
1637
- "name": "AuroCombobox",
1638
- "module": "components/combobox/src/index.js"
1639
- }
1640
- }
1641
- ]
1642
- },
1643
- {
1644
- "kind": "javascript-module",
1645
- "path": "components/combobox/src/registered.js",
1646
- "declarations": [],
1647
- "exports": [
1648
- {
1649
- "kind": "js",
1650
- "name": "AuroCombobox",
1651
- "declaration": {
1652
- "name": "AuroCombobox",
1653
- "module": "components/combobox/src/registered.js"
1654
- }
1655
- }
1656
- ]
1657
- },
1658
- {
1659
- "kind": "javascript-module",
1660
- "path": "components/checkbox/src/auro-checkbox-group.js",
1661
- "declarations": [
1662
- {
1663
- "kind": "class",
1664
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1665
- "name": "AuroCheckboxGroup",
1666
- "slots": [
1667
- {
1668
- "description": "Allows for the legend to be overridden.",
1669
- "name": "legend"
1334
+ "kind": "method",
1335
+ "name": "updateMenuShapeSize",
1336
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1337
+ "privacy": "private"
1670
1338
  },
1671
1339
  {
1672
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1673
- "name": "optionalLabel"
1340
+ "kind": "method",
1341
+ "name": "_getAnnouncementRoot",
1342
+ "description": "Returns the shadow root containing the live region for screen reader announcements.\nWhen the bib is open in fullscreen modal mode, everything outside the <dialog>\nis inert, so we target the bib's own shadow root instead of the host's.",
1343
+ "privacy": "private",
1344
+ "return": {
1345
+ "type": {
1346
+ "text": "ShadowRoot"
1347
+ }
1348
+ }
1674
1349
  },
1675
1350
  {
1676
- "description": "Allows for the helper text to be overridden.",
1677
- "name": "helpText"
1351
+ "kind": "method",
1352
+ "name": "configureMenu",
1353
+ "description": "Binds all behavior needed to the menu after rendering.",
1354
+ "privacy": "private",
1355
+ "return": {
1356
+ "type": {
1357
+ "text": "void"
1358
+ }
1359
+ }
1678
1360
  },
1679
- {
1680
- "description": "The default slot for the checkbox items.",
1681
- "name": "default"
1682
- }
1683
- ],
1684
- "members": [
1685
1361
  {
1686
1362
  "kind": "method",
1687
- "name": "_initializeDefaults"
1363
+ "name": "configureInput",
1364
+ "description": "Binds all behavior needed to the input after rendering.",
1365
+ "privacy": "private",
1366
+ "return": {
1367
+ "type": {
1368
+ "text": "void"
1369
+ }
1370
+ }
1688
1371
  },
1689
1372
  {
1690
1373
  "kind": "method",
1691
- "name": "register",
1692
- "static": true,
1374
+ "name": "handleMenuLoadingChange",
1693
1375
  "parameters": [
1694
1376
  {
1695
- "name": "name",
1696
- "default": "\"auro-checkbox-group\"",
1697
- "description": "The name of the element that you want to register.",
1698
- "optional": true,
1377
+ "name": "event",
1378
+ "description": "The event object containing details about the loading state change.",
1699
1379
  "type": {
1700
- "text": "string"
1380
+ "text": "CustomEvent"
1381
+ }
1382
+ },
1383
+ {
1384
+ "description": "Indicates whether the menu is currently loading.",
1385
+ "name": "event.detail.loading",
1386
+ "type": {
1387
+ "text": "boolean"
1388
+ }
1389
+ },
1390
+ {
1391
+ "description": "Indicates if there are loading placeholders present.",
1392
+ "name": "event.detail.hasLoadingPlaceholder",
1393
+ "type": {
1394
+ "text": "boolean"
1701
1395
  }
1702
1396
  }
1703
- ],
1704
- "description": "This will register this element with the browser."
1397
+ ],
1398
+ "description": "Manages the visibility of the dropdown based on loading state changes.\n\nThis method listens for loading state changes and adjusts the visibility of the dropdown accordingly.\nIf the dropdown is visible and loading is true without any loading placeholders, it hides the dropdown\nand sets a flag to indicate it is hidden while loading. If loading is false and the dropdown was previously\nhidden, it checks if the active element is within the dropdown and shows it again if true.",
1399
+ "privacy": "private",
1400
+ "return": {
1401
+ "type": {
1402
+ "text": "void"
1403
+ }
1404
+ }
1705
1405
  },
1706
1406
  {
1707
1407
  "kind": "method",
1708
- "name": "handleValueUpdate",
1408
+ "name": "handleInputValueChange",
1709
1409
  "parameters": [
1710
1410
  {
1711
- "name": "value",
1712
- "description": "The value of the checkbox.",
1713
- "type": {
1714
- "text": "String"
1715
- }
1716
- },
1717
- {
1718
- "name": "selected",
1719
- "description": "The checked state of the checkbox.",
1411
+ "name": "event",
1412
+ "description": "The input event triggered by the input element.",
1720
1413
  "type": {
1721
- "text": "Boolean"
1414
+ "text": "Event"
1722
1415
  }
1723
1416
  }
1724
1417
  ],
1725
- "description": "Helper method to handle checkbox value changing.",
1418
+ "description": "Handle changes to the input value and trigger changes that should result.",
1726
1419
  "privacy": "private",
1727
1420
  "return": {
1728
1421
  "type": {
@@ -1732,8 +1425,8 @@
1732
1425
  },
1733
1426
  {
1734
1427
  "kind": "method",
1735
- "name": "handlePreselectedItems",
1736
- "description": "Helper method that handles the state of preselected checkboxes.",
1428
+ "name": "configureCombobox",
1429
+ "description": "Binds all behavior needed to the combobox after rendering.",
1737
1430
  "privacy": "private",
1738
1431
  "return": {
1739
1432
  "type": {
@@ -1743,9 +1436,27 @@
1743
1436
  },
1744
1437
  {
1745
1438
  "kind": "method",
1746
- "name": "handleItems",
1747
- "description": "Helper method that handles the state of checkboxes.",
1748
- "privacy": "private",
1439
+ "name": "focus",
1440
+ "description": "Focuses the combobox trigger input.",
1441
+ "return": {
1442
+ "type": {
1443
+ "text": "void"
1444
+ }
1445
+ }
1446
+ },
1447
+ {
1448
+ "kind": "method",
1449
+ "name": "setMenuValue",
1450
+ "parameters": [
1451
+ {
1452
+ "name": "value",
1453
+ "description": "The value to set on the menu.",
1454
+ "type": {
1455
+ "text": "string"
1456
+ }
1457
+ }
1458
+ ],
1459
+ "description": "Sets the menu value if menu is available.",
1749
1460
  "return": {
1750
1461
  "type": {
1751
1462
  "text": "void"
@@ -1762,6 +1473,16 @@
1762
1473
  }
1763
1474
  }
1764
1475
  },
1476
+ {
1477
+ "kind": "method",
1478
+ "name": "clear",
1479
+ "description": "Clears the current value of the combobox.",
1480
+ "return": {
1481
+ "type": {
1482
+ "text": "void"
1483
+ }
1484
+ }
1485
+ },
1765
1486
  {
1766
1487
  "kind": "method",
1767
1488
  "name": "validate",
@@ -1778,49 +1499,272 @@
1778
1499
  ],
1779
1500
  "description": "Validates value."
1780
1501
  },
1502
+ {
1503
+ "kind": "method",
1504
+ "name": "transportAssignedNodes",
1505
+ "parameters": [
1506
+ {
1507
+ "name": "slot",
1508
+ "description": "The slot element containing the nodes to apply.",
1509
+ "type": {
1510
+ "text": "HTMLSlotElement"
1511
+ }
1512
+ },
1513
+ {
1514
+ "name": "target",
1515
+ "description": "The target element to apply the nodes to.",
1516
+ "type": {
1517
+ "text": "HTMLElement"
1518
+ }
1519
+ },
1520
+ {
1521
+ "name": "newSlotName",
1522
+ "description": "The new slot name for the applied nodes.",
1523
+ "type": {
1524
+ "text": "string"
1525
+ }
1526
+ }
1527
+ ],
1528
+ "description": "Applies slotted nodes to a target element with a new slot name.",
1529
+ "privacy": "private",
1530
+ "return": {
1531
+ "type": {
1532
+ "text": "void"
1533
+ }
1534
+ }
1535
+ },
1536
+ {
1537
+ "kind": "method",
1538
+ "name": "updateActiveOption",
1539
+ "parameters": [
1540
+ {
1541
+ "name": "index",
1542
+ "description": "Index of the option to make active.",
1543
+ "type": {
1544
+ "text": "number"
1545
+ }
1546
+ }
1547
+ ],
1548
+ "description": "Updates the active option in the menu."
1549
+ },
1550
+ {
1551
+ "kind": "method",
1552
+ "name": "handleSlotChange",
1553
+ "parameters": [
1554
+ {
1555
+ "name": "event",
1556
+ "description": "`slotchange` event.",
1557
+ "type": {
1558
+ "text": "Event"
1559
+ }
1560
+ }
1561
+ ],
1562
+ "description": "Watch for slot changes and recalculate the menuoptions.",
1563
+ "privacy": "private",
1564
+ "return": {
1565
+ "type": {
1566
+ "text": "void"
1567
+ }
1568
+ }
1569
+ },
1570
+ {
1571
+ "kind": "field",
1572
+ "name": "appearance",
1573
+ "privacy": "public",
1574
+ "type": {
1575
+ "text": "string"
1576
+ },
1577
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1578
+ "default": "'default'",
1579
+ "attribute": "appearance",
1580
+ "reflects": true
1581
+ },
1582
+ {
1583
+ "kind": "field",
1584
+ "name": "autocomplete",
1585
+ "privacy": "public",
1586
+ "type": {
1587
+ "text": "string"
1588
+ },
1589
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1590
+ "attribute": "autocomplete",
1591
+ "reflects": true
1592
+ },
1593
+ {
1594
+ "kind": "field",
1595
+ "name": "autoPlacement",
1596
+ "privacy": "public",
1597
+ "type": {
1598
+ "text": "boolean"
1599
+ },
1600
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1601
+ "attribute": "autoPlacement",
1602
+ "reflects": true
1603
+ },
1604
+ {
1605
+ "kind": "field",
1606
+ "name": "availableOptions",
1607
+ "privacy": "private",
1608
+ "type": {
1609
+ "text": "array"
1610
+ },
1611
+ "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
1612
+ "attribute": "availableOptions"
1613
+ },
1614
+ {
1615
+ "kind": "field",
1616
+ "name": "behavior",
1617
+ "privacy": "public",
1618
+ "type": {
1619
+ "text": "'filter' | 'suggestion'"
1620
+ },
1621
+ "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
1622
+ "default": "'suggestion'",
1623
+ "attribute": "behavior",
1624
+ "reflects": true
1625
+ },
1626
+ {
1627
+ "kind": "field",
1628
+ "name": "checkmark",
1629
+ "privacy": "public",
1630
+ "type": {
1631
+ "text": "boolean"
1632
+ },
1633
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1634
+ "attribute": "checkmark",
1635
+ "reflects": true
1636
+ },
1637
+ {
1638
+ "kind": "field",
1639
+ "name": "disabled",
1640
+ "privacy": "public",
1641
+ "type": {
1642
+ "text": "boolean"
1643
+ },
1644
+ "description": "If set, disables the combobox.",
1645
+ "attribute": "disabled",
1646
+ "reflects": true
1647
+ },
1648
+ {
1649
+ "kind": "field",
1650
+ "name": "dropdownId",
1651
+ "privacy": "private",
1652
+ "type": {
1653
+ "text": "string"
1654
+ },
1655
+ "description": "ID for the dropdown."
1656
+ },
1657
+ {
1658
+ "kind": "field",
1659
+ "name": "dropdownOpen",
1660
+ "privacy": "private",
1661
+ "type": {
1662
+ "text": "boolean"
1663
+ },
1664
+ "description": "Whether or not the dropdown is open."
1665
+ },
1666
+ {
1667
+ "kind": "field",
1668
+ "name": "dvInputOnly",
1669
+ "privacy": "public",
1670
+ "type": {
1671
+ "text": "boolean"
1672
+ },
1673
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1674
+ "attribute": "dvInputOnly",
1675
+ "reflects": true
1676
+ },
1677
+ {
1678
+ "kind": "field",
1679
+ "name": "error",
1680
+ "privacy": "public",
1681
+ "type": {
1682
+ "text": "string"
1683
+ },
1684
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1685
+ "attribute": "error",
1686
+ "reflects": true
1687
+ },
1688
+ {
1689
+ "kind": "field",
1690
+ "name": "format",
1691
+ "privacy": "public",
1692
+ "type": {
1693
+ "text": "string"
1694
+ },
1695
+ "description": "Specifies the input mask format.",
1696
+ "attribute": "format",
1697
+ "reflects": true
1698
+ },
1699
+ {
1700
+ "kind": "field",
1701
+ "name": "inputmode",
1702
+ "privacy": "public",
1703
+ "type": {
1704
+ "text": "string"
1705
+ },
1706
+ "description": "Exposes inputmode attribute for input.",
1707
+ "attribute": "inputmode",
1708
+ "reflects": true
1709
+ },
1781
1710
  {
1782
1711
  "kind": "field",
1783
- "name": "appearance",
1712
+ "name": "layout",
1784
1713
  "privacy": "public",
1785
1714
  "type": {
1786
- "text": "'default' | 'inverse'"
1715
+ "text": "string"
1787
1716
  },
1788
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1789
- "default": "'default'",
1790
- "attribute": "appearance",
1717
+ "description": "Sets the layout of the combobox.",
1718
+ "default": "'classic'",
1719
+ "attribute": "layout",
1720
+ "reflects": true,
1721
+ "inheritedFrom": {
1722
+ "name": "AuroElement",
1723
+ "module": "components/layoutElement/src/auroElement.js"
1724
+ }
1725
+ },
1726
+ {
1727
+ "kind": "field",
1728
+ "name": "matchWidth",
1729
+ "privacy": "private",
1730
+ "type": {
1731
+ "text": "boolean"
1732
+ },
1733
+ "description": "If declared, the popover and trigger will be set to the same width.",
1734
+ "attribute": "matchWidth",
1791
1735
  "reflects": true
1792
1736
  },
1793
1737
  {
1794
1738
  "kind": "field",
1795
- "name": "disabled",
1739
+ "name": "noFilter",
1796
1740
  "privacy": "public",
1797
1741
  "type": {
1798
1742
  "text": "boolean"
1799
1743
  },
1800
- "description": "If set, disables the checkbox group.",
1801
- "attribute": "disabled",
1744
+ "description": "If set, combobox will not filter menuoptions based on input.",
1745
+ "attribute": "noFilter",
1802
1746
  "reflects": true
1803
1747
  },
1804
1748
  {
1805
1749
  "kind": "field",
1806
- "name": "error",
1750
+ "name": "noFlip",
1807
1751
  "privacy": "public",
1808
1752
  "type": {
1809
- "text": "string"
1753
+ "text": "boolean"
1810
1754
  },
1811
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1812
- "attribute": "error",
1755
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1756
+ "attribute": "noFlip",
1813
1757
  "reflects": true
1814
1758
  },
1815
1759
  {
1816
1760
  "kind": "field",
1817
- "name": "horizontal",
1761
+ "name": "shift",
1818
1762
  "privacy": "public",
1819
1763
  "type": {
1820
1764
  "text": "boolean"
1821
1765
  },
1822
- "description": "If set, checkboxes will be aligned horizontally.",
1823
- "attribute": "horizontal",
1766
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1767
+ "attribute": "shift",
1824
1768
  "reflects": true
1825
1769
  },
1826
1770
  {
@@ -1834,6 +1778,18 @@
1834
1778
  "attribute": "noValidate",
1835
1779
  "reflects": true
1836
1780
  },
1781
+ {
1782
+ "kind": "field",
1783
+ "name": "offset",
1784
+ "privacy": "public",
1785
+ "type": {
1786
+ "text": "number"
1787
+ },
1788
+ "description": "Gap between the trigger element and bib.",
1789
+ "default": "0",
1790
+ "attribute": "offset",
1791
+ "reflects": true
1792
+ },
1837
1793
  {
1838
1794
  "kind": "field",
1839
1795
  "name": "onDark",
@@ -1841,8 +1797,56 @@
1841
1797
  "type": {
1842
1798
  "text": "boolean"
1843
1799
  },
1844
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1845
1800
  "attribute": "onDark",
1801
+ "reflects": true,
1802
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1803
+ "inheritedFrom": {
1804
+ "name": "AuroElement",
1805
+ "module": "components/layoutElement/src/auroElement.js"
1806
+ }
1807
+ },
1808
+ {
1809
+ "kind": "field",
1810
+ "name": "optionSelected",
1811
+ "privacy": "public",
1812
+ "type": {
1813
+ "text": "HTMLElement"
1814
+ },
1815
+ "description": "Specifies the current selected option.",
1816
+ "attribute": "optionSelected"
1817
+ },
1818
+ {
1819
+ "kind": "field",
1820
+ "name": "persistInput",
1821
+ "privacy": "public",
1822
+ "type": {
1823
+ "text": "boolean"
1824
+ },
1825
+ "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
1826
+ "attribute": "persistInput",
1827
+ "reflects": true
1828
+ },
1829
+ {
1830
+ "kind": "field",
1831
+ "name": "placement",
1832
+ "privacy": "public",
1833
+ "type": {
1834
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1835
+ },
1836
+ "description": "Position where the bib should appear relative to the trigger.",
1837
+ "default": "'bottom-start'",
1838
+ "attribute": "placement",
1839
+ "reflects": true
1840
+ },
1841
+ {
1842
+ "kind": "field",
1843
+ "name": "placeholder",
1844
+ "privacy": "public",
1845
+ "type": {
1846
+ "text": "string"
1847
+ },
1848
+ "description": "Define custom placeholder text, only supported by date input formats.",
1849
+ "attribute": "placeholder",
1846
1850
  "reflects": true
1847
1851
  },
1848
1852
  {
@@ -1852,7 +1856,7 @@
1852
1856
  "type": {
1853
1857
  "text": "boolean"
1854
1858
  },
1855
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1859
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1856
1860
  "attribute": "required",
1857
1861
  "reflects": true
1858
1862
  },
@@ -1886,6 +1890,58 @@
1886
1890
  "description": "Custom help text message to display when validity = `valueMissing`.",
1887
1891
  "attribute": "setCustomValidityValueMissing"
1888
1892
  },
1893
+ {
1894
+ "kind": "field",
1895
+ "name": "setCustomValidityValueMissingFilter",
1896
+ "privacy": "public",
1897
+ "type": {
1898
+ "text": "string"
1899
+ },
1900
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1901
+ "attribute": "setCustomValidityValueMissingFilter"
1902
+ },
1903
+ {
1904
+ "kind": "field",
1905
+ "name": "touched",
1906
+ "privacy": "private",
1907
+ "type": {
1908
+ "text": "boolean"
1909
+ },
1910
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1911
+ },
1912
+ {
1913
+ "kind": "field",
1914
+ "name": "triggerIcon",
1915
+ "privacy": "public",
1916
+ "type": {
1917
+ "text": "boolean"
1918
+ },
1919
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1920
+ "attribute": "triggerIcon",
1921
+ "reflects": true
1922
+ },
1923
+ {
1924
+ "kind": "field",
1925
+ "name": "type",
1926
+ "privacy": "public",
1927
+ "type": {
1928
+ "text": "string"
1929
+ },
1930
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1931
+ "attribute": "type",
1932
+ "reflects": true
1933
+ },
1934
+ {
1935
+ "kind": "field",
1936
+ "name": "typedValue",
1937
+ "privacy": "public",
1938
+ "type": {
1939
+ "text": "string"
1940
+ },
1941
+ "description": "Specifies the value of the input element within the combobox.",
1942
+ "attribute": "typedValue",
1943
+ "reflects": true
1944
+ },
1889
1945
  {
1890
1946
  "kind": "field",
1891
1947
  "name": "validity",
@@ -1896,607 +1952,551 @@
1896
1952
  "description": "Specifies the `validityState` this element is in.",
1897
1953
  "attribute": "validity",
1898
1954
  "reflects": true
1899
- }
1900
- ],
1901
- "events": [
1955
+ },
1902
1956
  {
1903
- "name": "input",
1957
+ "kind": "field",
1958
+ "name": "value",
1959
+ "privacy": "public",
1904
1960
  "type": {
1905
- "text": "CustomEvent"
1906
- }
1961
+ "text": "string"
1962
+ },
1963
+ "description": "Value selected for the dropdown menu.",
1964
+ "attribute": "value"
1907
1965
  },
1908
1966
  {
1909
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1910
- "name": "auroFormElement-validated"
1911
- }
1912
- ],
1913
- "attributes": [
1967
+ "kind": "field",
1968
+ "name": "largeFullscreenHeadline",
1969
+ "privacy": "public",
1970
+ "type": {
1971
+ "text": "boolean"
1972
+ },
1973
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1974
+ "attribute": "largeFullscreenHeadline",
1975
+ "reflects": true
1976
+ },
1914
1977
  {
1915
- "name": "appearance",
1978
+ "kind": "field",
1979
+ "name": "fullscreenBreakpoint",
1980
+ "privacy": "public",
1916
1981
  "type": {
1917
- "text": "'default' | 'inverse'"
1982
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1918
1983
  },
1919
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1920
- "default": "'default'",
1921
- "fieldName": "appearance"
1984
+ "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
1985
+ "default": "'sm'",
1986
+ "attribute": "fullscreenBreakpoint",
1987
+ "reflects": true
1988
+ },
1989
+ {
1990
+ "kind": "field",
1991
+ "name": "optionActive",
1992
+ "privacy": "private",
1993
+ "type": {
1994
+ "text": "object"
1995
+ },
1996
+ "description": "Specifies the currently active option."
1997
+ },
1998
+ {
1999
+ "kind": "field",
2000
+ "name": "triggerExpandedState",
2001
+ "privacy": "private",
2002
+ "type": {
2003
+ "text": "boolean"
2004
+ },
2005
+ "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
2006
+ },
2007
+ {
2008
+ "kind": "field",
2009
+ "name": "componentHasFocus",
2010
+ "description": "Returns true if the element has focus.",
2011
+ "privacy": "private",
2012
+ "return": {
2013
+ "type": {
2014
+ "text": "boolean"
2015
+ }
2016
+ },
2017
+ "readonly": true,
2018
+ "inheritedFrom": {
2019
+ "name": "AuroElement",
2020
+ "module": "components/layoutElement/src/auroElement.js"
2021
+ }
2022
+ },
2023
+ {
2024
+ "kind": "method",
2025
+ "name": "resetShapeClasses",
2026
+ "inheritedFrom": {
2027
+ "name": "AuroElement",
2028
+ "module": "components/layoutElement/src/auroElement.js"
2029
+ }
2030
+ },
2031
+ {
2032
+ "kind": "method",
2033
+ "name": "resetLayoutClasses",
2034
+ "inheritedFrom": {
2035
+ "name": "AuroElement",
2036
+ "module": "components/layoutElement/src/auroElement.js"
2037
+ }
1922
2038
  },
1923
2039
  {
1924
- "name": "disabled",
1925
- "type": {
1926
- "text": "boolean"
1927
- },
1928
- "description": "If set, disables the checkbox group.",
1929
- "fieldName": "disabled"
2040
+ "kind": "method",
2041
+ "name": "updateComponentArchitecture",
2042
+ "inheritedFrom": {
2043
+ "name": "AuroElement",
2044
+ "module": "components/layoutElement/src/auroElement.js"
2045
+ }
1930
2046
  },
1931
2047
  {
1932
- "name": "error",
2048
+ "kind": "field",
2049
+ "name": "shape",
2050
+ "privacy": "public",
1933
2051
  "type": {
1934
2052
  "text": "string"
1935
2053
  },
1936
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1937
- "fieldName": "error"
2054
+ "attribute": "shape",
2055
+ "reflects": true,
2056
+ "inheritedFrom": {
2057
+ "name": "AuroElement",
2058
+ "module": "components/layoutElement/src/auroElement.js"
2059
+ }
1938
2060
  },
1939
2061
  {
1940
- "name": "horizontal",
2062
+ "kind": "field",
2063
+ "name": "size",
2064
+ "privacy": "public",
1941
2065
  "type": {
1942
- "text": "boolean"
2066
+ "text": "string"
1943
2067
  },
1944
- "description": "If set, checkboxes will be aligned horizontally.",
1945
- "fieldName": "horizontal"
1946
- },
2068
+ "attribute": "size",
2069
+ "reflects": true,
2070
+ "inheritedFrom": {
2071
+ "name": "AuroElement",
2072
+ "module": "components/layoutElement/src/auroElement.js"
2073
+ }
2074
+ }
2075
+ ],
2076
+ "events": [
1947
2077
  {
1948
- "name": "noValidate",
2078
+ "name": "inputValue",
1949
2079
  "type": {
1950
- "text": "boolean"
2080
+ "text": "CustomEvent"
1951
2081
  },
1952
- "description": "If set, disables auto-validation on blur.",
1953
- "fieldName": "noValidate"
2082
+ "description": "Notifies that the components internal HTML5 input value has changed."
1954
2083
  },
1955
2084
  {
1956
- "name": "onDark",
2085
+ "name": "input",
1957
2086
  "type": {
1958
- "text": "boolean"
2087
+ "text": "CustomEvent"
1959
2088
  },
1960
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1961
- "fieldName": "onDark"
2089
+ "description": "Notifies that the component has a new value set."
1962
2090
  },
1963
2091
  {
1964
- "name": "required",
2092
+ "name": "auroCombobox-valueSet",
1965
2093
  "type": {
1966
- "text": "boolean"
2094
+ "text": "CustomEvent"
1967
2095
  },
1968
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1969
- "fieldName": "required"
2096
+ "description": "(Deprecated) Notifies that the component has a new value set."
1970
2097
  },
1971
2098
  {
1972
- "name": "setCustomValidity",
1973
- "type": {
1974
- "text": "string"
1975
- },
1976
- "description": "Sets a custom help text message to display for all validityStates.",
1977
- "fieldName": "setCustomValidity"
1978
- },
2099
+ "description": "Notifies that the component value(s) have been validated.",
2100
+ "name": "auroFormElement-validated"
2101
+ }
2102
+ ],
2103
+ "attributes": [
1979
2104
  {
1980
- "name": "setCustomValidityCustomError",
2105
+ "name": "appearance",
1981
2106
  "type": {
1982
2107
  "text": "string"
1983
2108
  },
1984
- "description": "Custom help text message to display when validity = `customError`.",
1985
- "fieldName": "setCustomValidityCustomError"
2109
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2110
+ "default": "'default'",
2111
+ "fieldName": "appearance"
1986
2112
  },
1987
2113
  {
1988
- "name": "setCustomValidityValueMissing",
2114
+ "name": "autocomplete",
1989
2115
  "type": {
1990
2116
  "text": "string"
1991
2117
  },
1992
- "description": "Custom help text message to display when validity = `valueMissing`.",
1993
- "fieldName": "setCustomValidityValueMissing"
2118
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2119
+ "fieldName": "autocomplete"
1994
2120
  },
1995
2121
  {
1996
- "name": "validity",
2122
+ "name": "autoPlacement",
1997
2123
  "type": {
1998
- "text": "string"
2124
+ "text": "boolean"
1999
2125
  },
2000
- "description": "Specifies the `validityState` this element is in.",
2001
- "fieldName": "validity"
2002
- }
2003
- ],
2004
- "superclass": {
2005
- "name": "LitElement",
2006
- "package": "lit"
2007
- },
2008
- "tagName": "auro-checkbox-group",
2009
- "customElement": true
2010
- }
2011
- ],
2012
- "exports": [
2013
- {
2014
- "kind": "js",
2015
- "name": "AuroCheckboxGroup",
2016
- "declaration": {
2017
- "name": "AuroCheckboxGroup",
2018
- "module": "components/checkbox/src/auro-checkbox-group.js"
2019
- }
2020
- }
2021
- ]
2022
- },
2023
- {
2024
- "kind": "javascript-module",
2025
- "path": "components/checkbox/src/auro-checkbox.js",
2026
- "declarations": [
2027
- {
2028
- "kind": "class",
2029
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2030
- "name": "AuroCheckbox",
2031
- "cssParts": [
2032
- {
2033
- "description": "apply css to a specific checkbox.",
2034
- "name": "checkbox"
2035
- },
2036
- {
2037
- "description": "apply css to a specific checkbox's input.",
2038
- "name": "checkbox-input"
2039
- },
2040
- {
2041
- "description": "apply css to a specific checkbox's label.",
2042
- "name": "checkbox-label"
2043
- }
2044
- ],
2045
- "slots": [
2046
- {
2047
- "description": "The default slot for the checkbox label.",
2048
- "name": "default"
2049
- }
2050
- ],
2051
- "members": [
2052
- {
2053
- "kind": "method",
2054
- "name": "_initializeDefaults"
2055
- },
2056
- {
2057
- "kind": "method",
2058
- "name": "register",
2059
- "static": true,
2060
- "parameters": [
2061
- {
2062
- "name": "name",
2063
- "default": "\"auro-checkbox\"",
2064
- "description": "The name of element that you want to register to.",
2065
- "optional": true,
2066
- "type": {
2067
- "text": "string"
2068
- }
2069
- }
2070
- ],
2071
- "description": "This will register this element with the browser."
2072
- },
2073
- {
2074
- "kind": "method",
2075
- "name": "handleChange",
2076
- "parameters": [
2077
- {
2078
- "name": "event",
2079
- "description": "The change event from the checkbox input.",
2080
- "type": {
2081
- "text": "Event"
2082
- }
2083
- }
2084
- ],
2085
- "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.",
2086
- "privacy": "private",
2087
- "return": {
2088
- "type": {
2089
- "text": "void"
2090
- }
2091
- }
2092
- },
2093
- {
2094
- "kind": "method",
2095
- "name": "handleInput",
2096
- "parameters": [
2097
- {
2098
- "name": "event",
2099
- "description": "The input event from the checkbox input.",
2100
- "type": {
2101
- "text": "Event"
2102
- }
2103
- }
2104
- ],
2105
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2106
- "privacy": "private",
2107
- "return": {
2108
- "type": {
2109
- "text": "void"
2110
- }
2111
- }
2112
- },
2113
- {
2114
- "kind": "method",
2115
- "name": "handleFocusin",
2116
- "description": "Function to support",
2117
- "privacy": "private",
2118
- "return": {
2119
- "type": {
2120
- "text": "void"
2121
- }
2122
- }
2123
- },
2124
- {
2125
- "kind": "method",
2126
- "name": "generateIconHtml",
2127
- "description": "Function to generate checkmark svg.",
2128
- "privacy": "private",
2129
- "return": {
2130
- "type": {
2131
- "text": "HTMLElement"
2132
- }
2133
- }
2134
- },
2135
- {
2136
- "kind": "method",
2137
- "name": "reset",
2138
- "description": "Resets component to initial state.",
2139
- "return": {
2140
- "type": {
2141
- "text": "void"
2142
- }
2143
- }
2126
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
2127
+ "fieldName": "autoPlacement"
2144
2128
  },
2145
2129
  {
2146
- "kind": "method",
2147
- "name": "updateAriaLabel",
2148
- "description": "Updates the aria-label based on slot content.",
2149
- "privacy": "private",
2150
- "return": {
2151
- "type": {
2152
- "text": "void"
2153
- }
2154
- }
2130
+ "name": "availableOptions",
2131
+ "type": {
2132
+ "text": "array"
2133
+ },
2134
+ "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
2135
+ "fieldName": "availableOptions"
2155
2136
  },
2156
2137
  {
2157
- "kind": "method",
2158
- "name": "handleKeyDown",
2159
- "parameters": [
2160
- {
2161
- "name": "event",
2162
- "description": "The keydown event from the checkbox input.",
2163
- "type": {
2164
- "text": "KeyboardEvent"
2165
- }
2166
- }
2167
- ],
2168
- "description": "Handles keydown event to toggle the checkbox with Space key.",
2169
- "privacy": "private",
2170
- "return": {
2171
- "type": {
2172
- "text": "void"
2173
- }
2174
- }
2138
+ "name": "behavior",
2139
+ "type": {
2140
+ "text": "'filter' | 'suggestion'"
2141
+ },
2142
+ "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
2143
+ "default": "'suggestion'",
2144
+ "fieldName": "behavior"
2175
2145
  },
2176
2146
  {
2177
- "kind": "field",
2178
- "name": "appearance",
2179
- "privacy": "public",
2147
+ "name": "checkmark",
2180
2148
  "type": {
2181
- "text": "'default' | 'inverse'"
2149
+ "text": "boolean"
2182
2150
  },
2183
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2184
- "default": "'default'",
2185
- "attribute": "appearance",
2186
- "reflects": true
2151
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
2152
+ "fieldName": "checkmark"
2187
2153
  },
2188
2154
  {
2189
- "kind": "field",
2190
- "name": "checked",
2191
- "privacy": "public",
2155
+ "name": "disabled",
2192
2156
  "type": {
2193
2157
  "text": "boolean"
2194
2158
  },
2195
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2196
- "attribute": "checked",
2197
- "reflects": true
2159
+ "description": "If set, disables the combobox.",
2160
+ "fieldName": "disabled"
2198
2161
  },
2199
2162
  {
2200
- "kind": "field",
2201
- "name": "disabled",
2202
- "privacy": "public",
2163
+ "name": "dvInputOnly",
2203
2164
  "type": {
2204
2165
  "text": "boolean"
2205
2166
  },
2206
- "description": "If set to true, the checkbox will not be clickable.",
2207
- "attribute": "disabled",
2208
- "reflects": true
2167
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2168
+ "fieldName": "dvInputOnly"
2209
2169
  },
2210
2170
  {
2211
- "kind": "field",
2212
2171
  "name": "error",
2213
- "privacy": "public",
2214
2172
  "type": {
2215
- "text": "boolean"
2173
+ "text": "string"
2216
2174
  },
2217
- "description": "If set to true, the checkbox will be displayed with an error state.",
2218
- "attribute": "error",
2219
- "reflects": true
2175
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2176
+ "fieldName": "error"
2220
2177
  },
2221
2178
  {
2222
- "kind": "field",
2223
- "name": "id",
2224
- "privacy": "public",
2179
+ "name": "format",
2225
2180
  "type": {
2226
2181
  "text": "string"
2227
2182
  },
2228
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2229
- "attribute": "id",
2230
- "reflects": true
2183
+ "description": "Specifies the input mask format.",
2184
+ "fieldName": "format"
2231
2185
  },
2232
2186
  {
2233
- "kind": "field",
2234
- "name": "inputId",
2235
- "privacy": "private",
2187
+ "name": "inputmode",
2236
2188
  "type": {
2237
2189
  "text": "string"
2238
2190
  },
2239
- "description": "The id for input node."
2191
+ "description": "Exposes inputmode attribute for input.",
2192
+ "fieldName": "inputmode"
2240
2193
  },
2241
2194
  {
2242
- "kind": "field",
2243
- "name": "name",
2244
- "privacy": "public",
2195
+ "name": "layout",
2245
2196
  "type": {
2246
2197
  "text": "string"
2247
2198
  },
2248
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2249
- "attribute": "name"
2199
+ "description": "Sets the layout of the combobox.",
2200
+ "default": "'classic'",
2201
+ "fieldName": "layout",
2202
+ "inheritedFrom": {
2203
+ "name": "AuroElement",
2204
+ "module": "components/layoutElement/src/auroElement.js"
2205
+ }
2250
2206
  },
2251
2207
  {
2252
- "kind": "field",
2253
- "name": "onDark",
2254
- "privacy": "public",
2208
+ "name": "matchWidth",
2255
2209
  "type": {
2256
2210
  "text": "boolean"
2257
2211
  },
2258
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2259
- "attribute": "onDark",
2260
- "reflects": true
2212
+ "description": "If declared, the popover and trigger will be set to the same width.",
2213
+ "fieldName": "matchWidth"
2261
2214
  },
2262
2215
  {
2263
- "kind": "field",
2264
- "name": "touched",
2265
- "privacy": "private",
2216
+ "name": "noFilter",
2266
2217
  "type": {
2267
2218
  "text": "boolean"
2268
2219
  },
2269
- "description": "Indicates whether the checkbox has been interacted with."
2220
+ "description": "If set, combobox will not filter menuoptions based on input.",
2221
+ "fieldName": "noFilter"
2270
2222
  },
2271
2223
  {
2272
- "kind": "field",
2273
- "name": "value",
2274
- "privacy": "public",
2224
+ "name": "noFlip",
2275
2225
  "type": {
2276
- "text": "string"
2226
+ "text": "boolean"
2277
2227
  },
2278
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2279
- "attribute": "value"
2228
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2229
+ "fieldName": "noFlip"
2280
2230
  },
2281
2231
  {
2282
- "kind": "field",
2283
- "name": "tabIndex",
2284
- "privacy": "private",
2232
+ "name": "shift",
2285
2233
  "type": {
2286
- "text": "number"
2234
+ "text": "boolean"
2287
2235
  },
2288
- "description": "The tabindex attribute for the checkbox.",
2289
- "attribute": "tabindex",
2290
- "reflects": true
2236
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2237
+ "fieldName": "shift"
2291
2238
  },
2292
2239
  {
2293
- "kind": "field",
2294
- "name": "ariaChecked",
2295
- "privacy": "private",
2240
+ "name": "noValidate",
2296
2241
  "type": {
2297
- "text": "string"
2242
+ "text": "boolean"
2298
2243
  },
2299
- "description": "The aria-checked attribute for the checkbox.",
2300
- "attribute": "aria-checked",
2301
- "reflects": true
2244
+ "description": "If set, disables auto-validation on blur.",
2245
+ "fieldName": "noValidate"
2302
2246
  },
2303
2247
  {
2304
- "kind": "field",
2305
- "name": "ariaDisabled",
2306
- "privacy": "private",
2248
+ "name": "offset",
2307
2249
  "type": {
2308
- "text": "string"
2250
+ "text": "number"
2309
2251
  },
2310
- "description": "The aria-disabled attribute for the checkbox.",
2311
- "attribute": "aria-disabled",
2312
- "reflects": true
2252
+ "description": "Gap between the trigger element and bib.",
2253
+ "default": "0",
2254
+ "fieldName": "offset"
2313
2255
  },
2314
2256
  {
2315
- "kind": "field",
2316
- "name": "role",
2317
- "privacy": "private",
2257
+ "name": "onDark",
2318
2258
  "type": {
2319
- "text": "string"
2259
+ "text": "boolean"
2320
2260
  },
2321
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2322
- "attribute": "role",
2323
- "reflects": true
2324
- }
2325
- ],
2326
- "events": [
2261
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2262
+ "fieldName": "onDark"
2263
+ },
2327
2264
  {
2328
- "name": "auroCheckbox-input",
2265
+ "name": "optionSelected",
2329
2266
  "type": {
2330
- "text": "CustomEvent"
2331
- }
2267
+ "text": "HTMLElement"
2268
+ },
2269
+ "description": "Specifies the current selected option.",
2270
+ "fieldName": "optionSelected"
2332
2271
  },
2333
2272
  {
2334
- "name": "auroCheckbox-focusin",
2273
+ "name": "persistInput",
2335
2274
  "type": {
2336
- "text": "CustomEvent"
2337
- }
2275
+ "text": "boolean"
2276
+ },
2277
+ "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
2278
+ "fieldName": "persistInput"
2338
2279
  },
2339
2280
  {
2340
- "name": "auroCheckbox-focusout",
2281
+ "name": "placement",
2341
2282
  "type": {
2342
- "text": "CustomEvent"
2343
- }
2283
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2284
+ },
2285
+ "description": "Position where the bib should appear relative to the trigger.",
2286
+ "default": "'bottom-start'",
2287
+ "fieldName": "placement"
2344
2288
  },
2345
2289
  {
2346
- "description": "(Deprecated) Notifies when checked value is changed.",
2347
- "name": "change"
2290
+ "name": "placeholder",
2291
+ "type": {
2292
+ "text": "string"
2293
+ },
2294
+ "description": "Define custom placeholder text, only supported by date input formats.",
2295
+ "fieldName": "placeholder"
2348
2296
  },
2349
2297
  {
2350
- "description": "Notifies when when checked value is changed by user's interface.",
2351
- "name": "input"
2352
- }
2353
- ],
2354
- "attributes": [
2298
+ "name": "required",
2299
+ "type": {
2300
+ "text": "boolean"
2301
+ },
2302
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2303
+ "fieldName": "required"
2304
+ },
2355
2305
  {
2356
- "name": "appearance",
2306
+ "name": "setCustomValidity",
2357
2307
  "type": {
2358
- "text": "'default' | 'inverse'"
2308
+ "text": "string"
2359
2309
  },
2360
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2361
- "default": "'default'",
2362
- "fieldName": "appearance"
2310
+ "description": "Sets a custom help text message to display for all validityStates.",
2311
+ "fieldName": "setCustomValidity"
2363
2312
  },
2364
2313
  {
2365
- "name": "checked",
2314
+ "name": "setCustomValidityCustomError",
2366
2315
  "type": {
2367
- "text": "boolean"
2316
+ "text": "string"
2368
2317
  },
2369
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2370
- "fieldName": "checked"
2318
+ "description": "Custom help text message to display when validity = `customError`.",
2319
+ "fieldName": "setCustomValidityCustomError"
2371
2320
  },
2372
2321
  {
2373
- "name": "disabled",
2322
+ "name": "setCustomValidityValueMissing",
2374
2323
  "type": {
2375
- "text": "boolean"
2324
+ "text": "string"
2376
2325
  },
2377
- "description": "If set to true, the checkbox will not be clickable.",
2378
- "fieldName": "disabled"
2326
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2327
+ "fieldName": "setCustomValidityValueMissing"
2379
2328
  },
2380
2329
  {
2381
- "name": "error",
2330
+ "name": "setCustomValidityValueMissingFilter",
2331
+ "type": {
2332
+ "text": "string"
2333
+ },
2334
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2335
+ "fieldName": "setCustomValidityValueMissingFilter"
2336
+ },
2337
+ {
2338
+ "name": "triggerIcon",
2382
2339
  "type": {
2383
2340
  "text": "boolean"
2384
2341
  },
2385
- "description": "If set to true, the checkbox will be displayed with an error state.",
2386
- "fieldName": "error"
2342
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2343
+ "fieldName": "triggerIcon"
2387
2344
  },
2388
2345
  {
2389
- "name": "id",
2346
+ "name": "type",
2390
2347
  "type": {
2391
2348
  "text": "string"
2392
2349
  },
2393
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2394
- "fieldName": "id"
2350
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2351
+ "fieldName": "type"
2395
2352
  },
2396
2353
  {
2397
- "name": "name",
2354
+ "name": "typedValue",
2398
2355
  "type": {
2399
2356
  "text": "string"
2400
2357
  },
2401
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2402
- "fieldName": "name"
2358
+ "description": "Specifies the value of the input element within the combobox.",
2359
+ "fieldName": "typedValue"
2403
2360
  },
2404
2361
  {
2405
- "name": "onDark",
2362
+ "name": "validity",
2406
2363
  "type": {
2407
- "text": "boolean"
2364
+ "text": "string"
2408
2365
  },
2409
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2410
- "fieldName": "onDark"
2366
+ "description": "Specifies the `validityState` this element is in.",
2367
+ "fieldName": "validity"
2411
2368
  },
2412
2369
  {
2413
2370
  "name": "value",
2414
2371
  "type": {
2415
2372
  "text": "string"
2416
2373
  },
2417
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2374
+ "description": "Value selected for the dropdown menu.",
2418
2375
  "fieldName": "value"
2419
2376
  },
2420
2377
  {
2421
- "name": "tabindex",
2378
+ "name": "largeFullscreenHeadline",
2422
2379
  "type": {
2423
- "text": "number"
2380
+ "text": "boolean"
2424
2381
  },
2425
- "description": "The tabindex attribute for the checkbox.",
2426
- "fieldName": "tabIndex"
2382
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2383
+ "fieldName": "largeFullscreenHeadline"
2427
2384
  },
2428
2385
  {
2429
- "name": "aria-checked",
2386
+ "name": "fullscreenBreakpoint",
2430
2387
  "type": {
2431
- "text": "string"
2388
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2432
2389
  },
2433
- "description": "The aria-checked attribute for the checkbox.",
2434
- "fieldName": "ariaChecked"
2390
+ "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
2391
+ "default": "'sm'",
2392
+ "fieldName": "fullscreenBreakpoint"
2435
2393
  },
2436
2394
  {
2437
- "name": "aria-disabled",
2395
+ "name": "shape",
2438
2396
  "type": {
2439
2397
  "text": "string"
2440
2398
  },
2441
- "description": "The aria-disabled attribute for the checkbox.",
2442
- "fieldName": "ariaDisabled"
2399
+ "fieldName": "shape",
2400
+ "inheritedFrom": {
2401
+ "name": "AuroElement",
2402
+ "module": "components/layoutElement/src/auroElement.js"
2403
+ }
2443
2404
  },
2444
2405
  {
2445
- "name": "role",
2406
+ "name": "size",
2446
2407
  "type": {
2447
2408
  "text": "string"
2448
2409
  },
2449
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2450
- "fieldName": "role"
2410
+ "fieldName": "size",
2411
+ "inheritedFrom": {
2412
+ "name": "AuroElement",
2413
+ "module": "components/layoutElement/src/auroElement.js"
2414
+ }
2415
+ },
2416
+ {
2417
+ "name": "ondark",
2418
+ "type": {
2419
+ "text": "boolean"
2420
+ },
2421
+ "fieldName": "onDark",
2422
+ "inheritedFrom": {
2423
+ "name": "AuroElement",
2424
+ "module": "components/layoutElement/src/auroElement.js"
2425
+ }
2451
2426
  }
2452
2427
  ],
2453
2428
  "superclass": {
2454
- "name": "LitElement",
2455
- "package": "lit"
2429
+ "name": "AuroElement",
2430
+ "module": "/components/layoutElement/src/auroElement.js"
2456
2431
  },
2457
- "tagName": "auro-checkbox",
2432
+ "tagName": "auro-combobox",
2458
2433
  "customElement": true
2459
2434
  }
2460
2435
  ],
2461
2436
  "exports": [
2462
2437
  {
2463
2438
  "kind": "js",
2464
- "name": "AuroCheckbox",
2439
+ "name": "AuroCombobox",
2465
2440
  "declaration": {
2466
- "name": "AuroCheckbox",
2467
- "module": "components/checkbox/src/auro-checkbox.js"
2441
+ "name": "AuroCombobox",
2442
+ "module": "components/combobox/src/auro-combobox.js"
2468
2443
  }
2469
2444
  }
2470
2445
  ]
2471
2446
  },
2472
2447
  {
2473
2448
  "kind": "javascript-module",
2474
- "path": "components/checkbox/src/index.js",
2475
- "declarations": [],
2449
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2450
+ "declarations": [
2451
+ {
2452
+ "kind": "variable",
2453
+ "name": "comboboxKeyboardStrategy",
2454
+ "type": {
2455
+ "text": "object"
2456
+ },
2457
+ "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { navigateArrow(component, 'down'); } } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
2458
+ }
2459
+ ],
2476
2460
  "exports": [
2477
2461
  {
2478
2462
  "kind": "js",
2479
- "name": "AuroCheckbox",
2463
+ "name": "comboboxKeyboardStrategy",
2480
2464
  "declaration": {
2481
- "name": "AuroCheckbox",
2482
- "module": "components/checkbox/src/index.js"
2465
+ "name": "comboboxKeyboardStrategy",
2466
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2483
2467
  }
2484
- },
2468
+ }
2469
+ ]
2470
+ },
2471
+ {
2472
+ "kind": "javascript-module",
2473
+ "path": "components/combobox/src/index.js",
2474
+ "declarations": [],
2475
+ "exports": [
2485
2476
  {
2486
2477
  "kind": "js",
2487
- "name": "AuroCheckboxGroup",
2478
+ "name": "AuroCombobox",
2488
2479
  "declaration": {
2489
- "name": "AuroCheckboxGroup",
2490
- "module": "components/checkbox/src/index.js"
2480
+ "name": "AuroCombobox",
2481
+ "module": "components/combobox/src/index.js"
2491
2482
  }
2492
2483
  }
2493
2484
  ]
2494
2485
  },
2495
2486
  {
2496
2487
  "kind": "javascript-module",
2497
- "path": "components/checkbox/src/registered.js",
2488
+ "path": "components/combobox/src/registered.js",
2498
2489
  "declarations": [],
2499
- "exports": []
2490
+ "exports": [
2491
+ {
2492
+ "kind": "js",
2493
+ "name": "AuroCombobox",
2494
+ "declaration": {
2495
+ "name": "AuroCombobox",
2496
+ "module": "components/combobox/src/registered.js"
2497
+ }
2498
+ }
2499
+ ]
2500
2500
  },
2501
2501
  {
2502
2502
  "kind": "javascript-module",
@@ -4577,7 +4577,7 @@
4577
4577
  {
4578
4578
  "kind": "method",
4579
4579
  "name": "updateHostAria",
4580
- "description": "Updates ARIA attributes on the host element so that\nariaActiveDescendantElement can expose cell info to the SR.",
4580
+ "description": "Sets host-level ARIA so each cell exposes its date, selection state,\nand blackout status to assistive tech browsing the month grid.",
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.\nNote: buttons stay tabindex=\"-1\" because the grid uses aria-activedescendant.",
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.",
4602
4602
  "return": {
4603
4603
  "type": {
4604
4604
  "text": "void"
@@ -4743,6 +4743,7 @@
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.",
4746
4747
  "default": "[]",
4747
4748
  "attribute": "disabledDays"
4748
4749
  },
@@ -4902,6 +4903,7 @@
4902
4903
  "type": {
4903
4904
  "text": "array"
4904
4905
  },
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.",
4905
4907
  "default": "[]",
4906
4908
  "fieldName": "disabledDays"
4907
4909
  },
@@ -5306,6 +5308,26 @@
5306
5308
  }
5307
5309
  }
5308
5310
  },
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
+ },
5309
5331
  {
5310
5332
  "kind": "method",
5311
5333
  "name": "renderAllCalendars",
@@ -5357,6 +5379,40 @@
5357
5379
  }
5358
5380
  }
5359
5381
  },
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
+ },
5360
5416
  {
5361
5417
  "kind": "method",
5362
5418
  "name": "getAllFocusableCells",
@@ -5380,7 +5436,7 @@
5380
5436
  }
5381
5437
  }
5382
5438
  ],
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.",
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.",
5384
5440
  "return": {
5385
5441
  "type": {
5386
5442
  "text": "void"
@@ -5419,6 +5475,39 @@
5419
5475
  }
5420
5476
  }
5421
5477
  },
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
+ },
5422
5511
  {
5423
5512
  "kind": "method",
5424
5513
  "name": "computeActiveDate",
@@ -5473,7 +5562,7 @@
5473
5562
  }
5474
5563
  }
5475
5564
  ],
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.",
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.",
5477
5566
  "privacy": "private",
5478
5567
  "return": {
5479
5568
  "type": {
@@ -5704,6 +5793,33 @@
5704
5793
  }
5705
5794
  }
5706
5795
  },
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
+ },
5707
5823
  {
5708
5824
  "kind": "method",
5709
5825
  "name": "announceFocusDebounced",
@@ -5888,7 +6004,7 @@
5888
6004
  "type": {
5889
6005
  "text": "array"
5890
6006
  },
5891
- "description": "Legacy array of disabled-date timestamps.",
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.",
5892
6008
  "privacy": "private",
5893
6009
  "default": "[]"
5894
6010
  },
@@ -6590,13 +6706,13 @@
6590
6706
  "parameters": [
6591
6707
  {
6592
6708
  "name": "time",
6593
- "description": "Unix timestamp in seconds.",
6709
+ "description": "Unix timestamp (seconds), local midnight of the day.",
6594
6710
  "type": {
6595
6711
  "text": "number"
6596
6712
  }
6597
6713
  }
6598
6714
  ],
6599
- "description": "Converts a Unix timestamp (seconds) from the vendor calendar to an ISO date string.",
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.",
6600
6716
  "privacy": "private",
6601
6717
  "return": {
6602
6718
  "type": {
@@ -6872,6 +6988,34 @@
6872
6988
  },
6873
6989
  "readonly": true
6874
6990
  },
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
+ },
6875
7019
  {
6876
7020
  "kind": "method",
6877
7021
  "name": "handleSlotToSlot",
@@ -7241,6 +7385,18 @@
7241
7385
  "attribute": "rangeLabelAfterRange",
7242
7386
  "reflects": true
7243
7387
  },
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
+ },
7244
7400
  {
7245
7401
  "kind": "field",
7246
7402
  "name": "blackoutDates",
@@ -7580,6 +7736,13 @@
7580
7736
  "name": "helpTextTag",
7581
7737
  "privacy": "private"
7582
7738
  },
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
+ },
7583
7746
  {
7584
7747
  "kind": "field",
7585
7748
  "name": "layout",
@@ -8212,6 +8375,15 @@
8212
8375
  "default": "'range end'",
8213
8376
  "fieldName": "rangeLabelEnd"
8214
8377
  },
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
+ },
8215
8387
  {
8216
8388
  "name": "rangeLabelInRange",
8217
8389
  "type": {