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