@aurodesignsystem-dev/auro-formkit 0.0.0-pr1519.0 → 0.0.0-pr1520.0

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