@aurodesignsystem-dev/auro-formkit 0.0.0-pr1475.5 → 0.0.0-pr1475.7

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