@aurodesignsystem-dev/auro-formkit 0.0.0-pr1552.0 → 0.0.0-pr1553.1

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 (45) 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 +46 -207
  7. package/components/combobox/demo/getting-started.min.js +46 -207
  8. package/components/combobox/demo/index.min.js +46 -207
  9. package/components/combobox/dist/index.js +46 -207
  10. package/components/combobox/dist/registered.js +46 -207
  11. package/components/counter/demo/customize.min.js +59 -222
  12. package/components/counter/demo/index.min.js +59 -222
  13. package/components/counter/dist/auro-counter.d.ts +0 -8
  14. package/components/counter/dist/index.js +59 -222
  15. package/components/counter/dist/registered.js +59 -222
  16. package/components/datepicker/demo/customize.min.js +46 -207
  17. package/components/datepicker/demo/index.min.js +46 -207
  18. package/components/datepicker/dist/index.js +46 -207
  19. package/components/datepicker/dist/registered.js +46 -207
  20. package/components/dropdown/demo/customize.min.js +44 -205
  21. package/components/dropdown/demo/getting-started.min.js +44 -205
  22. package/components/dropdown/demo/index.min.js +44 -205
  23. package/components/dropdown/dist/index.js +44 -205
  24. package/components/dropdown/dist/registered.js +44 -205
  25. package/components/form/demo/customize.min.js +199 -845
  26. package/components/form/demo/getting-started.min.js +199 -845
  27. package/components/form/demo/index.min.js +199 -845
  28. package/components/form/demo/registerDemoDeps.min.js +199 -845
  29. package/components/input/demo/customize.min.js +1 -1
  30. package/components/input/demo/getting-started.min.js +1 -1
  31. package/components/input/demo/index.min.js +1 -1
  32. package/components/input/dist/index.js +1 -1
  33. package/components/input/dist/registered.js +1 -1
  34. package/components/radio/demo/customize.min.js +1 -1
  35. package/components/radio/demo/getting-started.min.js +1 -1
  36. package/components/radio/demo/index.min.js +1 -1
  37. package/components/radio/dist/index.js +1 -1
  38. package/components/radio/dist/registered.js +1 -1
  39. package/components/select/demo/customize.min.js +45 -206
  40. package/components/select/demo/getting-started.min.js +45 -206
  41. package/components/select/demo/index.min.js +45 -206
  42. package/components/select/dist/index.js +45 -206
  43. package/components/select/dist/registered.js +45 -206
  44. package/custom-elements.json +1499 -1514
  45. package/package.json +2 -2
@@ -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,491 +374,63 @@
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
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
830
424
  },
831
425
  {
832
426
  "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",
427
+ "name": "horizontal",
1000
428
  "privacy": "public",
1001
429
  "type": {
1002
430
  "text": "boolean"
1003
431
  },
1004
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1005
- "attribute": "shift",
432
+ "description": "If set, checkboxes will be aligned horizontally.",
433
+ "attribute": "horizontal",
1006
434
  "reflects": true
1007
435
  },
1008
436
  {
@@ -1018,783 +446,1057 @@
1018
446
  },
1019
447
  {
1020
448
  "kind": "field",
1021
- "name": "offset",
449
+ "name": "onDark",
1022
450
  "privacy": "public",
1023
451
  "type": {
1024
- "text": "number"
452
+ "text": "boolean"
1025
453
  },
1026
- "description": "Gap between the trigger element and bib.",
1027
- "default": "0",
1028
- "attribute": "offset",
454
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
455
+ "attribute": "onDark",
1029
456
  "reflects": true
1030
457
  },
1031
458
  {
1032
459
  "kind": "field",
1033
- "name": "onDark",
460
+ "name": "required",
1034
461
  "privacy": "public",
1035
462
  "type": {
1036
463
  "text": "boolean"
1037
464
  },
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
- }
465
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
466
+ "attribute": "required",
467
+ "reflects": true
1045
468
  },
1046
469
  {
1047
470
  "kind": "field",
1048
- "name": "optionSelected",
471
+ "name": "setCustomValidity",
1049
472
  "privacy": "public",
1050
473
  "type": {
1051
- "text": "HTMLElement"
474
+ "text": "string"
1052
475
  },
1053
- "description": "Specifies the current selected option.",
1054
- "attribute": "optionSelected"
476
+ "description": "Sets a custom help text message to display for all validityStates.",
477
+ "attribute": "setCustomValidity"
1055
478
  },
1056
479
  {
1057
480
  "kind": "field",
1058
- "name": "persistInput",
481
+ "name": "setCustomValidityCustomError",
1059
482
  "privacy": "public",
1060
483
  "type": {
1061
- "text": "boolean"
484
+ "text": "string"
1062
485
  },
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",
1065
- "reflects": true
486
+ "description": "Custom help text message to display when validity = `customError`.",
487
+ "attribute": "setCustomValidityCustomError"
1066
488
  },
1067
489
  {
1068
490
  "kind": "field",
1069
- "name": "placement",
491
+ "name": "setCustomValidityValueMissing",
1070
492
  "privacy": "public",
1071
493
  "type": {
1072
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
494
+ "text": "string"
1073
495
  },
1074
- "description": "Position where the bib should appear relative to the trigger.",
1075
- "default": "'bottom-start'",
1076
- "attribute": "placement",
1077
- "reflects": true
496
+ "description": "Custom help text message to display when validity = `valueMissing`.",
497
+ "attribute": "setCustomValidityValueMissing"
1078
498
  },
1079
499
  {
1080
500
  "kind": "field",
1081
- "name": "placeholder",
501
+ "name": "validity",
1082
502
  "privacy": "public",
1083
503
  "type": {
1084
504
  "text": "string"
1085
505
  },
1086
- "description": "Define custom placeholder text, only supported by date input formats.",
1087
- "attribute": "placeholder",
506
+ "description": "Specifies the `validityState` this element is in.",
507
+ "attribute": "validity",
1088
508
  "reflects": true
509
+ }
510
+ ],
511
+ "events": [
512
+ {
513
+ "name": "input",
514
+ "type": {
515
+ "text": "CustomEvent"
516
+ }
1089
517
  },
1090
518
  {
1091
- "kind": "field",
1092
- "name": "required",
1093
- "privacy": "public",
519
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
520
+ "name": "auroFormElement-validated"
521
+ }
522
+ ],
523
+ "attributes": [
524
+ {
525
+ "name": "appearance",
1094
526
  "type": {
1095
- "text": "boolean"
527
+ "text": "'default' | 'inverse'"
1096
528
  },
1097
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1098
- "attribute": "required",
1099
- "reflects": true
529
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
530
+ "default": "'default'",
531
+ "fieldName": "appearance"
1100
532
  },
1101
533
  {
1102
- "kind": "field",
1103
- "name": "setCustomValidity",
1104
- "privacy": "public",
534
+ "name": "disabled",
1105
535
  "type": {
1106
- "text": "string"
536
+ "text": "boolean"
1107
537
  },
1108
- "description": "Sets a custom help text message to display for all validityStates.",
1109
- "attribute": "setCustomValidity"
538
+ "description": "If set, disables the checkbox group.",
539
+ "fieldName": "disabled"
1110
540
  },
1111
541
  {
1112
- "kind": "field",
1113
- "name": "setCustomValidityCustomError",
1114
- "privacy": "public",
542
+ "name": "error",
1115
543
  "type": {
1116
544
  "text": "string"
1117
545
  },
1118
- "description": "Custom help text message to display when validity = `customError`.",
1119
- "attribute": "setCustomValidityCustomError"
546
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
547
+ "fieldName": "error"
1120
548
  },
1121
549
  {
1122
- "kind": "field",
1123
- "name": "setCustomValidityValueMissing",
1124
- "privacy": "public",
550
+ "name": "horizontal",
1125
551
  "type": {
1126
- "text": "string"
552
+ "text": "boolean"
1127
553
  },
1128
- "description": "Custom help text message to display when validity = `valueMissing`.",
1129
- "attribute": "setCustomValidityValueMissing"
554
+ "description": "If set, checkboxes will be aligned horizontally.",
555
+ "fieldName": "horizontal"
1130
556
  },
1131
557
  {
1132
- "kind": "field",
1133
- "name": "setCustomValidityValueMissingFilter",
1134
- "privacy": "public",
558
+ "name": "noValidate",
1135
559
  "type": {
1136
- "text": "string"
560
+ "text": "boolean"
1137
561
  },
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"
562
+ "description": "If set, disables auto-validation on blur.",
563
+ "fieldName": "noValidate"
1140
564
  },
1141
565
  {
1142
- "kind": "field",
1143
- "name": "touched",
1144
- "privacy": "private",
566
+ "name": "onDark",
1145
567
  "type": {
1146
568
  "text": "boolean"
1147
569
  },
1148
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
570
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
571
+ "fieldName": "onDark"
1149
572
  },
1150
573
  {
1151
- "kind": "field",
1152
- "name": "triggerIcon",
1153
- "privacy": "public",
574
+ "name": "required",
1154
575
  "type": {
1155
576
  "text": "boolean"
1156
577
  },
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
578
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
579
+ "fieldName": "required"
1160
580
  },
1161
581
  {
1162
- "kind": "field",
1163
- "name": "type",
1164
- "privacy": "public",
582
+ "name": "setCustomValidity",
1165
583
  "type": {
1166
584
  "text": "string"
1167
585
  },
1168
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1169
- "attribute": "type",
1170
- "reflects": true
586
+ "description": "Sets a custom help text message to display for all validityStates.",
587
+ "fieldName": "setCustomValidity"
1171
588
  },
1172
589
  {
1173
- "kind": "field",
1174
- "name": "typedValue",
1175
- "privacy": "public",
590
+ "name": "setCustomValidityCustomError",
1176
591
  "type": {
1177
592
  "text": "string"
1178
593
  },
1179
- "description": "Specifies the value of the input element within the combobox.",
1180
- "attribute": "typedValue",
1181
- "reflects": true
594
+ "description": "Custom help text message to display when validity = `customError`.",
595
+ "fieldName": "setCustomValidityCustomError"
1182
596
  },
1183
597
  {
1184
- "kind": "field",
1185
- "name": "validity",
1186
- "privacy": "public",
598
+ "name": "setCustomValidityValueMissing",
1187
599
  "type": {
1188
600
  "text": "string"
1189
601
  },
1190
- "description": "Specifies the `validityState` this element is in.",
1191
- "attribute": "validity",
1192
- "reflects": true
602
+ "description": "Custom help text message to display when validity = `valueMissing`.",
603
+ "fieldName": "setCustomValidityValueMissing"
1193
604
  },
1194
605
  {
1195
- "kind": "field",
1196
- "name": "value",
1197
- "privacy": "public",
606
+ "name": "validity",
1198
607
  "type": {
1199
608
  "text": "string"
1200
609
  },
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"
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"
1203
645
  },
1204
646
  {
1205
- "kind": "field",
1206
- "name": "largeFullscreenHeadline",
1207
- "privacy": "public",
1208
- "type": {
1209
- "text": "boolean"
1210
- },
1211
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1212
- "attribute": "largeFullscreenHeadline",
1213
- "reflects": true
647
+ "description": "apply css to a specific checkbox's input.",
648
+ "name": "checkbox-input"
1214
649
  },
1215
650
  {
1216
- "kind": "field",
1217
- "name": "fullscreenBreakpoint",
1218
- "privacy": "public",
1219
- "type": {
1220
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1221
- },
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
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"
1226
665
  },
1227
666
  {
1228
- "kind": "field",
1229
- "name": "optionActive",
1230
- "privacy": "private",
1231
- "type": {
1232
- "text": "object"
1233
- },
1234
- "description": "Specifies the currently active option."
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."
1235
682
  },
1236
683
  {
1237
- "kind": "field",
1238
- "name": "componentHasFocus",
1239
- "description": "Returns true if the element has focus.",
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"
1403
- },
1404
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1405
- "fieldName": "error"
1406
- },
1407
- {
1408
- "name": "format",
1409
- "type": {
1410
- "text": "string"
1411
- },
1412
- "description": "Specifies the input mask format.",
1413
- "fieldName": "format"
1414
- },
1415
- {
1416
- "name": "inputmode",
1417
- "type": {
1418
- "text": "string"
825
+ "text": "boolean"
1419
826
  },
1420
- "description": "Exposes inputmode attribute for input.",
1421
- "fieldName": "inputmode"
827
+ "description": "If set to true, the checkbox will be displayed with an error state.",
828
+ "attribute": "error",
829
+ "reflects": true
1422
830
  },
1423
831
  {
1424
- "name": "layout",
832
+ "kind": "field",
833
+ "name": "id",
834
+ "privacy": "public",
1425
835
  "type": {
1426
836
  "text": "string"
1427
837
  },
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
- }
838
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
839
+ "attribute": "id",
840
+ "reflects": true
1435
841
  },
1436
842
  {
1437
- "name": "matchWidth",
843
+ "kind": "field",
844
+ "name": "inputId",
845
+ "privacy": "private",
1438
846
  "type": {
1439
- "text": "boolean"
847
+ "text": "string"
1440
848
  },
1441
- "description": "If declared, the popover and trigger will be set to the same width.",
1442
- "fieldName": "matchWidth"
849
+ "description": "The id for input node."
1443
850
  },
1444
851
  {
1445
- "name": "noFilter",
852
+ "kind": "field",
853
+ "name": "name",
854
+ "privacy": "public",
1446
855
  "type": {
1447
- "text": "boolean"
856
+ "text": "string"
1448
857
  },
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(); } } } }"
1067
+ "tagName": "auro-checkbox",
1068
+ "customElement": true
1687
1069
  }
1688
1070
  ],
1689
1071
  "exports": [
1690
1072
  {
1691
1073
  "kind": "js",
1692
- "name": "comboboxKeyboardStrategy",
1074
+ "name": "AuroCheckbox",
1693
1075
  "declaration": {
1694
- "name": "comboboxKeyboardStrategy",
1695
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1076
+ "name": "AuroCheckbox",
1077
+ "module": "components/checkbox/src/auro-checkbox.js"
1696
1078
  }
1697
1079
  }
1698
1080
  ]
1699
1081
  },
1700
1082
  {
1701
1083
  "kind": "javascript-module",
1702
- "path": "components/combobox/src/index.js",
1084
+ "path": "components/checkbox/src/index.js",
1703
1085
  "declarations": [],
1704
1086
  "exports": [
1705
1087
  {
1706
1088
  "kind": "js",
1707
- "name": "AuroCombobox",
1089
+ "name": "AuroCheckbox",
1708
1090
  "declaration": {
1709
- "name": "AuroCombobox",
1710
- "module": "components/combobox/src/index.js"
1091
+ "name": "AuroCheckbox",
1092
+ "module": "components/checkbox/src/index.js"
1711
1093
  }
1712
- }
1713
- ]
1714
- },
1715
- {
1716
- "kind": "javascript-module",
1717
- "path": "components/combobox/src/registered.js",
1718
- "declarations": [],
1719
- "exports": [
1094
+ },
1720
1095
  {
1721
1096
  "kind": "js",
1722
- "name": "AuroCombobox",
1097
+ "name": "AuroCheckboxGroup",
1723
1098
  "declaration": {
1724
- "name": "AuroCombobox",
1725
- "module": "components/combobox/src/registered.js"
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
+ }
1742
1341
  },
1743
1342
  {
1744
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1745
- "name": "optionalLabel"
1343
+ "kind": "method",
1344
+ "name": "hideBib",
1345
+ "description": "Hides the dropdown bib if its open.",
1346
+ "return": {
1347
+ "type": {
1348
+ "text": "void"
1349
+ }
1350
+ }
1746
1351
  },
1747
1352
  {
1748
- "description": "Allows for the helper text to be overridden.",
1749
- "name": "helpText"
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
+ }
1750
1361
  },
1751
1362
  {
1752
- "description": "The default slot for the checkbox items.",
1753
- "name": "default"
1754
- }
1755
- ],
1756
- "members": [
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
+ }
1372
+ },
1757
1373
  {
1758
1374
  "kind": "method",
1759
- "name": "_initializeDefaults"
1375
+ "name": "setClearBtnFocus",
1376
+ "privacy": "private"
1760
1377
  },
1761
1378
  {
1762
1379
  "kind": "method",
1763
- "name": "register",
1764
- "static": true,
1380
+ "name": "setTriggerInputFocus",
1381
+ "privacy": "private"
1382
+ },
1383
+ {
1384
+ "kind": "method",
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,9 +1517,27 @@
1815
1517
  },
1816
1518
  {
1817
1519
  "kind": "method",
1818
- "name": "handleItems",
1819
- "description": "Helper method that handles the state of checkboxes.",
1820
- "privacy": "private",
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.",
1821
1541
  "return": {
1822
1542
  "type": {
1823
1543
  "text": "void"
@@ -1836,32 +1556,165 @@
1836
1556
  },
1837
1557
  {
1838
1558
  "kind": "method",
1839
- "name": "validate",
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.",
1610
+ "privacy": "private",
1611
+ "return": {
1612
+ "type": {
1613
+ "text": "void"
1614
+ }
1615
+ }
1616
+ },
1617
+ {
1618
+ "kind": "method",
1619
+ "name": "updateActiveOption",
1840
1620
  "parameters": [
1841
1621
  {
1842
- "name": "force",
1843
- "default": "false",
1844
- "description": "Whether to force validation.",
1845
- "optional": true,
1622
+ "name": "index",
1623
+ "description": "Index of the option to make active.",
1846
1624
  "type": {
1847
- "text": "boolean"
1625
+ "text": "number"
1848
1626
  }
1849
1627
  }
1850
1628
  ],
1851
- "description": "Validates value."
1629
+ "description": "Updates the active option in the menu."
1630
+ },
1631
+ {
1632
+ "kind": "method",
1633
+ "name": "handleSlotChange",
1634
+ "parameters": [
1635
+ {
1636
+ "name": "event",
1637
+ "description": "`slotchange` event.",
1638
+ "type": {
1639
+ "text": "Event"
1640
+ }
1641
+ }
1642
+ ],
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
  {
@@ -1902,19 +1855,79 @@
1902
1855
  "type": {
1903
1856
  "text": "boolean"
1904
1857
  },
1905
- "description": "If set, disables auto-validation on blur.",
1906
- "attribute": "noValidate",
1858
+ "description": "If set, disables auto-validation on blur.",
1859
+ "attribute": "noValidate",
1860
+ "reflects": true
1861
+ },
1862
+ {
1863
+ "kind": "field",
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",
1907
1920
  "reflects": true
1908
1921
  },
1909
1922
  {
1910
1923
  "kind": "field",
1911
- "name": "onDark",
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
- {
2186
- "kind": "method",
2187
- "name": "handleFocusin",
2188
- "description": "Function to support",
2079
+ {
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"
2322
2265
  },
2323
2266
  {
2324
- "kind": "field",
2325
- "name": "onDark",
2326
- "privacy": "public",
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",
2327
2281
  "type": {
2328
2282
  "text": "boolean"
2329
2283
  },
2330
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2331
- "attribute": "onDark",
2332
- "reflects": true
2284
+ "description": "If declared, the popover and trigger will be set to the same width.",
2285
+ "fieldName": "matchWidth"
2333
2286
  },
2334
2287
  {
2335
- "kind": "field",
2336
- "name": "touched",
2337
- "privacy": "private",
2288
+ "name": "noFilter",
2338
2289
  "type": {
2339
2290
  "text": "boolean"
2340
2291
  },
2341
- "description": "Indicates whether the checkbox has been interacted with."
2292
+ "description": "If set, combobox will not filter menuoptions based on input.",
2293
+ "fieldName": "noFilter"
2342
2294
  },
2343
2295
  {
2344
- "kind": "field",
2345
- "name": "value",
2346
- "privacy": "public",
2296
+ "name": "noFlip",
2347
2297
  "type": {
2348
- "text": "string"
2298
+ "text": "boolean"
2349
2299
  },
2350
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2351
- "attribute": "value"
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"
2352
2318
  },
2353
2319
  {
2354
- "kind": "field",
2355
- "name": "tabIndex",
2356
- "privacy": "private",
2320
+ "name": "offset",
2357
2321
  "type": {
2358
2322
  "text": "number"
2359
2323
  },
2360
- "description": "The tabindex attribute for the checkbox.",
2361
- "attribute": "tabindex",
2362
- "reflects": true
2324
+ "description": "Gap between the trigger element and bib.",
2325
+ "default": "0",
2326
+ "fieldName": "offset"
2363
2327
  },
2364
2328
  {
2365
- "kind": "field",
2366
- "name": "ariaChecked",
2367
- "privacy": "private",
2329
+ "name": "onDark",
2368
2330
  "type": {
2369
- "text": "string"
2331
+ "text": "boolean"
2370
2332
  },
2371
- "description": "The aria-checked attribute for the checkbox.",
2372
- "attribute": "aria-checked",
2373
- "reflects": true
2333
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2334
+ "fieldName": "onDark"
2374
2335
  },
2375
2336
  {
2376
- "kind": "field",
2377
- "name": "ariaDisabled",
2378
- "privacy": "private",
2337
+ "name": "optionSelected",
2379
2338
  "type": {
2380
- "text": "string"
2339
+ "text": "HTMLElement"
2381
2340
  },
2382
- "description": "The aria-disabled attribute for the checkbox.",
2383
- "attribute": "aria-disabled",
2384
- "reflects": true
2341
+ "description": "Specifies the current selected option.",
2342
+ "fieldName": "optionSelected"
2385
2343
  },
2386
2344
  {
2387
- "kind": "field",
2388
- "name": "role",
2389
- "privacy": "private",
2345
+ "name": "persistInput",
2390
2346
  "type": {
2391
- "text": "string"
2347
+ "text": "boolean"
2392
2348
  },
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": [
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"
2351
+ },
2399
2352
  {
2400
- "name": "auroCheckbox-input",
2353
+ "name": "placement",
2401
2354
  "type": {
2402
- "text": "CustomEvent"
2403
- }
2355
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2356
+ },
2357
+ "description": "Position where the bib should appear relative to the trigger.",
2358
+ "default": "'bottom-start'",
2359
+ "fieldName": "placement"
2404
2360
  },
2405
2361
  {
2406
- "name": "auroCheckbox-focusin",
2362
+ "name": "placeholder",
2407
2363
  "type": {
2408
- "text": "CustomEvent"
2409
- }
2364
+ "text": "string"
2365
+ },
2366
+ "description": "Define custom placeholder text, only supported by date input formats.",
2367
+ "fieldName": "placeholder"
2410
2368
  },
2411
2369
  {
2412
- "name": "auroCheckbox-focusout",
2370
+ "name": "required",
2413
2371
  "type": {
2414
- "text": "CustomEvent"
2415
- }
2372
+ "text": "boolean"
2373
+ },
2374
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2375
+ "fieldName": "required"
2416
2376
  },
2417
2377
  {
2418
- "description": "(Deprecated) Notifies when checked value is changed.",
2419
- "name": "change"
2378
+ "name": "setCustomValidity",
2379
+ "type": {
2380
+ "text": "string"
2381
+ },
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",
@@ -3861,21 +3861,6 @@
3861
3861
  "description": "Handles the change event for the default slot.\nUpdates the defaultSlot property with the trimmed text content of the first assigned node.",
3862
3862
  "privacy": "private"
3863
3863
  },
3864
- {
3865
- "kind": "method",
3866
- "name": "onDescriptionSlotChange",
3867
- "parameters": [
3868
- {
3869
- "name": "event",
3870
- "description": "The slotchange event.",
3871
- "type": {
3872
- "text": "Event"
3873
- }
3874
- }
3875
- ],
3876
- "description": "Handles the slotchange event for the description slot.\nUpdates ariaDescribedByElements on the spinbutton.",
3877
- "privacy": "private"
3878
- },
3879
3864
  {
3880
3865
  "kind": "method",
3881
3866
  "name": "renderHelpText",