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