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