@aurodesignsystem-dev/auro-formkit 0.0.0-pr1614.0 → 0.0.0-pr1614.2

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