@aurodesignsystem-dev/auro-formkit 0.0.0-pr1541.3 → 0.0.0-pr1541.4

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