@aurodesignsystem-dev/auro-formkit 0.0.0-pr1489.6 → 0.0.0-pr1489.7

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