@aurodesignsystem-dev/auro-formkit 0.0.0-pr1408.14 → 0.0.0-pr1408.16

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