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

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