@aurodesignsystem-dev/auro-formkit 0.0.0-pr1432.0 → 0.0.0-pr1432.1

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