@aurodesignsystem-dev/auro-formkit 0.0.0-pr1608.2 → 0.0.0-pr1608.4

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