@aurodesignsystem-dev/auro-formkit 0.0.0-pr1474.3 → 0.0.0-pr1475.0

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 (83) hide show
  1. package/components/bibtemplate/dist/auro-bibtemplate.d.ts +7 -0
  2. package/components/bibtemplate/dist/index.js +9 -1
  3. package/components/bibtemplate/dist/registered.js +9 -1
  4. package/components/checkbox/demo/customize.html +2 -1
  5. package/components/checkbox/demo/customize.min.js +1 -1
  6. package/components/checkbox/demo/getting-started.min.js +1 -1
  7. package/components/checkbox/demo/index.min.js +1 -1
  8. package/components/checkbox/dist/index.js +1 -1
  9. package/components/checkbox/dist/registered.js +1 -1
  10. package/components/combobox/demo/customize.html +2 -1
  11. package/components/combobox/demo/customize.md +130 -106
  12. package/components/combobox/demo/customize.min.js +209 -16
  13. package/components/combobox/demo/getting-started.min.js +209 -16
  14. package/components/combobox/demo/index.min.js +209 -16
  15. package/components/combobox/dist/index.js +209 -16
  16. package/components/combobox/dist/registered.js +209 -16
  17. package/components/counter/demo/customize.min.js +208 -15
  18. package/components/counter/demo/index.min.js +208 -15
  19. package/components/counter/demo/keyboard-behavior.md +1 -0
  20. package/components/counter/dist/index.js +10 -2
  21. package/components/counter/dist/registered.js +10 -2
  22. package/components/datepicker/demo/accessibility.md +51 -3
  23. package/components/datepicker/demo/api.md +9 -0
  24. package/components/datepicker/demo/customize.html +2 -0
  25. package/components/datepicker/demo/customize.js +19 -0
  26. package/components/datepicker/demo/customize.md +72 -8
  27. package/components/datepicker/demo/customize.min.js +25690 -0
  28. package/components/datepicker/demo/design.md +3 -1
  29. package/components/datepicker/demo/index.js +2 -1
  30. package/components/datepicker/demo/index.md +81 -1
  31. package/components/datepicker/demo/index.min.js +1223 -101
  32. package/components/datepicker/demo/keyboard-behavior.md +201 -2
  33. package/components/datepicker/demo/voiceover.md +19 -12
  34. package/components/datepicker/dist/index.js +1155 -104
  35. package/components/datepicker/dist/registered.js +1155 -104
  36. package/components/datepicker/dist/src/auro-calendar-cell.d.ts +59 -0
  37. package/components/datepicker/dist/src/auro-calendar-month.d.ts +28 -0
  38. package/components/datepicker/dist/src/auro-calendar.d.ts +84 -0
  39. package/components/datepicker/dist/src/auro-datepicker.d.ts +80 -0
  40. package/components/datepicker/dist/src/datepickerKeyboardStrategy.d.ts +5 -3
  41. package/components/dropdown/demo/accessibility.md +11 -0
  42. package/components/dropdown/demo/api.md +1 -0
  43. package/components/dropdown/demo/customize.md +3 -0
  44. package/components/dropdown/demo/customize.min.js +198 -13
  45. package/components/dropdown/demo/getting-started.min.js +198 -13
  46. package/components/dropdown/demo/index.min.js +198 -13
  47. package/components/dropdown/demo/keyboard-behavior.md +1 -0
  48. package/components/dropdown/dist/auro-dropdown.d.ts +30 -1
  49. package/components/dropdown/dist/index.js +198 -13
  50. package/components/dropdown/dist/registered.js +198 -13
  51. package/components/form/demo/customize.html +6 -6
  52. package/components/form/demo/customize.js +0 -17
  53. package/components/form/demo/customize.md +51 -125
  54. package/components/form/demo/customize.min.js +1776 -327
  55. package/components/form/demo/getting-started.min.js +1776 -291
  56. package/components/form/demo/index.min.js +1776 -291
  57. package/components/form/demo/registerDemoDeps.min.js +1769 -139
  58. package/components/form/dist/auro-form.d.ts +5 -45
  59. package/components/form/dist/index.js +7 -152
  60. package/components/form/dist/registered.js +7 -152
  61. package/components/input/demo/customize.html +2 -1
  62. package/components/input/demo/customize.min.js +1 -1
  63. package/components/input/demo/getting-started.min.js +1 -1
  64. package/components/input/demo/index.min.js +1 -1
  65. package/components/input/dist/index.js +1 -1
  66. package/components/input/dist/registered.js +1 -1
  67. package/components/radio/demo/customize.min.js +2186 -0
  68. package/components/radio/demo/demo-support.min.js +55807 -0
  69. package/components/radio/demo/getting-started.js +1 -1
  70. package/components/radio/demo/getting-started.md +1 -1
  71. package/components/radio/demo/getting-started.min.js +2205 -0
  72. package/components/radio/demo/index.min.js +1 -1
  73. package/components/radio/dist/index.js +1 -1
  74. package/components/radio/dist/registered.js +1 -1
  75. package/components/select/demo/customize.html +2 -2
  76. package/components/select/demo/customize.min.js +208 -15
  77. package/components/select/demo/getting-started.min.js +208 -15
  78. package/components/select/demo/index.min.js +208 -15
  79. package/components/select/demo/keyboard-behavior.md +1 -0
  80. package/components/select/dist/index.js +208 -15
  81. package/components/select/dist/registered.js +208 -15
  82. package/custom-elements.json +2130 -1518
  83. package/package.json +2 -2
@@ -128,6 +128,17 @@
128
128
  },
129
129
  "attribute": "isFullscreen",
130
130
  "reflects": true
131
+ },
132
+ {
133
+ "kind": "field",
134
+ "name": "showFooter",
135
+ "privacy": "public",
136
+ "type": {
137
+ "text": "boolean"
138
+ },
139
+ "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
140
+ "attribute": "showFooter",
141
+ "reflects": true
131
142
  }
132
143
  ],
133
144
  "events": [
@@ -159,6 +170,14 @@
159
170
  },
160
171
  "default": "false",
161
172
  "fieldName": "large"
173
+ },
174
+ {
175
+ "name": "showFooter",
176
+ "type": {
177
+ "text": "boolean"
178
+ },
179
+ "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
180
+ "fieldName": "showFooter"
162
181
  }
163
182
  ],
164
183
  "superclass": {
@@ -248,34 +267,80 @@
248
267
  },
249
268
  {
250
269
  "kind": "javascript-module",
251
- "path": "components/checkbox/src/auro-checkbox-group.js",
270
+ "path": "components/combobox/src/auro-combobox.js",
252
271
  "declarations": [
253
272
  {
254
273
  "kind": "class",
255
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
256
- "name": "AuroCheckboxGroup",
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",
257
276
  "slots": [
258
277
  {
259
- "description": "Allows for the legend to be overridden.",
260
- "name": "legend"
278
+ "description": "Default slot for the menu content.",
279
+ "name": ""
261
280
  },
262
281
  {
282
+ "type": {
283
+ "text": "HTMLSlotElement"
284
+ },
263
285
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
264
286
  "name": "optionalLabel"
265
287
  },
266
288
  {
267
- "description": "Allows for the helper text to be overridden.",
289
+ "description": "Sets aria-label on clear button",
290
+ "name": "ariaLabel.input.clear"
291
+ },
292
+ {
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.",
268
306
  "name": "helpText"
269
307
  },
270
308
  {
271
- "description": "The default slot for the checkbox items.",
272
- "name": "default"
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"
273
311
  }
274
312
  ],
275
313
  "members": [
276
314
  {
277
315
  "kind": "method",
278
- "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
+ }
279
344
  },
280
345
  {
281
346
  "kind": "method",
@@ -284,7 +349,7 @@
284
349
  "parameters": [
285
350
  {
286
351
  "name": "name",
287
- "default": "\"auro-checkbox-group\"",
352
+ "default": "'auro-combobox'",
288
353
  "description": "The name of the element that you want to register.",
289
354
  "optional": true,
290
355
  "type": {
@@ -296,24 +361,62 @@
296
361
  },
297
362
  {
298
363
  "kind": "method",
299
- "name": "handleValueUpdate",
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"
370
+ }
371
+ }
372
+ },
373
+ {
374
+ "kind": "method",
375
+ "name": "activateLastEnabledAvailableOption",
376
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
377
+ "privacy": "private",
378
+ "return": {
379
+ "type": {
380
+ "text": "void"
381
+ }
382
+ }
383
+ },
384
+ {
385
+ "kind": "method",
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",
300
404
  "parameters": [
301
405
  {
302
- "name": "value",
303
- "description": "The value of the checkbox.",
304
- "type": {
305
- "text": "String"
306
- }
307
- },
308
- {
309
- "name": "selected",
310
- "description": "The checked state of the checkbox.",
406
+ "name": "label",
407
+ "description": "The label of the selected option.",
311
408
  "type": {
312
- "text": "Boolean"
409
+ "text": "string"
313
410
  }
314
411
  }
315
412
  ],
316
- "description": "Helper method to handle checkbox value changing.",
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.",
317
420
  "privacy": "private",
318
421
  "return": {
319
422
  "type": {
@@ -323,8 +426,8 @@
323
426
  },
324
427
  {
325
428
  "kind": "method",
326
- "name": "handlePreselectedItems",
327
- "description": "Helper method that handles the state of preselected checkboxes.",
429
+ "name": "generateOptionsArray",
430
+ "description": "Determines the element error state based on the `required` attribute and input value.",
328
431
  "privacy": "private",
329
432
  "return": {
330
433
  "type": {
@@ -334,9 +437,8 @@
334
437
  },
335
438
  {
336
439
  "kind": "method",
337
- "name": "handleItems",
338
- "description": "Helper method that handles the state of checkboxes.",
339
- "privacy": "private",
440
+ "name": "hideBib",
441
+ "description": "Hides the dropdown bib if its open.",
340
442
  "return": {
341
443
  "type": {
342
444
  "text": "void"
@@ -345,8 +447,8 @@
345
447
  },
346
448
  {
347
449
  "kind": "method",
348
- "name": "reset",
349
- "description": "Resets component to initial state.",
450
+ "name": "showBib",
451
+ "description": "Shows the dropdown bib if there are options to show.",
350
452
  "return": {
351
453
  "type": {
352
454
  "text": "void"
@@ -355,325 +457,102 @@
355
457
  },
356
458
  {
357
459
  "kind": "method",
358
- "name": "validate",
359
- "parameters": [
360
- {
361
- "name": "force",
362
- "default": "false",
363
- "description": "Whether to force validation.",
364
- "optional": true,
365
- "type": {
366
- "text": "boolean"
367
- }
460
+ "name": "configureDropdown",
461
+ "description": "Binds all behavior needed to the dropdown after rendering.",
462
+ "privacy": "private",
463
+ "return": {
464
+ "type": {
465
+ "text": "void"
368
466
  }
369
- ],
370
- "description": "Validates value."
467
+ }
371
468
  },
372
469
  {
373
- "kind": "field",
374
- "name": "appearance",
375
- "privacy": "public",
376
- "type": {
377
- "text": "'default' | 'inverse'"
378
- },
379
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
380
- "default": "'default'",
381
- "attribute": "appearance",
382
- "reflects": true
470
+ "kind": "method",
471
+ "name": "setClearBtnFocus",
472
+ "privacy": "private"
383
473
  },
384
474
  {
385
- "kind": "field",
386
- "name": "disabled",
387
- "privacy": "public",
388
- "type": {
389
- "text": "boolean"
390
- },
391
- "description": "If set, disables the checkbox group.",
392
- "attribute": "disabled",
393
- "reflects": true
475
+ "kind": "method",
476
+ "name": "setTriggerInputFocus",
477
+ "privacy": "private"
394
478
  },
395
479
  {
396
- "kind": "field",
397
- "name": "error",
398
- "privacy": "public",
399
- "type": {
400
- "text": "string"
401
- },
402
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
403
- "attribute": "error",
404
- "reflects": true
480
+ "kind": "method",
481
+ "name": "setInputFocus",
482
+ "privacy": "private"
405
483
  },
406
484
  {
407
- "kind": "field",
408
- "name": "horizontal",
409
- "privacy": "public",
410
- "type": {
411
- "text": "boolean"
412
- },
413
- "description": "If set, checkboxes will be aligned horizontally.",
414
- "attribute": "horizontal",
415
- "reflects": true
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"
416
489
  },
417
490
  {
418
- "kind": "field",
419
- "name": "noValidate",
420
- "privacy": "public",
421
- "type": {
422
- "text": "boolean"
423
- },
424
- "description": "If set, disables auto-validation on blur.",
425
- "attribute": "noValidate",
426
- "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"
427
495
  },
428
496
  {
429
- "kind": "field",
430
- "name": "onDark",
431
- "privacy": "public",
432
- "type": {
433
- "text": "boolean"
434
- },
435
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
436
- "attribute": "onDark",
437
- "reflects": true
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.",
500
+ "privacy": "private",
501
+ "return": {
502
+ "type": {
503
+ "text": "ShadowRoot"
504
+ }
505
+ }
438
506
  },
439
507
  {
440
- "kind": "field",
441
- "name": "required",
442
- "privacy": "public",
443
- "type": {
444
- "text": "boolean"
445
- },
446
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
447
- "attribute": "required",
448
- "reflects": true
449
- },
450
- {
451
- "kind": "field",
452
- "name": "setCustomValidity",
453
- "privacy": "public",
454
- "type": {
455
- "text": "string"
456
- },
457
- "description": "Sets a custom help text message to display for all validityStates.",
458
- "attribute": "setCustomValidity"
459
- },
460
- {
461
- "kind": "field",
462
- "name": "setCustomValidityCustomError",
463
- "privacy": "public",
464
- "type": {
465
- "text": "string"
466
- },
467
- "description": "Custom help text message to display when validity = `customError`.",
468
- "attribute": "setCustomValidityCustomError"
469
- },
470
- {
471
- "kind": "field",
472
- "name": "setCustomValidityValueMissing",
473
- "privacy": "public",
474
- "type": {
475
- "text": "string"
476
- },
477
- "description": "Custom help text message to display when validity = `valueMissing`.",
478
- "attribute": "setCustomValidityValueMissing"
479
- },
480
- {
481
- "kind": "field",
482
- "name": "validity",
483
- "privacy": "public",
484
- "type": {
485
- "text": "string"
486
- },
487
- "description": "Specifies the `validityState` this element is in.",
488
- "attribute": "validity",
489
- "reflects": true
490
- }
491
- ],
492
- "events": [
493
- {
494
- "name": "input",
495
- "type": {
496
- "text": "CustomEvent"
508
+ "kind": "method",
509
+ "name": "configureMenu",
510
+ "description": "Binds all behavior needed to the menu after rendering.",
511
+ "privacy": "private",
512
+ "return": {
513
+ "type": {
514
+ "text": "void"
515
+ }
497
516
  }
498
517
  },
499
- {
500
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
501
- "name": "auroFormElement-validated"
502
- }
503
- ],
504
- "attributes": [
505
- {
506
- "name": "appearance",
507
- "type": {
508
- "text": "'default' | 'inverse'"
509
- },
510
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
511
- "default": "'default'",
512
- "fieldName": "appearance"
513
- },
514
- {
515
- "name": "disabled",
516
- "type": {
517
- "text": "boolean"
518
- },
519
- "description": "If set, disables the checkbox group.",
520
- "fieldName": "disabled"
521
- },
522
- {
523
- "name": "error",
524
- "type": {
525
- "text": "string"
526
- },
527
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
528
- "fieldName": "error"
529
- },
530
- {
531
- "name": "horizontal",
532
- "type": {
533
- "text": "boolean"
534
- },
535
- "description": "If set, checkboxes will be aligned horizontally.",
536
- "fieldName": "horizontal"
537
- },
538
- {
539
- "name": "noValidate",
540
- "type": {
541
- "text": "boolean"
542
- },
543
- "description": "If set, disables auto-validation on blur.",
544
- "fieldName": "noValidate"
545
- },
546
- {
547
- "name": "onDark",
548
- "type": {
549
- "text": "boolean"
550
- },
551
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
552
- "fieldName": "onDark"
553
- },
554
- {
555
- "name": "required",
556
- "type": {
557
- "text": "boolean"
558
- },
559
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
560
- "fieldName": "required"
561
- },
562
- {
563
- "name": "setCustomValidity",
564
- "type": {
565
- "text": "string"
566
- },
567
- "description": "Sets a custom help text message to display for all validityStates.",
568
- "fieldName": "setCustomValidity"
569
- },
570
- {
571
- "name": "setCustomValidityCustomError",
572
- "type": {
573
- "text": "string"
574
- },
575
- "description": "Custom help text message to display when validity = `customError`.",
576
- "fieldName": "setCustomValidityCustomError"
577
- },
578
- {
579
- "name": "setCustomValidityValueMissing",
580
- "type": {
581
- "text": "string"
582
- },
583
- "description": "Custom help text message to display when validity = `valueMissing`.",
584
- "fieldName": "setCustomValidityValueMissing"
585
- },
586
- {
587
- "name": "validity",
588
- "type": {
589
- "text": "string"
590
- },
591
- "description": "Specifies the `validityState` this element is in.",
592
- "fieldName": "validity"
593
- }
594
- ],
595
- "superclass": {
596
- "name": "LitElement",
597
- "package": "lit"
598
- },
599
- "tagName": "auro-checkbox-group",
600
- "customElement": true
601
- }
602
- ],
603
- "exports": [
604
- {
605
- "kind": "js",
606
- "name": "AuroCheckboxGroup",
607
- "declaration": {
608
- "name": "AuroCheckboxGroup",
609
- "module": "components/checkbox/src/auro-checkbox-group.js"
610
- }
611
- }
612
- ]
613
- },
614
- {
615
- "kind": "javascript-module",
616
- "path": "components/checkbox/src/auro-checkbox.js",
617
- "declarations": [
618
- {
619
- "kind": "class",
620
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
621
- "name": "AuroCheckbox",
622
- "cssParts": [
623
- {
624
- "description": "apply css to a specific checkbox.",
625
- "name": "checkbox"
626
- },
627
- {
628
- "description": "apply css to a specific checkbox's input.",
629
- "name": "checkbox-input"
630
- },
631
- {
632
- "description": "apply css to a specific checkbox's label.",
633
- "name": "checkbox-label"
634
- }
635
- ],
636
- "slots": [
637
- {
638
- "description": "The default slot for the checkbox label.",
639
- "name": "default"
640
- }
641
- ],
642
- "members": [
643
518
  {
644
519
  "kind": "method",
645
- "name": "_initializeDefaults"
520
+ "name": "configureInput",
521
+ "description": "Binds all behavior needed to the input after rendering.",
522
+ "privacy": "private",
523
+ "return": {
524
+ "type": {
525
+ "text": "void"
526
+ }
527
+ }
646
528
  },
647
529
  {
648
530
  "kind": "method",
649
- "name": "register",
650
- "static": true,
531
+ "name": "handleMenuLoadingChange",
651
532
  "parameters": [
652
533
  {
653
- "name": "name",
654
- "default": "\"auro-checkbox\"",
655
- "description": "The name of element that you want to register to.",
656
- "optional": true,
534
+ "name": "event",
535
+ "description": "The event object containing details about the loading state change.",
657
536
  "type": {
658
- "text": "string"
537
+ "text": "CustomEvent"
659
538
  }
660
- }
661
- ],
662
- "description": "This will register this element with the browser."
663
- },
664
- {
665
- "kind": "method",
666
- "name": "handleChange",
667
- "parameters": [
539
+ },
668
540
  {
669
- "name": "event",
670
- "description": "The change event from the checkbox input.",
541
+ "description": "Indicates whether the menu is currently loading.",
542
+ "name": "event.detail.loading",
671
543
  "type": {
672
- "text": "Event"
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"
673
552
  }
674
553
  }
675
554
  ],
676
- "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.",
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.",
677
556
  "privacy": "private",
678
557
  "return": {
679
558
  "type": {
@@ -683,17 +562,17 @@
683
562
  },
684
563
  {
685
564
  "kind": "method",
686
- "name": "handleInput",
565
+ "name": "handleInputValueChange",
687
566
  "parameters": [
688
567
  {
689
568
  "name": "event",
690
- "description": "The input event from the checkbox input.",
569
+ "description": "The input event triggered by the input element.",
691
570
  "type": {
692
571
  "text": "Event"
693
572
  }
694
573
  }
695
574
  ],
696
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
575
+ "description": "Handle changes to the input value and trigger changes that should result.",
697
576
  "privacy": "private",
698
577
  "return": {
699
578
  "type": {
@@ -703,8 +582,8 @@
703
582
  },
704
583
  {
705
584
  "kind": "method",
706
- "name": "handleFocusin",
707
- "description": "Function to support",
585
+ "name": "configureCombobox",
586
+ "description": "Binds all behavior needed to the combobox after rendering.",
708
587
  "privacy": "private",
709
588
  "return": {
710
589
  "type": {
@@ -714,12 +593,30 @@
714
593
  },
715
594
  {
716
595
  "kind": "method",
717
- "name": "generateIconHtml",
718
- "description": "Function to generate checkmark svg.",
719
- "privacy": "private",
596
+ "name": "focus",
597
+ "description": "Focuses the combobox trigger input.",
720
598
  "return": {
721
599
  "type": {
722
- "text": "HTMLElement"
600
+ "text": "void"
601
+ }
602
+ }
603
+ },
604
+ {
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"
723
620
  }
724
621
  }
725
622
  },
@@ -735,8 +632,57 @@
735
632
  },
736
633
  {
737
634
  "kind": "method",
738
- "name": "updateAriaLabel",
739
- "description": "Updates the aria-label based on slot content.",
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.",
740
686
  "privacy": "private",
741
687
  "return": {
742
688
  "type": {
@@ -746,17 +692,31 @@
746
692
  },
747
693
  {
748
694
  "kind": "method",
749
- "name": "handleKeyDown",
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",
750
710
  "parameters": [
751
711
  {
752
712
  "name": "event",
753
- "description": "The keydown event from the checkbox input.",
713
+ "description": "`slotchange` event.",
754
714
  "type": {
755
- "text": "KeyboardEvent"
715
+ "text": "Event"
756
716
  }
757
717
  }
758
718
  ],
759
- "description": "Handles keydown event to toggle the checkbox with Space key.",
719
+ "description": "Watch for slot changes and recalculate the menuoptions.",
760
720
  "privacy": "private",
761
721
  "return": {
762
722
  "type": {
@@ -769,7 +729,7 @@
769
729
  "name": "appearance",
770
730
  "privacy": "public",
771
731
  "type": {
772
- "text": "'default' | 'inverse'"
732
+ "text": "string"
773
733
  },
774
734
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
775
735
  "default": "'default'",
@@ -778,974 +738,1089 @@
778
738
  },
779
739
  {
780
740
  "kind": "field",
781
- "name": "checked",
741
+ "name": "autocomplete",
782
742
  "privacy": "public",
783
743
  "type": {
784
- "text": "boolean"
744
+ "text": "string"
785
745
  },
786
- "description": "If set to true, the checkbox will be filled with a checkmark.",
787
- "attribute": "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",
788
748
  "reflects": true
789
749
  },
790
750
  {
791
751
  "kind": "field",
792
- "name": "disabled",
752
+ "name": "autoPlacement",
793
753
  "privacy": "public",
794
754
  "type": {
795
755
  "text": "boolean"
796
756
  },
797
- "description": "If set to true, the checkbox will not be clickable.",
798
- "attribute": "disabled",
757
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
758
+ "attribute": "autoPlacement",
799
759
  "reflects": true
800
760
  },
801
761
  {
802
762
  "kind": "field",
803
- "name": "error",
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",
804
774
  "privacy": "public",
805
775
  "type": {
806
- "text": "boolean"
776
+ "text": "'filter' | 'suggestion'"
807
777
  },
808
- "description": "If set to true, the checkbox will be displayed with an error state.",
809
- "attribute": "error",
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",
810
781
  "reflects": true
811
782
  },
812
783
  {
813
784
  "kind": "field",
814
- "name": "id",
785
+ "name": "checkmark",
815
786
  "privacy": "public",
816
787
  "type": {
817
- "text": "string"
788
+ "text": "boolean"
818
789
  },
819
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
820
- "attribute": "id",
790
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
791
+ "attribute": "checkmark",
821
792
  "reflects": true
822
793
  },
823
794
  {
824
795
  "kind": "field",
825
- "name": "inputId",
826
- "privacy": "private",
796
+ "name": "disabled",
797
+ "privacy": "public",
827
798
  "type": {
828
- "text": "string"
799
+ "text": "boolean"
829
800
  },
830
- "description": "The id for input node."
801
+ "description": "If set, disables the combobox.",
802
+ "attribute": "disabled",
803
+ "reflects": true
831
804
  },
832
805
  {
833
806
  "kind": "field",
834
- "name": "name",
835
- "privacy": "public",
807
+ "name": "dropdownId",
808
+ "privacy": "private",
836
809
  "type": {
837
810
  "text": "string"
838
811
  },
839
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
840
- "attribute": "name"
812
+ "description": "ID for the dropdown."
841
813
  },
842
814
  {
843
815
  "kind": "field",
844
- "name": "onDark",
845
- "privacy": "public",
816
+ "name": "dropdownOpen",
817
+ "privacy": "private",
846
818
  "type": {
847
819
  "text": "boolean"
848
820
  },
849
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
850
- "attribute": "onDark",
851
- "reflects": true
821
+ "description": "Whether or not the dropdown is open."
852
822
  },
853
823
  {
854
824
  "kind": "field",
855
- "name": "touched",
856
- "privacy": "private",
825
+ "name": "dvInputOnly",
826
+ "privacy": "public",
857
827
  "type": {
858
828
  "text": "boolean"
859
829
  },
860
- "description": "Indicates whether the checkbox has been interacted with."
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
861
833
  },
862
834
  {
863
835
  "kind": "field",
864
- "name": "value",
836
+ "name": "error",
865
837
  "privacy": "public",
866
838
  "type": {
867
839
  "text": "string"
868
840
  },
869
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
870
- "attribute": "value"
841
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
842
+ "attribute": "error",
843
+ "reflects": true
871
844
  },
872
845
  {
873
846
  "kind": "field",
874
- "name": "tabIndex",
875
- "privacy": "private",
847
+ "name": "format",
848
+ "privacy": "public",
876
849
  "type": {
877
- "text": "number"
850
+ "text": "string"
878
851
  },
879
- "description": "The tabindex attribute for the checkbox.",
880
- "attribute": "tabindex",
852
+ "description": "Specifies the input mask format.",
853
+ "attribute": "format",
881
854
  "reflects": true
882
855
  },
883
856
  {
884
857
  "kind": "field",
885
- "name": "ariaChecked",
886
- "privacy": "private",
858
+ "name": "inputmode",
859
+ "privacy": "public",
887
860
  "type": {
888
861
  "text": "string"
889
862
  },
890
- "description": "The aria-checked attribute for the checkbox.",
891
- "attribute": "aria-checked",
863
+ "description": "Exposes inputmode attribute for input.",
864
+ "attribute": "inputmode",
892
865
  "reflects": true
893
866
  },
894
867
  {
895
868
  "kind": "field",
896
- "name": "ariaDisabled",
897
- "privacy": "private",
869
+ "name": "layout",
870
+ "privacy": "public",
898
871
  "type": {
899
872
  "text": "string"
900
873
  },
901
- "description": "The aria-disabled attribute for the checkbox.",
902
- "attribute": "aria-disabled",
903
- "reflects": true
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"
881
+ }
904
882
  },
905
883
  {
906
884
  "kind": "field",
907
- "name": "role",
885
+ "name": "matchWidth",
908
886
  "privacy": "private",
909
887
  "type": {
910
- "text": "string"
888
+ "text": "boolean"
911
889
  },
912
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
913
- "attribute": "role",
890
+ "description": "If declared, the popover and trigger will be set to the same width.",
891
+ "attribute": "matchWidth",
914
892
  "reflects": true
915
- }
916
- ],
917
- "events": [
893
+ },
918
894
  {
919
- "name": "auroCheckbox-input",
895
+ "kind": "field",
896
+ "name": "noFilter",
897
+ "privacy": "public",
920
898
  "type": {
921
- "text": "CustomEvent"
922
- }
899
+ "text": "boolean"
900
+ },
901
+ "description": "If set, combobox will not filter menuoptions based on input.",
902
+ "attribute": "noFilter",
903
+ "reflects": true
923
904
  },
924
905
  {
925
- "name": "auroCheckbox-focusin",
906
+ "kind": "field",
907
+ "name": "noFlip",
908
+ "privacy": "public",
926
909
  "type": {
927
- "text": "CustomEvent"
928
- }
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
929
915
  },
930
916
  {
931
- "name": "auroCheckbox-focusout",
917
+ "kind": "field",
918
+ "name": "shift",
919
+ "privacy": "public",
932
920
  "type": {
933
- "text": "CustomEvent"
934
- }
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
935
926
  },
936
927
  {
937
- "description": "(Deprecated) Notifies when checked value is changed.",
938
- "name": "change"
928
+ "kind": "field",
929
+ "name": "noValidate",
930
+ "privacy": "public",
931
+ "type": {
932
+ "text": "boolean"
933
+ },
934
+ "description": "If set, disables auto-validation on blur.",
935
+ "attribute": "noValidate",
936
+ "reflects": true
939
937
  },
940
938
  {
941
- "description": "Notifies when when checked value is changed by user's interface.",
942
- "name": "input"
943
- }
944
- ],
945
- "attributes": [
946
- {
947
- "name": "appearance",
939
+ "kind": "field",
940
+ "name": "offset",
941
+ "privacy": "public",
948
942
  "type": {
949
- "text": "'default' | 'inverse'"
943
+ "text": "number"
950
944
  },
951
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
952
- "default": "'default'",
953
- "fieldName": "appearance"
945
+ "description": "Gap between the trigger element and bib.",
946
+ "default": "0",
947
+ "attribute": "offset",
948
+ "reflects": true
954
949
  },
955
950
  {
956
- "name": "checked",
951
+ "kind": "field",
952
+ "name": "onDark",
953
+ "privacy": "public",
957
954
  "type": {
958
955
  "text": "boolean"
959
956
  },
960
- "description": "If set to true, the checkbox will be filled with a checkmark.",
961
- "fieldName": "checked"
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"
963
+ }
962
964
  },
963
965
  {
964
- "name": "disabled",
966
+ "kind": "field",
967
+ "name": "optionSelected",
968
+ "privacy": "public",
965
969
  "type": {
966
- "text": "boolean"
970
+ "text": "HTMLElement"
967
971
  },
968
- "description": "If set to true, the checkbox will not be clickable.",
969
- "fieldName": "disabled"
972
+ "description": "Specifies the current selected option.",
973
+ "attribute": "optionSelected"
970
974
  },
971
975
  {
972
- "name": "error",
976
+ "kind": "field",
977
+ "name": "persistInput",
978
+ "privacy": "public",
973
979
  "type": {
974
980
  "text": "boolean"
975
981
  },
976
- "description": "If set to true, the checkbox will be displayed with an error state.",
977
- "fieldName": "error"
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
978
985
  },
979
986
  {
980
- "name": "id",
987
+ "kind": "field",
988
+ "name": "placement",
989
+ "privacy": "public",
981
990
  "type": {
982
- "text": "string"
991
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
983
992
  },
984
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
985
- "fieldName": "id"
993
+ "description": "Position where the bib should appear relative to the trigger.",
994
+ "default": "'bottom-start'",
995
+ "attribute": "placement",
996
+ "reflects": true
986
997
  },
987
998
  {
988
- "name": "name",
999
+ "kind": "field",
1000
+ "name": "placeholder",
1001
+ "privacy": "public",
989
1002
  "type": {
990
1003
  "text": "string"
991
1004
  },
992
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
993
- "fieldName": "name"
1005
+ "description": "Define custom placeholder text, only supported by date input formats.",
1006
+ "attribute": "placeholder",
1007
+ "reflects": true
994
1008
  },
995
1009
  {
996
- "name": "onDark",
1010
+ "kind": "field",
1011
+ "name": "required",
1012
+ "privacy": "public",
997
1013
  "type": {
998
1014
  "text": "boolean"
999
1015
  },
1000
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1001
- "fieldName": "onDark"
1016
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1017
+ "attribute": "required",
1018
+ "reflects": true
1002
1019
  },
1003
1020
  {
1004
- "name": "value",
1021
+ "kind": "field",
1022
+ "name": "setCustomValidity",
1023
+ "privacy": "public",
1005
1024
  "type": {
1006
1025
  "text": "string"
1007
1026
  },
1008
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1009
- "fieldName": "value"
1027
+ "description": "Sets a custom help text message to display for all validityStates.",
1028
+ "attribute": "setCustomValidity"
1010
1029
  },
1011
1030
  {
1012
- "name": "tabindex",
1031
+ "kind": "field",
1032
+ "name": "setCustomValidityCustomError",
1033
+ "privacy": "public",
1013
1034
  "type": {
1014
- "text": "number"
1035
+ "text": "string"
1015
1036
  },
1016
- "description": "The tabindex attribute for the checkbox.",
1017
- "fieldName": "tabIndex"
1037
+ "description": "Custom help text message to display when validity = `customError`.",
1038
+ "attribute": "setCustomValidityCustomError"
1018
1039
  },
1019
1040
  {
1020
- "name": "aria-checked",
1041
+ "kind": "field",
1042
+ "name": "setCustomValidityValueMissing",
1043
+ "privacy": "public",
1021
1044
  "type": {
1022
1045
  "text": "string"
1023
1046
  },
1024
- "description": "The aria-checked attribute for the checkbox.",
1025
- "fieldName": "ariaChecked"
1047
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1048
+ "attribute": "setCustomValidityValueMissing"
1026
1049
  },
1027
1050
  {
1028
- "name": "aria-disabled",
1051
+ "kind": "field",
1052
+ "name": "setCustomValidityValueMissingFilter",
1053
+ "privacy": "public",
1029
1054
  "type": {
1030
1055
  "text": "string"
1031
1056
  },
1032
- "description": "The aria-disabled attribute for the checkbox.",
1033
- "fieldName": "ariaDisabled"
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"
1034
1059
  },
1035
1060
  {
1036
- "name": "role",
1061
+ "kind": "field",
1062
+ "name": "touched",
1063
+ "privacy": "private",
1037
1064
  "type": {
1038
- "text": "string"
1065
+ "text": "boolean"
1039
1066
  },
1040
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
1041
- "fieldName": "role"
1042
- }
1043
- ],
1044
- "superclass": {
1045
- "name": "LitElement",
1046
- "package": "lit"
1047
- },
1048
- "tagName": "auro-checkbox",
1049
- "customElement": true
1050
- }
1051
- ],
1052
- "exports": [
1053
- {
1054
- "kind": "js",
1055
- "name": "AuroCheckbox",
1056
- "declaration": {
1057
- "name": "AuroCheckbox",
1058
- "module": "components/checkbox/src/auro-checkbox.js"
1059
- }
1060
- }
1061
- ]
1062
- },
1063
- {
1064
- "kind": "javascript-module",
1065
- "path": "components/checkbox/src/index.js",
1066
- "declarations": [],
1067
- "exports": [
1068
- {
1069
- "kind": "js",
1070
- "name": "AuroCheckbox",
1071
- "declaration": {
1072
- "name": "AuroCheckbox",
1073
- "module": "components/checkbox/src/index.js"
1074
- }
1075
- },
1076
- {
1077
- "kind": "js",
1078
- "name": "AuroCheckboxGroup",
1079
- "declaration": {
1080
- "name": "AuroCheckboxGroup",
1081
- "module": "components/checkbox/src/index.js"
1082
- }
1083
- }
1084
- ]
1085
- },
1086
- {
1087
- "kind": "javascript-module",
1088
- "path": "components/checkbox/src/registered.js",
1089
- "declarations": [],
1090
- "exports": []
1091
- },
1092
- {
1093
- "kind": "javascript-module",
1094
- "path": "components/combobox/src/auro-combobox.js",
1095
- "declarations": [
1096
- {
1097
- "kind": "class",
1098
- "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.",
1099
- "name": "AuroCombobox",
1100
- "slots": [
1101
- {
1102
- "description": "Default slot for the menu content.",
1103
- "name": ""
1067
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1104
1068
  },
1105
1069
  {
1070
+ "kind": "field",
1071
+ "name": "triggerIcon",
1072
+ "privacy": "public",
1106
1073
  "type": {
1107
- "text": "HTMLSlotElement"
1074
+ "text": "boolean"
1108
1075
  },
1109
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1110
- "name": "optionalLabel"
1111
- },
1112
- {
1113
- "description": "Sets aria-label on clear button",
1114
- "name": "ariaLabel.input.clear"
1076
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1077
+ "attribute": "triggerIcon",
1078
+ "reflects": true
1115
1079
  },
1116
1080
  {
1117
- "description": "Sets aria-label on close button in fullscreen bib",
1118
- "name": "ariaLabel.bib.close"
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
1119
1090
  },
1120
1091
  {
1121
- "description": "Defines the headline to display above menu-options",
1122
- "name": "bib.fullscreen.headline"
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
1123
1101
  },
1124
1102
  {
1125
- "description": "Defines the content of the label.",
1126
- "name": "label"
1127
- },
1128
- {
1129
- "description": "Defines the content of the helpText.",
1130
- "name": "helpText"
1131
- },
1132
- {
1133
- "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
1134
- "name": "displayValue"
1135
- }
1136
- ],
1137
- "members": [
1138
- {
1139
- "kind": "method",
1140
- "name": "_initializeDefaults",
1141
- "privacy": "private",
1142
- "return": {
1143
- "type": {
1144
- "text": "void"
1145
- }
1146
- }
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
1147
1112
  },
1148
1113
  {
1149
1114
  "kind": "field",
1150
- "name": "inputValue",
1151
- "description": "Returns the current value of the input element within the combobox.",
1152
- "return": {
1153
- "type": {
1154
- "text": "string|undefined"
1155
- }
1115
+ "name": "value",
1116
+ "privacy": "public",
1117
+ "type": {
1118
+ "text": "string"
1156
1119
  },
1157
- "readonly": true
1120
+ "description": "Value selected for the dropdown menu.",
1121
+ "attribute": "value"
1158
1122
  },
1159
1123
  {
1160
- "kind": "method",
1161
- "name": "isValid",
1162
- "description": "Checks if the element is valid.",
1163
- "return": {
1164
- "type": {
1165
- "text": "boolean"
1166
- }
1167
- }
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
1168
1133
  },
1169
1134
  {
1170
- "kind": "method",
1171
- "name": "register",
1172
- "static": true,
1173
- "parameters": [
1174
- {
1175
- "name": "name",
1176
- "default": "'auro-combobox'",
1177
- "description": "The name of the element that you want to register.",
1178
- "optional": true,
1179
- "type": {
1180
- "text": "string"
1181
- }
1182
- }
1183
- ],
1184
- "description": "This will register this element with the browser."
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
1185
1145
  },
1186
1146
  {
1187
- "kind": "method",
1188
- "name": "activateFirstEnabledAvailableOption",
1189
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
1147
+ "kind": "field",
1148
+ "name": "optionActive",
1190
1149
  "privacy": "private",
1191
- "return": {
1192
- "type": {
1193
- "text": "void"
1194
- }
1195
- }
1150
+ "type": {
1151
+ "text": "object"
1152
+ },
1153
+ "description": "Specifies the currently active option."
1196
1154
  },
1197
1155
  {
1198
- "kind": "method",
1199
- "name": "activateLastEnabledAvailableOption",
1200
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
1156
+ "kind": "field",
1157
+ "name": "triggerExpandedState",
1201
1158
  "privacy": "private",
1202
- "return": {
1203
- "type": {
1204
- "text": "void"
1205
- }
1206
- }
1207
- },
1208
- {
1209
- "kind": "method",
1210
- "name": "updateFilter",
1211
- "description": "Updates the filter for the available options based on the input value.",
1212
- "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\"."
1213
1163
  },
1214
1164
  {
1215
- "kind": "method",
1216
- "name": "syncValuesAndStates",
1217
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1165
+ "kind": "field",
1166
+ "name": "componentHasFocus",
1167
+ "description": "Returns true if the element has focus.",
1218
1168
  "privacy": "private",
1219
1169
  "return": {
1220
1170
  "type": {
1221
- "text": "void"
1171
+ "text": "boolean"
1222
1172
  }
1173
+ },
1174
+ "readonly": true,
1175
+ "inheritedFrom": {
1176
+ "name": "AuroElement",
1177
+ "module": "components/layoutElement/src/auroElement.js"
1223
1178
  }
1224
1179
  },
1225
1180
  {
1226
1181
  "kind": "method",
1227
- "name": "updateTriggerTextDisplay",
1228
- "parameters": [
1229
- {
1230
- "name": "label",
1231
- "description": "The label of the selected option.",
1232
- "type": {
1233
- "text": "string"
1234
- }
1235
- }
1236
- ],
1237
- "description": "Update displayValue or input.value, it's called when making a selection.",
1238
- "privacy": "private"
1239
- },
1240
- {
1241
- "kind": "method",
1242
- "name": "handleMenuOptions",
1243
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1244
- "privacy": "private",
1245
- "return": {
1246
- "type": {
1247
- "text": "void"
1248
- }
1182
+ "name": "resetShapeClasses",
1183
+ "inheritedFrom": {
1184
+ "name": "AuroElement",
1185
+ "module": "components/layoutElement/src/auroElement.js"
1249
1186
  }
1250
1187
  },
1251
1188
  {
1252
1189
  "kind": "method",
1253
- "name": "generateOptionsArray",
1254
- "description": "Determines the element error state based on the `required` attribute and input value.",
1255
- "privacy": "private",
1256
- "return": {
1257
- "type": {
1258
- "text": "void"
1259
- }
1190
+ "name": "resetLayoutClasses",
1191
+ "inheritedFrom": {
1192
+ "name": "AuroElement",
1193
+ "module": "components/layoutElement/src/auroElement.js"
1260
1194
  }
1261
1195
  },
1262
1196
  {
1263
1197
  "kind": "method",
1264
- "name": "hideBib",
1265
- "description": "Hides the dropdown bib if its open.",
1266
- "return": {
1267
- "type": {
1268
- "text": "void"
1269
- }
1198
+ "name": "updateComponentArchitecture",
1199
+ "inheritedFrom": {
1200
+ "name": "AuroElement",
1201
+ "module": "components/layoutElement/src/auroElement.js"
1270
1202
  }
1271
1203
  },
1272
1204
  {
1273
- "kind": "method",
1274
- "name": "showBib",
1275
- "description": "Shows the dropdown bib if there are options to show.",
1276
- "return": {
1277
- "type": {
1278
- "text": "void"
1279
- }
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"
1280
1216
  }
1281
1217
  },
1282
1218
  {
1283
- "kind": "method",
1284
- "name": "configureDropdown",
1285
- "description": "Binds all behavior needed to the dropdown after rendering.",
1286
- "privacy": "private",
1287
- "return": {
1288
- "type": {
1289
- "text": "void"
1290
- }
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"
1291
1230
  }
1292
- },
1231
+ }
1232
+ ],
1233
+ "events": [
1293
1234
  {
1294
- "kind": "method",
1295
- "name": "setClearBtnFocus",
1296
- "privacy": "private"
1235
+ "name": "inputValue",
1236
+ "type": {
1237
+ "text": "CustomEvent"
1238
+ },
1239
+ "description": "Notifies that the components internal HTML5 input value has changed."
1297
1240
  },
1298
1241
  {
1299
- "kind": "method",
1300
- "name": "setTriggerInputFocus",
1301
- "privacy": "private"
1242
+ "name": "input",
1243
+ "type": {
1244
+ "text": "CustomEvent"
1245
+ },
1246
+ "description": "Notifies that the component has a new value set."
1302
1247
  },
1303
1248
  {
1304
- "kind": "method",
1305
- "name": "setInputFocus",
1306
- "privacy": "private"
1249
+ "name": "auroCombobox-valueSet",
1250
+ "type": {
1251
+ "text": "CustomEvent"
1252
+ },
1253
+ "description": "(Deprecated) Notifies that the component has a new value set."
1307
1254
  },
1308
1255
  {
1309
- "kind": "method",
1310
- "name": "updateBibDialogRole",
1311
- "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.",
1312
- "privacy": "private"
1313
- },
1256
+ "description": "Notifies that the component value(s) have been validated.",
1257
+ "name": "auroFormElement-validated"
1258
+ }
1259
+ ],
1260
+ "attributes": [
1314
1261
  {
1315
- "kind": "method",
1316
- "name": "updateMenuShapeSize",
1317
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1318
- "privacy": "private"
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"
1319
1269
  },
1320
1270
  {
1321
- "kind": "method",
1322
- "name": "_getAnnouncementRoot",
1323
- "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.",
1324
- "privacy": "private",
1325
- "return": {
1326
- "type": {
1327
- "text": "ShadowRoot"
1328
- }
1329
- }
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"
1330
1277
  },
1331
1278
  {
1332
- "kind": "method",
1333
- "name": "configureMenu",
1334
- "description": "Binds all behavior needed to the menu after rendering.",
1335
- "privacy": "private",
1336
- "return": {
1337
- "type": {
1338
- "text": "void"
1339
- }
1340
- }
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"
1341
1285
  },
1342
1286
  {
1343
- "kind": "method",
1344
- "name": "configureInput",
1345
- "description": "Binds all behavior needed to the input after rendering.",
1346
- "privacy": "private",
1347
- "return": {
1348
- "type": {
1349
- "text": "void"
1350
- }
1351
- }
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"
1352
1293
  },
1353
1294
  {
1354
- "kind": "method",
1355
- "name": "handleMenuLoadingChange",
1356
- "parameters": [
1357
- {
1358
- "name": "event",
1359
- "description": "The event object containing details about the loading state change.",
1360
- "type": {
1361
- "text": "CustomEvent"
1362
- }
1363
- },
1364
- {
1365
- "description": "Indicates whether the menu is currently loading.",
1366
- "name": "event.detail.loading",
1367
- "type": {
1368
- "text": "boolean"
1369
- }
1370
- },
1371
- {
1372
- "description": "Indicates if there are loading placeholders present.",
1373
- "name": "event.detail.hasLoadingPlaceholder",
1374
- "type": {
1375
- "text": "boolean"
1376
- }
1377
- }
1378
- ],
1379
- "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.",
1380
- "privacy": "private",
1381
- "return": {
1382
- "type": {
1383
- "text": "void"
1384
- }
1385
- }
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"
1386
1302
  },
1387
1303
  {
1388
- "kind": "method",
1389
- "name": "handleInputValueChange",
1390
- "parameters": [
1391
- {
1392
- "name": "event",
1393
- "description": "The input event triggered by the input element.",
1394
- "type": {
1395
- "text": "Event"
1396
- }
1397
- }
1398
- ],
1399
- "description": "Handle changes to the input value and trigger changes that should result.",
1400
- "privacy": "private",
1401
- "return": {
1402
- "type": {
1403
- "text": "void"
1404
- }
1405
- }
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"
1406
1310
  },
1407
1311
  {
1408
- "kind": "method",
1409
- "name": "configureCombobox",
1410
- "description": "Binds all behavior needed to the combobox after rendering.",
1411
- "privacy": "private",
1412
- "return": {
1413
- "type": {
1414
- "text": "void"
1415
- }
1416
- }
1312
+ "name": "disabled",
1313
+ "type": {
1314
+ "text": "boolean"
1315
+ },
1316
+ "description": "If set, disables the combobox.",
1317
+ "fieldName": "disabled"
1417
1318
  },
1418
1319
  {
1419
- "kind": "method",
1420
- "name": "focus",
1421
- "description": "Focuses the combobox trigger input.",
1422
- "return": {
1423
- "type": {
1424
- "text": "void"
1425
- }
1426
- }
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"
1427
1326
  },
1428
1327
  {
1429
- "kind": "method",
1430
- "name": "setMenuValue",
1431
- "parameters": [
1432
- {
1433
- "name": "value",
1434
- "description": "The value to set on the menu.",
1435
- "type": {
1436
- "text": "string"
1437
- }
1438
- }
1439
- ],
1440
- "description": "Sets the menu value if menu is available.",
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": "reset",
1450
- "description": "Resets component to initial state.",
1451
- "return": {
1452
- "type": {
1453
- "text": "void"
1454
- }
1455
- }
1336
+ "name": "format",
1337
+ "type": {
1338
+ "text": "string"
1339
+ },
1340
+ "description": "Specifies the input mask format.",
1341
+ "fieldName": "format"
1456
1342
  },
1457
1343
  {
1458
- "kind": "method",
1459
- "name": "clear",
1460
- "description": "Clears the current value of the combobox.",
1461
- "return": {
1462
- "type": {
1463
- "text": "void"
1464
- }
1344
+ "name": "inputmode",
1345
+ "type": {
1346
+ "text": "string"
1347
+ },
1348
+ "description": "Exposes inputmode attribute for input.",
1349
+ "fieldName": "inputmode"
1350
+ },
1351
+ {
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"
1465
1362
  }
1466
1363
  },
1467
1364
  {
1468
- "kind": "method",
1469
- "name": "validate",
1470
- "parameters": [
1471
- {
1472
- "name": "force",
1473
- "default": "false",
1474
- "description": "Whether to force validation.",
1475
- "optional": true,
1476
- "type": {
1477
- "text": "boolean"
1478
- }
1479
- }
1480
- ],
1481
- "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"
1482
1371
  },
1483
1372
  {
1484
- "kind": "method",
1485
- "name": "transportAssignedNodes",
1486
- "parameters": [
1487
- {
1488
- "name": "slot",
1489
- "description": "The slot element containing the nodes to apply.",
1490
- "type": {
1491
- "text": "HTMLSlotElement"
1492
- }
1493
- },
1494
- {
1495
- "name": "target",
1496
- "description": "The target element to apply the nodes to.",
1497
- "type": {
1498
- "text": "HTMLElement"
1499
- }
1500
- },
1501
- {
1502
- "name": "newSlotName",
1503
- "description": "The new slot name for the applied nodes.",
1504
- "type": {
1505
- "text": "string"
1506
- }
1507
- }
1508
- ],
1509
- "description": "Applies slotted nodes to a target element with a new slot name.",
1510
- "privacy": "private",
1511
- "return": {
1512
- "type": {
1513
- "text": "void"
1514
- }
1515
- }
1373
+ "name": "noFilter",
1374
+ "type": {
1375
+ "text": "boolean"
1376
+ },
1377
+ "description": "If set, combobox will not filter menuoptions based on input.",
1378
+ "fieldName": "noFilter"
1516
1379
  },
1517
1380
  {
1518
- "kind": "method",
1519
- "name": "updateActiveOption",
1520
- "parameters": [
1521
- {
1522
- "name": "index",
1523
- "description": "Index of the option to make active.",
1524
- "type": {
1525
- "text": "number"
1526
- }
1527
- }
1528
- ],
1529
- "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"
1501
+ },
1502
+ {
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"
1530
1509
  },
1531
1510
  {
1532
- "kind": "method",
1533
- "name": "handleSlotChange",
1534
- "parameters": [
1535
- {
1536
- "name": "event",
1537
- "description": "`slotchange` event.",
1538
- "type": {
1539
- "text": "Event"
1540
- }
1541
- }
1542
- ],
1543
- "description": "Watch for slot changes and recalculate the menuoptions.",
1544
- "privacy": "private",
1545
- "return": {
1546
- "type": {
1547
- "text": "void"
1548
- }
1549
- }
1511
+ "name": "typedValue",
1512
+ "type": {
1513
+ "text": "string"
1514
+ },
1515
+ "description": "Specifies the value of the input element within the combobox.",
1516
+ "fieldName": "typedValue"
1550
1517
  },
1551
1518
  {
1552
- "kind": "field",
1553
- "name": "appearance",
1554
- "privacy": "public",
1519
+ "name": "validity",
1555
1520
  "type": {
1556
1521
  "text": "string"
1557
1522
  },
1558
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1559
- "default": "'default'",
1560
- "attribute": "appearance",
1561
- "reflects": true
1523
+ "description": "Specifies the `validityState` this element is in.",
1524
+ "fieldName": "validity"
1562
1525
  },
1563
1526
  {
1564
- "kind": "field",
1565
- "name": "autocomplete",
1566
- "privacy": "public",
1527
+ "name": "value",
1567
1528
  "type": {
1568
1529
  "text": "string"
1569
1530
  },
1570
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1571
- "attribute": "autocomplete",
1572
- "reflects": true
1531
+ "description": "Value selected for the dropdown menu.",
1532
+ "fieldName": "value"
1573
1533
  },
1574
1534
  {
1575
- "kind": "field",
1576
- "name": "autoPlacement",
1577
- "privacy": "public",
1535
+ "name": "largeFullscreenHeadline",
1578
1536
  "type": {
1579
1537
  "text": "boolean"
1580
1538
  },
1581
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1582
- "attribute": "autoPlacement",
1583
- "reflects": true
1539
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1540
+ "fieldName": "largeFullscreenHeadline"
1584
1541
  },
1585
1542
  {
1586
- "kind": "field",
1587
- "name": "availableOptions",
1588
- "privacy": "private",
1543
+ "name": "fullscreenBreakpoint",
1589
1544
  "type": {
1590
- "text": "array"
1545
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1591
1546
  },
1592
- "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).",
1593
- "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"
1594
1550
  },
1595
1551
  {
1596
- "kind": "field",
1597
- "name": "behavior",
1598
- "privacy": "public",
1552
+ "name": "shape",
1599
1553
  "type": {
1600
- "text": "'filter' | 'suggestion'"
1554
+ "text": "string"
1601
1555
  },
1602
- "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.",
1603
- "default": "'suggestion'",
1604
- "attribute": "behavior",
1605
- "reflects": true
1556
+ "fieldName": "shape",
1557
+ "inheritedFrom": {
1558
+ "name": "AuroElement",
1559
+ "module": "components/layoutElement/src/auroElement.js"
1560
+ }
1606
1561
  },
1607
1562
  {
1608
- "kind": "field",
1609
- "name": "checkmark",
1610
- "privacy": "public",
1563
+ "name": "size",
1611
1564
  "type": {
1612
- "text": "boolean"
1565
+ "text": "string"
1613
1566
  },
1614
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1615
- "attribute": "checkmark",
1616
- "reflects": true
1567
+ "fieldName": "size",
1568
+ "inheritedFrom": {
1569
+ "name": "AuroElement",
1570
+ "module": "components/layoutElement/src/auroElement.js"
1571
+ }
1617
1572
  },
1618
1573
  {
1619
- "kind": "field",
1620
- "name": "disabled",
1621
- "privacy": "public",
1574
+ "name": "ondark",
1622
1575
  "type": {
1623
1576
  "text": "boolean"
1624
1577
  },
1625
- "description": "If set, disables the combobox.",
1626
- "attribute": "disabled",
1627
- "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"
1628
1670
  },
1629
1671
  {
1630
- "kind": "field",
1631
- "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.",
1632
1726
  "privacy": "private",
1633
- "type": {
1634
- "text": "string"
1635
- },
1636
- "description": "ID for the dropdown."
1727
+ "return": {
1728
+ "type": {
1729
+ "text": "void"
1730
+ }
1731
+ }
1637
1732
  },
1638
1733
  {
1639
- "kind": "field",
1640
- "name": "dropdownOpen",
1734
+ "kind": "method",
1735
+ "name": "handlePreselectedItems",
1736
+ "description": "Helper method that handles the state of preselected checkboxes.",
1641
1737
  "privacy": "private",
1642
- "type": {
1643
- "text": "boolean"
1644
- },
1645
- "description": "Whether or not the dropdown is open."
1646
- },
1647
- {
1648
- "kind": "field",
1649
- "name": "dvInputOnly",
1650
- "privacy": "public",
1651
- "type": {
1652
- "text": "boolean"
1653
- },
1654
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1655
- "attribute": "dvInputOnly",
1656
- "reflects": true
1738
+ "return": {
1739
+ "type": {
1740
+ "text": "void"
1741
+ }
1742
+ }
1657
1743
  },
1658
1744
  {
1659
- "kind": "field",
1660
- "name": "error",
1661
- "privacy": "public",
1662
- "type": {
1663
- "text": "string"
1664
- },
1665
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1666
- "attribute": "error",
1667
- "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
+ }
1668
1754
  },
1669
1755
  {
1670
- "kind": "field",
1671
- "name": "format",
1672
- "privacy": "public",
1673
- "type": {
1674
- "text": "string"
1675
- },
1676
- "description": "Specifies the input mask format.",
1677
- "attribute": "format",
1678
- "reflects": true
1756
+ "kind": "method",
1757
+ "name": "reset",
1758
+ "description": "Resets component to initial state.",
1759
+ "return": {
1760
+ "type": {
1761
+ "text": "void"
1762
+ }
1763
+ }
1679
1764
  },
1680
1765
  {
1681
- "kind": "field",
1682
- "name": "inputmode",
1683
- "privacy": "public",
1684
- "type": {
1685
- "text": "string"
1686
- },
1687
- "description": "Exposes inputmode attribute for input.",
1688
- "attribute": "inputmode",
1689
- "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."
1690
1780
  },
1691
1781
  {
1692
1782
  "kind": "field",
1693
- "name": "layout",
1783
+ "name": "appearance",
1694
1784
  "privacy": "public",
1695
1785
  "type": {
1696
- "text": "string"
1697
- },
1698
- "description": "Sets the layout of the combobox.",
1699
- "default": "'classic'",
1700
- "attribute": "layout",
1701
- "reflects": true,
1702
- "inheritedFrom": {
1703
- "name": "AuroElement",
1704
- "module": "components/layoutElement/src/auroElement.js"
1705
- }
1706
- },
1707
- {
1708
- "kind": "field",
1709
- "name": "matchWidth",
1710
- "privacy": "private",
1711
- "type": {
1712
- "text": "boolean"
1786
+ "text": "'default' | 'inverse'"
1713
1787
  },
1714
- "description": "If declared, the popover and trigger will be set to the same width.",
1715
- "attribute": "matchWidth",
1788
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1789
+ "default": "'default'",
1790
+ "attribute": "appearance",
1716
1791
  "reflects": true
1717
1792
  },
1718
1793
  {
1719
1794
  "kind": "field",
1720
- "name": "noFilter",
1795
+ "name": "disabled",
1721
1796
  "privacy": "public",
1722
1797
  "type": {
1723
1798
  "text": "boolean"
1724
1799
  },
1725
- "description": "If set, combobox will not filter menuoptions based on input.",
1726
- "attribute": "noFilter",
1800
+ "description": "If set, disables the checkbox group.",
1801
+ "attribute": "disabled",
1727
1802
  "reflects": true
1728
1803
  },
1729
1804
  {
1730
1805
  "kind": "field",
1731
- "name": "noFlip",
1806
+ "name": "error",
1732
1807
  "privacy": "public",
1733
1808
  "type": {
1734
- "text": "boolean"
1809
+ "text": "string"
1735
1810
  },
1736
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1737
- "attribute": "noFlip",
1811
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1812
+ "attribute": "error",
1738
1813
  "reflects": true
1739
1814
  },
1740
1815
  {
1741
1816
  "kind": "field",
1742
- "name": "shift",
1817
+ "name": "horizontal",
1743
1818
  "privacy": "public",
1744
1819
  "type": {
1745
1820
  "text": "boolean"
1746
1821
  },
1747
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1748
- "attribute": "shift",
1822
+ "description": "If set, checkboxes will be aligned horizontally.",
1823
+ "attribute": "horizontal",
1749
1824
  "reflects": true
1750
1825
  },
1751
1826
  {
@@ -1759,18 +1834,6 @@
1759
1834
  "attribute": "noValidate",
1760
1835
  "reflects": true
1761
1836
  },
1762
- {
1763
- "kind": "field",
1764
- "name": "offset",
1765
- "privacy": "public",
1766
- "type": {
1767
- "text": "number"
1768
- },
1769
- "description": "Gap between the trigger element and bib.",
1770
- "default": "0",
1771
- "attribute": "offset",
1772
- "reflects": true
1773
- },
1774
1837
  {
1775
1838
  "kind": "field",
1776
1839
  "name": "onDark",
@@ -1778,56 +1841,8 @@
1778
1841
  "type": {
1779
1842
  "text": "boolean"
1780
1843
  },
1781
- "attribute": "onDark",
1782
- "reflects": true,
1783
1844
  "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1784
- "inheritedFrom": {
1785
- "name": "AuroElement",
1786
- "module": "components/layoutElement/src/auroElement.js"
1787
- }
1788
- },
1789
- {
1790
- "kind": "field",
1791
- "name": "optionSelected",
1792
- "privacy": "public",
1793
- "type": {
1794
- "text": "HTMLElement"
1795
- },
1796
- "description": "Specifies the current selected option.",
1797
- "attribute": "optionSelected"
1798
- },
1799
- {
1800
- "kind": "field",
1801
- "name": "persistInput",
1802
- "privacy": "public",
1803
- "type": {
1804
- "text": "boolean"
1805
- },
1806
- "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.",
1807
- "attribute": "persistInput",
1808
- "reflects": true
1809
- },
1810
- {
1811
- "kind": "field",
1812
- "name": "placement",
1813
- "privacy": "public",
1814
- "type": {
1815
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1816
- },
1817
- "description": "Position where the bib should appear relative to the trigger.",
1818
- "default": "'bottom-start'",
1819
- "attribute": "placement",
1820
- "reflects": true
1821
- },
1822
- {
1823
- "kind": "field",
1824
- "name": "placeholder",
1825
- "privacy": "public",
1826
- "type": {
1827
- "text": "string"
1828
- },
1829
- "description": "Define custom placeholder text, only supported by date input formats.",
1830
- "attribute": "placeholder",
1845
+ "attribute": "onDark",
1831
1846
  "reflects": true
1832
1847
  },
1833
1848
  {
@@ -1837,7 +1852,7 @@
1837
1852
  "type": {
1838
1853
  "text": "boolean"
1839
1854
  },
1840
- "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.",
1841
1856
  "attribute": "required",
1842
1857
  "reflects": true
1843
1858
  },
@@ -1873,611 +1888,615 @@
1873
1888
  },
1874
1889
  {
1875
1890
  "kind": "field",
1876
- "name": "setCustomValidityValueMissingFilter",
1891
+ "name": "validity",
1877
1892
  "privacy": "public",
1878
1893
  "type": {
1879
1894
  "text": "string"
1880
1895
  },
1881
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1882
- "attribute": "setCustomValidityValueMissingFilter"
1883
- },
1884
- {
1885
- "kind": "field",
1886
- "name": "touched",
1887
- "privacy": "private",
1888
- "type": {
1889
- "text": "boolean"
1890
- },
1891
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1892
- },
1893
- {
1894
- "kind": "field",
1895
- "name": "triggerIcon",
1896
- "privacy": "public",
1897
- "type": {
1898
- "text": "boolean"
1899
- },
1900
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1901
- "attribute": "triggerIcon",
1896
+ "description": "Specifies the `validityState` this element is in.",
1897
+ "attribute": "validity",
1902
1898
  "reflects": true
1903
- },
1899
+ }
1900
+ ],
1901
+ "events": [
1904
1902
  {
1905
- "kind": "field",
1906
- "name": "type",
1907
- "privacy": "public",
1903
+ "name": "input",
1908
1904
  "type": {
1909
- "text": "string"
1910
- },
1911
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1912
- "attribute": "type",
1913
- "reflects": true
1905
+ "text": "CustomEvent"
1906
+ }
1914
1907
  },
1915
1908
  {
1916
- "kind": "field",
1917
- "name": "typedValue",
1918
- "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",
1919
1916
  "type": {
1920
- "text": "string"
1917
+ "text": "'default' | 'inverse'"
1921
1918
  },
1922
- "description": "Specifies the value of the input element within the combobox.",
1923
- "attribute": "typedValue",
1924
- "reflects": true
1925
- },
1926
- {
1927
- "kind": "field",
1928
- "name": "validity",
1929
- "privacy": "public",
1919
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1920
+ "default": "'default'",
1921
+ "fieldName": "appearance"
1922
+ },
1923
+ {
1924
+ "name": "disabled",
1930
1925
  "type": {
1931
- "text": "string"
1926
+ "text": "boolean"
1932
1927
  },
1933
- "description": "Specifies the `validityState` this element is in.",
1934
- "attribute": "validity",
1935
- "reflects": true
1928
+ "description": "If set, disables the checkbox group.",
1929
+ "fieldName": "disabled"
1936
1930
  },
1937
1931
  {
1938
- "kind": "field",
1939
- "name": "value",
1940
- "privacy": "public",
1932
+ "name": "error",
1941
1933
  "type": {
1942
1934
  "text": "string"
1943
1935
  },
1944
- "description": "Value selected for the dropdown menu.",
1945
- "attribute": "value"
1936
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1937
+ "fieldName": "error"
1946
1938
  },
1947
1939
  {
1948
- "kind": "field",
1949
- "name": "largeFullscreenHeadline",
1950
- "privacy": "public",
1940
+ "name": "horizontal",
1951
1941
  "type": {
1952
1942
  "text": "boolean"
1953
1943
  },
1954
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1955
- "attribute": "largeFullscreenHeadline",
1956
- "reflects": true
1944
+ "description": "If set, checkboxes will be aligned horizontally.",
1945
+ "fieldName": "horizontal"
1957
1946
  },
1958
1947
  {
1959
- "kind": "field",
1960
- "name": "fullscreenBreakpoint",
1961
- "privacy": "public",
1948
+ "name": "noValidate",
1962
1949
  "type": {
1963
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1950
+ "text": "boolean"
1964
1951
  },
1965
- "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.",
1966
- "default": "'sm'",
1967
- "attribute": "fullscreenBreakpoint",
1968
- "reflects": true
1952
+ "description": "If set, disables auto-validation on blur.",
1953
+ "fieldName": "noValidate"
1969
1954
  },
1970
1955
  {
1971
- "kind": "field",
1972
- "name": "optionActive",
1973
- "privacy": "private",
1956
+ "name": "onDark",
1974
1957
  "type": {
1975
- "text": "object"
1958
+ "text": "boolean"
1976
1959
  },
1977
- "description": "Specifies the currently active option."
1960
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1961
+ "fieldName": "onDark"
1978
1962
  },
1979
1963
  {
1980
- "kind": "field",
1981
- "name": "triggerExpandedState",
1982
- "privacy": "private",
1964
+ "name": "required",
1983
1965
  "type": {
1984
1966
  "text": "boolean"
1985
1967
  },
1986
- "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1968
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1969
+ "fieldName": "required"
1987
1970
  },
1988
1971
  {
1989
- "kind": "field",
1990
- "name": "componentHasFocus",
1991
- "description": "Returns true if the element has focus.",
1992
- "privacy": "private",
1993
- "return": {
1994
- "type": {
1995
- "text": "boolean"
1996
- }
1972
+ "name": "setCustomValidity",
1973
+ "type": {
1974
+ "text": "string"
1997
1975
  },
1998
- "readonly": true,
1999
- "inheritedFrom": {
2000
- "name": "AuroElement",
2001
- "module": "components/layoutElement/src/auroElement.js"
2002
- }
2003
- },
2004
- {
2005
- "kind": "method",
2006
- "name": "resetShapeClasses",
2007
- "inheritedFrom": {
2008
- "name": "AuroElement",
2009
- "module": "components/layoutElement/src/auroElement.js"
2010
- }
2011
- },
2012
- {
2013
- "kind": "method",
2014
- "name": "resetLayoutClasses",
2015
- "inheritedFrom": {
2016
- "name": "AuroElement",
2017
- "module": "components/layoutElement/src/auroElement.js"
2018
- }
1976
+ "description": "Sets a custom help text message to display for all validityStates.",
1977
+ "fieldName": "setCustomValidity"
2019
1978
  },
2020
1979
  {
2021
- "kind": "method",
2022
- "name": "updateComponentArchitecture",
2023
- "inheritedFrom": {
2024
- "name": "AuroElement",
2025
- "module": "components/layoutElement/src/auroElement.js"
2026
- }
1980
+ "name": "setCustomValidityCustomError",
1981
+ "type": {
1982
+ "text": "string"
1983
+ },
1984
+ "description": "Custom help text message to display when validity = `customError`.",
1985
+ "fieldName": "setCustomValidityCustomError"
2027
1986
  },
2028
1987
  {
2029
- "kind": "field",
2030
- "name": "shape",
2031
- "privacy": "public",
1988
+ "name": "setCustomValidityValueMissing",
2032
1989
  "type": {
2033
1990
  "text": "string"
2034
1991
  },
2035
- "attribute": "shape",
2036
- "reflects": true,
2037
- "inheritedFrom": {
2038
- "name": "AuroElement",
2039
- "module": "components/layoutElement/src/auroElement.js"
2040
- }
1992
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1993
+ "fieldName": "setCustomValidityValueMissing"
2041
1994
  },
2042
1995
  {
2043
- "kind": "field",
2044
- "name": "size",
2045
- "privacy": "public",
1996
+ "name": "validity",
2046
1997
  "type": {
2047
1998
  "text": "string"
2048
1999
  },
2049
- "attribute": "size",
2050
- "reflects": true,
2051
- "inheritedFrom": {
2052
- "name": "AuroElement",
2053
- "module": "components/layoutElement/src/auroElement.js"
2054
- }
2000
+ "description": "Specifies the `validityState` this element is in.",
2001
+ "fieldName": "validity"
2055
2002
  }
2056
2003
  ],
2057
- "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": [
2058
2032
  {
2059
- "name": "inputValue",
2060
- "type": {
2061
- "text": "CustomEvent"
2062
- },
2063
- "description": "Notifies that the components internal HTML5 input value has changed."
2033
+ "description": "apply css to a specific checkbox.",
2034
+ "name": "checkbox"
2064
2035
  },
2065
2036
  {
2066
- "name": "input",
2067
- "type": {
2068
- "text": "CustomEvent"
2069
- },
2070
- "description": "Notifies that the component has a new value set."
2037
+ "description": "apply css to a specific checkbox's input.",
2038
+ "name": "checkbox-input"
2071
2039
  },
2072
2040
  {
2073
- "name": "auroCombobox-valueSet",
2074
- "type": {
2075
- "text": "CustomEvent"
2076
- },
2077
- "description": "(Deprecated) Notifies that the component has a new value set."
2078
- },
2041
+ "description": "apply css to a specific checkbox's label.",
2042
+ "name": "checkbox-label"
2043
+ }
2044
+ ],
2045
+ "slots": [
2079
2046
  {
2080
- "description": "Notifies that the component value(s) have been validated.",
2081
- "name": "auroFormElement-validated"
2047
+ "description": "The default slot for the checkbox label.",
2048
+ "name": "default"
2082
2049
  }
2083
2050
  ],
2084
- "attributes": [
2051
+ "members": [
2085
2052
  {
2086
- "name": "appearance",
2087
- "type": {
2088
- "text": "string"
2089
- },
2090
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2091
- "default": "'default'",
2092
- "fieldName": "appearance"
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
+ }
2112
+ },
2113
+ {
2114
+ "kind": "method",
2115
+ "name": "handleFocusin",
2116
+ "description": "Function to support",
2117
+ "privacy": "private",
2118
+ "return": {
2119
+ "type": {
2120
+ "text": "void"
2121
+ }
2122
+ }
2093
2123
  },
2094
2124
  {
2095
- "name": "autocomplete",
2096
- "type": {
2097
- "text": "string"
2098
- },
2099
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2100
- "fieldName": "autocomplete"
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
+ }
2101
2134
  },
2102
2135
  {
2103
- "name": "autoPlacement",
2104
- "type": {
2105
- "text": "boolean"
2106
- },
2107
- "description": "If declared, bib's position will be automatically calculated where to appear.",
2108
- "fieldName": "autoPlacement"
2136
+ "kind": "method",
2137
+ "name": "reset",
2138
+ "description": "Resets component to initial state.",
2139
+ "return": {
2140
+ "type": {
2141
+ "text": "void"
2142
+ }
2143
+ }
2109
2144
  },
2110
2145
  {
2111
- "name": "availableOptions",
2112
- "type": {
2113
- "text": "array"
2114
- },
2115
- "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).",
2116
- "fieldName": "availableOptions"
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
+ }
2117
2155
  },
2118
2156
  {
2119
- "name": "behavior",
2120
- "type": {
2121
- "text": "'filter' | 'suggestion'"
2122
- },
2123
- "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.",
2124
- "default": "'suggestion'",
2125
- "fieldName": "behavior"
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
+ }
2126
2175
  },
2127
2176
  {
2128
- "name": "checkmark",
2177
+ "kind": "field",
2178
+ "name": "appearance",
2179
+ "privacy": "public",
2129
2180
  "type": {
2130
- "text": "boolean"
2181
+ "text": "'default' | 'inverse'"
2131
2182
  },
2132
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
2133
- "fieldName": "checkmark"
2183
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2184
+ "default": "'default'",
2185
+ "attribute": "appearance",
2186
+ "reflects": true
2134
2187
  },
2135
2188
  {
2136
- "name": "disabled",
2189
+ "kind": "field",
2190
+ "name": "checked",
2191
+ "privacy": "public",
2137
2192
  "type": {
2138
2193
  "text": "boolean"
2139
2194
  },
2140
- "description": "If set, disables the combobox.",
2141
- "fieldName": "disabled"
2195
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2196
+ "attribute": "checked",
2197
+ "reflects": true
2142
2198
  },
2143
2199
  {
2144
- "name": "dvInputOnly",
2200
+ "kind": "field",
2201
+ "name": "disabled",
2202
+ "privacy": "public",
2145
2203
  "type": {
2146
2204
  "text": "boolean"
2147
2205
  },
2148
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2149
- "fieldName": "dvInputOnly"
2206
+ "description": "If set to true, the checkbox will not be clickable.",
2207
+ "attribute": "disabled",
2208
+ "reflects": true
2150
2209
  },
2151
2210
  {
2211
+ "kind": "field",
2152
2212
  "name": "error",
2213
+ "privacy": "public",
2153
2214
  "type": {
2154
- "text": "string"
2215
+ "text": "boolean"
2155
2216
  },
2156
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2157
- "fieldName": "error"
2217
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2218
+ "attribute": "error",
2219
+ "reflects": true
2158
2220
  },
2159
2221
  {
2160
- "name": "format",
2222
+ "kind": "field",
2223
+ "name": "id",
2224
+ "privacy": "public",
2161
2225
  "type": {
2162
2226
  "text": "string"
2163
2227
  },
2164
- "description": "Specifies the input mask format.",
2165
- "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
2166
2231
  },
2167
2232
  {
2168
- "name": "inputmode",
2233
+ "kind": "field",
2234
+ "name": "inputId",
2235
+ "privacy": "private",
2169
2236
  "type": {
2170
2237
  "text": "string"
2171
2238
  },
2172
- "description": "Exposes inputmode attribute for input.",
2173
- "fieldName": "inputmode"
2239
+ "description": "The id for input node."
2174
2240
  },
2175
2241
  {
2176
- "name": "layout",
2242
+ "kind": "field",
2243
+ "name": "name",
2244
+ "privacy": "public",
2177
2245
  "type": {
2178
2246
  "text": "string"
2179
2247
  },
2180
- "description": "Sets the layout of the combobox.",
2181
- "default": "'classic'",
2182
- "fieldName": "layout",
2183
- "inheritedFrom": {
2184
- "name": "AuroElement",
2185
- "module": "components/layoutElement/src/auroElement.js"
2186
- }
2187
- },
2188
- {
2189
- "name": "matchWidth",
2190
- "type": {
2191
- "text": "boolean"
2192
- },
2193
- "description": "If declared, the popover and trigger will be set to the same width.",
2194
- "fieldName": "matchWidth"
2195
- },
2196
- {
2197
- "name": "noFilter",
2198
- "type": {
2199
- "text": "boolean"
2200
- },
2201
- "description": "If set, combobox will not filter menuoptions based on input.",
2202
- "fieldName": "noFilter"
2248
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2249
+ "attribute": "name"
2203
2250
  },
2204
2251
  {
2205
- "name": "noFlip",
2252
+ "kind": "field",
2253
+ "name": "onDark",
2254
+ "privacy": "public",
2206
2255
  "type": {
2207
2256
  "text": "boolean"
2208
2257
  },
2209
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2210
- "fieldName": "noFlip"
2258
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2259
+ "attribute": "onDark",
2260
+ "reflects": true
2211
2261
  },
2212
2262
  {
2213
- "name": "shift",
2263
+ "kind": "field",
2264
+ "name": "touched",
2265
+ "privacy": "private",
2214
2266
  "type": {
2215
2267
  "text": "boolean"
2216
2268
  },
2217
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2218
- "fieldName": "shift"
2269
+ "description": "Indicates whether the checkbox has been interacted with."
2219
2270
  },
2220
2271
  {
2221
- "name": "noValidate",
2272
+ "kind": "field",
2273
+ "name": "value",
2274
+ "privacy": "public",
2222
2275
  "type": {
2223
- "text": "boolean"
2276
+ "text": "string"
2224
2277
  },
2225
- "description": "If set, disables auto-validation on blur.",
2226
- "fieldName": "noValidate"
2278
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2279
+ "attribute": "value"
2227
2280
  },
2228
2281
  {
2229
- "name": "offset",
2282
+ "kind": "field",
2283
+ "name": "tabIndex",
2284
+ "privacy": "private",
2230
2285
  "type": {
2231
2286
  "text": "number"
2232
2287
  },
2233
- "description": "Gap between the trigger element and bib.",
2234
- "default": "0",
2235
- "fieldName": "offset"
2236
- },
2237
- {
2238
- "name": "onDark",
2239
- "type": {
2240
- "text": "boolean"
2241
- },
2242
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2243
- "fieldName": "onDark"
2288
+ "description": "The tabindex attribute for the checkbox.",
2289
+ "attribute": "tabindex",
2290
+ "reflects": true
2244
2291
  },
2245
2292
  {
2246
- "name": "optionSelected",
2293
+ "kind": "field",
2294
+ "name": "ariaChecked",
2295
+ "privacy": "private",
2247
2296
  "type": {
2248
- "text": "HTMLElement"
2297
+ "text": "string"
2249
2298
  },
2250
- "description": "Specifies the current selected option.",
2251
- "fieldName": "optionSelected"
2299
+ "description": "The aria-checked attribute for the checkbox.",
2300
+ "attribute": "aria-checked",
2301
+ "reflects": true
2252
2302
  },
2253
2303
  {
2254
- "name": "persistInput",
2304
+ "kind": "field",
2305
+ "name": "ariaDisabled",
2306
+ "privacy": "private",
2255
2307
  "type": {
2256
- "text": "boolean"
2308
+ "text": "string"
2257
2309
  },
2258
- "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.",
2259
- "fieldName": "persistInput"
2310
+ "description": "The aria-disabled attribute for the checkbox.",
2311
+ "attribute": "aria-disabled",
2312
+ "reflects": true
2260
2313
  },
2261
2314
  {
2262
- "name": "placement",
2315
+ "kind": "field",
2316
+ "name": "role",
2317
+ "privacy": "private",
2263
2318
  "type": {
2264
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2319
+ "text": "string"
2265
2320
  },
2266
- "description": "Position where the bib should appear relative to the trigger.",
2267
- "default": "'bottom-start'",
2268
- "fieldName": "placement"
2269
- },
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": [
2270
2327
  {
2271
- "name": "placeholder",
2328
+ "name": "auroCheckbox-input",
2272
2329
  "type": {
2273
- "text": "string"
2274
- },
2275
- "description": "Define custom placeholder text, only supported by date input formats.",
2276
- "fieldName": "placeholder"
2330
+ "text": "CustomEvent"
2331
+ }
2277
2332
  },
2278
2333
  {
2279
- "name": "required",
2334
+ "name": "auroCheckbox-focusin",
2280
2335
  "type": {
2281
- "text": "boolean"
2282
- },
2283
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2284
- "fieldName": "required"
2336
+ "text": "CustomEvent"
2337
+ }
2285
2338
  },
2286
2339
  {
2287
- "name": "setCustomValidity",
2340
+ "name": "auroCheckbox-focusout",
2288
2341
  "type": {
2289
- "text": "string"
2290
- },
2291
- "description": "Sets a custom help text message to display for all validityStates.",
2292
- "fieldName": "setCustomValidity"
2342
+ "text": "CustomEvent"
2343
+ }
2293
2344
  },
2294
2345
  {
2295
- "name": "setCustomValidityCustomError",
2346
+ "description": "(Deprecated) Notifies when checked value is changed.",
2347
+ "name": "change"
2348
+ },
2349
+ {
2350
+ "description": "Notifies when when checked value is changed by user's interface.",
2351
+ "name": "input"
2352
+ }
2353
+ ],
2354
+ "attributes": [
2355
+ {
2356
+ "name": "appearance",
2296
2357
  "type": {
2297
- "text": "string"
2358
+ "text": "'default' | 'inverse'"
2298
2359
  },
2299
- "description": "Custom help text message to display when validity = `customError`.",
2300
- "fieldName": "setCustomValidityCustomError"
2360
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2361
+ "default": "'default'",
2362
+ "fieldName": "appearance"
2301
2363
  },
2302
2364
  {
2303
- "name": "setCustomValidityValueMissing",
2365
+ "name": "checked",
2304
2366
  "type": {
2305
- "text": "string"
2367
+ "text": "boolean"
2306
2368
  },
2307
- "description": "Custom help text message to display when validity = `valueMissing`.",
2308
- "fieldName": "setCustomValidityValueMissing"
2369
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2370
+ "fieldName": "checked"
2309
2371
  },
2310
2372
  {
2311
- "name": "setCustomValidityValueMissingFilter",
2373
+ "name": "disabled",
2312
2374
  "type": {
2313
- "text": "string"
2375
+ "text": "boolean"
2314
2376
  },
2315
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2316
- "fieldName": "setCustomValidityValueMissingFilter"
2377
+ "description": "If set to true, the checkbox will not be clickable.",
2378
+ "fieldName": "disabled"
2317
2379
  },
2318
2380
  {
2319
- "name": "triggerIcon",
2381
+ "name": "error",
2320
2382
  "type": {
2321
2383
  "text": "boolean"
2322
2384
  },
2323
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2324
- "fieldName": "triggerIcon"
2385
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2386
+ "fieldName": "error"
2325
2387
  },
2326
2388
  {
2327
- "name": "type",
2389
+ "name": "id",
2328
2390
  "type": {
2329
2391
  "text": "string"
2330
2392
  },
2331
- "description": "Applies the defined value as the type attribute on `auro-input`.",
2332
- "fieldName": "type"
2393
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2394
+ "fieldName": "id"
2333
2395
  },
2334
2396
  {
2335
- "name": "typedValue",
2397
+ "name": "name",
2336
2398
  "type": {
2337
2399
  "text": "string"
2338
2400
  },
2339
- "description": "Specifies the value of the input element within the combobox.",
2340
- "fieldName": "typedValue"
2401
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2402
+ "fieldName": "name"
2341
2403
  },
2342
2404
  {
2343
- "name": "validity",
2405
+ "name": "onDark",
2344
2406
  "type": {
2345
- "text": "string"
2407
+ "text": "boolean"
2346
2408
  },
2347
- "description": "Specifies the `validityState` this element is in.",
2348
- "fieldName": "validity"
2409
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2410
+ "fieldName": "onDark"
2349
2411
  },
2350
2412
  {
2351
2413
  "name": "value",
2352
2414
  "type": {
2353
2415
  "text": "string"
2354
2416
  },
2355
- "description": "Value selected for the dropdown menu.",
2417
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2356
2418
  "fieldName": "value"
2357
2419
  },
2358
2420
  {
2359
- "name": "largeFullscreenHeadline",
2360
- "type": {
2361
- "text": "boolean"
2362
- },
2363
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2364
- "fieldName": "largeFullscreenHeadline"
2365
- },
2366
- {
2367
- "name": "fullscreenBreakpoint",
2421
+ "name": "tabindex",
2368
2422
  "type": {
2369
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2423
+ "text": "number"
2370
2424
  },
2371
- "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.",
2372
- "default": "'sm'",
2373
- "fieldName": "fullscreenBreakpoint"
2425
+ "description": "The tabindex attribute for the checkbox.",
2426
+ "fieldName": "tabIndex"
2374
2427
  },
2375
2428
  {
2376
- "name": "shape",
2429
+ "name": "aria-checked",
2377
2430
  "type": {
2378
2431
  "text": "string"
2379
2432
  },
2380
- "fieldName": "shape",
2381
- "inheritedFrom": {
2382
- "name": "AuroElement",
2383
- "module": "components/layoutElement/src/auroElement.js"
2384
- }
2433
+ "description": "The aria-checked attribute for the checkbox.",
2434
+ "fieldName": "ariaChecked"
2385
2435
  },
2386
2436
  {
2387
- "name": "size",
2437
+ "name": "aria-disabled",
2388
2438
  "type": {
2389
2439
  "text": "string"
2390
2440
  },
2391
- "fieldName": "size",
2392
- "inheritedFrom": {
2393
- "name": "AuroElement",
2394
- "module": "components/layoutElement/src/auroElement.js"
2395
- }
2441
+ "description": "The aria-disabled attribute for the checkbox.",
2442
+ "fieldName": "ariaDisabled"
2396
2443
  },
2397
2444
  {
2398
- "name": "ondark",
2445
+ "name": "role",
2399
2446
  "type": {
2400
- "text": "boolean"
2447
+ "text": "string"
2401
2448
  },
2402
- "fieldName": "onDark",
2403
- "inheritedFrom": {
2404
- "name": "AuroElement",
2405
- "module": "components/layoutElement/src/auroElement.js"
2406
- }
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"
2407
2451
  }
2408
2452
  ],
2409
2453
  "superclass": {
2410
- "name": "AuroElement",
2411
- "module": "/components/layoutElement/src/auroElement.js"
2454
+ "name": "LitElement",
2455
+ "package": "lit"
2412
2456
  },
2413
- "tagName": "auro-combobox",
2457
+ "tagName": "auro-checkbox",
2414
2458
  "customElement": true
2415
2459
  }
2416
2460
  ],
2417
2461
  "exports": [
2418
2462
  {
2419
2463
  "kind": "js",
2420
- "name": "AuroCombobox",
2464
+ "name": "AuroCheckbox",
2421
2465
  "declaration": {
2422
- "name": "AuroCombobox",
2423
- "module": "components/combobox/src/auro-combobox.js"
2466
+ "name": "AuroCheckbox",
2467
+ "module": "components/checkbox/src/auro-checkbox.js"
2424
2468
  }
2425
2469
  }
2426
2470
  ]
2427
2471
  },
2428
2472
  {
2429
2473
  "kind": "javascript-module",
2430
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2431
- "declarations": [
2432
- {
2433
- "kind": "variable",
2434
- "name": "comboboxKeyboardStrategy",
2435
- "type": {
2436
- "text": "object"
2437
- },
2438
- "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(); } } }, }"
2439
- }
2440
- ],
2474
+ "path": "components/checkbox/src/index.js",
2475
+ "declarations": [],
2441
2476
  "exports": [
2442
2477
  {
2443
2478
  "kind": "js",
2444
- "name": "comboboxKeyboardStrategy",
2479
+ "name": "AuroCheckbox",
2445
2480
  "declaration": {
2446
- "name": "comboboxKeyboardStrategy",
2447
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2481
+ "name": "AuroCheckbox",
2482
+ "module": "components/checkbox/src/index.js"
2448
2483
  }
2449
- }
2450
- ]
2451
- },
2452
- {
2453
- "kind": "javascript-module",
2454
- "path": "components/combobox/src/index.js",
2455
- "declarations": [],
2456
- "exports": [
2484
+ },
2457
2485
  {
2458
2486
  "kind": "js",
2459
- "name": "AuroCombobox",
2487
+ "name": "AuroCheckboxGroup",
2460
2488
  "declaration": {
2461
- "name": "AuroCombobox",
2462
- "module": "components/combobox/src/index.js"
2489
+ "name": "AuroCheckboxGroup",
2490
+ "module": "components/checkbox/src/index.js"
2463
2491
  }
2464
2492
  }
2465
2493
  ]
2466
2494
  },
2467
2495
  {
2468
2496
  "kind": "javascript-module",
2469
- "path": "components/combobox/src/registered.js",
2497
+ "path": "components/checkbox/src/registered.js",
2470
2498
  "declarations": [],
2471
- "exports": [
2472
- {
2473
- "kind": "js",
2474
- "name": "AuroCombobox",
2475
- "declaration": {
2476
- "name": "AuroCombobox",
2477
- "module": "components/combobox/src/registered.js"
2478
- }
2479
- }
2480
- ]
2499
+ "exports": []
2481
2500
  },
2482
2501
  {
2483
2502
  "kind": "javascript-module",
@@ -4213,6 +4232,26 @@
4213
4232
  }
4214
4233
  }
4215
4234
  },
4235
+ {
4236
+ "kind": "method",
4237
+ "name": "handleKeyDown",
4238
+ "parameters": [
4239
+ {
4240
+ "name": "event",
4241
+ "description": "The keyboard event.",
4242
+ "type": {
4243
+ "text": "KeyboardEvent"
4244
+ }
4245
+ }
4246
+ ],
4247
+ "description": "Handles Enter/Space key on the cell button.",
4248
+ "privacy": "private",
4249
+ "return": {
4250
+ "type": {
4251
+ "text": "void"
4252
+ }
4253
+ }
4254
+ },
4216
4255
  {
4217
4256
  "kind": "method",
4218
4257
  "name": "handleHover",
@@ -4224,6 +4263,51 @@
4224
4263
  }
4225
4264
  }
4226
4265
  },
4266
+ {
4267
+ "kind": "method",
4268
+ "name": "isOutOfRange",
4269
+ "parameters": [
4270
+ {
4271
+ "name": "day",
4272
+ "description": "An object containing the dateFrom and day of month values.",
4273
+ "type": {
4274
+ "text": "Object"
4275
+ }
4276
+ },
4277
+ {
4278
+ "name": "min",
4279
+ "description": "The minimum date value.",
4280
+ "type": {
4281
+ "text": "Number"
4282
+ }
4283
+ },
4284
+ {
4285
+ "name": "max",
4286
+ "description": "The maximum date value.",
4287
+ "type": {
4288
+ "text": "Number"
4289
+ }
4290
+ }
4291
+ ],
4292
+ "description": "Checks if the current date is outside the valid min/max range.\nOut-of-range cells are not focusable and are hidden from screen readers.",
4293
+ "privacy": "private",
4294
+ "return": {
4295
+ "type": {
4296
+ "text": "Boolean"
4297
+ }
4298
+ }
4299
+ },
4300
+ {
4301
+ "kind": "method",
4302
+ "name": "isBlackout",
4303
+ "description": "Checks if the current date is a blackout date (in disabledDays but within range).\nBlackout cells are focusable but not selectable.",
4304
+ "privacy": "private",
4305
+ "return": {
4306
+ "type": {
4307
+ "text": "Boolean"
4308
+ }
4309
+ }
4310
+ },
4227
4311
  {
4228
4312
  "kind": "method",
4229
4313
  "name": "isEnabled",
@@ -4256,12 +4340,45 @@
4256
4340
  "text": "Array"
4257
4341
  }
4258
4342
  }
4259
- ],
4260
- "description": "Checks if the current date is a valid date depending on the min and max values.",
4343
+ ],
4344
+ "description": "Checks if the current date is a valid date depending on the min and max values.\nSets the disabled attribute for both out-of-range and blackout dates.",
4345
+ "privacy": "private",
4346
+ "return": {
4347
+ "type": {
4348
+ "text": "Boolean"
4349
+ }
4350
+ }
4351
+ },
4352
+ {
4353
+ "kind": "method",
4354
+ "name": "getCellId",
4355
+ "description": "Generates a unique cell ID in the format cell-YYYY-MM-DD.",
4356
+ "privacy": "private",
4357
+ "return": {
4358
+ "type": {
4359
+ "text": "String"
4360
+ }
4361
+ }
4362
+ },
4363
+ {
4364
+ "kind": "method",
4365
+ "name": "getAriaLabel",
4366
+ "description": "Generates a localized aria-label for the cell button using Intl.DateTimeFormat.\nIncludes range position and blackout status.",
4367
+ "privacy": "private",
4368
+ "return": {
4369
+ "type": {
4370
+ "text": "String"
4371
+ }
4372
+ }
4373
+ },
4374
+ {
4375
+ "kind": "method",
4376
+ "name": "getRangePosition",
4377
+ "description": "Determines the range position of this cell relative to the current selection.",
4261
4378
  "privacy": "private",
4262
4379
  "return": {
4263
4380
  "type": {
4264
- "text": "Boolean"
4381
+ "text": "String|null"
4265
4382
  }
4266
4383
  }
4267
4384
  },
@@ -4462,6 +4579,20 @@
4462
4579
  }
4463
4580
  }
4464
4581
  },
4582
+ {
4583
+ "kind": "method",
4584
+ "name": "focusButton",
4585
+ "description": "Programmatically focuses the cell's interactive button element.",
4586
+ "return": {
4587
+ "type": {
4588
+ "text": "void"
4589
+ }
4590
+ }
4591
+ },
4592
+ {
4593
+ "kind": "method",
4594
+ "name": "renderCellButton"
4595
+ },
4465
4596
  {
4466
4597
  "kind": "field",
4467
4598
  "name": "day",
@@ -4611,6 +4742,27 @@
4611
4742
  "default": "false",
4612
4743
  "attribute": "renderForDateSlot"
4613
4744
  },
4745
+ {
4746
+ "kind": "field",
4747
+ "name": "active",
4748
+ "privacy": "public",
4749
+ "type": {
4750
+ "text": "boolean"
4751
+ },
4752
+ "default": "false",
4753
+ "attribute": "active",
4754
+ "reflects": true
4755
+ },
4756
+ {
4757
+ "kind": "field",
4758
+ "name": "hasPopoverContent",
4759
+ "privacy": "public",
4760
+ "type": {
4761
+ "text": "boolean"
4762
+ },
4763
+ "default": "false",
4764
+ "attribute": "hasPopoverContent"
4765
+ },
4614
4766
  {
4615
4767
  "kind": "field",
4616
4768
  "name": "runtimeUtils",
@@ -4622,6 +4774,12 @@
4622
4774
  }
4623
4775
  ],
4624
4776
  "events": [
4777
+ {
4778
+ "name": "calendar-cell-activate",
4779
+ "type": {
4780
+ "text": "CustomEvent"
4781
+ }
4782
+ },
4625
4783
  {
4626
4784
  "name": "date-is-hovered",
4627
4785
  "type": {
@@ -4748,6 +4906,22 @@
4748
4906
  },
4749
4907
  "default": "false",
4750
4908
  "fieldName": "renderForDateSlot"
4909
+ },
4910
+ {
4911
+ "name": "active",
4912
+ "type": {
4913
+ "text": "boolean"
4914
+ },
4915
+ "default": "false",
4916
+ "fieldName": "active"
4917
+ },
4918
+ {
4919
+ "name": "hasPopoverContent",
4920
+ "type": {
4921
+ "text": "boolean"
4922
+ },
4923
+ "default": "false",
4924
+ "fieldName": "hasPopoverContent"
4751
4925
  }
4752
4926
  ],
4753
4927
  "superclass": {
@@ -4806,10 +4980,78 @@
4806
4980
  }
4807
4981
  }
4808
4982
  },
4983
+ {
4984
+ "kind": "method",
4985
+ "name": "getHeadingId",
4986
+ "description": "Returns the unique heading ID for this month, used by aria-labelledby.",
4987
+ "privacy": "private",
4988
+ "return": {
4989
+ "type": {
4990
+ "text": "String"
4991
+ }
4992
+ }
4993
+ },
4809
4994
  {
4810
4995
  "kind": "method",
4811
4996
  "name": "localeChanged",
4812
- "description": "Determines the current month name based on locale.\nThis is a rewrite of the function used in the class RangeDatepickerCalendar and should not be removed from here.",
4997
+ "description": "Determines the current month name based on locale.\nAlso builds parallel arrays of full day names for abbr attributes.\nThis is a rewrite of the function used in the class RangeDatepickerCalendar and should not be removed from here.",
4998
+ "privacy": "private",
4999
+ "return": {
5000
+ "type": {
5001
+ "text": "void"
5002
+ }
5003
+ }
5004
+ },
5005
+ {
5006
+ "kind": "method",
5007
+ "name": "renderDayOfWeek",
5008
+ "parameters": [
5009
+ {
5010
+ "name": "dayOfWeek",
5011
+ "description": "The short day name.",
5012
+ "type": {
5013
+ "text": "String"
5014
+ }
5015
+ },
5016
+ {
5017
+ "name": "index",
5018
+ "description": "The index in the dayNamesOfTheWeek array.",
5019
+ "type": {
5020
+ "text": "Number"
5021
+ }
5022
+ }
5023
+ ],
5024
+ "description": "Renders a day-of-week header with abbr attribute for the full day name.",
5025
+ "privacy": "private",
5026
+ "return": {
5027
+ "type": {
5028
+ "text": "Object"
5029
+ }
5030
+ }
5031
+ },
5032
+ {
5033
+ "kind": "method",
5034
+ "name": "getFocusableCells",
5035
+ "description": "Returns all focusable cell elements (enabled + blackout, not out-of-range) in this month.",
5036
+ "return": {
5037
+ "type": {
5038
+ "text": "Array"
5039
+ }
5040
+ }
5041
+ },
5042
+ {
5043
+ "kind": "method",
5044
+ "name": "handleGridKeyDown",
5045
+ "parameters": [
5046
+ {
5047
+ "name": "event",
5048
+ "description": "The keyboard event.",
5049
+ "type": {
5050
+ "text": "KeyboardEvent"
5051
+ }
5052
+ }
5053
+ ],
5054
+ "description": "Handles arrow key navigation within the month grid.\nDispatches a cross-month navigation event when the boundary is reached.",
4813
5055
  "privacy": "private",
4814
5056
  "return": {
4815
5057
  "type": {
@@ -4817,6 +5059,15 @@
4817
5059
  }
4818
5060
  }
4819
5061
  },
5062
+ {
5063
+ "kind": "method",
5064
+ "name": "renderWeek",
5065
+ "parameters": [
5066
+ {
5067
+ "name": "week"
5068
+ }
5069
+ ]
5070
+ },
4820
5071
  {
4821
5072
  "kind": "method",
4822
5073
  "name": "renderDay",
@@ -4837,6 +5088,20 @@
4837
5088
  "reflects": true
4838
5089
  }
4839
5090
  ],
5091
+ "events": [
5092
+ {
5093
+ "name": "calendar-month-boundary",
5094
+ "type": {
5095
+ "text": "CustomEvent"
5096
+ }
5097
+ },
5098
+ {
5099
+ "name": "calendar-cell-activate",
5100
+ "type": {
5101
+ "text": "CustomEvent"
5102
+ }
5103
+ }
5104
+ ],
4840
5105
  "attributes": [
4841
5106
  {
4842
5107
  "name": "monthFirst",
@@ -4895,8 +5160,161 @@
4895
5160
  },
4896
5161
  {
4897
5162
  "kind": "method",
4898
- "name": "handleNextMonth",
4899
- "description": "Updates the month and year when the user navigates to the next calendar month.",
5163
+ "name": "handleNextMonth",
5164
+ "description": "Updates the month and year when the user navigates to the next calendar month.",
5165
+ "privacy": "private",
5166
+ "return": {
5167
+ "type": {
5168
+ "text": "void"
5169
+ }
5170
+ }
5171
+ },
5172
+ {
5173
+ "kind": "method",
5174
+ "name": "announceMonthChange",
5175
+ "description": "Announces the current month and year via the live region after navigation.",
5176
+ "privacy": "private",
5177
+ "return": {
5178
+ "type": {
5179
+ "text": "void"
5180
+ }
5181
+ }
5182
+ },
5183
+ {
5184
+ "kind": "method",
5185
+ "name": "renderAllCalendars",
5186
+ "description": "Renders all of the auro-calendar-months HTML.",
5187
+ "privacy": "private",
5188
+ "return": {
5189
+ "type": {
5190
+ "text": "Object"
5191
+ }
5192
+ }
5193
+ },
5194
+ {
5195
+ "kind": "method",
5196
+ "name": "focusCloseButton",
5197
+ "description": "Focuses the close button inside the calendar's bibtemplate.\nUsed by datepicker to set initial focus when the fullscreen dialog opens.",
5198
+ "return": {
5199
+ "type": {
5200
+ "text": "void"
5201
+ }
5202
+ }
5203
+ },
5204
+ {
5205
+ "kind": "method",
5206
+ "name": "scrollMonthIntoView",
5207
+ "parameters": [
5208
+ {
5209
+ "name": "date",
5210
+ "description": "The date to scroll into view.",
5211
+ "type": {
5212
+ "text": "String"
5213
+ }
5214
+ }
5215
+ ],
5216
+ "description": "Request the calendar be scrolled to a given date.",
5217
+ "return": {
5218
+ "type": {
5219
+ "text": "void"
5220
+ }
5221
+ }
5222
+ },
5223
+ {
5224
+ "kind": "method",
5225
+ "name": "getMonthComponents",
5226
+ "description": "Gets all rendered month components.",
5227
+ "privacy": "private",
5228
+ "return": {
5229
+ "type": {
5230
+ "text": "Array"
5231
+ }
5232
+ }
5233
+ },
5234
+ {
5235
+ "kind": "method",
5236
+ "name": "getAllFocusableCells",
5237
+ "description": "Gets all focusable cells across all rendered months.",
5238
+ "privacy": "private",
5239
+ "return": {
5240
+ "type": {
5241
+ "text": "Array"
5242
+ }
5243
+ }
5244
+ },
5245
+ {
5246
+ "kind": "method",
5247
+ "name": "setActiveCell",
5248
+ "parameters": [
5249
+ {
5250
+ "name": "date",
5251
+ "description": "Unix timestamp of the cell to activate.",
5252
+ "type": {
5253
+ "text": "Number"
5254
+ }
5255
+ }
5256
+ ],
5257
+ "description": "Sets the active cell across all months. Only one cell has tabindex=\"0\" at a time.",
5258
+ "return": {
5259
+ "type": {
5260
+ "text": "void"
5261
+ }
5262
+ }
5263
+ },
5264
+ {
5265
+ "kind": "method",
5266
+ "name": "focusActiveCell",
5267
+ "description": "Focuses the currently active cell. If activeCellDate is set but no cell\nhas the active attribute yet, sets it first. Waits for the cell's render\nto complete so the focused button is the final DOM element.",
5268
+ "return": {
5269
+ "type": {
5270
+ "text": "void"
5271
+ }
5272
+ }
5273
+ },
5274
+ {
5275
+ "kind": "method",
5276
+ "name": "computeActiveDate",
5277
+ "description": "Computes the initial active date from data properties alone — no DOM required.\nPriority:\n 1. Selected date (dateFrom) if within range\n 2. Today's date if not disabled (in-range and not blackout)\n 3. First future non-disabled date (scans day-by-day from today up to 1 year)\n 4. First previous non-disabled date (scans day-by-day from today up to 1 year)\n 5. undefined — no valid target",
5278
+ "privacy": "private",
5279
+ "return": {
5280
+ "type": {
5281
+ "text": "Number|undefined"
5282
+ }
5283
+ }
5284
+ },
5285
+ {
5286
+ "kind": "method",
5287
+ "name": "handleMonthBoundary",
5288
+ "parameters": [
5289
+ {
5290
+ "name": "event",
5291
+ "description": "The boundary event with direction and source date info.",
5292
+ "type": {
5293
+ "text": "CustomEvent"
5294
+ }
5295
+ }
5296
+ ],
5297
+ "description": "Handles cross-month boundary navigation events from month components.",
5298
+ "privacy": "private",
5299
+ "return": {
5300
+ "type": {
5301
+ "text": "void"
5302
+ }
5303
+ }
5304
+ },
5305
+ {
5306
+ "kind": "method",
5307
+ "name": "handleCellActivate",
5308
+ "parameters": [
5309
+ {
5310
+ "name": "event",
5311
+ "description": "The activation event with target date.",
5312
+ "type": {
5313
+ "text": "CustomEvent"
5314
+ }
5315
+ }
5316
+ ],
5317
+ "description": "Handles cell activation events from month components.",
4900
5318
  "privacy": "private",
4901
5319
  "return": {
4902
5320
  "type": {
@@ -4906,19 +5324,29 @@
4906
5324
  },
4907
5325
  {
4908
5326
  "kind": "method",
4909
- "name": "renderAllCalendars",
4910
- "description": "Renders all of the auro-calendar-months HTML.",
5327
+ "name": "scrollToActiveCell",
5328
+ "description": "Scrolls the calendar to ensure the month containing the active cell is visible.",
4911
5329
  "privacy": "private",
4912
5330
  "return": {
4913
5331
  "type": {
4914
- "text": "Object"
5332
+ "text": "void"
4915
5333
  }
4916
5334
  }
4917
5335
  },
4918
5336
  {
4919
5337
  "kind": "method",
4920
- "name": "focusCloseButton",
4921
- "description": "Focuses the close button inside the calendar's bibtemplate.\nUsed by datepicker to set initial focus when the fullscreen dialog opens.",
5338
+ "name": "announceSelection",
5339
+ "parameters": [
5340
+ {
5341
+ "name": "dateStr",
5342
+ "description": "The localized date string to announce.",
5343
+ "type": {
5344
+ "text": "String"
5345
+ }
5346
+ }
5347
+ ],
5348
+ "description": "Announces a date selection via the live region.",
5349
+ "privacy": "private",
4922
5350
  "return": {
4923
5351
  "type": {
4924
5352
  "text": "void"
@@ -4927,20 +5355,21 @@
4927
5355
  },
4928
5356
  {
4929
5357
  "kind": "method",
4930
- "name": "scrollMonthIntoView",
5358
+ "name": "formatAnnouncementDate",
4931
5359
  "parameters": [
4932
5360
  {
4933
- "name": "date",
4934
- "description": "The date to scroll into view.",
5361
+ "name": "timestamp",
5362
+ "description": "Unix timestamp in seconds.",
4935
5363
  "type": {
4936
- "text": "String"
5364
+ "text": "String|Number"
4937
5365
  }
4938
5366
  }
4939
5367
  ],
4940
- "description": "Request the calendar be scrolled to a given date.",
5368
+ "description": "Formats a Unix timestamp (seconds) as a localized date string for SR announcements.",
5369
+ "privacy": "private",
4941
5370
  "return": {
4942
5371
  "type": {
4943
- "text": "void"
5372
+ "text": "String"
4944
5373
  }
4945
5374
  }
4946
5375
  },
@@ -5047,6 +5476,16 @@
5047
5476
  "attribute": "isFullscreen",
5048
5477
  "reflects": true
5049
5478
  },
5479
+ {
5480
+ "kind": "field",
5481
+ "name": "activeCellDate",
5482
+ "type": {
5483
+ "text": "null"
5484
+ },
5485
+ "description": "The date of the currently active cell (Unix timestamp).\nOnly one cell across the entire calendar has tabindex=\"0\" at a time.",
5486
+ "privacy": "private",
5487
+ "default": "null"
5488
+ },
5050
5489
  {
5051
5490
  "kind": "field",
5052
5491
  "name": "firstMonthRenderable",
@@ -5671,6 +6110,17 @@
5671
6110
  }
5672
6111
  }
5673
6112
  },
6113
+ {
6114
+ "kind": "method",
6115
+ "name": "focusActiveCellWhenReady",
6116
+ "description": "Attempts to focus the active calendar cell using a rAF retry loop.\nShared by both fullscreen and desktop open paths.",
6117
+ "privacy": "private",
6118
+ "return": {
6119
+ "type": {
6120
+ "text": "void"
6121
+ }
6122
+ }
6123
+ },
5674
6124
  {
5675
6125
  "kind": "method",
5676
6126
  "name": "configureDropdown",
@@ -6151,6 +6601,114 @@
6151
6601
  "attribute": "range",
6152
6602
  "reflects": true
6153
6603
  },
6604
+ {
6605
+ "kind": "field",
6606
+ "name": "rangeLabelStart",
6607
+ "privacy": "public",
6608
+ "type": {
6609
+ "text": "string"
6610
+ },
6611
+ "description": "Label announced for the range start date cell.",
6612
+ "default": "'range start'",
6613
+ "attribute": "rangeLabelStart",
6614
+ "reflects": true
6615
+ },
6616
+ {
6617
+ "kind": "field",
6618
+ "name": "rangeLabelEnd",
6619
+ "privacy": "public",
6620
+ "type": {
6621
+ "text": "string"
6622
+ },
6623
+ "description": "Label announced for the range end date cell.",
6624
+ "default": "'range end'",
6625
+ "attribute": "rangeLabelEnd",
6626
+ "reflects": true
6627
+ },
6628
+ {
6629
+ "kind": "field",
6630
+ "name": "rangeLabelBeforeRange",
6631
+ "privacy": "public",
6632
+ "type": {
6633
+ "text": "string"
6634
+ },
6635
+ "description": "Label announced for cells before the range start.",
6636
+ "default": "'before range'",
6637
+ "attribute": "rangeLabelBeforeRange",
6638
+ "reflects": true
6639
+ },
6640
+ {
6641
+ "kind": "field",
6642
+ "name": "rangeLabelInRange",
6643
+ "privacy": "public",
6644
+ "type": {
6645
+ "text": "string"
6646
+ },
6647
+ "description": "Label announced for cells within the selected range.",
6648
+ "default": "'in range'",
6649
+ "attribute": "rangeLabelInRange",
6650
+ "reflects": true
6651
+ },
6652
+ {
6653
+ "kind": "field",
6654
+ "name": "rangeLabelAfterRange",
6655
+ "privacy": "public",
6656
+ "type": {
6657
+ "text": "string"
6658
+ },
6659
+ "description": "Label announced for cells after the range (or after start when no end is selected).",
6660
+ "default": "'after range'",
6661
+ "attribute": "rangeLabelAfterRange",
6662
+ "reflects": true
6663
+ },
6664
+ {
6665
+ "kind": "field",
6666
+ "name": "blackoutDates",
6667
+ "privacy": "public",
6668
+ "type": {
6669
+ "text": "array"
6670
+ },
6671
+ "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
6672
+ "default": "[]",
6673
+ "attribute": "blackoutDates",
6674
+ "reflects": true
6675
+ },
6676
+ {
6677
+ "kind": "field",
6678
+ "name": "blackoutLabel",
6679
+ "privacy": "public",
6680
+ "type": {
6681
+ "text": "string"
6682
+ },
6683
+ "description": "Label announced for blackout (disabled but in-range) date cells.",
6684
+ "default": "'unavailable'",
6685
+ "attribute": "blackoutLabel",
6686
+ "reflects": true
6687
+ },
6688
+ {
6689
+ "kind": "field",
6690
+ "name": "navLabelPrevMonth",
6691
+ "privacy": "public",
6692
+ "type": {
6693
+ "text": "string"
6694
+ },
6695
+ "description": "Accessible label for the previous month navigation button.",
6696
+ "default": "'Previous month'",
6697
+ "attribute": "navLabelPrevMonth",
6698
+ "reflects": true
6699
+ },
6700
+ {
6701
+ "kind": "field",
6702
+ "name": "navLabelNextMonth",
6703
+ "privacy": "public",
6704
+ "type": {
6705
+ "text": "string"
6706
+ },
6707
+ "description": "Accessible label for the next month navigation button.",
6708
+ "default": "'Next month'",
6709
+ "attribute": "navLabelNextMonth",
6710
+ "reflects": true
6711
+ },
6154
6712
  {
6155
6713
  "kind": "field",
6156
6714
  "name": "stacked",
@@ -6980,6 +7538,87 @@
6980
7538
  "default": "false",
6981
7539
  "fieldName": "range"
6982
7540
  },
7541
+ {
7542
+ "name": "rangeLabelStart",
7543
+ "type": {
7544
+ "text": "string"
7545
+ },
7546
+ "description": "Label announced for the range start date cell.",
7547
+ "default": "'range start'",
7548
+ "fieldName": "rangeLabelStart"
7549
+ },
7550
+ {
7551
+ "name": "rangeLabelEnd",
7552
+ "type": {
7553
+ "text": "string"
7554
+ },
7555
+ "description": "Label announced for the range end date cell.",
7556
+ "default": "'range end'",
7557
+ "fieldName": "rangeLabelEnd"
7558
+ },
7559
+ {
7560
+ "name": "rangeLabelBeforeRange",
7561
+ "type": {
7562
+ "text": "string"
7563
+ },
7564
+ "description": "Label announced for cells before the range start.",
7565
+ "default": "'before range'",
7566
+ "fieldName": "rangeLabelBeforeRange"
7567
+ },
7568
+ {
7569
+ "name": "rangeLabelInRange",
7570
+ "type": {
7571
+ "text": "string"
7572
+ },
7573
+ "description": "Label announced for cells within the selected range.",
7574
+ "default": "'in range'",
7575
+ "fieldName": "rangeLabelInRange"
7576
+ },
7577
+ {
7578
+ "name": "rangeLabelAfterRange",
7579
+ "type": {
7580
+ "text": "string"
7581
+ },
7582
+ "description": "Label announced for cells after the range (or after start when no end is selected).",
7583
+ "default": "'after range'",
7584
+ "fieldName": "rangeLabelAfterRange"
7585
+ },
7586
+ {
7587
+ "name": "blackoutDates",
7588
+ "type": {
7589
+ "text": "array"
7590
+ },
7591
+ "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
7592
+ "default": "[]",
7593
+ "fieldName": "blackoutDates"
7594
+ },
7595
+ {
7596
+ "name": "blackoutLabel",
7597
+ "type": {
7598
+ "text": "string"
7599
+ },
7600
+ "description": "Label announced for blackout (disabled but in-range) date cells.",
7601
+ "default": "'unavailable'",
7602
+ "fieldName": "blackoutLabel"
7603
+ },
7604
+ {
7605
+ "name": "navLabelPrevMonth",
7606
+ "type": {
7607
+ "text": "string"
7608
+ },
7609
+ "description": "Accessible label for the previous month navigation button.",
7610
+ "default": "'Previous month'",
7611
+ "fieldName": "navLabelPrevMonth"
7612
+ },
7613
+ {
7614
+ "name": "navLabelNextMonth",
7615
+ "type": {
7616
+ "text": "string"
7617
+ },
7618
+ "description": "Accessible label for the next month navigation button.",
7619
+ "default": "'Next month'",
7620
+ "fieldName": "navLabelNextMonth"
7621
+ },
6983
7622
  {
6984
7623
  "name": "referenceDates",
6985
7624
  "type": {
@@ -7151,7 +7790,7 @@
7151
7790
  "type": {
7152
7791
  "text": "object"
7153
7792
  },
7154
- "default": "{ Escape(component, evt) { if (!component.dropdown || !component.dropdown.isPopoverVisible) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups. // Because stopPropagation prevents the document-level floatingUI keydown handler from // seeing this event, we must also close the dropdown explicitly. evt.stopPropagation(); component.dropdown.hide(); }, }"
7793
+ "default": "{ Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Stop propagation so parent containers (auro-dialog, auro-drawer) // don't also react to Escape. evt.stopPropagation(); evt.preventDefault(); component.hideBib(); }, Enter(component, evt, ctx) { if (ctx.isExpanded) { return; } // Prevent the space character from being typed into the input. evt.preventDefault(); component.dropdown.show(); }, ' '(component, evt, ctx) { if (ctx.isExpanded) { return; } // Prevent the space character from being typed into the input. evt.preventDefault(); component.dropdown.show(); }, }"
7155
7794
  }
7156
7795
  ],
7157
7796
  "exports": [
@@ -8005,6 +8644,29 @@
8005
8644
  "name": "updateFocusTrap",
8006
8645
  "privacy": "private"
8007
8646
  },
8647
+ {
8648
+ "kind": "method",
8649
+ "name": "_getActiveElements",
8650
+ "description": "Returns the chain of active (focused) elements through shadow roots.",
8651
+ "privacy": "private",
8652
+ "return": {
8653
+ "type": {
8654
+ "text": "Array<HTMLElement>"
8655
+ }
8656
+ }
8657
+ },
8658
+ {
8659
+ "kind": "method",
8660
+ "name": "_setPageInert",
8661
+ "description": "Sets `inert` on sibling elements of the dropdown's top-level host\nso that content outside the dropdown is not interactive while the modal is open.\nWalks up through shadow DOM boundaries to find the outermost host element\nin the light DOM, then sets `inert` on that element's siblings.",
8662
+ "privacy": "private"
8663
+ },
8664
+ {
8665
+ "kind": "method",
8666
+ "name": "_clearPageInert",
8667
+ "description": "Restores `inert` state on siblings that were made inert by `_setPageInert`.",
8668
+ "privacy": "private"
8669
+ },
8008
8670
  {
8009
8671
  "kind": "method",
8010
8672
  "name": "handleFocusout",
@@ -8311,6 +8973,17 @@
8311
8973
  "attribute": "autoPlacement",
8312
8974
  "reflects": true
8313
8975
  },
8976
+ {
8977
+ "kind": "field",
8978
+ "name": "desktopModal",
8979
+ "privacy": "public",
8980
+ "type": {
8981
+ "text": "boolean"
8982
+ },
8983
+ "description": "If declared, the dropdown will behave as a modal dialog when in a desktop viewport size.",
8984
+ "attribute": "desktopModal",
8985
+ "reflects": true
8986
+ },
8314
8987
  {
8315
8988
  "kind": "field",
8316
8989
  "name": "disableEventShow",
@@ -8617,6 +9290,14 @@
8617
9290
  "description": "If declared, bib's position will be automatically calculated where to appear.",
8618
9291
  "fieldName": "autoPlacement"
8619
9292
  },
9293
+ {
9294
+ "name": "desktopModal",
9295
+ "type": {
9296
+ "text": "boolean"
9297
+ },
9298
+ "description": "If declared, the dropdown will behave as a modal dialog when in a desktop viewport size.",
9299
+ "fieldName": "desktopModal"
9300
+ },
8620
9301
  {
8621
9302
  "name": "disableEventShow",
8622
9303
  "type": {
@@ -9355,46 +10036,6 @@
9355
10036
  },
9356
10037
  "privacy": "private"
9357
10038
  },
9358
- {
9359
- "kind": "method",
9360
- "name": "_isDisabled",
9361
- "parameters": [
9362
- {
9363
- "name": "element",
9364
- "description": "The element to check.",
9365
- "type": {
9366
- "text": "HTMLElement | undefined | null"
9367
- }
9368
- }
9369
- ],
9370
- "description": "Whether a given element is currently disabled. Disabled controls are excluded\nfrom submission, validity, and initial-state checks (per the HTML spec).\n\nImplementation note: we deliberately read only the attribute. Every Auro\nform element in `formElementTags` declares `disabled` with `reflect: true`,\nso the attribute and property stay in sync. Reading the attribute also\nlets the MutationObserver in `connectedCallback` (which is filtered to\n`['disabled', 'name']`) be the single source of truth for re-renders.\nIf a future form-element type ships without attribute reflection, expand\nthis helper to also read `element.disabled`.",
9371
- "return": {
9372
- "type": {
9373
- "text": "boolean"
9374
- }
9375
- },
9376
- "privacy": "private"
9377
- },
9378
- {
9379
- "kind": "method",
9380
- "name": "_isNameDisabled",
9381
- "parameters": [
9382
- {
9383
- "name": "name",
9384
- "description": "The `name` attribute used to register the element.",
9385
- "type": {
9386
- "text": "string"
9387
- }
9388
- }
9389
- ],
9390
- "description": "Whether the tracked form element registered under `name` is currently disabled.\n\nPerformance note: this is called once per `formState` key per read of\n`value` / `validity` / `isInitialState`, producing O(n²) work where n is\nthe number of tracked fields. Acceptable for typical forms (< ~50 fields).\nFor larger forms, a future refactor should store disabled state on each\n`formState` entry and update it from the attribute observer instead.",
9391
- "return": {
9392
- "type": {
9393
- "text": "boolean"
9394
- }
9395
- },
9396
- "privacy": "private"
9397
- },
9398
10039
  {
9399
10040
  "kind": "method",
9400
10041
  "name": "_eventIsValidFormEvent",
@@ -9656,26 +10297,6 @@
9656
10297
  },
9657
10298
  "privacy": "private"
9658
10299
  },
9659
- {
9660
- "kind": "method",
9661
- "name": "_handleAttributeMutations",
9662
- "parameters": [
9663
- {
9664
- "name": "mutations",
9665
- "description": "The batched mutation records.",
9666
- "type": {
9667
- "text": "MutationRecord[]"
9668
- }
9669
- }
9670
- ],
9671
- "description": "Handle batched MutationObserver records for `disabled` and `name`\nattribute changes on tracked form elements. A `name` change invalidates\nthe formState keying — we resolve it by re-initializing state. A `disabled`\nchange simply needs a re-render (so `value` / `validity` getters re-evaluate)\nand a refresh of the submit/reset button enablement.",
9672
- "return": {
9673
- "type": {
9674
- "text": "void"
9675
- }
9676
- },
9677
- "privacy": "private"
9678
- },
9679
10300
  {
9680
10301
  "kind": "method",
9681
10302
  "name": "mutationEventListener",
@@ -9769,15 +10390,6 @@
9769
10390
  },
9770
10391
  "privacy": "private",
9771
10392
  "default": "[]"
9772
- },
9773
- {
9774
- "kind": "field",
9775
- "name": "_attributeObserver",
9776
- "type": {
9777
- "text": "MutationObserver | null"
9778
- },
9779
- "privacy": "private",
9780
- "default": "null"
9781
10393
  }
9782
10394
  ],
9783
10395
  "events": [