@aurodesignsystem-dev/auro-formkit 0.0.0-pr1530.2 → 0.0.0-pr1531.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/components/checkbox/demo/customize.min.js +1 -1
  2. package/components/checkbox/demo/getting-started.min.js +1 -1
  3. package/components/checkbox/demo/index.min.js +1 -1
  4. package/components/checkbox/dist/index.js +1 -1
  5. package/components/checkbox/dist/registered.js +1 -1
  6. package/components/combobox/demo/customize.min.js +15 -6
  7. package/components/combobox/demo/getting-started.min.js +15 -6
  8. package/components/combobox/demo/index.min.js +15 -6
  9. package/components/combobox/dist/index.js +15 -6
  10. package/components/combobox/dist/registered.js +15 -6
  11. package/components/counter/demo/customize.min.js +2 -2
  12. package/components/counter/demo/index.min.js +2 -2
  13. package/components/counter/dist/index.js +2 -2
  14. package/components/counter/dist/registered.js +2 -2
  15. package/components/datepicker/demo/accessibility.md +8 -17
  16. package/components/datepicker/demo/api.md +1 -1
  17. package/components/datepicker/demo/customize.min.js +41 -178
  18. package/components/datepicker/demo/index.min.js +41 -178
  19. package/components/datepicker/demo/keyboard-behavior.md +3 -3
  20. package/components/datepicker/demo/voiceover.md +4 -4
  21. package/components/datepicker/demo/why-datepicker.md +2 -2
  22. package/components/datepicker/dist/auro-calendar-cell.d.ts +0 -11
  23. package/components/datepicker/dist/auro-calendar.d.ts +2 -26
  24. package/components/datepicker/dist/auro-datepicker.d.ts +1 -9
  25. package/components/datepicker/dist/index.js +41 -178
  26. package/components/datepicker/dist/registered.js +41 -178
  27. package/components/dropdown/demo/customize.min.js +1 -1
  28. package/components/dropdown/demo/getting-started.min.js +1 -1
  29. package/components/dropdown/demo/index.min.js +1 -1
  30. package/components/dropdown/dist/index.js +1 -1
  31. package/components/dropdown/dist/registered.js +1 -1
  32. package/components/form/demo/customize.min.js +89 -254
  33. package/components/form/demo/getting-started.min.js +89 -254
  34. package/components/form/demo/index.min.js +89 -254
  35. package/components/form/demo/registerDemoDeps.min.js +89 -254
  36. package/components/input/demo/customize.min.js +13 -4
  37. package/components/input/demo/getting-started.min.js +13 -4
  38. package/components/input/demo/index.min.js +13 -4
  39. package/components/input/dist/index.js +13 -4
  40. package/components/input/dist/registered.js +13 -4
  41. package/components/radio/demo/customize.min.js +1 -1
  42. package/components/radio/demo/getting-started.min.js +1 -1
  43. package/components/radio/demo/index.min.js +1 -1
  44. package/components/radio/dist/index.js +1 -1
  45. package/components/radio/dist/registered.js +1 -1
  46. package/components/select/demo/customize.min.js +16 -62
  47. package/components/select/demo/getting-started.min.js +16 -62
  48. package/components/select/demo/index.min.js +16 -62
  49. package/components/select/dist/auro-select.d.ts +0 -6
  50. package/components/select/dist/index.js +16 -62
  51. package/components/select/dist/registered.js +16 -62
  52. package/custom-elements.json +1480 -1510
  53. package/package.json +1 -1
@@ -267,34 +267,107 @@
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": "method",
326
+ "name": "_scheduleTimer",
327
+ "parameters": [
328
+ {
329
+ "name": "fn",
330
+ "description": "Callback to run.",
331
+ "type": {
332
+ "text": "Function"
333
+ }
334
+ },
335
+ {
336
+ "name": "ms",
337
+ "description": "Delay in milliseconds.",
338
+ "type": {
339
+ "text": "number"
340
+ }
341
+ }
342
+ ],
343
+ "description": "Wraps setTimeout and records the timer id so disconnectedCallback\ncan cancel any outstanding callbacks. The id is removed from the set\nonce the callback fires so the set doesn't grow unbounded.",
344
+ "return": {
345
+ "type": {
346
+ "text": "number"
347
+ }
348
+ },
349
+ "privacy": "private"
350
+ },
351
+ {
352
+ "kind": "field",
353
+ "name": "inputValue",
354
+ "description": "Returns the current value of the input element within the combobox.",
355
+ "return": {
356
+ "type": {
357
+ "text": "string|undefined"
358
+ }
359
+ },
360
+ "readonly": true
361
+ },
362
+ {
363
+ "kind": "method",
364
+ "name": "isValid",
365
+ "description": "Checks if the element is valid.",
366
+ "return": {
367
+ "type": {
368
+ "text": "boolean"
369
+ }
370
+ }
298
371
  },
299
372
  {
300
373
  "kind": "method",
@@ -303,7 +376,7 @@
303
376
  "parameters": [
304
377
  {
305
378
  "name": "name",
306
- "default": "\"auro-checkbox-group\"",
379
+ "default": "'auro-combobox'",
307
380
  "description": "The name of the element that you want to register.",
308
381
  "optional": true,
309
382
  "type": {
@@ -315,24 +388,82 @@
315
388
  },
316
389
  {
317
390
  "kind": "method",
318
- "name": "handleValueUpdate",
391
+ "name": "activateFirstEnabledAvailableOption",
392
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
393
+ "privacy": "private",
394
+ "return": {
395
+ "type": {
396
+ "text": "void"
397
+ }
398
+ }
399
+ },
400
+ {
401
+ "kind": "method",
402
+ "name": "activateLastEnabledAvailableOption",
403
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
404
+ "privacy": "private",
405
+ "return": {
406
+ "type": {
407
+ "text": "void"
408
+ }
409
+ }
410
+ },
411
+ {
412
+ "kind": "method",
413
+ "name": "updateFilter",
414
+ "description": "Updates the filter for the available options based on the input value.",
415
+ "privacy": "private"
416
+ },
417
+ {
418
+ "kind": "method",
419
+ "name": "syncValuesAndStates",
420
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
421
+ "privacy": "private",
422
+ "return": {
423
+ "type": {
424
+ "text": "void"
425
+ }
426
+ }
427
+ },
428
+ {
429
+ "kind": "method",
430
+ "name": "updateTriggerTextDisplay",
319
431
  "parameters": [
320
432
  {
321
- "name": "value",
322
- "description": "The value of the checkbox.",
433
+ "name": "label",
434
+ "description": "The label of the selected option.",
323
435
  "type": {
324
- "text": "String"
436
+ "text": "string"
325
437
  }
326
- },
438
+ }
439
+ ],
440
+ "description": "Update displayValue or input.value, it's called when making a selection.",
441
+ "privacy": "private"
442
+ },
443
+ {
444
+ "kind": "method",
445
+ "name": "syncInputValuesAcrossTriggerAndBib",
446
+ "parameters": [
327
447
  {
328
- "name": "selected",
329
- "description": "The checked state of the checkbox.",
448
+ "name": "nextValue",
449
+ "description": "The value to write to both inputs.",
330
450
  "type": {
331
- "text": "Boolean"
451
+ "text": "string"
332
452
  }
333
453
  }
334
454
  ],
335
- "description": "Helper method to handle checkbox value changing.",
455
+ "description": "Writes nextValue to the trigger input and the bib input when their current\nvalue differs, then re-asserts imask after Lit's update flushes.",
456
+ "return": {
457
+ "type": {
458
+ "text": "Promise<void>"
459
+ }
460
+ },
461
+ "privacy": "private"
462
+ },
463
+ {
464
+ "kind": "method",
465
+ "name": "handleMenuOptions",
466
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
336
467
  "privacy": "private",
337
468
  "return": {
338
469
  "type": {
@@ -342,8 +473,8 @@
342
473
  },
343
474
  {
344
475
  "kind": "method",
345
- "name": "handlePreselectedItems",
346
- "description": "Helper method that handles the state of preselected checkboxes.",
476
+ "name": "generateOptionsArray",
477
+ "description": "Determines the element error state based on the `required` attribute and input value.",
347
478
  "privacy": "private",
348
479
  "return": {
349
480
  "type": {
@@ -353,9 +484,8 @@
353
484
  },
354
485
  {
355
486
  "kind": "method",
356
- "name": "handleItems",
357
- "description": "Helper method that handles the state of checkboxes.",
358
- "privacy": "private",
487
+ "name": "hideBib",
488
+ "description": "Hides the dropdown bib if its open.",
359
489
  "return": {
360
490
  "type": {
361
491
  "text": "void"
@@ -364,8 +494,8 @@
364
494
  },
365
495
  {
366
496
  "kind": "method",
367
- "name": "reset",
368
- "description": "Resets component to initial state.",
497
+ "name": "showBib",
498
+ "description": "Shows the dropdown bib if there are options to show.",
369
499
  "return": {
370
500
  "type": {
371
501
  "text": "void"
@@ -374,509 +504,678 @@
374
504
  },
375
505
  {
376
506
  "kind": "method",
377
- "name": "validate",
378
- "parameters": [
379
- {
380
- "name": "force",
381
- "default": "false",
382
- "description": "Whether to force validation.",
383
- "optional": true,
384
- "type": {
385
- "text": "boolean"
386
- }
507
+ "name": "configureDropdown",
508
+ "description": "Binds all behavior needed to the dropdown after rendering.",
509
+ "privacy": "private",
510
+ "return": {
511
+ "type": {
512
+ "text": "void"
387
513
  }
388
- ],
389
- "description": "Validates value."
514
+ }
390
515
  },
391
516
  {
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
517
+ "kind": "method",
518
+ "name": "setClearBtnFocus",
519
+ "privacy": "private"
402
520
  },
403
521
  {
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
522
+ "kind": "method",
523
+ "name": "setTriggerInputFocus",
524
+ "privacy": "private"
413
525
  },
414
526
  {
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
527
+ "kind": "method",
528
+ "name": "setInputFocus",
529
+ "privacy": "private"
424
530
  },
425
531
  {
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
532
+ "kind": "method",
533
+ "name": "updateBibDialogRole",
534
+ "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.",
535
+ "privacy": "private"
435
536
  },
436
537
  {
437
- "kind": "field",
438
- "name": "noValidate",
439
- "privacy": "public",
440
- "type": {
441
- "text": "boolean"
538
+ "kind": "method",
539
+ "name": "updateMenuShapeSize",
540
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
541
+ "privacy": "private"
542
+ },
543
+ {
544
+ "kind": "method",
545
+ "name": "_getAnnouncementRoot",
546
+ "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.",
547
+ "privacy": "private",
548
+ "return": {
549
+ "type": {
550
+ "text": "ShadowRoot"
551
+ }
552
+ }
553
+ },
554
+ {
555
+ "kind": "method",
556
+ "name": "configureMenu",
557
+ "description": "Binds all behavior needed to the menu after rendering.",
558
+ "privacy": "private",
559
+ "return": {
560
+ "type": {
561
+ "text": "void"
562
+ }
563
+ }
564
+ },
565
+ {
566
+ "kind": "method",
567
+ "name": "configureInput",
568
+ "description": "Binds all behavior needed to the input after rendering.",
569
+ "privacy": "private",
570
+ "return": {
571
+ "type": {
572
+ "text": "void"
573
+ }
574
+ }
575
+ },
576
+ {
577
+ "kind": "method",
578
+ "name": "handleMenuLoadingChange",
579
+ "parameters": [
580
+ {
581
+ "name": "event",
582
+ "description": "The event object containing details about the loading state change.",
583
+ "type": {
584
+ "text": "CustomEvent"
585
+ }
586
+ },
587
+ {
588
+ "description": "Indicates whether the menu is currently loading.",
589
+ "name": "event.detail.loading",
590
+ "type": {
591
+ "text": "boolean"
592
+ }
593
+ },
594
+ {
595
+ "description": "Indicates if there are loading placeholders present.",
596
+ "name": "event.detail.hasLoadingPlaceholder",
597
+ "type": {
598
+ "text": "boolean"
599
+ }
600
+ }
601
+ ],
602
+ "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.",
603
+ "privacy": "private",
604
+ "return": {
605
+ "type": {
606
+ "text": "void"
607
+ }
608
+ }
609
+ },
610
+ {
611
+ "kind": "method",
612
+ "name": "handleInputValueChange",
613
+ "parameters": [
614
+ {
615
+ "name": "event",
616
+ "description": "The input event triggered by the input element.",
617
+ "type": {
618
+ "text": "Event"
619
+ }
620
+ }
621
+ ],
622
+ "description": "Handle changes to the input value and trigger changes that should result.",
623
+ "privacy": "private",
624
+ "return": {
625
+ "type": {
626
+ "text": "void"
627
+ }
628
+ }
629
+ },
630
+ {
631
+ "kind": "method",
632
+ "name": "handleTriggerInputValueChange",
633
+ "parameters": [
634
+ {
635
+ "name": "event",
636
+ "description": "The input event from the trigger input element.",
637
+ "type": {
638
+ "text": "Event"
639
+ }
640
+ }
641
+ ],
642
+ "description": "Handles input value changes originating from the trigger input.\nRefreshes menu options and filtering, delegates to handleInputValueChange\nfor value synchronization, and manages fullscreen bib focus.",
643
+ "privacy": "private",
644
+ "return": {
645
+ "type": {
646
+ "text": "void"
647
+ }
648
+ }
649
+ },
650
+ {
651
+ "kind": "method",
652
+ "name": "configureCombobox",
653
+ "description": "Binds all behavior needed to the combobox after rendering.",
654
+ "privacy": "private",
655
+ "return": {
656
+ "type": {
657
+ "text": "void"
658
+ }
659
+ }
660
+ },
661
+ {
662
+ "kind": "method",
663
+ "name": "focus",
664
+ "description": "Focuses the combobox trigger input.",
665
+ "return": {
666
+ "type": {
667
+ "text": "void"
668
+ }
669
+ }
670
+ },
671
+ {
672
+ "kind": "method",
673
+ "name": "setMenuValue",
674
+ "parameters": [
675
+ {
676
+ "name": "value",
677
+ "description": "The value to set on the menu.",
678
+ "type": {
679
+ "text": "string"
680
+ }
681
+ }
682
+ ],
683
+ "description": "Sets the menu value if menu is available.",
684
+ "return": {
685
+ "type": {
686
+ "text": "void"
687
+ }
688
+ }
689
+ },
690
+ {
691
+ "kind": "method",
692
+ "name": "reset",
693
+ "description": "Resets component to initial state.",
694
+ "return": {
695
+ "type": {
696
+ "text": "void"
697
+ }
698
+ }
699
+ },
700
+ {
701
+ "kind": "method",
702
+ "name": "clear",
703
+ "description": "Clears the current value of the combobox.",
704
+ "return": {
705
+ "type": {
706
+ "text": "void"
707
+ }
708
+ }
709
+ },
710
+ {
711
+ "kind": "method",
712
+ "name": "validate",
713
+ "parameters": [
714
+ {
715
+ "name": "force",
716
+ "default": "false",
717
+ "description": "Whether to force validation.",
718
+ "optional": true,
719
+ "type": {
720
+ "text": "boolean"
721
+ }
722
+ }
723
+ ],
724
+ "description": "Validates value."
725
+ },
726
+ {
727
+ "kind": "method",
728
+ "name": "transportAssignedNodes",
729
+ "parameters": [
730
+ {
731
+ "name": "slot",
732
+ "description": "The slot element containing the nodes to apply.",
733
+ "type": {
734
+ "text": "HTMLSlotElement"
735
+ }
736
+ },
737
+ {
738
+ "name": "target",
739
+ "description": "The target element to apply the nodes to.",
740
+ "type": {
741
+ "text": "HTMLElement"
742
+ }
743
+ },
744
+ {
745
+ "name": "newSlotName",
746
+ "description": "The new slot name for the applied nodes.",
747
+ "type": {
748
+ "text": "string"
749
+ }
750
+ }
751
+ ],
752
+ "description": "Applies slotted nodes to a target element with a new slot name.",
753
+ "privacy": "private",
754
+ "return": {
755
+ "type": {
756
+ "text": "void"
757
+ }
758
+ }
759
+ },
760
+ {
761
+ "kind": "method",
762
+ "name": "updateActiveOption",
763
+ "parameters": [
764
+ {
765
+ "name": "index",
766
+ "description": "Index of the option to make active.",
767
+ "type": {
768
+ "text": "number"
769
+ }
770
+ }
771
+ ],
772
+ "description": "Updates the active option in the menu."
773
+ },
774
+ {
775
+ "kind": "method",
776
+ "name": "handleSlotChange",
777
+ "parameters": [
778
+ {
779
+ "name": "event",
780
+ "description": "`slotchange` event.",
781
+ "type": {
782
+ "text": "Event"
783
+ }
784
+ }
785
+ ],
786
+ "description": "Watch for slot changes and recalculate the menuoptions.",
787
+ "privacy": "private",
788
+ "return": {
789
+ "type": {
790
+ "text": "void"
791
+ }
792
+ }
793
+ },
794
+ {
795
+ "kind": "field",
796
+ "name": "appearance",
797
+ "privacy": "public",
798
+ "type": {
799
+ "text": "string"
442
800
  },
443
- "description": "If set, disables auto-validation on blur.",
444
- "attribute": "noValidate",
801
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
802
+ "default": "'default'",
803
+ "attribute": "appearance",
445
804
  "reflects": true
446
805
  },
447
806
  {
448
807
  "kind": "field",
449
- "name": "onDark",
808
+ "name": "autocomplete",
450
809
  "privacy": "public",
451
810
  "type": {
452
- "text": "boolean"
811
+ "text": "string"
453
812
  },
454
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
455
- "attribute": "onDark",
813
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
814
+ "attribute": "autocomplete",
456
815
  "reflects": true
457
816
  },
458
817
  {
459
818
  "kind": "field",
460
- "name": "required",
819
+ "name": "autoPlacement",
461
820
  "privacy": "public",
462
821
  "type": {
463
822
  "text": "boolean"
464
823
  },
465
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
466
- "attribute": "required",
824
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
825
+ "attribute": "autoPlacement",
467
826
  "reflects": true
468
827
  },
469
828
  {
470
829
  "kind": "field",
471
- "name": "setCustomValidity",
472
- "privacy": "public",
830
+ "name": "availableOptions",
831
+ "privacy": "private",
473
832
  "type": {
474
- "text": "string"
833
+ "text": "array"
475
834
  },
476
- "description": "Sets a custom help text message to display for all validityStates.",
477
- "attribute": "setCustomValidity"
835
+ "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).",
836
+ "attribute": "availableOptions"
478
837
  },
479
838
  {
480
839
  "kind": "field",
481
- "name": "setCustomValidityCustomError",
840
+ "name": "behavior",
482
841
  "privacy": "public",
483
842
  "type": {
484
- "text": "string"
843
+ "text": "'filter' | 'suggestion'"
485
844
  },
486
- "description": "Custom help text message to display when validity = `customError`.",
487
- "attribute": "setCustomValidityCustomError"
845
+ "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.",
846
+ "default": "'suggestion'",
847
+ "attribute": "behavior",
848
+ "reflects": true
488
849
  },
489
850
  {
490
851
  "kind": "field",
491
- "name": "setCustomValidityValueMissing",
852
+ "name": "checkmark",
492
853
  "privacy": "public",
493
854
  "type": {
494
- "text": "string"
855
+ "text": "boolean"
495
856
  },
496
- "description": "Custom help text message to display when validity = `valueMissing`.",
497
- "attribute": "setCustomValidityValueMissing"
857
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
858
+ "attribute": "checkmark",
859
+ "reflects": true
498
860
  },
499
861
  {
500
862
  "kind": "field",
501
- "name": "validity",
863
+ "name": "disabled",
502
864
  "privacy": "public",
503
865
  "type": {
504
- "text": "string"
866
+ "text": "boolean"
505
867
  },
506
- "description": "Specifies the `validityState` this element is in.",
507
- "attribute": "validity",
868
+ "description": "If set, disables the combobox.",
869
+ "attribute": "disabled",
508
870
  "reflects": true
509
- }
510
- ],
511
- "events": [
871
+ },
512
872
  {
513
- "name": "input",
873
+ "kind": "field",
874
+ "name": "dropdownId",
875
+ "privacy": "private",
514
876
  "type": {
515
- "text": "CustomEvent"
516
- }
877
+ "text": "string"
878
+ },
879
+ "description": "ID for the dropdown."
517
880
  },
518
881
  {
519
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
520
- "name": "auroFormElement-validated"
521
- }
522
- ],
523
- "attributes": [
524
- {
525
- "name": "appearance",
882
+ "kind": "field",
883
+ "name": "dropdownOpen",
884
+ "privacy": "private",
526
885
  "type": {
527
- "text": "'default' | 'inverse'"
886
+ "text": "boolean"
528
887
  },
529
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
530
- "default": "'default'",
531
- "fieldName": "appearance"
888
+ "description": "Whether or not the dropdown is open."
532
889
  },
533
890
  {
534
- "name": "disabled",
891
+ "kind": "field",
892
+ "name": "dvInputOnly",
893
+ "privacy": "public",
535
894
  "type": {
536
895
  "text": "boolean"
537
896
  },
538
- "description": "If set, disables the checkbox group.",
539
- "fieldName": "disabled"
897
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
898
+ "attribute": "dvInputOnly",
899
+ "reflects": true
540
900
  },
541
901
  {
902
+ "kind": "field",
542
903
  "name": "error",
904
+ "privacy": "public",
543
905
  "type": {
544
906
  "text": "string"
545
907
  },
546
908
  "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
547
- "fieldName": "error"
909
+ "attribute": "error",
910
+ "reflects": true
548
911
  },
549
912
  {
550
- "name": "horizontal",
913
+ "kind": "field",
914
+ "name": "format",
915
+ "privacy": "public",
916
+ "type": {
917
+ "text": "string"
918
+ },
919
+ "description": "Specifies the input mask format.",
920
+ "attribute": "format",
921
+ "reflects": true
922
+ },
923
+ {
924
+ "kind": "field",
925
+ "name": "inputmode",
926
+ "privacy": "public",
927
+ "type": {
928
+ "text": "string"
929
+ },
930
+ "description": "Exposes inputmode attribute for input.",
931
+ "attribute": "inputmode",
932
+ "reflects": true
933
+ },
934
+ {
935
+ "kind": "field",
936
+ "name": "layout",
937
+ "privacy": "public",
938
+ "type": {
939
+ "text": "string"
940
+ },
941
+ "description": "Sets the layout of the combobox.",
942
+ "default": "'classic'",
943
+ "attribute": "layout",
944
+ "reflects": true,
945
+ "inheritedFrom": {
946
+ "name": "AuroElement",
947
+ "module": "components/layoutElement/src/auroElement.js"
948
+ }
949
+ },
950
+ {
951
+ "kind": "field",
952
+ "name": "matchWidth",
953
+ "privacy": "private",
954
+ "type": {
955
+ "text": "boolean"
956
+ },
957
+ "description": "If declared, the popover and trigger will be set to the same width.",
958
+ "attribute": "matchWidth",
959
+ "reflects": true
960
+ },
961
+ {
962
+ "kind": "field",
963
+ "name": "noFilter",
964
+ "privacy": "public",
551
965
  "type": {
552
966
  "text": "boolean"
553
967
  },
554
- "description": "If set, checkboxes will be aligned horizontally.",
555
- "fieldName": "horizontal"
968
+ "description": "If set, combobox will not filter menuoptions based on input.",
969
+ "attribute": "noFilter",
970
+ "reflects": true
556
971
  },
557
972
  {
558
- "name": "noValidate",
973
+ "kind": "field",
974
+ "name": "noFlip",
975
+ "privacy": "public",
559
976
  "type": {
560
977
  "text": "boolean"
561
978
  },
562
- "description": "If set, disables auto-validation on blur.",
563
- "fieldName": "noValidate"
979
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
980
+ "attribute": "noFlip",
981
+ "reflects": true
564
982
  },
565
983
  {
566
- "name": "onDark",
984
+ "kind": "field",
985
+ "name": "shift",
986
+ "privacy": "public",
567
987
  "type": {
568
988
  "text": "boolean"
569
989
  },
570
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
571
- "fieldName": "onDark"
990
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
991
+ "attribute": "shift",
992
+ "reflects": true
572
993
  },
573
994
  {
574
- "name": "required",
995
+ "kind": "field",
996
+ "name": "noValidate",
997
+ "privacy": "public",
575
998
  "type": {
576
999
  "text": "boolean"
577
1000
  },
578
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
579
- "fieldName": "required"
1001
+ "description": "If set, disables auto-validation on blur.",
1002
+ "attribute": "noValidate",
1003
+ "reflects": true
580
1004
  },
581
1005
  {
582
- "name": "setCustomValidity",
1006
+ "kind": "field",
1007
+ "name": "offset",
1008
+ "privacy": "public",
583
1009
  "type": {
584
- "text": "string"
1010
+ "text": "number"
585
1011
  },
586
- "description": "Sets a custom help text message to display for all validityStates.",
587
- "fieldName": "setCustomValidity"
1012
+ "description": "Gap between the trigger element and bib.",
1013
+ "default": "0",
1014
+ "attribute": "offset",
1015
+ "reflects": true
588
1016
  },
589
1017
  {
590
- "name": "setCustomValidityCustomError",
1018
+ "kind": "field",
1019
+ "name": "onDark",
1020
+ "privacy": "public",
591
1021
  "type": {
592
- "text": "string"
1022
+ "text": "boolean"
593
1023
  },
594
- "description": "Custom help text message to display when validity = `customError`.",
595
- "fieldName": "setCustomValidityCustomError"
1024
+ "attribute": "onDark",
1025
+ "reflects": true,
1026
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1027
+ "inheritedFrom": {
1028
+ "name": "AuroElement",
1029
+ "module": "components/layoutElement/src/auroElement.js"
1030
+ }
596
1031
  },
597
1032
  {
598
- "name": "setCustomValidityValueMissing",
1033
+ "kind": "field",
1034
+ "name": "optionSelected",
1035
+ "privacy": "public",
599
1036
  "type": {
600
- "text": "string"
1037
+ "text": "HTMLElement"
601
1038
  },
602
- "description": "Custom help text message to display when validity = `valueMissing`.",
603
- "fieldName": "setCustomValidityValueMissing"
1039
+ "description": "Specifies the current selected option.",
1040
+ "attribute": "optionSelected"
604
1041
  },
605
1042
  {
606
- "name": "validity",
1043
+ "kind": "field",
1044
+ "name": "persistInput",
1045
+ "privacy": "public",
607
1046
  "type": {
608
- "text": "string"
1047
+ "text": "boolean"
609
1048
  },
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
- {
663
- "kind": "method",
664
- "name": "_initializeDefaults"
665
- },
666
- {
667
- "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
- }
679
- }
680
- ],
681
- "description": "This will register this element with the browser."
682
- },
683
- {
684
- "kind": "method",
685
- "name": "handleChange",
686
- "parameters": [
687
- {
688
- "name": "event",
689
- "description": "The change event from the checkbox input.",
690
- "type": {
691
- "text": "Event"
692
- }
693
- }
694
- ],
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.",
696
- "privacy": "private",
697
- "return": {
698
- "type": {
699
- "text": "void"
700
- }
701
- }
702
- },
703
- {
704
- "kind": "method",
705
- "name": "handleInput",
706
- "parameters": [
707
- {
708
- "name": "event",
709
- "description": "The input event from the checkbox input.",
710
- "type": {
711
- "text": "Event"
712
- }
713
- }
714
- ],
715
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
716
- "privacy": "private",
717
- "return": {
718
- "type": {
719
- "text": "void"
720
- }
721
- }
722
- },
723
- {
724
- "kind": "method",
725
- "name": "handleFocusin",
726
- "description": "Function to support",
727
- "privacy": "private",
728
- "return": {
729
- "type": {
730
- "text": "void"
731
- }
732
- }
733
- },
734
- {
735
- "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.",
749
- "return": {
750
- "type": {
751
- "text": "void"
752
- }
753
- }
754
- },
755
- {
756
- "kind": "method",
757
- "name": "updateAriaLabel",
758
- "description": "Updates the aria-label based on slot content.",
759
- "privacy": "private",
760
- "return": {
761
- "type": {
762
- "text": "void"
763
- }
764
- }
1049
+ "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.",
1050
+ "attribute": "persistInput",
1051
+ "reflects": true
765
1052
  },
766
1053
  {
767
- "kind": "method",
768
- "name": "handleKeyDown",
769
- "parameters": [
770
- {
771
- "name": "event",
772
- "description": "The keydown event from the checkbox input.",
773
- "type": {
774
- "text": "KeyboardEvent"
775
- }
776
- }
777
- ],
778
- "description": "Handles keydown event to toggle the checkbox with Space key.",
779
- "privacy": "private",
780
- "return": {
781
- "type": {
782
- "text": "void"
783
- }
784
- }
1054
+ "kind": "field",
1055
+ "name": "placement",
1056
+ "privacy": "public",
1057
+ "type": {
1058
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1059
+ },
1060
+ "description": "Position where the bib should appear relative to the trigger.",
1061
+ "default": "'bottom-start'",
1062
+ "attribute": "placement",
1063
+ "reflects": true
785
1064
  },
786
1065
  {
787
1066
  "kind": "field",
788
- "name": "appearance",
1067
+ "name": "placeholder",
789
1068
  "privacy": "public",
790
1069
  "type": {
791
- "text": "'default' | 'inverse'"
1070
+ "text": "string"
792
1071
  },
793
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
794
- "default": "'default'",
795
- "attribute": "appearance",
1072
+ "description": "Define custom placeholder text, only supported by date input formats.",
1073
+ "attribute": "placeholder",
796
1074
  "reflects": true
797
1075
  },
798
1076
  {
799
1077
  "kind": "field",
800
- "name": "checked",
1078
+ "name": "required",
801
1079
  "privacy": "public",
802
1080
  "type": {
803
1081
  "text": "boolean"
804
1082
  },
805
- "description": "If set to true, the checkbox will be filled with a checkmark.",
806
- "attribute": "checked",
1083
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1084
+ "attribute": "required",
807
1085
  "reflects": true
808
1086
  },
809
1087
  {
810
1088
  "kind": "field",
811
- "name": "disabled",
1089
+ "name": "setCustomValidity",
812
1090
  "privacy": "public",
813
1091
  "type": {
814
- "text": "boolean"
1092
+ "text": "string"
815
1093
  },
816
- "description": "If set to true, the checkbox will not be clickable.",
817
- "attribute": "disabled",
818
- "reflects": true
1094
+ "description": "Sets a custom help text message to display for all validityStates.",
1095
+ "attribute": "setCustomValidity"
819
1096
  },
820
1097
  {
821
1098
  "kind": "field",
822
- "name": "error",
1099
+ "name": "setCustomValidityCustomError",
823
1100
  "privacy": "public",
824
1101
  "type": {
825
- "text": "boolean"
1102
+ "text": "string"
826
1103
  },
827
- "description": "If set to true, the checkbox will be displayed with an error state.",
828
- "attribute": "error",
829
- "reflects": true
1104
+ "description": "Custom help text message to display when validity = `customError`.",
1105
+ "attribute": "setCustomValidityCustomError"
830
1106
  },
831
1107
  {
832
1108
  "kind": "field",
833
- "name": "id",
1109
+ "name": "setCustomValidityValueMissing",
834
1110
  "privacy": "public",
835
1111
  "type": {
836
1112
  "text": "string"
837
1113
  },
838
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
839
- "attribute": "id",
840
- "reflects": true
1114
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1115
+ "attribute": "setCustomValidityValueMissing"
841
1116
  },
842
1117
  {
843
1118
  "kind": "field",
844
- "name": "inputId",
845
- "privacy": "private",
1119
+ "name": "setCustomValidityValueMissingFilter",
1120
+ "privacy": "public",
846
1121
  "type": {
847
1122
  "text": "string"
848
1123
  },
849
- "description": "The id for input node."
1124
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1125
+ "attribute": "setCustomValidityValueMissingFilter"
850
1126
  },
851
1127
  {
852
1128
  "kind": "field",
853
- "name": "name",
1129
+ "name": "touched",
1130
+ "privacy": "private",
1131
+ "type": {
1132
+ "text": "boolean"
1133
+ },
1134
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1135
+ },
1136
+ {
1137
+ "kind": "field",
1138
+ "name": "triggerIcon",
1139
+ "privacy": "public",
1140
+ "type": {
1141
+ "text": "boolean"
1142
+ },
1143
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1144
+ "attribute": "triggerIcon",
1145
+ "reflects": true
1146
+ },
1147
+ {
1148
+ "kind": "field",
1149
+ "name": "type",
854
1150
  "privacy": "public",
855
1151
  "type": {
856
1152
  "text": "string"
857
1153
  },
858
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
859
- "attribute": "name"
1154
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1155
+ "attribute": "type",
1156
+ "reflects": true
860
1157
  },
861
1158
  {
862
1159
  "kind": "field",
863
- "name": "onDark",
1160
+ "name": "typedValue",
864
1161
  "privacy": "public",
865
1162
  "type": {
866
- "text": "boolean"
1163
+ "text": "string"
867
1164
  },
868
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
869
- "attribute": "onDark",
1165
+ "description": "Specifies the value of the input element within the combobox.",
1166
+ "attribute": "typedValue",
870
1167
  "reflects": true
871
1168
  },
872
1169
  {
873
1170
  "kind": "field",
874
- "name": "touched",
875
- "privacy": "private",
1171
+ "name": "validity",
1172
+ "privacy": "public",
876
1173
  "type": {
877
- "text": "boolean"
1174
+ "text": "string"
878
1175
  },
879
- "description": "Indicates whether the checkbox has been interacted with."
1176
+ "description": "Specifies the `validityState` this element is in.",
1177
+ "attribute": "validity",
1178
+ "reflects": true
880
1179
  },
881
1180
  {
882
1181
  "kind": "field",
@@ -885,604 +1184,603 @@
885
1184
  "type": {
886
1185
  "text": "string"
887
1186
  },
888
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1187
+ "description": "Value selected for the dropdown menu.",
889
1188
  "attribute": "value"
890
1189
  },
891
1190
  {
892
1191
  "kind": "field",
893
- "name": "tabIndex",
894
- "privacy": "private",
1192
+ "name": "largeFullscreenHeadline",
1193
+ "privacy": "public",
895
1194
  "type": {
896
- "text": "number"
1195
+ "text": "boolean"
897
1196
  },
898
- "description": "The tabindex attribute for the checkbox.",
899
- "attribute": "tabindex",
1197
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1198
+ "attribute": "largeFullscreenHeadline",
900
1199
  "reflects": true
901
1200
  },
902
1201
  {
903
1202
  "kind": "field",
904
- "name": "ariaChecked",
905
- "privacy": "private",
1203
+ "name": "fullscreenBreakpoint",
1204
+ "privacy": "public",
906
1205
  "type": {
907
- "text": "string"
1206
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
908
1207
  },
909
- "description": "The aria-checked attribute for the checkbox.",
910
- "attribute": "aria-checked",
1208
+ "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.",
1209
+ "default": "'sm'",
1210
+ "attribute": "fullscreenBreakpoint",
911
1211
  "reflects": true
912
1212
  },
913
1213
  {
914
1214
  "kind": "field",
915
- "name": "ariaDisabled",
1215
+ "name": "optionActive",
916
1216
  "privacy": "private",
917
1217
  "type": {
918
- "text": "string"
1218
+ "text": "object"
919
1219
  },
920
- "description": "The aria-disabled attribute for the checkbox.",
921
- "attribute": "aria-disabled",
922
- "reflects": true
1220
+ "description": "Specifies the currently active option."
923
1221
  },
924
1222
  {
925
1223
  "kind": "field",
926
- "name": "role",
1224
+ "name": "componentHasFocus",
1225
+ "description": "Returns true if the element has focus.",
927
1226
  "privacy": "private",
1227
+ "return": {
1228
+ "type": {
1229
+ "text": "boolean"
1230
+ }
1231
+ },
1232
+ "readonly": true,
1233
+ "inheritedFrom": {
1234
+ "name": "AuroElement",
1235
+ "module": "components/layoutElement/src/auroElement.js"
1236
+ }
1237
+ },
1238
+ {
1239
+ "kind": "method",
1240
+ "name": "resetShapeClasses",
1241
+ "inheritedFrom": {
1242
+ "name": "AuroElement",
1243
+ "module": "components/layoutElement/src/auroElement.js"
1244
+ }
1245
+ },
1246
+ {
1247
+ "kind": "method",
1248
+ "name": "resetLayoutClasses",
1249
+ "inheritedFrom": {
1250
+ "name": "AuroElement",
1251
+ "module": "components/layoutElement/src/auroElement.js"
1252
+ }
1253
+ },
1254
+ {
1255
+ "kind": "method",
1256
+ "name": "updateComponentArchitecture",
1257
+ "inheritedFrom": {
1258
+ "name": "AuroElement",
1259
+ "module": "components/layoutElement/src/auroElement.js"
1260
+ }
1261
+ },
1262
+ {
1263
+ "kind": "field",
1264
+ "name": "shape",
1265
+ "privacy": "public",
928
1266
  "type": {
929
1267
  "text": "string"
930
1268
  },
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",
933
- "reflects": true
1269
+ "attribute": "shape",
1270
+ "reflects": true,
1271
+ "inheritedFrom": {
1272
+ "name": "AuroElement",
1273
+ "module": "components/layoutElement/src/auroElement.js"
1274
+ }
1275
+ },
1276
+ {
1277
+ "kind": "field",
1278
+ "name": "size",
1279
+ "privacy": "public",
1280
+ "type": {
1281
+ "text": "string"
1282
+ },
1283
+ "attribute": "size",
1284
+ "reflects": true,
1285
+ "inheritedFrom": {
1286
+ "name": "AuroElement",
1287
+ "module": "components/layoutElement/src/auroElement.js"
1288
+ }
934
1289
  }
935
1290
  ],
936
1291
  "events": [
937
1292
  {
938
- "name": "auroCheckbox-input",
1293
+ "name": "inputValue",
939
1294
  "type": {
940
1295
  "text": "CustomEvent"
941
- }
1296
+ },
1297
+ "description": "Notifies that the components internal HTML5 input value has changed."
942
1298
  },
943
1299
  {
944
- "name": "auroCheckbox-focusin",
1300
+ "name": "input",
945
1301
  "type": {
946
1302
  "text": "CustomEvent"
947
- }
1303
+ },
1304
+ "description": "Notifies that the component has a new value set."
948
1305
  },
949
1306
  {
950
- "name": "auroCheckbox-focusout",
1307
+ "name": "auroCombobox-valueSet",
951
1308
  "type": {
952
1309
  "text": "CustomEvent"
953
- }
954
- },
955
- {
956
- "description": "(Deprecated) Notifies when checked value is changed.",
957
- "name": "change"
1310
+ },
1311
+ "description": "(Deprecated) Notifies that the component has a new value set."
958
1312
  },
959
1313
  {
960
- "description": "Notifies when when checked value is changed by user's interface.",
961
- "name": "input"
1314
+ "description": "Notifies that the component value(s) have been validated.",
1315
+ "name": "auroFormElement-validated"
962
1316
  }
963
1317
  ],
964
1318
  "attributes": [
965
1319
  {
966
1320
  "name": "appearance",
967
1321
  "type": {
968
- "text": "'default' | 'inverse'"
1322
+ "text": "string"
969
1323
  },
970
1324
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
971
1325
  "default": "'default'",
972
1326
  "fieldName": "appearance"
973
1327
  },
974
1328
  {
975
- "name": "checked",
976
- "type": {
977
- "text": "boolean"
978
- },
979
- "description": "If set to true, the checkbox will be filled with a checkmark.",
980
- "fieldName": "checked"
981
- },
982
- {
983
- "name": "disabled",
1329
+ "name": "autocomplete",
984
1330
  "type": {
985
- "text": "boolean"
1331
+ "text": "string"
986
1332
  },
987
- "description": "If set to true, the checkbox will not be clickable.",
988
- "fieldName": "disabled"
1333
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1334
+ "fieldName": "autocomplete"
989
1335
  },
990
1336
  {
991
- "name": "error",
1337
+ "name": "autoPlacement",
992
1338
  "type": {
993
1339
  "text": "boolean"
994
1340
  },
995
- "description": "If set to true, the checkbox will be displayed with an error state.",
996
- "fieldName": "error"
1341
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1342
+ "fieldName": "autoPlacement"
997
1343
  },
998
1344
  {
999
- "name": "id",
1345
+ "name": "availableOptions",
1000
1346
  "type": {
1001
- "text": "string"
1347
+ "text": "array"
1002
1348
  },
1003
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
1004
- "fieldName": "id"
1349
+ "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).",
1350
+ "fieldName": "availableOptions"
1005
1351
  },
1006
1352
  {
1007
- "name": "name",
1353
+ "name": "behavior",
1008
1354
  "type": {
1009
- "text": "string"
1355
+ "text": "'filter' | 'suggestion'"
1010
1356
  },
1011
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
1012
- "fieldName": "name"
1357
+ "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.",
1358
+ "default": "'suggestion'",
1359
+ "fieldName": "behavior"
1013
1360
  },
1014
1361
  {
1015
- "name": "onDark",
1362
+ "name": "checkmark",
1016
1363
  "type": {
1017
1364
  "text": "boolean"
1018
1365
  },
1019
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1020
- "fieldName": "onDark"
1366
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1367
+ "fieldName": "checkmark"
1021
1368
  },
1022
1369
  {
1023
- "name": "value",
1370
+ "name": "disabled",
1024
1371
  "type": {
1025
- "text": "string"
1372
+ "text": "boolean"
1026
1373
  },
1027
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1028
- "fieldName": "value"
1374
+ "description": "If set, disables the combobox.",
1375
+ "fieldName": "disabled"
1029
1376
  },
1030
1377
  {
1031
- "name": "tabindex",
1378
+ "name": "dvInputOnly",
1032
1379
  "type": {
1033
- "text": "number"
1380
+ "text": "boolean"
1034
1381
  },
1035
- "description": "The tabindex attribute for the checkbox.",
1036
- "fieldName": "tabIndex"
1382
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1383
+ "fieldName": "dvInputOnly"
1037
1384
  },
1038
1385
  {
1039
- "name": "aria-checked",
1386
+ "name": "error",
1040
1387
  "type": {
1041
1388
  "text": "string"
1042
1389
  },
1043
- "description": "The aria-checked attribute for the checkbox.",
1044
- "fieldName": "ariaChecked"
1390
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1391
+ "fieldName": "error"
1045
1392
  },
1046
1393
  {
1047
- "name": "aria-disabled",
1394
+ "name": "format",
1048
1395
  "type": {
1049
1396
  "text": "string"
1050
1397
  },
1051
- "description": "The aria-disabled attribute for the checkbox.",
1052
- "fieldName": "ariaDisabled"
1398
+ "description": "Specifies the input mask format.",
1399
+ "fieldName": "format"
1053
1400
  },
1054
1401
  {
1055
- "name": "role",
1402
+ "name": "inputmode",
1056
1403
  "type": {
1057
1404
  "text": "string"
1058
1405
  },
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": ""
1406
+ "description": "Exposes inputmode attribute for input.",
1407
+ "fieldName": "inputmode"
1123
1408
  },
1124
1409
  {
1410
+ "name": "layout",
1125
1411
  "type": {
1126
- "text": "HTMLSlotElement"
1412
+ "text": "string"
1127
1413
  },
1128
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1129
- "name": "optionalLabel"
1414
+ "description": "Sets the layout of the combobox.",
1415
+ "default": "'classic'",
1416
+ "fieldName": "layout",
1417
+ "inheritedFrom": {
1418
+ "name": "AuroElement",
1419
+ "module": "components/layoutElement/src/auroElement.js"
1420
+ }
1130
1421
  },
1131
1422
  {
1132
- "description": "Sets aria-label on clear button",
1133
- "name": "ariaLabel.input.clear"
1423
+ "name": "matchWidth",
1424
+ "type": {
1425
+ "text": "boolean"
1426
+ },
1427
+ "description": "If declared, the popover and trigger will be set to the same width.",
1428
+ "fieldName": "matchWidth"
1134
1429
  },
1135
1430
  {
1136
- "description": "Sets aria-label on close button in fullscreen bib",
1137
- "name": "ariaLabel.bib.close"
1431
+ "name": "noFilter",
1432
+ "type": {
1433
+ "text": "boolean"
1434
+ },
1435
+ "description": "If set, combobox will not filter menuoptions based on input.",
1436
+ "fieldName": "noFilter"
1138
1437
  },
1139
1438
  {
1140
- "description": "Defines the headline to display above menu-options",
1141
- "name": "bib.fullscreen.headline"
1439
+ "name": "noFlip",
1440
+ "type": {
1441
+ "text": "boolean"
1442
+ },
1443
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1444
+ "fieldName": "noFlip"
1142
1445
  },
1143
1446
  {
1144
- "description": "Defines the content of the label.",
1145
- "name": "label"
1447
+ "name": "shift",
1448
+ "type": {
1449
+ "text": "boolean"
1450
+ },
1451
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1452
+ "fieldName": "shift"
1146
1453
  },
1147
1454
  {
1148
- "description": "Defines the content of the helpText.",
1149
- "name": "helpText"
1455
+ "name": "noValidate",
1456
+ "type": {
1457
+ "text": "boolean"
1458
+ },
1459
+ "description": "If set, disables auto-validation on blur.",
1460
+ "fieldName": "noValidate"
1150
1461
  },
1151
1462
  {
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
- }
1463
+ "name": "offset",
1464
+ "type": {
1465
+ "text": "number"
1466
+ },
1467
+ "description": "Gap between the trigger element and bib.",
1468
+ "default": "0",
1469
+ "fieldName": "offset"
1166
1470
  },
1167
1471
  {
1168
- "kind": "method",
1169
- "name": "_scheduleTimer",
1170
- "parameters": [
1171
- {
1172
- "name": "fn",
1173
- "description": "Callback to run.",
1174
- "type": {
1175
- "text": "Function"
1176
- }
1177
- },
1178
- {
1179
- "name": "ms",
1180
- "description": "Delay in milliseconds.",
1181
- "type": {
1182
- "text": "number"
1183
- }
1184
- }
1185
- ],
1186
- "description": "Wraps setTimeout and records the timer id so disconnectedCallback\ncan cancel any outstanding callbacks. The id is removed from the set\nonce the callback fires so the set doesn't grow unbounded.",
1187
- "return": {
1188
- "type": {
1189
- "text": "number"
1190
- }
1472
+ "name": "onDark",
1473
+ "type": {
1474
+ "text": "boolean"
1191
1475
  },
1192
- "privacy": "private"
1476
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1477
+ "fieldName": "onDark"
1193
1478
  },
1194
1479
  {
1195
- "kind": "field",
1196
- "name": "inputValue",
1197
- "description": "Returns the current value of the input element within the combobox.",
1198
- "return": {
1199
- "type": {
1200
- "text": "string|undefined"
1201
- }
1480
+ "name": "optionSelected",
1481
+ "type": {
1482
+ "text": "HTMLElement"
1202
1483
  },
1203
- "readonly": true
1484
+ "description": "Specifies the current selected option.",
1485
+ "fieldName": "optionSelected"
1204
1486
  },
1205
1487
  {
1206
- "kind": "method",
1207
- "name": "isValid",
1208
- "description": "Checks if the element is valid.",
1209
- "return": {
1210
- "type": {
1211
- "text": "boolean"
1212
- }
1213
- }
1488
+ "name": "persistInput",
1489
+ "type": {
1490
+ "text": "boolean"
1491
+ },
1492
+ "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.",
1493
+ "fieldName": "persistInput"
1214
1494
  },
1215
1495
  {
1216
- "kind": "method",
1217
- "name": "register",
1218
- "static": true,
1219
- "parameters": [
1220
- {
1221
- "name": "name",
1222
- "default": "'auro-combobox'",
1223
- "description": "The name of the element that you want to register.",
1224
- "optional": true,
1225
- "type": {
1226
- "text": "string"
1227
- }
1228
- }
1229
- ],
1230
- "description": "This will register this element with the browser."
1496
+ "name": "placement",
1497
+ "type": {
1498
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1499
+ },
1500
+ "description": "Position where the bib should appear relative to the trigger.",
1501
+ "default": "'bottom-start'",
1502
+ "fieldName": "placement"
1231
1503
  },
1232
1504
  {
1233
- "kind": "method",
1234
- "name": "activateFirstEnabledAvailableOption",
1235
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
1236
- "privacy": "private",
1237
- "return": {
1238
- "type": {
1239
- "text": "void"
1240
- }
1241
- }
1505
+ "name": "placeholder",
1506
+ "type": {
1507
+ "text": "string"
1508
+ },
1509
+ "description": "Define custom placeholder text, only supported by date input formats.",
1510
+ "fieldName": "placeholder"
1242
1511
  },
1243
1512
  {
1244
- "kind": "method",
1245
- "name": "activateLastEnabledAvailableOption",
1246
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
1247
- "privacy": "private",
1248
- "return": {
1249
- "type": {
1250
- "text": "void"
1251
- }
1252
- }
1513
+ "name": "required",
1514
+ "type": {
1515
+ "text": "boolean"
1516
+ },
1517
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1518
+ "fieldName": "required"
1253
1519
  },
1254
1520
  {
1255
- "kind": "method",
1256
- "name": "updateFilter",
1257
- "description": "Updates the filter for the available options based on the input value.",
1258
- "privacy": "private"
1521
+ "name": "setCustomValidity",
1522
+ "type": {
1523
+ "text": "string"
1524
+ },
1525
+ "description": "Sets a custom help text message to display for all validityStates.",
1526
+ "fieldName": "setCustomValidity"
1259
1527
  },
1260
1528
  {
1261
- "kind": "method",
1262
- "name": "syncValuesAndStates",
1263
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1264
- "privacy": "private",
1265
- "return": {
1266
- "type": {
1267
- "text": "void"
1268
- }
1269
- }
1529
+ "name": "setCustomValidityCustomError",
1530
+ "type": {
1531
+ "text": "string"
1532
+ },
1533
+ "description": "Custom help text message to display when validity = `customError`.",
1534
+ "fieldName": "setCustomValidityCustomError"
1270
1535
  },
1271
1536
  {
1272
- "kind": "method",
1273
- "name": "updateTriggerTextDisplay",
1274
- "parameters": [
1275
- {
1276
- "name": "label",
1277
- "description": "The label of the selected option.",
1278
- "type": {
1279
- "text": "string"
1280
- }
1281
- }
1282
- ],
1283
- "description": "Update displayValue or input.value, it's called when making a selection.",
1284
- "privacy": "private"
1537
+ "name": "setCustomValidityValueMissing",
1538
+ "type": {
1539
+ "text": "string"
1540
+ },
1541
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1542
+ "fieldName": "setCustomValidityValueMissing"
1285
1543
  },
1286
1544
  {
1287
- "kind": "method",
1288
- "name": "syncInputValuesAcrossTriggerAndBib",
1289
- "parameters": [
1290
- {
1291
- "name": "nextValue",
1292
- "description": "The value to write to both inputs.",
1293
- "type": {
1294
- "text": "string"
1295
- }
1296
- }
1297
- ],
1298
- "description": "Writes nextValue to the trigger input and the bib input when their current\nvalue differs, then re-asserts imask after Lit's update flushes.",
1299
- "return": {
1300
- "type": {
1301
- "text": "Promise<void>"
1302
- }
1545
+ "name": "setCustomValidityValueMissingFilter",
1546
+ "type": {
1547
+ "text": "string"
1303
1548
  },
1304
- "privacy": "private"
1549
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1550
+ "fieldName": "setCustomValidityValueMissingFilter"
1305
1551
  },
1306
1552
  {
1307
- "kind": "method",
1308
- "name": "handleMenuOptions",
1309
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1310
- "privacy": "private",
1311
- "return": {
1312
- "type": {
1313
- "text": "void"
1314
- }
1315
- }
1553
+ "name": "triggerIcon",
1554
+ "type": {
1555
+ "text": "boolean"
1556
+ },
1557
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1558
+ "fieldName": "triggerIcon"
1316
1559
  },
1317
1560
  {
1318
- "kind": "method",
1319
- "name": "generateOptionsArray",
1320
- "description": "Determines the element error state based on the `required` attribute and input value.",
1321
- "privacy": "private",
1322
- "return": {
1323
- "type": {
1324
- "text": "void"
1325
- }
1326
- }
1561
+ "name": "type",
1562
+ "type": {
1563
+ "text": "string"
1564
+ },
1565
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1566
+ "fieldName": "type"
1327
1567
  },
1328
1568
  {
1329
- "kind": "method",
1330
- "name": "hideBib",
1331
- "description": "Hides the dropdown bib if its open.",
1332
- "return": {
1333
- "type": {
1334
- "text": "void"
1335
- }
1336
- }
1569
+ "name": "typedValue",
1570
+ "type": {
1571
+ "text": "string"
1572
+ },
1573
+ "description": "Specifies the value of the input element within the combobox.",
1574
+ "fieldName": "typedValue"
1337
1575
  },
1338
1576
  {
1339
- "kind": "method",
1340
- "name": "showBib",
1341
- "description": "Shows the dropdown bib if there are options to show.",
1342
- "return": {
1343
- "type": {
1344
- "text": "void"
1345
- }
1346
- }
1577
+ "name": "validity",
1578
+ "type": {
1579
+ "text": "string"
1580
+ },
1581
+ "description": "Specifies the `validityState` this element is in.",
1582
+ "fieldName": "validity"
1347
1583
  },
1348
1584
  {
1349
- "kind": "method",
1350
- "name": "configureDropdown",
1351
- "description": "Binds all behavior needed to the dropdown after rendering.",
1352
- "privacy": "private",
1353
- "return": {
1354
- "type": {
1355
- "text": "void"
1356
- }
1357
- }
1585
+ "name": "value",
1586
+ "type": {
1587
+ "text": "string"
1588
+ },
1589
+ "description": "Value selected for the dropdown menu.",
1590
+ "fieldName": "value"
1358
1591
  },
1359
1592
  {
1360
- "kind": "method",
1361
- "name": "setClearBtnFocus",
1362
- "privacy": "private"
1593
+ "name": "largeFullscreenHeadline",
1594
+ "type": {
1595
+ "text": "boolean"
1596
+ },
1597
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1598
+ "fieldName": "largeFullscreenHeadline"
1363
1599
  },
1364
1600
  {
1365
- "kind": "method",
1366
- "name": "setTriggerInputFocus",
1367
- "privacy": "private"
1601
+ "name": "fullscreenBreakpoint",
1602
+ "type": {
1603
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1604
+ },
1605
+ "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.",
1606
+ "default": "'sm'",
1607
+ "fieldName": "fullscreenBreakpoint"
1368
1608
  },
1369
1609
  {
1370
- "kind": "method",
1371
- "name": "setInputFocus",
1372
- "privacy": "private"
1610
+ "name": "shape",
1611
+ "type": {
1612
+ "text": "string"
1613
+ },
1614
+ "fieldName": "shape",
1615
+ "inheritedFrom": {
1616
+ "name": "AuroElement",
1617
+ "module": "components/layoutElement/src/auroElement.js"
1618
+ }
1619
+ },
1620
+ {
1621
+ "name": "size",
1622
+ "type": {
1623
+ "text": "string"
1624
+ },
1625
+ "fieldName": "size",
1626
+ "inheritedFrom": {
1627
+ "name": "AuroElement",
1628
+ "module": "components/layoutElement/src/auroElement.js"
1629
+ }
1373
1630
  },
1374
1631
  {
1375
- "kind": "method",
1376
- "name": "updateBibDialogRole",
1377
- "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.",
1378
- "privacy": "private"
1632
+ "name": "ondark",
1633
+ "type": {
1634
+ "text": "boolean"
1635
+ },
1636
+ "fieldName": "onDark",
1637
+ "inheritedFrom": {
1638
+ "name": "AuroElement",
1639
+ "module": "components/layoutElement/src/auroElement.js"
1640
+ }
1641
+ }
1642
+ ],
1643
+ "superclass": {
1644
+ "name": "AuroElement",
1645
+ "module": "/components/layoutElement/src/auroElement.js"
1646
+ },
1647
+ "tagName": "auro-combobox",
1648
+ "customElement": true
1649
+ }
1650
+ ],
1651
+ "exports": [
1652
+ {
1653
+ "kind": "js",
1654
+ "name": "AuroCombobox",
1655
+ "declaration": {
1656
+ "name": "AuroCombobox",
1657
+ "module": "components/combobox/src/auro-combobox.js"
1658
+ }
1659
+ }
1660
+ ]
1661
+ },
1662
+ {
1663
+ "kind": "javascript-module",
1664
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1665
+ "declarations": [
1666
+ {
1667
+ "kind": "variable",
1668
+ "name": "comboboxKeyboardStrategy",
1669
+ "type": {
1670
+ "text": "object"
1671
+ },
1672
+ "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'down'); } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'up'); } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { // Forms should not submit on Enter from a combobox, regardless of which // child element (input, clear button, menu) is focused. evt.stopPropagation(); if (isClearBtnFocused(ctx)) { // Let the browser dispatch Enter to the focused clear button so its // built-in activation fires and clears the selection. Do NOT call // preventDefault — that would block the activation. return; } if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); } else { evt.preventDefault(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } } }"
1673
+ }
1674
+ ],
1675
+ "exports": [
1676
+ {
1677
+ "kind": "js",
1678
+ "name": "comboboxKeyboardStrategy",
1679
+ "declaration": {
1680
+ "name": "comboboxKeyboardStrategy",
1681
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1682
+ }
1683
+ }
1684
+ ]
1685
+ },
1686
+ {
1687
+ "kind": "javascript-module",
1688
+ "path": "components/combobox/src/index.js",
1689
+ "declarations": [],
1690
+ "exports": [
1691
+ {
1692
+ "kind": "js",
1693
+ "name": "AuroCombobox",
1694
+ "declaration": {
1695
+ "name": "AuroCombobox",
1696
+ "module": "components/combobox/src/index.js"
1697
+ }
1698
+ }
1699
+ ]
1700
+ },
1701
+ {
1702
+ "kind": "javascript-module",
1703
+ "path": "components/combobox/src/registered.js",
1704
+ "declarations": [],
1705
+ "exports": [
1706
+ {
1707
+ "kind": "js",
1708
+ "name": "AuroCombobox",
1709
+ "declaration": {
1710
+ "name": "AuroCombobox",
1711
+ "module": "components/combobox/src/registered.js"
1712
+ }
1713
+ }
1714
+ ]
1715
+ },
1716
+ {
1717
+ "kind": "javascript-module",
1718
+ "path": "components/checkbox/src/auro-checkbox-group.js",
1719
+ "declarations": [
1720
+ {
1721
+ "kind": "class",
1722
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1723
+ "name": "AuroCheckboxGroup",
1724
+ "slots": [
1725
+ {
1726
+ "description": "Allows for the legend to be overridden.",
1727
+ "name": "legend"
1379
1728
  },
1380
1729
  {
1381
- "kind": "method",
1382
- "name": "updateMenuShapeSize",
1383
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1384
- "privacy": "private"
1730
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1731
+ "name": "optionalLabel"
1385
1732
  },
1386
1733
  {
1387
- "kind": "method",
1388
- "name": "_getAnnouncementRoot",
1389
- "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.",
1390
- "privacy": "private",
1391
- "return": {
1392
- "type": {
1393
- "text": "ShadowRoot"
1394
- }
1395
- }
1734
+ "description": "Allows for the helper text to be overridden.",
1735
+ "name": "helpText"
1396
1736
  },
1397
1737
  {
1398
- "kind": "method",
1399
- "name": "configureMenu",
1400
- "description": "Binds all behavior needed to the menu after rendering.",
1401
- "privacy": "private",
1402
- "return": {
1403
- "type": {
1404
- "text": "void"
1405
- }
1406
- }
1407
- },
1738
+ "description": "The default slot for the checkbox items.",
1739
+ "name": "default"
1740
+ }
1741
+ ],
1742
+ "members": [
1408
1743
  {
1409
1744
  "kind": "method",
1410
- "name": "configureInput",
1411
- "description": "Binds all behavior needed to the input after rendering.",
1412
- "privacy": "private",
1413
- "return": {
1414
- "type": {
1415
- "text": "void"
1416
- }
1417
- }
1745
+ "name": "_initializeDefaults"
1418
1746
  },
1419
1747
  {
1420
1748
  "kind": "method",
1421
- "name": "handleMenuLoadingChange",
1749
+ "name": "register",
1750
+ "static": true,
1422
1751
  "parameters": [
1423
1752
  {
1424
- "name": "event",
1425
- "description": "The event object containing details about the loading state change.",
1426
- "type": {
1427
- "text": "CustomEvent"
1428
- }
1429
- },
1430
- {
1431
- "description": "Indicates whether the menu is currently loading.",
1432
- "name": "event.detail.loading",
1433
- "type": {
1434
- "text": "boolean"
1435
- }
1436
- },
1437
- {
1438
- "description": "Indicates if there are loading placeholders present.",
1439
- "name": "event.detail.hasLoadingPlaceholder",
1753
+ "name": "name",
1754
+ "default": "\"auro-checkbox-group\"",
1755
+ "description": "The name of the element that you want to register.",
1756
+ "optional": true,
1440
1757
  "type": {
1441
- "text": "boolean"
1758
+ "text": "string"
1442
1759
  }
1443
1760
  }
1444
1761
  ],
1445
- "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.",
1446
- "privacy": "private",
1447
- "return": {
1448
- "type": {
1449
- "text": "void"
1450
- }
1451
- }
1762
+ "description": "This will register this element with the browser."
1452
1763
  },
1453
1764
  {
1454
1765
  "kind": "method",
1455
- "name": "handleInputValueChange",
1766
+ "name": "handleValueUpdate",
1456
1767
  "parameters": [
1457
1768
  {
1458
- "name": "event",
1459
- "description": "The input event triggered by the input element.",
1769
+ "name": "value",
1770
+ "description": "The value of the checkbox.",
1460
1771
  "type": {
1461
- "text": "Event"
1772
+ "text": "String"
1462
1773
  }
1463
- }
1464
- ],
1465
- "description": "Handle changes to the input value and trigger changes that should result.",
1466
- "privacy": "private",
1467
- "return": {
1468
- "type": {
1469
- "text": "void"
1470
- }
1471
- }
1472
- },
1473
- {
1474
- "kind": "method",
1475
- "name": "handleTriggerInputValueChange",
1476
- "parameters": [
1774
+ },
1477
1775
  {
1478
- "name": "event",
1479
- "description": "The input event from the trigger input element.",
1776
+ "name": "selected",
1777
+ "description": "The checked state of the checkbox.",
1480
1778
  "type": {
1481
- "text": "Event"
1779
+ "text": "Boolean"
1482
1780
  }
1483
1781
  }
1484
1782
  ],
1485
- "description": "Handles input value changes originating from the trigger input.\nRefreshes menu options and filtering, delegates to handleInputValueChange\nfor value synchronization, and manages fullscreen bib focus.",
1783
+ "description": "Helper method to handle checkbox value changing.",
1486
1784
  "privacy": "private",
1487
1785
  "return": {
1488
1786
  "type": {
@@ -1492,8 +1790,8 @@
1492
1790
  },
1493
1791
  {
1494
1792
  "kind": "method",
1495
- "name": "configureCombobox",
1496
- "description": "Binds all behavior needed to the combobox after rendering.",
1793
+ "name": "handlePreselectedItems",
1794
+ "description": "Helper method that handles the state of preselected checkboxes.",
1497
1795
  "privacy": "private",
1498
1796
  "return": {
1499
1797
  "type": {
@@ -1503,96 +1801,8 @@
1503
1801
  },
1504
1802
  {
1505
1803
  "kind": "method",
1506
- "name": "focus",
1507
- "description": "Focuses the combobox trigger input.",
1508
- "return": {
1509
- "type": {
1510
- "text": "void"
1511
- }
1512
- }
1513
- },
1514
- {
1515
- "kind": "method",
1516
- "name": "setMenuValue",
1517
- "parameters": [
1518
- {
1519
- "name": "value",
1520
- "description": "The value to set on the menu.",
1521
- "type": {
1522
- "text": "string"
1523
- }
1524
- }
1525
- ],
1526
- "description": "Sets the menu value if menu is available.",
1527
- "return": {
1528
- "type": {
1529
- "text": "void"
1530
- }
1531
- }
1532
- },
1533
- {
1534
- "kind": "method",
1535
- "name": "reset",
1536
- "description": "Resets component to initial state.",
1537
- "return": {
1538
- "type": {
1539
- "text": "void"
1540
- }
1541
- }
1542
- },
1543
- {
1544
- "kind": "method",
1545
- "name": "clear",
1546
- "description": "Clears the current value of the combobox.",
1547
- "return": {
1548
- "type": {
1549
- "text": "void"
1550
- }
1551
- }
1552
- },
1553
- {
1554
- "kind": "method",
1555
- "name": "validate",
1556
- "parameters": [
1557
- {
1558
- "name": "force",
1559
- "default": "false",
1560
- "description": "Whether to force validation.",
1561
- "optional": true,
1562
- "type": {
1563
- "text": "boolean"
1564
- }
1565
- }
1566
- ],
1567
- "description": "Validates value."
1568
- },
1569
- {
1570
- "kind": "method",
1571
- "name": "transportAssignedNodes",
1572
- "parameters": [
1573
- {
1574
- "name": "slot",
1575
- "description": "The slot element containing the nodes to apply.",
1576
- "type": {
1577
- "text": "HTMLSlotElement"
1578
- }
1579
- },
1580
- {
1581
- "name": "target",
1582
- "description": "The target element to apply the nodes to.",
1583
- "type": {
1584
- "text": "HTMLElement"
1585
- }
1586
- },
1587
- {
1588
- "name": "newSlotName",
1589
- "description": "The new slot name for the applied nodes.",
1590
- "type": {
1591
- "text": "string"
1592
- }
1593
- }
1594
- ],
1595
- "description": "Applies slotted nodes to a target element with a new slot name.",
1804
+ "name": "handleItems",
1805
+ "description": "Helper method that handles the state of checkboxes.",
1596
1806
  "privacy": "private",
1597
1807
  "return": {
1598
1808
  "type": {
@@ -1602,105 +1812,42 @@
1602
1812
  },
1603
1813
  {
1604
1814
  "kind": "method",
1605
- "name": "updateActiveOption",
1606
- "parameters": [
1607
- {
1608
- "name": "index",
1609
- "description": "Index of the option to make active.",
1610
- "type": {
1611
- "text": "number"
1612
- }
1815
+ "name": "reset",
1816
+ "description": "Resets component to initial state.",
1817
+ "return": {
1818
+ "type": {
1819
+ "text": "void"
1613
1820
  }
1614
- ],
1615
- "description": "Updates the active option in the menu."
1821
+ }
1616
1822
  },
1617
1823
  {
1618
1824
  "kind": "method",
1619
- "name": "handleSlotChange",
1825
+ "name": "validate",
1620
1826
  "parameters": [
1621
1827
  {
1622
- "name": "event",
1623
- "description": "`slotchange` event.",
1828
+ "name": "force",
1829
+ "default": "false",
1830
+ "description": "Whether to force validation.",
1831
+ "optional": true,
1624
1832
  "type": {
1625
- "text": "Event"
1833
+ "text": "boolean"
1626
1834
  }
1627
1835
  }
1628
1836
  ],
1629
- "description": "Watch for slot changes and recalculate the menuoptions.",
1630
- "privacy": "private",
1631
- "return": {
1632
- "type": {
1633
- "text": "void"
1634
- }
1635
- }
1837
+ "description": "Validates value."
1636
1838
  },
1637
1839
  {
1638
1840
  "kind": "field",
1639
1841
  "name": "appearance",
1640
1842
  "privacy": "public",
1641
1843
  "type": {
1642
- "text": "string"
1844
+ "text": "'default' | 'inverse'"
1643
1845
  },
1644
1846
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
1645
1847
  "default": "'default'",
1646
1848
  "attribute": "appearance",
1647
1849
  "reflects": true
1648
1850
  },
1649
- {
1650
- "kind": "field",
1651
- "name": "autocomplete",
1652
- "privacy": "public",
1653
- "type": {
1654
- "text": "string"
1655
- },
1656
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1657
- "attribute": "autocomplete",
1658
- "reflects": true
1659
- },
1660
- {
1661
- "kind": "field",
1662
- "name": "autoPlacement",
1663
- "privacy": "public",
1664
- "type": {
1665
- "text": "boolean"
1666
- },
1667
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1668
- "attribute": "autoPlacement",
1669
- "reflects": true
1670
- },
1671
- {
1672
- "kind": "field",
1673
- "name": "availableOptions",
1674
- "privacy": "private",
1675
- "type": {
1676
- "text": "array"
1677
- },
1678
- "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).",
1679
- "attribute": "availableOptions"
1680
- },
1681
- {
1682
- "kind": "field",
1683
- "name": "behavior",
1684
- "privacy": "public",
1685
- "type": {
1686
- "text": "'filter' | 'suggestion'"
1687
- },
1688
- "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.",
1689
- "default": "'suggestion'",
1690
- "attribute": "behavior",
1691
- "reflects": true
1692
- },
1693
- {
1694
- "kind": "field",
1695
- "name": "checkmark",
1696
- "privacy": "public",
1697
- "type": {
1698
- "text": "boolean"
1699
- },
1700
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1701
- "attribute": "checkmark",
1702
- "reflects": true
1703
- },
1704
1851
  {
1705
1852
  "kind": "field",
1706
1853
  "name": "disabled",
@@ -1708,39 +1855,10 @@
1708
1855
  "type": {
1709
1856
  "text": "boolean"
1710
1857
  },
1711
- "description": "If set, disables the combobox.",
1858
+ "description": "If set, disables the checkbox group.",
1712
1859
  "attribute": "disabled",
1713
1860
  "reflects": true
1714
1861
  },
1715
- {
1716
- "kind": "field",
1717
- "name": "dropdownId",
1718
- "privacy": "private",
1719
- "type": {
1720
- "text": "string"
1721
- },
1722
- "description": "ID for the dropdown."
1723
- },
1724
- {
1725
- "kind": "field",
1726
- "name": "dropdownOpen",
1727
- "privacy": "private",
1728
- "type": {
1729
- "text": "boolean"
1730
- },
1731
- "description": "Whether or not the dropdown is open."
1732
- },
1733
- {
1734
- "kind": "field",
1735
- "name": "dvInputOnly",
1736
- "privacy": "public",
1737
- "type": {
1738
- "text": "boolean"
1739
- },
1740
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1741
- "attribute": "dvInputOnly",
1742
- "reflects": true
1743
- },
1744
1862
  {
1745
1863
  "kind": "field",
1746
1864
  "name": "error",
@@ -1754,807 +1872,689 @@
1754
1872
  },
1755
1873
  {
1756
1874
  "kind": "field",
1757
- "name": "format",
1758
- "privacy": "public",
1759
- "type": {
1760
- "text": "string"
1761
- },
1762
- "description": "Specifies the input mask format.",
1763
- "attribute": "format",
1764
- "reflects": true
1765
- },
1766
- {
1767
- "kind": "field",
1768
- "name": "inputmode",
1769
- "privacy": "public",
1770
- "type": {
1771
- "text": "string"
1772
- },
1773
- "description": "Exposes inputmode attribute for input.",
1774
- "attribute": "inputmode",
1775
- "reflects": true
1776
- },
1777
- {
1778
- "kind": "field",
1779
- "name": "layout",
1780
- "privacy": "public",
1781
- "type": {
1782
- "text": "string"
1783
- },
1784
- "description": "Sets the layout of the combobox.",
1785
- "default": "'classic'",
1786
- "attribute": "layout",
1787
- "reflects": true,
1788
- "inheritedFrom": {
1789
- "name": "AuroElement",
1790
- "module": "components/layoutElement/src/auroElement.js"
1791
- }
1792
- },
1793
- {
1794
- "kind": "field",
1795
- "name": "matchWidth",
1796
- "privacy": "private",
1797
- "type": {
1798
- "text": "boolean"
1799
- },
1800
- "description": "If declared, the popover and trigger will be set to the same width.",
1801
- "attribute": "matchWidth",
1802
- "reflects": true
1803
- },
1804
- {
1805
- "kind": "field",
1806
- "name": "noFilter",
1875
+ "name": "horizontal",
1807
1876
  "privacy": "public",
1808
1877
  "type": {
1809
1878
  "text": "boolean"
1810
1879
  },
1811
- "description": "If set, combobox will not filter menuoptions based on input.",
1812
- "attribute": "noFilter",
1880
+ "description": "If set, checkboxes will be aligned horizontally.",
1881
+ "attribute": "horizontal",
1813
1882
  "reflects": true
1814
1883
  },
1815
1884
  {
1816
1885
  "kind": "field",
1817
- "name": "noFlip",
1886
+ "name": "noValidate",
1818
1887
  "privacy": "public",
1819
1888
  "type": {
1820
1889
  "text": "boolean"
1821
1890
  },
1822
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1823
- "attribute": "noFlip",
1891
+ "description": "If set, disables auto-validation on blur.",
1892
+ "attribute": "noValidate",
1824
1893
  "reflects": true
1825
1894
  },
1826
1895
  {
1827
1896
  "kind": "field",
1828
- "name": "shift",
1897
+ "name": "onDark",
1829
1898
  "privacy": "public",
1830
1899
  "type": {
1831
1900
  "text": "boolean"
1832
1901
  },
1833
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1834
- "attribute": "shift",
1902
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1903
+ "attribute": "onDark",
1835
1904
  "reflects": true
1836
1905
  },
1837
1906
  {
1838
1907
  "kind": "field",
1839
- "name": "noValidate",
1908
+ "name": "required",
1840
1909
  "privacy": "public",
1841
1910
  "type": {
1842
1911
  "text": "boolean"
1843
1912
  },
1844
- "description": "If set, disables auto-validation on blur.",
1845
- "attribute": "noValidate",
1913
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1914
+ "attribute": "required",
1846
1915
  "reflects": true
1847
1916
  },
1848
1917
  {
1849
1918
  "kind": "field",
1850
- "name": "offset",
1919
+ "name": "setCustomValidity",
1851
1920
  "privacy": "public",
1852
1921
  "type": {
1853
- "text": "number"
1922
+ "text": "string"
1854
1923
  },
1855
- "description": "Gap between the trigger element and bib.",
1856
- "default": "0",
1857
- "attribute": "offset",
1858
- "reflects": true
1924
+ "description": "Sets a custom help text message to display for all validityStates.",
1925
+ "attribute": "setCustomValidity"
1859
1926
  },
1860
1927
  {
1861
1928
  "kind": "field",
1862
- "name": "onDark",
1929
+ "name": "setCustomValidityCustomError",
1863
1930
  "privacy": "public",
1864
1931
  "type": {
1865
- "text": "boolean"
1932
+ "text": "string"
1866
1933
  },
1867
- "attribute": "onDark",
1868
- "reflects": true,
1869
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1870
- "inheritedFrom": {
1871
- "name": "AuroElement",
1872
- "module": "components/layoutElement/src/auroElement.js"
1873
- }
1934
+ "description": "Custom help text message to display when validity = `customError`.",
1935
+ "attribute": "setCustomValidityCustomError"
1874
1936
  },
1875
1937
  {
1876
1938
  "kind": "field",
1877
- "name": "optionSelected",
1939
+ "name": "setCustomValidityValueMissing",
1878
1940
  "privacy": "public",
1879
1941
  "type": {
1880
- "text": "HTMLElement"
1942
+ "text": "string"
1881
1943
  },
1882
- "description": "Specifies the current selected option.",
1883
- "attribute": "optionSelected"
1944
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1945
+ "attribute": "setCustomValidityValueMissing"
1884
1946
  },
1885
1947
  {
1886
1948
  "kind": "field",
1887
- "name": "persistInput",
1949
+ "name": "validity",
1888
1950
  "privacy": "public",
1889
1951
  "type": {
1890
- "text": "boolean"
1952
+ "text": "string"
1891
1953
  },
1892
- "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.",
1893
- "attribute": "persistInput",
1954
+ "description": "Specifies the `validityState` this element is in.",
1955
+ "attribute": "validity",
1894
1956
  "reflects": true
1895
- },
1957
+ }
1958
+ ],
1959
+ "events": [
1896
1960
  {
1897
- "kind": "field",
1898
- "name": "placement",
1899
- "privacy": "public",
1961
+ "name": "input",
1900
1962
  "type": {
1901
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1902
- },
1903
- "description": "Position where the bib should appear relative to the trigger.",
1904
- "default": "'bottom-start'",
1905
- "attribute": "placement",
1906
- "reflects": true
1963
+ "text": "CustomEvent"
1964
+ }
1907
1965
  },
1908
1966
  {
1909
- "kind": "field",
1910
- "name": "placeholder",
1911
- "privacy": "public",
1967
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1968
+ "name": "auroFormElement-validated"
1969
+ }
1970
+ ],
1971
+ "attributes": [
1972
+ {
1973
+ "name": "appearance",
1912
1974
  "type": {
1913
- "text": "string"
1975
+ "text": "'default' | 'inverse'"
1914
1976
  },
1915
- "description": "Define custom placeholder text, only supported by date input formats.",
1916
- "attribute": "placeholder",
1917
- "reflects": true
1977
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1978
+ "default": "'default'",
1979
+ "fieldName": "appearance"
1918
1980
  },
1919
1981
  {
1920
- "kind": "field",
1921
- "name": "required",
1922
- "privacy": "public",
1982
+ "name": "disabled",
1923
1983
  "type": {
1924
1984
  "text": "boolean"
1925
1985
  },
1926
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1927
- "attribute": "required",
1928
- "reflects": true
1986
+ "description": "If set, disables the checkbox group.",
1987
+ "fieldName": "disabled"
1929
1988
  },
1930
1989
  {
1931
- "kind": "field",
1932
- "name": "setCustomValidity",
1933
- "privacy": "public",
1990
+ "name": "error",
1934
1991
  "type": {
1935
1992
  "text": "string"
1936
1993
  },
1937
- "description": "Sets a custom help text message to display for all validityStates.",
1938
- "attribute": "setCustomValidity"
1994
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1995
+ "fieldName": "error"
1939
1996
  },
1940
1997
  {
1941
- "kind": "field",
1942
- "name": "setCustomValidityCustomError",
1943
- "privacy": "public",
1998
+ "name": "horizontal",
1944
1999
  "type": {
1945
- "text": "string"
2000
+ "text": "boolean"
1946
2001
  },
1947
- "description": "Custom help text message to display when validity = `customError`.",
1948
- "attribute": "setCustomValidityCustomError"
2002
+ "description": "If set, checkboxes will be aligned horizontally.",
2003
+ "fieldName": "horizontal"
1949
2004
  },
1950
2005
  {
1951
- "kind": "field",
1952
- "name": "setCustomValidityValueMissing",
1953
- "privacy": "public",
2006
+ "name": "noValidate",
1954
2007
  "type": {
1955
- "text": "string"
2008
+ "text": "boolean"
1956
2009
  },
1957
- "description": "Custom help text message to display when validity = `valueMissing`.",
1958
- "attribute": "setCustomValidityValueMissing"
2010
+ "description": "If set, disables auto-validation on blur.",
2011
+ "fieldName": "noValidate"
1959
2012
  },
1960
2013
  {
1961
- "kind": "field",
1962
- "name": "setCustomValidityValueMissingFilter",
1963
- "privacy": "public",
2014
+ "name": "onDark",
1964
2015
  "type": {
1965
- "text": "string"
2016
+ "text": "boolean"
1966
2017
  },
1967
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1968
- "attribute": "setCustomValidityValueMissingFilter"
2018
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2019
+ "fieldName": "onDark"
1969
2020
  },
1970
2021
  {
1971
- "kind": "field",
1972
- "name": "touched",
1973
- "privacy": "private",
2022
+ "name": "required",
1974
2023
  "type": {
1975
2024
  "text": "boolean"
1976
2025
  },
1977
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
2026
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
2027
+ "fieldName": "required"
1978
2028
  },
1979
2029
  {
1980
- "kind": "field",
1981
- "name": "triggerIcon",
1982
- "privacy": "public",
2030
+ "name": "setCustomValidity",
1983
2031
  "type": {
1984
- "text": "boolean"
2032
+ "text": "string"
1985
2033
  },
1986
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1987
- "attribute": "triggerIcon",
1988
- "reflects": true
2034
+ "description": "Sets a custom help text message to display for all validityStates.",
2035
+ "fieldName": "setCustomValidity"
1989
2036
  },
1990
2037
  {
1991
- "kind": "field",
1992
- "name": "type",
1993
- "privacy": "public",
2038
+ "name": "setCustomValidityCustomError",
1994
2039
  "type": {
1995
2040
  "text": "string"
1996
2041
  },
1997
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1998
- "attribute": "type",
1999
- "reflects": true
2042
+ "description": "Custom help text message to display when validity = `customError`.",
2043
+ "fieldName": "setCustomValidityCustomError"
2000
2044
  },
2001
2045
  {
2002
- "kind": "field",
2003
- "name": "typedValue",
2004
- "privacy": "public",
2046
+ "name": "setCustomValidityValueMissing",
2005
2047
  "type": {
2006
2048
  "text": "string"
2007
2049
  },
2008
- "description": "Specifies the value of the input element within the combobox.",
2009
- "attribute": "typedValue",
2010
- "reflects": true
2050
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2051
+ "fieldName": "setCustomValidityValueMissing"
2011
2052
  },
2012
2053
  {
2013
- "kind": "field",
2014
2054
  "name": "validity",
2015
- "privacy": "public",
2016
2055
  "type": {
2017
2056
  "text": "string"
2018
2057
  },
2019
2058
  "description": "Specifies the `validityState` this element is in.",
2020
- "attribute": "validity",
2021
- "reflects": true
2059
+ "fieldName": "validity"
2060
+ }
2061
+ ],
2062
+ "superclass": {
2063
+ "name": "LitElement",
2064
+ "package": "lit"
2065
+ },
2066
+ "tagName": "auro-checkbox-group",
2067
+ "customElement": true
2068
+ }
2069
+ ],
2070
+ "exports": [
2071
+ {
2072
+ "kind": "js",
2073
+ "name": "AuroCheckboxGroup",
2074
+ "declaration": {
2075
+ "name": "AuroCheckboxGroup",
2076
+ "module": "components/checkbox/src/auro-checkbox-group.js"
2077
+ }
2078
+ }
2079
+ ]
2080
+ },
2081
+ {
2082
+ "kind": "javascript-module",
2083
+ "path": "components/checkbox/src/auro-checkbox.js",
2084
+ "declarations": [
2085
+ {
2086
+ "kind": "class",
2087
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2088
+ "name": "AuroCheckbox",
2089
+ "cssParts": [
2090
+ {
2091
+ "description": "apply css to a specific checkbox.",
2092
+ "name": "checkbox"
2022
2093
  },
2023
2094
  {
2024
- "kind": "field",
2025
- "name": "value",
2026
- "privacy": "public",
2027
- "type": {
2028
- "text": "string"
2029
- },
2030
- "description": "Value selected for the dropdown menu.",
2031
- "attribute": "value"
2095
+ "description": "apply css to a specific checkbox's input.",
2096
+ "name": "checkbox-input"
2032
2097
  },
2033
2098
  {
2034
- "kind": "field",
2035
- "name": "largeFullscreenHeadline",
2036
- "privacy": "public",
2037
- "type": {
2038
- "text": "boolean"
2039
- },
2040
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2041
- "attribute": "largeFullscreenHeadline",
2042
- "reflects": true
2099
+ "description": "apply css to a specific checkbox's label.",
2100
+ "name": "checkbox-label"
2101
+ }
2102
+ ],
2103
+ "slots": [
2104
+ {
2105
+ "description": "The default slot for the checkbox label.",
2106
+ "name": "default"
2107
+ }
2108
+ ],
2109
+ "members": [
2110
+ {
2111
+ "kind": "method",
2112
+ "name": "_initializeDefaults"
2043
2113
  },
2044
2114
  {
2045
- "kind": "field",
2046
- "name": "fullscreenBreakpoint",
2047
- "privacy": "public",
2048
- "type": {
2049
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2050
- },
2051
- "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.",
2052
- "default": "'sm'",
2053
- "attribute": "fullscreenBreakpoint",
2054
- "reflects": true
2115
+ "kind": "method",
2116
+ "name": "register",
2117
+ "static": true,
2118
+ "parameters": [
2119
+ {
2120
+ "name": "name",
2121
+ "default": "\"auro-checkbox\"",
2122
+ "description": "The name of element that you want to register to.",
2123
+ "optional": true,
2124
+ "type": {
2125
+ "text": "string"
2126
+ }
2127
+ }
2128
+ ],
2129
+ "description": "This will register this element with the browser."
2055
2130
  },
2056
2131
  {
2057
- "kind": "field",
2058
- "name": "optionActive",
2132
+ "kind": "method",
2133
+ "name": "handleChange",
2134
+ "parameters": [
2135
+ {
2136
+ "name": "event",
2137
+ "description": "The change event from the checkbox input.",
2138
+ "type": {
2139
+ "text": "Event"
2140
+ }
2141
+ }
2142
+ ],
2143
+ "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.",
2059
2144
  "privacy": "private",
2060
- "type": {
2061
- "text": "object"
2062
- },
2063
- "description": "Specifies the currently active option."
2145
+ "return": {
2146
+ "type": {
2147
+ "text": "void"
2148
+ }
2149
+ }
2064
2150
  },
2065
2151
  {
2066
- "kind": "field",
2067
- "name": "componentHasFocus",
2068
- "description": "Returns true if the element has focus.",
2152
+ "kind": "method",
2153
+ "name": "handleInput",
2154
+ "parameters": [
2155
+ {
2156
+ "name": "event",
2157
+ "description": "The input event from the checkbox input.",
2158
+ "type": {
2159
+ "text": "Event"
2160
+ }
2161
+ }
2162
+ ],
2163
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2069
2164
  "privacy": "private",
2070
2165
  "return": {
2071
2166
  "type": {
2072
- "text": "boolean"
2167
+ "text": "void"
2073
2168
  }
2074
- },
2075
- "readonly": true,
2076
- "inheritedFrom": {
2077
- "name": "AuroElement",
2078
- "module": "components/layoutElement/src/auroElement.js"
2079
2169
  }
2080
2170
  },
2081
2171
  {
2082
2172
  "kind": "method",
2083
- "name": "resetShapeClasses",
2084
- "inheritedFrom": {
2085
- "name": "AuroElement",
2086
- "module": "components/layoutElement/src/auroElement.js"
2173
+ "name": "handleFocusin",
2174
+ "description": "Function to support",
2175
+ "privacy": "private",
2176
+ "return": {
2177
+ "type": {
2178
+ "text": "void"
2179
+ }
2087
2180
  }
2088
2181
  },
2089
2182
  {
2090
2183
  "kind": "method",
2091
- "name": "resetLayoutClasses",
2092
- "inheritedFrom": {
2093
- "name": "AuroElement",
2094
- "module": "components/layoutElement/src/auroElement.js"
2184
+ "name": "generateIconHtml",
2185
+ "description": "Function to generate checkmark svg.",
2186
+ "privacy": "private",
2187
+ "return": {
2188
+ "type": {
2189
+ "text": "HTMLElement"
2190
+ }
2095
2191
  }
2096
2192
  },
2097
2193
  {
2098
2194
  "kind": "method",
2099
- "name": "updateComponentArchitecture",
2100
- "inheritedFrom": {
2101
- "name": "AuroElement",
2102
- "module": "components/layoutElement/src/auroElement.js"
2195
+ "name": "reset",
2196
+ "description": "Resets component to initial state.",
2197
+ "return": {
2198
+ "type": {
2199
+ "text": "void"
2200
+ }
2103
2201
  }
2104
2202
  },
2105
2203
  {
2106
- "kind": "field",
2107
- "name": "shape",
2108
- "privacy": "public",
2109
- "type": {
2110
- "text": "string"
2111
- },
2112
- "attribute": "shape",
2113
- "reflects": true,
2114
- "inheritedFrom": {
2115
- "name": "AuroElement",
2116
- "module": "components/layoutElement/src/auroElement.js"
2204
+ "kind": "method",
2205
+ "name": "updateAriaLabel",
2206
+ "description": "Updates the aria-label based on slot content.",
2207
+ "privacy": "private",
2208
+ "return": {
2209
+ "type": {
2210
+ "text": "void"
2211
+ }
2117
2212
  }
2118
2213
  },
2119
2214
  {
2120
- "kind": "field",
2121
- "name": "size",
2122
- "privacy": "public",
2123
- "type": {
2124
- "text": "string"
2125
- },
2126
- "attribute": "size",
2127
- "reflects": true,
2128
- "inheritedFrom": {
2129
- "name": "AuroElement",
2130
- "module": "components/layoutElement/src/auroElement.js"
2215
+ "kind": "method",
2216
+ "name": "handleKeyDown",
2217
+ "parameters": [
2218
+ {
2219
+ "name": "event",
2220
+ "description": "The keydown event from the checkbox input.",
2221
+ "type": {
2222
+ "text": "KeyboardEvent"
2223
+ }
2224
+ }
2225
+ ],
2226
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
2227
+ "privacy": "private",
2228
+ "return": {
2229
+ "type": {
2230
+ "text": "void"
2231
+ }
2131
2232
  }
2132
- }
2133
- ],
2134
- "events": [
2135
- {
2136
- "name": "inputValue",
2137
- "type": {
2138
- "text": "CustomEvent"
2139
- },
2140
- "description": "Notifies that the components internal HTML5 input value has changed."
2141
- },
2142
- {
2143
- "name": "input",
2144
- "type": {
2145
- "text": "CustomEvent"
2146
- },
2147
- "description": "Notifies that the component has a new value set."
2148
- },
2149
- {
2150
- "name": "auroCombobox-valueSet",
2151
- "type": {
2152
- "text": "CustomEvent"
2153
- },
2154
- "description": "(Deprecated) Notifies that the component has a new value set."
2155
2233
  },
2156
2234
  {
2157
- "description": "Notifies that the component value(s) have been validated.",
2158
- "name": "auroFormElement-validated"
2159
- }
2160
- ],
2161
- "attributes": [
2162
- {
2235
+ "kind": "field",
2163
2236
  "name": "appearance",
2237
+ "privacy": "public",
2164
2238
  "type": {
2165
- "text": "string"
2239
+ "text": "'default' | 'inverse'"
2166
2240
  },
2167
2241
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
2168
2242
  "default": "'default'",
2169
- "fieldName": "appearance"
2170
- },
2171
- {
2172
- "name": "autocomplete",
2173
- "type": {
2174
- "text": "string"
2175
- },
2176
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2177
- "fieldName": "autocomplete"
2178
- },
2179
- {
2180
- "name": "autoPlacement",
2181
- "type": {
2182
- "text": "boolean"
2183
- },
2184
- "description": "If declared, bib's position will be automatically calculated where to appear.",
2185
- "fieldName": "autoPlacement"
2186
- },
2187
- {
2188
- "name": "availableOptions",
2189
- "type": {
2190
- "text": "array"
2191
- },
2192
- "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).",
2193
- "fieldName": "availableOptions"
2194
- },
2195
- {
2196
- "name": "behavior",
2197
- "type": {
2198
- "text": "'filter' | 'suggestion'"
2199
- },
2200
- "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.",
2201
- "default": "'suggestion'",
2202
- "fieldName": "behavior"
2243
+ "attribute": "appearance",
2244
+ "reflects": true
2203
2245
  },
2204
2246
  {
2205
- "name": "checkmark",
2247
+ "kind": "field",
2248
+ "name": "checked",
2249
+ "privacy": "public",
2206
2250
  "type": {
2207
2251
  "text": "boolean"
2208
2252
  },
2209
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
2210
- "fieldName": "checkmark"
2253
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2254
+ "attribute": "checked",
2255
+ "reflects": true
2211
2256
  },
2212
2257
  {
2258
+ "kind": "field",
2213
2259
  "name": "disabled",
2260
+ "privacy": "public",
2214
2261
  "type": {
2215
2262
  "text": "boolean"
2216
2263
  },
2217
- "description": "If set, disables the combobox.",
2218
- "fieldName": "disabled"
2219
- },
2220
- {
2221
- "name": "dvInputOnly",
2222
- "type": {
2223
- "text": "boolean"
2224
- },
2225
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2226
- "fieldName": "dvInputOnly"
2264
+ "description": "If set to true, the checkbox will not be clickable.",
2265
+ "attribute": "disabled",
2266
+ "reflects": true
2227
2267
  },
2228
2268
  {
2269
+ "kind": "field",
2229
2270
  "name": "error",
2271
+ "privacy": "public",
2230
2272
  "type": {
2231
- "text": "string"
2273
+ "text": "boolean"
2232
2274
  },
2233
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2234
- "fieldName": "error"
2275
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2276
+ "attribute": "error",
2277
+ "reflects": true
2235
2278
  },
2236
2279
  {
2237
- "name": "format",
2280
+ "kind": "field",
2281
+ "name": "id",
2282
+ "privacy": "public",
2238
2283
  "type": {
2239
2284
  "text": "string"
2240
2285
  },
2241
- "description": "Specifies the input mask format.",
2242
- "fieldName": "format"
2286
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2287
+ "attribute": "id",
2288
+ "reflects": true
2243
2289
  },
2244
2290
  {
2245
- "name": "inputmode",
2291
+ "kind": "field",
2292
+ "name": "inputId",
2293
+ "privacy": "private",
2246
2294
  "type": {
2247
2295
  "text": "string"
2248
2296
  },
2249
- "description": "Exposes inputmode attribute for input.",
2250
- "fieldName": "inputmode"
2297
+ "description": "The id for input node."
2251
2298
  },
2252
2299
  {
2253
- "name": "layout",
2300
+ "kind": "field",
2301
+ "name": "name",
2302
+ "privacy": "public",
2254
2303
  "type": {
2255
2304
  "text": "string"
2256
2305
  },
2257
- "description": "Sets the layout of the combobox.",
2258
- "default": "'classic'",
2259
- "fieldName": "layout",
2260
- "inheritedFrom": {
2261
- "name": "AuroElement",
2262
- "module": "components/layoutElement/src/auroElement.js"
2263
- }
2264
- },
2265
- {
2266
- "name": "matchWidth",
2267
- "type": {
2268
- "text": "boolean"
2269
- },
2270
- "description": "If declared, the popover and trigger will be set to the same width.",
2271
- "fieldName": "matchWidth"
2272
- },
2273
- {
2274
- "name": "noFilter",
2275
- "type": {
2276
- "text": "boolean"
2277
- },
2278
- "description": "If set, combobox will not filter menuoptions based on input.",
2279
- "fieldName": "noFilter"
2306
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2307
+ "attribute": "name"
2280
2308
  },
2281
2309
  {
2282
- "name": "noFlip",
2310
+ "kind": "field",
2311
+ "name": "onDark",
2312
+ "privacy": "public",
2283
2313
  "type": {
2284
2314
  "text": "boolean"
2285
2315
  },
2286
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2287
- "fieldName": "noFlip"
2316
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2317
+ "attribute": "onDark",
2318
+ "reflects": true
2288
2319
  },
2289
2320
  {
2290
- "name": "shift",
2321
+ "kind": "field",
2322
+ "name": "touched",
2323
+ "privacy": "private",
2291
2324
  "type": {
2292
2325
  "text": "boolean"
2293
2326
  },
2294
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2295
- "fieldName": "shift"
2327
+ "description": "Indicates whether the checkbox has been interacted with."
2296
2328
  },
2297
2329
  {
2298
- "name": "noValidate",
2330
+ "kind": "field",
2331
+ "name": "value",
2332
+ "privacy": "public",
2299
2333
  "type": {
2300
- "text": "boolean"
2334
+ "text": "string"
2301
2335
  },
2302
- "description": "If set, disables auto-validation on blur.",
2303
- "fieldName": "noValidate"
2336
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2337
+ "attribute": "value"
2304
2338
  },
2305
2339
  {
2306
- "name": "offset",
2340
+ "kind": "field",
2341
+ "name": "tabIndex",
2342
+ "privacy": "private",
2307
2343
  "type": {
2308
2344
  "text": "number"
2309
- },
2310
- "description": "Gap between the trigger element and bib.",
2311
- "default": "0",
2312
- "fieldName": "offset"
2313
- },
2314
- {
2315
- "name": "onDark",
2316
- "type": {
2317
- "text": "boolean"
2318
- },
2319
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2320
- "fieldName": "onDark"
2321
- },
2322
- {
2323
- "name": "optionSelected",
2324
- "type": {
2325
- "text": "HTMLElement"
2326
- },
2327
- "description": "Specifies the current selected option.",
2328
- "fieldName": "optionSelected"
2345
+ },
2346
+ "description": "The tabindex attribute for the checkbox.",
2347
+ "attribute": "tabindex",
2348
+ "reflects": true
2329
2349
  },
2330
2350
  {
2331
- "name": "persistInput",
2351
+ "kind": "field",
2352
+ "name": "ariaChecked",
2353
+ "privacy": "private",
2332
2354
  "type": {
2333
- "text": "boolean"
2355
+ "text": "string"
2334
2356
  },
2335
- "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.",
2336
- "fieldName": "persistInput"
2357
+ "description": "The aria-checked attribute for the checkbox.",
2358
+ "attribute": "aria-checked",
2359
+ "reflects": true
2337
2360
  },
2338
2361
  {
2339
- "name": "placement",
2362
+ "kind": "field",
2363
+ "name": "ariaDisabled",
2364
+ "privacy": "private",
2340
2365
  "type": {
2341
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2366
+ "text": "string"
2342
2367
  },
2343
- "description": "Position where the bib should appear relative to the trigger.",
2344
- "default": "'bottom-start'",
2345
- "fieldName": "placement"
2368
+ "description": "The aria-disabled attribute for the checkbox.",
2369
+ "attribute": "aria-disabled",
2370
+ "reflects": true
2346
2371
  },
2347
2372
  {
2348
- "name": "placeholder",
2373
+ "kind": "field",
2374
+ "name": "role",
2375
+ "privacy": "private",
2349
2376
  "type": {
2350
2377
  "text": "string"
2351
2378
  },
2352
- "description": "Define custom placeholder text, only supported by date input formats.",
2353
- "fieldName": "placeholder"
2379
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2380
+ "attribute": "role",
2381
+ "reflects": true
2382
+ }
2383
+ ],
2384
+ "events": [
2385
+ {
2386
+ "name": "auroCheckbox-input",
2387
+ "type": {
2388
+ "text": "CustomEvent"
2389
+ }
2354
2390
  },
2355
2391
  {
2356
- "name": "required",
2392
+ "name": "auroCheckbox-focusin",
2357
2393
  "type": {
2358
- "text": "boolean"
2359
- },
2360
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2361
- "fieldName": "required"
2394
+ "text": "CustomEvent"
2395
+ }
2362
2396
  },
2363
2397
  {
2364
- "name": "setCustomValidity",
2398
+ "name": "auroCheckbox-focusout",
2365
2399
  "type": {
2366
- "text": "string"
2367
- },
2368
- "description": "Sets a custom help text message to display for all validityStates.",
2369
- "fieldName": "setCustomValidity"
2400
+ "text": "CustomEvent"
2401
+ }
2370
2402
  },
2371
2403
  {
2372
- "name": "setCustomValidityCustomError",
2404
+ "description": "(Deprecated) Notifies when checked value is changed.",
2405
+ "name": "change"
2406
+ },
2407
+ {
2408
+ "description": "Notifies when when checked value is changed by user's interface.",
2409
+ "name": "input"
2410
+ }
2411
+ ],
2412
+ "attributes": [
2413
+ {
2414
+ "name": "appearance",
2373
2415
  "type": {
2374
- "text": "string"
2416
+ "text": "'default' | 'inverse'"
2375
2417
  },
2376
- "description": "Custom help text message to display when validity = `customError`.",
2377
- "fieldName": "setCustomValidityCustomError"
2418
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2419
+ "default": "'default'",
2420
+ "fieldName": "appearance"
2378
2421
  },
2379
2422
  {
2380
- "name": "setCustomValidityValueMissing",
2423
+ "name": "checked",
2381
2424
  "type": {
2382
- "text": "string"
2425
+ "text": "boolean"
2383
2426
  },
2384
- "description": "Custom help text message to display when validity = `valueMissing`.",
2385
- "fieldName": "setCustomValidityValueMissing"
2427
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2428
+ "fieldName": "checked"
2386
2429
  },
2387
2430
  {
2388
- "name": "setCustomValidityValueMissingFilter",
2431
+ "name": "disabled",
2389
2432
  "type": {
2390
- "text": "string"
2433
+ "text": "boolean"
2391
2434
  },
2392
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2393
- "fieldName": "setCustomValidityValueMissingFilter"
2435
+ "description": "If set to true, the checkbox will not be clickable.",
2436
+ "fieldName": "disabled"
2394
2437
  },
2395
2438
  {
2396
- "name": "triggerIcon",
2439
+ "name": "error",
2397
2440
  "type": {
2398
2441
  "text": "boolean"
2399
2442
  },
2400
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2401
- "fieldName": "triggerIcon"
2443
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2444
+ "fieldName": "error"
2402
2445
  },
2403
2446
  {
2404
- "name": "type",
2447
+ "name": "id",
2405
2448
  "type": {
2406
2449
  "text": "string"
2407
2450
  },
2408
- "description": "Applies the defined value as the type attribute on `auro-input`.",
2409
- "fieldName": "type"
2451
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2452
+ "fieldName": "id"
2410
2453
  },
2411
2454
  {
2412
- "name": "typedValue",
2455
+ "name": "name",
2413
2456
  "type": {
2414
2457
  "text": "string"
2415
2458
  },
2416
- "description": "Specifies the value of the input element within the combobox.",
2417
- "fieldName": "typedValue"
2459
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2460
+ "fieldName": "name"
2418
2461
  },
2419
2462
  {
2420
- "name": "validity",
2463
+ "name": "onDark",
2421
2464
  "type": {
2422
- "text": "string"
2465
+ "text": "boolean"
2423
2466
  },
2424
- "description": "Specifies the `validityState` this element is in.",
2425
- "fieldName": "validity"
2467
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2468
+ "fieldName": "onDark"
2426
2469
  },
2427
2470
  {
2428
2471
  "name": "value",
2429
2472
  "type": {
2430
2473
  "text": "string"
2431
2474
  },
2432
- "description": "Value selected for the dropdown menu.",
2475
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2433
2476
  "fieldName": "value"
2434
2477
  },
2435
2478
  {
2436
- "name": "largeFullscreenHeadline",
2437
- "type": {
2438
- "text": "boolean"
2439
- },
2440
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2441
- "fieldName": "largeFullscreenHeadline"
2442
- },
2443
- {
2444
- "name": "fullscreenBreakpoint",
2479
+ "name": "tabindex",
2445
2480
  "type": {
2446
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2481
+ "text": "number"
2447
2482
  },
2448
- "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.",
2449
- "default": "'sm'",
2450
- "fieldName": "fullscreenBreakpoint"
2483
+ "description": "The tabindex attribute for the checkbox.",
2484
+ "fieldName": "tabIndex"
2451
2485
  },
2452
2486
  {
2453
- "name": "shape",
2487
+ "name": "aria-checked",
2454
2488
  "type": {
2455
2489
  "text": "string"
2456
2490
  },
2457
- "fieldName": "shape",
2458
- "inheritedFrom": {
2459
- "name": "AuroElement",
2460
- "module": "components/layoutElement/src/auroElement.js"
2461
- }
2491
+ "description": "The aria-checked attribute for the checkbox.",
2492
+ "fieldName": "ariaChecked"
2462
2493
  },
2463
2494
  {
2464
- "name": "size",
2495
+ "name": "aria-disabled",
2465
2496
  "type": {
2466
2497
  "text": "string"
2467
2498
  },
2468
- "fieldName": "size",
2469
- "inheritedFrom": {
2470
- "name": "AuroElement",
2471
- "module": "components/layoutElement/src/auroElement.js"
2472
- }
2499
+ "description": "The aria-disabled attribute for the checkbox.",
2500
+ "fieldName": "ariaDisabled"
2473
2501
  },
2474
2502
  {
2475
- "name": "ondark",
2503
+ "name": "role",
2476
2504
  "type": {
2477
- "text": "boolean"
2505
+ "text": "string"
2478
2506
  },
2479
- "fieldName": "onDark",
2480
- "inheritedFrom": {
2481
- "name": "AuroElement",
2482
- "module": "components/layoutElement/src/auroElement.js"
2483
- }
2507
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2508
+ "fieldName": "role"
2484
2509
  }
2485
2510
  ],
2486
2511
  "superclass": {
2487
- "name": "AuroElement",
2488
- "module": "/components/layoutElement/src/auroElement.js"
2512
+ "name": "LitElement",
2513
+ "package": "lit"
2489
2514
  },
2490
- "tagName": "auro-combobox",
2515
+ "tagName": "auro-checkbox",
2491
2516
  "customElement": true
2492
2517
  }
2493
2518
  ],
2494
2519
  "exports": [
2495
2520
  {
2496
2521
  "kind": "js",
2497
- "name": "AuroCombobox",
2522
+ "name": "AuroCheckbox",
2498
2523
  "declaration": {
2499
- "name": "AuroCombobox",
2500
- "module": "components/combobox/src/auro-combobox.js"
2524
+ "name": "AuroCheckbox",
2525
+ "module": "components/checkbox/src/auro-checkbox.js"
2501
2526
  }
2502
2527
  }
2503
2528
  ]
2504
2529
  },
2505
2530
  {
2506
2531
  "kind": "javascript-module",
2507
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2508
- "declarations": [
2509
- {
2510
- "kind": "variable",
2511
- "name": "comboboxKeyboardStrategy",
2512
- "type": {
2513
- "text": "object"
2514
- },
2515
- "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'down'); } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'up'); } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { // Forms should not submit on Enter from a combobox, regardless of which // child element (input, clear button, menu) is focused. evt.stopPropagation(); if (isClearBtnFocused(ctx)) { // Let the browser dispatch Enter to the focused clear button so its // built-in activation fires and clears the selection. Do NOT call // preventDefault — that would block the activation. return; } if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); } else { evt.preventDefault(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } } }"
2516
- }
2517
- ],
2532
+ "path": "components/checkbox/src/index.js",
2533
+ "declarations": [],
2518
2534
  "exports": [
2519
2535
  {
2520
2536
  "kind": "js",
2521
- "name": "comboboxKeyboardStrategy",
2537
+ "name": "AuroCheckbox",
2522
2538
  "declaration": {
2523
- "name": "comboboxKeyboardStrategy",
2524
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2539
+ "name": "AuroCheckbox",
2540
+ "module": "components/checkbox/src/index.js"
2525
2541
  }
2526
- }
2527
- ]
2528
- },
2529
- {
2530
- "kind": "javascript-module",
2531
- "path": "components/combobox/src/index.js",
2532
- "declarations": [],
2533
- "exports": [
2542
+ },
2534
2543
  {
2535
2544
  "kind": "js",
2536
- "name": "AuroCombobox",
2545
+ "name": "AuroCheckboxGroup",
2537
2546
  "declaration": {
2538
- "name": "AuroCombobox",
2539
- "module": "components/combobox/src/index.js"
2547
+ "name": "AuroCheckboxGroup",
2548
+ "module": "components/checkbox/src/index.js"
2540
2549
  }
2541
2550
  }
2542
2551
  ]
2543
2552
  },
2544
2553
  {
2545
2554
  "kind": "javascript-module",
2546
- "path": "components/combobox/src/registered.js",
2555
+ "path": "components/checkbox/src/registered.js",
2547
2556
  "declarations": [],
2548
- "exports": [
2549
- {
2550
- "kind": "js",
2551
- "name": "AuroCombobox",
2552
- "declaration": {
2553
- "name": "AuroCombobox",
2554
- "module": "components/combobox/src/registered.js"
2555
- }
2556
- }
2557
- ]
2557
+ "exports": []
2558
2558
  },
2559
2559
  {
2560
2560
  "kind": "javascript-module",
@@ -4621,17 +4621,6 @@
4621
4621
  }
4622
4622
  }
4623
4623
  },
4624
- {
4625
- "kind": "method",
4626
- "name": "_initFromAncestors",
4627
- "description": "Wires the cell to its ancestor calendar-month and calendar (and, via\nthe calendar, to the datepicker). Extracted from firstUpdated() so the\nretry loop can re-attempt without recursively invoking a Lit lifecycle\nmethod (which is outside the framework's contract).",
4628
- "privacy": "private",
4629
- "return": {
4630
- "type": {
4631
- "text": "void"
4632
- }
4633
- }
4634
- },
4635
4624
  {
4636
4625
  "kind": "method",
4637
4626
  "name": "configurePopover",
@@ -5293,25 +5282,6 @@
5293
5282
  "description": "",
5294
5283
  "name": "AuroCalendar",
5295
5284
  "members": [
5296
- {
5297
- "kind": "field",
5298
- "name": "disabledDays",
5299
- "deprecated": "See constructor JSDoc — migrate to\n`auro-datepicker.blackoutDates`. The getter/setter pair exists so the\none-time deprecation warning fires as soon as a consumer assigns a\nnon-empty array (empty assignments are ignored — an empty array is\nindistinguishable from the constructor default and would produce a\nspurious warning), rather than only when `_getBlackoutSet()` happens\nto rebuild.",
5300
- "return": {
5301
- "type": {
5302
- "text": "Array"
5303
- }
5304
- },
5305
- "parameters": [
5306
- {
5307
- "description": "The legacy `disabledDays` array to set.",
5308
- "name": "value",
5309
- "type": {
5310
- "text": "Array"
5311
- }
5312
- }
5313
- ]
5314
- },
5315
5285
  {
5316
5286
  "kind": "field",
5317
5287
  "name": "centralDateObject",
@@ -5586,7 +5556,7 @@
5586
5556
  {
5587
5557
  "kind": "method",
5588
5558
  "name": "_getBlackoutSet",
5589
- "description": "Returns a memoized Set of blackout timestamps (seconds) drawn from both\nthe legacy `disabledDays` array and the datepicker's ISO `blackoutDates`.\n\nThe cache invalidates on **reference identity** — only when the\nconsumer reassigns the array (`el.blackoutDates = [...]`), matching\nLit's own reactivity semantics for array properties. In-place mutations\non the existing array (`push`, `splice`, index assignment) will NOT\ninvalidate the cache and the new entries will be silently ignored.\nConsumers must reassign to update — see the JSDoc on\n`auro-datepicker.blackoutDates` for the recommended pattern.\n\nA shallow-equality tier was considered but rejected: it would run\nO(N) work on every cell render (this method is called per-cell via\n`isBlackout()`) and still wouldn't catch same-length value swaps,\noffering a false sense of safety.",
5559
+ "description": "Returns a memoized Set of blackout timestamps (seconds) drawn from both\nthe legacy `disabledDays` array and the datepicker's ISO `blackoutDates`.\nThe cache invalidates when either source array's reference changes, which\nmatches Lit's own reactive identity semantics for array properties.",
5590
5560
  "privacy": "private",
5591
5561
  "return": {
5592
5562
  "type": {
@@ -5962,7 +5932,7 @@
5962
5932
  }
5963
5933
  }
5964
5934
  ],
5965
- "description": "Debounced version of announceSelection for focus navigation.\nUses the assertive live region with a 150ms debounce so only the\nfinal cell after rapid arrow-key traversal is announced. We\noriginally tried aria-live=\"polite\" here, but VoiceOver treats\npolite as \"wait until idle\" — which never happens during active\nkeyboard navigation — so the announcements were silently dropped.\n\nThis is a documented deviation from WCAG 2.1 SC 4.1.3, which\nprefers `polite` for status messages. See the \"Documented\nDeviation\" section in components/datepicker/docs/pages/accessibility.md.",
5935
+ "description": "Debounced version of announceSelection for focus navigation.\nUses the assertive live region with a 150ms debounce so only the\nfinal cell after rapid arrow-key traversal is announced. We\noriginally tried aria-live=\"polite\" here, but VoiceOver treats\npolite as \"wait until idle\" — which never happens during active\nkeyboard navigation — so the announcements were silently dropped.",
5966
5936
  "privacy": "private",
5967
5937
  "return": {
5968
5938
  "type": {
@@ -6140,7 +6110,7 @@
6140
6110
  },
6141
6111
  {
6142
6112
  "kind": "field",
6143
- "name": "_disabledDays",
6113
+ "name": "disabledDays",
6144
6114
  "type": {
6145
6115
  "text": "array"
6146
6116
  },
@@ -7544,7 +7514,7 @@
7544
7514
  "type": {
7545
7515
  "text": "array"
7546
7516
  },
7547
- "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).\n\n**Immutable update required.** The datepicker treats this array as\nimmutable and memoizes a lookup Set keyed on the array's reference\nidentity — matching Lit's own reactivity semantics for array\nproperties. In-place mutations (`blackoutDates.push(...)`,\n`blackoutDates[i] = ...`, `blackoutDates.splice(...)`) will not\ninvalidate the cache and the new entries will be silently ignored.\nTo update, reassign the property: `el.blackoutDates = [...el.blackoutDates, '2024-12-25']`.",
7517
+ "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
7548
7518
  "default": "[]",
7549
7519
  "attribute": "blackoutDates",
7550
7520
  "reflects": true
@@ -8208,7 +8178,7 @@
8208
8178
  "type": {
8209
8179
  "text": "array"
8210
8180
  },
8211
- "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).\n\n**Immutable update required.** The datepicker treats this array as\nimmutable and memoizes a lookup Set keyed on the array's reference\nidentity — matching Lit's own reactivity semantics for array\nproperties. In-place mutations (`blackoutDates.push(...)`,\n`blackoutDates[i] = ...`, `blackoutDates.splice(...)`) will not\ninvalidate the cache and the new entries will be silently ignored.\nTo update, reassign the property: `el.blackoutDates = [...el.blackoutDates, '2024-12-25']`.",
8181
+ "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
8212
8182
  "default": "[]",
8213
8183
  "fieldName": "blackoutDates"
8214
8184
  },
@@ -8832,7 +8802,7 @@
8832
8802
  "type": {
8833
8803
  "text": "object"
8834
8804
  },
8835
- "default": "{ Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Stop propagation so parent containers (auro-dialog, auro-drawer) // don't also react to Escape. evt.stopPropagation(); evt.preventDefault(); // Signal to the visibility-change handler in auro-datepicker.js that // focus should be restored to the trigger regardless of hasFocus. // hidePopover() (desktop non-modal path) does not auto-restore focus, // and hiding the grid's popover ancestor drops focus to <body>. That // synchronously fires focusout on the datepicker host — clearing // hasFocus — before updated() runs, which would otherwise skip the // input refocus. Native <dialog>.close() (modal path) restores focus // itself, but the flag is harmless there. component._restoreFocusOnClose = true; component.hideBib(); }, Enter(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, ' '(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, }"
8805
+ "default": "{ Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Stop propagation so parent containers (auro-dialog, auro-drawer) // don't also react to Escape. evt.stopPropagation(); evt.preventDefault(); component.hideBib(); }, Enter(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, ' '(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, }"
8836
8806
  }
8837
8807
  ],
8838
8808
  "exports": [
@@ -19198,7 +19168,7 @@
19198
19168
  {
19199
19169
  "kind": "method",
19200
19170
  "name": "configureMenu",
19201
- "description": "Binds all behavior needed to the menu after rendering.\n\nThe `<auro-menu>` reference is captured once and not re-targeted on\n`slotchange`. Runtime option mutations are covered via\n`auroMenu-optionsChange`, so swap options inside the menu freely; do not\nswap the `<auro-menu>` element itself under a live select — remount the\nparent `<auro-select>` instead.",
19171
+ "description": "Binds all behavior needed to the menu after rendering.",
19202
19172
  "privacy": "private",
19203
19173
  "return": {
19204
19174
  "type": {
@@ -20402,7 +20372,7 @@
20402
20372
  "type": {
20403
20373
  "text": "object"
20404
20374
  },
20405
- "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { // Always clear the type-ahead buffer — Escape is a universal cancel. // Safe to call when the buffer is empty. // eslint-disable-next-line no-underscore-dangle if (typeof component._clearTypeaheadBuffer === 'function') { // eslint-disable-next-line no-underscore-dangle component._clearTypeaheadBuffer(); } if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getActiveOptions returns a fresh filtered array. // Uses \"active\" (not \"enabled\") so hidden and static rows — which a screen // reader must not announce as focused — are skipped. const lastOption = getActiveOptions(component.menu).pop(); if (!lastOption) { return; } // Pre-stash before show() so the auroDropdown-toggled handler's // `!optionActive` guard short-circuits the firstActive/selected fallback — // otherwise show() synchronously fires the handler and writes // aria-activedescendant once before we overwrite it. component.menu.updateActiveOption(lastOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Enter(component, evt, ctx) { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit. Matches APG select-only combobox // and native <select> behavior: Enter opens the listbox when closed, selects // the active option when open — it does not submit a parent form. evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getActiveOptions(component.menu); if (!firstOption) { return; } // See End() for why this must run before show(). component.menu.updateActiveOption(firstOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { // Ignore keys chorded with Ctrl/Meta/Alt so browser/OS shortcuts // (Cmd+C, Ctrl+V, Alt+X, Cmd+Space, …) don't leak into typeahead // or toggle the bib. Native <select> ignores modified keys. // ArrowUp/ArrowDown handle modifier+arrow explicitly above; this // guard only affects the default (printable/Space) branch. if (evt.ctrlKey || evt.metaKey || evt.altKey) { return; } // Space resolves to either typeahead-buffer extension or bib toggle // depending on whether a type-ahead buffer is active. Mirrors native // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space // is a search character (e.g. \"San Francisco\"); otherwise it toggles. if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) { component.updateActiveOptionBasedOnKey(evt.key); return; } if (ctx.isExpanded) { component.dropdown.hide(); } else { component.dropdown.show(); } return; } component.updateActiveOptionBasedOnKey(evt.key); }, }"
20375
+ "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { // Always clear the type-ahead buffer — Escape is a universal cancel. // Safe to call when the buffer is empty. // eslint-disable-next-line no-underscore-dangle if (typeof component._clearTypeaheadBuffer === 'function') { // eslint-disable-next-line no-underscore-dangle component._clearTypeaheadBuffer(); } if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getEnabledOptions returns a fresh filtered array. const lastOption = getEnabledOptions(component.menu).pop(); if (!lastOption) { return; } // Pre-stash before show() so the auroDropdown-toggled handler's // `!optionActive` guard short-circuits the firstActive/selected fallback — // otherwise show() synchronously fires the handler and writes // aria-activedescendant once before we overwrite it. component.menu.updateActiveOption(lastOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Enter(component, evt, ctx) { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit. Matches APG select-only combobox // and native <select> behavior: Enter opens the listbox when closed, selects // the active option when open — it does not submit a parent form. evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getEnabledOptions(component.menu); if (!firstOption) { return; } // See End() for why this must run before show(). component.menu.updateActiveOption(firstOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { // Space resolves to either typeahead-buffer extension or bib toggle // depending on whether a type-ahead buffer is active. Mirrors native // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space // is a search character (e.g. \"San Francisco\"); otherwise it toggles. if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) { component.updateActiveOptionBasedOnKey(evt.key); return; } if (ctx.isExpanded) { component.dropdown.hide(); } else { component.dropdown.show(); } return; } component.updateActiveOptionBasedOnKey(evt.key); }, }"
20406
20376
  }
20407
20377
  ],
20408
20378
  "exports": [