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

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