@aurodesignsystem-dev/auro-formkit 0.0.0-pr1460.2 → 0.0.0-pr1464.0

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