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

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