@aurodesignsystem-dev/auro-formkit 0.0.0-pr1540.1 → 0.0.0-pr1541.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 (64) 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 +22 -4
  7. package/components/combobox/demo/getting-started.min.js +22 -4
  8. package/components/combobox/demo/index.min.js +22 -4
  9. package/components/combobox/dist/index.js +3 -3
  10. package/components/combobox/dist/registered.js +3 -3
  11. package/components/counter/demo/customize.min.js +2 -2
  12. package/components/counter/demo/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/customize.min.js +3 -3
  16. package/components/datepicker/demo/index.min.js +3 -3
  17. package/components/datepicker/dist/index.js +3 -3
  18. package/components/datepicker/dist/registered.js +3 -3
  19. package/components/dropdown/demo/customize.min.js +1 -1
  20. package/components/dropdown/demo/getting-started.min.js +1 -1
  21. package/components/dropdown/demo/index.min.js +1 -1
  22. package/components/dropdown/dist/index.js +1 -1
  23. package/components/dropdown/dist/registered.js +1 -1
  24. package/components/form/demo/customize.min.js +34 -16
  25. package/components/form/demo/getting-started.min.js +34 -16
  26. package/components/form/demo/index.min.js +34 -16
  27. package/components/form/demo/registerDemoDeps.min.js +34 -16
  28. package/components/input/demo/customize.min.js +1 -1
  29. package/components/input/demo/getting-started.min.js +1 -1
  30. package/components/input/demo/index.min.js +1 -1
  31. package/components/input/dist/index.js +1 -1
  32. package/components/input/dist/registered.js +1 -1
  33. package/components/menu/demo/accessibility.md +9 -4
  34. package/components/menu/demo/api.md +3 -2
  35. package/components/menu/demo/css-only.md +26 -19
  36. package/components/menu/demo/customize.md +306 -46
  37. package/components/menu/demo/design.md +1 -1
  38. package/components/menu/demo/getting-started.md +143 -6
  39. package/components/menu/demo/index.min.js +144 -1
  40. package/components/menu/demo/keyboard-behavior.md +77 -4
  41. package/components/menu/demo/voiceover.md +12 -9
  42. package/components/menu/demo/why-menu.md +8 -9
  43. package/components/menu/dist/auro-menu.d.ts +1 -1
  44. package/components/menu/dist/auro-menuoption.d.ts +11 -0
  45. package/components/menu/dist/index.js +19 -1
  46. package/components/menu/dist/registered.js +19 -1
  47. package/components/radio/demo/customize.min.js +1 -1
  48. package/components/radio/demo/getting-started.min.js +1 -1
  49. package/components/radio/demo/index.min.js +1 -1
  50. package/components/radio/dist/index.js +1 -1
  51. package/components/radio/dist/registered.js +1 -1
  52. package/components/select/demo/accessibility.md +5 -0
  53. package/components/select/demo/customize.md +2 -2
  54. package/components/select/demo/customize.min.js +23 -5
  55. package/components/select/demo/design.md +10 -10
  56. package/components/select/demo/getting-started.min.js +23 -5
  57. package/components/select/demo/index.md +1 -1
  58. package/components/select/demo/index.min.js +23 -5
  59. package/components/select/demo/keyboard-behavior.md +63 -68
  60. package/components/select/demo/voiceover.md +28 -15
  61. package/components/select/dist/index.js +4 -4
  62. package/components/select/dist/registered.js +4 -4
  63. package/custom-elements.json +1795 -1770
  64. package/package.json +1 -1
@@ -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,315 +90,366 @@
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
- }
401
+ "name": "_initializeDefaults"
323
402
  },
324
403
  {
325
404
  "kind": "method",
326
- "name": "_scheduleTimer",
405
+ "name": "register",
406
+ "static": true,
327
407
  "parameters": [
328
408
  {
329
- "name": "fn",
330
- "description": "Callback to run.",
331
- "type": {
332
- "text": "Function"
333
- }
334
- },
335
- {
336
- "name": "ms",
337
- "description": "Delay in milliseconds.",
409
+ "name": "name",
410
+ "default": "\"auro-checkbox\"",
411
+ "description": "The name of element that you want to register to.",
412
+ "optional": true,
338
413
  "type": {
339
- "text": "number"
414
+ "text": "string"
340
415
  }
341
416
  }
342
417
  ],
343
- "description": "Wraps setTimeout and records the timer id so disconnectedCallback\ncan cancel any outstanding callbacks. The id is removed from the set\nonce the callback fires so the set doesn't grow unbounded.",
344
- "return": {
345
- "type": {
346
- "text": "number"
347
- }
348
- },
349
- "privacy": "private"
350
- },
351
- {
352
- "kind": "field",
353
- "name": "inputValue",
354
- "description": "Returns the current value of the input element within the combobox.",
355
- "return": {
356
- "type": {
357
- "text": "string|undefined"
358
- }
359
- },
360
- "readonly": true
418
+ "description": "This will register this element with the browser."
361
419
  },
362
420
  {
363
421
  "kind": "method",
364
- "name": "isValid",
365
- "description": "Checks if the element is valid.",
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.",
433
+ "privacy": "private",
366
434
  "return": {
367
435
  "type": {
368
- "text": "boolean"
436
+ "text": "void"
369
437
  }
370
438
  }
371
439
  },
372
440
  {
373
441
  "kind": "method",
374
- "name": "register",
375
- "static": true,
442
+ "name": "handleInput",
376
443
  "parameters": [
377
444
  {
378
- "name": "name",
379
- "default": "'auro-combobox'",
380
- "description": "The name of the element that you want to register.",
381
- "optional": true,
445
+ "name": "event",
446
+ "description": "The input event from the checkbox input.",
382
447
  "type": {
383
- "text": "string"
448
+ "text": "Event"
384
449
  }
385
450
  }
386
451
  ],
387
- "description": "This will register this element with the browser."
388
- },
389
- {
390
- "kind": "method",
391
- "name": "activateFirstEnabledAvailableOption",
392
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
452
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
393
453
  "privacy": "private",
394
454
  "return": {
395
455
  "type": {
@@ -399,8 +459,8 @@
399
459
  },
400
460
  {
401
461
  "kind": "method",
402
- "name": "activateLastEnabledAvailableOption",
403
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
462
+ "name": "handleFocusin",
463
+ "description": "Function to support",
404
464
  "privacy": "private",
405
465
  "return": {
406
466
  "type": {
@@ -410,74 +470,49 @@
410
470
  },
411
471
  {
412
472
  "kind": "method",
413
- "name": "updateFilter",
414
- "description": "Updates the filter for the available options based on the input value.",
415
- "privacy": "private"
416
- },
417
- {
418
- "kind": "method",
419
- "name": "syncValuesAndStates",
420
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
473
+ "name": "generateIconHtml",
474
+ "description": "Function to generate checkmark svg.",
421
475
  "privacy": "private",
422
476
  "return": {
423
477
  "type": {
424
- "text": "void"
478
+ "text": "HTMLElement"
425
479
  }
426
480
  }
427
481
  },
428
482
  {
429
483
  "kind": "method",
430
- "name": "updateTriggerTextDisplay",
431
- "parameters": [
432
- {
433
- "name": "label",
434
- "description": "The label of the selected option.",
435
- "type": {
436
- "text": "string"
437
- }
484
+ "name": "reset",
485
+ "description": "Resets component to initial state.",
486
+ "return": {
487
+ "type": {
488
+ "text": "void"
438
489
  }
439
- ],
440
- "description": "Update displayValue or input.value, it's called when making a selection.",
441
- "privacy": "private"
490
+ }
442
491
  },
443
492
  {
444
493
  "kind": "method",
445
- "name": "syncInputValuesAcrossTriggerAndBib",
446
- "parameters": [
447
- {
448
- "name": "nextValue",
449
- "description": "The value to write to both inputs.",
450
- "type": {
451
- "text": "string"
452
- }
453
- }
454
- ],
455
- "description": "Writes nextValue to the trigger input and the bib input when their current\nvalue differs, then re-asserts imask after Lit's update flushes.",
494
+ "name": "updateAriaLabel",
495
+ "description": "Updates the aria-label based on slot content.",
496
+ "privacy": "private",
456
497
  "return": {
457
498
  "type": {
458
- "text": "Promise<void>"
499
+ "text": "void"
459
500
  }
460
- },
461
- "privacy": "private"
501
+ }
462
502
  },
463
503
  {
464
504
  "kind": "method",
465
- "name": "handleMenuOptions",
505
+ "name": "handleKeyDown",
466
506
  "parameters": [
467
507
  {
468
- "name": "{ preferComboboxValue = false }",
469
- "default": "{}"
470
- },
471
- {
472
- "description": "Optional flag bag.",
473
- "name": "options",
474
- "optional": true,
508
+ "name": "event",
509
+ "description": "The keydown event from the checkbox input.",
475
510
  "type": {
476
- "text": "@param {boolean} [options.preferComboboxValue=false] - When true,\n * handleMenuOptions matches the selected option against `this.value`\n * first instead of `this.input.value`. Needed on mount and re-mount\n * because under `persistInput` the consumer's typedValue prop can drift\n * from the framework value (Svelte `{#key}` re-mount after a swap, or\n * SPA preselect after route change) and the old input-first match would\n * then pick the stale text. Only handleSlotChange passes this; typing\n * and clearing paths keep the input-first match so user clears aren't\n * undone.\n * "
511
+ "text": "KeyboardEvent"
477
512
  }
478
513
  }
479
514
  ],
480
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
515
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
481
516
  "privacy": "private",
482
517
  "return": {
483
518
  "type": {
@@ -486,175 +521,391 @@
486
521
  }
487
522
  },
488
523
  {
489
- "kind": "method",
490
- "name": "generateOptionsArray",
491
- "description": "Determines the element error state based on the `required` attribute and input value.",
492
- "privacy": "private",
493
- "return": {
494
- "type": {
495
- "text": "void"
496
- }
497
- }
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
498
534
  },
499
535
  {
500
- "kind": "method",
501
- "name": "hideBib",
502
- "description": "Hides the dropdown bib if its open.",
503
- "return": {
504
- "type": {
505
- "text": "void"
506
- }
507
- }
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
508
545
  },
509
546
  {
510
- "kind": "method",
511
- "name": "showBib",
512
- "description": "Shows the dropdown bib if there are options to show.",
513
- "return": {
514
- "type": {
515
- "text": "void"
516
- }
517
- }
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
518
556
  },
519
557
  {
520
- "kind": "method",
521
- "name": "configureDropdown",
522
- "description": "Binds all behavior needed to the dropdown after rendering.",
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
567
+ },
568
+ {
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
578
+ },
579
+ {
580
+ "kind": "field",
581
+ "name": "inputId",
523
582
  "privacy": "private",
524
- "return": {
525
- "type": {
526
- "text": "void"
527
- }
528
- }
583
+ "type": {
584
+ "text": "string"
585
+ },
586
+ "description": "The id for input node."
529
587
  },
530
588
  {
531
- "kind": "method",
532
- "name": "setClearBtnFocus",
533
- "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"
534
597
  },
535
598
  {
536
- "kind": "method",
537
- "name": "setTriggerInputFocus",
538
- "privacy": "private"
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
539
608
  },
540
609
  {
541
- "kind": "method",
542
- "name": "setInputFocus",
543
- "privacy": "private"
610
+ "kind": "field",
611
+ "name": "touched",
612
+ "privacy": "private",
613
+ "type": {
614
+ "text": "boolean"
615
+ },
616
+ "description": "Indicates whether the checkbox has been interacted with."
544
617
  },
545
618
  {
546
- "kind": "method",
547
- "name": "updateBibDialogRole",
548
- "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.",
549
- "privacy": "private"
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"
550
627
  },
551
628
  {
552
- "kind": "method",
553
- "name": "updateMenuShapeSize",
554
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
555
- "privacy": "private"
629
+ "kind": "field",
630
+ "name": "tabIndex",
631
+ "privacy": "private",
632
+ "type": {
633
+ "text": "number"
634
+ },
635
+ "description": "The tabindex attribute for the checkbox.",
636
+ "attribute": "tabindex",
637
+ "reflects": true
556
638
  },
557
639
  {
558
- "kind": "method",
559
- "name": "_getAnnouncementRoot",
560
- "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.",
640
+ "kind": "field",
641
+ "name": "ariaChecked",
561
642
  "privacy": "private",
562
- "return": {
563
- "type": {
564
- "text": "ShadowRoot"
565
- }
566
- }
643
+ "type": {
644
+ "text": "string"
645
+ },
646
+ "description": "The aria-checked attribute for the checkbox.",
647
+ "attribute": "aria-checked",
648
+ "reflects": true
567
649
  },
568
650
  {
569
- "kind": "method",
570
- "name": "configureMenu",
571
- "description": "Binds all behavior needed to the menu after rendering.",
651
+ "kind": "field",
652
+ "name": "ariaDisabled",
572
653
  "privacy": "private",
573
- "return": {
574
- "type": {
575
- "text": "void"
576
- }
577
- }
654
+ "type": {
655
+ "text": "string"
656
+ },
657
+ "description": "The aria-disabled attribute for the checkbox.",
658
+ "attribute": "aria-disabled",
659
+ "reflects": true
578
660
  },
579
661
  {
580
- "kind": "method",
581
- "name": "configureInput",
582
- "description": "Binds all behavior needed to the input after rendering.",
662
+ "kind": "field",
663
+ "name": "role",
583
664
  "privacy": "private",
584
- "return": {
585
- "type": {
586
- "text": "void"
587
- }
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"
588
678
  }
589
679
  },
590
680
  {
591
- "kind": "method",
592
- "name": "handleMenuLoadingChange",
593
- "parameters": [
594
- {
595
- "name": "event",
596
- "description": "The event object containing details about the loading state change.",
597
- "type": {
598
- "text": "CustomEvent"
599
- }
600
- },
601
- {
602
- "description": "Indicates whether the menu is currently loading.",
603
- "name": "event.detail.loading",
604
- "type": {
605
- "text": "boolean"
606
- }
607
- },
608
- {
609
- "description": "Indicates if there are loading placeholders present.",
610
- "name": "event.detail.hasLoadingPlaceholder",
611
- "type": {
612
- "text": "boolean"
613
- }
614
- }
615
- ],
616
- "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.",
617
- "privacy": "private",
618
- "return": {
619
- "type": {
620
- "text": "void"
621
- }
681
+ "name": "auroCheckbox-focusin",
682
+ "type": {
683
+ "text": "CustomEvent"
684
+ }
685
+ },
686
+ {
687
+ "name": "auroCheckbox-focusout",
688
+ "type": {
689
+ "text": "CustomEvent"
622
690
  }
623
691
  },
692
+ {
693
+ "description": "(Deprecated) Notifies when checked value is changed.",
694
+ "name": "change"
695
+ },
696
+ {
697
+ "description": "Notifies when when checked value is changed by user's interface.",
698
+ "name": "input"
699
+ }
700
+ ],
701
+ "attributes": [
702
+ {
703
+ "name": "appearance",
704
+ "type": {
705
+ "text": "'default' | 'inverse'"
706
+ },
707
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
708
+ "default": "'default'",
709
+ "fieldName": "appearance"
710
+ },
711
+ {
712
+ "name": "checked",
713
+ "type": {
714
+ "text": "boolean"
715
+ },
716
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
717
+ "fieldName": "checked"
718
+ },
719
+ {
720
+ "name": "disabled",
721
+ "type": {
722
+ "text": "boolean"
723
+ },
724
+ "description": "If set to true, the checkbox will not be clickable.",
725
+ "fieldName": "disabled"
726
+ },
727
+ {
728
+ "name": "error",
729
+ "type": {
730
+ "text": "boolean"
731
+ },
732
+ "description": "If set to true, the checkbox will be displayed with an error state.",
733
+ "fieldName": "error"
734
+ },
735
+ {
736
+ "name": "id",
737
+ "type": {
738
+ "text": "string"
739
+ },
740
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
741
+ "fieldName": "id"
742
+ },
743
+ {
744
+ "name": "name",
745
+ "type": {
746
+ "text": "string"
747
+ },
748
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
749
+ "fieldName": "name"
750
+ },
751
+ {
752
+ "name": "onDark",
753
+ "type": {
754
+ "text": "boolean"
755
+ },
756
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
757
+ "fieldName": "onDark"
758
+ },
759
+ {
760
+ "name": "value",
761
+ "type": {
762
+ "text": "string"
763
+ },
764
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
765
+ "fieldName": "value"
766
+ },
767
+ {
768
+ "name": "tabindex",
769
+ "type": {
770
+ "text": "number"
771
+ },
772
+ "description": "The tabindex attribute for the checkbox.",
773
+ "fieldName": "tabIndex"
774
+ },
775
+ {
776
+ "name": "aria-checked",
777
+ "type": {
778
+ "text": "string"
779
+ },
780
+ "description": "The aria-checked attribute for the checkbox.",
781
+ "fieldName": "ariaChecked"
782
+ },
783
+ {
784
+ "name": "aria-disabled",
785
+ "type": {
786
+ "text": "string"
787
+ },
788
+ "description": "The aria-disabled attribute for the checkbox.",
789
+ "fieldName": "ariaDisabled"
790
+ },
791
+ {
792
+ "name": "role",
793
+ "type": {
794
+ "text": "string"
795
+ },
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"
860
+ },
861
+ {
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": [
624
879
  {
625
880
  "kind": "method",
626
- "name": "handleInputValueChange",
881
+ "name": "register",
882
+ "static": true,
627
883
  "parameters": [
628
884
  {
629
- "name": "event",
630
- "description": "The input event triggered by the input element.",
885
+ "name": "name",
886
+ "default": "\"auro-bibtemplate\"",
887
+ "description": "The name of element that you want to register to.",
888
+ "optional": true,
631
889
  "type": {
632
- "text": "Event"
890
+ "text": "string"
633
891
  }
634
892
  }
635
893
  ],
636
- "description": "Handle changes to the input value and trigger changes that should result.",
637
- "privacy": "private",
638
- "return": {
639
- "type": {
640
- "text": "void"
641
- }
642
- }
894
+ "description": "This will register this element with the browser."
643
895
  },
644
896
  {
645
897
  "kind": "method",
646
- "name": "handleTriggerInputValueChange",
898
+ "name": "preventBodyScroll",
647
899
  "parameters": [
648
900
  {
649
901
  "name": "event",
650
- "description": "The input event from the trigger input element.",
902
+ "description": "The touchmove event.",
651
903
  "type": {
652
904
  "text": "Event"
653
905
  }
654
906
  }
655
907
  ],
656
- "description": "Handles input value changes originating from the trigger input.\nRefreshes menu options and filtering, delegates to handleInputValueChange\nfor value synchronization, and manages fullscreen bib focus.",
657
- "privacy": "private",
908
+ "description": "Prevents scrolling of the body when touching empty areas of the component.",
658
909
  "return": {
659
910
  "type": {
660
911
  "text": "void"
@@ -663,9 +914,8 @@
663
914
  },
664
915
  {
665
916
  "kind": "method",
666
- "name": "configureCombobox",
667
- "description": "Binds all behavior needed to the combobox after rendering.",
668
- "privacy": "private",
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.",
669
919
  "return": {
670
920
  "type": {
671
921
  "text": "void"
@@ -674,131 +924,12 @@
674
924
  },
675
925
  {
676
926
  "kind": "method",
677
- "name": "focus",
678
- "description": "Focuses the combobox trigger input.",
679
- "return": {
680
- "type": {
681
- "text": "void"
682
- }
683
- }
684
- },
685
- {
686
- "kind": "method",
687
- "name": "setMenuValue",
688
- "parameters": [
689
- {
690
- "name": "value",
691
- "description": "The value to set on the menu.",
692
- "type": {
693
- "text": "string"
694
- }
695
- }
696
- ],
697
- "description": "Sets the menu value if menu is available.",
698
- "return": {
699
- "type": {
700
- "text": "void"
701
- }
702
- }
703
- },
704
- {
705
- "kind": "method",
706
- "name": "reset",
707
- "description": "Resets component to initial state.",
708
- "return": {
709
- "type": {
710
- "text": "void"
711
- }
712
- }
713
- },
714
- {
715
- "kind": "method",
716
- "name": "clear",
717
- "description": "Clears the current value of the combobox.",
718
- "return": {
719
- "type": {
720
- "text": "void"
721
- }
722
- }
723
- },
724
- {
725
- "kind": "method",
726
- "name": "validate",
727
- "parameters": [
728
- {
729
- "name": "force",
730
- "default": "false",
731
- "description": "Whether to force validation.",
732
- "optional": true,
733
- "type": {
734
- "text": "boolean"
735
- }
736
- }
737
- ],
738
- "description": "Validates value."
739
- },
740
- {
741
- "kind": "method",
742
- "name": "transportAssignedNodes",
743
- "parameters": [
744
- {
745
- "name": "slot",
746
- "description": "The slot element containing the nodes to apply.",
747
- "type": {
748
- "text": "HTMLSlotElement"
749
- }
750
- },
751
- {
752
- "name": "target",
753
- "description": "The target element to apply the nodes to.",
754
- "type": {
755
- "text": "HTMLElement"
756
- }
757
- },
758
- {
759
- "name": "newSlotName",
760
- "description": "The new slot name for the applied nodes.",
761
- "type": {
762
- "text": "string"
763
- }
764
- }
765
- ],
766
- "description": "Applies slotted nodes to a target element with a new slot name.",
767
- "privacy": "private",
768
- "return": {
769
- "type": {
770
- "text": "void"
771
- }
772
- }
773
- },
774
- {
775
- "kind": "method",
776
- "name": "updateActiveOption",
777
- "parameters": [
778
- {
779
- "name": "index",
780
- "description": "Index of the option to make active.",
781
- "type": {
782
- "text": "number"
783
- }
784
- }
785
- ],
786
- "description": "Updates the active option in the menu."
927
+ "name": "onCloseButtonClick"
787
928
  },
788
929
  {
789
930
  "kind": "method",
790
- "name": "handleSlotChange",
791
- "parameters": [
792
- {
793
- "name": "event",
794
- "description": "`slotchange` event.",
795
- "type": {
796
- "text": "Event"
797
- }
798
- }
799
- ],
800
- "description": "Watch for slot changes and recalculate the menuoptions.",
801
- "privacy": "private",
931
+ "name": "exposeCssParts",
932
+ "description": "Exposes CSS parts for styling from parent components.",
802
933
  "return": {
803
934
  "type": {
804
935
  "text": "void"
@@ -807,994 +938,565 @@
807
938
  },
808
939
  {
809
940
  "kind": "field",
810
- "name": "appearance",
811
- "privacy": "public",
812
- "type": {
813
- "text": "string"
814
- },
815
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
816
- "default": "'default'",
817
- "attribute": "appearance",
818
- "reflects": true
819
- },
820
- {
821
- "kind": "field",
822
- "name": "autocomplete",
941
+ "name": "large",
823
942
  "privacy": "public",
824
943
  "type": {
825
- "text": "string"
944
+ "text": "boolean"
826
945
  },
827
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
828
- "attribute": "autocomplete",
946
+ "default": "false",
947
+ "attribute": "large",
829
948
  "reflects": true
830
949
  },
831
950
  {
832
951
  "kind": "field",
833
- "name": "autoPlacement",
834
- "privacy": "public",
835
- "type": {
836
- "text": "boolean"
837
- },
838
- "description": "If declared, bib's position will be automatically calculated where to appear.",
839
- "attribute": "autoPlacement",
840
- "reflects": true
952
+ "name": "iconTag",
953
+ "privacy": "private"
841
954
  },
842
955
  {
843
956
  "kind": "field",
844
- "name": "availableOptions",
845
- "privacy": "private",
846
- "type": {
847
- "text": "array"
848
- },
849
- "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).",
850
- "attribute": "availableOptions"
957
+ "name": "headerTag",
958
+ "privacy": "private"
851
959
  },
852
960
  {
853
961
  "kind": "field",
854
- "name": "behavior",
855
- "privacy": "public",
856
- "type": {
857
- "text": "'filter' | 'suggestion'"
858
- },
859
- "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.",
860
- "default": "'suggestion'",
861
- "attribute": "behavior",
862
- "reflects": true
962
+ "name": "buttonTag",
963
+ "privacy": "private"
863
964
  },
864
965
  {
865
966
  "kind": "field",
866
- "name": "checkmark",
967
+ "name": "isFullscreen",
867
968
  "privacy": "public",
868
969
  "type": {
869
970
  "text": "boolean"
870
971
  },
871
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
872
- "attribute": "checkmark",
972
+ "attribute": "isFullscreen",
873
973
  "reflects": true
874
974
  },
875
975
  {
876
976
  "kind": "field",
877
- "name": "disabled",
977
+ "name": "showFooter",
878
978
  "privacy": "public",
879
979
  "type": {
880
980
  "text": "boolean"
881
981
  },
882
- "description": "If set, disables the combobox.",
883
- "attribute": "disabled",
982
+ "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
983
+ "attribute": "showFooter",
884
984
  "reflects": true
885
- },
985
+ }
986
+ ],
987
+ "events": [
886
988
  {
887
- "kind": "field",
888
- "name": "dropdownId",
889
- "privacy": "private",
989
+ "name": "close-click",
890
990
  "type": {
891
- "text": "string"
892
- },
893
- "description": "ID for the dropdown."
991
+ "text": "Event"
992
+ }
894
993
  },
895
994
  {
896
- "kind": "field",
897
- "name": "dropdownOpen",
898
- "privacy": "private",
995
+ "name": "auro-bibtemplate-connected",
899
996
  "type": {
900
- "text": "boolean"
901
- },
902
- "description": "Whether or not the dropdown is open."
903
- },
997
+ "text": "CustomEvent"
998
+ }
999
+ }
1000
+ ],
1001
+ "attributes": [
904
1002
  {
905
- "kind": "field",
906
- "name": "dvInputOnly",
907
- "privacy": "public",
1003
+ "name": "isFullscreen",
908
1004
  "type": {
909
1005
  "text": "boolean"
910
1006
  },
911
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
912
- "attribute": "dvInputOnly",
913
- "reflects": true
914
- },
915
- {
916
- "kind": "field",
917
- "name": "error",
918
- "privacy": "public",
919
- "type": {
920
- "text": "string"
921
- },
922
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
923
- "attribute": "error",
924
- "reflects": true
925
- },
926
- {
927
- "kind": "field",
928
- "name": "format",
929
- "privacy": "public",
930
- "type": {
931
- "text": "string"
932
- },
933
- "description": "Specifies the input mask format.",
934
- "attribute": "format",
935
- "reflects": true
1007
+ "fieldName": "isFullscreen"
936
1008
  },
937
1009
  {
938
- "kind": "field",
939
- "name": "inputmode",
940
- "privacy": "public",
1010
+ "name": "large",
941
1011
  "type": {
942
- "text": "string"
1012
+ "text": "boolean"
943
1013
  },
944
- "description": "Exposes inputmode attribute for input.",
945
- "attribute": "inputmode",
946
- "reflects": true
1014
+ "default": "false",
1015
+ "fieldName": "large"
947
1016
  },
948
1017
  {
949
- "kind": "field",
950
- "name": "layout",
951
- "privacy": "public",
1018
+ "name": "showFooter",
952
1019
  "type": {
953
- "text": "string"
1020
+ "text": "boolean"
954
1021
  },
955
- "description": "Sets the layout of the combobox.",
956
- "default": "'classic'",
957
- "attribute": "layout",
958
- "reflects": true,
959
- "inheritedFrom": {
960
- "name": "AuroElement",
961
- "module": "components/layoutElement/src/auroElement.js"
962
- }
963
- },
964
- {
965
- "kind": "field",
966
- "name": "matchWidth",
967
- "privacy": "private",
968
- "type": {
969
- "text": "boolean"
970
- },
971
- "description": "If declared, the popover and trigger will be set to the same width.",
972
- "attribute": "matchWidth",
973
- "reflects": true
974
- },
975
- {
976
- "kind": "field",
977
- "name": "noFilter",
978
- "privacy": "public",
979
- "type": {
980
- "text": "boolean"
981
- },
982
- "description": "If set, combobox will not filter menuoptions based on input.",
983
- "attribute": "noFilter",
984
- "reflects": true
985
- },
986
- {
987
- "kind": "field",
988
- "name": "noFlip",
989
- "privacy": "public",
990
- "type": {
991
- "text": "boolean"
992
- },
993
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
994
- "attribute": "noFlip",
995
- "reflects": true
996
- },
997
- {
998
- "kind": "field",
999
- "name": "shift",
1000
- "privacy": "public",
1001
- "type": {
1002
- "text": "boolean"
1003
- },
1004
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1005
- "attribute": "shift",
1006
- "reflects": true
1007
- },
1008
- {
1009
- "kind": "field",
1010
- "name": "noValidate",
1011
- "privacy": "public",
1012
- "type": {
1013
- "text": "boolean"
1014
- },
1015
- "description": "If set, disables auto-validation on blur.",
1016
- "attribute": "noValidate",
1017
- "reflects": true
1018
- },
1019
- {
1020
- "kind": "field",
1021
- "name": "offset",
1022
- "privacy": "public",
1023
- "type": {
1024
- "text": "number"
1025
- },
1026
- "description": "Gap between the trigger element and bib.",
1027
- "default": "0",
1028
- "attribute": "offset",
1029
- "reflects": true
1030
- },
1031
- {
1032
- "kind": "field",
1033
- "name": "onDark",
1034
- "privacy": "public",
1035
- "type": {
1036
- "text": "boolean"
1037
- },
1038
- "attribute": "onDark",
1039
- "reflects": true,
1040
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1041
- "inheritedFrom": {
1042
- "name": "AuroElement",
1043
- "module": "components/layoutElement/src/auroElement.js"
1044
- }
1045
- },
1046
- {
1047
- "kind": "field",
1048
- "name": "optionSelected",
1049
- "privacy": "public",
1050
- "type": {
1051
- "text": "HTMLElement"
1052
- },
1053
- "description": "Specifies the current selected option.",
1054
- "attribute": "optionSelected"
1055
- },
1056
- {
1057
- "kind": "field",
1058
- "name": "persistInput",
1059
- "privacy": "public",
1060
- "type": {
1061
- "text": "boolean"
1062
- },
1063
- "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.",
1064
- "attribute": "persistInput",
1065
- "reflects": true
1066
- },
1067
- {
1068
- "kind": "field",
1069
- "name": "placement",
1070
- "privacy": "public",
1071
- "type": {
1072
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1073
- },
1074
- "description": "Position where the bib should appear relative to the trigger.",
1075
- "default": "'bottom-start'",
1076
- "attribute": "placement",
1077
- "reflects": true
1078
- },
1079
- {
1080
- "kind": "field",
1081
- "name": "placeholder",
1082
- "privacy": "public",
1083
- "type": {
1084
- "text": "string"
1085
- },
1086
- "description": "Define custom placeholder text, only supported by date input formats.",
1087
- "attribute": "placeholder",
1088
- "reflects": true
1089
- },
1090
- {
1091
- "kind": "field",
1092
- "name": "required",
1093
- "privacy": "public",
1094
- "type": {
1095
- "text": "boolean"
1096
- },
1097
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1098
- "attribute": "required",
1099
- "reflects": true
1100
- },
1101
- {
1102
- "kind": "field",
1103
- "name": "setCustomValidity",
1104
- "privacy": "public",
1105
- "type": {
1106
- "text": "string"
1107
- },
1108
- "description": "Sets a custom help text message to display for all validityStates.",
1109
- "attribute": "setCustomValidity"
1110
- },
1111
- {
1112
- "kind": "field",
1113
- "name": "setCustomValidityCustomError",
1114
- "privacy": "public",
1115
- "type": {
1116
- "text": "string"
1117
- },
1118
- "description": "Custom help text message to display when validity = `customError`.",
1119
- "attribute": "setCustomValidityCustomError"
1120
- },
1121
- {
1122
- "kind": "field",
1123
- "name": "setCustomValidityValueMissing",
1124
- "privacy": "public",
1125
- "type": {
1126
- "text": "string"
1127
- },
1128
- "description": "Custom help text message to display when validity = `valueMissing`.",
1129
- "attribute": "setCustomValidityValueMissing"
1130
- },
1131
- {
1132
- "kind": "field",
1133
- "name": "setCustomValidityValueMissingFilter",
1134
- "privacy": "public",
1135
- "type": {
1136
- "text": "string"
1137
- },
1138
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1139
- "attribute": "setCustomValidityValueMissingFilter"
1140
- },
1141
- {
1142
- "kind": "field",
1143
- "name": "touched",
1144
- "privacy": "private",
1145
- "type": {
1146
- "text": "boolean"
1147
- },
1148
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1149
- },
1150
- {
1151
- "kind": "field",
1152
- "name": "triggerIcon",
1153
- "privacy": "public",
1154
- "type": {
1155
- "text": "boolean"
1156
- },
1157
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1158
- "attribute": "triggerIcon",
1159
- "reflects": true
1160
- },
1161
- {
1162
- "kind": "field",
1163
- "name": "type",
1164
- "privacy": "public",
1165
- "type": {
1166
- "text": "string"
1167
- },
1168
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1169
- "attribute": "type",
1170
- "reflects": true
1171
- },
1172
- {
1173
- "kind": "field",
1174
- "name": "typedValue",
1175
- "privacy": "public",
1176
- "type": {
1177
- "text": "string"
1178
- },
1179
- "description": "Specifies the value of the input element within the combobox.",
1180
- "attribute": "typedValue",
1181
- "reflects": true
1182
- },
1183
- {
1184
- "kind": "field",
1185
- "name": "validity",
1186
- "privacy": "public",
1187
- "type": {
1188
- "text": "string"
1189
- },
1190
- "description": "Specifies the `validityState` this element is in.",
1191
- "attribute": "validity",
1192
- "reflects": true
1193
- },
1194
- {
1195
- "kind": "field",
1196
- "name": "value",
1197
- "privacy": "public",
1198
- "type": {
1199
- "text": "string"
1200
- },
1201
- "description": "Value selected for the dropdown menu.",
1202
- "attribute": "value"
1203
- },
1204
- {
1205
- "kind": "field",
1206
- "name": "largeFullscreenHeadline",
1207
- "privacy": "public",
1208
- "type": {
1209
- "text": "boolean"
1210
- },
1211
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1212
- "attribute": "largeFullscreenHeadline",
1213
- "reflects": true
1214
- },
1215
- {
1216
- "kind": "field",
1217
- "name": "fullscreenBreakpoint",
1218
- "privacy": "public",
1219
- "type": {
1220
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1221
- },
1222
- "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.",
1223
- "default": "'sm'",
1224
- "attribute": "fullscreenBreakpoint",
1225
- "reflects": true
1226
- },
1227
- {
1228
- "kind": "field",
1229
- "name": "optionActive",
1230
- "privacy": "private",
1231
- "type": {
1232
- "text": "object"
1233
- },
1234
- "description": "Specifies the currently active option."
1235
- },
1236
- {
1237
- "kind": "field",
1238
- "name": "componentHasFocus",
1239
- "description": "Returns true if the element has focus.",
1240
- "privacy": "private",
1241
- "return": {
1242
- "type": {
1243
- "text": "boolean"
1244
- }
1245
- },
1246
- "readonly": true,
1247
- "inheritedFrom": {
1248
- "name": "AuroElement",
1249
- "module": "components/layoutElement/src/auroElement.js"
1250
- }
1251
- },
1252
- {
1253
- "kind": "method",
1254
- "name": "resetShapeClasses",
1255
- "inheritedFrom": {
1256
- "name": "AuroElement",
1257
- "module": "components/layoutElement/src/auroElement.js"
1258
- }
1259
- },
1260
- {
1261
- "kind": "method",
1262
- "name": "resetLayoutClasses",
1263
- "inheritedFrom": {
1264
- "name": "AuroElement",
1265
- "module": "components/layoutElement/src/auroElement.js"
1266
- }
1267
- },
1268
- {
1269
- "kind": "method",
1270
- "name": "updateComponentArchitecture",
1271
- "inheritedFrom": {
1272
- "name": "AuroElement",
1273
- "module": "components/layoutElement/src/auroElement.js"
1274
- }
1275
- },
1276
- {
1277
- "kind": "field",
1278
- "name": "shape",
1279
- "privacy": "public",
1280
- "type": {
1281
- "text": "string"
1282
- },
1283
- "attribute": "shape",
1284
- "reflects": true,
1285
- "inheritedFrom": {
1286
- "name": "AuroElement",
1287
- "module": "components/layoutElement/src/auroElement.js"
1288
- }
1289
- },
1290
- {
1291
- "kind": "field",
1292
- "name": "size",
1293
- "privacy": "public",
1294
- "type": {
1295
- "text": "string"
1296
- },
1297
- "attribute": "size",
1298
- "reflects": true,
1299
- "inheritedFrom": {
1300
- "name": "AuroElement",
1301
- "module": "components/layoutElement/src/auroElement.js"
1302
- }
1303
- }
1304
- ],
1305
- "events": [
1306
- {
1307
- "name": "inputValue",
1308
- "type": {
1309
- "text": "CustomEvent"
1310
- },
1311
- "description": "Notifies that the components internal HTML5 input value has changed."
1312
- },
1313
- {
1314
- "name": "input",
1315
- "type": {
1316
- "text": "CustomEvent"
1317
- },
1318
- "description": "Notifies that the component has a new value set."
1319
- },
1320
- {
1321
- "name": "auroCombobox-valueSet",
1322
- "type": {
1323
- "text": "CustomEvent"
1324
- },
1325
- "description": "(Deprecated) Notifies that the component has a new value set."
1326
- },
1327
- {
1328
- "description": "Notifies that the component value(s) have been validated.",
1329
- "name": "auroFormElement-validated"
1330
- }
1331
- ],
1332
- "attributes": [
1333
- {
1334
- "name": "appearance",
1335
- "type": {
1336
- "text": "string"
1337
- },
1338
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1339
- "default": "'default'",
1340
- "fieldName": "appearance"
1341
- },
1342
- {
1343
- "name": "autocomplete",
1344
- "type": {
1345
- "text": "string"
1346
- },
1347
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1348
- "fieldName": "autocomplete"
1349
- },
1350
- {
1351
- "name": "autoPlacement",
1352
- "type": {
1353
- "text": "boolean"
1354
- },
1355
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1356
- "fieldName": "autoPlacement"
1357
- },
1358
- {
1359
- "name": "availableOptions",
1360
- "type": {
1361
- "text": "array"
1362
- },
1363
- "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).",
1364
- "fieldName": "availableOptions"
1365
- },
1366
- {
1367
- "name": "behavior",
1368
- "type": {
1369
- "text": "'filter' | 'suggestion'"
1370
- },
1371
- "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.",
1372
- "default": "'suggestion'",
1373
- "fieldName": "behavior"
1374
- },
1375
- {
1376
- "name": "checkmark",
1377
- "type": {
1378
- "text": "boolean"
1379
- },
1380
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1381
- "fieldName": "checkmark"
1382
- },
1383
- {
1384
- "name": "disabled",
1385
- "type": {
1386
- "text": "boolean"
1387
- },
1388
- "description": "If set, disables the combobox.",
1389
- "fieldName": "disabled"
1390
- },
1391
- {
1392
- "name": "dvInputOnly",
1393
- "type": {
1394
- "text": "boolean"
1395
- },
1396
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1397
- "fieldName": "dvInputOnly"
1398
- },
1399
- {
1400
- "name": "error",
1401
- "type": {
1402
- "text": "string"
1403
- },
1404
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1405
- "fieldName": "error"
1406
- },
1407
- {
1408
- "name": "format",
1409
- "type": {
1410
- "text": "string"
1411
- },
1412
- "description": "Specifies the input mask format.",
1413
- "fieldName": "format"
1414
- },
1415
- {
1416
- "name": "inputmode",
1417
- "type": {
1418
- "text": "string"
1419
- },
1420
- "description": "Exposes inputmode attribute for input.",
1421
- "fieldName": "inputmode"
1422
- },
1423
- {
1424
- "name": "layout",
1425
- "type": {
1426
- "text": "string"
1427
- },
1428
- "description": "Sets the layout of the combobox.",
1429
- "default": "'classic'",
1430
- "fieldName": "layout",
1431
- "inheritedFrom": {
1432
- "name": "AuroElement",
1433
- "module": "components/layoutElement/src/auroElement.js"
1434
- }
1435
- },
1436
- {
1437
- "name": "matchWidth",
1438
- "type": {
1439
- "text": "boolean"
1440
- },
1441
- "description": "If declared, the popover and trigger will be set to the same width.",
1442
- "fieldName": "matchWidth"
1443
- },
1444
- {
1445
- "name": "noFilter",
1446
- "type": {
1447
- "text": "boolean"
1448
- },
1449
- "description": "If set, combobox will not filter menuoptions based on input.",
1450
- "fieldName": "noFilter"
1451
- },
1452
- {
1453
- "name": "noFlip",
1454
- "type": {
1455
- "text": "boolean"
1456
- },
1457
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1458
- "fieldName": "noFlip"
1459
- },
1460
- {
1461
- "name": "shift",
1462
- "type": {
1463
- "text": "boolean"
1464
- },
1465
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1466
- "fieldName": "shift"
1467
- },
1468
- {
1469
- "name": "noValidate",
1470
- "type": {
1471
- "text": "boolean"
1472
- },
1473
- "description": "If set, disables auto-validation on blur.",
1474
- "fieldName": "noValidate"
1475
- },
1476
- {
1477
- "name": "offset",
1478
- "type": {
1479
- "text": "number"
1480
- },
1481
- "description": "Gap between the trigger element and bib.",
1482
- "default": "0",
1483
- "fieldName": "offset"
1484
- },
1485
- {
1486
- "name": "onDark",
1487
- "type": {
1488
- "text": "boolean"
1489
- },
1490
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1491
- "fieldName": "onDark"
1492
- },
1493
- {
1494
- "name": "optionSelected",
1495
- "type": {
1496
- "text": "HTMLElement"
1497
- },
1498
- "description": "Specifies the current selected option.",
1499
- "fieldName": "optionSelected"
1500
- },
1501
- {
1502
- "name": "persistInput",
1503
- "type": {
1504
- "text": "boolean"
1505
- },
1506
- "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.",
1507
- "fieldName": "persistInput"
1508
- },
1509
- {
1510
- "name": "placement",
1511
- "type": {
1512
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1513
- },
1514
- "description": "Position where the bib should appear relative to the trigger.",
1515
- "default": "'bottom-start'",
1516
- "fieldName": "placement"
1517
- },
1518
- {
1519
- "name": "placeholder",
1520
- "type": {
1521
- "text": "string"
1522
- },
1523
- "description": "Define custom placeholder text, only supported by date input formats.",
1524
- "fieldName": "placeholder"
1525
- },
1526
- {
1527
- "name": "required",
1528
- "type": {
1529
- "text": "boolean"
1530
- },
1531
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1532
- "fieldName": "required"
1533
- },
1534
- {
1535
- "name": "setCustomValidity",
1536
- "type": {
1537
- "text": "string"
1538
- },
1539
- "description": "Sets a custom help text message to display for all validityStates.",
1540
- "fieldName": "setCustomValidity"
1541
- },
1542
- {
1543
- "name": "setCustomValidityCustomError",
1544
- "type": {
1545
- "text": "string"
1546
- },
1547
- "description": "Custom help text message to display when validity = `customError`.",
1548
- "fieldName": "setCustomValidityCustomError"
1549
- },
1550
- {
1551
- "name": "setCustomValidityValueMissing",
1552
- "type": {
1553
- "text": "string"
1554
- },
1555
- "description": "Custom help text message to display when validity = `valueMissing`.",
1556
- "fieldName": "setCustomValidityValueMissing"
1557
- },
1558
- {
1559
- "name": "setCustomValidityValueMissingFilter",
1560
- "type": {
1561
- "text": "string"
1562
- },
1563
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1564
- "fieldName": "setCustomValidityValueMissingFilter"
1565
- },
1566
- {
1567
- "name": "triggerIcon",
1568
- "type": {
1569
- "text": "boolean"
1570
- },
1571
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1572
- "fieldName": "triggerIcon"
1573
- },
1574
- {
1575
- "name": "type",
1576
- "type": {
1577
- "text": "string"
1578
- },
1579
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1580
- "fieldName": "type"
1581
- },
1582
- {
1583
- "name": "typedValue",
1584
- "type": {
1585
- "text": "string"
1586
- },
1587
- "description": "Specifies the value of the input element within the combobox.",
1588
- "fieldName": "typedValue"
1589
- },
1590
- {
1591
- "name": "validity",
1592
- "type": {
1593
- "text": "string"
1594
- },
1595
- "description": "Specifies the `validityState` this element is in.",
1596
- "fieldName": "validity"
1597
- },
1598
- {
1599
- "name": "value",
1600
- "type": {
1601
- "text": "string"
1602
- },
1603
- "description": "Value selected for the dropdown menu.",
1604
- "fieldName": "value"
1605
- },
1606
- {
1607
- "name": "largeFullscreenHeadline",
1608
- "type": {
1609
- "text": "boolean"
1610
- },
1611
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1612
- "fieldName": "largeFullscreenHeadline"
1613
- },
1614
- {
1615
- "name": "fullscreenBreakpoint",
1616
- "type": {
1617
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1618
- },
1619
- "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.",
1620
- "default": "'sm'",
1621
- "fieldName": "fullscreenBreakpoint"
1622
- },
1623
- {
1624
- "name": "shape",
1625
- "type": {
1626
- "text": "string"
1627
- },
1628
- "fieldName": "shape",
1629
- "inheritedFrom": {
1630
- "name": "AuroElement",
1631
- "module": "components/layoutElement/src/auroElement.js"
1632
- }
1633
- },
1634
- {
1635
- "name": "size",
1636
- "type": {
1637
- "text": "string"
1638
- },
1639
- "fieldName": "size",
1640
- "inheritedFrom": {
1641
- "name": "AuroElement",
1642
- "module": "components/layoutElement/src/auroElement.js"
1643
- }
1644
- },
1645
- {
1646
- "name": "ondark",
1647
- "type": {
1648
- "text": "boolean"
1649
- },
1650
- "fieldName": "onDark",
1651
- "inheritedFrom": {
1652
- "name": "AuroElement",
1653
- "module": "components/layoutElement/src/auroElement.js"
1654
- }
1022
+ "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
1023
+ "fieldName": "showFooter"
1655
1024
  }
1656
1025
  ],
1657
1026
  "superclass": {
1658
- "name": "AuroElement",
1659
- "module": "/components/layoutElement/src/auroElement.js"
1027
+ "name": "LitElement",
1028
+ "package": "lit"
1660
1029
  },
1661
- "tagName": "auro-combobox",
1030
+ "tagName": "auro-bibtemplate",
1662
1031
  "customElement": true
1663
1032
  }
1664
1033
  ],
1665
1034
  "exports": [
1666
1035
  {
1667
1036
  "kind": "js",
1668
- "name": "AuroCombobox",
1037
+ "name": "AuroBibtemplate",
1669
1038
  "declaration": {
1670
- "name": "AuroCombobox",
1671
- "module": "components/combobox/src/auro-combobox.js"
1039
+ "name": "AuroBibtemplate",
1040
+ "module": "components/bibtemplate/src/auro-bibtemplate.js"
1672
1041
  }
1673
1042
  }
1674
1043
  ]
1675
1044
  },
1676
1045
  {
1677
1046
  "kind": "javascript-module",
1678
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1679
- "declarations": [
1047
+ "path": "components/bibtemplate/src/buttonVersion.js",
1048
+ "declarations": [],
1049
+ "exports": [
1680
1050
  {
1681
- "kind": "variable",
1682
- "name": "comboboxKeyboardStrategy",
1683
- "type": {
1684
- "text": "object"
1685
- },
1686
- "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) { 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) { navigateArrow(component, 'up'); } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { // Forms should not submit on Enter from a combobox, regardless of which // child element (input, clear button, menu) is focused. evt.stopPropagation(); if (isClearBtnFocused(ctx)) { // Let the browser dispatch Enter to the focused clear button so its // built-in activation fires and clears the selection. Do NOT call // preventDefault — that would block the activation. return; } if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); } else { evt.preventDefault(); 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(); } } } }"
1051
+ "kind": "js",
1052
+ "name": "default",
1053
+ "declaration": {
1054
+ "name": "12.3.2",
1055
+ "module": "components/bibtemplate/src/buttonVersion.js"
1056
+ }
1687
1057
  }
1688
- ],
1058
+ ]
1059
+ },
1060
+ {
1061
+ "kind": "javascript-module",
1062
+ "path": "components/bibtemplate/src/headerVersion.js",
1063
+ "declarations": [],
1689
1064
  "exports": [
1690
1065
  {
1691
1066
  "kind": "js",
1692
- "name": "comboboxKeyboardStrategy",
1067
+ "name": "default",
1693
1068
  "declaration": {
1694
- "name": "comboboxKeyboardStrategy",
1695
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1069
+ "name": "5.0.1",
1070
+ "module": "components/bibtemplate/src/headerVersion.js"
1696
1071
  }
1697
1072
  }
1698
1073
  ]
1699
1074
  },
1700
1075
  {
1701
1076
  "kind": "javascript-module",
1702
- "path": "components/combobox/src/index.js",
1077
+ "path": "components/bibtemplate/src/iconVersion.js",
1703
1078
  "declarations": [],
1704
1079
  "exports": [
1705
1080
  {
1706
1081
  "kind": "js",
1707
- "name": "AuroCombobox",
1082
+ "name": "default",
1708
1083
  "declaration": {
1709
- "name": "AuroCombobox",
1710
- "module": "components/combobox/src/index.js"
1084
+ "name": "9.2.0",
1085
+ "module": "components/bibtemplate/src/iconVersion.js"
1711
1086
  }
1712
1087
  }
1713
1088
  ]
1714
1089
  },
1715
1090
  {
1716
1091
  "kind": "javascript-module",
1717
- "path": "components/combobox/src/registered.js",
1092
+ "path": "components/bibtemplate/src/index.js",
1718
1093
  "declarations": [],
1719
1094
  "exports": [
1720
1095
  {
1721
1096
  "kind": "js",
1722
- "name": "AuroCombobox",
1097
+ "name": "AuroBibtemplate",
1723
1098
  "declaration": {
1724
- "name": "AuroCombobox",
1725
- "module": "components/combobox/src/registered.js"
1099
+ "name": "AuroBibtemplate",
1100
+ "module": "components/bibtemplate/src/index.js"
1726
1101
  }
1727
1102
  }
1728
1103
  ]
1729
1104
  },
1730
1105
  {
1731
1106
  "kind": "javascript-module",
1732
- "path": "components/checkbox/src/auro-checkbox-group.js",
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",
1733
1114
  "declarations": [
1734
1115
  {
1735
1116
  "kind": "class",
1736
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1737
- "name": "AuroCheckboxGroup",
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",
1738
1119
  "slots": [
1739
1120
  {
1740
- "description": "Allows for the legend to be overridden.",
1741
- "name": "legend"
1121
+ "description": "Default slot for the menu content.",
1122
+ "name": ""
1123
+ },
1124
+ {
1125
+ "type": {
1126
+ "text": "HTMLSlotElement"
1127
+ },
1128
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1129
+ "name": "optionalLabel"
1130
+ },
1131
+ {
1132
+ "description": "Sets aria-label on clear button",
1133
+ "name": "ariaLabel.input.clear"
1134
+ },
1135
+ {
1136
+ "description": "Sets aria-label on close button in fullscreen bib",
1137
+ "name": "ariaLabel.bib.close"
1138
+ },
1139
+ {
1140
+ "description": "Defines the headline to display above menu-options",
1141
+ "name": "bib.fullscreen.headline"
1142
+ },
1143
+ {
1144
+ "description": "Defines the content of the label.",
1145
+ "name": "label"
1146
+ },
1147
+ {
1148
+ "description": "Defines the content of the helpText.",
1149
+ "name": "helpText"
1150
+ },
1151
+ {
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": [
1157
+ {
1158
+ "kind": "method",
1159
+ "name": "_initializeDefaults",
1160
+ "privacy": "private",
1161
+ "return": {
1162
+ "type": {
1163
+ "text": "void"
1164
+ }
1165
+ }
1166
+ },
1167
+ {
1168
+ "kind": "method",
1169
+ "name": "_scheduleTimer",
1170
+ "parameters": [
1171
+ {
1172
+ "name": "fn",
1173
+ "description": "Callback to run.",
1174
+ "type": {
1175
+ "text": "Function"
1176
+ }
1177
+ },
1178
+ {
1179
+ "name": "ms",
1180
+ "description": "Delay in milliseconds.",
1181
+ "type": {
1182
+ "text": "number"
1183
+ }
1184
+ }
1185
+ ],
1186
+ "description": "Wraps setTimeout and records the timer id so disconnectedCallback\ncan cancel any outstanding callbacks. The id is removed from the set\nonce the callback fires so the set doesn't grow unbounded.",
1187
+ "return": {
1188
+ "type": {
1189
+ "text": "number"
1190
+ }
1191
+ },
1192
+ "privacy": "private"
1193
+ },
1194
+ {
1195
+ "kind": "field",
1196
+ "name": "inputValue",
1197
+ "description": "Returns the current value of the input element within the combobox.",
1198
+ "return": {
1199
+ "type": {
1200
+ "text": "string|undefined"
1201
+ }
1202
+ },
1203
+ "readonly": true
1204
+ },
1205
+ {
1206
+ "kind": "method",
1207
+ "name": "isValid",
1208
+ "description": "Checks if the element is valid.",
1209
+ "return": {
1210
+ "type": {
1211
+ "text": "boolean"
1212
+ }
1213
+ }
1214
+ },
1215
+ {
1216
+ "kind": "method",
1217
+ "name": "register",
1218
+ "static": true,
1219
+ "parameters": [
1220
+ {
1221
+ "name": "name",
1222
+ "default": "'auro-combobox'",
1223
+ "description": "The name of the element that you want to register.",
1224
+ "optional": true,
1225
+ "type": {
1226
+ "text": "string"
1227
+ }
1228
+ }
1229
+ ],
1230
+ "description": "This will register this element with the browser."
1231
+ },
1232
+ {
1233
+ "kind": "method",
1234
+ "name": "activateFirstEnabledAvailableOption",
1235
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
1236
+ "privacy": "private",
1237
+ "return": {
1238
+ "type": {
1239
+ "text": "void"
1240
+ }
1241
+ }
1242
+ },
1243
+ {
1244
+ "kind": "method",
1245
+ "name": "activateLastEnabledAvailableOption",
1246
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
1247
+ "privacy": "private",
1248
+ "return": {
1249
+ "type": {
1250
+ "text": "void"
1251
+ }
1252
+ }
1253
+ },
1254
+ {
1255
+ "kind": "method",
1256
+ "name": "updateFilter",
1257
+ "description": "Updates the filter for the available options based on the input value.",
1258
+ "privacy": "private"
1259
+ },
1260
+ {
1261
+ "kind": "method",
1262
+ "name": "syncValuesAndStates",
1263
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1264
+ "privacy": "private",
1265
+ "return": {
1266
+ "type": {
1267
+ "text": "void"
1268
+ }
1269
+ }
1270
+ },
1271
+ {
1272
+ "kind": "method",
1273
+ "name": "updateTriggerTextDisplay",
1274
+ "parameters": [
1275
+ {
1276
+ "name": "label",
1277
+ "description": "The label of the selected option.",
1278
+ "type": {
1279
+ "text": "string"
1280
+ }
1281
+ }
1282
+ ],
1283
+ "description": "Update displayValue or input.value, it's called when making a selection.",
1284
+ "privacy": "private"
1285
+ },
1286
+ {
1287
+ "kind": "method",
1288
+ "name": "syncInputValuesAcrossTriggerAndBib",
1289
+ "parameters": [
1290
+ {
1291
+ "name": "nextValue",
1292
+ "description": "The value to write to both inputs.",
1293
+ "type": {
1294
+ "text": "string"
1295
+ }
1296
+ }
1297
+ ],
1298
+ "description": "Writes nextValue to the trigger input and the bib input when their current\nvalue differs, then re-asserts imask after Lit's update flushes.",
1299
+ "return": {
1300
+ "type": {
1301
+ "text": "Promise<void>"
1302
+ }
1303
+ },
1304
+ "privacy": "private"
1305
+ },
1306
+ {
1307
+ "kind": "method",
1308
+ "name": "handleMenuOptions",
1309
+ "parameters": [
1310
+ {
1311
+ "name": "{ preferComboboxValue = false }",
1312
+ "default": "{}"
1313
+ },
1314
+ {
1315
+ "description": "Optional flag bag.",
1316
+ "name": "options",
1317
+ "optional": true,
1318
+ "type": {
1319
+ "text": "@param {boolean} [options.preferComboboxValue=false] - When true,\n * handleMenuOptions matches the selected option against `this.value`\n * first instead of `this.input.value`. Needed on mount and re-mount\n * because under `persistInput` the consumer's typedValue prop can drift\n * from the framework value (Svelte `{#key}` re-mount after a swap, or\n * SPA preselect after route change) and the old input-first match would\n * then pick the stale text. Only handleSlotChange passes this; typing\n * and clearing paths keep the input-first match so user clears aren't\n * undone.\n * "
1320
+ }
1321
+ }
1322
+ ],
1323
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1324
+ "privacy": "private",
1325
+ "return": {
1326
+ "type": {
1327
+ "text": "void"
1328
+ }
1329
+ }
1330
+ },
1331
+ {
1332
+ "kind": "method",
1333
+ "name": "generateOptionsArray",
1334
+ "description": "Determines the element error state based on the `required` attribute and input value.",
1335
+ "privacy": "private",
1336
+ "return": {
1337
+ "type": {
1338
+ "text": "void"
1339
+ }
1340
+ }
1341
+ },
1342
+ {
1343
+ "kind": "method",
1344
+ "name": "hideBib",
1345
+ "description": "Hides the dropdown bib if its open.",
1346
+ "return": {
1347
+ "type": {
1348
+ "text": "void"
1349
+ }
1350
+ }
1742
1351
  },
1743
1352
  {
1744
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1745
- "name": "optionalLabel"
1353
+ "kind": "method",
1354
+ "name": "showBib",
1355
+ "description": "Shows the dropdown bib if there are options to show.",
1356
+ "return": {
1357
+ "type": {
1358
+ "text": "void"
1359
+ }
1360
+ }
1746
1361
  },
1747
1362
  {
1748
- "description": "Allows for the helper text to be overridden.",
1749
- "name": "helpText"
1363
+ "kind": "method",
1364
+ "name": "configureDropdown",
1365
+ "description": "Binds all behavior needed to the dropdown after rendering.",
1366
+ "privacy": "private",
1367
+ "return": {
1368
+ "type": {
1369
+ "text": "void"
1370
+ }
1371
+ }
1750
1372
  },
1751
1373
  {
1752
- "description": "The default slot for the checkbox items.",
1753
- "name": "default"
1754
- }
1755
- ],
1756
- "members": [
1374
+ "kind": "method",
1375
+ "name": "setClearBtnFocus",
1376
+ "privacy": "private"
1377
+ },
1757
1378
  {
1758
1379
  "kind": "method",
1759
- "name": "_initializeDefaults"
1380
+ "name": "setTriggerInputFocus",
1381
+ "privacy": "private"
1760
1382
  },
1761
1383
  {
1762
1384
  "kind": "method",
1763
- "name": "register",
1764
- "static": true,
1385
+ "name": "setInputFocus",
1386
+ "privacy": "private"
1387
+ },
1388
+ {
1389
+ "kind": "method",
1390
+ "name": "updateBibDialogRole",
1391
+ "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.",
1392
+ "privacy": "private"
1393
+ },
1394
+ {
1395
+ "kind": "method",
1396
+ "name": "updateMenuShapeSize",
1397
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1398
+ "privacy": "private"
1399
+ },
1400
+ {
1401
+ "kind": "method",
1402
+ "name": "_getAnnouncementRoot",
1403
+ "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.",
1404
+ "privacy": "private",
1405
+ "return": {
1406
+ "type": {
1407
+ "text": "ShadowRoot"
1408
+ }
1409
+ }
1410
+ },
1411
+ {
1412
+ "kind": "method",
1413
+ "name": "configureMenu",
1414
+ "description": "Binds all behavior needed to the menu after rendering.",
1415
+ "privacy": "private",
1416
+ "return": {
1417
+ "type": {
1418
+ "text": "void"
1419
+ }
1420
+ }
1421
+ },
1422
+ {
1423
+ "kind": "method",
1424
+ "name": "configureInput",
1425
+ "description": "Binds all behavior needed to the input after rendering.",
1426
+ "privacy": "private",
1427
+ "return": {
1428
+ "type": {
1429
+ "text": "void"
1430
+ }
1431
+ }
1432
+ },
1433
+ {
1434
+ "kind": "method",
1435
+ "name": "handleMenuLoadingChange",
1765
1436
  "parameters": [
1766
1437
  {
1767
- "name": "name",
1768
- "default": "\"auro-checkbox-group\"",
1769
- "description": "The name of the element that you want to register.",
1770
- "optional": true,
1438
+ "name": "event",
1439
+ "description": "The event object containing details about the loading state change.",
1771
1440
  "type": {
1772
- "text": "string"
1441
+ "text": "CustomEvent"
1442
+ }
1443
+ },
1444
+ {
1445
+ "description": "Indicates whether the menu is currently loading.",
1446
+ "name": "event.detail.loading",
1447
+ "type": {
1448
+ "text": "boolean"
1449
+ }
1450
+ },
1451
+ {
1452
+ "description": "Indicates if there are loading placeholders present.",
1453
+ "name": "event.detail.hasLoadingPlaceholder",
1454
+ "type": {
1455
+ "text": "boolean"
1773
1456
  }
1774
1457
  }
1775
1458
  ],
1776
- "description": "This will register this element with the browser."
1459
+ "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.",
1460
+ "privacy": "private",
1461
+ "return": {
1462
+ "type": {
1463
+ "text": "void"
1464
+ }
1465
+ }
1777
1466
  },
1778
1467
  {
1779
1468
  "kind": "method",
1780
- "name": "handleValueUpdate",
1469
+ "name": "handleInputValueChange",
1781
1470
  "parameters": [
1782
1471
  {
1783
- "name": "value",
1784
- "description": "The value of the checkbox.",
1472
+ "name": "event",
1473
+ "description": "The input event triggered by the input element.",
1785
1474
  "type": {
1786
- "text": "String"
1475
+ "text": "Event"
1787
1476
  }
1788
- },
1477
+ }
1478
+ ],
1479
+ "description": "Handle changes to the input value and trigger changes that should result.",
1480
+ "privacy": "private",
1481
+ "return": {
1482
+ "type": {
1483
+ "text": "void"
1484
+ }
1485
+ }
1486
+ },
1487
+ {
1488
+ "kind": "method",
1489
+ "name": "handleTriggerInputValueChange",
1490
+ "parameters": [
1789
1491
  {
1790
- "name": "selected",
1791
- "description": "The checked state of the checkbox.",
1492
+ "name": "event",
1493
+ "description": "The input event from the trigger input element.",
1792
1494
  "type": {
1793
- "text": "Boolean"
1495
+ "text": "Event"
1794
1496
  }
1795
1497
  }
1796
1498
  ],
1797
- "description": "Helper method to handle checkbox value changing.",
1499
+ "description": "Handles input value changes originating from the trigger input.\nRefreshes menu options and filtering, delegates to handleInputValueChange\nfor value synchronization, and manages fullscreen bib focus.",
1798
1500
  "privacy": "private",
1799
1501
  "return": {
1800
1502
  "type": {
@@ -1804,8 +1506,8 @@
1804
1506
  },
1805
1507
  {
1806
1508
  "kind": "method",
1807
- "name": "handlePreselectedItems",
1808
- "description": "Helper method that handles the state of preselected checkboxes.",
1509
+ "name": "configureCombobox",
1510
+ "description": "Binds all behavior needed to the combobox after rendering.",
1809
1511
  "privacy": "private",
1810
1512
  "return": {
1811
1513
  "type": {
@@ -1815,8 +1517,96 @@
1815
1517
  },
1816
1518
  {
1817
1519
  "kind": "method",
1818
- "name": "handleItems",
1819
- "description": "Helper method that handles the state of checkboxes.",
1520
+ "name": "focus",
1521
+ "description": "Focuses the combobox trigger input.",
1522
+ "return": {
1523
+ "type": {
1524
+ "text": "void"
1525
+ }
1526
+ }
1527
+ },
1528
+ {
1529
+ "kind": "method",
1530
+ "name": "setMenuValue",
1531
+ "parameters": [
1532
+ {
1533
+ "name": "value",
1534
+ "description": "The value to set on the menu.",
1535
+ "type": {
1536
+ "text": "string"
1537
+ }
1538
+ }
1539
+ ],
1540
+ "description": "Sets the menu value if menu is available.",
1541
+ "return": {
1542
+ "type": {
1543
+ "text": "void"
1544
+ }
1545
+ }
1546
+ },
1547
+ {
1548
+ "kind": "method",
1549
+ "name": "reset",
1550
+ "description": "Resets component to initial state.",
1551
+ "return": {
1552
+ "type": {
1553
+ "text": "void"
1554
+ }
1555
+ }
1556
+ },
1557
+ {
1558
+ "kind": "method",
1559
+ "name": "clear",
1560
+ "description": "Clears the current value of the combobox.",
1561
+ "return": {
1562
+ "type": {
1563
+ "text": "void"
1564
+ }
1565
+ }
1566
+ },
1567
+ {
1568
+ "kind": "method",
1569
+ "name": "validate",
1570
+ "parameters": [
1571
+ {
1572
+ "name": "force",
1573
+ "default": "false",
1574
+ "description": "Whether to force validation.",
1575
+ "optional": true,
1576
+ "type": {
1577
+ "text": "boolean"
1578
+ }
1579
+ }
1580
+ ],
1581
+ "description": "Validates value."
1582
+ },
1583
+ {
1584
+ "kind": "method",
1585
+ "name": "transportAssignedNodes",
1586
+ "parameters": [
1587
+ {
1588
+ "name": "slot",
1589
+ "description": "The slot element containing the nodes to apply.",
1590
+ "type": {
1591
+ "text": "HTMLSlotElement"
1592
+ }
1593
+ },
1594
+ {
1595
+ "name": "target",
1596
+ "description": "The target element to apply the nodes to.",
1597
+ "type": {
1598
+ "text": "HTMLElement"
1599
+ }
1600
+ },
1601
+ {
1602
+ "name": "newSlotName",
1603
+ "description": "The new slot name for the applied nodes.",
1604
+ "type": {
1605
+ "text": "string"
1606
+ }
1607
+ }
1608
+ ],
1609
+ "description": "Applies slotted nodes to a target element with a new slot name.",
1820
1610
  "privacy": "private",
1821
1611
  "return": {
1822
1612
  "type": {
@@ -1826,42 +1616,105 @@
1826
1616
  },
1827
1617
  {
1828
1618
  "kind": "method",
1829
- "name": "reset",
1830
- "description": "Resets component to initial state.",
1831
- "return": {
1832
- "type": {
1833
- "text": "void"
1619
+ "name": "updateActiveOption",
1620
+ "parameters": [
1621
+ {
1622
+ "name": "index",
1623
+ "description": "Index of the option to make active.",
1624
+ "type": {
1625
+ "text": "number"
1626
+ }
1834
1627
  }
1835
- }
1628
+ ],
1629
+ "description": "Updates the active option in the menu."
1836
1630
  },
1837
1631
  {
1838
1632
  "kind": "method",
1839
- "name": "validate",
1633
+ "name": "handleSlotChange",
1840
1634
  "parameters": [
1841
1635
  {
1842
- "name": "force",
1843
- "default": "false",
1844
- "description": "Whether to force validation.",
1845
- "optional": true,
1636
+ "name": "event",
1637
+ "description": "`slotchange` event.",
1846
1638
  "type": {
1847
- "text": "boolean"
1639
+ "text": "Event"
1848
1640
  }
1849
1641
  }
1850
1642
  ],
1851
- "description": "Validates value."
1643
+ "description": "Watch for slot changes and recalculate the menuoptions.",
1644
+ "privacy": "private",
1645
+ "return": {
1646
+ "type": {
1647
+ "text": "void"
1648
+ }
1649
+ }
1852
1650
  },
1853
1651
  {
1854
1652
  "kind": "field",
1855
1653
  "name": "appearance",
1856
1654
  "privacy": "public",
1857
1655
  "type": {
1858
- "text": "'default' | 'inverse'"
1656
+ "text": "string"
1859
1657
  },
1860
1658
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
1861
1659
  "default": "'default'",
1862
1660
  "attribute": "appearance",
1863
1661
  "reflects": true
1864
1662
  },
1663
+ {
1664
+ "kind": "field",
1665
+ "name": "autocomplete",
1666
+ "privacy": "public",
1667
+ "type": {
1668
+ "text": "string"
1669
+ },
1670
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1671
+ "attribute": "autocomplete",
1672
+ "reflects": true
1673
+ },
1674
+ {
1675
+ "kind": "field",
1676
+ "name": "autoPlacement",
1677
+ "privacy": "public",
1678
+ "type": {
1679
+ "text": "boolean"
1680
+ },
1681
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1682
+ "attribute": "autoPlacement",
1683
+ "reflects": true
1684
+ },
1685
+ {
1686
+ "kind": "field",
1687
+ "name": "availableOptions",
1688
+ "privacy": "private",
1689
+ "type": {
1690
+ "text": "array"
1691
+ },
1692
+ "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).",
1693
+ "attribute": "availableOptions"
1694
+ },
1695
+ {
1696
+ "kind": "field",
1697
+ "name": "behavior",
1698
+ "privacy": "public",
1699
+ "type": {
1700
+ "text": "'filter' | 'suggestion'"
1701
+ },
1702
+ "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.",
1703
+ "default": "'suggestion'",
1704
+ "attribute": "behavior",
1705
+ "reflects": true
1706
+ },
1707
+ {
1708
+ "kind": "field",
1709
+ "name": "checkmark",
1710
+ "privacy": "public",
1711
+ "type": {
1712
+ "text": "boolean"
1713
+ },
1714
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1715
+ "attribute": "checkmark",
1716
+ "reflects": true
1717
+ },
1865
1718
  {
1866
1719
  "kind": "field",
1867
1720
  "name": "disabled",
@@ -1869,10 +1722,39 @@
1869
1722
  "type": {
1870
1723
  "text": "boolean"
1871
1724
  },
1872
- "description": "If set, disables the checkbox group.",
1725
+ "description": "If set, disables the combobox.",
1873
1726
  "attribute": "disabled",
1874
1727
  "reflects": true
1875
1728
  },
1729
+ {
1730
+ "kind": "field",
1731
+ "name": "dropdownId",
1732
+ "privacy": "private",
1733
+ "type": {
1734
+ "text": "string"
1735
+ },
1736
+ "description": "ID for the dropdown."
1737
+ },
1738
+ {
1739
+ "kind": "field",
1740
+ "name": "dropdownOpen",
1741
+ "privacy": "private",
1742
+ "type": {
1743
+ "text": "boolean"
1744
+ },
1745
+ "description": "Whether or not the dropdown is open."
1746
+ },
1747
+ {
1748
+ "kind": "field",
1749
+ "name": "dvInputOnly",
1750
+ "privacy": "public",
1751
+ "type": {
1752
+ "text": "boolean"
1753
+ },
1754
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1755
+ "attribute": "dvInputOnly",
1756
+ "reflects": true
1757
+ },
1876
1758
  {
1877
1759
  "kind": "field",
1878
1760
  "name": "error",
@@ -1886,13 +1768,84 @@
1886
1768
  },
1887
1769
  {
1888
1770
  "kind": "field",
1889
- "name": "horizontal",
1771
+ "name": "format",
1772
+ "privacy": "public",
1773
+ "type": {
1774
+ "text": "string"
1775
+ },
1776
+ "description": "Specifies the input mask format.",
1777
+ "attribute": "format",
1778
+ "reflects": true
1779
+ },
1780
+ {
1781
+ "kind": "field",
1782
+ "name": "inputmode",
1783
+ "privacy": "public",
1784
+ "type": {
1785
+ "text": "string"
1786
+ },
1787
+ "description": "Exposes inputmode attribute for input.",
1788
+ "attribute": "inputmode",
1789
+ "reflects": true
1790
+ },
1791
+ {
1792
+ "kind": "field",
1793
+ "name": "layout",
1794
+ "privacy": "public",
1795
+ "type": {
1796
+ "text": "string"
1797
+ },
1798
+ "description": "Sets the layout of the combobox.",
1799
+ "default": "'classic'",
1800
+ "attribute": "layout",
1801
+ "reflects": true,
1802
+ "inheritedFrom": {
1803
+ "name": "AuroElement",
1804
+ "module": "components/layoutElement/src/auroElement.js"
1805
+ }
1806
+ },
1807
+ {
1808
+ "kind": "field",
1809
+ "name": "matchWidth",
1810
+ "privacy": "private",
1811
+ "type": {
1812
+ "text": "boolean"
1813
+ },
1814
+ "description": "If declared, the popover and trigger will be set to the same width.",
1815
+ "attribute": "matchWidth",
1816
+ "reflects": true
1817
+ },
1818
+ {
1819
+ "kind": "field",
1820
+ "name": "noFilter",
1890
1821
  "privacy": "public",
1891
1822
  "type": {
1892
1823
  "text": "boolean"
1893
1824
  },
1894
- "description": "If set, checkboxes will be aligned horizontally.",
1895
- "attribute": "horizontal",
1825
+ "description": "If set, combobox will not filter menuoptions based on input.",
1826
+ "attribute": "noFilter",
1827
+ "reflects": true
1828
+ },
1829
+ {
1830
+ "kind": "field",
1831
+ "name": "noFlip",
1832
+ "privacy": "public",
1833
+ "type": {
1834
+ "text": "boolean"
1835
+ },
1836
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1837
+ "attribute": "noFlip",
1838
+ "reflects": true
1839
+ },
1840
+ {
1841
+ "kind": "field",
1842
+ "name": "shift",
1843
+ "privacy": "public",
1844
+ "type": {
1845
+ "text": "boolean"
1846
+ },
1847
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1848
+ "attribute": "shift",
1896
1849
  "reflects": true
1897
1850
  },
1898
1851
  {
@@ -1908,13 +1861,73 @@
1908
1861
  },
1909
1862
  {
1910
1863
  "kind": "field",
1911
- "name": "onDark",
1864
+ "name": "offset",
1865
+ "privacy": "public",
1866
+ "type": {
1867
+ "text": "number"
1868
+ },
1869
+ "description": "Gap between the trigger element and bib.",
1870
+ "default": "0",
1871
+ "attribute": "offset",
1872
+ "reflects": true
1873
+ },
1874
+ {
1875
+ "kind": "field",
1876
+ "name": "onDark",
1877
+ "privacy": "public",
1878
+ "type": {
1879
+ "text": "boolean"
1880
+ },
1881
+ "attribute": "onDark",
1882
+ "reflects": true,
1883
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1884
+ "inheritedFrom": {
1885
+ "name": "AuroElement",
1886
+ "module": "components/layoutElement/src/auroElement.js"
1887
+ }
1888
+ },
1889
+ {
1890
+ "kind": "field",
1891
+ "name": "optionSelected",
1892
+ "privacy": "public",
1893
+ "type": {
1894
+ "text": "HTMLElement"
1895
+ },
1896
+ "description": "Specifies the current selected option.",
1897
+ "attribute": "optionSelected"
1898
+ },
1899
+ {
1900
+ "kind": "field",
1901
+ "name": "persistInput",
1902
+ "privacy": "public",
1903
+ "type": {
1904
+ "text": "boolean"
1905
+ },
1906
+ "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.",
1907
+ "attribute": "persistInput",
1908
+ "reflects": true
1909
+ },
1910
+ {
1911
+ "kind": "field",
1912
+ "name": "placement",
1913
+ "privacy": "public",
1914
+ "type": {
1915
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1916
+ },
1917
+ "description": "Position where the bib should appear relative to the trigger.",
1918
+ "default": "'bottom-start'",
1919
+ "attribute": "placement",
1920
+ "reflects": true
1921
+ },
1922
+ {
1923
+ "kind": "field",
1924
+ "name": "placeholder",
1912
1925
  "privacy": "public",
1913
1926
  "type": {
1914
- "text": "boolean"
1927
+ "text": "string"
1915
1928
  },
1916
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1917
- "attribute": "onDark",
1929
+ "description": "Define custom placeholder text, only supported by date input formats.",
1930
+ "attribute": "placeholder",
1918
1931
  "reflects": true
1919
1932
  },
1920
1933
  {
@@ -1924,7 +1937,7 @@
1924
1937
  "type": {
1925
1938
  "text": "boolean"
1926
1939
  },
1927
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1940
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1928
1941
  "attribute": "required",
1929
1942
  "reflects": true
1930
1943
  },
@@ -1960,615 +1973,602 @@
1960
1973
  },
1961
1974
  {
1962
1975
  "kind": "field",
1963
- "name": "validity",
1976
+ "name": "setCustomValidityValueMissingFilter",
1964
1977
  "privacy": "public",
1965
1978
  "type": {
1966
1979
  "text": "string"
1967
1980
  },
1968
- "description": "Specifies the `validityState` this element is in.",
1969
- "attribute": "validity",
1970
- "reflects": true
1971
- }
1972
- ],
1973
- "events": [
1974
- {
1975
- "name": "input",
1976
- "type": {
1977
- "text": "CustomEvent"
1978
- }
1979
- },
1980
- {
1981
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1982
- "name": "auroFormElement-validated"
1983
- }
1984
- ],
1985
- "attributes": [
1986
- {
1987
- "name": "appearance",
1988
- "type": {
1989
- "text": "'default' | 'inverse'"
1990
- },
1991
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1992
- "default": "'default'",
1993
- "fieldName": "appearance"
1994
- },
1995
- {
1996
- "name": "disabled",
1997
- "type": {
1998
- "text": "boolean"
1999
- },
2000
- "description": "If set, disables the checkbox group.",
2001
- "fieldName": "disabled"
2002
- },
2003
- {
2004
- "name": "error",
2005
- "type": {
2006
- "text": "string"
2007
- },
2008
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2009
- "fieldName": "error"
1981
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1982
+ "attribute": "setCustomValidityValueMissingFilter"
2010
1983
  },
2011
1984
  {
2012
- "name": "horizontal",
1985
+ "kind": "field",
1986
+ "name": "touched",
1987
+ "privacy": "private",
2013
1988
  "type": {
2014
1989
  "text": "boolean"
2015
1990
  },
2016
- "description": "If set, checkboxes will be aligned horizontally.",
2017
- "fieldName": "horizontal"
1991
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
2018
1992
  },
2019
1993
  {
2020
- "name": "noValidate",
1994
+ "kind": "field",
1995
+ "name": "triggerIcon",
1996
+ "privacy": "public",
2021
1997
  "type": {
2022
1998
  "text": "boolean"
2023
1999
  },
2024
- "description": "If set, disables auto-validation on blur.",
2025
- "fieldName": "noValidate"
2000
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2001
+ "attribute": "triggerIcon",
2002
+ "reflects": true
2026
2003
  },
2027
2004
  {
2028
- "name": "onDark",
2005
+ "kind": "field",
2006
+ "name": "type",
2007
+ "privacy": "public",
2029
2008
  "type": {
2030
- "text": "boolean"
2009
+ "text": "string"
2031
2010
  },
2032
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2033
- "fieldName": "onDark"
2011
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2012
+ "attribute": "type",
2013
+ "reflects": true
2034
2014
  },
2035
2015
  {
2036
- "name": "required",
2016
+ "kind": "field",
2017
+ "name": "typedValue",
2018
+ "privacy": "public",
2037
2019
  "type": {
2038
- "text": "boolean"
2020
+ "text": "string"
2039
2021
  },
2040
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
2041
- "fieldName": "required"
2022
+ "description": "Specifies the value of the input element within the combobox.",
2023
+ "attribute": "typedValue",
2024
+ "reflects": true
2042
2025
  },
2043
2026
  {
2044
- "name": "setCustomValidity",
2027
+ "kind": "field",
2028
+ "name": "validity",
2029
+ "privacy": "public",
2045
2030
  "type": {
2046
2031
  "text": "string"
2047
2032
  },
2048
- "description": "Sets a custom help text message to display for all validityStates.",
2049
- "fieldName": "setCustomValidity"
2033
+ "description": "Specifies the `validityState` this element is in.",
2034
+ "attribute": "validity",
2035
+ "reflects": true
2050
2036
  },
2051
2037
  {
2052
- "name": "setCustomValidityCustomError",
2038
+ "kind": "field",
2039
+ "name": "value",
2040
+ "privacy": "public",
2053
2041
  "type": {
2054
2042
  "text": "string"
2055
2043
  },
2056
- "description": "Custom help text message to display when validity = `customError`.",
2057
- "fieldName": "setCustomValidityCustomError"
2044
+ "description": "Value selected for the dropdown menu.",
2045
+ "attribute": "value"
2058
2046
  },
2059
2047
  {
2060
- "name": "setCustomValidityValueMissing",
2048
+ "kind": "field",
2049
+ "name": "largeFullscreenHeadline",
2050
+ "privacy": "public",
2061
2051
  "type": {
2062
- "text": "string"
2052
+ "text": "boolean"
2063
2053
  },
2064
- "description": "Custom help text message to display when validity = `valueMissing`.",
2065
- "fieldName": "setCustomValidityValueMissing"
2054
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2055
+ "attribute": "largeFullscreenHeadline",
2056
+ "reflects": true
2066
2057
  },
2067
2058
  {
2068
- "name": "validity",
2059
+ "kind": "field",
2060
+ "name": "fullscreenBreakpoint",
2061
+ "privacy": "public",
2069
2062
  "type": {
2070
- "text": "string"
2063
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2071
2064
  },
2072
- "description": "Specifies the `validityState` this element is in.",
2073
- "fieldName": "validity"
2074
- }
2075
- ],
2076
- "superclass": {
2077
- "name": "LitElement",
2078
- "package": "lit"
2079
- },
2080
- "tagName": "auro-checkbox-group",
2081
- "customElement": true
2082
- }
2083
- ],
2084
- "exports": [
2085
- {
2086
- "kind": "js",
2087
- "name": "AuroCheckboxGroup",
2088
- "declaration": {
2089
- "name": "AuroCheckboxGroup",
2090
- "module": "components/checkbox/src/auro-checkbox-group.js"
2091
- }
2092
- }
2093
- ]
2094
- },
2095
- {
2096
- "kind": "javascript-module",
2097
- "path": "components/checkbox/src/auro-checkbox.js",
2098
- "declarations": [
2099
- {
2100
- "kind": "class",
2101
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2102
- "name": "AuroCheckbox",
2103
- "cssParts": [
2104
- {
2105
- "description": "apply css to a specific checkbox.",
2106
- "name": "checkbox"
2107
- },
2108
- {
2109
- "description": "apply css to a specific checkbox's input.",
2110
- "name": "checkbox-input"
2111
- },
2112
- {
2113
- "description": "apply css to a specific checkbox's label.",
2114
- "name": "checkbox-label"
2115
- }
2116
- ],
2117
- "slots": [
2118
- {
2119
- "description": "The default slot for the checkbox label.",
2120
- "name": "default"
2121
- }
2122
- ],
2123
- "members": [
2124
- {
2125
- "kind": "method",
2126
- "name": "_initializeDefaults"
2127
- },
2128
- {
2129
- "kind": "method",
2130
- "name": "register",
2131
- "static": true,
2132
- "parameters": [
2133
- {
2134
- "name": "name",
2135
- "default": "\"auro-checkbox\"",
2136
- "description": "The name of element that you want to register to.",
2137
- "optional": true,
2138
- "type": {
2139
- "text": "string"
2140
- }
2141
- }
2142
- ],
2143
- "description": "This will register this element with the browser."
2144
- },
2145
- {
2146
- "kind": "method",
2147
- "name": "handleChange",
2148
- "parameters": [
2149
- {
2150
- "name": "event",
2151
- "description": "The change event from the checkbox input.",
2152
- "type": {
2153
- "text": "Event"
2154
- }
2155
- }
2156
- ],
2157
- "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.",
2158
- "privacy": "private",
2159
- "return": {
2160
- "type": {
2161
- "text": "void"
2162
- }
2163
- }
2065
+ "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.",
2066
+ "default": "'sm'",
2067
+ "attribute": "fullscreenBreakpoint",
2068
+ "reflects": true
2164
2069
  },
2165
2070
  {
2166
- "kind": "method",
2167
- "name": "handleInput",
2168
- "parameters": [
2169
- {
2170
- "name": "event",
2171
- "description": "The input event from the checkbox input.",
2172
- "type": {
2173
- "text": "Event"
2174
- }
2175
- }
2176
- ],
2177
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2071
+ "kind": "field",
2072
+ "name": "optionActive",
2178
2073
  "privacy": "private",
2179
- "return": {
2180
- "type": {
2181
- "text": "void"
2182
- }
2183
- }
2074
+ "type": {
2075
+ "text": "object"
2076
+ },
2077
+ "description": "Specifies the currently active option."
2184
2078
  },
2185
2079
  {
2186
- "kind": "method",
2187
- "name": "handleFocusin",
2188
- "description": "Function to support",
2080
+ "kind": "field",
2081
+ "name": "componentHasFocus",
2082
+ "description": "Returns true if the element has focus.",
2189
2083
  "privacy": "private",
2190
2084
  "return": {
2191
2085
  "type": {
2192
- "text": "void"
2086
+ "text": "boolean"
2193
2087
  }
2088
+ },
2089
+ "readonly": true,
2090
+ "inheritedFrom": {
2091
+ "name": "AuroElement",
2092
+ "module": "components/layoutElement/src/auroElement.js"
2194
2093
  }
2195
2094
  },
2196
2095
  {
2197
2096
  "kind": "method",
2198
- "name": "generateIconHtml",
2199
- "description": "Function to generate checkmark svg.",
2200
- "privacy": "private",
2201
- "return": {
2202
- "type": {
2203
- "text": "HTMLElement"
2204
- }
2097
+ "name": "resetShapeClasses",
2098
+ "inheritedFrom": {
2099
+ "name": "AuroElement",
2100
+ "module": "components/layoutElement/src/auroElement.js"
2205
2101
  }
2206
2102
  },
2207
2103
  {
2208
2104
  "kind": "method",
2209
- "name": "reset",
2210
- "description": "Resets component to initial state.",
2211
- "return": {
2212
- "type": {
2213
- "text": "void"
2214
- }
2105
+ "name": "resetLayoutClasses",
2106
+ "inheritedFrom": {
2107
+ "name": "AuroElement",
2108
+ "module": "components/layoutElement/src/auroElement.js"
2215
2109
  }
2216
2110
  },
2217
2111
  {
2218
2112
  "kind": "method",
2219
- "name": "updateAriaLabel",
2220
- "description": "Updates the aria-label based on slot content.",
2221
- "privacy": "private",
2222
- "return": {
2223
- "type": {
2224
- "text": "void"
2225
- }
2113
+ "name": "updateComponentArchitecture",
2114
+ "inheritedFrom": {
2115
+ "name": "AuroElement",
2116
+ "module": "components/layoutElement/src/auroElement.js"
2226
2117
  }
2227
2118
  },
2228
2119
  {
2229
- "kind": "method",
2230
- "name": "handleKeyDown",
2231
- "parameters": [
2232
- {
2233
- "name": "event",
2234
- "description": "The keydown event from the checkbox input.",
2235
- "type": {
2236
- "text": "KeyboardEvent"
2237
- }
2238
- }
2239
- ],
2240
- "description": "Handles keydown event to toggle the checkbox with Space key.",
2241
- "privacy": "private",
2242
- "return": {
2243
- "type": {
2244
- "text": "void"
2245
- }
2120
+ "kind": "field",
2121
+ "name": "shape",
2122
+ "privacy": "public",
2123
+ "type": {
2124
+ "text": "string"
2125
+ },
2126
+ "attribute": "shape",
2127
+ "reflects": true,
2128
+ "inheritedFrom": {
2129
+ "name": "AuroElement",
2130
+ "module": "components/layoutElement/src/auroElement.js"
2246
2131
  }
2247
2132
  },
2248
2133
  {
2249
2134
  "kind": "field",
2250
- "name": "appearance",
2135
+ "name": "size",
2251
2136
  "privacy": "public",
2252
2137
  "type": {
2253
- "text": "'default' | 'inverse'"
2138
+ "text": "string"
2139
+ },
2140
+ "attribute": "size",
2141
+ "reflects": true,
2142
+ "inheritedFrom": {
2143
+ "name": "AuroElement",
2144
+ "module": "components/layoutElement/src/auroElement.js"
2145
+ }
2146
+ }
2147
+ ],
2148
+ "events": [
2149
+ {
2150
+ "name": "inputValue",
2151
+ "type": {
2152
+ "text": "CustomEvent"
2153
+ },
2154
+ "description": "Notifies that the components internal HTML5 input value has changed."
2155
+ },
2156
+ {
2157
+ "name": "input",
2158
+ "type": {
2159
+ "text": "CustomEvent"
2160
+ },
2161
+ "description": "Notifies that the component has a new value set."
2162
+ },
2163
+ {
2164
+ "name": "auroCombobox-valueSet",
2165
+ "type": {
2166
+ "text": "CustomEvent"
2167
+ },
2168
+ "description": "(Deprecated) Notifies that the component has a new value set."
2169
+ },
2170
+ {
2171
+ "description": "Notifies that the component value(s) have been validated.",
2172
+ "name": "auroFormElement-validated"
2173
+ }
2174
+ ],
2175
+ "attributes": [
2176
+ {
2177
+ "name": "appearance",
2178
+ "type": {
2179
+ "text": "string"
2254
2180
  },
2255
2181
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
2256
2182
  "default": "'default'",
2257
- "attribute": "appearance",
2258
- "reflects": true
2183
+ "fieldName": "appearance"
2259
2184
  },
2260
2185
  {
2261
- "kind": "field",
2262
- "name": "checked",
2263
- "privacy": "public",
2186
+ "name": "autocomplete",
2187
+ "type": {
2188
+ "text": "string"
2189
+ },
2190
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2191
+ "fieldName": "autocomplete"
2192
+ },
2193
+ {
2194
+ "name": "autoPlacement",
2264
2195
  "type": {
2265
2196
  "text": "boolean"
2266
2197
  },
2267
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2268
- "attribute": "checked",
2269
- "reflects": true
2198
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
2199
+ "fieldName": "autoPlacement"
2200
+ },
2201
+ {
2202
+ "name": "availableOptions",
2203
+ "type": {
2204
+ "text": "array"
2205
+ },
2206
+ "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).",
2207
+ "fieldName": "availableOptions"
2208
+ },
2209
+ {
2210
+ "name": "behavior",
2211
+ "type": {
2212
+ "text": "'filter' | 'suggestion'"
2213
+ },
2214
+ "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.",
2215
+ "default": "'suggestion'",
2216
+ "fieldName": "behavior"
2217
+ },
2218
+ {
2219
+ "name": "checkmark",
2220
+ "type": {
2221
+ "text": "boolean"
2222
+ },
2223
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
2224
+ "fieldName": "checkmark"
2270
2225
  },
2271
2226
  {
2272
- "kind": "field",
2273
2227
  "name": "disabled",
2274
- "privacy": "public",
2275
2228
  "type": {
2276
2229
  "text": "boolean"
2277
2230
  },
2278
- "description": "If set to true, the checkbox will not be clickable.",
2279
- "attribute": "disabled",
2280
- "reflects": true
2231
+ "description": "If set, disables the combobox.",
2232
+ "fieldName": "disabled"
2281
2233
  },
2282
2234
  {
2283
- "kind": "field",
2284
- "name": "error",
2285
- "privacy": "public",
2235
+ "name": "dvInputOnly",
2286
2236
  "type": {
2287
2237
  "text": "boolean"
2288
2238
  },
2289
- "description": "If set to true, the checkbox will be displayed with an error state.",
2290
- "attribute": "error",
2291
- "reflects": true
2239
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2240
+ "fieldName": "dvInputOnly"
2292
2241
  },
2293
2242
  {
2294
- "kind": "field",
2295
- "name": "id",
2296
- "privacy": "public",
2243
+ "name": "error",
2297
2244
  "type": {
2298
2245
  "text": "string"
2299
2246
  },
2300
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2301
- "attribute": "id",
2302
- "reflects": true
2247
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2248
+ "fieldName": "error"
2303
2249
  },
2304
2250
  {
2305
- "kind": "field",
2306
- "name": "inputId",
2307
- "privacy": "private",
2251
+ "name": "format",
2308
2252
  "type": {
2309
2253
  "text": "string"
2310
2254
  },
2311
- "description": "The id for input node."
2255
+ "description": "Specifies the input mask format.",
2256
+ "fieldName": "format"
2312
2257
  },
2313
2258
  {
2314
- "kind": "field",
2315
- "name": "name",
2316
- "privacy": "public",
2259
+ "name": "inputmode",
2317
2260
  "type": {
2318
2261
  "text": "string"
2319
2262
  },
2320
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2321
- "attribute": "name"
2263
+ "description": "Exposes inputmode attribute for input.",
2264
+ "fieldName": "inputmode"
2322
2265
  },
2323
2266
  {
2324
- "kind": "field",
2325
- "name": "onDark",
2326
- "privacy": "public",
2267
+ "name": "layout",
2268
+ "type": {
2269
+ "text": "string"
2270
+ },
2271
+ "description": "Sets the layout of the combobox.",
2272
+ "default": "'classic'",
2273
+ "fieldName": "layout",
2274
+ "inheritedFrom": {
2275
+ "name": "AuroElement",
2276
+ "module": "components/layoutElement/src/auroElement.js"
2277
+ }
2278
+ },
2279
+ {
2280
+ "name": "matchWidth",
2327
2281
  "type": {
2328
2282
  "text": "boolean"
2329
2283
  },
2330
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2331
- "attribute": "onDark",
2332
- "reflects": true
2284
+ "description": "If declared, the popover and trigger will be set to the same width.",
2285
+ "fieldName": "matchWidth"
2333
2286
  },
2334
2287
  {
2335
- "kind": "field",
2336
- "name": "touched",
2337
- "privacy": "private",
2288
+ "name": "noFilter",
2338
2289
  "type": {
2339
2290
  "text": "boolean"
2340
2291
  },
2341
- "description": "Indicates whether the checkbox has been interacted with."
2292
+ "description": "If set, combobox will not filter menuoptions based on input.",
2293
+ "fieldName": "noFilter"
2342
2294
  },
2343
2295
  {
2344
- "kind": "field",
2345
- "name": "value",
2346
- "privacy": "public",
2296
+ "name": "noFlip",
2347
2297
  "type": {
2348
- "text": "string"
2298
+ "text": "boolean"
2349
2299
  },
2350
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2351
- "attribute": "value"
2300
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2301
+ "fieldName": "noFlip"
2352
2302
  },
2353
2303
  {
2354
- "kind": "field",
2355
- "name": "tabIndex",
2356
- "privacy": "private",
2304
+ "name": "shift",
2305
+ "type": {
2306
+ "text": "boolean"
2307
+ },
2308
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2309
+ "fieldName": "shift"
2310
+ },
2311
+ {
2312
+ "name": "noValidate",
2313
+ "type": {
2314
+ "text": "boolean"
2315
+ },
2316
+ "description": "If set, disables auto-validation on blur.",
2317
+ "fieldName": "noValidate"
2318
+ },
2319
+ {
2320
+ "name": "offset",
2357
2321
  "type": {
2358
2322
  "text": "number"
2359
2323
  },
2360
- "description": "The tabindex attribute for the checkbox.",
2361
- "attribute": "tabindex",
2362
- "reflects": true
2324
+ "description": "Gap between the trigger element and bib.",
2325
+ "default": "0",
2326
+ "fieldName": "offset"
2363
2327
  },
2364
2328
  {
2365
- "kind": "field",
2366
- "name": "ariaChecked",
2367
- "privacy": "private",
2329
+ "name": "onDark",
2368
2330
  "type": {
2369
- "text": "string"
2331
+ "text": "boolean"
2370
2332
  },
2371
- "description": "The aria-checked attribute for the checkbox.",
2372
- "attribute": "aria-checked",
2373
- "reflects": true
2333
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2334
+ "fieldName": "onDark"
2374
2335
  },
2375
2336
  {
2376
- "kind": "field",
2377
- "name": "ariaDisabled",
2378
- "privacy": "private",
2337
+ "name": "optionSelected",
2379
2338
  "type": {
2380
- "text": "string"
2339
+ "text": "HTMLElement"
2381
2340
  },
2382
- "description": "The aria-disabled attribute for the checkbox.",
2383
- "attribute": "aria-disabled",
2384
- "reflects": true
2341
+ "description": "Specifies the current selected option.",
2342
+ "fieldName": "optionSelected"
2385
2343
  },
2386
2344
  {
2387
- "kind": "field",
2388
- "name": "role",
2389
- "privacy": "private",
2345
+ "name": "persistInput",
2390
2346
  "type": {
2391
- "text": "string"
2347
+ "text": "boolean"
2392
2348
  },
2393
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2394
- "attribute": "role",
2395
- "reflects": true
2396
- }
2397
- ],
2398
- "events": [
2349
+ "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.",
2350
+ "fieldName": "persistInput"
2351
+ },
2399
2352
  {
2400
- "name": "auroCheckbox-input",
2353
+ "name": "placement",
2401
2354
  "type": {
2402
- "text": "CustomEvent"
2403
- }
2355
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2356
+ },
2357
+ "description": "Position where the bib should appear relative to the trigger.",
2358
+ "default": "'bottom-start'",
2359
+ "fieldName": "placement"
2404
2360
  },
2405
2361
  {
2406
- "name": "auroCheckbox-focusin",
2362
+ "name": "placeholder",
2407
2363
  "type": {
2408
- "text": "CustomEvent"
2409
- }
2364
+ "text": "string"
2365
+ },
2366
+ "description": "Define custom placeholder text, only supported by date input formats.",
2367
+ "fieldName": "placeholder"
2410
2368
  },
2411
2369
  {
2412
- "name": "auroCheckbox-focusout",
2370
+ "name": "required",
2413
2371
  "type": {
2414
- "text": "CustomEvent"
2415
- }
2372
+ "text": "boolean"
2373
+ },
2374
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2375
+ "fieldName": "required"
2416
2376
  },
2417
2377
  {
2418
- "description": "(Deprecated) Notifies when checked value is changed.",
2419
- "name": "change"
2378
+ "name": "setCustomValidity",
2379
+ "type": {
2380
+ "text": "string"
2381
+ },
2382
+ "description": "Sets a custom help text message to display for all validityStates.",
2383
+ "fieldName": "setCustomValidity"
2420
2384
  },
2421
2385
  {
2422
- "description": "Notifies when when checked value is changed by user's interface.",
2423
- "name": "input"
2424
- }
2425
- ],
2426
- "attributes": [
2427
- {
2428
- "name": "appearance",
2386
+ "name": "setCustomValidityCustomError",
2429
2387
  "type": {
2430
- "text": "'default' | 'inverse'"
2388
+ "text": "string"
2431
2389
  },
2432
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2433
- "default": "'default'",
2434
- "fieldName": "appearance"
2390
+ "description": "Custom help text message to display when validity = `customError`.",
2391
+ "fieldName": "setCustomValidityCustomError"
2435
2392
  },
2436
2393
  {
2437
- "name": "checked",
2394
+ "name": "setCustomValidityValueMissing",
2438
2395
  "type": {
2439
- "text": "boolean"
2396
+ "text": "string"
2440
2397
  },
2441
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2442
- "fieldName": "checked"
2398
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2399
+ "fieldName": "setCustomValidityValueMissing"
2443
2400
  },
2444
2401
  {
2445
- "name": "disabled",
2402
+ "name": "setCustomValidityValueMissingFilter",
2446
2403
  "type": {
2447
- "text": "boolean"
2404
+ "text": "string"
2448
2405
  },
2449
- "description": "If set to true, the checkbox will not be clickable.",
2450
- "fieldName": "disabled"
2406
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2407
+ "fieldName": "setCustomValidityValueMissingFilter"
2451
2408
  },
2452
2409
  {
2453
- "name": "error",
2410
+ "name": "triggerIcon",
2454
2411
  "type": {
2455
2412
  "text": "boolean"
2456
2413
  },
2457
- "description": "If set to true, the checkbox will be displayed with an error state.",
2458
- "fieldName": "error"
2414
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2415
+ "fieldName": "triggerIcon"
2459
2416
  },
2460
2417
  {
2461
- "name": "id",
2418
+ "name": "type",
2462
2419
  "type": {
2463
2420
  "text": "string"
2464
2421
  },
2465
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2466
- "fieldName": "id"
2422
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2423
+ "fieldName": "type"
2467
2424
  },
2468
2425
  {
2469
- "name": "name",
2426
+ "name": "typedValue",
2470
2427
  "type": {
2471
2428
  "text": "string"
2472
2429
  },
2473
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2474
- "fieldName": "name"
2430
+ "description": "Specifies the value of the input element within the combobox.",
2431
+ "fieldName": "typedValue"
2475
2432
  },
2476
2433
  {
2477
- "name": "onDark",
2434
+ "name": "validity",
2478
2435
  "type": {
2479
- "text": "boolean"
2436
+ "text": "string"
2480
2437
  },
2481
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2482
- "fieldName": "onDark"
2438
+ "description": "Specifies the `validityState` this element is in.",
2439
+ "fieldName": "validity"
2483
2440
  },
2484
2441
  {
2485
2442
  "name": "value",
2486
2443
  "type": {
2487
2444
  "text": "string"
2488
2445
  },
2489
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2446
+ "description": "Value selected for the dropdown menu.",
2490
2447
  "fieldName": "value"
2491
2448
  },
2492
2449
  {
2493
- "name": "tabindex",
2450
+ "name": "largeFullscreenHeadline",
2494
2451
  "type": {
2495
- "text": "number"
2452
+ "text": "boolean"
2496
2453
  },
2497
- "description": "The tabindex attribute for the checkbox.",
2498
- "fieldName": "tabIndex"
2454
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2455
+ "fieldName": "largeFullscreenHeadline"
2499
2456
  },
2500
2457
  {
2501
- "name": "aria-checked",
2458
+ "name": "fullscreenBreakpoint",
2502
2459
  "type": {
2503
- "text": "string"
2460
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2504
2461
  },
2505
- "description": "The aria-checked attribute for the checkbox.",
2506
- "fieldName": "ariaChecked"
2462
+ "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.",
2463
+ "default": "'sm'",
2464
+ "fieldName": "fullscreenBreakpoint"
2507
2465
  },
2508
2466
  {
2509
- "name": "aria-disabled",
2467
+ "name": "shape",
2510
2468
  "type": {
2511
2469
  "text": "string"
2512
2470
  },
2513
- "description": "The aria-disabled attribute for the checkbox.",
2514
- "fieldName": "ariaDisabled"
2471
+ "fieldName": "shape",
2472
+ "inheritedFrom": {
2473
+ "name": "AuroElement",
2474
+ "module": "components/layoutElement/src/auroElement.js"
2475
+ }
2515
2476
  },
2516
2477
  {
2517
- "name": "role",
2478
+ "name": "size",
2518
2479
  "type": {
2519
2480
  "text": "string"
2520
2481
  },
2521
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2522
- "fieldName": "role"
2482
+ "fieldName": "size",
2483
+ "inheritedFrom": {
2484
+ "name": "AuroElement",
2485
+ "module": "components/layoutElement/src/auroElement.js"
2486
+ }
2487
+ },
2488
+ {
2489
+ "name": "ondark",
2490
+ "type": {
2491
+ "text": "boolean"
2492
+ },
2493
+ "fieldName": "onDark",
2494
+ "inheritedFrom": {
2495
+ "name": "AuroElement",
2496
+ "module": "components/layoutElement/src/auroElement.js"
2497
+ }
2523
2498
  }
2524
2499
  ],
2525
2500
  "superclass": {
2526
- "name": "LitElement",
2527
- "package": "lit"
2501
+ "name": "AuroElement",
2502
+ "module": "/components/layoutElement/src/auroElement.js"
2528
2503
  },
2529
- "tagName": "auro-checkbox",
2504
+ "tagName": "auro-combobox",
2530
2505
  "customElement": true
2531
2506
  }
2532
2507
  ],
2533
2508
  "exports": [
2534
2509
  {
2535
2510
  "kind": "js",
2536
- "name": "AuroCheckbox",
2511
+ "name": "AuroCombobox",
2537
2512
  "declaration": {
2538
- "name": "AuroCheckbox",
2539
- "module": "components/checkbox/src/auro-checkbox.js"
2513
+ "name": "AuroCombobox",
2514
+ "module": "components/combobox/src/auro-combobox.js"
2540
2515
  }
2541
2516
  }
2542
2517
  ]
2543
2518
  },
2544
2519
  {
2545
2520
  "kind": "javascript-module",
2546
- "path": "components/checkbox/src/index.js",
2547
- "declarations": [],
2521
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2522
+ "declarations": [
2523
+ {
2524
+ "kind": "variable",
2525
+ "name": "comboboxKeyboardStrategy",
2526
+ "type": {
2527
+ "text": "object"
2528
+ },
2529
+ "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) { 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) { navigateArrow(component, 'up'); } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { // Forms should not submit on Enter from a combobox, regardless of which // child element (input, clear button, menu) is focused. evt.stopPropagation(); if (isClearBtnFocused(ctx)) { // Let the browser dispatch Enter to the focused clear button so its // built-in activation fires and clears the selection. Do NOT call // preventDefault — that would block the activation. return; } if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); } else { evt.preventDefault(); 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(); } } } }"
2530
+ }
2531
+ ],
2548
2532
  "exports": [
2549
2533
  {
2550
2534
  "kind": "js",
2551
- "name": "AuroCheckbox",
2535
+ "name": "comboboxKeyboardStrategy",
2552
2536
  "declaration": {
2553
- "name": "AuroCheckbox",
2554
- "module": "components/checkbox/src/index.js"
2537
+ "name": "comboboxKeyboardStrategy",
2538
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2555
2539
  }
2556
- },
2540
+ }
2541
+ ]
2542
+ },
2543
+ {
2544
+ "kind": "javascript-module",
2545
+ "path": "components/combobox/src/index.js",
2546
+ "declarations": [],
2547
+ "exports": [
2557
2548
  {
2558
2549
  "kind": "js",
2559
- "name": "AuroCheckboxGroup",
2550
+ "name": "AuroCombobox",
2560
2551
  "declaration": {
2561
- "name": "AuroCheckboxGroup",
2562
- "module": "components/checkbox/src/index.js"
2552
+ "name": "AuroCombobox",
2553
+ "module": "components/combobox/src/index.js"
2563
2554
  }
2564
2555
  }
2565
2556
  ]
2566
2557
  },
2567
2558
  {
2568
2559
  "kind": "javascript-module",
2569
- "path": "components/checkbox/src/registered.js",
2560
+ "path": "components/combobox/src/registered.js",
2570
2561
  "declarations": [],
2571
- "exports": []
2562
+ "exports": [
2563
+ {
2564
+ "kind": "js",
2565
+ "name": "AuroCombobox",
2566
+ "declaration": {
2567
+ "name": "AuroCombobox",
2568
+ "module": "components/combobox/src/registered.js"
2569
+ }
2570
+ }
2571
+ ]
2572
2572
  },
2573
2573
  {
2574
2574
  "kind": "javascript-module",
@@ -17132,7 +17132,7 @@
17132
17132
  "type": {
17133
17133
  "text": "object"
17134
17134
  },
17135
- "description": "An array of currently selected menu options, type `HTMLElement` by default. In multi-select mode, `optionSelected` is an array of HTML elements.",
17135
+ "description": "The currently selected menu option(s). In single-select mode this is a single `HTMLElement` (or `undefined` when nothing is selected). In multi-select mode this is an array of `HTMLElement`s.",
17136
17136
  "default": "undefined",
17137
17137
  "attribute": "optionSelected"
17138
17138
  },
@@ -17394,7 +17394,7 @@
17394
17394
  "type": {
17395
17395
  "text": "object"
17396
17396
  },
17397
- "description": "An array of currently selected menu options, type `HTMLElement` by default. In multi-select mode, `optionSelected` is an array of HTML elements.",
17397
+ "description": "The currently selected menu option(s). In single-select mode this is a single `HTMLElement` (or `undefined` when nothing is selected). In multi-select mode this is an array of `HTMLElement`s.",
17398
17398
  "default": "undefined",
17399
17399
  "fieldName": "optionSelected"
17400
17400
  },
@@ -17620,6 +17620,8 @@
17620
17620
  "type": {
17621
17621
  "text": "boolean"
17622
17622
  },
17623
+ "description": "**Deprecated.** Use the `value` attribute on `auro-menu` to set the selected option when the menu renders (or call `menu.selectByValue(value)` programmatically). Support for the child-level `selected` attribute will be removed in a future major release.",
17624
+ "deprecated": "Use the `value` attribute on `auro-menu` instead.",
17623
17625
  "default": "false",
17624
17626
  "attribute": "selected",
17625
17627
  "reflects": true
@@ -17658,6 +17660,18 @@
17658
17660
  "attribute": "nomatch",
17659
17661
  "reflects": true
17660
17662
  },
17663
+ {
17664
+ "kind": "field",
17665
+ "name": "persistent",
17666
+ "privacy": "public",
17667
+ "type": {
17668
+ "text": "boolean"
17669
+ },
17670
+ "description": "When true, this option is excluded from `matchWord` DOM rewriting — useful for utility rows (e.g., \"Add new…\") that must render identically regardless of the current filter.",
17671
+ "default": "false",
17672
+ "attribute": "persistent",
17673
+ "reflects": true
17674
+ },
17661
17675
  {
17662
17676
  "kind": "field",
17663
17677
  "name": "tabIndex",
@@ -17796,6 +17810,8 @@
17796
17810
  "type": {
17797
17811
  "text": "boolean"
17798
17812
  },
17813
+ "description": "**Deprecated.** Use the `value` attribute on `auro-menu` to set the selected option when the menu renders (or call `menu.selectByValue(value)` programmatically). Support for the child-level `selected` attribute will be removed in a future major release.",
17814
+ "deprecated": "Use the `value` attribute on `auro-menu` instead.",
17799
17815
  "default": "false",
17800
17816
  "fieldName": "selected"
17801
17817
  },
@@ -17838,6 +17854,15 @@
17838
17854
  "default": "false",
17839
17855
  "fieldName": "noMatch"
17840
17856
  },
17857
+ {
17858
+ "name": "persistent",
17859
+ "type": {
17860
+ "text": "boolean"
17861
+ },
17862
+ "description": "When true, this option is excluded from `matchWord` DOM rewriting — useful for utility rows (e.g., \"Add new…\") that must render identically regardless of the current filter.",
17863
+ "default": "false",
17864
+ "fieldName": "persistent"
17865
+ },
17841
17866
  {
17842
17867
  "name": "layout",
17843
17868
  "type": {
@@ -20416,7 +20441,7 @@
20416
20441
  "type": {
20417
20442
  "text": "object"
20418
20443
  },
20419
- "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { // Always clear the type-ahead buffer — Escape is a universal cancel. // Safe to call when the buffer is empty. // eslint-disable-next-line no-underscore-dangle if (typeof component._clearTypeaheadBuffer === 'function') { // eslint-disable-next-line no-underscore-dangle component._clearTypeaheadBuffer(); } if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getActiveOptions returns a fresh filtered array. // Uses \"active\" (not \"enabled\") so hidden and static rows — which a screen // reader must not announce as focused — are skipped. const lastOption = getActiveOptions(component.menu).pop(); if (!lastOption) { return; } // Pre-stash before show() so the auroDropdown-toggled handler's // `!optionActive` guard short-circuits the firstActive/selected fallback — // otherwise show() synchronously fires the handler and writes // aria-activedescendant once before we overwrite it. component.menu.updateActiveOption(lastOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Enter(component, evt, ctx) { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit. Matches APG select-only combobox // and native <select> behavior: Enter opens the listbox when closed, selects // the active option when open — it does not submit a parent form. evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getActiveOptions(component.menu); if (!firstOption) { return; } // See End() for why this must run before show(). component.menu.updateActiveOption(firstOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { // Ignore keys chorded with Ctrl/Meta/Alt so browser/OS shortcuts // (Cmd+C, Ctrl+V, Alt+X, Cmd+Space, …) don't leak into typeahead // or toggle the bib. Native <select> ignores modified keys. // ArrowUp/ArrowDown handle modifier+arrow explicitly above; this // guard only affects the default (printable/Space) branch. if (evt.ctrlKey || evt.metaKey || evt.altKey) { return; } // Space resolves to either typeahead-buffer extension or bib toggle // depending on whether a type-ahead buffer is active. Mirrors native // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space // is a search character (e.g. \"San Francisco\"); otherwise it toggles. if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) { component.updateActiveOptionBasedOnKey(evt.key); return; } if (ctx.isExpanded) { component.dropdown.hide(); } else { component.dropdown.show(); } return; } component.updateActiveOptionBasedOnKey(evt.key); }, }"
20444
+ "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { // Always clear the type-ahead buffer — Escape is a universal cancel. // Safe to call when the buffer is empty. // eslint-disable-next-line no-underscore-dangle if (typeof component._clearTypeaheadBuffer === 'function') { // eslint-disable-next-line no-underscore-dangle component._clearTypeaheadBuffer(); } if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getActiveOptions returns a fresh filtered array. // Uses \"active\" (not \"enabled\") so hidden and static rows — which a screen // reader must not announce as focused — are skipped. const lastOption = getActiveOptions(component.menu).pop(); if (!lastOption) { return; } // Pre-stash before show() so the auroDropdown-toggled handler's // `!optionActive` guard short-circuits the firstActive/selected fallback — // otherwise show() synchronously fires the handler and writes // aria-activedescendant once before we overwrite it. component.menu.updateActiveOption(lastOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Enter(component, evt, ctx) { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit. Matches APG select-only combobox // and native <select> behavior: Enter opens the listbox when closed, selects // the active option when open — it does not submit a parent form. evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getActiveOptions(component.menu); if (!firstOption) { return; } // See End() for why this must run before show(). component.menu.updateActiveOption(firstOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { // Ignore keys chorded with Ctrl/Meta/Alt so browser/OS shortcuts // (Cmd+C, Ctrl+V, Alt+X, Cmd+Space, …) don't leak into typeahead // or toggle the bib. Native <select> ignores modified keys. // ArrowUp/ArrowDown handle modifier+arrow explicitly above; this // guard only affects the default (printable/Space) branch. if (evt.ctrlKey || evt.metaKey || evt.altKey) { return; } // Space resolves to either typeahead-buffer extension or bib toggle // depending on whether a type-ahead buffer is active. Mirrors native // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space // is a search character (e.g. \"San Francisco\"); otherwise it toggles. if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) { component.updateActiveOptionBasedOnKey(evt.key); return; } if (ctx.isExpanded) { component.dropdown.hide(); } else { component.dropdown.show(); } return; } component.updateActiveOptionBasedOnKey(evt.key); }, }"
20420
20445
  }
20421
20446
  ],
20422
20447
  "exports": [