@aurodesignsystem-dev/auro-formkit 0.0.0-pr1424.4 → 0.0.0-pr1424.6

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