@aurodesignsystem-dev/auro-formkit 0.0.0-pr1610.1 → 0.0.0-pr1610.3

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