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

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