@aurodesignsystem-dev/auro-formkit 0.0.0-pr1440.4 → 0.0.0-pr1441.0

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