@aurodesignsystem-dev/auro-formkit 0.0.0-pr1448.0 → 0.0.0-pr1450.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 (43) hide show
  1. package/components/checkbox/demo/api.min.js +1 -1
  2. package/components/checkbox/demo/index.min.js +1 -1
  3. package/components/checkbox/dist/index.js +1 -1
  4. package/components/checkbox/dist/registered.js +1 -1
  5. package/components/combobox/demo/api.min.js +17 -22
  6. package/components/combobox/demo/index.min.js +17 -22
  7. package/components/combobox/dist/auro-combobox.d.ts +1 -1
  8. package/components/combobox/dist/index.js +14 -18
  9. package/components/combobox/dist/registered.js +14 -18
  10. package/components/counter/demo/api.min.js +2 -2
  11. package/components/counter/demo/index.min.js +2 -2
  12. package/components/counter/dist/index.js +2 -2
  13. package/components/counter/dist/registered.js +2 -2
  14. package/components/datepicker/demo/api.min.js +4 -5
  15. package/components/datepicker/demo/index.min.js +4 -5
  16. package/components/datepicker/dist/index.js +4 -5
  17. package/components/datepicker/dist/registered.js +4 -5
  18. package/components/dropdown/demo/api.min.js +1 -1
  19. package/components/dropdown/demo/index.min.js +1 -1
  20. package/components/dropdown/dist/index.js +1 -1
  21. package/components/dropdown/dist/registered.js +1 -1
  22. package/components/form/demo/api.min.js +29 -36
  23. package/components/form/demo/index.min.js +29 -36
  24. package/components/input/demo/api.min.js +2 -3
  25. package/components/input/demo/index.min.js +2 -3
  26. package/components/input/dist/index.js +2 -3
  27. package/components/input/dist/registered.js +2 -3
  28. package/components/menu/demo/api.md +1 -1
  29. package/components/menu/demo/api.min.js +3 -4
  30. package/components/menu/demo/index.min.js +3 -4
  31. package/components/menu/dist/auro-menu.d.ts +1 -1
  32. package/components/menu/dist/index.js +3 -4
  33. package/components/menu/dist/registered.js +3 -4
  34. package/components/radio/demo/api.min.js +1 -1
  35. package/components/radio/demo/index.min.js +1 -1
  36. package/components/radio/dist/index.js +1 -1
  37. package/components/radio/dist/registered.js +1 -1
  38. package/components/select/demo/api.min.js +5 -6
  39. package/components/select/demo/index.min.js +5 -6
  40. package/components/select/dist/index.js +2 -2
  41. package/components/select/dist/registered.js +2 -2
  42. package/custom-elements.json +1490 -1488
  43. package/package.json +1 -1
@@ -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,636 @@
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"
697
- }
698
- }
699
- ],
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"
755
+ "text": "KeyboardEvent"
756
+ }
757
+ }
758
+ ],
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"
1323
821
  },
1324
822
  {
1325
- "name": "inputmode",
823
+ "kind": "field",
824
+ "name": "inputId",
825
+ "privacy": "private",
1326
826
  "type": {
1327
827
  "text": "string"
1328
828
  },
1329
- "description": "Exposes inputmode attribute for input.",
1330
- "fieldName": "inputmode"
829
+ "description": "The id for input node."
1331
830
  },
1332
831
  {
1333
- "name": "layout",
832
+ "kind": "field",
833
+ "name": "name",
834
+ "privacy": "public",
1334
835
  "type": {
1335
836
  "text": "string"
1336
837
  },
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"
838
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
839
+ "attribute": "name"
1360
840
  },
1361
841
  {
1362
- "name": "noFlip",
842
+ "kind": "field",
843
+ "name": "onDark",
844
+ "privacy": "public",
1363
845
  "type": {
1364
846
  "text": "boolean"
1365
847
  },
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"
848
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
849
+ "attribute": "onDark",
850
+ "reflects": true
1368
851
  },
1369
852
  {
1370
- "name": "shift",
853
+ "kind": "field",
854
+ "name": "touched",
855
+ "privacy": "private",
1371
856
  "type": {
1372
857
  "text": "boolean"
1373
858
  },
1374
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1375
- "fieldName": "shift"
859
+ "description": "Indicates whether the checkbox has been interacted with."
1376
860
  },
1377
861
  {
1378
- "name": "noValidate",
862
+ "kind": "field",
863
+ "name": "value",
864
+ "privacy": "public",
1379
865
  "type": {
1380
- "text": "boolean"
866
+ "text": "string"
1381
867
  },
1382
- "description": "If set, disables auto-validation on blur.",
1383
- "fieldName": "noValidate"
868
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
869
+ "attribute": "value"
1384
870
  },
1385
871
  {
1386
- "name": "offset",
872
+ "kind": "field",
873
+ "name": "tabIndex",
874
+ "privacy": "private",
1387
875
  "type": {
1388
876
  "text": "number"
1389
877
  },
1390
- "description": "Gap between the trigger element and bib.",
1391
- "default": "0",
1392
- "fieldName": "offset"
878
+ "description": "The tabindex attribute for the checkbox.",
879
+ "attribute": "tabindex",
880
+ "reflects": true
1393
881
  },
1394
882
  {
1395
- "name": "onDark",
883
+ "kind": "field",
884
+ "name": "ariaChecked",
885
+ "privacy": "private",
1396
886
  "type": {
1397
- "text": "boolean"
887
+ "text": "string"
1398
888
  },
1399
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1400
- "fieldName": "onDark"
889
+ "description": "The aria-checked attribute for the checkbox.",
890
+ "attribute": "aria-checked",
891
+ "reflects": true
1401
892
  },
1402
893
  {
1403
- "name": "optionSelected",
894
+ "kind": "field",
895
+ "name": "ariaDisabled",
896
+ "privacy": "private",
1404
897
  "type": {
1405
- "text": "HTMLElement"
898
+ "text": "string"
1406
899
  },
1407
- "description": "Specifies the current selected option.",
1408
- "fieldName": "optionSelected"
900
+ "description": "The aria-disabled attribute for the checkbox.",
901
+ "attribute": "aria-disabled",
902
+ "reflects": true
1409
903
  },
1410
904
  {
1411
- "name": "persistInput",
905
+ "kind": "field",
906
+ "name": "role",
907
+ "privacy": "private",
1412
908
  "type": {
1413
- "text": "boolean"
909
+ "text": "string"
1414
910
  },
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
- },
911
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
912
+ "attribute": "role",
913
+ "reflects": true
914
+ }
915
+ ],
916
+ "events": [
1418
917
  {
1419
- "name": "placement",
918
+ "name": "auroCheckbox-input",
1420
919
  "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"
920
+ "text": "CustomEvent"
921
+ }
1426
922
  },
1427
923
  {
1428
- "name": "placeholder",
924
+ "name": "auroCheckbox-focusin",
1429
925
  "type": {
1430
- "text": "string"
1431
- },
1432
- "description": "Define custom placeholder text, only supported by date input formats.",
1433
- "fieldName": "placeholder"
926
+ "text": "CustomEvent"
927
+ }
1434
928
  },
1435
929
  {
1436
- "name": "required",
930
+ "name": "auroCheckbox-focusout",
1437
931
  "type": {
1438
- "text": "boolean"
1439
- },
1440
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1441
- "fieldName": "required"
932
+ "text": "CustomEvent"
933
+ }
1442
934
  },
1443
935
  {
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"
936
+ "description": "(Deprecated) Notifies when checked value is changed.",
937
+ "name": "change"
1450
938
  },
1451
939
  {
1452
- "name": "setCustomValidityCustomError",
940
+ "description": "Notifies when when checked value is changed by user's interface.",
941
+ "name": "input"
942
+ }
943
+ ],
944
+ "attributes": [
945
+ {
946
+ "name": "appearance",
1453
947
  "type": {
1454
- "text": "string"
948
+ "text": "'default' | 'inverse'"
1455
949
  },
1456
- "description": "Custom help text message to display when validity = `customError`.",
1457
- "fieldName": "setCustomValidityCustomError"
950
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
951
+ "default": "'default'",
952
+ "fieldName": "appearance"
1458
953
  },
1459
954
  {
1460
- "name": "setCustomValidityValueMissing",
955
+ "name": "checked",
1461
956
  "type": {
1462
- "text": "string"
957
+ "text": "boolean"
1463
958
  },
1464
- "description": "Custom help text message to display when validity = `valueMissing`.",
1465
- "fieldName": "setCustomValidityValueMissing"
959
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
960
+ "fieldName": "checked"
1466
961
  },
1467
962
  {
1468
- "name": "setCustomValidityValueMissingFilter",
963
+ "name": "disabled",
1469
964
  "type": {
1470
- "text": "string"
965
+ "text": "boolean"
1471
966
  },
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"
967
+ "description": "If set to true, the checkbox will not be clickable.",
968
+ "fieldName": "disabled"
1474
969
  },
1475
970
  {
1476
- "name": "triggerIcon",
971
+ "name": "error",
1477
972
  "type": {
1478
973
  "text": "boolean"
1479
974
  },
1480
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1481
- "fieldName": "triggerIcon"
975
+ "description": "If set to true, the checkbox will be displayed with an error state.",
976
+ "fieldName": "error"
1482
977
  },
1483
978
  {
1484
- "name": "type",
979
+ "name": "id",
1485
980
  "type": {
1486
981
  "text": "string"
1487
982
  },
1488
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1489
- "fieldName": "type"
983
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
984
+ "fieldName": "id"
1490
985
  },
1491
986
  {
1492
- "name": "typedValue",
987
+ "name": "name",
1493
988
  "type": {
1494
989
  "text": "string"
1495
990
  },
1496
- "description": "Specifies the value of the input element within the combobox.",
1497
- "fieldName": "typedValue"
991
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
992
+ "fieldName": "name"
1498
993
  },
1499
994
  {
1500
- "name": "validity",
995
+ "name": "onDark",
1501
996
  "type": {
1502
- "text": "string"
997
+ "text": "boolean"
1503
998
  },
1504
- "description": "Specifies the `validityState` this element is in.",
1505
- "fieldName": "validity"
999
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1000
+ "fieldName": "onDark"
1506
1001
  },
1507
1002
  {
1508
1003
  "name": "value",
1509
1004
  "type": {
1510
1005
  "text": "string"
1511
1006
  },
1512
- "description": "Value selected for the dropdown menu.",
1007
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1513
1008
  "fieldName": "value"
1514
1009
  },
1515
1010
  {
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",
1011
+ "name": "tabindex",
1525
1012
  "type": {
1526
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1013
+ "text": "number"
1527
1014
  },
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"
1015
+ "description": "The tabindex attribute for the checkbox.",
1016
+ "fieldName": "tabIndex"
1531
1017
  },
1532
1018
  {
1533
- "name": "shape",
1019
+ "name": "aria-checked",
1534
1020
  "type": {
1535
1021
  "text": "string"
1536
1022
  },
1537
- "fieldName": "shape",
1538
- "inheritedFrom": {
1539
- "name": "AuroElement",
1540
- "module": "components/layoutElement/src/auroElement.js"
1541
- }
1023
+ "description": "The aria-checked attribute for the checkbox.",
1024
+ "fieldName": "ariaChecked"
1542
1025
  },
1543
1026
  {
1544
- "name": "size",
1027
+ "name": "aria-disabled",
1545
1028
  "type": {
1546
1029
  "text": "string"
1547
1030
  },
1548
- "fieldName": "size",
1549
- "inheritedFrom": {
1550
- "name": "AuroElement",
1551
- "module": "components/layoutElement/src/auroElement.js"
1552
- }
1031
+ "description": "The aria-disabled attribute for the checkbox.",
1032
+ "fieldName": "ariaDisabled"
1553
1033
  },
1554
1034
  {
1555
- "name": "ondark",
1035
+ "name": "role",
1556
1036
  "type": {
1557
- "text": "boolean"
1037
+ "text": "string"
1558
1038
  },
1559
- "fieldName": "onDark",
1560
- "inheritedFrom": {
1561
- "name": "AuroElement",
1562
- "module": "components/layoutElement/src/auroElement.js"
1563
- }
1039
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
1040
+ "fieldName": "role"
1564
1041
  }
1565
1042
  ],
1566
1043
  "superclass": {
1567
- "name": "AuroElement",
1568
- "module": "/components/layoutElement/src/auroElement.js"
1044
+ "name": "LitElement",
1045
+ "package": "lit"
1569
1046
  },
1570
- "tagName": "auro-combobox",
1047
+ "tagName": "auro-checkbox",
1571
1048
  "customElement": true
1572
1049
  }
1573
1050
  ],
1574
1051
  "exports": [
1575
1052
  {
1576
1053
  "kind": "js",
1577
- "name": "AuroCombobox",
1054
+ "name": "AuroCheckbox",
1578
1055
  "declaration": {
1579
- "name": "AuroCombobox",
1580
- "module": "components/combobox/src/auro-combobox.js"
1056
+ "name": "AuroCheckbox",
1057
+ "module": "components/checkbox/src/auro-checkbox.js"
1581
1058
  }
1582
1059
  }
1583
1060
  ]
1584
1061
  },
1585
1062
  {
1586
1063
  "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
- ],
1064
+ "path": "components/checkbox/src/index.js",
1065
+ "declarations": [],
1598
1066
  "exports": [
1599
1067
  {
1600
1068
  "kind": "js",
1601
- "name": "comboboxKeyboardStrategy",
1069
+ "name": "AuroCheckbox",
1602
1070
  "declaration": {
1603
- "name": "comboboxKeyboardStrategy",
1604
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1071
+ "name": "AuroCheckbox",
1072
+ "module": "components/checkbox/src/index.js"
1605
1073
  }
1606
- }
1607
- ]
1608
- },
1609
- {
1610
- "kind": "javascript-module",
1611
- "path": "components/combobox/src/index.js",
1612
- "declarations": [],
1613
- "exports": [
1074
+ },
1614
1075
  {
1615
1076
  "kind": "js",
1616
- "name": "AuroCombobox",
1077
+ "name": "AuroCheckboxGroup",
1617
1078
  "declaration": {
1618
- "name": "AuroCombobox",
1619
- "module": "components/combobox/src/index.js"
1079
+ "name": "AuroCheckboxGroup",
1080
+ "module": "components/checkbox/src/index.js"
1620
1081
  }
1621
1082
  }
1622
1083
  ]
1623
1084
  },
1624
1085
  {
1625
1086
  "kind": "javascript-module",
1626
- "path": "components/combobox/src/registered.js",
1087
+ "path": "components/checkbox/src/registered.js",
1627
1088
  "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
- ]
1089
+ "exports": []
1638
1090
  },
1639
1091
  {
1640
1092
  "kind": "javascript-module",
1641
- "path": "components/checkbox/src/auro-checkbox-group.js",
1093
+ "path": "components/combobox/src/auro-combobox.js",
1642
1094
  "declarations": [
1643
1095
  {
1644
1096
  "kind": "class",
1645
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1646
- "name": "AuroCheckboxGroup",
1097
+ "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.",
1098
+ "name": "AuroCombobox",
1647
1099
  "slots": [
1648
1100
  {
1649
- "description": "Allows for the legend to be overridden.",
1650
- "name": "legend"
1101
+ "description": "Default slot for the menu content.",
1102
+ "name": ""
1103
+ },
1104
+ {
1105
+ "type": {
1106
+ "text": "HTMLSlotElement"
1107
+ },
1108
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1109
+ "name": "optionalLabel"
1110
+ },
1111
+ {
1112
+ "description": "Sets aria-label on clear button",
1113
+ "name": "ariaLabel.input.clear"
1114
+ },
1115
+ {
1116
+ "description": "Sets aria-label on close button in fullscreen bib",
1117
+ "name": "ariaLabel.bib.close"
1118
+ },
1119
+ {
1120
+ "description": "Defines the headline to display above menu-options",
1121
+ "name": "bib.fullscreen.headline"
1122
+ },
1123
+ {
1124
+ "description": "Defines the content of the label.",
1125
+ "name": "label"
1126
+ },
1127
+ {
1128
+ "description": "Defines the content of the helpText.",
1129
+ "name": "helpText"
1130
+ },
1131
+ {
1132
+ "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
1133
+ "name": "displayValue"
1134
+ }
1135
+ ],
1136
+ "members": [
1137
+ {
1138
+ "kind": "method",
1139
+ "name": "_initializeDefaults",
1140
+ "privacy": "private",
1141
+ "return": {
1142
+ "type": {
1143
+ "text": "void"
1144
+ }
1145
+ }
1146
+ },
1147
+ {
1148
+ "kind": "field",
1149
+ "name": "inputValue",
1150
+ "description": "Returns the current value of the input element within the combobox.",
1151
+ "return": {
1152
+ "type": {
1153
+ "text": "string|undefined"
1154
+ }
1155
+ },
1156
+ "readonly": true
1157
+ },
1158
+ {
1159
+ "kind": "method",
1160
+ "name": "isValid",
1161
+ "description": "Checks if the element is valid.",
1162
+ "return": {
1163
+ "type": {
1164
+ "text": "boolean"
1165
+ }
1166
+ }
1167
+ },
1168
+ {
1169
+ "kind": "method",
1170
+ "name": "register",
1171
+ "static": true,
1172
+ "parameters": [
1173
+ {
1174
+ "name": "name",
1175
+ "default": "'auro-combobox'",
1176
+ "description": "The name of the element that you want to register.",
1177
+ "optional": true,
1178
+ "type": {
1179
+ "text": "string"
1180
+ }
1181
+ }
1182
+ ],
1183
+ "description": "This will register this element with the browser."
1184
+ },
1185
+ {
1186
+ "kind": "method",
1187
+ "name": "activateFirstEnabledAvailableOption",
1188
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
1189
+ "privacy": "private",
1190
+ "return": {
1191
+ "type": {
1192
+ "text": "void"
1193
+ }
1194
+ }
1195
+ },
1196
+ {
1197
+ "kind": "method",
1198
+ "name": "activateLastEnabledAvailableOption",
1199
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
1200
+ "privacy": "private",
1201
+ "return": {
1202
+ "type": {
1203
+ "text": "void"
1204
+ }
1205
+ }
1206
+ },
1207
+ {
1208
+ "kind": "method",
1209
+ "name": "updateFilter",
1210
+ "description": "Updates the filter for the available options based on the input value.",
1211
+ "privacy": "private"
1212
+ },
1213
+ {
1214
+ "kind": "method",
1215
+ "name": "syncValuesAndStates",
1216
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1217
+ "privacy": "private",
1218
+ "return": {
1219
+ "type": {
1220
+ "text": "void"
1221
+ }
1222
+ }
1223
+ },
1224
+ {
1225
+ "kind": "method",
1226
+ "name": "updateTriggerTextDisplay",
1227
+ "parameters": [
1228
+ {
1229
+ "name": "label",
1230
+ "description": "The label of the selected option.",
1231
+ "type": {
1232
+ "text": "string"
1233
+ }
1234
+ }
1235
+ ],
1236
+ "description": "Update displayValue or input.value, it's called when making a selection.",
1237
+ "privacy": "private"
1238
+ },
1239
+ {
1240
+ "kind": "method",
1241
+ "name": "handleMenuOptions",
1242
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1243
+ "privacy": "private",
1244
+ "return": {
1245
+ "type": {
1246
+ "text": "void"
1247
+ }
1248
+ }
1651
1249
  },
1652
1250
  {
1653
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1654
- "name": "optionalLabel"
1251
+ "kind": "method",
1252
+ "name": "generateOptionsArray",
1253
+ "description": "Determines the element error state based on the `required` attribute and input value.",
1254
+ "privacy": "private",
1255
+ "return": {
1256
+ "type": {
1257
+ "text": "void"
1258
+ }
1259
+ }
1655
1260
  },
1656
1261
  {
1657
- "description": "Allows for the helper text to be overridden.",
1658
- "name": "helpText"
1262
+ "kind": "method",
1263
+ "name": "hideBib",
1264
+ "description": "Hides the dropdown bib if its open.",
1265
+ "return": {
1266
+ "type": {
1267
+ "text": "void"
1268
+ }
1269
+ }
1659
1270
  },
1660
1271
  {
1661
- "description": "The default slot for the checkbox items.",
1662
- "name": "default"
1663
- }
1664
- ],
1665
- "members": [
1272
+ "kind": "method",
1273
+ "name": "showBib",
1274
+ "description": "Shows the dropdown bib if there are options to show.",
1275
+ "return": {
1276
+ "type": {
1277
+ "text": "void"
1278
+ }
1279
+ }
1280
+ },
1666
1281
  {
1667
1282
  "kind": "method",
1668
- "name": "_initializeDefaults"
1283
+ "name": "configureDropdown",
1284
+ "description": "Binds all behavior needed to the dropdown after rendering.",
1285
+ "privacy": "private",
1286
+ "return": {
1287
+ "type": {
1288
+ "text": "void"
1289
+ }
1290
+ }
1669
1291
  },
1670
1292
  {
1671
1293
  "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
- }
1294
+ "name": "setClearBtnFocus",
1295
+ "privacy": "private"
1296
+ },
1297
+ {
1298
+ "kind": "method",
1299
+ "name": "setTriggerInputFocus",
1300
+ "privacy": "private"
1301
+ },
1302
+ {
1303
+ "kind": "method",
1304
+ "name": "setInputFocus",
1305
+ "privacy": "private"
1306
+ },
1307
+ {
1308
+ "kind": "method",
1309
+ "name": "updateBibDialogRole",
1310
+ "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.",
1311
+ "privacy": "private"
1312
+ },
1313
+ {
1314
+ "kind": "method",
1315
+ "name": "updateMenuShapeSize",
1316
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1317
+ "privacy": "private"
1318
+ },
1319
+ {
1320
+ "kind": "method",
1321
+ "name": "_getAnnouncementRoot",
1322
+ "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.",
1323
+ "privacy": "private",
1324
+ "return": {
1325
+ "type": {
1326
+ "text": "ShadowRoot"
1683
1327
  }
1684
- ],
1685
- "description": "This will register this element with the browser."
1328
+ }
1686
1329
  },
1687
1330
  {
1688
1331
  "kind": "method",
1689
- "name": "handleValueUpdate",
1332
+ "name": "configureMenu",
1333
+ "description": "Binds all behavior needed to the menu after rendering.",
1334
+ "privacy": "private",
1335
+ "return": {
1336
+ "type": {
1337
+ "text": "void"
1338
+ }
1339
+ }
1340
+ },
1341
+ {
1342
+ "kind": "method",
1343
+ "name": "configureInput",
1344
+ "description": "Binds all behavior needed to the input after rendering.",
1345
+ "privacy": "private",
1346
+ "return": {
1347
+ "type": {
1348
+ "text": "void"
1349
+ }
1350
+ }
1351
+ },
1352
+ {
1353
+ "kind": "method",
1354
+ "name": "handleMenuLoadingChange",
1690
1355
  "parameters": [
1691
1356
  {
1692
- "name": "value",
1693
- "description": "The value of the checkbox.",
1357
+ "name": "event",
1358
+ "description": "The event object containing details about the loading state change.",
1694
1359
  "type": {
1695
- "text": "String"
1360
+ "text": "CustomEvent"
1696
1361
  }
1697
1362
  },
1698
1363
  {
1699
- "name": "selected",
1700
- "description": "The checked state of the checkbox.",
1364
+ "description": "Indicates whether the menu is currently loading.",
1365
+ "name": "event.detail.loading",
1701
1366
  "type": {
1702
- "text": "Boolean"
1367
+ "text": "boolean"
1368
+ }
1369
+ },
1370
+ {
1371
+ "description": "Indicates if there are loading placeholders present.",
1372
+ "name": "event.detail.hasLoadingPlaceholder",
1373
+ "type": {
1374
+ "text": "boolean"
1703
1375
  }
1704
1376
  }
1705
1377
  ],
1706
- "description": "Helper method to handle checkbox value changing.",
1378
+ "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
1379
  "privacy": "private",
1708
1380
  "return": {
1709
1381
  "type": {
@@ -1713,8 +1385,17 @@
1713
1385
  },
1714
1386
  {
1715
1387
  "kind": "method",
1716
- "name": "handlePreselectedItems",
1717
- "description": "Helper method that handles the state of preselected checkboxes.",
1388
+ "name": "handleInputValueChange",
1389
+ "parameters": [
1390
+ {
1391
+ "name": "event",
1392
+ "description": "The input event triggered by the input element.",
1393
+ "type": {
1394
+ "text": "Event"
1395
+ }
1396
+ }
1397
+ ],
1398
+ "description": "Handle changes to the input value and trigger changes that should result.",
1718
1399
  "privacy": "private",
1719
1400
  "return": {
1720
1401
  "type": {
@@ -1724,8 +1405,8 @@
1724
1405
  },
1725
1406
  {
1726
1407
  "kind": "method",
1727
- "name": "handleItems",
1728
- "description": "Helper method that handles the state of checkboxes.",
1408
+ "name": "configureCombobox",
1409
+ "description": "Binds all behavior needed to the combobox after rendering.",
1729
1410
  "privacy": "private",
1730
1411
  "return": {
1731
1412
  "type": {
@@ -1733,6 +1414,35 @@
1733
1414
  }
1734
1415
  }
1735
1416
  },
1417
+ {
1418
+ "kind": "method",
1419
+ "name": "focus",
1420
+ "description": "Focuses the combobox trigger input.",
1421
+ "return": {
1422
+ "type": {
1423
+ "text": "void"
1424
+ }
1425
+ }
1426
+ },
1427
+ {
1428
+ "kind": "method",
1429
+ "name": "setMenuValue",
1430
+ "parameters": [
1431
+ {
1432
+ "name": "value",
1433
+ "description": "The value to set on the menu.",
1434
+ "type": {
1435
+ "text": "string"
1436
+ }
1437
+ }
1438
+ ],
1439
+ "description": "Sets the menu value if menu is available.",
1440
+ "return": {
1441
+ "type": {
1442
+ "text": "void"
1443
+ }
1444
+ }
1445
+ },
1736
1446
  {
1737
1447
  "kind": "method",
1738
1448
  "name": "reset",
@@ -1745,32 +1455,165 @@
1745
1455
  },
1746
1456
  {
1747
1457
  "kind": "method",
1748
- "name": "validate",
1458
+ "name": "clear",
1459
+ "description": "Clears the current value of the combobox.",
1460
+ "return": {
1461
+ "type": {
1462
+ "text": "void"
1463
+ }
1464
+ }
1465
+ },
1466
+ {
1467
+ "kind": "method",
1468
+ "name": "validate",
1469
+ "parameters": [
1470
+ {
1471
+ "name": "force",
1472
+ "default": "false",
1473
+ "description": "Whether to force validation.",
1474
+ "optional": true,
1475
+ "type": {
1476
+ "text": "boolean"
1477
+ }
1478
+ }
1479
+ ],
1480
+ "description": "Validates value."
1481
+ },
1482
+ {
1483
+ "kind": "method",
1484
+ "name": "transportAssignedNodes",
1485
+ "parameters": [
1486
+ {
1487
+ "name": "slot",
1488
+ "description": "The slot element containing the nodes to apply.",
1489
+ "type": {
1490
+ "text": "HTMLSlotElement"
1491
+ }
1492
+ },
1493
+ {
1494
+ "name": "target",
1495
+ "description": "The target element to apply the nodes to.",
1496
+ "type": {
1497
+ "text": "HTMLElement"
1498
+ }
1499
+ },
1500
+ {
1501
+ "name": "newSlotName",
1502
+ "description": "The new slot name for the applied nodes.",
1503
+ "type": {
1504
+ "text": "string"
1505
+ }
1506
+ }
1507
+ ],
1508
+ "description": "Applies slotted nodes to a target element with a new slot name.",
1509
+ "privacy": "private",
1510
+ "return": {
1511
+ "type": {
1512
+ "text": "void"
1513
+ }
1514
+ }
1515
+ },
1516
+ {
1517
+ "kind": "method",
1518
+ "name": "updateActiveOption",
1749
1519
  "parameters": [
1750
1520
  {
1751
- "name": "force",
1752
- "default": "false",
1753
- "description": "Whether to force validation.",
1754
- "optional": true,
1521
+ "name": "index",
1522
+ "description": "Index of the option to make active.",
1755
1523
  "type": {
1756
- "text": "boolean"
1524
+ "text": "number"
1757
1525
  }
1758
1526
  }
1759
1527
  ],
1760
- "description": "Validates value."
1528
+ "description": "Updates the active option in the menu."
1529
+ },
1530
+ {
1531
+ "kind": "method",
1532
+ "name": "handleSlotChange",
1533
+ "parameters": [
1534
+ {
1535
+ "name": "event",
1536
+ "description": "`slotchange` event.",
1537
+ "type": {
1538
+ "text": "Event"
1539
+ }
1540
+ }
1541
+ ],
1542
+ "description": "Watch for slot changes and recalculate the menuoptions.",
1543
+ "privacy": "private",
1544
+ "return": {
1545
+ "type": {
1546
+ "text": "void"
1547
+ }
1548
+ }
1761
1549
  },
1762
1550
  {
1763
1551
  "kind": "field",
1764
1552
  "name": "appearance",
1765
1553
  "privacy": "public",
1766
1554
  "type": {
1767
- "text": "'default' | 'inverse'"
1555
+ "text": "string"
1768
1556
  },
1769
1557
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
1770
1558
  "default": "'default'",
1771
1559
  "attribute": "appearance",
1772
1560
  "reflects": true
1773
1561
  },
1562
+ {
1563
+ "kind": "field",
1564
+ "name": "autocomplete",
1565
+ "privacy": "public",
1566
+ "type": {
1567
+ "text": "string"
1568
+ },
1569
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1570
+ "attribute": "autocomplete",
1571
+ "reflects": true
1572
+ },
1573
+ {
1574
+ "kind": "field",
1575
+ "name": "autoPlacement",
1576
+ "privacy": "public",
1577
+ "type": {
1578
+ "text": "boolean"
1579
+ },
1580
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1581
+ "attribute": "autoPlacement",
1582
+ "reflects": true
1583
+ },
1584
+ {
1585
+ "kind": "field",
1586
+ "name": "availableOptions",
1587
+ "privacy": "private",
1588
+ "type": {
1589
+ "text": "array"
1590
+ },
1591
+ "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).",
1592
+ "attribute": "availableOptions"
1593
+ },
1594
+ {
1595
+ "kind": "field",
1596
+ "name": "behavior",
1597
+ "privacy": "public",
1598
+ "type": {
1599
+ "text": "'filter' | 'suggestion'"
1600
+ },
1601
+ "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.",
1602
+ "default": "'suggestion'",
1603
+ "attribute": "behavior",
1604
+ "reflects": true
1605
+ },
1606
+ {
1607
+ "kind": "field",
1608
+ "name": "checkmark",
1609
+ "privacy": "public",
1610
+ "type": {
1611
+ "text": "boolean"
1612
+ },
1613
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1614
+ "attribute": "checkmark",
1615
+ "reflects": true
1616
+ },
1774
1617
  {
1775
1618
  "kind": "field",
1776
1619
  "name": "disabled",
@@ -1778,10 +1621,39 @@
1778
1621
  "type": {
1779
1622
  "text": "boolean"
1780
1623
  },
1781
- "description": "If set, disables the checkbox group.",
1624
+ "description": "If set, disables the combobox.",
1782
1625
  "attribute": "disabled",
1783
1626
  "reflects": true
1784
1627
  },
1628
+ {
1629
+ "kind": "field",
1630
+ "name": "dropdownId",
1631
+ "privacy": "private",
1632
+ "type": {
1633
+ "text": "string"
1634
+ },
1635
+ "description": "ID for the dropdown."
1636
+ },
1637
+ {
1638
+ "kind": "field",
1639
+ "name": "dropdownOpen",
1640
+ "privacy": "private",
1641
+ "type": {
1642
+ "text": "boolean"
1643
+ },
1644
+ "description": "Whether or not the dropdown is open."
1645
+ },
1646
+ {
1647
+ "kind": "field",
1648
+ "name": "dvInputOnly",
1649
+ "privacy": "public",
1650
+ "type": {
1651
+ "text": "boolean"
1652
+ },
1653
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1654
+ "attribute": "dvInputOnly",
1655
+ "reflects": true
1656
+ },
1785
1657
  {
1786
1658
  "kind": "field",
1787
1659
  "name": "error",
@@ -1795,688 +1667,816 @@
1795
1667
  },
1796
1668
  {
1797
1669
  "kind": "field",
1798
- "name": "horizontal",
1670
+ "name": "format",
1799
1671
  "privacy": "public",
1800
1672
  "type": {
1801
- "text": "boolean"
1673
+ "text": "string"
1802
1674
  },
1803
- "description": "If set, checkboxes will be aligned horizontally.",
1804
- "attribute": "horizontal",
1675
+ "description": "Specifies the input mask format.",
1676
+ "attribute": "format",
1805
1677
  "reflects": true
1806
1678
  },
1807
1679
  {
1808
1680
  "kind": "field",
1809
- "name": "noValidate",
1681
+ "name": "inputmode",
1810
1682
  "privacy": "public",
1811
1683
  "type": {
1812
- "text": "boolean"
1684
+ "text": "string"
1813
1685
  },
1814
- "description": "If set, disables auto-validation on blur.",
1815
- "attribute": "noValidate",
1686
+ "description": "Exposes inputmode attribute for input.",
1687
+ "attribute": "inputmode",
1816
1688
  "reflects": true
1817
1689
  },
1818
1690
  {
1819
1691
  "kind": "field",
1820
- "name": "onDark",
1692
+ "name": "layout",
1821
1693
  "privacy": "public",
1694
+ "type": {
1695
+ "text": "string"
1696
+ },
1697
+ "description": "Sets the layout of the combobox.",
1698
+ "default": "'classic'",
1699
+ "attribute": "layout",
1700
+ "reflects": true,
1701
+ "inheritedFrom": {
1702
+ "name": "AuroElement",
1703
+ "module": "components/layoutElement/src/auroElement.js"
1704
+ }
1705
+ },
1706
+ {
1707
+ "kind": "field",
1708
+ "name": "matchWidth",
1709
+ "privacy": "private",
1822
1710
  "type": {
1823
1711
  "text": "boolean"
1824
1712
  },
1825
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1826
- "attribute": "onDark",
1713
+ "description": "If declared, the popover and trigger will be set to the same width.",
1714
+ "attribute": "matchWidth",
1827
1715
  "reflects": true
1828
1716
  },
1829
1717
  {
1830
1718
  "kind": "field",
1831
- "name": "required",
1719
+ "name": "noFilter",
1832
1720
  "privacy": "public",
1833
1721
  "type": {
1834
1722
  "text": "boolean"
1835
1723
  },
1836
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1837
- "attribute": "required",
1724
+ "description": "If set, combobox will not filter menuoptions based on input.",
1725
+ "attribute": "noFilter",
1838
1726
  "reflects": true
1839
1727
  },
1840
1728
  {
1841
1729
  "kind": "field",
1842
- "name": "setCustomValidity",
1730
+ "name": "noFlip",
1843
1731
  "privacy": "public",
1844
1732
  "type": {
1845
- "text": "string"
1733
+ "text": "boolean"
1846
1734
  },
1847
- "description": "Sets a custom help text message to display for all validityStates.",
1848
- "attribute": "setCustomValidity"
1735
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1736
+ "attribute": "noFlip",
1737
+ "reflects": true
1849
1738
  },
1850
1739
  {
1851
1740
  "kind": "field",
1852
- "name": "setCustomValidityCustomError",
1741
+ "name": "shift",
1853
1742
  "privacy": "public",
1854
1743
  "type": {
1855
- "text": "string"
1744
+ "text": "boolean"
1856
1745
  },
1857
- "description": "Custom help text message to display when validity = `customError`.",
1858
- "attribute": "setCustomValidityCustomError"
1746
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1747
+ "attribute": "shift",
1748
+ "reflects": true
1859
1749
  },
1860
1750
  {
1861
1751
  "kind": "field",
1862
- "name": "setCustomValidityValueMissing",
1752
+ "name": "noValidate",
1863
1753
  "privacy": "public",
1864
1754
  "type": {
1865
- "text": "string"
1755
+ "text": "boolean"
1866
1756
  },
1867
- "description": "Custom help text message to display when validity = `valueMissing`.",
1868
- "attribute": "setCustomValidityValueMissing"
1757
+ "description": "If set, disables auto-validation on blur.",
1758
+ "attribute": "noValidate",
1759
+ "reflects": true
1869
1760
  },
1870
1761
  {
1871
1762
  "kind": "field",
1872
- "name": "validity",
1763
+ "name": "offset",
1873
1764
  "privacy": "public",
1874
1765
  "type": {
1875
- "text": "string"
1766
+ "text": "number"
1876
1767
  },
1877
- "description": "Specifies the `validityState` this element is in.",
1878
- "attribute": "validity",
1768
+ "description": "Gap between the trigger element and bib.",
1769
+ "default": "0",
1770
+ "attribute": "offset",
1879
1771
  "reflects": true
1880
- }
1881
- ],
1882
- "events": [
1772
+ },
1883
1773
  {
1884
- "name": "input",
1774
+ "kind": "field",
1775
+ "name": "onDark",
1776
+ "privacy": "public",
1885
1777
  "type": {
1886
- "text": "CustomEvent"
1778
+ "text": "boolean"
1779
+ },
1780
+ "attribute": "onDark",
1781
+ "reflects": true,
1782
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1783
+ "inheritedFrom": {
1784
+ "name": "AuroElement",
1785
+ "module": "components/layoutElement/src/auroElement.js"
1887
1786
  }
1888
1787
  },
1889
1788
  {
1890
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1891
- "name": "auroFormElement-validated"
1892
- }
1893
- ],
1894
- "attributes": [
1789
+ "kind": "field",
1790
+ "name": "optionSelected",
1791
+ "privacy": "public",
1792
+ "type": {
1793
+ "text": "HTMLElement"
1794
+ },
1795
+ "description": "Specifies the current selected option.",
1796
+ "attribute": "optionSelected"
1797
+ },
1895
1798
  {
1896
- "name": "appearance",
1799
+ "kind": "field",
1800
+ "name": "persistInput",
1801
+ "privacy": "public",
1802
+ "type": {
1803
+ "text": "boolean"
1804
+ },
1805
+ "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.",
1806
+ "attribute": "persistInput",
1807
+ "reflects": true
1808
+ },
1809
+ {
1810
+ "kind": "field",
1811
+ "name": "placement",
1812
+ "privacy": "public",
1813
+ "type": {
1814
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1815
+ },
1816
+ "description": "Position where the bib should appear relative to the trigger.",
1817
+ "default": "'bottom-start'",
1818
+ "attribute": "placement",
1819
+ "reflects": true
1820
+ },
1821
+ {
1822
+ "kind": "field",
1823
+ "name": "placeholder",
1824
+ "privacy": "public",
1897
1825
  "type": {
1898
- "text": "'default' | 'inverse'"
1826
+ "text": "string"
1899
1827
  },
1900
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1901
- "default": "'default'",
1902
- "fieldName": "appearance"
1828
+ "description": "Define custom placeholder text, only supported by date input formats.",
1829
+ "attribute": "placeholder",
1830
+ "reflects": true
1903
1831
  },
1904
1832
  {
1905
- "name": "disabled",
1833
+ "kind": "field",
1834
+ "name": "required",
1835
+ "privacy": "public",
1906
1836
  "type": {
1907
1837
  "text": "boolean"
1908
1838
  },
1909
- "description": "If set, disables the checkbox group.",
1910
- "fieldName": "disabled"
1839
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1840
+ "attribute": "required",
1841
+ "reflects": true
1911
1842
  },
1912
1843
  {
1913
- "name": "error",
1844
+ "kind": "field",
1845
+ "name": "setCustomValidity",
1846
+ "privacy": "public",
1914
1847
  "type": {
1915
1848
  "text": "string"
1916
1849
  },
1917
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1918
- "fieldName": "error"
1850
+ "description": "Sets a custom help text message to display for all validityStates.",
1851
+ "attribute": "setCustomValidity"
1919
1852
  },
1920
1853
  {
1921
- "name": "horizontal",
1854
+ "kind": "field",
1855
+ "name": "setCustomValidityCustomError",
1856
+ "privacy": "public",
1922
1857
  "type": {
1923
- "text": "boolean"
1858
+ "text": "string"
1924
1859
  },
1925
- "description": "If set, checkboxes will be aligned horizontally.",
1926
- "fieldName": "horizontal"
1860
+ "description": "Custom help text message to display when validity = `customError`.",
1861
+ "attribute": "setCustomValidityCustomError"
1927
1862
  },
1928
1863
  {
1929
- "name": "noValidate",
1864
+ "kind": "field",
1865
+ "name": "setCustomValidityValueMissing",
1866
+ "privacy": "public",
1930
1867
  "type": {
1931
- "text": "boolean"
1868
+ "text": "string"
1932
1869
  },
1933
- "description": "If set, disables auto-validation on blur.",
1934
- "fieldName": "noValidate"
1870
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1871
+ "attribute": "setCustomValidityValueMissing"
1935
1872
  },
1936
1873
  {
1937
- "name": "onDark",
1874
+ "kind": "field",
1875
+ "name": "setCustomValidityValueMissingFilter",
1876
+ "privacy": "public",
1938
1877
  "type": {
1939
- "text": "boolean"
1878
+ "text": "string"
1940
1879
  },
1941
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1942
- "fieldName": "onDark"
1880
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1881
+ "attribute": "setCustomValidityValueMissingFilter"
1943
1882
  },
1944
1883
  {
1945
- "name": "required",
1884
+ "kind": "field",
1885
+ "name": "touched",
1886
+ "privacy": "private",
1946
1887
  "type": {
1947
1888
  "text": "boolean"
1948
1889
  },
1949
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1950
- "fieldName": "required"
1890
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1951
1891
  },
1952
1892
  {
1953
- "name": "setCustomValidity",
1893
+ "kind": "field",
1894
+ "name": "triggerIcon",
1895
+ "privacy": "public",
1954
1896
  "type": {
1955
- "text": "string"
1897
+ "text": "boolean"
1956
1898
  },
1957
- "description": "Sets a custom help text message to display for all validityStates.",
1958
- "fieldName": "setCustomValidity"
1899
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1900
+ "attribute": "triggerIcon",
1901
+ "reflects": true
1959
1902
  },
1960
1903
  {
1961
- "name": "setCustomValidityCustomError",
1904
+ "kind": "field",
1905
+ "name": "type",
1906
+ "privacy": "public",
1962
1907
  "type": {
1963
1908
  "text": "string"
1964
1909
  },
1965
- "description": "Custom help text message to display when validity = `customError`.",
1966
- "fieldName": "setCustomValidityCustomError"
1910
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1911
+ "attribute": "type",
1912
+ "reflects": true
1967
1913
  },
1968
1914
  {
1969
- "name": "setCustomValidityValueMissing",
1915
+ "kind": "field",
1916
+ "name": "typedValue",
1917
+ "privacy": "public",
1970
1918
  "type": {
1971
1919
  "text": "string"
1972
1920
  },
1973
- "description": "Custom help text message to display when validity = `valueMissing`.",
1974
- "fieldName": "setCustomValidityValueMissing"
1921
+ "description": "Specifies the value of the input element within the combobox.",
1922
+ "attribute": "typedValue",
1923
+ "reflects": true
1975
1924
  },
1976
1925
  {
1926
+ "kind": "field",
1977
1927
  "name": "validity",
1928
+ "privacy": "public",
1978
1929
  "type": {
1979
1930
  "text": "string"
1980
1931
  },
1981
1932
  "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"
1933
+ "attribute": "validity",
1934
+ "reflects": true
2016
1935
  },
2017
1936
  {
2018
- "description": "apply css to a specific checkbox's input.",
2019
- "name": "checkbox-input"
1937
+ "kind": "field",
1938
+ "name": "value",
1939
+ "privacy": "public",
1940
+ "type": {
1941
+ "text": "string"
1942
+ },
1943
+ "description": "Value selected for the dropdown menu.",
1944
+ "attribute": "value"
2020
1945
  },
2021
1946
  {
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"
1947
+ "kind": "field",
1948
+ "name": "largeFullscreenHeadline",
1949
+ "privacy": "public",
1950
+ "type": {
1951
+ "text": "boolean"
1952
+ },
1953
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1954
+ "attribute": "largeFullscreenHeadline",
1955
+ "reflects": true
2036
1956
  },
2037
1957
  {
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."
1958
+ "kind": "field",
1959
+ "name": "fullscreenBreakpoint",
1960
+ "privacy": "public",
1961
+ "type": {
1962
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1963
+ },
1964
+ "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.",
1965
+ "default": "'sm'",
1966
+ "attribute": "fullscreenBreakpoint",
1967
+ "reflects": true
2053
1968
  },
2054
1969
  {
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.",
1970
+ "kind": "field",
1971
+ "name": "optionActive",
2067
1972
  "privacy": "private",
2068
- "return": {
2069
- "type": {
2070
- "text": "void"
2071
- }
2072
- }
1973
+ "type": {
1974
+ "text": "object"
1975
+ },
1976
+ "description": "Specifies the currently active option."
2073
1977
  },
2074
1978
  {
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.",
1979
+ "kind": "field",
1980
+ "name": "triggerExpandedState",
2087
1981
  "privacy": "private",
2088
- "return": {
2089
- "type": {
2090
- "text": "void"
2091
- }
2092
- }
1982
+ "type": {
1983
+ "text": "boolean"
1984
+ },
1985
+ "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
2093
1986
  },
2094
1987
  {
2095
- "kind": "method",
2096
- "name": "handleFocusin",
2097
- "description": "Function to support",
1988
+ "kind": "field",
1989
+ "name": "componentHasFocus",
1990
+ "description": "Returns true if the element has focus.",
2098
1991
  "privacy": "private",
2099
1992
  "return": {
2100
1993
  "type": {
2101
- "text": "void"
1994
+ "text": "boolean"
2102
1995
  }
1996
+ },
1997
+ "readonly": true,
1998
+ "inheritedFrom": {
1999
+ "name": "AuroElement",
2000
+ "module": "components/layoutElement/src/auroElement.js"
2103
2001
  }
2104
2002
  },
2105
2003
  {
2106
2004
  "kind": "method",
2107
- "name": "generateIconHtml",
2108
- "description": "Function to generate checkmark svg.",
2109
- "privacy": "private",
2110
- "return": {
2111
- "type": {
2112
- "text": "HTMLElement"
2113
- }
2005
+ "name": "resetShapeClasses",
2006
+ "inheritedFrom": {
2007
+ "name": "AuroElement",
2008
+ "module": "components/layoutElement/src/auroElement.js"
2114
2009
  }
2115
2010
  },
2116
2011
  {
2117
2012
  "kind": "method",
2118
- "name": "reset",
2119
- "description": "Resets component to initial state.",
2120
- "return": {
2121
- "type": {
2122
- "text": "void"
2123
- }
2013
+ "name": "resetLayoutClasses",
2014
+ "inheritedFrom": {
2015
+ "name": "AuroElement",
2016
+ "module": "components/layoutElement/src/auroElement.js"
2124
2017
  }
2125
2018
  },
2126
2019
  {
2127
2020
  "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
- }
2021
+ "name": "updateComponentArchitecture",
2022
+ "inheritedFrom": {
2023
+ "name": "AuroElement",
2024
+ "module": "components/layoutElement/src/auroElement.js"
2135
2025
  }
2136
2026
  },
2137
2027
  {
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
- }
2028
+ "kind": "field",
2029
+ "name": "shape",
2030
+ "privacy": "public",
2031
+ "type": {
2032
+ "text": "string"
2033
+ },
2034
+ "attribute": "shape",
2035
+ "reflects": true,
2036
+ "inheritedFrom": {
2037
+ "name": "AuroElement",
2038
+ "module": "components/layoutElement/src/auroElement.js"
2155
2039
  }
2156
2040
  },
2157
2041
  {
2158
2042
  "kind": "field",
2159
- "name": "appearance",
2043
+ "name": "size",
2160
2044
  "privacy": "public",
2161
2045
  "type": {
2162
- "text": "'default' | 'inverse'"
2046
+ "text": "string"
2047
+ },
2048
+ "attribute": "size",
2049
+ "reflects": true,
2050
+ "inheritedFrom": {
2051
+ "name": "AuroElement",
2052
+ "module": "components/layoutElement/src/auroElement.js"
2053
+ }
2054
+ }
2055
+ ],
2056
+ "events": [
2057
+ {
2058
+ "name": "inputValue",
2059
+ "type": {
2060
+ "text": "CustomEvent"
2061
+ },
2062
+ "description": "Notifies that the components internal HTML5 input value has changed."
2063
+ },
2064
+ {
2065
+ "name": "input",
2066
+ "type": {
2067
+ "text": "CustomEvent"
2068
+ },
2069
+ "description": "Notifies that the component has a new value set."
2070
+ },
2071
+ {
2072
+ "name": "auroCombobox-valueSet",
2073
+ "type": {
2074
+ "text": "CustomEvent"
2075
+ },
2076
+ "description": "(Deprecated) Notifies that the component has a new value set."
2077
+ },
2078
+ {
2079
+ "description": "Notifies that the component value(s) have been validated.",
2080
+ "name": "auroFormElement-validated"
2081
+ }
2082
+ ],
2083
+ "attributes": [
2084
+ {
2085
+ "name": "appearance",
2086
+ "type": {
2087
+ "text": "string"
2163
2088
  },
2164
2089
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
2165
2090
  "default": "'default'",
2166
- "attribute": "appearance",
2167
- "reflects": true
2091
+ "fieldName": "appearance"
2168
2092
  },
2169
2093
  {
2170
- "kind": "field",
2171
- "name": "checked",
2172
- "privacy": "public",
2094
+ "name": "autocomplete",
2095
+ "type": {
2096
+ "text": "string"
2097
+ },
2098
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2099
+ "fieldName": "autocomplete"
2100
+ },
2101
+ {
2102
+ "name": "autoPlacement",
2173
2103
  "type": {
2174
2104
  "text": "boolean"
2175
2105
  },
2176
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2177
- "attribute": "checked",
2178
- "reflects": true
2106
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
2107
+ "fieldName": "autoPlacement"
2108
+ },
2109
+ {
2110
+ "name": "availableOptions",
2111
+ "type": {
2112
+ "text": "array"
2113
+ },
2114
+ "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).",
2115
+ "fieldName": "availableOptions"
2116
+ },
2117
+ {
2118
+ "name": "behavior",
2119
+ "type": {
2120
+ "text": "'filter' | 'suggestion'"
2121
+ },
2122
+ "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.",
2123
+ "default": "'suggestion'",
2124
+ "fieldName": "behavior"
2125
+ },
2126
+ {
2127
+ "name": "checkmark",
2128
+ "type": {
2129
+ "text": "boolean"
2130
+ },
2131
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
2132
+ "fieldName": "checkmark"
2179
2133
  },
2180
2134
  {
2181
- "kind": "field",
2182
2135
  "name": "disabled",
2183
- "privacy": "public",
2184
2136
  "type": {
2185
2137
  "text": "boolean"
2186
2138
  },
2187
- "description": "If set to true, the checkbox will not be clickable.",
2188
- "attribute": "disabled",
2189
- "reflects": true
2139
+ "description": "If set, disables the combobox.",
2140
+ "fieldName": "disabled"
2190
2141
  },
2191
2142
  {
2192
- "kind": "field",
2193
- "name": "error",
2194
- "privacy": "public",
2143
+ "name": "dvInputOnly",
2195
2144
  "type": {
2196
2145
  "text": "boolean"
2197
2146
  },
2198
- "description": "If set to true, the checkbox will be displayed with an error state.",
2199
- "attribute": "error",
2200
- "reflects": true
2147
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2148
+ "fieldName": "dvInputOnly"
2201
2149
  },
2202
2150
  {
2203
- "kind": "field",
2204
- "name": "id",
2205
- "privacy": "public",
2151
+ "name": "error",
2206
2152
  "type": {
2207
2153
  "text": "string"
2208
2154
  },
2209
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2210
- "attribute": "id"
2155
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2156
+ "fieldName": "error"
2211
2157
  },
2212
2158
  {
2213
- "kind": "field",
2214
- "name": "inputId",
2215
- "privacy": "private",
2159
+ "name": "format",
2216
2160
  "type": {
2217
2161
  "text": "string"
2218
2162
  },
2219
- "description": "The id for input node."
2163
+ "description": "Specifies the input mask format.",
2164
+ "fieldName": "format"
2220
2165
  },
2221
2166
  {
2222
- "kind": "field",
2223
- "name": "name",
2224
- "privacy": "public",
2167
+ "name": "inputmode",
2225
2168
  "type": {
2226
2169
  "text": "string"
2227
2170
  },
2228
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2229
- "attribute": "name"
2171
+ "description": "Exposes inputmode attribute for input.",
2172
+ "fieldName": "inputmode"
2230
2173
  },
2231
2174
  {
2232
- "kind": "field",
2233
- "name": "onDark",
2234
- "privacy": "public",
2175
+ "name": "layout",
2176
+ "type": {
2177
+ "text": "string"
2178
+ },
2179
+ "description": "Sets the layout of the combobox.",
2180
+ "default": "'classic'",
2181
+ "fieldName": "layout",
2182
+ "inheritedFrom": {
2183
+ "name": "AuroElement",
2184
+ "module": "components/layoutElement/src/auroElement.js"
2185
+ }
2186
+ },
2187
+ {
2188
+ "name": "matchWidth",
2235
2189
  "type": {
2236
2190
  "text": "boolean"
2237
2191
  },
2238
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2239
- "attribute": "onDark",
2240
- "reflects": true
2192
+ "description": "If declared, the popover and trigger will be set to the same width.",
2193
+ "fieldName": "matchWidth"
2241
2194
  },
2242
2195
  {
2243
- "kind": "field",
2244
- "name": "touched",
2245
- "privacy": "private",
2196
+ "name": "noFilter",
2246
2197
  "type": {
2247
2198
  "text": "boolean"
2248
2199
  },
2249
- "description": "Indicates whether the checkbox has been interacted with."
2200
+ "description": "If set, combobox will not filter menuoptions based on input.",
2201
+ "fieldName": "noFilter"
2250
2202
  },
2251
2203
  {
2252
- "kind": "field",
2253
- "name": "value",
2254
- "privacy": "public",
2204
+ "name": "noFlip",
2255
2205
  "type": {
2256
- "text": "string"
2206
+ "text": "boolean"
2257
2207
  },
2258
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2259
- "attribute": "value"
2208
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2209
+ "fieldName": "noFlip"
2260
2210
  },
2261
2211
  {
2262
- "kind": "field",
2263
- "name": "tabIndex",
2264
- "privacy": "private",
2212
+ "name": "shift",
2213
+ "type": {
2214
+ "text": "boolean"
2215
+ },
2216
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2217
+ "fieldName": "shift"
2218
+ },
2219
+ {
2220
+ "name": "noValidate",
2221
+ "type": {
2222
+ "text": "boolean"
2223
+ },
2224
+ "description": "If set, disables auto-validation on blur.",
2225
+ "fieldName": "noValidate"
2226
+ },
2227
+ {
2228
+ "name": "offset",
2229
+ "type": {
2230
+ "text": "number"
2231
+ },
2232
+ "description": "Gap between the trigger element and bib.",
2233
+ "default": "0",
2234
+ "fieldName": "offset"
2235
+ },
2236
+ {
2237
+ "name": "onDark",
2238
+ "type": {
2239
+ "text": "boolean"
2240
+ },
2241
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2242
+ "fieldName": "onDark"
2243
+ },
2244
+ {
2245
+ "name": "optionSelected",
2265
2246
  "type": {
2266
- "text": "number"
2247
+ "text": "HTMLElement"
2267
2248
  },
2268
- "description": "The tabindex attribute for the checkbox.",
2269
- "attribute": "tabindex",
2270
- "reflects": true
2249
+ "description": "Specifies the current selected option.",
2250
+ "fieldName": "optionSelected"
2271
2251
  },
2272
2252
  {
2273
- "kind": "field",
2274
- "name": "ariaChecked",
2275
- "privacy": "private",
2253
+ "name": "persistInput",
2276
2254
  "type": {
2277
- "text": "string"
2255
+ "text": "boolean"
2278
2256
  },
2279
- "description": "The aria-checked attribute for the checkbox.",
2280
- "attribute": "aria-checked",
2281
- "reflects": true
2257
+ "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.",
2258
+ "fieldName": "persistInput"
2282
2259
  },
2283
2260
  {
2284
- "kind": "field",
2285
- "name": "ariaDisabled",
2286
- "privacy": "private",
2261
+ "name": "placement",
2287
2262
  "type": {
2288
- "text": "string"
2263
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2289
2264
  },
2290
- "description": "The aria-disabled attribute for the checkbox.",
2291
- "attribute": "aria-disabled",
2292
- "reflects": true
2265
+ "description": "Position where the bib should appear relative to the trigger.",
2266
+ "default": "'bottom-start'",
2267
+ "fieldName": "placement"
2293
2268
  },
2294
2269
  {
2295
- "kind": "field",
2296
- "name": "role",
2297
- "privacy": "private",
2270
+ "name": "placeholder",
2298
2271
  "type": {
2299
2272
  "text": "string"
2300
2273
  },
2301
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2302
- "attribute": "role",
2303
- "reflects": true
2304
- }
2305
- ],
2306
- "events": [
2307
- {
2308
- "name": "auroCheckbox-input",
2309
- "type": {
2310
- "text": "CustomEvent"
2311
- }
2274
+ "description": "Define custom placeholder text, only supported by date input formats.",
2275
+ "fieldName": "placeholder"
2312
2276
  },
2313
2277
  {
2314
- "name": "auroCheckbox-focusin",
2278
+ "name": "required",
2315
2279
  "type": {
2316
- "text": "CustomEvent"
2317
- }
2280
+ "text": "boolean"
2281
+ },
2282
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2283
+ "fieldName": "required"
2318
2284
  },
2319
2285
  {
2320
- "name": "auroCheckbox-focusout",
2286
+ "name": "setCustomValidity",
2321
2287
  "type": {
2322
- "text": "CustomEvent"
2323
- }
2324
- },
2325
- {
2326
- "description": "(Deprecated) Notifies when checked value is changed.",
2327
- "name": "change"
2288
+ "text": "string"
2289
+ },
2290
+ "description": "Sets a custom help text message to display for all validityStates.",
2291
+ "fieldName": "setCustomValidity"
2328
2292
  },
2329
2293
  {
2330
- "description": "Notifies when when checked value is changed by user's interface.",
2331
- "name": "input"
2332
- }
2333
- ],
2334
- "attributes": [
2335
- {
2336
- "name": "appearance",
2294
+ "name": "setCustomValidityCustomError",
2337
2295
  "type": {
2338
- "text": "'default' | 'inverse'"
2296
+ "text": "string"
2339
2297
  },
2340
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2341
- "default": "'default'",
2342
- "fieldName": "appearance"
2298
+ "description": "Custom help text message to display when validity = `customError`.",
2299
+ "fieldName": "setCustomValidityCustomError"
2343
2300
  },
2344
2301
  {
2345
- "name": "checked",
2302
+ "name": "setCustomValidityValueMissing",
2346
2303
  "type": {
2347
- "text": "boolean"
2304
+ "text": "string"
2348
2305
  },
2349
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2350
- "fieldName": "checked"
2306
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2307
+ "fieldName": "setCustomValidityValueMissing"
2351
2308
  },
2352
2309
  {
2353
- "name": "disabled",
2310
+ "name": "setCustomValidityValueMissingFilter",
2354
2311
  "type": {
2355
- "text": "boolean"
2312
+ "text": "string"
2356
2313
  },
2357
- "description": "If set to true, the checkbox will not be clickable.",
2358
- "fieldName": "disabled"
2314
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2315
+ "fieldName": "setCustomValidityValueMissingFilter"
2359
2316
  },
2360
2317
  {
2361
- "name": "error",
2318
+ "name": "triggerIcon",
2362
2319
  "type": {
2363
2320
  "text": "boolean"
2364
2321
  },
2365
- "description": "If set to true, the checkbox will be displayed with an error state.",
2366
- "fieldName": "error"
2322
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2323
+ "fieldName": "triggerIcon"
2367
2324
  },
2368
2325
  {
2369
- "name": "id",
2326
+ "name": "type",
2370
2327
  "type": {
2371
2328
  "text": "string"
2372
2329
  },
2373
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2374
- "fieldName": "id"
2330
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2331
+ "fieldName": "type"
2375
2332
  },
2376
2333
  {
2377
- "name": "name",
2334
+ "name": "typedValue",
2378
2335
  "type": {
2379
2336
  "text": "string"
2380
2337
  },
2381
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2382
- "fieldName": "name"
2338
+ "description": "Specifies the value of the input element within the combobox.",
2339
+ "fieldName": "typedValue"
2383
2340
  },
2384
2341
  {
2385
- "name": "onDark",
2342
+ "name": "validity",
2386
2343
  "type": {
2387
- "text": "boolean"
2344
+ "text": "string"
2388
2345
  },
2389
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2390
- "fieldName": "onDark"
2346
+ "description": "Specifies the `validityState` this element is in.",
2347
+ "fieldName": "validity"
2391
2348
  },
2392
2349
  {
2393
2350
  "name": "value",
2394
2351
  "type": {
2395
2352
  "text": "string"
2396
2353
  },
2397
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2354
+ "description": "Value selected for the dropdown menu.",
2398
2355
  "fieldName": "value"
2399
2356
  },
2400
2357
  {
2401
- "name": "tabindex",
2358
+ "name": "largeFullscreenHeadline",
2402
2359
  "type": {
2403
- "text": "number"
2360
+ "text": "boolean"
2404
2361
  },
2405
- "description": "The tabindex attribute for the checkbox.",
2406
- "fieldName": "tabIndex"
2362
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2363
+ "fieldName": "largeFullscreenHeadline"
2407
2364
  },
2408
2365
  {
2409
- "name": "aria-checked",
2366
+ "name": "fullscreenBreakpoint",
2410
2367
  "type": {
2411
- "text": "string"
2368
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2412
2369
  },
2413
- "description": "The aria-checked attribute for the checkbox.",
2414
- "fieldName": "ariaChecked"
2370
+ "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.",
2371
+ "default": "'sm'",
2372
+ "fieldName": "fullscreenBreakpoint"
2415
2373
  },
2416
2374
  {
2417
- "name": "aria-disabled",
2375
+ "name": "shape",
2418
2376
  "type": {
2419
2377
  "text": "string"
2420
2378
  },
2421
- "description": "The aria-disabled attribute for the checkbox.",
2422
- "fieldName": "ariaDisabled"
2379
+ "fieldName": "shape",
2380
+ "inheritedFrom": {
2381
+ "name": "AuroElement",
2382
+ "module": "components/layoutElement/src/auroElement.js"
2383
+ }
2423
2384
  },
2424
2385
  {
2425
- "name": "role",
2386
+ "name": "size",
2426
2387
  "type": {
2427
2388
  "text": "string"
2428
2389
  },
2429
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2430
- "fieldName": "role"
2390
+ "fieldName": "size",
2391
+ "inheritedFrom": {
2392
+ "name": "AuroElement",
2393
+ "module": "components/layoutElement/src/auroElement.js"
2394
+ }
2395
+ },
2396
+ {
2397
+ "name": "ondark",
2398
+ "type": {
2399
+ "text": "boolean"
2400
+ },
2401
+ "fieldName": "onDark",
2402
+ "inheritedFrom": {
2403
+ "name": "AuroElement",
2404
+ "module": "components/layoutElement/src/auroElement.js"
2405
+ }
2431
2406
  }
2432
2407
  ],
2433
2408
  "superclass": {
2434
- "name": "LitElement",
2435
- "package": "lit"
2409
+ "name": "AuroElement",
2410
+ "module": "/components/layoutElement/src/auroElement.js"
2436
2411
  },
2437
- "tagName": "auro-checkbox",
2412
+ "tagName": "auro-combobox",
2438
2413
  "customElement": true
2439
2414
  }
2440
2415
  ],
2441
2416
  "exports": [
2442
2417
  {
2443
2418
  "kind": "js",
2444
- "name": "AuroCheckbox",
2419
+ "name": "AuroCombobox",
2445
2420
  "declaration": {
2446
- "name": "AuroCheckbox",
2447
- "module": "components/checkbox/src/auro-checkbox.js"
2421
+ "name": "AuroCombobox",
2422
+ "module": "components/combobox/src/auro-combobox.js"
2448
2423
  }
2449
2424
  }
2450
2425
  ]
2451
2426
  },
2452
2427
  {
2453
2428
  "kind": "javascript-module",
2454
- "path": "components/checkbox/src/index.js",
2455
- "declarations": [],
2429
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2430
+ "declarations": [
2431
+ {
2432
+ "kind": "variable",
2433
+ "name": "comboboxKeyboardStrategy",
2434
+ "type": {
2435
+ "text": "object"
2436
+ },
2437
+ "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(); } } }, }"
2438
+ }
2439
+ ],
2456
2440
  "exports": [
2457
2441
  {
2458
2442
  "kind": "js",
2459
- "name": "AuroCheckbox",
2443
+ "name": "comboboxKeyboardStrategy",
2460
2444
  "declaration": {
2461
- "name": "AuroCheckbox",
2462
- "module": "components/checkbox/src/index.js"
2445
+ "name": "comboboxKeyboardStrategy",
2446
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2463
2447
  }
2464
- },
2448
+ }
2449
+ ]
2450
+ },
2451
+ {
2452
+ "kind": "javascript-module",
2453
+ "path": "components/combobox/src/index.js",
2454
+ "declarations": [],
2455
+ "exports": [
2465
2456
  {
2466
2457
  "kind": "js",
2467
- "name": "AuroCheckboxGroup",
2458
+ "name": "AuroCombobox",
2468
2459
  "declaration": {
2469
- "name": "AuroCheckboxGroup",
2470
- "module": "components/checkbox/src/index.js"
2460
+ "name": "AuroCombobox",
2461
+ "module": "components/combobox/src/index.js"
2471
2462
  }
2472
2463
  }
2473
2464
  ]
2474
2465
  },
2475
2466
  {
2476
2467
  "kind": "javascript-module",
2477
- "path": "components/checkbox/src/registered.js",
2468
+ "path": "components/combobox/src/registered.js",
2478
2469
  "declarations": [],
2479
- "exports": []
2470
+ "exports": [
2471
+ {
2472
+ "kind": "js",
2473
+ "name": "AuroCombobox",
2474
+ "declaration": {
2475
+ "name": "AuroCombobox",
2476
+ "module": "components/combobox/src/registered.js"
2477
+ }
2478
+ }
2479
+ ]
2480
2480
  },
2481
2481
  {
2482
2482
  "kind": "javascript-module",
@@ -15326,6 +15326,18 @@
15326
15326
  "module": "components/layoutElement/src/auroElement.js"
15327
15327
  }
15328
15328
  },
15329
+ {
15330
+ "kind": "field",
15331
+ "name": "value",
15332
+ "privacy": "public",
15333
+ "type": {
15334
+ "text": "string"
15335
+ },
15336
+ "description": "The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.",
15337
+ "default": "undefined",
15338
+ "attribute": "value",
15339
+ "reflects": true
15340
+ },
15329
15341
  {
15330
15342
  "kind": "field",
15331
15343
  "name": "optionSelected",
@@ -15465,17 +15477,6 @@
15465
15477
  "description": "Available menu options.",
15466
15478
  "readonly": true
15467
15479
  },
15468
- {
15469
- "kind": "field",
15470
- "name": "value",
15471
- "privacy": "public",
15472
- "type": {
15473
- "text": "string"
15474
- },
15475
- "description": "The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.",
15476
- "attribute": "value",
15477
- "reflects": true
15478
- },
15479
15480
  {
15480
15481
  "kind": "field",
15481
15482
  "name": "componentHasFocus",
@@ -15728,6 +15729,7 @@
15728
15729
  "text": "string"
15729
15730
  },
15730
15731
  "description": "The value of the selected option. In multi-select mode, this is a JSON stringified array of selected option values.",
15732
+ "default": "undefined",
15731
15733
  "fieldName": "value"
15732
15734
  },
15733
15735
  {