@aurodesignsystem-dev/auro-formkit 0.0.0-pr1398.1 → 0.0.0-pr1398.3

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 (62) hide show
  1. package/components/checkbox/demo/api.min.js +1 -1
  2. package/components/checkbox/demo/index.min.js +1 -1
  3. package/components/checkbox/demo/keyboardBehavior.md +0 -0
  4. package/components/checkbox/dist/index.js +1 -1
  5. package/components/checkbox/dist/registered.js +1 -1
  6. package/components/combobox/demo/api.min.js +129 -166
  7. package/components/combobox/demo/index.min.js +129 -166
  8. package/components/combobox/demo/keyboardBehavior.html +81 -0
  9. package/components/combobox/demo/keyboardBehavior.md +308 -0
  10. package/components/combobox/dist/index.js +87 -134
  11. package/components/combobox/dist/registered.js +87 -134
  12. package/components/counter/demo/api.md +1 -1
  13. package/components/counter/demo/api.min.js +183 -160
  14. package/components/counter/demo/index.min.js +183 -160
  15. package/components/counter/demo/keyboardBehavior.html +81 -0
  16. package/components/counter/demo/keyboardBehavior.md +127 -0
  17. package/components/counter/dist/auro-counter.d.ts +11 -8
  18. package/components/counter/dist/index.js +183 -160
  19. package/components/counter/dist/keyboardStrategy.d.ts +4 -0
  20. package/components/counter/dist/registered.js +183 -160
  21. package/components/datepicker/demo/api.min.js +89 -137
  22. package/components/datepicker/demo/index.min.js +89 -137
  23. package/components/datepicker/demo/keyboardBehavior.html +81 -0
  24. package/components/datepicker/demo/keyboardBehavior.md +24 -0
  25. package/components/datepicker/dist/index.js +84 -132
  26. package/components/datepicker/dist/registered.js +84 -132
  27. package/components/dropdown/demo/api.md +0 -1
  28. package/components/dropdown/demo/api.min.js +99 -140
  29. package/components/dropdown/demo/index.md +2 -2
  30. package/components/dropdown/demo/index.min.js +99 -140
  31. package/components/dropdown/demo/keyboardBehavior.html +81 -0
  32. package/components/dropdown/demo/keyboardBehavior.md +77 -0
  33. package/components/dropdown/dist/auro-dropdown.d.ts +0 -8
  34. package/components/dropdown/dist/auro-dropdownBib.d.ts +1 -50
  35. package/components/dropdown/dist/dropdownBibKeyboardStrategy.d.ts +7 -0
  36. package/components/dropdown/dist/index.js +83 -128
  37. package/components/dropdown/dist/registered.js +83 -128
  38. package/components/form/demo/api.min.js +492 -599
  39. package/components/form/demo/index.min.js +492 -599
  40. package/components/form/demo/keyboardBehavior.md +0 -0
  41. package/components/input/demo/api.min.js +1 -1
  42. package/components/input/demo/index.min.js +1 -1
  43. package/components/input/demo/keyboardBehavior.md +0 -0
  44. package/components/input/dist/index.js +1 -1
  45. package/components/input/dist/registered.js +1 -1
  46. package/components/menu/demo/api.min.js +42 -32
  47. package/components/menu/demo/index.min.js +42 -32
  48. package/components/menu/dist/auro-menu.d.ts +3 -11
  49. package/components/menu/dist/index.js +42 -32
  50. package/components/menu/dist/registered.js +42 -32
  51. package/components/radio/demo/api.min.js +1 -1
  52. package/components/radio/demo/index.min.js +1 -1
  53. package/components/radio/dist/index.js +1 -1
  54. package/components/radio/dist/registered.js +1 -1
  55. package/components/select/demo/api.min.js +132 -167
  56. package/components/select/demo/index.min.js +132 -167
  57. package/components/select/demo/keyboardBehavior.html +81 -0
  58. package/components/select/demo/keyboardBehavior.md +246 -0
  59. package/components/select/dist/index.js +90 -135
  60. package/components/select/dist/registered.js +90 -135
  61. package/custom-elements.json +1598 -1598
  62. package/package.json +5 -3
@@ -248,80 +248,34 @@
248
248
  },
249
249
  {
250
250
  "kind": "javascript-module",
251
- "path": "components/combobox/src/auro-combobox.js",
251
+ "path": "components/checkbox/src/auro-checkbox-group.js",
252
252
  "declarations": [
253
253
  {
254
254
  "kind": "class",
255
- "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.",
256
- "name": "AuroCombobox",
255
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
256
+ "name": "AuroCheckboxGroup",
257
257
  "slots": [
258
258
  {
259
- "description": "Default slot for the menu content.",
260
- "name": ""
259
+ "description": "Allows for the legend to be overridden.",
260
+ "name": "legend"
261
261
  },
262
262
  {
263
- "type": {
264
- "text": "HTMLSlotElement"
265
- },
266
263
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
267
264
  "name": "optionalLabel"
268
265
  },
269
266
  {
270
- "description": "Sets aria-label on clear button",
271
- "name": "ariaLabel.input.clear"
272
- },
273
- {
274
- "description": "Sets aria-label on close button in fullscreen bib",
275
- "name": "ariaLabel.bib.close"
276
- },
277
- {
278
- "description": "Defines the headline to display above menu-options",
279
- "name": "bib.fullscreen.headline"
280
- },
281
- {
282
- "description": "Defines the content of the label.",
283
- "name": "label"
284
- },
285
- {
286
- "description": "Defines the content of the helpText.",
267
+ "description": "Allows for the helper text to be overridden.",
287
268
  "name": "helpText"
288
269
  },
289
270
  {
290
- "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
291
- "name": "displayValue"
271
+ "description": "The default slot for the checkbox items.",
272
+ "name": "default"
292
273
  }
293
274
  ],
294
275
  "members": [
295
276
  {
296
277
  "kind": "method",
297
- "name": "_initializeDefaults",
298
- "privacy": "private",
299
- "return": {
300
- "type": {
301
- "text": "void"
302
- }
303
- }
304
- },
305
- {
306
- "kind": "field",
307
- "name": "inputValue",
308
- "description": "Returns the current value of the input element within the combobox.",
309
- "return": {
310
- "type": {
311
- "text": "string|undefined"
312
- }
313
- },
314
- "readonly": true
315
- },
316
- {
317
- "kind": "method",
318
- "name": "isValid",
319
- "description": "Checks if the element is valid.",
320
- "return": {
321
- "type": {
322
- "text": "boolean"
323
- }
324
- }
278
+ "name": "_initializeDefaults"
325
279
  },
326
280
  {
327
281
  "kind": "method",
@@ -330,7 +284,7 @@
330
284
  "parameters": [
331
285
  {
332
286
  "name": "name",
333
- "default": "'auro-combobox'",
287
+ "default": "\"auro-checkbox-group\"",
334
288
  "description": "The name of the element that you want to register.",
335
289
  "optional": true,
336
290
  "type": {
@@ -342,40 +296,24 @@
342
296
  },
343
297
  {
344
298
  "kind": "method",
345
- "name": "updateFilter",
346
- "description": "Updates the filter for the available options based on the input value.",
347
- "privacy": "private"
348
- },
349
- {
350
- "kind": "method",
351
- "name": "syncValuesAndStates",
352
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
353
- "privacy": "private",
354
- "return": {
355
- "type": {
356
- "text": "void"
357
- }
358
- }
359
- },
360
- {
361
- "kind": "method",
362
- "name": "updateTriggerTextDisplay",
299
+ "name": "handleValueUpdate",
363
300
  "parameters": [
364
301
  {
365
- "name": "label",
366
- "description": "The label of the selected option.",
302
+ "name": "value",
303
+ "description": "The value of the checkbox.",
367
304
  "type": {
368
- "text": "string"
305
+ "text": "String"
306
+ }
307
+ },
308
+ {
309
+ "name": "selected",
310
+ "description": "The checked state of the checkbox.",
311
+ "type": {
312
+ "text": "Boolean"
369
313
  }
370
314
  }
371
315
  ],
372
- "description": "Update displayValue or input.value, it's called when making a selection.",
373
- "privacy": "private"
374
- },
375
- {
376
- "kind": "method",
377
- "name": "handleMenuOptions",
378
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
316
+ "description": "Helper method to handle checkbox value changing.",
379
317
  "privacy": "private",
380
318
  "return": {
381
319
  "type": {
@@ -385,8 +323,8 @@
385
323
  },
386
324
  {
387
325
  "kind": "method",
388
- "name": "generateOptionsArray",
389
- "description": "Determines the element error state based on the `required` attribute and input value.",
326
+ "name": "handlePreselectedItems",
327
+ "description": "Helper method that handles the state of preselected checkboxes.",
390
328
  "privacy": "private",
391
329
  "return": {
392
330
  "type": {
@@ -396,8 +334,9 @@
396
334
  },
397
335
  {
398
336
  "kind": "method",
399
- "name": "hideBib",
400
- "description": "Hides the dropdown bib if its open.",
337
+ "name": "handleItems",
338
+ "description": "Helper method that handles the state of checkboxes.",
339
+ "privacy": "private",
401
340
  "return": {
402
341
  "type": {
403
342
  "text": "void"
@@ -406,8 +345,8 @@
406
345
  },
407
346
  {
408
347
  "kind": "method",
409
- "name": "showBib",
410
- "description": "Shows the dropdown bib if there are options to show.",
348
+ "name": "reset",
349
+ "description": "Resets component to initial state.",
411
350
  "return": {
412
351
  "type": {
413
352
  "text": "void"
@@ -416,942 +355,647 @@
416
355
  },
417
356
  {
418
357
  "kind": "method",
419
- "name": "configureDropdown",
420
- "description": "Binds all behavior needed to the dropdown after rendering.",
421
- "privacy": "private",
422
- "return": {
423
- "type": {
424
- "text": "void"
358
+ "name": "validate",
359
+ "parameters": [
360
+ {
361
+ "name": "force",
362
+ "default": "false",
363
+ "description": "Whether to force validation.",
364
+ "optional": true,
365
+ "type": {
366
+ "text": "boolean"
367
+ }
425
368
  }
426
- }
369
+ ],
370
+ "description": "Validates value."
427
371
  },
428
372
  {
429
- "kind": "method",
430
- "name": "setClearBtnFocus",
431
- "privacy": "private"
373
+ "kind": "field",
374
+ "name": "appearance",
375
+ "privacy": "public",
376
+ "type": {
377
+ "text": "'default' | 'inverse'"
378
+ },
379
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
380
+ "default": "'default'",
381
+ "attribute": "appearance",
382
+ "reflects": true
432
383
  },
433
384
  {
434
- "kind": "method",
435
- "name": "setInputFocus",
436
- "privacy": "private"
385
+ "kind": "field",
386
+ "name": "disabled",
387
+ "privacy": "public",
388
+ "type": {
389
+ "text": "boolean"
390
+ },
391
+ "description": "If set, disables the checkbox group.",
392
+ "attribute": "disabled",
393
+ "reflects": true
437
394
  },
438
395
  {
439
- "kind": "method",
440
- "name": "updateBibDialogRole",
441
- "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.",
442
- "privacy": "private"
396
+ "kind": "field",
397
+ "name": "error",
398
+ "privacy": "public",
399
+ "type": {
400
+ "text": "string"
401
+ },
402
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
403
+ "attribute": "error",
404
+ "reflects": true
443
405
  },
444
406
  {
445
- "kind": "method",
446
- "name": "updateMenuShapeSize",
447
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
448
- "privacy": "private"
407
+ "kind": "field",
408
+ "name": "horizontal",
409
+ "privacy": "public",
410
+ "type": {
411
+ "text": "boolean"
412
+ },
413
+ "description": "If set, checkboxes will be aligned horizontally.",
414
+ "attribute": "horizontal",
415
+ "reflects": true
449
416
  },
450
417
  {
451
- "kind": "method",
452
- "name": "configureMenu",
453
- "description": "Binds all behavior needed to the menu after rendering.",
454
- "privacy": "private",
455
- "return": {
456
- "type": {
457
- "text": "void"
458
- }
459
- }
418
+ "kind": "field",
419
+ "name": "noValidate",
420
+ "privacy": "public",
421
+ "type": {
422
+ "text": "boolean"
423
+ },
424
+ "description": "If set, disables auto-validation on blur.",
425
+ "attribute": "noValidate",
426
+ "reflects": true
460
427
  },
461
428
  {
462
- "kind": "method",
463
- "name": "configureInput",
464
- "description": "Binds all behavior needed to the input after rendering.",
465
- "privacy": "private",
466
- "return": {
467
- "type": {
468
- "text": "void"
469
- }
470
- }
471
- },
472
- {
473
- "kind": "method",
474
- "name": "handleMenuLoadingChange",
475
- "parameters": [
476
- {
477
- "name": "event",
478
- "description": "The event object containing details about the loading state change.",
479
- "type": {
480
- "text": "CustomEvent"
481
- }
482
- },
483
- {
484
- "description": "Indicates whether the menu is currently loading.",
485
- "name": "event.detail.loading",
486
- "type": {
487
- "text": "boolean"
488
- }
489
- },
490
- {
491
- "description": "Indicates if there are loading placeholders present.",
492
- "name": "event.detail.hasLoadingPlaceholder",
493
- "type": {
494
- "text": "boolean"
495
- }
496
- }
497
- ],
498
- "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.",
499
- "privacy": "private",
500
- "return": {
501
- "type": {
502
- "text": "void"
503
- }
504
- }
505
- },
506
- {
507
- "kind": "method",
508
- "name": "handleInputValueChange",
509
- "parameters": [
510
- {
511
- "name": "event",
512
- "description": "The input event triggered by the input element.",
513
- "type": {
514
- "text": "Event"
515
- }
516
- }
517
- ],
518
- "description": "Handle changes to the input value and trigger changes that should result.",
519
- "privacy": "private",
520
- "return": {
521
- "type": {
522
- "text": "void"
523
- }
524
- }
525
- },
526
- {
527
- "kind": "method",
528
- "name": "configureCombobox",
529
- "description": "Binds all behavior needed to the combobox after rendering.",
530
- "privacy": "private",
531
- "return": {
532
- "type": {
533
- "text": "void"
534
- }
535
- }
536
- },
537
- {
538
- "kind": "method",
539
- "name": "focus",
540
- "description": "Focuses the combobox trigger input.",
541
- "return": {
542
- "type": {
543
- "text": "void"
544
- }
545
- }
546
- },
547
- {
548
- "kind": "method",
549
- "name": "setMenuValue",
550
- "parameters": [
551
- {
552
- "name": "value",
553
- "description": "The value to set on the menu.",
554
- "type": {
555
- "text": "string"
556
- }
557
- }
558
- ],
559
- "description": "Sets the menu value if menu is available.",
560
- "return": {
561
- "type": {
562
- "text": "void"
563
- }
564
- }
565
- },
566
- {
567
- "kind": "method",
568
- "name": "reset",
569
- "description": "Resets component to initial state.",
570
- "return": {
571
- "type": {
572
- "text": "void"
573
- }
574
- }
575
- },
576
- {
577
- "kind": "method",
578
- "name": "clear",
579
- "description": "Clears the current value of the combobox.",
580
- "return": {
581
- "type": {
582
- "text": "void"
583
- }
584
- }
585
- },
586
- {
587
- "kind": "method",
588
- "name": "validate",
589
- "parameters": [
590
- {
591
- "name": "force",
592
- "default": "false",
593
- "description": "Whether to force validation.",
594
- "optional": true,
595
- "type": {
596
- "text": "boolean"
597
- }
598
- }
599
- ],
600
- "description": "Validates value."
601
- },
602
- {
603
- "kind": "method",
604
- "name": "transportAssignedNodes",
605
- "parameters": [
606
- {
607
- "name": "slot",
608
- "description": "The slot element containing the nodes to apply.",
609
- "type": {
610
- "text": "HTMLSlotElement"
611
- }
612
- },
613
- {
614
- "name": "target",
615
- "description": "The target element to apply the nodes to.",
616
- "type": {
617
- "text": "HTMLElement"
618
- }
619
- },
620
- {
621
- "name": "newSlotName",
622
- "description": "The new slot name for the applied nodes.",
623
- "type": {
624
- "text": "string"
625
- }
626
- }
627
- ],
628
- "description": "Applies slotted nodes to a target element with a new slot name.",
629
- "privacy": "private",
630
- "return": {
631
- "type": {
632
- "text": "void"
633
- }
634
- }
635
- },
636
- {
637
- "kind": "method",
638
- "name": "updateActiveOption",
639
- "parameters": [
640
- {
641
- "name": "index",
642
- "description": "Index of the option to make active.",
643
- "type": {
644
- "text": "number"
645
- }
646
- }
647
- ],
648
- "description": "Updates the active option in the menu."
649
- },
650
- {
651
- "kind": "method",
652
- "name": "handleSlotChange",
653
- "parameters": [
654
- {
655
- "name": "event",
656
- "description": "`slotchange` event.",
657
- "type": {
658
- "text": "Event"
659
- }
660
- }
661
- ],
662
- "description": "Watch for slot changes and recalculate the menuoptions.",
663
- "privacy": "private",
664
- "return": {
665
- "type": {
666
- "text": "void"
667
- }
668
- }
429
+ "kind": "field",
430
+ "name": "onDark",
431
+ "privacy": "public",
432
+ "type": {
433
+ "text": "boolean"
434
+ },
435
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
436
+ "attribute": "onDark",
437
+ "reflects": true
669
438
  },
670
439
  {
671
440
  "kind": "field",
672
- "name": "appearance",
441
+ "name": "required",
673
442
  "privacy": "public",
674
443
  "type": {
675
- "text": "string"
444
+ "text": "boolean"
676
445
  },
677
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
678
- "default": "'default'",
679
- "attribute": "appearance",
446
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
447
+ "attribute": "required",
680
448
  "reflects": true
681
449
  },
682
450
  {
683
451
  "kind": "field",
684
- "name": "autocomplete",
452
+ "name": "setCustomValidity",
685
453
  "privacy": "public",
686
454
  "type": {
687
455
  "text": "string"
688
456
  },
689
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
690
- "attribute": "autocomplete",
691
- "reflects": true
457
+ "description": "Sets a custom help text message to display for all validityStates.",
458
+ "attribute": "setCustomValidity"
692
459
  },
693
460
  {
694
461
  "kind": "field",
695
- "name": "autoPlacement",
462
+ "name": "setCustomValidityCustomError",
696
463
  "privacy": "public",
697
464
  "type": {
698
- "text": "boolean"
465
+ "text": "string"
699
466
  },
700
- "description": "If declared, bib's position will be automatically calculated where to appear.",
701
- "attribute": "autoPlacement",
702
- "reflects": true
467
+ "description": "Custom help text message to display when validity = `customError`.",
468
+ "attribute": "setCustomValidityCustomError"
703
469
  },
704
470
  {
705
471
  "kind": "field",
706
- "name": "availableOptions",
707
- "privacy": "private",
472
+ "name": "setCustomValidityValueMissing",
473
+ "privacy": "public",
708
474
  "type": {
709
- "text": "array"
475
+ "text": "string"
710
476
  },
711
- "description": "Array of available options to display in the dropdown.",
712
- "attribute": "availableOptions"
477
+ "description": "Custom help text message to display when validity = `valueMissing`.",
478
+ "attribute": "setCustomValidityValueMissing"
713
479
  },
714
480
  {
715
481
  "kind": "field",
716
- "name": "behavior",
482
+ "name": "validity",
717
483
  "privacy": "public",
718
484
  "type": {
719
- "text": "'filter' | 'suggestion'"
485
+ "text": "string"
720
486
  },
721
- "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.",
722
- "default": "'suggestion'",
723
- "attribute": "behavior",
487
+ "description": "Specifies the `validityState` this element is in.",
488
+ "attribute": "validity",
724
489
  "reflects": true
490
+ }
491
+ ],
492
+ "events": [
493
+ {
494
+ "name": "input",
495
+ "type": {
496
+ "text": "CustomEvent"
497
+ }
725
498
  },
726
499
  {
727
- "kind": "field",
728
- "name": "checkmark",
729
- "privacy": "public",
500
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
501
+ "name": "auroFormElement-validated"
502
+ }
503
+ ],
504
+ "attributes": [
505
+ {
506
+ "name": "appearance",
730
507
  "type": {
731
- "text": "boolean"
508
+ "text": "'default' | 'inverse'"
732
509
  },
733
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
734
- "attribute": "checkmark",
735
- "reflects": true
510
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
511
+ "default": "'default'",
512
+ "fieldName": "appearance"
736
513
  },
737
514
  {
738
- "kind": "field",
739
515
  "name": "disabled",
740
- "privacy": "public",
741
516
  "type": {
742
517
  "text": "boolean"
743
518
  },
744
- "description": "If set, disables the combobox.",
745
- "attribute": "disabled",
746
- "reflects": true
519
+ "description": "If set, disables the checkbox group.",
520
+ "fieldName": "disabled"
747
521
  },
748
522
  {
749
- "kind": "field",
750
- "name": "dropdownId",
751
- "privacy": "private",
523
+ "name": "error",
752
524
  "type": {
753
525
  "text": "string"
754
526
  },
755
- "description": "ID for the dropdown."
527
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
528
+ "fieldName": "error"
756
529
  },
757
530
  {
758
- "kind": "field",
759
- "name": "dropdownOpen",
760
- "privacy": "private",
531
+ "name": "horizontal",
761
532
  "type": {
762
533
  "text": "boolean"
763
534
  },
764
- "description": "Whether or not the dropdown is open."
765
- },
766
- {
767
- "kind": "field",
768
- "name": "dvInputOnly",
769
- "privacy": "public",
770
- "type": {
771
- "text": "boolean"
772
- },
773
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
774
- "attribute": "dvInputOnly",
775
- "reflects": true
776
- },
777
- {
778
- "kind": "field",
779
- "name": "error",
780
- "privacy": "public",
781
- "type": {
782
- "text": "string"
783
- },
784
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
785
- "attribute": "error",
786
- "reflects": true
787
- },
788
- {
789
- "kind": "field",
790
- "name": "format",
791
- "privacy": "public",
792
- "type": {
793
- "text": "string"
794
- },
795
- "description": "Specifies the input mask format.",
796
- "attribute": "format",
797
- "reflects": true
798
- },
799
- {
800
- "kind": "field",
801
- "name": "inputmode",
802
- "privacy": "public",
803
- "type": {
804
- "text": "string"
805
- },
806
- "description": "Exposes inputmode attribute for input.",
807
- "attribute": "inputmode",
808
- "reflects": true
809
- },
810
- {
811
- "kind": "field",
812
- "name": "layout",
813
- "privacy": "public",
814
- "type": {
815
- "text": "string"
816
- },
817
- "description": "Sets the layout of the combobox.",
818
- "default": "'classic'",
819
- "attribute": "layout",
820
- "reflects": true,
821
- "inheritedFrom": {
822
- "name": "AuroElement",
823
- "module": "components/layoutElement/src/auroElement.js"
824
- }
825
- },
826
- {
827
- "kind": "field",
828
- "name": "matchWidth",
829
- "privacy": "private",
830
- "type": {
831
- "text": "boolean"
832
- },
833
- "description": "If declared, the popover and trigger will be set to the same width.",
834
- "attribute": "matchWidth",
835
- "reflects": true
836
- },
837
- {
838
- "kind": "field",
839
- "name": "noFilter",
840
- "privacy": "public",
841
- "type": {
842
- "text": "boolean"
843
- },
844
- "description": "If set, combobox will not filter menuoptions based on input.",
845
- "attribute": "noFilter",
846
- "reflects": true
847
- },
848
- {
849
- "kind": "field",
850
- "name": "noFlip",
851
- "privacy": "public",
852
- "type": {
853
- "text": "boolean"
854
- },
855
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
856
- "attribute": "noFlip",
857
- "reflects": true
858
- },
859
- {
860
- "kind": "field",
861
- "name": "shift",
862
- "privacy": "public",
863
- "type": {
864
- "text": "boolean"
865
- },
866
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
867
- "attribute": "shift",
868
- "reflects": true
535
+ "description": "If set, checkboxes will be aligned horizontally.",
536
+ "fieldName": "horizontal"
869
537
  },
870
538
  {
871
- "kind": "field",
872
539
  "name": "noValidate",
873
- "privacy": "public",
874
540
  "type": {
875
541
  "text": "boolean"
876
542
  },
877
543
  "description": "If set, disables auto-validation on blur.",
878
- "attribute": "noValidate",
879
- "reflects": true
880
- },
881
- {
882
- "kind": "field",
883
- "name": "offset",
884
- "privacy": "public",
885
- "type": {
886
- "text": "number"
887
- },
888
- "description": "Gap between the trigger element and bib.",
889
- "default": "0",
890
- "attribute": "offset",
891
- "reflects": true
544
+ "fieldName": "noValidate"
892
545
  },
893
546
  {
894
- "kind": "field",
895
547
  "name": "onDark",
896
- "privacy": "public",
897
548
  "type": {
898
549
  "text": "boolean"
899
550
  },
900
- "attribute": "onDark",
901
- "reflects": true,
902
551
  "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
903
- "inheritedFrom": {
904
- "name": "AuroElement",
905
- "module": "components/layoutElement/src/auroElement.js"
906
- }
907
- },
908
- {
909
- "kind": "field",
910
- "name": "optionSelected",
911
- "privacy": "public",
912
- "type": {
913
- "text": "HTMLElement"
914
- },
915
- "description": "Specifies the current selected option.",
916
- "attribute": "optionSelected"
917
- },
918
- {
919
- "kind": "field",
920
- "name": "persistInput",
921
- "privacy": "public",
922
- "type": {
923
- "text": "boolean"
924
- },
925
- "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.",
926
- "attribute": "persistInput",
927
- "reflects": true
928
- },
929
- {
930
- "kind": "field",
931
- "name": "placement",
932
- "privacy": "public",
933
- "type": {
934
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
935
- },
936
- "description": "Position where the bib should appear relative to the trigger.",
937
- "default": "'bottom-start'",
938
- "attribute": "placement",
939
- "reflects": true
940
- },
941
- {
942
- "kind": "field",
943
- "name": "placeholder",
944
- "privacy": "public",
945
- "type": {
946
- "text": "string"
947
- },
948
- "description": "Define custom placeholder text, only supported by date input formats.",
949
- "attribute": "placeholder",
950
- "reflects": true
552
+ "fieldName": "onDark"
951
553
  },
952
554
  {
953
- "kind": "field",
954
555
  "name": "required",
955
- "privacy": "public",
956
556
  "type": {
957
557
  "text": "boolean"
958
558
  },
959
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
960
- "attribute": "required",
961
- "reflects": true
559
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
560
+ "fieldName": "required"
962
561
  },
963
562
  {
964
- "kind": "field",
965
563
  "name": "setCustomValidity",
966
- "privacy": "public",
967
564
  "type": {
968
565
  "text": "string"
969
566
  },
970
567
  "description": "Sets a custom help text message to display for all validityStates.",
971
- "attribute": "setCustomValidity"
568
+ "fieldName": "setCustomValidity"
972
569
  },
973
570
  {
974
- "kind": "field",
975
571
  "name": "setCustomValidityCustomError",
976
- "privacy": "public",
977
572
  "type": {
978
573
  "text": "string"
979
574
  },
980
575
  "description": "Custom help text message to display when validity = `customError`.",
981
- "attribute": "setCustomValidityCustomError"
576
+ "fieldName": "setCustomValidityCustomError"
982
577
  },
983
578
  {
984
- "kind": "field",
985
579
  "name": "setCustomValidityValueMissing",
986
- "privacy": "public",
987
580
  "type": {
988
581
  "text": "string"
989
582
  },
990
583
  "description": "Custom help text message to display when validity = `valueMissing`.",
991
- "attribute": "setCustomValidityValueMissing"
584
+ "fieldName": "setCustomValidityValueMissing"
992
585
  },
993
586
  {
994
- "kind": "field",
995
- "name": "setCustomValidityValueMissingFilter",
996
- "privacy": "public",
587
+ "name": "validity",
997
588
  "type": {
998
589
  "text": "string"
999
590
  },
1000
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1001
- "attribute": "setCustomValidityValueMissingFilter"
1002
- },
591
+ "description": "Specifies the `validityState` this element is in.",
592
+ "fieldName": "validity"
593
+ }
594
+ ],
595
+ "superclass": {
596
+ "name": "LitElement",
597
+ "package": "lit"
598
+ },
599
+ "tagName": "auro-checkbox-group",
600
+ "customElement": true
601
+ }
602
+ ],
603
+ "exports": [
604
+ {
605
+ "kind": "js",
606
+ "name": "AuroCheckboxGroup",
607
+ "declaration": {
608
+ "name": "AuroCheckboxGroup",
609
+ "module": "components/checkbox/src/auro-checkbox-group.js"
610
+ }
611
+ }
612
+ ]
613
+ },
614
+ {
615
+ "kind": "javascript-module",
616
+ "path": "components/checkbox/src/auro-checkbox.js",
617
+ "declarations": [
618
+ {
619
+ "kind": "class",
620
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
621
+ "name": "AuroCheckbox",
622
+ "cssParts": [
1003
623
  {
1004
- "kind": "field",
1005
- "name": "touched",
1006
- "privacy": "private",
1007
- "type": {
1008
- "text": "boolean"
1009
- },
1010
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
624
+ "description": "apply css to a specific checkbox.",
625
+ "name": "checkbox"
1011
626
  },
1012
627
  {
1013
- "kind": "field",
1014
- "name": "triggerIcon",
1015
- "privacy": "public",
1016
- "type": {
1017
- "text": "boolean"
1018
- },
1019
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1020
- "attribute": "triggerIcon",
1021
- "reflects": true
628
+ "description": "apply css to a specific checkbox's input.",
629
+ "name": "checkbox-input"
1022
630
  },
1023
631
  {
1024
- "kind": "field",
1025
- "name": "type",
1026
- "privacy": "public",
1027
- "type": {
1028
- "text": "string"
1029
- },
1030
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1031
- "attribute": "type",
1032
- "reflects": true
632
+ "description": "apply css to a specific checkbox's label.",
633
+ "name": "checkbox-label"
634
+ }
635
+ ],
636
+ "slots": [
637
+ {
638
+ "description": "The default slot for the checkbox label.",
639
+ "name": "default"
640
+ }
641
+ ],
642
+ "members": [
643
+ {
644
+ "kind": "method",
645
+ "name": "_initializeDefaults"
646
+ },
647
+ {
648
+ "kind": "method",
649
+ "name": "register",
650
+ "static": true,
651
+ "parameters": [
652
+ {
653
+ "name": "name",
654
+ "default": "\"auro-checkbox\"",
655
+ "description": "The name of element that you want to register to.",
656
+ "optional": true,
657
+ "type": {
658
+ "text": "string"
659
+ }
660
+ }
661
+ ],
662
+ "description": "This will register this element with the browser."
663
+ },
664
+ {
665
+ "kind": "method",
666
+ "name": "handleChange",
667
+ "parameters": [
668
+ {
669
+ "name": "event",
670
+ "description": "The change event from the checkbox input.",
671
+ "type": {
672
+ "text": "Event"
673
+ }
674
+ }
675
+ ],
676
+ "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.",
677
+ "privacy": "private",
678
+ "return": {
679
+ "type": {
680
+ "text": "void"
681
+ }
682
+ }
683
+ },
684
+ {
685
+ "kind": "method",
686
+ "name": "handleInput",
687
+ "parameters": [
688
+ {
689
+ "name": "event",
690
+ "description": "The input event from the checkbox input.",
691
+ "type": {
692
+ "text": "Event"
693
+ }
694
+ }
695
+ ],
696
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
697
+ "privacy": "private",
698
+ "return": {
699
+ "type": {
700
+ "text": "void"
701
+ }
702
+ }
703
+ },
704
+ {
705
+ "kind": "method",
706
+ "name": "handleFocusin",
707
+ "description": "Function to support",
708
+ "privacy": "private",
709
+ "return": {
710
+ "type": {
711
+ "text": "void"
712
+ }
713
+ }
714
+ },
715
+ {
716
+ "kind": "method",
717
+ "name": "generateIconHtml",
718
+ "description": "Function to generate checkmark svg.",
719
+ "privacy": "private",
720
+ "return": {
721
+ "type": {
722
+ "text": "HTMLElement"
723
+ }
724
+ }
725
+ },
726
+ {
727
+ "kind": "method",
728
+ "name": "reset",
729
+ "description": "Resets component to initial state.",
730
+ "return": {
731
+ "type": {
732
+ "text": "void"
733
+ }
734
+ }
735
+ },
736
+ {
737
+ "kind": "method",
738
+ "name": "updateAriaLabel",
739
+ "description": "Updates the aria-label based on slot content.",
740
+ "privacy": "private",
741
+ "return": {
742
+ "type": {
743
+ "text": "void"
744
+ }
745
+ }
746
+ },
747
+ {
748
+ "kind": "method",
749
+ "name": "handleKeyDown",
750
+ "parameters": [
751
+ {
752
+ "name": "event",
753
+ "description": "The keydown event from the checkbox input.",
754
+ "type": {
755
+ "text": "KeyboardEvent"
756
+ }
757
+ }
758
+ ],
759
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
760
+ "privacy": "private",
761
+ "return": {
762
+ "type": {
763
+ "text": "void"
764
+ }
765
+ }
1033
766
  },
1034
767
  {
1035
768
  "kind": "field",
1036
- "name": "typedValue",
769
+ "name": "appearance",
1037
770
  "privacy": "public",
1038
771
  "type": {
1039
- "text": "string"
772
+ "text": "'default' | 'inverse'"
1040
773
  },
1041
- "description": "Specifies the value of the input element within the combobox.",
1042
- "attribute": "typedValue",
774
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
775
+ "default": "'default'",
776
+ "attribute": "appearance",
1043
777
  "reflects": true
1044
778
  },
1045
779
  {
1046
780
  "kind": "field",
1047
- "name": "validity",
781
+ "name": "checked",
1048
782
  "privacy": "public",
1049
783
  "type": {
1050
- "text": "string"
784
+ "text": "boolean"
1051
785
  },
1052
- "description": "Specifies the `validityState` this element is in.",
1053
- "attribute": "validity",
786
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
787
+ "attribute": "checked",
1054
788
  "reflects": true
1055
789
  },
1056
790
  {
1057
791
  "kind": "field",
1058
- "name": "value",
792
+ "name": "disabled",
1059
793
  "privacy": "public",
1060
794
  "type": {
1061
- "text": "string"
795
+ "text": "boolean"
1062
796
  },
1063
- "description": "Value selected for the dropdown menu.",
1064
- "attribute": "value"
797
+ "description": "If set to true, the checkbox will not be clickable.",
798
+ "attribute": "disabled",
799
+ "reflects": true
1065
800
  },
1066
801
  {
1067
802
  "kind": "field",
1068
- "name": "largeFullscreenHeadline",
803
+ "name": "error",
1069
804
  "privacy": "public",
1070
805
  "type": {
1071
806
  "text": "boolean"
1072
807
  },
1073
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1074
- "attribute": "largeFullscreenHeadline",
808
+ "description": "If set to true, the checkbox will be displayed with an error state.",
809
+ "attribute": "error",
1075
810
  "reflects": true
1076
811
  },
1077
812
  {
1078
813
  "kind": "field",
1079
- "name": "fullscreenBreakpoint",
814
+ "name": "id",
1080
815
  "privacy": "public",
1081
816
  "type": {
1082
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
817
+ "text": "string"
1083
818
  },
1084
- "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.",
1085
- "default": "'sm'",
1086
- "attribute": "fullscreenBreakpoint",
1087
- "reflects": true
819
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
820
+ "attribute": "id"
1088
821
  },
1089
822
  {
1090
823
  "kind": "field",
1091
- "name": "optionActive",
824
+ "name": "inputId",
1092
825
  "privacy": "private",
1093
826
  "type": {
1094
- "text": "object"
827
+ "text": "string"
1095
828
  },
1096
- "description": "Specifies the currently active option."
829
+ "description": "The id for input node."
1097
830
  },
1098
831
  {
1099
832
  "kind": "field",
1100
- "name": "triggerExpandedState",
1101
- "privacy": "private",
833
+ "name": "name",
834
+ "privacy": "public",
1102
835
  "type": {
1103
- "text": "boolean"
836
+ "text": "string"
1104
837
  },
1105
- "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
838
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
839
+ "attribute": "name"
1106
840
  },
1107
841
  {
1108
842
  "kind": "field",
1109
- "name": "componentHasFocus",
1110
- "description": "Returns true if the element has focus.",
1111
- "privacy": "private",
1112
- "return": {
1113
- "type": {
1114
- "text": "boolean"
1115
- }
843
+ "name": "onDark",
844
+ "privacy": "public",
845
+ "type": {
846
+ "text": "boolean"
1116
847
  },
1117
- "readonly": true,
1118
- "inheritedFrom": {
1119
- "name": "AuroElement",
1120
- "module": "components/layoutElement/src/auroElement.js"
1121
- }
1122
- },
1123
- {
1124
- "kind": "method",
1125
- "name": "resetShapeClasses",
1126
- "inheritedFrom": {
1127
- "name": "AuroElement",
1128
- "module": "components/layoutElement/src/auroElement.js"
1129
- }
1130
- },
1131
- {
1132
- "kind": "method",
1133
- "name": "resetLayoutClasses",
1134
- "inheritedFrom": {
1135
- "name": "AuroElement",
1136
- "module": "components/layoutElement/src/auroElement.js"
1137
- }
1138
- },
1139
- {
1140
- "kind": "method",
1141
- "name": "updateComponentArchitecture",
1142
- "inheritedFrom": {
1143
- "name": "AuroElement",
1144
- "module": "components/layoutElement/src/auroElement.js"
1145
- }
848
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
849
+ "attribute": "onDark",
850
+ "reflects": true
1146
851
  },
1147
852
  {
1148
853
  "kind": "field",
1149
- "name": "shape",
1150
- "privacy": "public",
854
+ "name": "touched",
855
+ "privacy": "private",
1151
856
  "type": {
1152
- "text": "string"
857
+ "text": "boolean"
1153
858
  },
1154
- "attribute": "shape",
1155
- "reflects": true,
1156
- "inheritedFrom": {
1157
- "name": "AuroElement",
1158
- "module": "components/layoutElement/src/auroElement.js"
1159
- }
859
+ "description": "Indicates whether the checkbox has been interacted with."
1160
860
  },
1161
861
  {
1162
862
  "kind": "field",
1163
- "name": "size",
863
+ "name": "value",
1164
864
  "privacy": "public",
1165
865
  "type": {
1166
866
  "text": "string"
1167
867
  },
1168
- "attribute": "size",
1169
- "reflects": true,
1170
- "inheritedFrom": {
1171
- "name": "AuroElement",
1172
- "module": "components/layoutElement/src/auroElement.js"
1173
- }
1174
- }
1175
- ],
1176
- "events": [
1177
- {
1178
- "name": "inputValue",
1179
- "type": {
1180
- "text": "CustomEvent"
1181
- },
1182
- "description": "Notifies that the components internal HTML5 input value has changed."
1183
- },
1184
- {
1185
- "name": "input",
1186
- "type": {
1187
- "text": "CustomEvent"
1188
- },
1189
- "description": "Notifies that the component has a new value set."
868
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
869
+ "attribute": "value"
1190
870
  },
1191
871
  {
1192
- "name": "auroCombobox-valueSet",
872
+ "kind": "field",
873
+ "name": "tabIndex",
874
+ "privacy": "private",
1193
875
  "type": {
1194
- "text": "CustomEvent"
876
+ "text": "number"
1195
877
  },
1196
- "description": "(Deprecated) Notifies that the component has a new value set."
878
+ "description": "The tabindex attribute for the checkbox.",
879
+ "attribute": "tabindex",
880
+ "reflects": true
1197
881
  },
1198
882
  {
1199
- "description": "Notifies that the component value(s) have been validated.",
1200
- "name": "auroFormElement-validated"
1201
- }
1202
- ],
1203
- "attributes": [
1204
- {
1205
- "name": "appearance",
883
+ "kind": "field",
884
+ "name": "ariaChecked",
885
+ "privacy": "private",
1206
886
  "type": {
1207
887
  "text": "string"
1208
888
  },
1209
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1210
- "default": "'default'",
1211
- "fieldName": "appearance"
889
+ "description": "The aria-checked attribute for the checkbox.",
890
+ "attribute": "aria-checked",
891
+ "reflects": true
1212
892
  },
1213
893
  {
1214
- "name": "autocomplete",
894
+ "kind": "field",
895
+ "name": "ariaDisabled",
896
+ "privacy": "private",
1215
897
  "type": {
1216
898
  "text": "string"
1217
899
  },
1218
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1219
- "fieldName": "autocomplete"
1220
- },
1221
- {
1222
- "name": "autoPlacement",
1223
- "type": {
1224
- "text": "boolean"
1225
- },
1226
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1227
- "fieldName": "autoPlacement"
1228
- },
1229
- {
1230
- "name": "availableOptions",
1231
- "type": {
1232
- "text": "array"
1233
- },
1234
- "description": "Array of available options to display in the dropdown.",
1235
- "fieldName": "availableOptions"
1236
- },
1237
- {
1238
- "name": "behavior",
1239
- "type": {
1240
- "text": "'filter' | 'suggestion'"
1241
- },
1242
- "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.",
1243
- "default": "'suggestion'",
1244
- "fieldName": "behavior"
1245
- },
1246
- {
1247
- "name": "checkmark",
1248
- "type": {
1249
- "text": "boolean"
1250
- },
1251
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1252
- "fieldName": "checkmark"
900
+ "description": "The aria-disabled attribute for the checkbox.",
901
+ "attribute": "aria-disabled",
902
+ "reflects": true
1253
903
  },
1254
904
  {
1255
- "name": "disabled",
905
+ "kind": "field",
906
+ "name": "role",
907
+ "privacy": "private",
1256
908
  "type": {
1257
- "text": "boolean"
909
+ "text": "string"
1258
910
  },
1259
- "description": "If set, disables the combobox.",
1260
- "fieldName": "disabled"
1261
- },
911
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
912
+ "attribute": "role",
913
+ "reflects": true
914
+ }
915
+ ],
916
+ "events": [
1262
917
  {
1263
- "name": "dvInputOnly",
918
+ "name": "auroCheckbox-input",
1264
919
  "type": {
1265
- "text": "boolean"
1266
- },
1267
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1268
- "fieldName": "dvInputOnly"
920
+ "text": "CustomEvent"
921
+ }
1269
922
  },
1270
923
  {
1271
- "name": "error",
924
+ "name": "auroCheckbox-focusin",
1272
925
  "type": {
1273
- "text": "string"
1274
- },
1275
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1276
- "fieldName": "error"
926
+ "text": "CustomEvent"
927
+ }
1277
928
  },
1278
929
  {
1279
- "name": "format",
930
+ "name": "auroCheckbox-focusout",
1280
931
  "type": {
1281
- "text": "string"
1282
- },
1283
- "description": "Specifies the input mask format.",
1284
- "fieldName": "format"
932
+ "text": "CustomEvent"
933
+ }
1285
934
  },
1286
935
  {
1287
- "name": "inputmode",
1288
936
  "type": {
1289
- "text": "string"
937
+ "text": "CustomEvent<any>"
1290
938
  },
1291
- "description": "Exposes inputmode attribute for input.",
1292
- "fieldName": "inputmode"
939
+ "description": "(Deprecated) Notifies when checked value is changed.",
940
+ "name": "change"
1293
941
  },
1294
942
  {
1295
- "name": "layout",
1296
943
  "type": {
1297
- "text": "string"
944
+ "text": "InputEvent"
1298
945
  },
1299
- "description": "Sets the layout of the combobox.",
1300
- "default": "'classic'",
1301
- "fieldName": "layout",
1302
- "inheritedFrom": {
1303
- "name": "AuroElement",
1304
- "module": "components/layoutElement/src/auroElement.js"
1305
- }
1306
- },
946
+ "description": "Notifies when when checked value is changed by user's interface.",
947
+ "name": "input"
948
+ }
949
+ ],
950
+ "attributes": [
1307
951
  {
1308
- "name": "matchWidth",
952
+ "name": "appearance",
1309
953
  "type": {
1310
- "text": "boolean"
954
+ "text": "'default' | 'inverse'"
1311
955
  },
1312
- "description": "If declared, the popover and trigger will be set to the same width.",
1313
- "fieldName": "matchWidth"
956
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
957
+ "default": "'default'",
958
+ "fieldName": "appearance"
1314
959
  },
1315
960
  {
1316
- "name": "noFilter",
961
+ "name": "checked",
1317
962
  "type": {
1318
963
  "text": "boolean"
1319
964
  },
1320
- "description": "If set, combobox will not filter menuoptions based on input.",
1321
- "fieldName": "noFilter"
965
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
966
+ "fieldName": "checked"
1322
967
  },
1323
968
  {
1324
- "name": "noFlip",
969
+ "name": "disabled",
1325
970
  "type": {
1326
971
  "text": "boolean"
1327
972
  },
1328
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1329
- "fieldName": "noFlip"
973
+ "description": "If set to true, the checkbox will not be clickable.",
974
+ "fieldName": "disabled"
1330
975
  },
1331
976
  {
1332
- "name": "shift",
977
+ "name": "error",
1333
978
  "type": {
1334
979
  "text": "boolean"
1335
980
  },
1336
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1337
- "fieldName": "shift"
981
+ "description": "If set to true, the checkbox will be displayed with an error state.",
982
+ "fieldName": "error"
1338
983
  },
1339
984
  {
1340
- "name": "noValidate",
985
+ "name": "id",
1341
986
  "type": {
1342
- "text": "boolean"
987
+ "text": "string"
1343
988
  },
1344
- "description": "If set, disables auto-validation on blur.",
1345
- "fieldName": "noValidate"
989
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
990
+ "fieldName": "id"
1346
991
  },
1347
992
  {
1348
- "name": "offset",
993
+ "name": "name",
1349
994
  "type": {
1350
- "text": "number"
995
+ "text": "string"
1351
996
  },
1352
- "description": "Gap between the trigger element and bib.",
1353
- "default": "0",
1354
- "fieldName": "offset"
997
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
998
+ "fieldName": "name"
1355
999
  },
1356
1000
  {
1357
1001
  "name": "onDark",
@@ -1362,272 +1006,170 @@
1362
1006
  "fieldName": "onDark"
1363
1007
  },
1364
1008
  {
1365
- "name": "optionSelected",
1366
- "type": {
1367
- "text": "HTMLElement"
1368
- },
1369
- "description": "Specifies the current selected option.",
1370
- "fieldName": "optionSelected"
1371
- },
1372
- {
1373
- "name": "persistInput",
1374
- "type": {
1375
- "text": "boolean"
1376
- },
1377
- "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.",
1378
- "fieldName": "persistInput"
1379
- },
1380
- {
1381
- "name": "placement",
1382
- "type": {
1383
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1384
- },
1385
- "description": "Position where the bib should appear relative to the trigger.",
1386
- "default": "'bottom-start'",
1387
- "fieldName": "placement"
1388
- },
1389
- {
1390
- "name": "placeholder",
1009
+ "name": "value",
1391
1010
  "type": {
1392
1011
  "text": "string"
1393
1012
  },
1394
- "description": "Define custom placeholder text, only supported by date input formats.",
1395
- "fieldName": "placeholder"
1013
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1014
+ "fieldName": "value"
1396
1015
  },
1397
1016
  {
1398
- "name": "required",
1017
+ "name": "tabindex",
1399
1018
  "type": {
1400
- "text": "boolean"
1019
+ "text": "number"
1401
1020
  },
1402
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1403
- "fieldName": "required"
1021
+ "description": "The tabindex attribute for the checkbox.",
1022
+ "fieldName": "tabIndex"
1404
1023
  },
1405
1024
  {
1406
- "name": "setCustomValidity",
1025
+ "name": "aria-checked",
1407
1026
  "type": {
1408
1027
  "text": "string"
1409
1028
  },
1410
- "description": "Sets a custom help text message to display for all validityStates.",
1411
- "fieldName": "setCustomValidity"
1029
+ "description": "The aria-checked attribute for the checkbox.",
1030
+ "fieldName": "ariaChecked"
1412
1031
  },
1413
1032
  {
1414
- "name": "setCustomValidityCustomError",
1033
+ "name": "aria-disabled",
1415
1034
  "type": {
1416
1035
  "text": "string"
1417
1036
  },
1418
- "description": "Custom help text message to display when validity = `customError`.",
1419
- "fieldName": "setCustomValidityCustomError"
1037
+ "description": "The aria-disabled attribute for the checkbox.",
1038
+ "fieldName": "ariaDisabled"
1420
1039
  },
1421
1040
  {
1422
- "name": "setCustomValidityValueMissing",
1041
+ "name": "role",
1423
1042
  "type": {
1424
1043
  "text": "string"
1425
1044
  },
1426
- "description": "Custom help text message to display when validity = `valueMissing`.",
1427
- "fieldName": "setCustomValidityValueMissing"
1428
- },
1429
- {
1430
- "name": "setCustomValidityValueMissingFilter",
1431
- "type": {
1432
- "text": "string"
1433
- },
1434
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1435
- "fieldName": "setCustomValidityValueMissingFilter"
1436
- },
1437
- {
1438
- "name": "triggerIcon",
1439
- "type": {
1440
- "text": "boolean"
1441
- },
1442
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1443
- "fieldName": "triggerIcon"
1444
- },
1445
- {
1446
- "name": "type",
1447
- "type": {
1448
- "text": "string"
1449
- },
1450
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1451
- "fieldName": "type"
1452
- },
1453
- {
1454
- "name": "typedValue",
1455
- "type": {
1456
- "text": "string"
1457
- },
1458
- "description": "Specifies the value of the input element within the combobox.",
1459
- "fieldName": "typedValue"
1460
- },
1461
- {
1462
- "name": "validity",
1463
- "type": {
1464
- "text": "string"
1465
- },
1466
- "description": "Specifies the `validityState` this element is in.",
1467
- "fieldName": "validity"
1468
- },
1469
- {
1470
- "name": "value",
1471
- "type": {
1472
- "text": "string"
1473
- },
1474
- "description": "Value selected for the dropdown menu.",
1475
- "fieldName": "value"
1476
- },
1477
- {
1478
- "name": "largeFullscreenHeadline",
1479
- "type": {
1480
- "text": "boolean"
1481
- },
1482
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1483
- "fieldName": "largeFullscreenHeadline"
1484
- },
1485
- {
1486
- "name": "fullscreenBreakpoint",
1487
- "type": {
1488
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1489
- },
1490
- "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.",
1491
- "default": "'sm'",
1492
- "fieldName": "fullscreenBreakpoint"
1493
- },
1494
- {
1495
- "name": "shape",
1496
- "type": {
1497
- "text": "string"
1498
- },
1499
- "fieldName": "shape",
1500
- "inheritedFrom": {
1501
- "name": "AuroElement",
1502
- "module": "components/layoutElement/src/auroElement.js"
1503
- }
1504
- },
1505
- {
1506
- "name": "size",
1507
- "type": {
1508
- "text": "string"
1509
- },
1510
- "fieldName": "size",
1511
- "inheritedFrom": {
1512
- "name": "AuroElement",
1513
- "module": "components/layoutElement/src/auroElement.js"
1514
- }
1515
- },
1516
- {
1517
- "name": "ondark",
1518
- "type": {
1519
- "text": "boolean"
1520
- },
1521
- "fieldName": "onDark",
1522
- "inheritedFrom": {
1523
- "name": "AuroElement",
1524
- "module": "components/layoutElement/src/auroElement.js"
1525
- }
1045
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
1046
+ "fieldName": "role"
1526
1047
  }
1527
1048
  ],
1528
1049
  "superclass": {
1529
- "name": "AuroElement",
1530
- "module": "/components/layoutElement/src/auroElement.js"
1050
+ "name": "LitElement",
1051
+ "package": "lit"
1531
1052
  },
1532
- "tagName": "auro-combobox",
1053
+ "tagName": "auro-checkbox",
1533
1054
  "customElement": true
1534
1055
  }
1535
1056
  ],
1536
1057
  "exports": [
1537
1058
  {
1538
1059
  "kind": "js",
1539
- "name": "AuroCombobox",
1060
+ "name": "AuroCheckbox",
1540
1061
  "declaration": {
1541
- "name": "AuroCombobox",
1542
- "module": "components/combobox/src/auro-combobox.js"
1062
+ "name": "AuroCheckbox",
1063
+ "module": "components/checkbox/src/auro-checkbox.js"
1543
1064
  }
1544
1065
  }
1545
1066
  ]
1546
1067
  },
1547
1068
  {
1548
1069
  "kind": "javascript-module",
1549
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1550
- "declarations": [
1551
- {
1552
- "kind": "variable",
1553
- "name": "comboboxKeyboardStrategy",
1554
- "type": {
1555
- "text": "object"
1556
- },
1557
- "default": "{ async Enter(component, evt, 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. if (isClearBtnFocused(ctx)) { evt.stopPropagation(); return; } if (ctx.isExpanded && component.optionActive) { component.menu.makeSelection(); await component.updateComplete; evt.preventDefault(); evt.stopPropagation(); component.setClearBtnFocus(); } 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(); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Shift+Tab moves the highlight to the first non-disabled option // without making a selection or closing the bib. if (evt.shiftKey) { evt.preventDefault(); const firstActive = component.menu.menuService.menuOptions.find((option) => option.isActive); if (firstActive) { component.menu.updateActiveOption(firstActive); } return; } if (ctx.isModal) { if (!ctx.activeInput) { return; } const clearBtn = getClearBtn(ctx); const clearBtnHasFocus = isClearBtnFocused(ctx, clearBtn); // Tab from input: if clear button exists and doesn't have focus, focus it if (clearBtn && !clearBtnHasFocus && ctx.activeInput.value) { // Force clear button container visible to work around Safari not // propagating :focus-within through shadow DOM boundaries, which // causes .wrapper:not(:focus-within) to hide .notification.clear. const clearContainer = clearBtn.closest('.clear'); if (clearContainer) { clearContainer.style.display = 'flex'; clearBtn.addEventListener('focusout', () => { // Delay cleanup so :focus-within settles when focus moves // to a sibling (e.g., Shift+Tab back to the input). requestAnimationFrame(() => { clearContainer.style.display = ''; }); }, { once: true }); } // Focus the native button inside auro-button so the browser // treats it as a real focusable element inside the dialog. const nativeBtn = clearBtn.shadowRoot && clearBtn.shadowRoot.querySelector('button'); if (nativeBtn) { nativeBtn.focus(); } else { clearBtn.focus(); } return; } // Tab from clear button (or no clear button / no value) → // select the highlighted option if any, then close if (component.optionActive) { component.menu.makeSelection(); } component.hideBib(); return; } // Non-fullscreen: select + close if (component.menu.optionActive && component.menu.optionActive.value) { component.menu.value = component.menu.optionActive.value; } component.hideBib(); }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } if (component.availableOptions.length > 0) { component.showBib(); } // Read live visibility — ctx.isExpanded was computed before showBib() above, // so it wouldn't reflect the state change. if (component.dropdown.isPopoverVisible) { evt.preventDefault(); navigateArrow(component, 'up'); } }, ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } if (component.availableOptions.length > 0) { component.showBib(); } // Read live visibility — ctx.isExpanded was computed before showBib() above, // so it wouldn't reflect the state change. if (component.dropdown.isPopoverVisible) { evt.preventDefault(); navigateArrow(component, 'down'); } }, }"
1558
- }
1559
- ],
1070
+ "path": "components/checkbox/src/index.js",
1071
+ "declarations": [],
1560
1072
  "exports": [
1561
1073
  {
1562
1074
  "kind": "js",
1563
- "name": "comboboxKeyboardStrategy",
1075
+ "name": "AuroCheckbox",
1564
1076
  "declaration": {
1565
- "name": "comboboxKeyboardStrategy",
1566
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1077
+ "name": "AuroCheckbox",
1078
+ "module": "components/checkbox/src/index.js"
1567
1079
  }
1568
- }
1569
- ]
1570
- },
1571
- {
1572
- "kind": "javascript-module",
1573
- "path": "components/combobox/src/index.js",
1574
- "declarations": [],
1575
- "exports": [
1080
+ },
1576
1081
  {
1577
1082
  "kind": "js",
1578
- "name": "AuroCombobox",
1083
+ "name": "AuroCheckboxGroup",
1579
1084
  "declaration": {
1580
- "name": "AuroCombobox",
1581
- "module": "components/combobox/src/index.js"
1085
+ "name": "AuroCheckboxGroup",
1086
+ "module": "components/checkbox/src/index.js"
1582
1087
  }
1583
1088
  }
1584
1089
  ]
1585
1090
  },
1586
1091
  {
1587
1092
  "kind": "javascript-module",
1588
- "path": "components/combobox/src/registered.js",
1093
+ "path": "components/checkbox/src/registered.js",
1589
1094
  "declarations": [],
1590
- "exports": [
1591
- {
1592
- "kind": "js",
1593
- "name": "AuroCombobox",
1594
- "declaration": {
1595
- "name": "AuroCombobox",
1596
- "module": "components/combobox/src/registered.js"
1597
- }
1598
- }
1599
- ]
1095
+ "exports": []
1600
1096
  },
1601
1097
  {
1602
1098
  "kind": "javascript-module",
1603
- "path": "components/checkbox/src/auro-checkbox-group.js",
1099
+ "path": "components/combobox/src/auro-combobox.js",
1604
1100
  "declarations": [
1605
1101
  {
1606
1102
  "kind": "class",
1607
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1608
- "name": "AuroCheckboxGroup",
1103
+ "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.",
1104
+ "name": "AuroCombobox",
1609
1105
  "slots": [
1610
1106
  {
1611
- "description": "Allows for the legend to be overridden.",
1612
- "name": "legend"
1107
+ "description": "Default slot for the menu content.",
1108
+ "name": ""
1613
1109
  },
1614
1110
  {
1111
+ "type": {
1112
+ "text": "HTMLSlotElement"
1113
+ },
1615
1114
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1616
1115
  "name": "optionalLabel"
1617
1116
  },
1618
1117
  {
1619
- "description": "Allows for the helper text to be overridden.",
1118
+ "description": "Sets aria-label on clear button",
1119
+ "name": "ariaLabel.input.clear"
1120
+ },
1121
+ {
1122
+ "description": "Sets aria-label on close button in fullscreen bib",
1123
+ "name": "ariaLabel.bib.close"
1124
+ },
1125
+ {
1126
+ "description": "Defines the headline to display above menu-options",
1127
+ "name": "bib.fullscreen.headline"
1128
+ },
1129
+ {
1130
+ "description": "Defines the content of the label.",
1131
+ "name": "label"
1132
+ },
1133
+ {
1134
+ "description": "Defines the content of the helpText.",
1620
1135
  "name": "helpText"
1621
1136
  },
1622
1137
  {
1623
- "description": "The default slot for the checkbox items.",
1624
- "name": "default"
1138
+ "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
1139
+ "name": "displayValue"
1625
1140
  }
1626
1141
  ],
1627
1142
  "members": [
1628
1143
  {
1629
1144
  "kind": "method",
1630
- "name": "_initializeDefaults"
1145
+ "name": "_initializeDefaults",
1146
+ "privacy": "private",
1147
+ "return": {
1148
+ "type": {
1149
+ "text": "void"
1150
+ }
1151
+ }
1152
+ },
1153
+ {
1154
+ "kind": "field",
1155
+ "name": "inputValue",
1156
+ "description": "Returns the current value of the input element within the combobox.",
1157
+ "return": {
1158
+ "type": {
1159
+ "text": "string|undefined"
1160
+ }
1161
+ },
1162
+ "readonly": true
1163
+ },
1164
+ {
1165
+ "kind": "method",
1166
+ "name": "isValid",
1167
+ "description": "Checks if the element is valid.",
1168
+ "return": {
1169
+ "type": {
1170
+ "text": "boolean"
1171
+ }
1172
+ }
1631
1173
  },
1632
1174
  {
1633
1175
  "kind": "method",
@@ -1636,7 +1178,7 @@
1636
1178
  "parameters": [
1637
1179
  {
1638
1180
  "name": "name",
1639
- "default": "\"auro-checkbox-group\"",
1181
+ "default": "'auro-combobox'",
1640
1182
  "description": "The name of the element that you want to register.",
1641
1183
  "optional": true,
1642
1184
  "type": {
@@ -1648,35 +1190,14 @@
1648
1190
  },
1649
1191
  {
1650
1192
  "kind": "method",
1651
- "name": "handleValueUpdate",
1652
- "parameters": [
1653
- {
1654
- "name": "value",
1655
- "description": "The value of the checkbox.",
1656
- "type": {
1657
- "text": "String"
1658
- }
1659
- },
1660
- {
1661
- "name": "selected",
1662
- "description": "The checked state of the checkbox.",
1663
- "type": {
1664
- "text": "Boolean"
1665
- }
1666
- }
1667
- ],
1668
- "description": "Helper method to handle checkbox value changing.",
1669
- "privacy": "private",
1670
- "return": {
1671
- "type": {
1672
- "text": "void"
1673
- }
1674
- }
1193
+ "name": "updateFilter",
1194
+ "description": "Updates the filter for the available options based on the input value.",
1195
+ "privacy": "private"
1675
1196
  },
1676
1197
  {
1677
1198
  "kind": "method",
1678
- "name": "handlePreselectedItems",
1679
- "description": "Helper method that handles the state of preselected checkboxes.",
1199
+ "name": "syncValuesAndStates",
1200
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1680
1201
  "privacy": "private",
1681
1202
  "return": {
1682
1203
  "type": {
@@ -1686,9 +1207,24 @@
1686
1207
  },
1687
1208
  {
1688
1209
  "kind": "method",
1689
- "name": "handleItems",
1690
- "description": "Helper method that handles the state of checkboxes.",
1691
- "privacy": "private",
1210
+ "name": "updateTriggerTextDisplay",
1211
+ "parameters": [
1212
+ {
1213
+ "name": "label",
1214
+ "description": "The label of the selected option.",
1215
+ "type": {
1216
+ "text": "string"
1217
+ }
1218
+ }
1219
+ ],
1220
+ "description": "Update displayValue or input.value, it's called when making a selection.",
1221
+ "privacy": "private"
1222
+ },
1223
+ {
1224
+ "kind": "method",
1225
+ "name": "handleMenuOptions",
1226
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1227
+ "privacy": "private",
1692
1228
  "return": {
1693
1229
  "type": {
1694
1230
  "text": "void"
@@ -1697,8 +1233,9 @@
1697
1233
  },
1698
1234
  {
1699
1235
  "kind": "method",
1700
- "name": "reset",
1701
- "description": "Resets component to initial state.",
1236
+ "name": "generateOptionsArray",
1237
+ "description": "Determines the element error state based on the `required` attribute and input value.",
1238
+ "privacy": "private",
1702
1239
  "return": {
1703
1240
  "type": {
1704
1241
  "text": "void"
@@ -1707,326 +1244,148 @@
1707
1244
  },
1708
1245
  {
1709
1246
  "kind": "method",
1710
- "name": "validate",
1711
- "parameters": [
1712
- {
1713
- "name": "force",
1714
- "default": "false",
1715
- "description": "Whether to force validation.",
1716
- "optional": true,
1717
- "type": {
1718
- "text": "boolean"
1719
- }
1247
+ "name": "hideBib",
1248
+ "description": "Hides the dropdown bib if its open.",
1249
+ "return": {
1250
+ "type": {
1251
+ "text": "void"
1720
1252
  }
1721
- ],
1722
- "description": "Validates value."
1253
+ }
1723
1254
  },
1724
1255
  {
1725
- "kind": "field",
1726
- "name": "appearance",
1727
- "privacy": "public",
1728
- "type": {
1729
- "text": "'default' | 'inverse'"
1730
- },
1731
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1732
- "default": "'default'",
1733
- "attribute": "appearance",
1734
- "reflects": true
1256
+ "kind": "method",
1257
+ "name": "showBib",
1258
+ "description": "Shows the dropdown bib if there are options to show.",
1259
+ "return": {
1260
+ "type": {
1261
+ "text": "void"
1262
+ }
1263
+ }
1735
1264
  },
1736
1265
  {
1737
- "kind": "field",
1738
- "name": "disabled",
1739
- "privacy": "public",
1740
- "type": {
1741
- "text": "boolean"
1742
- },
1743
- "description": "If set, disables the checkbox group.",
1744
- "attribute": "disabled",
1745
- "reflects": true
1266
+ "kind": "method",
1267
+ "name": "configureDropdown",
1268
+ "description": "Binds all behavior needed to the dropdown after rendering.",
1269
+ "privacy": "private",
1270
+ "return": {
1271
+ "type": {
1272
+ "text": "void"
1273
+ }
1274
+ }
1746
1275
  },
1747
1276
  {
1748
- "kind": "field",
1749
- "name": "error",
1750
- "privacy": "public",
1751
- "type": {
1752
- "text": "string"
1753
- },
1754
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1755
- "attribute": "error",
1756
- "reflects": true
1277
+ "kind": "method",
1278
+ "name": "setClearBtnFocus",
1279
+ "privacy": "private"
1757
1280
  },
1758
1281
  {
1759
- "kind": "field",
1760
- "name": "horizontal",
1761
- "privacy": "public",
1762
- "type": {
1763
- "text": "boolean"
1764
- },
1765
- "description": "If set, checkboxes will be aligned horizontally.",
1766
- "attribute": "horizontal",
1767
- "reflects": true
1282
+ "kind": "method",
1283
+ "name": "setInputFocus",
1284
+ "privacy": "private"
1768
1285
  },
1769
1286
  {
1770
- "kind": "field",
1771
- "name": "noValidate",
1772
- "privacy": "public",
1773
- "type": {
1774
- "text": "boolean"
1775
- },
1776
- "description": "If set, disables auto-validation on blur.",
1777
- "attribute": "noValidate",
1778
- "reflects": true
1287
+ "kind": "method",
1288
+ "name": "updateBibDialogRole",
1289
+ "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.",
1290
+ "privacy": "private"
1779
1291
  },
1780
1292
  {
1781
- "kind": "field",
1782
- "name": "onDark",
1783
- "privacy": "public",
1784
- "type": {
1785
- "text": "boolean"
1786
- },
1787
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1788
- "attribute": "onDark",
1789
- "reflects": true
1293
+ "kind": "method",
1294
+ "name": "updateMenuShapeSize",
1295
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1296
+ "privacy": "private"
1790
1297
  },
1791
1298
  {
1792
- "kind": "field",
1793
- "name": "required",
1794
- "privacy": "public",
1795
- "type": {
1796
- "text": "boolean"
1797
- },
1798
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1799
- "attribute": "required",
1800
- "reflects": true
1299
+ "kind": "method",
1300
+ "name": "configureMenu",
1301
+ "description": "Binds all behavior needed to the menu after rendering.",
1302
+ "privacy": "private",
1303
+ "return": {
1304
+ "type": {
1305
+ "text": "void"
1306
+ }
1307
+ }
1801
1308
  },
1802
1309
  {
1803
- "kind": "field",
1804
- "name": "setCustomValidity",
1805
- "privacy": "public",
1806
- "type": {
1807
- "text": "string"
1808
- },
1809
- "description": "Sets a custom help text message to display for all validityStates.",
1810
- "attribute": "setCustomValidity"
1310
+ "kind": "method",
1311
+ "name": "configureInput",
1312
+ "description": "Binds all behavior needed to the input after rendering.",
1313
+ "privacy": "private",
1314
+ "return": {
1315
+ "type": {
1316
+ "text": "void"
1317
+ }
1318
+ }
1811
1319
  },
1812
1320
  {
1813
- "kind": "field",
1814
- "name": "setCustomValidityCustomError",
1815
- "privacy": "public",
1816
- "type": {
1817
- "text": "string"
1818
- },
1819
- "description": "Custom help text message to display when validity = `customError`.",
1820
- "attribute": "setCustomValidityCustomError"
1321
+ "kind": "method",
1322
+ "name": "handleMenuLoadingChange",
1323
+ "parameters": [
1324
+ {
1325
+ "name": "event",
1326
+ "description": "The event object containing details about the loading state change.",
1327
+ "type": {
1328
+ "text": "CustomEvent"
1329
+ }
1330
+ },
1331
+ {
1332
+ "description": "Indicates whether the menu is currently loading.",
1333
+ "name": "event.detail.loading",
1334
+ "type": {
1335
+ "text": "boolean"
1336
+ }
1337
+ },
1338
+ {
1339
+ "description": "Indicates if there are loading placeholders present.",
1340
+ "name": "event.detail.hasLoadingPlaceholder",
1341
+ "type": {
1342
+ "text": "boolean"
1343
+ }
1344
+ }
1345
+ ],
1346
+ "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.",
1347
+ "privacy": "private",
1348
+ "return": {
1349
+ "type": {
1350
+ "text": "void"
1351
+ }
1352
+ }
1821
1353
  },
1822
1354
  {
1823
- "kind": "field",
1824
- "name": "setCustomValidityValueMissing",
1825
- "privacy": "public",
1826
- "type": {
1827
- "text": "string"
1828
- },
1829
- "description": "Custom help text message to display when validity = `valueMissing`.",
1830
- "attribute": "setCustomValidityValueMissing"
1355
+ "kind": "method",
1356
+ "name": "handleInputValueChange",
1357
+ "parameters": [
1358
+ {
1359
+ "name": "event",
1360
+ "description": "The input event triggered by the input element.",
1361
+ "type": {
1362
+ "text": "Event"
1363
+ }
1364
+ }
1365
+ ],
1366
+ "description": "Handle changes to the input value and trigger changes that should result.",
1367
+ "privacy": "private",
1368
+ "return": {
1369
+ "type": {
1370
+ "text": "void"
1371
+ }
1372
+ }
1831
1373
  },
1832
1374
  {
1833
- "kind": "field",
1834
- "name": "validity",
1835
- "privacy": "public",
1836
- "type": {
1837
- "text": "string"
1838
- },
1839
- "description": "Specifies the `validityState` this element is in.",
1840
- "attribute": "validity",
1841
- "reflects": true
1842
- }
1843
- ],
1844
- "events": [
1845
- {
1846
- "name": "input",
1847
- "type": {
1848
- "text": "CustomEvent"
1375
+ "kind": "method",
1376
+ "name": "configureCombobox",
1377
+ "description": "Binds all behavior needed to the combobox after rendering.",
1378
+ "privacy": "private",
1379
+ "return": {
1380
+ "type": {
1381
+ "text": "void"
1382
+ }
1849
1383
  }
1850
1384
  },
1851
- {
1852
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1853
- "name": "auroFormElement-validated"
1854
- }
1855
- ],
1856
- "attributes": [
1857
- {
1858
- "name": "appearance",
1859
- "type": {
1860
- "text": "'default' | 'inverse'"
1861
- },
1862
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1863
- "default": "'default'",
1864
- "fieldName": "appearance"
1865
- },
1866
- {
1867
- "name": "disabled",
1868
- "type": {
1869
- "text": "boolean"
1870
- },
1871
- "description": "If set, disables the checkbox group.",
1872
- "fieldName": "disabled"
1873
- },
1874
- {
1875
- "name": "error",
1876
- "type": {
1877
- "text": "string"
1878
- },
1879
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1880
- "fieldName": "error"
1881
- },
1882
- {
1883
- "name": "horizontal",
1884
- "type": {
1885
- "text": "boolean"
1886
- },
1887
- "description": "If set, checkboxes will be aligned horizontally.",
1888
- "fieldName": "horizontal"
1889
- },
1890
- {
1891
- "name": "noValidate",
1892
- "type": {
1893
- "text": "boolean"
1894
- },
1895
- "description": "If set, disables auto-validation on blur.",
1896
- "fieldName": "noValidate"
1897
- },
1898
- {
1899
- "name": "onDark",
1900
- "type": {
1901
- "text": "boolean"
1902
- },
1903
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1904
- "fieldName": "onDark"
1905
- },
1906
- {
1907
- "name": "required",
1908
- "type": {
1909
- "text": "boolean"
1910
- },
1911
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1912
- "fieldName": "required"
1913
- },
1914
- {
1915
- "name": "setCustomValidity",
1916
- "type": {
1917
- "text": "string"
1918
- },
1919
- "description": "Sets a custom help text message to display for all validityStates.",
1920
- "fieldName": "setCustomValidity"
1921
- },
1922
- {
1923
- "name": "setCustomValidityCustomError",
1924
- "type": {
1925
- "text": "string"
1926
- },
1927
- "description": "Custom help text message to display when validity = `customError`.",
1928
- "fieldName": "setCustomValidityCustomError"
1929
- },
1930
- {
1931
- "name": "setCustomValidityValueMissing",
1932
- "type": {
1933
- "text": "string"
1934
- },
1935
- "description": "Custom help text message to display when validity = `valueMissing`.",
1936
- "fieldName": "setCustomValidityValueMissing"
1937
- },
1938
- {
1939
- "name": "validity",
1940
- "type": {
1941
- "text": "string"
1942
- },
1943
- "description": "Specifies the `validityState` this element is in.",
1944
- "fieldName": "validity"
1945
- }
1946
- ],
1947
- "superclass": {
1948
- "name": "LitElement",
1949
- "package": "lit"
1950
- },
1951
- "tagName": "auro-checkbox-group",
1952
- "customElement": true
1953
- }
1954
- ],
1955
- "exports": [
1956
- {
1957
- "kind": "js",
1958
- "name": "AuroCheckboxGroup",
1959
- "declaration": {
1960
- "name": "AuroCheckboxGroup",
1961
- "module": "components/checkbox/src/auro-checkbox-group.js"
1962
- }
1963
- }
1964
- ]
1965
- },
1966
- {
1967
- "kind": "javascript-module",
1968
- "path": "components/checkbox/src/auro-checkbox.js",
1969
- "declarations": [
1970
- {
1971
- "kind": "class",
1972
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
1973
- "name": "AuroCheckbox",
1974
- "cssParts": [
1975
- {
1976
- "description": "apply css to a specific checkbox.",
1977
- "name": "checkbox"
1978
- },
1979
- {
1980
- "description": "apply css to a specific checkbox's input.",
1981
- "name": "checkbox-input"
1982
- },
1983
- {
1984
- "description": "apply css to a specific checkbox's label.",
1985
- "name": "checkbox-label"
1986
- }
1987
- ],
1988
- "slots": [
1989
- {
1990
- "description": "The default slot for the checkbox label.",
1991
- "name": "default"
1992
- }
1993
- ],
1994
- "members": [
1995
- {
1996
- "kind": "method",
1997
- "name": "_initializeDefaults"
1998
- },
1999
- {
2000
- "kind": "method",
2001
- "name": "register",
2002
- "static": true,
2003
- "parameters": [
2004
- {
2005
- "name": "name",
2006
- "default": "\"auro-checkbox\"",
2007
- "description": "The name of element that you want to register to.",
2008
- "optional": true,
2009
- "type": {
2010
- "text": "string"
2011
- }
2012
- }
2013
- ],
2014
- "description": "This will register this element with the browser."
2015
- },
2016
1385
  {
2017
1386
  "kind": "method",
2018
- "name": "handleChange",
2019
- "parameters": [
2020
- {
2021
- "name": "event",
2022
- "description": "The change event from the checkbox input.",
2023
- "type": {
2024
- "text": "Event"
2025
- }
2026
- }
2027
- ],
2028
- "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.",
2029
- "privacy": "private",
1387
+ "name": "focus",
1388
+ "description": "Focuses the combobox trigger input.",
2030
1389
  "return": {
2031
1390
  "type": {
2032
1391
  "text": "void"
@@ -2035,18 +1394,17 @@
2035
1394
  },
2036
1395
  {
2037
1396
  "kind": "method",
2038
- "name": "handleInput",
1397
+ "name": "setMenuValue",
2039
1398
  "parameters": [
2040
1399
  {
2041
- "name": "event",
2042
- "description": "The input event from the checkbox input.",
1400
+ "name": "value",
1401
+ "description": "The value to set on the menu.",
2043
1402
  "type": {
2044
- "text": "Event"
1403
+ "text": "string"
2045
1404
  }
2046
1405
  }
2047
1406
  ],
2048
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2049
- "privacy": "private",
1407
+ "description": "Sets the menu value if menu is available.",
2050
1408
  "return": {
2051
1409
  "type": {
2052
1410
  "text": "void"
@@ -2055,9 +1413,8 @@
2055
1413
  },
2056
1414
  {
2057
1415
  "kind": "method",
2058
- "name": "handleFocusin",
2059
- "description": "Function to support",
2060
- "privacy": "private",
1416
+ "name": "reset",
1417
+ "description": "Resets component to initial state.",
2061
1418
  "return": {
2062
1419
  "type": {
2063
1420
  "text": "void"
@@ -2066,29 +1423,57 @@
2066
1423
  },
2067
1424
  {
2068
1425
  "kind": "method",
2069
- "name": "generateIconHtml",
2070
- "description": "Function to generate checkmark svg.",
2071
- "privacy": "private",
1426
+ "name": "clear",
1427
+ "description": "Clears the current value of the combobox.",
2072
1428
  "return": {
2073
1429
  "type": {
2074
- "text": "HTMLElement"
1430
+ "text": "void"
2075
1431
  }
2076
1432
  }
2077
1433
  },
2078
1434
  {
2079
1435
  "kind": "method",
2080
- "name": "reset",
2081
- "description": "Resets component to initial state.",
2082
- "return": {
2083
- "type": {
2084
- "text": "void"
1436
+ "name": "validate",
1437
+ "parameters": [
1438
+ {
1439
+ "name": "force",
1440
+ "default": "false",
1441
+ "description": "Whether to force validation.",
1442
+ "optional": true,
1443
+ "type": {
1444
+ "text": "boolean"
1445
+ }
2085
1446
  }
2086
- }
1447
+ ],
1448
+ "description": "Validates value."
2087
1449
  },
2088
1450
  {
2089
1451
  "kind": "method",
2090
- "name": "updateAriaLabel",
2091
- "description": "Updates the aria-label based on slot content.",
1452
+ "name": "transportAssignedNodes",
1453
+ "parameters": [
1454
+ {
1455
+ "name": "slot",
1456
+ "description": "The slot element containing the nodes to apply.",
1457
+ "type": {
1458
+ "text": "HTMLSlotElement"
1459
+ }
1460
+ },
1461
+ {
1462
+ "name": "target",
1463
+ "description": "The target element to apply the nodes to.",
1464
+ "type": {
1465
+ "text": "HTMLElement"
1466
+ }
1467
+ },
1468
+ {
1469
+ "name": "newSlotName",
1470
+ "description": "The new slot name for the applied nodes.",
1471
+ "type": {
1472
+ "text": "string"
1473
+ }
1474
+ }
1475
+ ],
1476
+ "description": "Applies slotted nodes to a target element with a new slot name.",
2092
1477
  "privacy": "private",
2093
1478
  "return": {
2094
1479
  "type": {
@@ -2098,353 +1483,968 @@
2098
1483
  },
2099
1484
  {
2100
1485
  "kind": "method",
2101
- "name": "handleKeyDown",
1486
+ "name": "updateActiveOption",
2102
1487
  "parameters": [
2103
1488
  {
2104
- "name": "event",
2105
- "description": "The keydown event from the checkbox input.",
1489
+ "name": "index",
1490
+ "description": "Index of the option to make active.",
2106
1491
  "type": {
2107
- "text": "KeyboardEvent"
1492
+ "text": "number"
2108
1493
  }
2109
1494
  }
2110
1495
  ],
2111
- "description": "Handles keydown event to toggle the checkbox with Space key.",
2112
- "privacy": "private",
2113
- "return": {
2114
- "type": {
2115
- "text": "void"
1496
+ "description": "Updates the active option in the menu."
1497
+ },
1498
+ {
1499
+ "kind": "method",
1500
+ "name": "handleSlotChange",
1501
+ "parameters": [
1502
+ {
1503
+ "name": "event",
1504
+ "description": "`slotchange` event.",
1505
+ "type": {
1506
+ "text": "Event"
1507
+ }
1508
+ }
1509
+ ],
1510
+ "description": "Watch for slot changes and recalculate the menuoptions.",
1511
+ "privacy": "private",
1512
+ "return": {
1513
+ "type": {
1514
+ "text": "void"
1515
+ }
1516
+ }
1517
+ },
1518
+ {
1519
+ "kind": "field",
1520
+ "name": "appearance",
1521
+ "privacy": "public",
1522
+ "type": {
1523
+ "text": "string"
1524
+ },
1525
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1526
+ "default": "'default'",
1527
+ "attribute": "appearance",
1528
+ "reflects": true
1529
+ },
1530
+ {
1531
+ "kind": "field",
1532
+ "name": "autocomplete",
1533
+ "privacy": "public",
1534
+ "type": {
1535
+ "text": "string"
1536
+ },
1537
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1538
+ "attribute": "autocomplete",
1539
+ "reflects": true
1540
+ },
1541
+ {
1542
+ "kind": "field",
1543
+ "name": "autoPlacement",
1544
+ "privacy": "public",
1545
+ "type": {
1546
+ "text": "boolean"
1547
+ },
1548
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1549
+ "attribute": "autoPlacement",
1550
+ "reflects": true
1551
+ },
1552
+ {
1553
+ "kind": "field",
1554
+ "name": "availableOptions",
1555
+ "privacy": "private",
1556
+ "type": {
1557
+ "text": "array"
1558
+ },
1559
+ "description": "Array of available options to display in the dropdown.",
1560
+ "attribute": "availableOptions"
1561
+ },
1562
+ {
1563
+ "kind": "field",
1564
+ "name": "behavior",
1565
+ "privacy": "public",
1566
+ "type": {
1567
+ "text": "'filter' | 'suggestion'"
1568
+ },
1569
+ "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.",
1570
+ "default": "'suggestion'",
1571
+ "attribute": "behavior",
1572
+ "reflects": true
1573
+ },
1574
+ {
1575
+ "kind": "field",
1576
+ "name": "checkmark",
1577
+ "privacy": "public",
1578
+ "type": {
1579
+ "text": "boolean"
1580
+ },
1581
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1582
+ "attribute": "checkmark",
1583
+ "reflects": true
1584
+ },
1585
+ {
1586
+ "kind": "field",
1587
+ "name": "disabled",
1588
+ "privacy": "public",
1589
+ "type": {
1590
+ "text": "boolean"
1591
+ },
1592
+ "description": "If set, disables the combobox.",
1593
+ "attribute": "disabled",
1594
+ "reflects": true
1595
+ },
1596
+ {
1597
+ "kind": "field",
1598
+ "name": "dropdownId",
1599
+ "privacy": "private",
1600
+ "type": {
1601
+ "text": "string"
1602
+ },
1603
+ "description": "ID for the dropdown."
1604
+ },
1605
+ {
1606
+ "kind": "field",
1607
+ "name": "dropdownOpen",
1608
+ "privacy": "private",
1609
+ "type": {
1610
+ "text": "boolean"
1611
+ },
1612
+ "description": "Whether or not the dropdown is open."
1613
+ },
1614
+ {
1615
+ "kind": "field",
1616
+ "name": "dvInputOnly",
1617
+ "privacy": "public",
1618
+ "type": {
1619
+ "text": "boolean"
1620
+ },
1621
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1622
+ "attribute": "dvInputOnly",
1623
+ "reflects": true
1624
+ },
1625
+ {
1626
+ "kind": "field",
1627
+ "name": "error",
1628
+ "privacy": "public",
1629
+ "type": {
1630
+ "text": "string"
1631
+ },
1632
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1633
+ "attribute": "error",
1634
+ "reflects": true
1635
+ },
1636
+ {
1637
+ "kind": "field",
1638
+ "name": "format",
1639
+ "privacy": "public",
1640
+ "type": {
1641
+ "text": "string"
1642
+ },
1643
+ "description": "Specifies the input mask format.",
1644
+ "attribute": "format",
1645
+ "reflects": true
1646
+ },
1647
+ {
1648
+ "kind": "field",
1649
+ "name": "inputmode",
1650
+ "privacy": "public",
1651
+ "type": {
1652
+ "text": "string"
1653
+ },
1654
+ "description": "Exposes inputmode attribute for input.",
1655
+ "attribute": "inputmode",
1656
+ "reflects": true
1657
+ },
1658
+ {
1659
+ "kind": "field",
1660
+ "name": "layout",
1661
+ "privacy": "public",
1662
+ "type": {
1663
+ "text": "string"
1664
+ },
1665
+ "description": "Sets the layout of the combobox.",
1666
+ "default": "'classic'",
1667
+ "attribute": "layout",
1668
+ "reflects": true,
1669
+ "inheritedFrom": {
1670
+ "name": "AuroElement",
1671
+ "module": "components/layoutElement/src/auroElement.js"
1672
+ }
1673
+ },
1674
+ {
1675
+ "kind": "field",
1676
+ "name": "matchWidth",
1677
+ "privacy": "private",
1678
+ "type": {
1679
+ "text": "boolean"
1680
+ },
1681
+ "description": "If declared, the popover and trigger will be set to the same width.",
1682
+ "attribute": "matchWidth",
1683
+ "reflects": true
1684
+ },
1685
+ {
1686
+ "kind": "field",
1687
+ "name": "noFilter",
1688
+ "privacy": "public",
1689
+ "type": {
1690
+ "text": "boolean"
1691
+ },
1692
+ "description": "If set, combobox will not filter menuoptions based on input.",
1693
+ "attribute": "noFilter",
1694
+ "reflects": true
1695
+ },
1696
+ {
1697
+ "kind": "field",
1698
+ "name": "noFlip",
1699
+ "privacy": "public",
1700
+ "type": {
1701
+ "text": "boolean"
1702
+ },
1703
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1704
+ "attribute": "noFlip",
1705
+ "reflects": true
1706
+ },
1707
+ {
1708
+ "kind": "field",
1709
+ "name": "shift",
1710
+ "privacy": "public",
1711
+ "type": {
1712
+ "text": "boolean"
1713
+ },
1714
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1715
+ "attribute": "shift",
1716
+ "reflects": true
1717
+ },
1718
+ {
1719
+ "kind": "field",
1720
+ "name": "noValidate",
1721
+ "privacy": "public",
1722
+ "type": {
1723
+ "text": "boolean"
1724
+ },
1725
+ "description": "If set, disables auto-validation on blur.",
1726
+ "attribute": "noValidate",
1727
+ "reflects": true
1728
+ },
1729
+ {
1730
+ "kind": "field",
1731
+ "name": "offset",
1732
+ "privacy": "public",
1733
+ "type": {
1734
+ "text": "number"
1735
+ },
1736
+ "description": "Gap between the trigger element and bib.",
1737
+ "default": "0",
1738
+ "attribute": "offset",
1739
+ "reflects": true
1740
+ },
1741
+ {
1742
+ "kind": "field",
1743
+ "name": "onDark",
1744
+ "privacy": "public",
1745
+ "type": {
1746
+ "text": "boolean"
1747
+ },
1748
+ "attribute": "onDark",
1749
+ "reflects": true,
1750
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1751
+ "inheritedFrom": {
1752
+ "name": "AuroElement",
1753
+ "module": "components/layoutElement/src/auroElement.js"
1754
+ }
1755
+ },
1756
+ {
1757
+ "kind": "field",
1758
+ "name": "optionSelected",
1759
+ "privacy": "public",
1760
+ "type": {
1761
+ "text": "HTMLElement"
1762
+ },
1763
+ "description": "Specifies the current selected option.",
1764
+ "attribute": "optionSelected"
1765
+ },
1766
+ {
1767
+ "kind": "field",
1768
+ "name": "persistInput",
1769
+ "privacy": "public",
1770
+ "type": {
1771
+ "text": "boolean"
1772
+ },
1773
+ "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.",
1774
+ "attribute": "persistInput",
1775
+ "reflects": true
1776
+ },
1777
+ {
1778
+ "kind": "field",
1779
+ "name": "placement",
1780
+ "privacy": "public",
1781
+ "type": {
1782
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1783
+ },
1784
+ "description": "Position where the bib should appear relative to the trigger.",
1785
+ "default": "'bottom-start'",
1786
+ "attribute": "placement",
1787
+ "reflects": true
1788
+ },
1789
+ {
1790
+ "kind": "field",
1791
+ "name": "placeholder",
1792
+ "privacy": "public",
1793
+ "type": {
1794
+ "text": "string"
1795
+ },
1796
+ "description": "Define custom placeholder text, only supported by date input formats.",
1797
+ "attribute": "placeholder",
1798
+ "reflects": true
1799
+ },
1800
+ {
1801
+ "kind": "field",
1802
+ "name": "required",
1803
+ "privacy": "public",
1804
+ "type": {
1805
+ "text": "boolean"
1806
+ },
1807
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1808
+ "attribute": "required",
1809
+ "reflects": true
1810
+ },
1811
+ {
1812
+ "kind": "field",
1813
+ "name": "setCustomValidity",
1814
+ "privacy": "public",
1815
+ "type": {
1816
+ "text": "string"
1817
+ },
1818
+ "description": "Sets a custom help text message to display for all validityStates.",
1819
+ "attribute": "setCustomValidity"
1820
+ },
1821
+ {
1822
+ "kind": "field",
1823
+ "name": "setCustomValidityCustomError",
1824
+ "privacy": "public",
1825
+ "type": {
1826
+ "text": "string"
1827
+ },
1828
+ "description": "Custom help text message to display when validity = `customError`.",
1829
+ "attribute": "setCustomValidityCustomError"
1830
+ },
1831
+ {
1832
+ "kind": "field",
1833
+ "name": "setCustomValidityValueMissing",
1834
+ "privacy": "public",
1835
+ "type": {
1836
+ "text": "string"
1837
+ },
1838
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1839
+ "attribute": "setCustomValidityValueMissing"
1840
+ },
1841
+ {
1842
+ "kind": "field",
1843
+ "name": "setCustomValidityValueMissingFilter",
1844
+ "privacy": "public",
1845
+ "type": {
1846
+ "text": "string"
1847
+ },
1848
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1849
+ "attribute": "setCustomValidityValueMissingFilter"
1850
+ },
1851
+ {
1852
+ "kind": "field",
1853
+ "name": "touched",
1854
+ "privacy": "private",
1855
+ "type": {
1856
+ "text": "boolean"
1857
+ },
1858
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1859
+ },
1860
+ {
1861
+ "kind": "field",
1862
+ "name": "triggerIcon",
1863
+ "privacy": "public",
1864
+ "type": {
1865
+ "text": "boolean"
1866
+ },
1867
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1868
+ "attribute": "triggerIcon",
1869
+ "reflects": true
1870
+ },
1871
+ {
1872
+ "kind": "field",
1873
+ "name": "type",
1874
+ "privacy": "public",
1875
+ "type": {
1876
+ "text": "string"
1877
+ },
1878
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1879
+ "attribute": "type",
1880
+ "reflects": true
1881
+ },
1882
+ {
1883
+ "kind": "field",
1884
+ "name": "typedValue",
1885
+ "privacy": "public",
1886
+ "type": {
1887
+ "text": "string"
1888
+ },
1889
+ "description": "Specifies the value of the input element within the combobox.",
1890
+ "attribute": "typedValue",
1891
+ "reflects": true
1892
+ },
1893
+ {
1894
+ "kind": "field",
1895
+ "name": "validity",
1896
+ "privacy": "public",
1897
+ "type": {
1898
+ "text": "string"
1899
+ },
1900
+ "description": "Specifies the `validityState` this element is in.",
1901
+ "attribute": "validity",
1902
+ "reflects": true
1903
+ },
1904
+ {
1905
+ "kind": "field",
1906
+ "name": "value",
1907
+ "privacy": "public",
1908
+ "type": {
1909
+ "text": "string"
1910
+ },
1911
+ "description": "Value selected for the dropdown menu.",
1912
+ "attribute": "value"
1913
+ },
1914
+ {
1915
+ "kind": "field",
1916
+ "name": "largeFullscreenHeadline",
1917
+ "privacy": "public",
1918
+ "type": {
1919
+ "text": "boolean"
1920
+ },
1921
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1922
+ "attribute": "largeFullscreenHeadline",
1923
+ "reflects": true
1924
+ },
1925
+ {
1926
+ "kind": "field",
1927
+ "name": "fullscreenBreakpoint",
1928
+ "privacy": "public",
1929
+ "type": {
1930
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1931
+ },
1932
+ "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.",
1933
+ "default": "'sm'",
1934
+ "attribute": "fullscreenBreakpoint",
1935
+ "reflects": true
1936
+ },
1937
+ {
1938
+ "kind": "field",
1939
+ "name": "optionActive",
1940
+ "privacy": "private",
1941
+ "type": {
1942
+ "text": "object"
1943
+ },
1944
+ "description": "Specifies the currently active option."
1945
+ },
1946
+ {
1947
+ "kind": "field",
1948
+ "name": "triggerExpandedState",
1949
+ "privacy": "private",
1950
+ "type": {
1951
+ "text": "boolean"
1952
+ },
1953
+ "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1954
+ },
1955
+ {
1956
+ "kind": "field",
1957
+ "name": "componentHasFocus",
1958
+ "description": "Returns true if the element has focus.",
1959
+ "privacy": "private",
1960
+ "return": {
1961
+ "type": {
1962
+ "text": "boolean"
2116
1963
  }
1964
+ },
1965
+ "readonly": true,
1966
+ "inheritedFrom": {
1967
+ "name": "AuroElement",
1968
+ "module": "components/layoutElement/src/auroElement.js"
1969
+ }
1970
+ },
1971
+ {
1972
+ "kind": "method",
1973
+ "name": "resetShapeClasses",
1974
+ "inheritedFrom": {
1975
+ "name": "AuroElement",
1976
+ "module": "components/layoutElement/src/auroElement.js"
1977
+ }
1978
+ },
1979
+ {
1980
+ "kind": "method",
1981
+ "name": "resetLayoutClasses",
1982
+ "inheritedFrom": {
1983
+ "name": "AuroElement",
1984
+ "module": "components/layoutElement/src/auroElement.js"
1985
+ }
1986
+ },
1987
+ {
1988
+ "kind": "method",
1989
+ "name": "updateComponentArchitecture",
1990
+ "inheritedFrom": {
1991
+ "name": "AuroElement",
1992
+ "module": "components/layoutElement/src/auroElement.js"
1993
+ }
1994
+ },
1995
+ {
1996
+ "kind": "field",
1997
+ "name": "shape",
1998
+ "privacy": "public",
1999
+ "type": {
2000
+ "text": "string"
2001
+ },
2002
+ "attribute": "shape",
2003
+ "reflects": true,
2004
+ "inheritedFrom": {
2005
+ "name": "AuroElement",
2006
+ "module": "components/layoutElement/src/auroElement.js"
2007
+ }
2008
+ },
2009
+ {
2010
+ "kind": "field",
2011
+ "name": "size",
2012
+ "privacy": "public",
2013
+ "type": {
2014
+ "text": "string"
2015
+ },
2016
+ "attribute": "size",
2017
+ "reflects": true,
2018
+ "inheritedFrom": {
2019
+ "name": "AuroElement",
2020
+ "module": "components/layoutElement/src/auroElement.js"
2117
2021
  }
2022
+ }
2023
+ ],
2024
+ "events": [
2025
+ {
2026
+ "name": "inputValue",
2027
+ "type": {
2028
+ "text": "CustomEvent"
2029
+ },
2030
+ "description": "Notifies that the components internal HTML5 input value has changed."
2031
+ },
2032
+ {
2033
+ "name": "input",
2034
+ "type": {
2035
+ "text": "CustomEvent"
2036
+ },
2037
+ "description": "Notifies that the component has a new value set."
2038
+ },
2039
+ {
2040
+ "name": "auroCombobox-valueSet",
2041
+ "type": {
2042
+ "text": "CustomEvent"
2043
+ },
2044
+ "description": "(Deprecated) Notifies that the component has a new value set."
2045
+ },
2046
+ {
2047
+ "description": "Notifies that the component value(s) have been validated.",
2048
+ "name": "auroFormElement-validated"
2049
+ }
2050
+ ],
2051
+ "attributes": [
2052
+ {
2053
+ "name": "appearance",
2054
+ "type": {
2055
+ "text": "string"
2056
+ },
2057
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2058
+ "default": "'default'",
2059
+ "fieldName": "appearance"
2060
+ },
2061
+ {
2062
+ "name": "autocomplete",
2063
+ "type": {
2064
+ "text": "string"
2065
+ },
2066
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2067
+ "fieldName": "autocomplete"
2068
+ },
2069
+ {
2070
+ "name": "autoPlacement",
2071
+ "type": {
2072
+ "text": "boolean"
2073
+ },
2074
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
2075
+ "fieldName": "autoPlacement"
2076
+ },
2077
+ {
2078
+ "name": "availableOptions",
2079
+ "type": {
2080
+ "text": "array"
2081
+ },
2082
+ "description": "Array of available options to display in the dropdown.",
2083
+ "fieldName": "availableOptions"
2118
2084
  },
2119
2085
  {
2120
- "kind": "field",
2121
- "name": "appearance",
2122
- "privacy": "public",
2086
+ "name": "behavior",
2123
2087
  "type": {
2124
- "text": "'default' | 'inverse'"
2088
+ "text": "'filter' | 'suggestion'"
2125
2089
  },
2126
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2127
- "default": "'default'",
2128
- "attribute": "appearance",
2129
- "reflects": true
2090
+ "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.",
2091
+ "default": "'suggestion'",
2092
+ "fieldName": "behavior"
2130
2093
  },
2131
2094
  {
2132
- "kind": "field",
2133
- "name": "checked",
2134
- "privacy": "public",
2095
+ "name": "checkmark",
2135
2096
  "type": {
2136
2097
  "text": "boolean"
2137
2098
  },
2138
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2139
- "attribute": "checked",
2140
- "reflects": true
2099
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
2100
+ "fieldName": "checkmark"
2141
2101
  },
2142
2102
  {
2143
- "kind": "field",
2144
2103
  "name": "disabled",
2145
- "privacy": "public",
2146
2104
  "type": {
2147
2105
  "text": "boolean"
2148
2106
  },
2149
- "description": "If set to true, the checkbox will not be clickable.",
2150
- "attribute": "disabled",
2151
- "reflects": true
2107
+ "description": "If set, disables the combobox.",
2108
+ "fieldName": "disabled"
2152
2109
  },
2153
2110
  {
2154
- "kind": "field",
2155
- "name": "error",
2156
- "privacy": "public",
2111
+ "name": "dvInputOnly",
2157
2112
  "type": {
2158
2113
  "text": "boolean"
2159
2114
  },
2160
- "description": "If set to true, the checkbox will be displayed with an error state.",
2161
- "attribute": "error",
2162
- "reflects": true
2115
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2116
+ "fieldName": "dvInputOnly"
2163
2117
  },
2164
2118
  {
2165
- "kind": "field",
2166
- "name": "id",
2167
- "privacy": "public",
2119
+ "name": "error",
2168
2120
  "type": {
2169
2121
  "text": "string"
2170
2122
  },
2171
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2172
- "attribute": "id"
2123
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2124
+ "fieldName": "error"
2173
2125
  },
2174
2126
  {
2175
- "kind": "field",
2176
- "name": "inputId",
2177
- "privacy": "private",
2127
+ "name": "format",
2178
2128
  "type": {
2179
2129
  "text": "string"
2180
2130
  },
2181
- "description": "The id for input node."
2131
+ "description": "Specifies the input mask format.",
2132
+ "fieldName": "format"
2182
2133
  },
2183
2134
  {
2184
- "kind": "field",
2185
- "name": "name",
2186
- "privacy": "public",
2135
+ "name": "inputmode",
2187
2136
  "type": {
2188
2137
  "text": "string"
2189
2138
  },
2190
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2191
- "attribute": "name"
2139
+ "description": "Exposes inputmode attribute for input.",
2140
+ "fieldName": "inputmode"
2192
2141
  },
2193
2142
  {
2194
- "kind": "field",
2195
- "name": "onDark",
2196
- "privacy": "public",
2143
+ "name": "layout",
2144
+ "type": {
2145
+ "text": "string"
2146
+ },
2147
+ "description": "Sets the layout of the combobox.",
2148
+ "default": "'classic'",
2149
+ "fieldName": "layout",
2150
+ "inheritedFrom": {
2151
+ "name": "AuroElement",
2152
+ "module": "components/layoutElement/src/auroElement.js"
2153
+ }
2154
+ },
2155
+ {
2156
+ "name": "matchWidth",
2197
2157
  "type": {
2198
2158
  "text": "boolean"
2199
2159
  },
2200
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2201
- "attribute": "onDark",
2202
- "reflects": true
2160
+ "description": "If declared, the popover and trigger will be set to the same width.",
2161
+ "fieldName": "matchWidth"
2203
2162
  },
2204
2163
  {
2205
- "kind": "field",
2206
- "name": "touched",
2207
- "privacy": "private",
2164
+ "name": "noFilter",
2208
2165
  "type": {
2209
2166
  "text": "boolean"
2210
2167
  },
2211
- "description": "Indicates whether the checkbox has been interacted with."
2168
+ "description": "If set, combobox will not filter menuoptions based on input.",
2169
+ "fieldName": "noFilter"
2212
2170
  },
2213
2171
  {
2214
- "kind": "field",
2215
- "name": "value",
2216
- "privacy": "public",
2172
+ "name": "noFlip",
2217
2173
  "type": {
2218
- "text": "string"
2174
+ "text": "boolean"
2219
2175
  },
2220
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2221
- "attribute": "value"
2176
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2177
+ "fieldName": "noFlip"
2222
2178
  },
2223
2179
  {
2224
- "kind": "field",
2225
- "name": "tabIndex",
2226
- "privacy": "private",
2180
+ "name": "shift",
2181
+ "type": {
2182
+ "text": "boolean"
2183
+ },
2184
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2185
+ "fieldName": "shift"
2186
+ },
2187
+ {
2188
+ "name": "noValidate",
2189
+ "type": {
2190
+ "text": "boolean"
2191
+ },
2192
+ "description": "If set, disables auto-validation on blur.",
2193
+ "fieldName": "noValidate"
2194
+ },
2195
+ {
2196
+ "name": "offset",
2227
2197
  "type": {
2228
2198
  "text": "number"
2229
2199
  },
2230
- "description": "The tabindex attribute for the checkbox.",
2231
- "attribute": "tabindex",
2232
- "reflects": true
2200
+ "description": "Gap between the trigger element and bib.",
2201
+ "default": "0",
2202
+ "fieldName": "offset"
2233
2203
  },
2234
2204
  {
2235
- "kind": "field",
2236
- "name": "ariaChecked",
2237
- "privacy": "private",
2205
+ "name": "onDark",
2238
2206
  "type": {
2239
- "text": "string"
2207
+ "text": "boolean"
2240
2208
  },
2241
- "description": "The aria-checked attribute for the checkbox.",
2242
- "attribute": "aria-checked",
2243
- "reflects": true
2209
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2210
+ "fieldName": "onDark"
2244
2211
  },
2245
2212
  {
2246
- "kind": "field",
2247
- "name": "ariaDisabled",
2248
- "privacy": "private",
2213
+ "name": "optionSelected",
2249
2214
  "type": {
2250
- "text": "string"
2215
+ "text": "HTMLElement"
2251
2216
  },
2252
- "description": "The aria-disabled attribute for the checkbox.",
2253
- "attribute": "aria-disabled",
2254
- "reflects": true
2217
+ "description": "Specifies the current selected option.",
2218
+ "fieldName": "optionSelected"
2255
2219
  },
2256
2220
  {
2257
- "kind": "field",
2258
- "name": "role",
2259
- "privacy": "private",
2221
+ "name": "persistInput",
2260
2222
  "type": {
2261
- "text": "string"
2223
+ "text": "boolean"
2262
2224
  },
2263
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2264
- "attribute": "role",
2265
- "reflects": true
2266
- }
2267
- ],
2268
- "events": [
2225
+ "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.",
2226
+ "fieldName": "persistInput"
2227
+ },
2269
2228
  {
2270
- "name": "auroCheckbox-input",
2229
+ "name": "placement",
2271
2230
  "type": {
2272
- "text": "CustomEvent"
2273
- }
2231
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2232
+ },
2233
+ "description": "Position where the bib should appear relative to the trigger.",
2234
+ "default": "'bottom-start'",
2235
+ "fieldName": "placement"
2274
2236
  },
2275
2237
  {
2276
- "name": "auroCheckbox-focusin",
2238
+ "name": "placeholder",
2277
2239
  "type": {
2278
- "text": "CustomEvent"
2279
- }
2240
+ "text": "string"
2241
+ },
2242
+ "description": "Define custom placeholder text, only supported by date input formats.",
2243
+ "fieldName": "placeholder"
2280
2244
  },
2281
2245
  {
2282
- "name": "auroCheckbox-focusout",
2246
+ "name": "required",
2283
2247
  "type": {
2284
- "text": "CustomEvent"
2285
- }
2248
+ "text": "boolean"
2249
+ },
2250
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2251
+ "fieldName": "required"
2286
2252
  },
2287
2253
  {
2254
+ "name": "setCustomValidity",
2288
2255
  "type": {
2289
- "text": "CustomEvent<any>"
2256
+ "text": "string"
2290
2257
  },
2291
- "description": "(Deprecated) Notifies when checked value is changed.",
2292
- "name": "change"
2258
+ "description": "Sets a custom help text message to display for all validityStates.",
2259
+ "fieldName": "setCustomValidity"
2293
2260
  },
2294
2261
  {
2262
+ "name": "setCustomValidityCustomError",
2295
2263
  "type": {
2296
- "text": "InputEvent"
2264
+ "text": "string"
2297
2265
  },
2298
- "description": "Notifies when when checked value is changed by user's interface.",
2299
- "name": "input"
2300
- }
2301
- ],
2302
- "attributes": [
2266
+ "description": "Custom help text message to display when validity = `customError`.",
2267
+ "fieldName": "setCustomValidityCustomError"
2268
+ },
2303
2269
  {
2304
- "name": "appearance",
2270
+ "name": "setCustomValidityValueMissing",
2305
2271
  "type": {
2306
- "text": "'default' | 'inverse'"
2272
+ "text": "string"
2307
2273
  },
2308
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2309
- "default": "'default'",
2310
- "fieldName": "appearance"
2274
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2275
+ "fieldName": "setCustomValidityValueMissing"
2311
2276
  },
2312
2277
  {
2313
- "name": "checked",
2278
+ "name": "setCustomValidityValueMissingFilter",
2314
2279
  "type": {
2315
- "text": "boolean"
2280
+ "text": "string"
2316
2281
  },
2317
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2318
- "fieldName": "checked"
2282
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2283
+ "fieldName": "setCustomValidityValueMissingFilter"
2319
2284
  },
2320
2285
  {
2321
- "name": "disabled",
2286
+ "name": "triggerIcon",
2322
2287
  "type": {
2323
2288
  "text": "boolean"
2324
2289
  },
2325
- "description": "If set to true, the checkbox will not be clickable.",
2326
- "fieldName": "disabled"
2290
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2291
+ "fieldName": "triggerIcon"
2327
2292
  },
2328
2293
  {
2329
- "name": "error",
2294
+ "name": "type",
2330
2295
  "type": {
2331
- "text": "boolean"
2296
+ "text": "string"
2332
2297
  },
2333
- "description": "If set to true, the checkbox will be displayed with an error state.",
2334
- "fieldName": "error"
2298
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2299
+ "fieldName": "type"
2335
2300
  },
2336
2301
  {
2337
- "name": "id",
2302
+ "name": "typedValue",
2338
2303
  "type": {
2339
2304
  "text": "string"
2340
2305
  },
2341
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2342
- "fieldName": "id"
2306
+ "description": "Specifies the value of the input element within the combobox.",
2307
+ "fieldName": "typedValue"
2343
2308
  },
2344
2309
  {
2345
- "name": "name",
2310
+ "name": "validity",
2346
2311
  "type": {
2347
2312
  "text": "string"
2348
2313
  },
2349
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2350
- "fieldName": "name"
2314
+ "description": "Specifies the `validityState` this element is in.",
2315
+ "fieldName": "validity"
2351
2316
  },
2352
2317
  {
2353
- "name": "onDark",
2318
+ "name": "value",
2354
2319
  "type": {
2355
- "text": "boolean"
2320
+ "text": "string"
2356
2321
  },
2357
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2358
- "fieldName": "onDark"
2322
+ "description": "Value selected for the dropdown menu.",
2323
+ "fieldName": "value"
2359
2324
  },
2360
2325
  {
2361
- "name": "value",
2326
+ "name": "largeFullscreenHeadline",
2362
2327
  "type": {
2363
- "text": "string"
2328
+ "text": "boolean"
2364
2329
  },
2365
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2366
- "fieldName": "value"
2330
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2331
+ "fieldName": "largeFullscreenHeadline"
2367
2332
  },
2368
2333
  {
2369
- "name": "tabindex",
2334
+ "name": "fullscreenBreakpoint",
2370
2335
  "type": {
2371
- "text": "number"
2336
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2372
2337
  },
2373
- "description": "The tabindex attribute for the checkbox.",
2374
- "fieldName": "tabIndex"
2338
+ "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.",
2339
+ "default": "'sm'",
2340
+ "fieldName": "fullscreenBreakpoint"
2375
2341
  },
2376
2342
  {
2377
- "name": "aria-checked",
2343
+ "name": "shape",
2378
2344
  "type": {
2379
2345
  "text": "string"
2380
2346
  },
2381
- "description": "The aria-checked attribute for the checkbox.",
2382
- "fieldName": "ariaChecked"
2347
+ "fieldName": "shape",
2348
+ "inheritedFrom": {
2349
+ "name": "AuroElement",
2350
+ "module": "components/layoutElement/src/auroElement.js"
2351
+ }
2383
2352
  },
2384
2353
  {
2385
- "name": "aria-disabled",
2354
+ "name": "size",
2386
2355
  "type": {
2387
2356
  "text": "string"
2388
2357
  },
2389
- "description": "The aria-disabled attribute for the checkbox.",
2390
- "fieldName": "ariaDisabled"
2358
+ "fieldName": "size",
2359
+ "inheritedFrom": {
2360
+ "name": "AuroElement",
2361
+ "module": "components/layoutElement/src/auroElement.js"
2362
+ }
2391
2363
  },
2392
2364
  {
2393
- "name": "role",
2365
+ "name": "ondark",
2394
2366
  "type": {
2395
- "text": "string"
2367
+ "text": "boolean"
2396
2368
  },
2397
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2398
- "fieldName": "role"
2369
+ "fieldName": "onDark",
2370
+ "inheritedFrom": {
2371
+ "name": "AuroElement",
2372
+ "module": "components/layoutElement/src/auroElement.js"
2373
+ }
2399
2374
  }
2400
2375
  ],
2401
2376
  "superclass": {
2402
- "name": "LitElement",
2403
- "package": "lit"
2377
+ "name": "AuroElement",
2378
+ "module": "/components/layoutElement/src/auroElement.js"
2404
2379
  },
2405
- "tagName": "auro-checkbox",
2380
+ "tagName": "auro-combobox",
2406
2381
  "customElement": true
2407
2382
  }
2408
2383
  ],
2409
2384
  "exports": [
2410
2385
  {
2411
2386
  "kind": "js",
2412
- "name": "AuroCheckbox",
2387
+ "name": "AuroCombobox",
2413
2388
  "declaration": {
2414
- "name": "AuroCheckbox",
2415
- "module": "components/checkbox/src/auro-checkbox.js"
2389
+ "name": "AuroCombobox",
2390
+ "module": "components/combobox/src/auro-combobox.js"
2416
2391
  }
2417
2392
  }
2418
2393
  ]
2419
2394
  },
2420
2395
  {
2421
2396
  "kind": "javascript-module",
2422
- "path": "components/checkbox/src/index.js",
2423
- "declarations": [],
2397
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2398
+ "declarations": [
2399
+ {
2400
+ "kind": "variable",
2401
+ "name": "comboboxKeyboardStrategy",
2402
+ "type": {
2403
+ "text": "object"
2404
+ },
2405
+ "default": "{ async Enter(component, evt, 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. if (isClearBtnFocused(ctx)) { evt.stopPropagation(); return; } if (ctx.isExpanded && component.optionActive) { component.menu.makeSelection(); await component.updateComplete; evt.preventDefault(); evt.stopPropagation(); component.setClearBtnFocus(); } 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(); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Shift+Tab moves the highlight to the first non-disabled option // without making a selection or closing the bib. if (evt.shiftKey) { evt.preventDefault(); const firstActive = component.menu.menuService.menuOptions.find((option) => option.isActive); if (firstActive) { component.menu.updateActiveOption(firstActive); } return; } if (ctx.isModal) { if (!ctx.activeInput) { return; } const clearBtn = getClearBtn(ctx); const clearBtnHasFocus = isClearBtnFocused(ctx, clearBtn); // Tab from input: if clear button exists and doesn't have focus, focus it if (clearBtn && !clearBtnHasFocus && ctx.activeInput.value) { // Force clear button container visible to work around Safari not // propagating :focus-within through shadow DOM boundaries, which // causes .wrapper:not(:focus-within) to hide .notification.clear. const clearContainer = clearBtn.closest('.clear'); if (clearContainer) { clearContainer.style.display = 'flex'; clearBtn.addEventListener('focusout', () => { // Delay cleanup so :focus-within settles when focus moves // to a sibling (e.g., Shift+Tab back to the input). requestAnimationFrame(() => { clearContainer.style.display = ''; }); }, { once: true }); } // Focus the native button inside auro-button so the browser // treats it as a real focusable element inside the dialog. const nativeBtn = clearBtn.shadowRoot && clearBtn.shadowRoot.querySelector('button'); if (nativeBtn) { nativeBtn.focus(); } else { clearBtn.focus(); } return; } // Tab from clear button (or no clear button / no value) → // select the highlighted option if any, then close if (component.optionActive) { component.menu.makeSelection(); } component.hideBib(); return; } // Non-fullscreen: select + close if (component.menu.optionActive && component.menu.optionActive.value) { component.menu.value = component.menu.optionActive.value; } component.hideBib(); }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } if (component.availableOptions.length > 0) { component.showBib(); } // Read live visibility — ctx.isExpanded was computed before showBib() above, // so it wouldn't reflect the state change. if (component.dropdown.isPopoverVisible) { evt.preventDefault(); navigateArrow(component, 'up'); } }, ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } if (component.availableOptions.length > 0) { component.showBib(); } // Read live visibility — ctx.isExpanded was computed before showBib() above, // so it wouldn't reflect the state change. if (component.dropdown.isPopoverVisible) { evt.preventDefault(); navigateArrow(component, 'down'); } }, }"
2406
+ }
2407
+ ],
2424
2408
  "exports": [
2425
2409
  {
2426
2410
  "kind": "js",
2427
- "name": "AuroCheckbox",
2411
+ "name": "comboboxKeyboardStrategy",
2428
2412
  "declaration": {
2429
- "name": "AuroCheckbox",
2430
- "module": "components/checkbox/src/index.js"
2413
+ "name": "comboboxKeyboardStrategy",
2414
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2431
2415
  }
2432
- },
2416
+ }
2417
+ ]
2418
+ },
2419
+ {
2420
+ "kind": "javascript-module",
2421
+ "path": "components/combobox/src/index.js",
2422
+ "declarations": [],
2423
+ "exports": [
2433
2424
  {
2434
2425
  "kind": "js",
2435
- "name": "AuroCheckboxGroup",
2426
+ "name": "AuroCombobox",
2436
2427
  "declaration": {
2437
- "name": "AuroCheckboxGroup",
2438
- "module": "components/checkbox/src/index.js"
2428
+ "name": "AuroCombobox",
2429
+ "module": "components/combobox/src/index.js"
2439
2430
  }
2440
2431
  }
2441
2432
  ]
2442
2433
  },
2443
2434
  {
2444
2435
  "kind": "javascript-module",
2445
- "path": "components/checkbox/src/registered.js",
2436
+ "path": "components/combobox/src/registered.js",
2446
2437
  "declarations": [],
2447
- "exports": []
2438
+ "exports": [
2439
+ {
2440
+ "kind": "js",
2441
+ "name": "AuroCombobox",
2442
+ "declaration": {
2443
+ "name": "AuroCombobox",
2444
+ "module": "components/combobox/src/registered.js"
2445
+ }
2446
+ }
2447
+ ]
2448
2448
  },
2449
2449
  {
2450
2450
  "kind": "javascript-module",
@@ -3584,6 +3584,30 @@
3584
3584
  "kind": "method",
3585
3585
  "name": "_initializeDefaults"
3586
3586
  },
3587
+ {
3588
+ "kind": "field",
3589
+ "name": "value",
3590
+ "privacy": "public",
3591
+ "type": {
3592
+ "text": "number"
3593
+ },
3594
+ "description": "Sets the value of the counter. If the provided value is undefined, null, or cannot be converted to a number, the internal value will be set to undefined.",
3595
+ "return": {
3596
+ "type": {
3597
+ "text": "number|undefined"
3598
+ }
3599
+ },
3600
+ "parameters": [
3601
+ {
3602
+ "description": "The value to set for the counter. Can be a number, a string that can be converted to a number, undefined, or null.",
3603
+ "name": "val",
3604
+ "type": {
3605
+ "text": "number|string|undefined|null"
3606
+ }
3607
+ }
3608
+ ],
3609
+ "attribute": "value"
3610
+ },
3587
3611
  {
3588
3612
  "kind": "method",
3589
3613
  "name": "register",
@@ -3683,26 +3707,6 @@
3683
3707
  ],
3684
3708
  "description": "Validates value."
3685
3709
  },
3686
- {
3687
- "kind": "method",
3688
- "name": "handleKeyDown",
3689
- "parameters": [
3690
- {
3691
- "name": "event",
3692
- "description": "The keyboard event object.",
3693
- "type": {
3694
- "text": "KeyboardEvent"
3695
- }
3696
- }
3697
- ],
3698
- "description": "Handles the keydown event for the counter component.",
3699
- "return": {
3700
- "type": {
3701
- "text": "void"
3702
- }
3703
- },
3704
- "privacy": "private"
3705
- },
3706
3710
  {
3707
3711
  "kind": "method",
3708
3712
  "name": "setTagAttribute",
@@ -3865,16 +3869,6 @@
3865
3869
  "description": "The validity state of the counter.",
3866
3870
  "attribute": "validity",
3867
3871
  "reflects": true
3868
- },
3869
- {
3870
- "kind": "field",
3871
- "name": "value",
3872
- "privacy": "public",
3873
- "type": {
3874
- "text": "number"
3875
- },
3876
- "description": "The current value of the counter.",
3877
- "attribute": "value"
3878
3872
  }
3879
3873
  ],
3880
3874
  "events": [
@@ -3972,7 +3966,21 @@
3972
3966
  "type": {
3973
3967
  "text": "number"
3974
3968
  },
3975
- "description": "The current value of the counter.",
3969
+ "description": "Sets the value of the counter. If the provided value is undefined, null, or cannot be converted to a number, the internal value will be set to undefined.",
3970
+ "return": {
3971
+ "type": {
3972
+ "text": "number|undefined"
3973
+ }
3974
+ },
3975
+ "parameters": [
3976
+ {
3977
+ "description": "The value to set for the counter. Can be a number, a string that can be converted to a number, undefined, or null.",
3978
+ "name": "val",
3979
+ "type": {
3980
+ "text": "number|string|undefined|null"
3981
+ }
3982
+ }
3983
+ ],
3976
3984
  "fieldName": "value"
3977
3985
  }
3978
3986
  ],
@@ -4048,6 +4056,30 @@
4048
4056
  }
4049
4057
  ]
4050
4058
  },
4059
+ {
4060
+ "kind": "javascript-module",
4061
+ "path": "components/counter/src/keyboardStrategy.js",
4062
+ "declarations": [
4063
+ {
4064
+ "kind": "variable",
4065
+ "name": "keyboardStrategy",
4066
+ "type": {
4067
+ "text": "object"
4068
+ },
4069
+ "default": "{ ArrowUp(component, _evt) { if (component.disabled) { return; } _evt.preventDefault(); component.increment(); }, ArrowDown(component, _evt) { if (component.disabled) { return; } _evt.preventDefault(); component.decrement(); } }"
4070
+ }
4071
+ ],
4072
+ "exports": [
4073
+ {
4074
+ "kind": "js",
4075
+ "name": "keyboardStrategy",
4076
+ "declaration": {
4077
+ "name": "keyboardStrategy",
4078
+ "module": "components/counter/src/keyboardStrategy.js"
4079
+ }
4080
+ }
4081
+ ]
4082
+ },
4051
4083
  {
4052
4084
  "kind": "javascript-module",
4053
4085
  "path": "components/counter/src/registered.js",
@@ -8253,17 +8285,6 @@
8253
8285
  "attribute": "disabled",
8254
8286
  "reflects": true
8255
8287
  },
8256
- {
8257
- "kind": "field",
8258
- "name": "disableFocusTrap",
8259
- "privacy": "public",
8260
- "type": {
8261
- "text": "boolean"
8262
- },
8263
- "description": "If declared, the focus trap inside of bib will be turned off.",
8264
- "attribute": "disableFocusTrap",
8265
- "reflects": true
8266
- },
8267
8288
  {
8268
8289
  "kind": "field",
8269
8290
  "name": "dropdownWidth",
@@ -8547,14 +8568,6 @@
8547
8568
  "description": "If declared, the dropdown is not interactive.",
8548
8569
  "fieldName": "disabled"
8549
8570
  },
8550
- {
8551
- "name": "disableFocusTrap",
8552
- "type": {
8553
- "text": "boolean"
8554
- },
8555
- "description": "If declared, the focus trap inside of bib will be turned off.",
8556
- "fieldName": "disableFocusTrap"
8557
- },
8558
8571
  {
8559
8572
  "name": "dropdownWidth",
8560
8573
  "type": {
@@ -8821,21 +8834,6 @@
8821
8834
  "description": "Forwards the dialog's native `cancel` event (fired on ESC) as\nan `auro-bib-cancel` custom event so parent components can close.",
8822
8835
  "privacy": "private"
8823
8836
  },
8824
- {
8825
- "kind": "method",
8826
- "name": "_setupKeyboardBridge",
8827
- "parameters": [
8828
- {
8829
- "name": "dialog",
8830
- "description": "The dialog element to attach the keyboard bridge to.",
8831
- "type": {
8832
- "text": "HTMLDialogElement"
8833
- }
8834
- }
8835
- ],
8836
- "description": "showModal() creates a closed focus scope — keyboard events inside\nthe dialog's shadow DOM do NOT bubble out to the combobox/select\nkeydown handlers in the parent shadow DOM. This handler bridges\nthat gap by re-dispatching navigation keys so they cross the\nshadow boundary and reach the menu navigation logic in the parent\ncomponent.\n\nThe trade-off: intercepting these keys means native keyboard\nbehaviors that would normally \"just work\" must be manually\nre-implemented here:\n\n- Enter on buttons: Custom elements (auro-button) don't get the\n native Enter→click that <button> provides, so we call .click()\n directly when Enter is pressed on a button-like element.\n\n- Tab: Intercepted and re-dispatched so parent components\n (select/combobox) can select the active option and close the\n dialog. The <dialog> provides containment and isolation\n (inert background, VoiceOver focus trapping, top layer), while\n the content inside is a role=\"listbox\" navigated via\n aria-activedescendant (options are not focusable). Tab keyboard\n behavior follows listbox conventions (select + close) because\n the dialog's native Tab trap only cycles between the close\n button and browser chrome.\n\n- Escape: The native <dialog> fires a `cancel` event on ESC\n (handled by _setupCancelHandler), so the re-dispatched Escape\n is a secondary path for parent components that also listen for\n Escape keydown.",
8837
- "privacy": "private"
8838
- },
8839
8837
  {
8840
8838
  "kind": "method",
8841
8839
  "name": "_lockTouchScroll",
@@ -8899,7 +8897,7 @@
8899
8897
  "type": {
8900
8898
  "text": "boolean"
8901
8899
  },
8902
- "description": "Set by auro-dropdown when a menu option is highlighted via\naria-activedescendant. The dialog keyboard bridge checks this\nflag so that Enter selects the highlighted option instead of\nactivating the focused interactive element (e.g. the trigger\nbutton, or the bibtemplate close button in fullscreen).",
8900
+ "description": "Tracks whether a menu option is currently highlighted.",
8903
8901
  "default": "false",
8904
8902
  "attribute": "hasActiveDescendant"
8905
8903
  },
@@ -8984,16 +8982,6 @@
8984
8982
  },
8985
8983
  "description": "Overrides the native role of the dialog element.\nFor example, set to `\"presentation\"` on desktop combobox to prevent\nVoiceOver from announcing \"listbox inside of a dialog\".\nWhen `undefined`, the dialog keeps its native role.",
8986
8984
  "attribute": "dialogRole"
8987
- },
8988
- {
8989
- "kind": "field",
8990
- "name": "nativeFocusableContent",
8991
- "privacy": "private",
8992
- "type": {
8993
- "text": "boolean"
8994
- },
8995
- "description": "When true, the keyboard bridge allows native Tab behavior\ninstead of intercepting it. Set this for bib consumers\n(e.g. counter) whose content contains real focusable elements\nthat need native Tab navigation.",
8996
- "attribute": "nativeFocusableContent"
8997
8985
  }
8998
8986
  ],
8999
8987
  "events": [
@@ -9089,17 +9077,9 @@
9089
9077
  "type": {
9090
9078
  "text": "boolean"
9091
9079
  },
9092
- "description": "Set by auro-dropdown when a menu option is highlighted via\naria-activedescendant. The dialog keyboard bridge checks this\nflag so that Enter selects the highlighted option instead of\nactivating the focused interactive element (e.g. the trigger\nbutton, or the bibtemplate close button in fullscreen).",
9080
+ "description": "Tracks whether a menu option is currently highlighted.",
9093
9081
  "default": "false",
9094
9082
  "fieldName": "hasActiveDescendant"
9095
- },
9096
- {
9097
- "name": "nativeFocusableContent",
9098
- "type": {
9099
- "text": "boolean"
9100
- },
9101
- "description": "When true, the keyboard bridge allows native Tab behavior\ninstead of intercepting it. Set this for bib consumers\n(e.g. counter) whose content contains real focusable elements\nthat need native Tab navigation.",
9102
- "fieldName": "nativeFocusableContent"
9103
9083
  }
9104
9084
  ],
9105
9085
  "superclass": {
@@ -9120,6 +9100,41 @@
9120
9100
  }
9121
9101
  ]
9122
9102
  },
9103
+ {
9104
+ "kind": "javascript-module",
9105
+ "path": "components/dropdown/src/dropdownBibKeyboardStrategy.js",
9106
+ "declarations": [
9107
+ {
9108
+ "kind": "function",
9109
+ "name": "createDropdownBibKeyboardStrategy",
9110
+ "parameters": [
9111
+ {
9112
+ "name": "bib",
9113
+ "description": "The dropdown bib element.",
9114
+ "type": {
9115
+ "text": "HTMLElement"
9116
+ }
9117
+ }
9118
+ ],
9119
+ "description": "Creates a keyboard strategy for dialog-specific key handling.\nAll other keydown behavior is left to the browser's native bubbling path.",
9120
+ "return": {
9121
+ "type": {
9122
+ "text": "Object"
9123
+ }
9124
+ }
9125
+ }
9126
+ ],
9127
+ "exports": [
9128
+ {
9129
+ "kind": "js",
9130
+ "name": "createDropdownBibKeyboardStrategy",
9131
+ "declaration": {
9132
+ "name": "createDropdownBibKeyboardStrategy",
9133
+ "module": "components/dropdown/src/dropdownBibKeyboardStrategy.js"
9134
+ }
9135
+ }
9136
+ ]
9137
+ },
9123
9138
  {
9124
9139
  "kind": "javascript-module",
9125
9140
  "path": "components/dropdown/src/iconVersion.js",
@@ -15104,21 +15119,6 @@
15104
15119
  "description": "Handles nested menu structure.",
15105
15120
  "privacy": "private"
15106
15121
  },
15107
- {
15108
- "kind": "method",
15109
- "name": "handleKeyDown",
15110
- "parameters": [
15111
- {
15112
- "name": "event",
15113
- "description": "Event object from the browser.",
15114
- "type": {
15115
- "text": "KeyboardEvent"
15116
- }
15117
- }
15118
- ],
15119
- "description": "Handles keyboard navigation.",
15120
- "privacy": "private"
15121
- },
15122
15122
  {
15123
15123
  "kind": "method",
15124
15124
  "name": "navigateOptions",