@aurodesignsystem-dev/auro-formkit 0.0.0-pr1408.8 → 0.0.0-pr1411.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/components/checkbox/demo/api.min.js +1 -1
  2. package/components/checkbox/demo/index.min.js +1 -1
  3. package/components/checkbox/demo/keyboardBehavior.md +0 -0
  4. package/components/checkbox/dist/index.js +1 -1
  5. package/components/checkbox/dist/registered.js +1 -1
  6. package/components/combobox/demo/api.min.js +121 -144
  7. package/components/combobox/demo/index.min.js +121 -144
  8. package/components/combobox/demo/keyboardBehavior.html +1 -0
  9. package/components/combobox/demo/keyboardBehavior.md +21 -22
  10. package/components/combobox/dist/index.js +87 -117
  11. package/components/combobox/dist/registered.js +87 -117
  12. package/components/counter/demo/api.md +1 -1
  13. package/components/counter/demo/api.min.js +184 -148
  14. package/components/counter/demo/index.min.js +184 -148
  15. package/components/counter/demo/keyboardBehavior.html +1 -0
  16. package/components/counter/demo/keyboardBehavior.md +1 -1
  17. package/components/counter/dist/auro-counter.d.ts +11 -8
  18. package/components/counter/dist/index.js +184 -148
  19. package/components/counter/dist/keyboardStrategy.d.ts +4 -0
  20. package/components/counter/dist/registered.js +184 -148
  21. package/components/datepicker/demo/api.min.js +89 -120
  22. package/components/datepicker/demo/index.min.js +89 -120
  23. package/components/datepicker/demo/keyboardBehavior.html +1 -0
  24. package/components/datepicker/demo/keyboardBehavior.md +14 -13
  25. package/components/datepicker/dist/index.js +84 -115
  26. package/components/datepicker/dist/registered.js +84 -115
  27. package/components/dropdown/demo/api.md +0 -1
  28. package/components/dropdown/demo/api.min.js +99 -123
  29. package/components/dropdown/demo/index.md +2 -2
  30. package/components/dropdown/demo/index.min.js +99 -123
  31. package/components/dropdown/demo/keyboardBehavior.html +1 -0
  32. package/components/dropdown/dist/auro-dropdown.d.ts +0 -8
  33. package/components/dropdown/dist/auro-dropdownBib.d.ts +1 -40
  34. package/components/dropdown/dist/dropdownBibKeyboardStrategy.d.ts +7 -0
  35. package/components/dropdown/dist/index.js +83 -111
  36. package/components/dropdown/dist/registered.js +83 -111
  37. package/components/form/demo/api.min.js +542 -564
  38. package/components/form/demo/index.min.js +542 -564
  39. package/components/form/demo/keyboardBehavior.md +0 -0
  40. package/components/input/demo/api.min.js +1 -1
  41. package/components/input/demo/index.min.js +1 -1
  42. package/components/input/demo/keyboardBehavior.md +0 -0
  43. package/components/input/dist/index.js +1 -1
  44. package/components/input/dist/registered.js +1 -1
  45. package/components/menu/demo/api.min.js +34 -27
  46. package/components/menu/demo/index.min.js +34 -27
  47. package/components/menu/dist/auro-menu.d.ts +0 -6
  48. package/components/menu/dist/index.js +34 -27
  49. package/components/menu/dist/registered.js +34 -27
  50. package/components/radio/demo/api.min.js +1 -1
  51. package/components/radio/demo/index.min.js +1 -1
  52. package/components/radio/dist/index.js +1 -1
  53. package/components/radio/dist/registered.js +1 -1
  54. package/components/select/demo/api.min.js +181 -178
  55. package/components/select/demo/index.min.js +181 -178
  56. package/components/select/demo/keyboardBehavior.html +1 -0
  57. package/components/select/demo/keyboardBehavior.md +240 -239
  58. package/components/select/dist/index.js +147 -151
  59. package/components/select/dist/registered.js +147 -151
  60. package/components/select/dist/selectKeyboardStrategy.d.ts +3 -1
  61. package/custom-elements.json +1521 -1503
  62. package/package.json +5 -3
@@ -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
- }
1352
- }
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"
1353
1269
  },
1354
1270
  {
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
- }
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"
1372
1305
  }
1373
1306
  },
1374
1307
  {
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
- }
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"
1383
1503
  }
1384
1504
  },
1385
1505
  {
1386
- "kind": "method",
1387
- "name": "focus",
1388
- "description": "Focuses the combobox trigger input.",
1389
- "return": {
1390
- "type": {
1391
- "text": "void"
1392
- }
1506
+ "name": "size",
1507
+ "type": {
1508
+ "text": "string"
1509
+ },
1510
+ "fieldName": "size",
1511
+ "inheritedFrom": {
1512
+ "name": "AuroElement",
1513
+ "module": "components/layoutElement/src/auroElement.js"
1393
1514
  }
1394
1515
  },
1395
1516
  {
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
- }
1517
+ "name": "ondark",
1518
+ "type": {
1519
+ "text": "boolean"
1520
+ },
1521
+ "fieldName": "onDark",
1522
+ "inheritedFrom": {
1523
+ "name": "AuroElement",
1524
+ "module": "components/layoutElement/src/auroElement.js"
1412
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"
1413
1613
  },
1414
1614
  {
1415
- "kind": "method",
1416
- "name": "reset",
1417
- "description": "Resets component to initial state.",
1418
- "return": {
1419
- "type": {
1420
- "text": "void"
1421
- }
1422
- }
1615
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1616
+ "name": "optionalLabel"
1617
+ },
1618
+ {
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,31 +1675,19 @@
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
- }
1678
+ "name": "handlePreselectedItems",
1679
+ "description": "Helper method that handles the state of preselected checkboxes.",
1680
+ "privacy": "private",
1681
+ "return": {
1682
+ "type": {
1683
+ "text": "void"
1494
1684
  }
1495
- ],
1496
- "description": "Updates the active option in the menu."
1685
+ }
1497
1686
  },
1498
1687
  {
1499
1688
  "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.",
1689
+ "name": "handleItems",
1690
+ "description": "Helper method that handles the state of checkboxes.",
1511
1691
  "privacy": "private",
1512
1692
  "return": {
1513
1693
  "type": {
@@ -1516,203 +1696,74 @@
1516
1696
  }
1517
1697
  },
1518
1698
  {
1519
- "kind": "field",
1520
- "name": "appearance",
1521
- "privacy": "public",
1522
- "type": {
1523
- "text": "string"
1524
- },
1525
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1526
- "default": "'default'",
1527
- "attribute": "appearance",
1528
- "reflects": true
1529
- },
1530
- {
1531
- "kind": "field",
1532
- "name": "autocomplete",
1533
- "privacy": "public",
1534
- "type": {
1535
- "text": "string"
1536
- },
1537
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1538
- "attribute": "autocomplete",
1539
- "reflects": true
1540
- },
1541
- {
1542
- "kind": "field",
1543
- "name": "autoPlacement",
1544
- "privacy": "public",
1545
- "type": {
1546
- "text": "boolean"
1547
- },
1548
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1549
- "attribute": "autoPlacement",
1550
- "reflects": true
1551
- },
1552
- {
1553
- "kind": "field",
1554
- "name": "availableOptions",
1555
- "privacy": "private",
1556
- "type": {
1557
- "text": "array"
1558
- },
1559
- "description": "Array of available options to display in the dropdown.",
1560
- "attribute": "availableOptions"
1561
- },
1562
- {
1563
- "kind": "field",
1564
- "name": "behavior",
1565
- "privacy": "public",
1566
- "type": {
1567
- "text": "'filter' | 'suggestion'"
1568
- },
1569
- "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
1570
- "default": "'suggestion'",
1571
- "attribute": "behavior",
1572
- "reflects": true
1573
- },
1574
- {
1575
- "kind": "field",
1576
- "name": "checkmark",
1577
- "privacy": "public",
1578
- "type": {
1579
- "text": "boolean"
1580
- },
1581
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1582
- "attribute": "checkmark",
1583
- "reflects": true
1584
- },
1585
- {
1586
- "kind": "field",
1587
- "name": "disabled",
1588
- "privacy": "public",
1589
- "type": {
1590
- "text": "boolean"
1591
- },
1592
- "description": "If set, disables the combobox.",
1593
- "attribute": "disabled",
1594
- "reflects": true
1595
- },
1596
- {
1597
- "kind": "field",
1598
- "name": "dropdownId",
1599
- "privacy": "private",
1600
- "type": {
1601
- "text": "string"
1602
- },
1603
- "description": "ID for the dropdown."
1604
- },
1605
- {
1606
- "kind": "field",
1607
- "name": "dropdownOpen",
1608
- "privacy": "private",
1609
- "type": {
1610
- "text": "boolean"
1611
- },
1612
- "description": "Whether or not the dropdown is open."
1613
- },
1614
- {
1615
- "kind": "field",
1616
- "name": "dvInputOnly",
1617
- "privacy": "public",
1618
- "type": {
1619
- "text": "boolean"
1620
- },
1621
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1622
- "attribute": "dvInputOnly",
1623
- "reflects": true
1624
- },
1625
- {
1626
- "kind": "field",
1627
- "name": "error",
1628
- "privacy": "public",
1629
- "type": {
1630
- "text": "string"
1631
- },
1632
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1633
- "attribute": "error",
1634
- "reflects": true
1635
- },
1636
- {
1637
- "kind": "field",
1638
- "name": "format",
1639
- "privacy": "public",
1640
- "type": {
1641
- "text": "string"
1642
- },
1643
- "description": "Specifies the input mask format.",
1644
- "attribute": "format",
1645
- "reflects": true
1646
- },
1647
- {
1648
- "kind": "field",
1649
- "name": "inputmode",
1650
- "privacy": "public",
1651
- "type": {
1652
- "text": "string"
1653
- },
1654
- "description": "Exposes inputmode attribute for input.",
1655
- "attribute": "inputmode",
1656
- "reflects": true
1699
+ "kind": "method",
1700
+ "name": "reset",
1701
+ "description": "Resets component to initial state.",
1702
+ "return": {
1703
+ "type": {
1704
+ "text": "void"
1705
+ }
1706
+ }
1657
1707
  },
1658
1708
  {
1659
- "kind": "field",
1660
- "name": "layout",
1661
- "privacy": "public",
1662
- "type": {
1663
- "text": "string"
1664
- },
1665
- "description": "Sets the layout of the combobox.",
1666
- "default": "'classic'",
1667
- "attribute": "layout",
1668
- "reflects": true,
1669
- "inheritedFrom": {
1670
- "name": "AuroElement",
1671
- "module": "components/layoutElement/src/auroElement.js"
1672
- }
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."
1673
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
  },
@@ -1838,58 +1829,6 @@
1838
1829
  "description": "Custom help text message to display when validity = `valueMissing`.",
1839
1830
  "attribute": "setCustomValidityValueMissing"
1840
1831
  },
1841
- {
1842
- "kind": "field",
1843
- "name": "setCustomValidityValueMissingFilter",
1844
- "privacy": "public",
1845
- "type": {
1846
- "text": "string"
1847
- },
1848
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1849
- "attribute": "setCustomValidityValueMissingFilter"
1850
- },
1851
- {
1852
- "kind": "field",
1853
- "name": "touched",
1854
- "privacy": "private",
1855
- "type": {
1856
- "text": "boolean"
1857
- },
1858
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1859
- },
1860
- {
1861
- "kind": "field",
1862
- "name": "triggerIcon",
1863
- "privacy": "public",
1864
- "type": {
1865
- "text": "boolean"
1866
- },
1867
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1868
- "attribute": "triggerIcon",
1869
- "reflects": true
1870
- },
1871
- {
1872
- "kind": "field",
1873
- "name": "type",
1874
- "privacy": "public",
1875
- "type": {
1876
- "text": "string"
1877
- },
1878
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1879
- "attribute": "type",
1880
- "reflects": true
1881
- },
1882
- {
1883
- "kind": "field",
1884
- "name": "typedValue",
1885
- "privacy": "public",
1886
- "type": {
1887
- "text": "string"
1888
- },
1889
- "description": "Specifies the value of the input element within the combobox.",
1890
- "attribute": "typedValue",
1891
- "reflects": true
1892
- },
1893
1832
  {
1894
1833
  "kind": "field",
1895
1834
  "name": "validity",
@@ -1900,551 +1839,612 @@
1900
1839
  "description": "Specifies the `validityState` this element is in.",
1901
1840
  "attribute": "validity",
1902
1841
  "reflects": true
1903
- },
1904
- {
1905
- "kind": "field",
1906
- "name": "value",
1907
- "privacy": "public",
1908
- "type": {
1909
- "text": "string"
1910
- },
1911
- "description": "Value selected for the dropdown menu.",
1912
- "attribute": "value"
1913
- },
1914
- {
1915
- "kind": "field",
1916
- "name": "largeFullscreenHeadline",
1917
- "privacy": "public",
1918
- "type": {
1919
- "text": "boolean"
1920
- },
1921
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1922
- "attribute": "largeFullscreenHeadline",
1923
- "reflects": true
1924
- },
1842
+ }
1843
+ ],
1844
+ "events": [
1925
1845
  {
1926
- "kind": "field",
1927
- "name": "fullscreenBreakpoint",
1928
- "privacy": "public",
1846
+ "name": "input",
1929
1847
  "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
1848
+ "text": "CustomEvent"
1849
+ }
1936
1850
  },
1937
1851
  {
1938
- "kind": "field",
1939
- "name": "optionActive",
1940
- "privacy": "private",
1941
- "type": {
1942
- "text": "object"
1943
- },
1944
- "description": "Specifies the currently active option."
1945
- },
1852
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1853
+ "name": "auroFormElement-validated"
1854
+ }
1855
+ ],
1856
+ "attributes": [
1946
1857
  {
1947
- "kind": "field",
1948
- "name": "triggerExpandedState",
1949
- "privacy": "private",
1858
+ "name": "appearance",
1950
1859
  "type": {
1951
- "text": "boolean"
1952
- },
1953
- "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1954
- },
1955
- {
1956
- "kind": "field",
1957
- "name": "componentHasFocus",
1958
- "description": "Returns true if the element has focus.",
1959
- "privacy": "private",
1960
- "return": {
1961
- "type": {
1962
- "text": "boolean"
1963
- }
1860
+ "text": "'default' | 'inverse'"
1964
1861
  },
1965
- "readonly": true,
1966
- "inheritedFrom": {
1967
- "name": "AuroElement",
1968
- "module": "components/layoutElement/src/auroElement.js"
1969
- }
1970
- },
1971
- {
1972
- "kind": "method",
1973
- "name": "resetShapeClasses",
1974
- "inheritedFrom": {
1975
- "name": "AuroElement",
1976
- "module": "components/layoutElement/src/auroElement.js"
1977
- }
1978
- },
1979
- {
1980
- "kind": "method",
1981
- "name": "resetLayoutClasses",
1982
- "inheritedFrom": {
1983
- "name": "AuroElement",
1984
- "module": "components/layoutElement/src/auroElement.js"
1985
- }
1986
- },
1987
- {
1988
- "kind": "method",
1989
- "name": "updateComponentArchitecture",
1990
- "inheritedFrom": {
1991
- "name": "AuroElement",
1992
- "module": "components/layoutElement/src/auroElement.js"
1993
- }
1862
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1863
+ "default": "'default'",
1864
+ "fieldName": "appearance"
1994
1865
  },
1995
1866
  {
1996
- "kind": "field",
1997
- "name": "shape",
1998
- "privacy": "public",
1867
+ "name": "disabled",
1999
1868
  "type": {
2000
- "text": "string"
1869
+ "text": "boolean"
2001
1870
  },
2002
- "attribute": "shape",
2003
- "reflects": true,
2004
- "inheritedFrom": {
2005
- "name": "AuroElement",
2006
- "module": "components/layoutElement/src/auroElement.js"
2007
- }
1871
+ "description": "If set, disables the checkbox group.",
1872
+ "fieldName": "disabled"
2008
1873
  },
2009
1874
  {
2010
- "kind": "field",
2011
- "name": "size",
2012
- "privacy": "public",
1875
+ "name": "error",
2013
1876
  "type": {
2014
1877
  "text": "string"
2015
1878
  },
2016
- "attribute": "size",
2017
- "reflects": true,
2018
- "inheritedFrom": {
2019
- "name": "AuroElement",
2020
- "module": "components/layoutElement/src/auroElement.js"
2021
- }
2022
- }
2023
- ],
2024
- "events": [
1879
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1880
+ "fieldName": "error"
1881
+ },
2025
1882
  {
2026
- "name": "inputValue",
1883
+ "name": "horizontal",
2027
1884
  "type": {
2028
- "text": "CustomEvent"
1885
+ "text": "boolean"
2029
1886
  },
2030
- "description": "Notifies that the components internal HTML5 input value has changed."
1887
+ "description": "If set, checkboxes will be aligned horizontally.",
1888
+ "fieldName": "horizontal"
2031
1889
  },
2032
1890
  {
2033
- "name": "input",
1891
+ "name": "noValidate",
2034
1892
  "type": {
2035
- "text": "CustomEvent"
1893
+ "text": "boolean"
2036
1894
  },
2037
- "description": "Notifies that the component has a new value set."
1895
+ "description": "If set, disables auto-validation on blur.",
1896
+ "fieldName": "noValidate"
2038
1897
  },
2039
1898
  {
2040
- "name": "auroCombobox-valueSet",
1899
+ "name": "onDark",
2041
1900
  "type": {
2042
- "text": "CustomEvent"
1901
+ "text": "boolean"
2043
1902
  },
2044
- "description": "(Deprecated) Notifies that the component has a new value set."
1903
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1904
+ "fieldName": "onDark"
2045
1905
  },
2046
1906
  {
2047
- "description": "Notifies that the component value(s) have been validated.",
2048
- "name": "auroFormElement-validated"
2049
- }
2050
- ],
2051
- "attributes": [
1907
+ "name": "required",
1908
+ "type": {
1909
+ "text": "boolean"
1910
+ },
1911
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1912
+ "fieldName": "required"
1913
+ },
2052
1914
  {
2053
- "name": "appearance",
1915
+ "name": "setCustomValidity",
2054
1916
  "type": {
2055
1917
  "text": "string"
2056
1918
  },
2057
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2058
- "default": "'default'",
2059
- "fieldName": "appearance"
1919
+ "description": "Sets a custom help text message to display for all validityStates.",
1920
+ "fieldName": "setCustomValidity"
2060
1921
  },
2061
1922
  {
2062
- "name": "autocomplete",
1923
+ "name": "setCustomValidityCustomError",
2063
1924
  "type": {
2064
1925
  "text": "string"
2065
1926
  },
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"
1927
+ "description": "Custom help text message to display when validity = `customError`.",
1928
+ "fieldName": "setCustomValidityCustomError"
2068
1929
  },
2069
1930
  {
2070
- "name": "autoPlacement",
1931
+ "name": "setCustomValidityValueMissing",
2071
1932
  "type": {
2072
- "text": "boolean"
1933
+ "text": "string"
2073
1934
  },
2074
- "description": "If declared, bib's position will be automatically calculated where to appear.",
2075
- "fieldName": "autoPlacement"
1935
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1936
+ "fieldName": "setCustomValidityValueMissing"
2076
1937
  },
2077
1938
  {
2078
- "name": "availableOptions",
1939
+ "name": "validity",
2079
1940
  "type": {
2080
- "text": "array"
1941
+ "text": "string"
2081
1942
  },
2082
- "description": "Array of available options to display in the dropdown.",
2083
- "fieldName": "availableOptions"
1943
+ "description": "Specifies the `validityState` this element is in.",
1944
+ "fieldName": "validity"
1945
+ }
1946
+ ],
1947
+ "superclass": {
1948
+ "name": "LitElement",
1949
+ "package": "lit"
1950
+ },
1951
+ "tagName": "auro-checkbox-group",
1952
+ "customElement": true
1953
+ }
1954
+ ],
1955
+ "exports": [
1956
+ {
1957
+ "kind": "js",
1958
+ "name": "AuroCheckboxGroup",
1959
+ "declaration": {
1960
+ "name": "AuroCheckboxGroup",
1961
+ "module": "components/checkbox/src/auro-checkbox-group.js"
1962
+ }
1963
+ }
1964
+ ]
1965
+ },
1966
+ {
1967
+ "kind": "javascript-module",
1968
+ "path": "components/checkbox/src/auro-checkbox.js",
1969
+ "declarations": [
1970
+ {
1971
+ "kind": "class",
1972
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
1973
+ "name": "AuroCheckbox",
1974
+ "cssParts": [
1975
+ {
1976
+ "description": "apply css to a specific checkbox.",
1977
+ "name": "checkbox"
1978
+ },
1979
+ {
1980
+ "description": "apply css to a specific checkbox's input.",
1981
+ "name": "checkbox-input"
1982
+ },
1983
+ {
1984
+ "description": "apply css to a specific checkbox's label.",
1985
+ "name": "checkbox-label"
1986
+ }
1987
+ ],
1988
+ "slots": [
1989
+ {
1990
+ "description": "The default slot for the checkbox label.",
1991
+ "name": "default"
1992
+ }
1993
+ ],
1994
+ "members": [
1995
+ {
1996
+ "kind": "method",
1997
+ "name": "_initializeDefaults"
1998
+ },
1999
+ {
2000
+ "kind": "method",
2001
+ "name": "register",
2002
+ "static": true,
2003
+ "parameters": [
2004
+ {
2005
+ "name": "name",
2006
+ "default": "\"auro-checkbox\"",
2007
+ "description": "The name of element that you want to register to.",
2008
+ "optional": true,
2009
+ "type": {
2010
+ "text": "string"
2011
+ }
2012
+ }
2013
+ ],
2014
+ "description": "This will register this element with the browser."
2015
+ },
2016
+ {
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
+ }
2098
+ },
2099
+ {
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"
2162
- },
2163
- {
2164
- "name": "noFilter",
2165
- "type": {
2166
- "text": "boolean"
2167
- },
2168
- "description": "If set, combobox will not filter menuoptions based on input.",
2169
- "fieldName": "noFilter"
2190
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2191
+ "attribute": "name"
2170
2192
  },
2171
2193
  {
2172
- "name": "noFlip",
2194
+ "kind": "field",
2195
+ "name": "onDark",
2196
+ "privacy": "public",
2173
2197
  "type": {
2174
2198
  "text": "boolean"
2175
2199
  },
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"
2200
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2201
+ "attribute": "onDark",
2202
+ "reflects": true
2178
2203
  },
2179
2204
  {
2180
- "name": "shift",
2205
+ "kind": "field",
2206
+ "name": "touched",
2207
+ "privacy": "private",
2181
2208
  "type": {
2182
2209
  "text": "boolean"
2183
2210
  },
2184
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2185
- "fieldName": "shift"
2211
+ "description": "Indicates whether the checkbox has been interacted with."
2186
2212
  },
2187
2213
  {
2188
- "name": "noValidate",
2214
+ "kind": "field",
2215
+ "name": "value",
2216
+ "privacy": "public",
2189
2217
  "type": {
2190
- "text": "boolean"
2218
+ "text": "string"
2191
2219
  },
2192
- "description": "If set, disables auto-validation on blur.",
2193
- "fieldName": "noValidate"
2220
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2221
+ "attribute": "value"
2194
2222
  },
2195
2223
  {
2196
- "name": "offset",
2224
+ "kind": "field",
2225
+ "name": "tabIndex",
2226
+ "privacy": "private",
2197
2227
  "type": {
2198
2228
  "text": "number"
2199
2229
  },
2200
- "description": "Gap between the trigger element and bib.",
2201
- "default": "0",
2202
- "fieldName": "offset"
2230
+ "description": "The tabindex attribute for the checkbox.",
2231
+ "attribute": "tabindex",
2232
+ "reflects": true
2203
2233
  },
2204
2234
  {
2205
- "name": "onDark",
2235
+ "kind": "field",
2236
+ "name": "ariaChecked",
2237
+ "privacy": "private",
2206
2238
  "type": {
2207
- "text": "boolean"
2239
+ "text": "string"
2208
2240
  },
2209
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2210
- "fieldName": "onDark"
2241
+ "description": "The aria-checked attribute for the checkbox.",
2242
+ "attribute": "aria-checked",
2243
+ "reflects": true
2211
2244
  },
2212
2245
  {
2213
- "name": "optionSelected",
2246
+ "kind": "field",
2247
+ "name": "ariaDisabled",
2248
+ "privacy": "private",
2214
2249
  "type": {
2215
- "text": "HTMLElement"
2250
+ "text": "string"
2216
2251
  },
2217
- "description": "Specifies the current selected option.",
2218
- "fieldName": "optionSelected"
2252
+ "description": "The aria-disabled attribute for the checkbox.",
2253
+ "attribute": "aria-disabled",
2254
+ "reflects": true
2219
2255
  },
2220
2256
  {
2221
- "name": "persistInput",
2257
+ "kind": "field",
2258
+ "name": "role",
2259
+ "privacy": "private",
2222
2260
  "type": {
2223
- "text": "boolean"
2261
+ "text": "string"
2224
2262
  },
2225
- "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
2226
- "fieldName": "persistInput"
2227
- },
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": [
2228
2269
  {
2229
- "name": "placement",
2270
+ "name": "auroCheckbox-input",
2230
2271
  "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"
2272
+ "text": "CustomEvent"
2273
+ }
2236
2274
  },
2237
2275
  {
2238
- "name": "placeholder",
2276
+ "name": "auroCheckbox-focusin",
2239
2277
  "type": {
2240
- "text": "string"
2241
- },
2242
- "description": "Define custom placeholder text, only supported by date input formats.",
2243
- "fieldName": "placeholder"
2278
+ "text": "CustomEvent"
2279
+ }
2244
2280
  },
2245
2281
  {
2246
- "name": "required",
2282
+ "name": "auroCheckbox-focusout",
2247
2283
  "type": {
2248
- "text": "boolean"
2249
- },
2250
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2251
- "fieldName": "required"
2284
+ "text": "CustomEvent"
2285
+ }
2252
2286
  },
2253
2287
  {
2254
- "name": "setCustomValidity",
2255
2288
  "type": {
2256
- "text": "string"
2289
+ "text": "CustomEvent<any>"
2257
2290
  },
2258
- "description": "Sets a custom help text message to display for all validityStates.",
2259
- "fieldName": "setCustomValidity"
2291
+ "description": "(Deprecated) Notifies when checked value is changed.",
2292
+ "name": "change"
2260
2293
  },
2261
2294
  {
2262
- "name": "setCustomValidityCustomError",
2263
2295
  "type": {
2264
- "text": "string"
2296
+ "text": "InputEvent"
2265
2297
  },
2266
- "description": "Custom help text message to display when validity = `customError`.",
2267
- "fieldName": "setCustomValidityCustomError"
2268
- },
2298
+ "description": "Notifies when when checked value is changed by user's interface.",
2299
+ "name": "input"
2300
+ }
2301
+ ],
2302
+ "attributes": [
2269
2303
  {
2270
- "name": "setCustomValidityValueMissing",
2304
+ "name": "appearance",
2271
2305
  "type": {
2272
- "text": "string"
2306
+ "text": "'default' | 'inverse'"
2273
2307
  },
2274
- "description": "Custom help text message to display when validity = `valueMissing`.",
2275
- "fieldName": "setCustomValidityValueMissing"
2308
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2309
+ "default": "'default'",
2310
+ "fieldName": "appearance"
2276
2311
  },
2277
2312
  {
2278
- "name": "setCustomValidityValueMissingFilter",
2313
+ "name": "checked",
2279
2314
  "type": {
2280
- "text": "string"
2315
+ "text": "boolean"
2281
2316
  },
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"
2317
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2318
+ "fieldName": "checked"
2284
2319
  },
2285
2320
  {
2286
- "name": "triggerIcon",
2321
+ "name": "disabled",
2287
2322
  "type": {
2288
2323
  "text": "boolean"
2289
2324
  },
2290
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2291
- "fieldName": "triggerIcon"
2325
+ "description": "If set to true, the checkbox will not be clickable.",
2326
+ "fieldName": "disabled"
2292
2327
  },
2293
2328
  {
2294
- "name": "type",
2329
+ "name": "error",
2295
2330
  "type": {
2296
- "text": "string"
2331
+ "text": "boolean"
2297
2332
  },
2298
- "description": "Applies the defined value as the type attribute on `auro-input`.",
2299
- "fieldName": "type"
2333
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2334
+ "fieldName": "error"
2300
2335
  },
2301
2336
  {
2302
- "name": "typedValue",
2337
+ "name": "id",
2303
2338
  "type": {
2304
2339
  "text": "string"
2305
2340
  },
2306
- "description": "Specifies the value of the input element within the combobox.",
2307
- "fieldName": "typedValue"
2341
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2342
+ "fieldName": "id"
2308
2343
  },
2309
2344
  {
2310
- "name": "validity",
2345
+ "name": "name",
2311
2346
  "type": {
2312
2347
  "text": "string"
2313
2348
  },
2314
- "description": "Specifies the `validityState` this element is in.",
2315
- "fieldName": "validity"
2349
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2350
+ "fieldName": "name"
2316
2351
  },
2317
2352
  {
2318
- "name": "value",
2353
+ "name": "onDark",
2319
2354
  "type": {
2320
- "text": "string"
2355
+ "text": "boolean"
2321
2356
  },
2322
- "description": "Value selected for the dropdown menu.",
2323
- "fieldName": "value"
2357
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2358
+ "fieldName": "onDark"
2324
2359
  },
2325
2360
  {
2326
- "name": "largeFullscreenHeadline",
2361
+ "name": "value",
2327
2362
  "type": {
2328
- "text": "boolean"
2363
+ "text": "string"
2329
2364
  },
2330
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2331
- "fieldName": "largeFullscreenHeadline"
2365
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2366
+ "fieldName": "value"
2332
2367
  },
2333
2368
  {
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",
@@ -8253,17 +8285,6 @@
8253
8285
  "attribute": "disabled",
8254
8286
  "reflects": true
8255
8287
  },
8256
- {
8257
- "kind": "field",
8258
- "name": "disableFocusTrap",
8259
- "privacy": "public",
8260
- "type": {
8261
- "text": "boolean"
8262
- },
8263
- "description": "If declared, the focus trap inside of bib will be turned off.",
8264
- "attribute": "disableFocusTrap",
8265
- "reflects": true
8266
- },
8267
8288
  {
8268
8289
  "kind": "field",
8269
8290
  "name": "dropdownWidth",
@@ -8547,14 +8568,6 @@
8547
8568
  "description": "If declared, the dropdown is not interactive.",
8548
8569
  "fieldName": "disabled"
8549
8570
  },
8550
- {
8551
- "name": "disableFocusTrap",
8552
- "type": {
8553
- "text": "boolean"
8554
- },
8555
- "description": "If declared, the focus trap inside of bib will be turned off.",
8556
- "fieldName": "disableFocusTrap"
8557
- },
8558
8571
  {
8559
8572
  "name": "dropdownWidth",
8560
8573
  "type": {
@@ -8821,21 +8834,6 @@
8821
8834
  "description": "Forwards the dialog's native `cancel` event (fired on ESC) as\nan `auro-bib-cancel` custom event so parent components can close.",
8822
8835
  "privacy": "private"
8823
8836
  },
8824
- {
8825
- "kind": "method",
8826
- "name": "_setupKeyboardBridge",
8827
- "parameters": [
8828
- {
8829
- "name": "dialog",
8830
- "description": "The dialog element to attach the keyboard bridge to.",
8831
- "type": {
8832
- "text": "HTMLDialogElement"
8833
- }
8834
- }
8835
- ],
8836
- "description": "showModal() creates a closed focus scope — keyboard events inside\nthe dialog's shadow DOM do NOT bubble out to the combobox/select\nkeydown handlers in the parent shadow DOM. This handler bridges\nthat gap by re-dispatching navigation keys so they cross the\nshadow boundary and reach the menu navigation logic in the parent\ncomponent.\n\nThe trade-off: intercepting these keys means native keyboard\nbehaviors that would normally \"just work\" must be manually\nre-implemented here:\n\n- Enter on buttons: Custom elements (auro-button) don't get the\n native Enter→click that <button> provides, so we call .click()\n directly when Enter is pressed on a button-like element.\n\n- Tab: Intercepted and re-dispatched so parent components\n (select/combobox) can select the active option and close the\n dialog. The <dialog> provides containment and isolation\n (inert background, VoiceOver focus trapping, top layer), while\n the content inside is a role=\"listbox\" navigated via\n aria-activedescendant (options are not focusable). Tab keyboard\n behavior follows listbox conventions (select + close) because\n the dialog's native Tab trap only cycles between the close\n button and browser chrome.\n\n- Escape: The native <dialog> fires a `cancel` event on ESC\n (handled by _setupCancelHandler), so the re-dispatched Escape\n is a secondary path for parent components that also listen for\n Escape keydown.",
8837
- "privacy": "private"
8838
- },
8839
8837
  {
8840
8838
  "kind": "method",
8841
8839
  "name": "_lockTouchScroll",
@@ -8899,7 +8897,7 @@
8899
8897
  "type": {
8900
8898
  "text": "boolean"
8901
8899
  },
8902
- "description": "Set by auro-dropdown when a menu option is highlighted via\naria-activedescendant. The dialog keyboard bridge checks this\nflag so that Enter selects the highlighted option instead of\nactivating the focused interactive element (e.g. the trigger\nbutton, or the bibtemplate close button in fullscreen).",
8900
+ "description": "Tracks whether a menu option is currently highlighted.",
8903
8901
  "default": "false",
8904
8902
  "attribute": "hasActiveDescendant"
8905
8903
  },
@@ -9079,7 +9077,7 @@
9079
9077
  "type": {
9080
9078
  "text": "boolean"
9081
9079
  },
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).",
9080
+ "description": "Tracks whether a menu option is currently highlighted.",
9083
9081
  "default": "false",
9084
9082
  "fieldName": "hasActiveDescendant"
9085
9083
  }
@@ -9102,6 +9100,41 @@
9102
9100
  }
9103
9101
  ]
9104
9102
  },
9103
+ {
9104
+ "kind": "javascript-module",
9105
+ "path": "components/dropdown/src/dropdownBibKeyboardStrategy.js",
9106
+ "declarations": [
9107
+ {
9108
+ "kind": "function",
9109
+ "name": "createDropdownBibKeyboardStrategy",
9110
+ "parameters": [
9111
+ {
9112
+ "name": "bib",
9113
+ "description": "The dropdown bib element.",
9114
+ "type": {
9115
+ "text": "HTMLElement"
9116
+ }
9117
+ }
9118
+ ],
9119
+ "description": "Creates a keyboard strategy for dialog-specific key handling.\nAll other keydown behavior is left to the browser's native bubbling path.",
9120
+ "return": {
9121
+ "type": {
9122
+ "text": "Object"
9123
+ }
9124
+ }
9125
+ }
9126
+ ],
9127
+ "exports": [
9128
+ {
9129
+ "kind": "js",
9130
+ "name": "createDropdownBibKeyboardStrategy",
9131
+ "declaration": {
9132
+ "name": "createDropdownBibKeyboardStrategy",
9133
+ "module": "components/dropdown/src/dropdownBibKeyboardStrategy.js"
9134
+ }
9135
+ }
9136
+ ]
9137
+ },
9105
9138
  {
9106
9139
  "kind": "javascript-module",
9107
9140
  "path": "components/dropdown/src/iconVersion.js",
@@ -15086,21 +15119,6 @@
15086
15119
  "description": "Handles nested menu structure.",
15087
15120
  "privacy": "private"
15088
15121
  },
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
15122
  {
15105
15123
  "kind": "method",
15106
15124
  "name": "navigateOptions",
@@ -18674,7 +18692,7 @@
18674
18692
  "type": {
18675
18693
  "text": "object"
18676
18694
  },
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); }, }"
18695
+ "default": "{ ArrowUp(component, evt, ctx) { // Navigate menu only if the bib is open, otherwise open the bib evt.preventDefault(); if (evt.altKey || evt.metaKey) { // navigate to first enabled option } else if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'up', { ctx, showFn: () => component.dropdown.show(), }); } else { component.dropdown.show(); } }, ArrowDown(component, evt, ctx) { // Navigate menu only if the bib is open, otherwise open the bib evt.preventDefault(); if (evt.altKey || evt.metaKey) { // navigate to last enabled option } else if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'down', { ctx, showFn: () => component.dropdown.show(), }); } else { component.dropdown.show(); } }, Enter(component, evt, ctx) { if (!ctx.isExpanded && ctx.isPopover) { component.menu.makeSelection(); } else if (ctx.isModal && !evt.defaultPrevented) { // for modal, isExpanded is always true // defaultPrevented will be true if Floating UI has already handled the event to open the dropdown component.menu.makeSelection(); } }, 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) { evt.preventDefault(); evt.stopPropagation(); const firstOption = component.menu.menuService.menuOptions.find((option) => !option.disabled); if (firstOption) { component.menu.updateActiveOption(firstOption); } }, End(component, evt) { evt.preventDefault(); evt.stopPropagation(); const lastOption = [...component.menu.menuService.menuOptions].reverse().find((option) => !option.disabled); if (lastOption) { component.menu.updateActiveOption(lastOption); } }, default(component, evt) { component.updateActiveOptionBasedOnKey(evt.key); }, }"
18678
18696
  }
18679
18697
  ],
18680
18698
  "exports": [