@aurodesignsystem-dev/auro-formkit 0.0.0-pr1595.6 → 0.0.0-pr1595.8

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 (54) hide show
  1. package/components/checkbox/demo/api.md +1 -1
  2. package/components/checkbox/demo/customize.min.js +3 -5
  3. package/components/checkbox/demo/getting-started.min.js +3 -5
  4. package/components/checkbox/demo/index.min.js +3 -5
  5. package/components/checkbox/dist/auro-checkbox.d.ts +2 -2
  6. package/components/checkbox/dist/index.js +3 -5
  7. package/components/checkbox/dist/registered.js +3 -5
  8. package/components/combobox/demo/api.md +1 -1
  9. package/components/combobox/demo/customize.min.js +20 -9
  10. package/components/combobox/demo/getting-started.min.js +20 -9
  11. package/components/combobox/demo/index.min.js +20 -9
  12. package/components/combobox/dist/auro-combobox.d.ts +10 -5
  13. package/components/combobox/dist/index.js +20 -9
  14. package/components/combobox/dist/registered.js +20 -9
  15. package/components/counter/demo/customize.min.js +7 -4
  16. package/components/counter/demo/index.min.js +7 -4
  17. package/components/counter/dist/auro-counter-group.d.ts +4 -2
  18. package/components/counter/dist/index.js +7 -4
  19. package/components/counter/dist/registered.js +7 -4
  20. package/components/datepicker/demo/customize.min.js +8 -5
  21. package/components/datepicker/demo/index.min.js +8 -5
  22. package/components/datepicker/dist/auro-datepicker.d.ts +4 -2
  23. package/components/datepicker/dist/index.js +8 -5
  24. package/components/datepicker/dist/registered.js +8 -5
  25. package/components/dropdown/demo/api.md +1 -1
  26. package/components/dropdown/demo/customize.min.js +3 -3
  27. package/components/dropdown/demo/getting-started.min.js +4 -4
  28. package/components/dropdown/demo/index.min.js +3 -3
  29. package/components/dropdown/dist/auro-dropdownBib.d.ts +1 -1
  30. package/components/dropdown/dist/index.js +3 -3
  31. package/components/dropdown/dist/registered.js +3 -3
  32. package/components/form/demo/customize.min.js +46 -31
  33. package/components/form/demo/getting-started.min.js +46 -31
  34. package/components/form/demo/index.min.js +46 -31
  35. package/components/form/demo/registerDemoDeps.min.js +46 -31
  36. package/components/input/demo/customize.min.js +1 -1
  37. package/components/input/demo/getting-started.min.js +1 -1
  38. package/components/input/demo/index.min.js +1 -1
  39. package/components/input/dist/index.js +1 -1
  40. package/components/input/dist/registered.js +1 -1
  41. package/components/radio/demo/api.md +1 -1
  42. package/components/radio/demo/customize.min.js +2 -2
  43. package/components/radio/demo/getting-started.min.js +2 -2
  44. package/components/radio/demo/index.min.js +2 -2
  45. package/components/radio/dist/index.js +2 -2
  46. package/components/radio/dist/registered.js +2 -2
  47. package/components/select/demo/api.md +1 -1
  48. package/components/select/demo/customize.min.js +5 -5
  49. package/components/select/demo/getting-started.min.js +5 -5
  50. package/components/select/demo/index.min.js +5 -5
  51. package/components/select/dist/index.js +5 -5
  52. package/components/select/dist/registered.js +5 -5
  53. package/custom-elements.json +1474 -1519
  54. package/package.json +1 -1
@@ -279,40 +279,113 @@
279
279
  },
280
280
  {
281
281
  "kind": "javascript-module",
282
- "path": "components/checkbox/src/auro-checkbox-group.js",
282
+ "path": "components/combobox/src/auro-combobox.js",
283
283
  "declarations": [
284
284
  {
285
285
  "kind": "class",
286
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
287
- "name": "AuroCheckboxGroup",
286
+ "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.",
287
+ "name": "AuroCombobox",
288
288
  "cssParts": [
289
289
  {
290
- "description": "Apply css to the help text element that displays helper or error messages.",
290
+ "description": "The help text and error message content container.",
291
291
  "name": "helpText"
292
292
  }
293
293
  ],
294
294
  "slots": [
295
295
  {
296
- "description": "Allows for the legend to be overridden.",
297
- "name": "legend"
296
+ "description": "Default slot for the menu content.",
297
+ "name": ""
298
298
  },
299
299
  {
300
+ "type": {
301
+ "text": "HTMLSlotElement"
302
+ },
300
303
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
301
304
  "name": "optionalLabel"
302
305
  },
303
306
  {
304
- "description": "Allows for the helper text to be overridden.",
307
+ "description": "Sets aria-label on clear button",
308
+ "name": "ariaLabel.input.clear"
309
+ },
310
+ {
311
+ "description": "Sets aria-label on close button in fullscreen bib",
312
+ "name": "ariaLabel.bib.close"
313
+ },
314
+ {
315
+ "description": "Defines the headline to display above menu-options",
316
+ "name": "bib.fullscreen.headline"
317
+ },
318
+ {
319
+ "description": "Defines the content of the label.",
320
+ "name": "label"
321
+ },
322
+ {
323
+ "description": "Defines the content of the helpText.",
305
324
  "name": "helpText"
306
325
  },
307
326
  {
308
- "description": "The default slot for the checkbox items.",
309
- "name": "default"
327
+ "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
328
+ "name": "displayValue"
310
329
  }
311
330
  ],
312
331
  "members": [
313
332
  {
314
333
  "kind": "method",
315
- "name": "_initializeDefaults"
334
+ "name": "_initializeDefaults",
335
+ "privacy": "private",
336
+ "return": {
337
+ "type": {
338
+ "text": "void"
339
+ }
340
+ }
341
+ },
342
+ {
343
+ "kind": "method",
344
+ "name": "_scheduleTimer",
345
+ "parameters": [
346
+ {
347
+ "name": "fn",
348
+ "description": "Callback to run.",
349
+ "type": {
350
+ "text": "Function"
351
+ }
352
+ },
353
+ {
354
+ "name": "ms",
355
+ "description": "Delay in milliseconds.",
356
+ "type": {
357
+ "text": "number"
358
+ }
359
+ }
360
+ ],
361
+ "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.",
362
+ "return": {
363
+ "type": {
364
+ "text": "number"
365
+ }
366
+ },
367
+ "privacy": "private"
368
+ },
369
+ {
370
+ "kind": "field",
371
+ "name": "inputValue",
372
+ "description": "Returns the current value of the input element within the combobox.",
373
+ "return": {
374
+ "type": {
375
+ "text": "string|undefined"
376
+ }
377
+ },
378
+ "readonly": true
379
+ },
380
+ {
381
+ "kind": "method",
382
+ "name": "isValid",
383
+ "description": "Checks if the element is valid.",
384
+ "return": {
385
+ "type": {
386
+ "text": "boolean"
387
+ }
388
+ }
316
389
  },
317
390
  {
318
391
  "kind": "method",
@@ -321,7 +394,7 @@
321
394
  "parameters": [
322
395
  {
323
396
  "name": "name",
324
- "default": "\"auro-checkbox-group\"",
397
+ "default": "'auro-combobox'",
325
398
  "description": "The name of the element that you want to register.",
326
399
  "optional": true,
327
400
  "type": {
@@ -333,24 +406,96 @@
333
406
  },
334
407
  {
335
408
  "kind": "method",
336
- "name": "handleValueUpdate",
409
+ "name": "activateFirstEnabledAvailableOption",
410
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
411
+ "privacy": "private",
412
+ "return": {
413
+ "type": {
414
+ "text": "void"
415
+ }
416
+ }
417
+ },
418
+ {
419
+ "kind": "method",
420
+ "name": "activateLastEnabledAvailableOption",
421
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
422
+ "privacy": "private",
423
+ "return": {
424
+ "type": {
425
+ "text": "void"
426
+ }
427
+ }
428
+ },
429
+ {
430
+ "kind": "method",
431
+ "name": "updateFilter",
432
+ "description": "Updates the filter for the available options based on the input value.",
433
+ "privacy": "private"
434
+ },
435
+ {
436
+ "kind": "method",
437
+ "name": "syncValuesAndStates",
438
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
439
+ "privacy": "private",
440
+ "return": {
441
+ "type": {
442
+ "text": "void"
443
+ }
444
+ }
445
+ },
446
+ {
447
+ "kind": "method",
448
+ "name": "updateTriggerTextDisplay",
337
449
  "parameters": [
338
450
  {
339
- "name": "value",
340
- "description": "The value of the checkbox.",
451
+ "name": "label",
452
+ "description": "The label of the selected option.",
341
453
  "type": {
342
- "text": "String"
454
+ "text": "string"
455
+ }
456
+ }
457
+ ],
458
+ "description": "Update displayValue or input.value, it's called when making a selection.",
459
+ "privacy": "private"
460
+ },
461
+ {
462
+ "kind": "method",
463
+ "name": "syncInputValuesAcrossTriggerAndBib",
464
+ "parameters": [
465
+ {
466
+ "name": "nextValue",
467
+ "description": "The value to write to both inputs.",
468
+ "type": {
469
+ "text": "string"
343
470
  }
471
+ }
472
+ ],
473
+ "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.",
474
+ "return": {
475
+ "type": {
476
+ "text": "Promise<void>"
477
+ }
478
+ },
479
+ "privacy": "private"
480
+ },
481
+ {
482
+ "kind": "method",
483
+ "name": "handleMenuOptions",
484
+ "parameters": [
485
+ {
486
+ "name": "{ preferComboboxValue = false }",
487
+ "default": "{}"
344
488
  },
345
489
  {
346
- "name": "selected",
347
- "description": "The checked state of the checkbox.",
490
+ "description": "Optional flag bag.",
491
+ "name": "options",
492
+ "optional": true,
348
493
  "type": {
349
- "text": "Boolean"
494
+ "text": "@param {boolean} [options.preferComboboxValue=false] - When true,\n * handleMenuOptions matches the selected option against `this.value`\n * first instead of `this.input.value`. Needed on mount and re-mount\n * because under `persistInput` the consumer's typedValue prop can drift\n * from the framework value (Svelte `{#key}` re-mount after a swap, or\n * SPA preselect after route change) and the old input-first match would\n * then pick the stale text. Only handleSlotChange passes this; typing\n * and clearing paths keep the input-first match so user clears aren't\n * undone.\n * "
350
495
  }
351
496
  }
352
497
  ],
353
- "description": "Helper method to handle checkbox value changing.",
498
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
354
499
  "privacy": "private",
355
500
  "return": {
356
501
  "type": {
@@ -360,8 +505,8 @@
360
505
  },
361
506
  {
362
507
  "kind": "method",
363
- "name": "handlePreselectedItems",
364
- "description": "Helper method that handles the state of preselected checkboxes.",
508
+ "name": "generateOptionsArray",
509
+ "description": "Determines the element error state based on the `required` attribute and input value.",
365
510
  "privacy": "private",
366
511
  "return": {
367
512
  "type": {
@@ -371,9 +516,8 @@
371
516
  },
372
517
  {
373
518
  "kind": "method",
374
- "name": "handleItems",
375
- "description": "Helper method that handles the state of checkboxes.",
376
- "privacy": "private",
519
+ "name": "hideBib",
520
+ "description": "Hides the dropdown bib if its open.",
377
521
  "return": {
378
522
  "type": {
379
523
  "text": "void"
@@ -382,8 +526,8 @@
382
526
  },
383
527
  {
384
528
  "kind": "method",
385
- "name": "reset",
386
- "description": "Resets component to initial state.",
529
+ "name": "showBib",
530
+ "description": "Shows the dropdown bib if there are options to show.",
387
531
  "return": {
388
532
  "type": {
389
533
  "text": "void"
@@ -392,328 +536,122 @@
392
536
  },
393
537
  {
394
538
  "kind": "method",
395
- "name": "validate",
396
- "parameters": [
397
- {
398
- "name": "force",
399
- "default": "false",
400
- "description": "Whether to force validation.",
401
- "optional": true,
402
- "type": {
403
- "text": "boolean"
404
- }
539
+ "name": "configureDropdown",
540
+ "description": "Binds all behavior needed to the dropdown after rendering.",
541
+ "privacy": "private",
542
+ "return": {
543
+ "type": {
544
+ "text": "void"
405
545
  }
406
- ],
407
- "description": "Validates value."
546
+ }
408
547
  },
409
548
  {
410
- "kind": "field",
411
- "name": "appearance",
412
- "privacy": "public",
413
- "type": {
414
- "text": "'default' | 'inverse'"
415
- },
416
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
417
- "default": "'default'",
418
- "attribute": "appearance",
419
- "reflects": true
549
+ "kind": "method",
550
+ "name": "setClearBtnFocus",
551
+ "privacy": "private"
420
552
  },
421
553
  {
422
- "kind": "field",
423
- "name": "disabled",
424
- "privacy": "public",
425
- "type": {
426
- "text": "boolean"
427
- },
428
- "description": "If set, disables the checkbox group.",
429
- "attribute": "disabled",
430
- "reflects": true
554
+ "kind": "method",
555
+ "name": "setTriggerInputFocus",
556
+ "privacy": "private"
431
557
  },
432
558
  {
433
- "kind": "field",
434
- "name": "error",
435
- "privacy": "public",
436
- "type": {
437
- "text": "string"
438
- },
439
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
440
- "attribute": "error",
441
- "reflects": true
559
+ "kind": "method",
560
+ "name": "setInputFocus",
561
+ "privacy": "private"
442
562
  },
443
563
  {
444
- "kind": "field",
445
- "name": "horizontal",
446
- "privacy": "public",
447
- "type": {
448
- "text": "boolean"
449
- },
450
- "description": "If set, checkboxes will be aligned horizontally.",
451
- "attribute": "horizontal",
452
- "reflects": true
453
- },
454
- {
455
- "kind": "field",
456
- "name": "noValidate",
457
- "privacy": "public",
458
- "type": {
459
- "text": "boolean"
460
- },
461
- "description": "If set, disables auto-validation on blur.",
462
- "attribute": "novalidate",
463
- "reflects": true
464
- },
465
- {
466
- "kind": "field",
467
- "name": "onDark",
468
- "privacy": "public",
469
- "type": {
470
- "text": "boolean"
471
- },
472
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
473
- "deprecated": "Use `appearance=\"inverse\"` instead.",
474
- "attribute": "ondark",
475
- "reflects": true
476
- },
477
- {
478
- "kind": "field",
479
- "name": "required",
480
- "privacy": "public",
481
- "type": {
482
- "text": "boolean"
483
- },
484
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
485
- "attribute": "required",
486
- "reflects": true
487
- },
488
- {
489
- "kind": "field",
490
- "name": "setCustomValidity",
491
- "privacy": "public",
492
- "type": {
493
- "text": "string"
494
- },
495
- "description": "Sets a custom help text message to display for all validityStates.",
496
- "attribute": "setcustomvalidity"
497
- },
498
- {
499
- "kind": "field",
500
- "name": "setCustomValidityCustomError",
501
- "privacy": "public",
502
- "type": {
503
- "text": "string"
504
- },
505
- "description": "Custom help text message to display when validity = `customError`.",
506
- "attribute": "setcustomvaliditycustomerror"
507
- },
508
- {
509
- "kind": "field",
510
- "name": "setCustomValidityValueMissing",
511
- "privacy": "public",
512
- "type": {
513
- "text": "string"
514
- },
515
- "description": "Custom help text message to display when validity = `valueMissing`.",
516
- "attribute": "setcustomvalidityvaluemissing"
517
- },
518
- {
519
- "kind": "field",
520
- "name": "validity",
521
- "privacy": "public",
522
- "type": {
523
- "text": "string"
524
- },
525
- "description": "Specifies the `validityState` this element is in.",
526
- "attribute": "validity",
527
- "reflects": true
528
- }
529
- ],
530
- "events": [
531
- {
532
- "name": "input",
533
- "type": {
534
- "text": "CustomEvent"
535
- },
536
- "description": "Notifies when the group's value changes due to a checkbox selection being added or removed."
537
- },
538
- {
539
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
540
- "name": "auroFormElement-validated"
541
- }
542
- ],
543
- "attributes": [
544
- {
545
- "name": "appearance",
546
- "type": {
547
- "text": "'default' | 'inverse'"
548
- },
549
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
550
- "default": "'default'",
551
- "fieldName": "appearance"
552
- },
553
- {
554
- "name": "disabled",
555
- "type": {
556
- "text": "boolean"
557
- },
558
- "description": "If set, disables the checkbox group.",
559
- "fieldName": "disabled"
560
- },
561
- {
562
- "name": "error",
563
- "type": {
564
- "text": "string"
565
- },
566
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
567
- "fieldName": "error"
568
- },
569
- {
570
- "name": "horizontal",
571
- "type": {
572
- "text": "boolean"
573
- },
574
- "description": "If set, checkboxes will be aligned horizontally.",
575
- "fieldName": "horizontal"
576
- },
577
- {
578
- "name": "novalidate",
579
- "type": {
580
- "text": "boolean"
581
- },
582
- "description": "If set, disables auto-validation on blur.",
583
- "fieldName": "noValidate"
584
- },
585
- {
586
- "name": "ondark",
587
- "type": {
588
- "text": "boolean"
589
- },
590
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
591
- "deprecated": "Use `appearance=\"inverse\"` instead.",
592
- "fieldName": "onDark"
593
- },
594
- {
595
- "name": "required",
596
- "type": {
597
- "text": "boolean"
598
- },
599
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
600
- "fieldName": "required"
601
- },
602
- {
603
- "name": "setcustomvalidity",
604
- "type": {
605
- "text": "string"
606
- },
607
- "description": "Sets a custom help text message to display for all validityStates.",
608
- "fieldName": "setCustomValidity"
609
- },
610
- {
611
- "name": "setcustomvaliditycustomerror",
612
- "type": {
613
- "text": "string"
614
- },
615
- "description": "Custom help text message to display when validity = `customError`.",
616
- "fieldName": "setCustomValidityCustomError"
564
+ "kind": "method",
565
+ "name": "updateBibDialogRole",
566
+ "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.",
567
+ "privacy": "private"
617
568
  },
618
569
  {
619
- "name": "setcustomvalidityvaluemissing",
620
- "type": {
621
- "text": "string"
622
- },
623
- "description": "Custom help text message to display when validity = `valueMissing`.",
624
- "fieldName": "setCustomValidityValueMissing"
570
+ "kind": "method",
571
+ "name": "updateMenuShapeSize",
572
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
573
+ "privacy": "private"
625
574
  },
626
575
  {
627
- "name": "validity",
628
- "type": {
629
- "text": "string"
630
- },
631
- "description": "Specifies the `validityState` this element is in.",
632
- "fieldName": "validity"
633
- }
634
- ],
635
- "superclass": {
636
- "name": "LitElement",
637
- "package": "lit"
638
- },
639
- "tagName": "auro-checkbox-group",
640
- "customElement": true
641
- }
642
- ],
643
- "exports": [
644
- {
645
- "kind": "js",
646
- "name": "AuroCheckboxGroup",
647
- "declaration": {
648
- "name": "AuroCheckboxGroup",
649
- "module": "components/checkbox/src/auro-checkbox-group.js"
650
- }
651
- }
652
- ]
653
- },
654
- {
655
- "kind": "javascript-module",
656
- "path": "components/checkbox/src/auro-checkbox.js",
657
- "declarations": [
658
- {
659
- "kind": "class",
660
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
661
- "name": "AuroCheckbox",
662
- "cssParts": [
663
- {
664
- "description": "apply css to a specific checkbox.",
665
- "name": "checkbox"
576
+ "kind": "method",
577
+ "name": "_getAnnouncementRoot",
578
+ "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.",
579
+ "privacy": "private",
580
+ "return": {
581
+ "type": {
582
+ "text": "ShadowRoot"
583
+ }
584
+ }
666
585
  },
667
586
  {
668
- "description": "apply css to a specific checkbox's input.",
669
- "name": "checkbox-input"
587
+ "kind": "method",
588
+ "name": "configureMenu",
589
+ "description": "Binds all behavior needed to the menu after rendering.",
590
+ "privacy": "private",
591
+ "return": {
592
+ "type": {
593
+ "text": "void"
594
+ }
595
+ }
670
596
  },
671
- {
672
- "description": "apply css to a specific checkbox's label.",
673
- "name": "checkbox-label"
674
- }
675
- ],
676
- "slots": [
677
- {
678
- "description": "The default slot for the checkbox label.",
679
- "name": "default"
680
- }
681
- ],
682
- "members": [
683
597
  {
684
598
  "kind": "method",
685
- "name": "_initializeDefaults"
599
+ "name": "configureInput",
600
+ "description": "Binds all behavior needed to the input after rendering.",
601
+ "privacy": "private",
602
+ "return": {
603
+ "type": {
604
+ "text": "void"
605
+ }
606
+ }
686
607
  },
687
608
  {
688
609
  "kind": "method",
689
- "name": "register",
690
- "static": true,
610
+ "name": "handleMenuLoadingChange",
691
611
  "parameters": [
692
612
  {
693
- "name": "name",
694
- "default": "\"auro-checkbox\"",
695
- "description": "The name of element that you want to register to.",
696
- "optional": true,
613
+ "name": "event",
614
+ "description": "The event object containing details about the loading state change.",
697
615
  "type": {
698
- "text": "string"
616
+ "text": "CustomEvent"
617
+ }
618
+ },
619
+ {
620
+ "description": "Indicates whether the menu is currently loading.",
621
+ "name": "event.detail.loading",
622
+ "type": {
623
+ "text": "boolean"
624
+ }
625
+ },
626
+ {
627
+ "description": "Indicates if there are loading placeholders present.",
628
+ "name": "event.detail.hasLoadingPlaceholder",
629
+ "type": {
630
+ "text": "boolean"
699
631
  }
700
632
  }
701
633
  ],
702
- "description": "This will register this element with the browser."
634
+ "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.",
635
+ "privacy": "private",
636
+ "return": {
637
+ "type": {
638
+ "text": "void"
639
+ }
640
+ }
703
641
  },
704
642
  {
705
643
  "kind": "method",
706
- "name": "handleChange",
644
+ "name": "handleInputValueChange",
707
645
  "parameters": [
708
646
  {
709
647
  "name": "event",
710
- "description": "The change event from the checkbox input.",
648
+ "description": "The input event triggered by the input element.",
711
649
  "type": {
712
650
  "text": "Event"
713
651
  }
714
652
  }
715
653
  ],
716
- "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.",
654
+ "description": "Handle changes to the input value and trigger changes that should result.",
717
655
  "privacy": "private",
718
656
  "return": {
719
657
  "type": {
@@ -723,17 +661,17 @@
723
661
  },
724
662
  {
725
663
  "kind": "method",
726
- "name": "handleInput",
664
+ "name": "handleTriggerInputValueChange",
727
665
  "parameters": [
728
666
  {
729
667
  "name": "event",
730
- "description": "The input event from the checkbox input.",
668
+ "description": "The input event from the trigger input element.",
731
669
  "type": {
732
670
  "text": "Event"
733
671
  }
734
672
  }
735
673
  ],
736
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
674
+ "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.",
737
675
  "privacy": "private",
738
676
  "return": {
739
677
  "type": {
@@ -743,8 +681,8 @@
743
681
  },
744
682
  {
745
683
  "kind": "method",
746
- "name": "handleFocusin",
747
- "description": "Function to support",
684
+ "name": "configureCombobox",
685
+ "description": "Binds all behavior needed to the combobox after rendering.",
748
686
  "privacy": "private",
749
687
  "return": {
750
688
  "type": {
@@ -754,12 +692,30 @@
754
692
  },
755
693
  {
756
694
  "kind": "method",
757
- "name": "generateIconHtml",
758
- "description": "Function to generate checkmark svg.",
759
- "privacy": "private",
695
+ "name": "focus",
696
+ "description": "Focuses the combobox trigger input.",
760
697
  "return": {
761
698
  "type": {
762
- "text": "HTMLElement"
699
+ "text": "void"
700
+ }
701
+ }
702
+ },
703
+ {
704
+ "kind": "method",
705
+ "name": "setMenuValue",
706
+ "parameters": [
707
+ {
708
+ "name": "value",
709
+ "description": "The value to set on the menu.",
710
+ "type": {
711
+ "text": "string"
712
+ }
713
+ }
714
+ ],
715
+ "description": "Sets the menu value if menu is available.",
716
+ "return": {
717
+ "type": {
718
+ "text": "void"
763
719
  }
764
720
  }
765
721
  },
@@ -775,28 +731,91 @@
775
731
  },
776
732
  {
777
733
  "kind": "method",
778
- "name": "updateAriaLabel",
779
- "description": "Updates the aria-label based on slot content.",
734
+ "name": "clear",
735
+ "description": "Clears the current value of the combobox.",
736
+ "return": {
737
+ "type": {
738
+ "text": "void"
739
+ }
740
+ }
741
+ },
742
+ {
743
+ "kind": "method",
744
+ "name": "validate",
745
+ "parameters": [
746
+ {
747
+ "name": "force",
748
+ "default": "false",
749
+ "description": "Whether to force validation.",
750
+ "optional": true,
751
+ "type": {
752
+ "text": "boolean"
753
+ }
754
+ }
755
+ ],
756
+ "description": "Validates value."
757
+ },
758
+ {
759
+ "kind": "method",
760
+ "name": "transportAssignedNodes",
761
+ "parameters": [
762
+ {
763
+ "name": "slot",
764
+ "description": "The slot element containing the nodes to apply.",
765
+ "type": {
766
+ "text": "HTMLSlotElement"
767
+ }
768
+ },
769
+ {
770
+ "name": "target",
771
+ "description": "The target element to apply the nodes to.",
772
+ "type": {
773
+ "text": "HTMLElement"
774
+ }
775
+ },
776
+ {
777
+ "name": "newSlotName",
778
+ "description": "The new slot name for the applied nodes.",
779
+ "type": {
780
+ "text": "string"
781
+ }
782
+ }
783
+ ],
784
+ "description": "Applies slotted nodes to a target element with a new slot name.",
780
785
  "privacy": "private",
781
786
  "return": {
782
787
  "type": {
783
788
  "text": "void"
784
789
  }
785
- }
790
+ }
791
+ },
792
+ {
793
+ "kind": "method",
794
+ "name": "updateActiveOption",
795
+ "parameters": [
796
+ {
797
+ "name": "index",
798
+ "description": "Index of the option to make active.",
799
+ "type": {
800
+ "text": "number"
801
+ }
802
+ }
803
+ ],
804
+ "description": "Updates the active option in the menu."
786
805
  },
787
806
  {
788
807
  "kind": "method",
789
- "name": "handleKeyDown",
808
+ "name": "handleSlotChange",
790
809
  "parameters": [
791
810
  {
792
811
  "name": "event",
793
- "description": "The keydown event from the checkbox input.",
812
+ "description": "`slotchange` event.",
794
813
  "type": {
795
- "text": "KeyboardEvent"
814
+ "text": "Event"
796
815
  }
797
816
  }
798
817
  ],
799
- "description": "Handles keydown event to toggle the checkbox with Space key.",
818
+ "description": "Watch for slot changes and recalculate the menuoptions.",
800
819
  "privacy": "private",
801
820
  "return": {
802
821
  "type": {
@@ -818,13 +837,56 @@
818
837
  },
819
838
  {
820
839
  "kind": "field",
821
- "name": "checked",
840
+ "name": "autocomplete",
841
+ "privacy": "public",
842
+ "type": {
843
+ "text": "string"
844
+ },
845
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
846
+ "attribute": "autocomplete",
847
+ "reflects": true
848
+ },
849
+ {
850
+ "kind": "field",
851
+ "name": "autoPlacement",
822
852
  "privacy": "public",
823
853
  "type": {
824
854
  "text": "boolean"
825
855
  },
826
- "description": "If set to true, the checkbox will be filled with a checkmark.",
827
- "attribute": "checked",
856
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
857
+ "attribute": "autoplacement",
858
+ "reflects": true
859
+ },
860
+ {
861
+ "kind": "field",
862
+ "name": "availableOptions",
863
+ "privacy": "private",
864
+ "type": {
865
+ "text": "HTMLElement[]"
866
+ },
867
+ "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)."
868
+ },
869
+ {
870
+ "kind": "field",
871
+ "name": "behavior",
872
+ "privacy": "public",
873
+ "type": {
874
+ "text": "'filter' | 'suggestion'"
875
+ },
876
+ "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.",
877
+ "default": "'suggestion'",
878
+ "attribute": "behavior",
879
+ "reflects": true
880
+ },
881
+ {
882
+ "kind": "field",
883
+ "name": "checkmark",
884
+ "privacy": "public",
885
+ "type": {
886
+ "text": "boolean"
887
+ },
888
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
889
+ "attribute": "checkmark",
828
890
  "reflects": true
829
891
  },
830
892
  {
@@ -834,1154 +896,1012 @@
834
896
  "type": {
835
897
  "text": "boolean"
836
898
  },
837
- "description": "If set to true, the checkbox will not be clickable.",
899
+ "description": "If set, disables the combobox.",
838
900
  "attribute": "disabled",
839
901
  "reflects": true
840
902
  },
841
903
  {
842
904
  "kind": "field",
843
- "name": "error",
905
+ "name": "dropdownId",
906
+ "privacy": "private",
907
+ "type": {
908
+ "text": "string"
909
+ },
910
+ "description": "ID for the dropdown."
911
+ },
912
+ {
913
+ "kind": "field",
914
+ "name": "dropdownOpen",
915
+ "privacy": "private",
916
+ "type": {
917
+ "text": "boolean"
918
+ },
919
+ "description": "Whether or not the dropdown is open."
920
+ },
921
+ {
922
+ "kind": "field",
923
+ "name": "dvInputOnly",
844
924
  "privacy": "public",
845
925
  "type": {
846
926
  "text": "boolean"
847
927
  },
848
- "description": "If set to true, the checkbox will be displayed with an error state.",
849
- "attribute": "error",
928
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
929
+ "attribute": "dvinputonly",
850
930
  "reflects": true
851
931
  },
852
932
  {
853
933
  "kind": "field",
854
- "name": "id",
934
+ "name": "error",
855
935
  "privacy": "public",
856
936
  "type": {
857
937
  "text": "string"
858
938
  },
859
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
860
- "attribute": "id",
939
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
940
+ "attribute": "error",
861
941
  "reflects": true
862
942
  },
863
943
  {
864
944
  "kind": "field",
865
- "name": "inputId",
866
- "privacy": "private",
945
+ "name": "format",
946
+ "privacy": "public",
867
947
  "type": {
868
948
  "text": "string"
869
949
  },
870
- "description": "The id for input node."
950
+ "description": "Specifies the input mask format.",
951
+ "attribute": "format",
952
+ "reflects": true
871
953
  },
872
954
  {
873
955
  "kind": "field",
874
- "name": "name",
956
+ "name": "inputmode",
875
957
  "privacy": "public",
876
958
  "type": {
877
959
  "text": "string"
878
960
  },
879
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
880
- "attribute": "name"
961
+ "description": "Exposes inputmode attribute for input.",
962
+ "attribute": "inputmode",
963
+ "reflects": true
881
964
  },
882
965
  {
883
966
  "kind": "field",
884
- "name": "onDark",
967
+ "name": "layout",
885
968
  "privacy": "public",
886
969
  "type": {
887
- "text": "boolean"
970
+ "text": "'classic' | 'emphasized' | 'snowflake'"
888
971
  },
889
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
890
- "deprecated": "Use `appearance=\"inverse\"` instead.",
891
- "attribute": "ondark",
972
+ "description": "Sets the layout of the combobox.",
973
+ "default": "'classic'",
974
+ "attribute": "layout",
892
975
  "reflects": true
893
976
  },
894
977
  {
895
978
  "kind": "field",
896
- "name": "touched",
897
- "privacy": "private",
979
+ "name": "shape",
980
+ "privacy": "public",
898
981
  "type": {
899
- "text": "boolean"
982
+ "text": "'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'"
900
983
  },
901
- "description": "Indicates whether the checkbox has been interacted with."
984
+ "description": "Sets the shape of the combobox.",
985
+ "default": "'classic'",
986
+ "attribute": "shape",
987
+ "reflects": true
902
988
  },
903
989
  {
904
990
  "kind": "field",
905
- "name": "value",
991
+ "name": "size",
906
992
  "privacy": "public",
907
993
  "type": {
908
- "text": "string"
994
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
909
995
  },
910
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
911
- "attribute": "value"
996
+ "description": "Sets the size of the combobox.",
997
+ "default": "'xl'",
998
+ "attribute": "size",
999
+ "reflects": true
912
1000
  },
913
1001
  {
914
1002
  "kind": "field",
915
- "name": "tabIndex",
1003
+ "name": "matchWidth",
916
1004
  "privacy": "private",
917
1005
  "type": {
918
- "text": "number"
1006
+ "text": "boolean"
919
1007
  },
920
- "description": "The tabindex attribute for the checkbox.",
921
- "attribute": "tabindex",
1008
+ "description": "If declared, the popover and trigger will be set to the same width.",
1009
+ "attribute": "matchwidth",
922
1010
  "reflects": true
923
1011
  },
924
1012
  {
925
1013
  "kind": "field",
926
- "name": "ariaChecked",
927
- "privacy": "private",
1014
+ "name": "noFilter",
1015
+ "privacy": "public",
928
1016
  "type": {
929
- "text": "string"
1017
+ "text": "boolean"
930
1018
  },
931
- "description": "The aria-checked attribute for the checkbox.",
932
- "attribute": "aria-checked",
1019
+ "description": "If set, combobox will not filter menuoptions based on input.",
1020
+ "attribute": "nofilter",
933
1021
  "reflects": true
934
1022
  },
935
1023
  {
936
1024
  "kind": "field",
937
- "name": "ariaDisabled",
938
- "privacy": "private",
1025
+ "name": "noFlip",
1026
+ "privacy": "public",
939
1027
  "type": {
940
- "text": "string"
1028
+ "text": "boolean"
941
1029
  },
942
- "description": "The aria-disabled attribute for the checkbox.",
943
- "attribute": "aria-disabled",
1030
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1031
+ "attribute": "noflip",
944
1032
  "reflects": true
945
1033
  },
946
1034
  {
947
1035
  "kind": "field",
948
- "name": "role",
949
- "privacy": "private",
1036
+ "name": "shift",
1037
+ "privacy": "public",
950
1038
  "type": {
951
- "text": "string"
1039
+ "text": "boolean"
952
1040
  },
953
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
954
- "attribute": "role",
1041
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1042
+ "attribute": "shift",
955
1043
  "reflects": true
956
- }
957
- ],
958
- "events": [
1044
+ },
959
1045
  {
960
- "name": "auroCheckbox-input",
1046
+ "kind": "field",
1047
+ "name": "noValidate",
1048
+ "privacy": "public",
961
1049
  "type": {
962
- "text": "CustomEvent"
1050
+ "text": "boolean"
963
1051
  },
964
- "description": "Notifies when the checked value is changed by user interaction. **DEPRECATED** - Use the `input` event instead.",
965
- "deprecated": "Use the `input` event instead."
1052
+ "description": "If set, disables auto-validation on blur.",
1053
+ "attribute": "novalidate",
1054
+ "reflects": true
966
1055
  },
967
1056
  {
968
- "name": "auroCheckbox-focusin",
1057
+ "kind": "field",
1058
+ "name": "offset",
1059
+ "privacy": "public",
969
1060
  "type": {
970
- "text": "CustomEvent"
1061
+ "text": "number"
971
1062
  },
972
- "description": "Notifies when the checkbox receives focus."
1063
+ "description": "Gap between the trigger element and bib.",
1064
+ "default": "0",
1065
+ "attribute": "offset",
1066
+ "reflects": true
973
1067
  },
974
1068
  {
975
- "name": "auroCheckbox-focusout",
1069
+ "kind": "field",
1070
+ "name": "onDark",
1071
+ "privacy": "public",
976
1072
  "type": {
977
- "text": "CustomEvent"
1073
+ "text": "boolean"
978
1074
  },
979
- "description": "Notifies when the checkbox loses focus."
1075
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1076
+ "attribute": "ondark",
1077
+ "reflects": true,
1078
+ "deprecated": "Use `appearance=\"inverse\"` instead.",
1079
+ "inheritedFrom": {
1080
+ "name": "AuroElement",
1081
+ "module": "components/layoutElement/src/auroElement.js"
1082
+ }
980
1083
  },
981
1084
  {
982
- "description": "Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.",
983
- "name": "change",
984
- "deprecated": "Use the `input` event instead."
1085
+ "kind": "field",
1086
+ "name": "optionSelected",
1087
+ "privacy": "public",
1088
+ "type": {
1089
+ "text": "HTMLElement"
1090
+ },
1091
+ "description": "Specifies the current selected option."
985
1092
  },
986
1093
  {
987
- "description": "Notifies when when checked value is changed by user's interface.",
988
- "name": "input"
989
- }
990
- ],
991
- "attributes": [
1094
+ "kind": "field",
1095
+ "name": "persistInput",
1096
+ "privacy": "public",
1097
+ "type": {
1098
+ "text": "boolean"
1099
+ },
1100
+ "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.",
1101
+ "attribute": "persistinput",
1102
+ "reflects": true
1103
+ },
992
1104
  {
993
- "name": "appearance",
1105
+ "kind": "field",
1106
+ "name": "placement",
1107
+ "privacy": "public",
1108
+ "type": {
1109
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1110
+ },
1111
+ "description": "Position where the bib should appear relative to the trigger.",
1112
+ "default": "'bottom-start'",
1113
+ "attribute": "placement",
1114
+ "reflects": true
1115
+ },
1116
+ {
1117
+ "kind": "field",
1118
+ "name": "placeholder",
1119
+ "privacy": "public",
994
1120
  "type": {
995
- "text": "'default' | 'inverse'"
1121
+ "text": "string"
996
1122
  },
997
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
998
- "default": "'default'",
999
- "fieldName": "appearance"
1123
+ "description": "Define custom placeholder text, only supported by date input formats.",
1124
+ "attribute": "placeholder",
1125
+ "reflects": true
1000
1126
  },
1001
1127
  {
1002
- "name": "checked",
1128
+ "kind": "field",
1129
+ "name": "required",
1130
+ "privacy": "public",
1003
1131
  "type": {
1004
1132
  "text": "boolean"
1005
1133
  },
1006
- "description": "If set to true, the checkbox will be filled with a checkmark.",
1007
- "fieldName": "checked"
1134
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1135
+ "attribute": "required",
1136
+ "reflects": true
1008
1137
  },
1009
1138
  {
1010
- "name": "disabled",
1139
+ "kind": "field",
1140
+ "name": "setCustomValidity",
1141
+ "privacy": "public",
1011
1142
  "type": {
1012
- "text": "boolean"
1143
+ "text": "string"
1013
1144
  },
1014
- "description": "If set to true, the checkbox will not be clickable.",
1015
- "fieldName": "disabled"
1145
+ "description": "Sets a custom help text message to display for all validityStates.",
1146
+ "attribute": "setcustomvalidity"
1016
1147
  },
1017
1148
  {
1018
- "name": "error",
1149
+ "kind": "field",
1150
+ "name": "setCustomValidityCustomError",
1151
+ "privacy": "public",
1019
1152
  "type": {
1020
- "text": "boolean"
1153
+ "text": "string"
1021
1154
  },
1022
- "description": "If set to true, the checkbox will be displayed with an error state.",
1023
- "fieldName": "error"
1155
+ "description": "Custom help text message to display when validity = `customError`.",
1156
+ "attribute": "setcustomvaliditycustomerror"
1024
1157
  },
1025
1158
  {
1026
- "name": "id",
1159
+ "kind": "field",
1160
+ "name": "setCustomValidityValueMissing",
1161
+ "privacy": "public",
1027
1162
  "type": {
1028
1163
  "text": "string"
1029
1164
  },
1030
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
1031
- "fieldName": "id"
1165
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1166
+ "attribute": "setcustomvalidityvaluemissing"
1032
1167
  },
1033
1168
  {
1034
- "name": "name",
1169
+ "kind": "field",
1170
+ "name": "setCustomValidityValueMissingFilter",
1171
+ "privacy": "public",
1035
1172
  "type": {
1036
1173
  "text": "string"
1037
1174
  },
1038
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
1039
- "fieldName": "name"
1175
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1176
+ "attribute": "setcustomvalidityvaluemissingfilter"
1040
1177
  },
1041
1178
  {
1042
- "name": "ondark",
1179
+ "kind": "field",
1180
+ "name": "touched",
1181
+ "privacy": "private",
1043
1182
  "type": {
1044
1183
  "text": "boolean"
1045
1184
  },
1046
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1047
- "deprecated": "Use `appearance=\"inverse\"` instead.",
1048
- "fieldName": "onDark"
1185
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1049
1186
  },
1050
1187
  {
1051
- "name": "value",
1188
+ "kind": "field",
1189
+ "name": "triggerIcon",
1190
+ "privacy": "public",
1052
1191
  "type": {
1053
- "text": "string"
1192
+ "text": "boolean"
1054
1193
  },
1055
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1056
- "fieldName": "value"
1194
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.\nIcon rendering is currently limited to `type=\"credit-card\"`. Setting `triggerIcon`\nwithout a supported `type` propagates the attribute but does not render a visible icon.",
1195
+ "attribute": "triggericon",
1196
+ "reflects": true
1057
1197
  },
1058
1198
  {
1059
- "name": "tabindex",
1199
+ "kind": "field",
1200
+ "name": "type",
1201
+ "privacy": "public",
1060
1202
  "type": {
1061
- "text": "number"
1203
+ "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
1062
1204
  },
1063
- "description": "The tabindex attribute for the checkbox.",
1064
- "fieldName": "tabIndex"
1205
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1206
+ "attribute": "type",
1207
+ "reflects": true
1065
1208
  },
1066
1209
  {
1067
- "name": "aria-checked",
1210
+ "kind": "field",
1211
+ "name": "typedValue",
1212
+ "privacy": "public",
1068
1213
  "type": {
1069
1214
  "text": "string"
1070
1215
  },
1071
- "description": "The aria-checked attribute for the checkbox.",
1072
- "fieldName": "ariaChecked"
1216
+ "description": "Specifies the value of the input element within the combobox.",
1217
+ "attribute": "typedvalue",
1218
+ "reflects": true
1073
1219
  },
1074
1220
  {
1075
- "name": "aria-disabled",
1221
+ "kind": "field",
1222
+ "name": "validity",
1223
+ "privacy": "public",
1076
1224
  "type": {
1077
1225
  "text": "string"
1078
1226
  },
1079
- "description": "The aria-disabled attribute for the checkbox.",
1080
- "fieldName": "ariaDisabled"
1227
+ "description": "Specifies the `validityState` this element is in.",
1228
+ "attribute": "validity",
1229
+ "reflects": true
1081
1230
  },
1082
1231
  {
1083
- "name": "role",
1232
+ "kind": "field",
1233
+ "name": "value",
1234
+ "privacy": "public",
1084
1235
  "type": {
1085
1236
  "text": "string"
1086
1237
  },
1087
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
1088
- "fieldName": "role"
1089
- }
1090
- ],
1091
- "superclass": {
1092
- "name": "LitElement",
1093
- "package": "lit"
1094
- },
1095
- "tagName": "auro-checkbox",
1096
- "customElement": true
1097
- }
1098
- ],
1099
- "exports": [
1100
- {
1101
- "kind": "js",
1102
- "name": "AuroCheckbox",
1103
- "declaration": {
1104
- "name": "AuroCheckbox",
1105
- "module": "components/checkbox/src/auro-checkbox.js"
1106
- }
1107
- }
1108
- ]
1109
- },
1110
- {
1111
- "kind": "javascript-module",
1112
- "path": "components/checkbox/src/index.js",
1113
- "declarations": [],
1114
- "exports": [
1115
- {
1116
- "kind": "js",
1117
- "name": "AuroCheckbox",
1118
- "declaration": {
1119
- "name": "AuroCheckbox",
1120
- "module": "components/checkbox/src/index.js"
1121
- }
1122
- },
1123
- {
1124
- "kind": "js",
1125
- "name": "AuroCheckboxGroup",
1126
- "declaration": {
1127
- "name": "AuroCheckboxGroup",
1128
- "module": "components/checkbox/src/index.js"
1129
- }
1130
- }
1131
- ]
1132
- },
1133
- {
1134
- "kind": "javascript-module",
1135
- "path": "components/checkbox/src/registered.js",
1136
- "declarations": [],
1137
- "exports": []
1138
- },
1139
- {
1140
- "kind": "javascript-module",
1141
- "path": "components/combobox/src/auro-combobox.js",
1142
- "declarations": [
1143
- {
1144
- "kind": "class",
1145
- "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.",
1146
- "name": "AuroCombobox",
1147
- "cssParts": [
1148
- {
1149
- "description": "The help text and error message content container.",
1150
- "name": "helpText"
1151
- }
1152
- ],
1153
- "slots": [
1154
- {
1155
- "description": "Default slot for the menu content.",
1156
- "name": ""
1238
+ "description": "Value selected for the dropdown menu. When set programmatically or as a preset attribute, the value must match a selectable option. If it matches an option marked `disabled` or `static`, the selection is rejected: `value` and `optionSelected` are cleared to `undefined`. `hidden` options (including those filtered out by type-ahead) remain selectable by value.",
1239
+ "attribute": "value"
1157
1240
  },
1158
1241
  {
1242
+ "kind": "field",
1243
+ "name": "largeFullscreenHeadline",
1244
+ "privacy": "public",
1159
1245
  "type": {
1160
- "text": "HTMLSlotElement"
1246
+ "text": "boolean"
1161
1247
  },
1162
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1163
- "name": "optionalLabel"
1164
- },
1165
- {
1166
- "description": "Sets aria-label on clear button",
1167
- "name": "ariaLabel.input.clear"
1168
- },
1169
- {
1170
- "description": "Sets aria-label on close button in fullscreen bib",
1171
- "name": "ariaLabel.bib.close"
1172
- },
1173
- {
1174
- "description": "Defines the headline to display above menu-options",
1175
- "name": "bib.fullscreen.headline"
1176
- },
1177
- {
1178
- "description": "Defines the content of the label.",
1179
- "name": "label"
1180
- },
1181
- {
1182
- "description": "Defines the content of the helpText.",
1183
- "name": "helpText"
1184
- },
1185
- {
1186
- "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
1187
- "name": "displayValue"
1188
- }
1189
- ],
1190
- "members": [
1191
- {
1192
- "kind": "method",
1193
- "name": "_initializeDefaults",
1194
- "privacy": "private",
1195
- "return": {
1196
- "type": {
1197
- "text": "void"
1198
- }
1199
- }
1248
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1249
+ "attribute": "largefullscreenheadline",
1250
+ "reflects": true
1200
1251
  },
1201
1252
  {
1202
- "kind": "method",
1203
- "name": "_scheduleTimer",
1204
- "parameters": [
1205
- {
1206
- "name": "fn",
1207
- "description": "Callback to run.",
1208
- "type": {
1209
- "text": "Function"
1210
- }
1211
- },
1212
- {
1213
- "name": "ms",
1214
- "description": "Delay in milliseconds.",
1215
- "type": {
1216
- "text": "number"
1217
- }
1218
- }
1219
- ],
1220
- "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.",
1221
- "return": {
1222
- "type": {
1223
- "text": "number"
1224
- }
1253
+ "kind": "field",
1254
+ "name": "fullscreenBreakpoint",
1255
+ "privacy": "public",
1256
+ "type": {
1257
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1225
1258
  },
1226
- "privacy": "private"
1259
+ "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.",
1260
+ "default": "'sm'",
1261
+ "attribute": "fullscreenbreakpoint",
1262
+ "reflects": true
1227
1263
  },
1228
1264
  {
1229
1265
  "kind": "field",
1230
- "name": "inputValue",
1231
- "description": "Returns the current value of the input element within the combobox.",
1232
- "return": {
1233
- "type": {
1234
- "text": "string|undefined"
1235
- }
1266
+ "name": "optionActive",
1267
+ "privacy": "private",
1268
+ "type": {
1269
+ "text": "HTMLElement"
1236
1270
  },
1237
- "readonly": true
1271
+ "description": "Specifies the currently active option."
1238
1272
  },
1239
1273
  {
1240
- "kind": "method",
1241
- "name": "isValid",
1242
- "description": "Checks if the element is valid.",
1274
+ "kind": "field",
1275
+ "name": "componentHasFocus",
1276
+ "description": "Returns true if the element has focus.",
1277
+ "privacy": "private",
1243
1278
  "return": {
1244
1279
  "type": {
1245
1280
  "text": "boolean"
1246
1281
  }
1282
+ },
1283
+ "readonly": true,
1284
+ "inheritedFrom": {
1285
+ "name": "AuroElement",
1286
+ "module": "components/layoutElement/src/auroElement.js"
1247
1287
  }
1248
1288
  },
1249
1289
  {
1250
1290
  "kind": "method",
1251
- "name": "register",
1252
- "static": true,
1253
- "parameters": [
1254
- {
1255
- "name": "name",
1256
- "default": "'auro-combobox'",
1257
- "description": "The name of the element that you want to register.",
1258
- "optional": true,
1259
- "type": {
1260
- "text": "string"
1261
- }
1262
- }
1263
- ],
1264
- "description": "This will register this element with the browser."
1265
- },
1266
- {
1267
- "kind": "method",
1268
- "name": "activateFirstEnabledAvailableOption",
1269
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
1270
- "privacy": "private",
1271
- "return": {
1272
- "type": {
1273
- "text": "void"
1274
- }
1291
+ "name": "resetShapeClasses",
1292
+ "inheritedFrom": {
1293
+ "name": "AuroElement",
1294
+ "module": "components/layoutElement/src/auroElement.js"
1275
1295
  }
1276
1296
  },
1277
1297
  {
1278
1298
  "kind": "method",
1279
- "name": "activateLastEnabledAvailableOption",
1280
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
1281
- "privacy": "private",
1282
- "return": {
1283
- "type": {
1284
- "text": "void"
1285
- }
1299
+ "name": "resetLayoutClasses",
1300
+ "inheritedFrom": {
1301
+ "name": "AuroElement",
1302
+ "module": "components/layoutElement/src/auroElement.js"
1286
1303
  }
1287
1304
  },
1288
1305
  {
1289
1306
  "kind": "method",
1290
- "name": "updateFilter",
1291
- "description": "Updates the filter for the available options based on the input value.",
1292
- "privacy": "private"
1293
- },
1294
- {
1295
- "kind": "method",
1296
- "name": "syncValuesAndStates",
1297
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1298
- "privacy": "private",
1299
- "return": {
1300
- "type": {
1301
- "text": "void"
1302
- }
1307
+ "name": "updateComponentArchitecture",
1308
+ "inheritedFrom": {
1309
+ "name": "AuroElement",
1310
+ "module": "components/layoutElement/src/auroElement.js"
1303
1311
  }
1304
- },
1312
+ }
1313
+ ],
1314
+ "events": [
1305
1315
  {
1306
- "kind": "method",
1307
- "name": "updateTriggerTextDisplay",
1308
- "parameters": [
1309
- {
1310
- "name": "label",
1311
- "description": "The label of the selected option.",
1312
- "type": {
1313
- "text": "string"
1314
- }
1315
- }
1316
- ],
1317
- "description": "Update displayValue or input.value, it's called when making a selection.",
1318
- "privacy": "private"
1316
+ "name": "inputValue",
1317
+ "type": {
1318
+ "text": "CustomEvent"
1319
+ },
1320
+ "description": "Notifies that the components internal HTML5 input value has changed."
1319
1321
  },
1320
1322
  {
1321
- "kind": "method",
1322
- "name": "syncInputValuesAcrossTriggerAndBib",
1323
- "parameters": [
1324
- {
1325
- "name": "nextValue",
1326
- "description": "The value to write to both inputs.",
1327
- "type": {
1328
- "text": "string"
1329
- }
1330
- }
1331
- ],
1332
- "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.",
1333
- "return": {
1334
- "type": {
1335
- "text": "Promise<void>"
1336
- }
1323
+ "name": "input",
1324
+ "type": {
1325
+ "text": "CustomEvent"
1337
1326
  },
1338
- "privacy": "private"
1327
+ "description": "Notifies that the component has a new value set."
1339
1328
  },
1340
1329
  {
1341
- "kind": "method",
1342
- "name": "handleMenuOptions",
1343
- "parameters": [
1344
- {
1345
- "name": "{ preferComboboxValue = false }",
1346
- "default": "{}"
1347
- },
1348
- {
1349
- "description": "Optional flag bag.",
1350
- "name": "options",
1351
- "optional": true,
1352
- "type": {
1353
- "text": "@param {boolean} [options.preferComboboxValue=false] - When true,\n * handleMenuOptions matches the selected option against `this.value`\n * first instead of `this.input.value`. Needed on mount and re-mount\n * because under `persistInput` the consumer's typedValue prop can drift\n * from the framework value (Svelte `{#key}` re-mount after a swap, or\n * SPA preselect after route change) and the old input-first match would\n * then pick the stale text. Only handleSlotChange passes this; typing\n * and clearing paths keep the input-first match so user clears aren't\n * undone.\n * "
1354
- }
1355
- }
1356
- ],
1357
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1358
- "privacy": "private",
1359
- "return": {
1360
- "type": {
1361
- "text": "void"
1362
- }
1363
- }
1330
+ "name": "auroCombobox-valueSet",
1331
+ "type": {
1332
+ "text": "CustomEvent"
1333
+ },
1334
+ "description": "Notifies that the component has a new value set. **DEPRECATED** - Use the `input` event instead.",
1335
+ "deprecated": "Use the `input` event instead."
1364
1336
  },
1365
1337
  {
1366
- "kind": "method",
1367
- "name": "generateOptionsArray",
1368
- "description": "Determines the element error state based on the `required` attribute and input value.",
1369
- "privacy": "private",
1370
- "return": {
1371
- "type": {
1372
- "text": "void"
1373
- }
1374
- }
1338
+ "description": "Notifies that the component value(s) have been validated.",
1339
+ "name": "auroFormElement-validated"
1340
+ }
1341
+ ],
1342
+ "attributes": [
1343
+ {
1344
+ "name": "appearance",
1345
+ "type": {
1346
+ "text": "'default' | 'inverse'"
1347
+ },
1348
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1349
+ "default": "'default'",
1350
+ "fieldName": "appearance"
1375
1351
  },
1376
1352
  {
1377
- "kind": "method",
1378
- "name": "hideBib",
1379
- "description": "Hides the dropdown bib if its open.",
1380
- "return": {
1381
- "type": {
1382
- "text": "void"
1383
- }
1384
- }
1353
+ "name": "autocomplete",
1354
+ "type": {
1355
+ "text": "string"
1356
+ },
1357
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1358
+ "fieldName": "autocomplete"
1385
1359
  },
1386
1360
  {
1387
- "kind": "method",
1388
- "name": "showBib",
1389
- "description": "Shows the dropdown bib if there are options to show.",
1390
- "return": {
1391
- "type": {
1392
- "text": "void"
1393
- }
1394
- }
1361
+ "name": "autoplacement",
1362
+ "type": {
1363
+ "text": "boolean"
1364
+ },
1365
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1366
+ "fieldName": "autoPlacement"
1395
1367
  },
1396
1368
  {
1397
- "kind": "method",
1398
- "name": "configureDropdown",
1399
- "description": "Binds all behavior needed to the dropdown after rendering.",
1400
- "privacy": "private",
1401
- "return": {
1402
- "type": {
1403
- "text": "void"
1404
- }
1405
- }
1369
+ "name": "behavior",
1370
+ "type": {
1371
+ "text": "'filter' | 'suggestion'"
1372
+ },
1373
+ "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.",
1374
+ "default": "'suggestion'",
1375
+ "fieldName": "behavior"
1406
1376
  },
1407
1377
  {
1408
- "kind": "method",
1409
- "name": "setClearBtnFocus",
1410
- "privacy": "private"
1378
+ "name": "checkmark",
1379
+ "type": {
1380
+ "text": "boolean"
1381
+ },
1382
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1383
+ "fieldName": "checkmark"
1411
1384
  },
1412
1385
  {
1413
- "kind": "method",
1414
- "name": "setTriggerInputFocus",
1415
- "privacy": "private"
1386
+ "name": "disabled",
1387
+ "type": {
1388
+ "text": "boolean"
1389
+ },
1390
+ "description": "If set, disables the combobox.",
1391
+ "fieldName": "disabled"
1416
1392
  },
1417
1393
  {
1418
- "kind": "method",
1419
- "name": "setInputFocus",
1420
- "privacy": "private"
1394
+ "name": "dvinputonly",
1395
+ "type": {
1396
+ "text": "boolean"
1397
+ },
1398
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1399
+ "fieldName": "dvInputOnly"
1421
1400
  },
1422
1401
  {
1423
- "kind": "method",
1424
- "name": "updateBibDialogRole",
1425
- "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.",
1426
- "privacy": "private"
1402
+ "name": "error",
1403
+ "type": {
1404
+ "text": "string"
1405
+ },
1406
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1407
+ "fieldName": "error"
1427
1408
  },
1428
1409
  {
1429
- "kind": "method",
1430
- "name": "updateMenuShapeSize",
1431
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1432
- "privacy": "private"
1410
+ "name": "format",
1411
+ "type": {
1412
+ "text": "string"
1413
+ },
1414
+ "description": "Specifies the input mask format.",
1415
+ "fieldName": "format"
1433
1416
  },
1434
1417
  {
1435
- "kind": "method",
1436
- "name": "_getAnnouncementRoot",
1437
- "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.",
1438
- "privacy": "private",
1439
- "return": {
1440
- "type": {
1441
- "text": "ShadowRoot"
1442
- }
1443
- }
1418
+ "name": "inputmode",
1419
+ "type": {
1420
+ "text": "string"
1421
+ },
1422
+ "description": "Exposes inputmode attribute for input.",
1423
+ "fieldName": "inputmode"
1444
1424
  },
1445
1425
  {
1446
- "kind": "method",
1447
- "name": "configureMenu",
1448
- "description": "Binds all behavior needed to the menu after rendering.",
1449
- "privacy": "private",
1450
- "return": {
1451
- "type": {
1452
- "text": "void"
1453
- }
1454
- }
1426
+ "name": "layout",
1427
+ "type": {
1428
+ "text": "'classic' | 'emphasized' | 'snowflake'"
1429
+ },
1430
+ "description": "Sets the layout of the combobox.",
1431
+ "default": "'classic'",
1432
+ "fieldName": "layout"
1455
1433
  },
1456
1434
  {
1457
- "kind": "method",
1458
- "name": "configureInput",
1459
- "description": "Binds all behavior needed to the input after rendering.",
1460
- "privacy": "private",
1461
- "return": {
1462
- "type": {
1463
- "text": "void"
1464
- }
1465
- }
1435
+ "name": "shape",
1436
+ "type": {
1437
+ "text": "'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'"
1438
+ },
1439
+ "description": "Sets the shape of the combobox.",
1440
+ "default": "'classic'",
1441
+ "fieldName": "shape"
1466
1442
  },
1467
1443
  {
1468
- "kind": "method",
1469
- "name": "handleMenuLoadingChange",
1470
- "parameters": [
1471
- {
1472
- "name": "event",
1473
- "description": "The event object containing details about the loading state change.",
1474
- "type": {
1475
- "text": "CustomEvent"
1476
- }
1477
- },
1478
- {
1479
- "description": "Indicates whether the menu is currently loading.",
1480
- "name": "event.detail.loading",
1481
- "type": {
1482
- "text": "boolean"
1483
- }
1484
- },
1485
- {
1486
- "description": "Indicates if there are loading placeholders present.",
1487
- "name": "event.detail.hasLoadingPlaceholder",
1488
- "type": {
1489
- "text": "boolean"
1490
- }
1491
- }
1492
- ],
1493
- "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.",
1494
- "privacy": "private",
1495
- "return": {
1496
- "type": {
1497
- "text": "void"
1498
- }
1499
- }
1444
+ "name": "size",
1445
+ "type": {
1446
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
1447
+ },
1448
+ "description": "Sets the size of the combobox.",
1449
+ "default": "'xl'",
1450
+ "fieldName": "size"
1500
1451
  },
1501
1452
  {
1502
- "kind": "method",
1503
- "name": "handleInputValueChange",
1504
- "parameters": [
1505
- {
1506
- "name": "event",
1507
- "description": "The input event triggered by the input element.",
1508
- "type": {
1509
- "text": "Event"
1510
- }
1511
- }
1512
- ],
1513
- "description": "Handle changes to the input value and trigger changes that should result.",
1514
- "privacy": "private",
1515
- "return": {
1516
- "type": {
1517
- "text": "void"
1518
- }
1519
- }
1453
+ "name": "matchwidth",
1454
+ "type": {
1455
+ "text": "boolean"
1456
+ },
1457
+ "description": "If declared, the popover and trigger will be set to the same width.",
1458
+ "fieldName": "matchWidth"
1520
1459
  },
1521
1460
  {
1522
- "kind": "method",
1523
- "name": "handleTriggerInputValueChange",
1524
- "parameters": [
1525
- {
1526
- "name": "event",
1527
- "description": "The input event from the trigger input element.",
1528
- "type": {
1529
- "text": "Event"
1530
- }
1531
- }
1532
- ],
1533
- "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.",
1534
- "privacy": "private",
1535
- "return": {
1536
- "type": {
1537
- "text": "void"
1538
- }
1539
- }
1461
+ "name": "nofilter",
1462
+ "type": {
1463
+ "text": "boolean"
1464
+ },
1465
+ "description": "If set, combobox will not filter menuoptions based on input.",
1466
+ "fieldName": "noFilter"
1540
1467
  },
1541
1468
  {
1542
- "kind": "method",
1543
- "name": "configureCombobox",
1544
- "description": "Binds all behavior needed to the combobox after rendering.",
1545
- "privacy": "private",
1546
- "return": {
1547
- "type": {
1548
- "text": "void"
1549
- }
1550
- }
1469
+ "name": "noflip",
1470
+ "type": {
1471
+ "text": "boolean"
1472
+ },
1473
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1474
+ "fieldName": "noFlip"
1551
1475
  },
1552
1476
  {
1553
- "kind": "method",
1554
- "name": "focus",
1555
- "description": "Focuses the combobox trigger input.",
1556
- "return": {
1557
- "type": {
1558
- "text": "void"
1559
- }
1560
- }
1477
+ "name": "shift",
1478
+ "type": {
1479
+ "text": "boolean"
1480
+ },
1481
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1482
+ "fieldName": "shift"
1561
1483
  },
1562
1484
  {
1563
- "kind": "method",
1564
- "name": "setMenuValue",
1565
- "parameters": [
1566
- {
1567
- "name": "value",
1568
- "description": "The value to set on the menu.",
1569
- "type": {
1570
- "text": "string"
1571
- }
1572
- }
1573
- ],
1574
- "description": "Sets the menu value if menu is available.",
1575
- "return": {
1576
- "type": {
1577
- "text": "void"
1578
- }
1579
- }
1485
+ "name": "novalidate",
1486
+ "type": {
1487
+ "text": "boolean"
1488
+ },
1489
+ "description": "If set, disables auto-validation on blur.",
1490
+ "fieldName": "noValidate"
1580
1491
  },
1581
1492
  {
1582
- "kind": "method",
1583
- "name": "reset",
1584
- "description": "Resets component to initial state.",
1585
- "return": {
1586
- "type": {
1587
- "text": "void"
1588
- }
1589
- }
1493
+ "name": "offset",
1494
+ "type": {
1495
+ "text": "number"
1496
+ },
1497
+ "description": "Gap between the trigger element and bib.",
1498
+ "default": "0",
1499
+ "fieldName": "offset"
1590
1500
  },
1591
1501
  {
1592
- "kind": "method",
1593
- "name": "clear",
1594
- "description": "Clears the current value of the combobox.",
1595
- "return": {
1596
- "type": {
1597
- "text": "void"
1598
- }
1502
+ "name": "ondark",
1503
+ "type": {
1504
+ "text": "boolean"
1505
+ },
1506
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1507
+ "fieldName": "onDark",
1508
+ "deprecated": "Use `appearance=\"inverse\"` instead.",
1509
+ "inheritedFrom": {
1510
+ "name": "AuroElement",
1511
+ "module": "components/layoutElement/src/auroElement.js"
1599
1512
  }
1600
1513
  },
1601
1514
  {
1602
- "kind": "method",
1603
- "name": "validate",
1604
- "parameters": [
1605
- {
1606
- "name": "force",
1607
- "default": "false",
1608
- "description": "Whether to force validation.",
1609
- "optional": true,
1610
- "type": {
1611
- "text": "boolean"
1612
- }
1613
- }
1614
- ],
1615
- "description": "Validates value."
1515
+ "name": "persistinput",
1516
+ "type": {
1517
+ "text": "boolean"
1518
+ },
1519
+ "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.",
1520
+ "fieldName": "persistInput"
1521
+ },
1522
+ {
1523
+ "name": "placement",
1524
+ "type": {
1525
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1526
+ },
1527
+ "description": "Position where the bib should appear relative to the trigger.",
1528
+ "default": "'bottom-start'",
1529
+ "fieldName": "placement"
1616
1530
  },
1617
1531
  {
1618
- "kind": "method",
1619
- "name": "transportAssignedNodes",
1620
- "parameters": [
1621
- {
1622
- "name": "slot",
1623
- "description": "The slot element containing the nodes to apply.",
1624
- "type": {
1625
- "text": "HTMLSlotElement"
1626
- }
1627
- },
1628
- {
1629
- "name": "target",
1630
- "description": "The target element to apply the nodes to.",
1631
- "type": {
1632
- "text": "HTMLElement"
1633
- }
1634
- },
1635
- {
1636
- "name": "newSlotName",
1637
- "description": "The new slot name for the applied nodes.",
1638
- "type": {
1639
- "text": "string"
1640
- }
1641
- }
1642
- ],
1643
- "description": "Applies slotted nodes to a target element with a new slot name.",
1644
- "privacy": "private",
1645
- "return": {
1646
- "type": {
1647
- "text": "void"
1648
- }
1649
- }
1532
+ "name": "placeholder",
1533
+ "type": {
1534
+ "text": "string"
1535
+ },
1536
+ "description": "Define custom placeholder text, only supported by date input formats.",
1537
+ "fieldName": "placeholder"
1650
1538
  },
1651
1539
  {
1652
- "kind": "method",
1653
- "name": "updateActiveOption",
1654
- "parameters": [
1655
- {
1656
- "name": "index",
1657
- "description": "Index of the option to make active.",
1658
- "type": {
1659
- "text": "number"
1660
- }
1661
- }
1662
- ],
1663
- "description": "Updates the active option in the menu."
1540
+ "name": "required",
1541
+ "type": {
1542
+ "text": "boolean"
1543
+ },
1544
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1545
+ "fieldName": "required"
1664
1546
  },
1665
1547
  {
1666
- "kind": "method",
1667
- "name": "handleSlotChange",
1668
- "parameters": [
1669
- {
1670
- "name": "event",
1671
- "description": "`slotchange` event.",
1672
- "type": {
1673
- "text": "Event"
1674
- }
1675
- }
1676
- ],
1677
- "description": "Watch for slot changes and recalculate the menuoptions.",
1678
- "privacy": "private",
1679
- "return": {
1680
- "type": {
1681
- "text": "void"
1682
- }
1683
- }
1548
+ "name": "setcustomvalidity",
1549
+ "type": {
1550
+ "text": "string"
1551
+ },
1552
+ "description": "Sets a custom help text message to display for all validityStates.",
1553
+ "fieldName": "setCustomValidity"
1684
1554
  },
1685
1555
  {
1686
- "kind": "field",
1687
- "name": "appearance",
1688
- "privacy": "public",
1556
+ "name": "setcustomvaliditycustomerror",
1689
1557
  "type": {
1690
- "text": "'default' | 'inverse'"
1558
+ "text": "string"
1691
1559
  },
1692
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1693
- "default": "'default'",
1694
- "attribute": "appearance",
1695
- "reflects": true
1560
+ "description": "Custom help text message to display when validity = `customError`.",
1561
+ "fieldName": "setCustomValidityCustomError"
1696
1562
  },
1697
1563
  {
1698
- "kind": "field",
1699
- "name": "autocomplete",
1700
- "privacy": "public",
1564
+ "name": "setcustomvalidityvaluemissing",
1701
1565
  "type": {
1702
1566
  "text": "string"
1703
1567
  },
1704
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1705
- "attribute": "autocomplete",
1706
- "reflects": true
1568
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1569
+ "fieldName": "setCustomValidityValueMissing"
1707
1570
  },
1708
1571
  {
1709
- "kind": "field",
1710
- "name": "autoPlacement",
1711
- "privacy": "public",
1572
+ "name": "setcustomvalidityvaluemissingfilter",
1573
+ "type": {
1574
+ "text": "string"
1575
+ },
1576
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1577
+ "fieldName": "setCustomValidityValueMissingFilter"
1578
+ },
1579
+ {
1580
+ "name": "triggericon",
1712
1581
  "type": {
1713
1582
  "text": "boolean"
1714
1583
  },
1715
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1716
- "attribute": "autoplacement",
1717
- "reflects": true
1584
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.\nIcon rendering is currently limited to `type=\"credit-card\"`. Setting `triggerIcon`\nwithout a supported `type` propagates the attribute but does not render a visible icon.",
1585
+ "fieldName": "triggerIcon"
1718
1586
  },
1719
1587
  {
1720
- "kind": "field",
1721
- "name": "availableOptions",
1722
- "privacy": "private",
1588
+ "name": "type",
1723
1589
  "type": {
1724
- "text": "HTMLElement[]"
1590
+ "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
1725
1591
  },
1726
- "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value)."
1592
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1593
+ "fieldName": "type"
1727
1594
  },
1728
1595
  {
1729
- "kind": "field",
1730
- "name": "behavior",
1731
- "privacy": "public",
1596
+ "name": "typedvalue",
1732
1597
  "type": {
1733
- "text": "'filter' | 'suggestion'"
1598
+ "text": "string"
1734
1599
  },
1735
- "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.",
1736
- "default": "'suggestion'",
1737
- "attribute": "behavior",
1738
- "reflects": true
1600
+ "description": "Specifies the value of the input element within the combobox.",
1601
+ "fieldName": "typedValue"
1739
1602
  },
1740
1603
  {
1741
- "kind": "field",
1742
- "name": "checkmark",
1743
- "privacy": "public",
1604
+ "name": "validity",
1744
1605
  "type": {
1745
- "text": "boolean"
1606
+ "text": "string"
1746
1607
  },
1747
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1748
- "attribute": "checkmark",
1749
- "reflects": true
1608
+ "description": "Specifies the `validityState` this element is in.",
1609
+ "fieldName": "validity"
1750
1610
  },
1751
1611
  {
1752
- "kind": "field",
1753
- "name": "disabled",
1754
- "privacy": "public",
1612
+ "name": "value",
1613
+ "type": {
1614
+ "text": "string"
1615
+ },
1616
+ "description": "Value selected for the dropdown menu. When set programmatically or as a preset attribute, the value must match a selectable option. If it matches an option marked `disabled` or `static`, the selection is rejected: `value` and `optionSelected` are cleared to `undefined`. `hidden` options (including those filtered out by type-ahead) remain selectable by value.",
1617
+ "fieldName": "value"
1618
+ },
1619
+ {
1620
+ "name": "largefullscreenheadline",
1755
1621
  "type": {
1756
1622
  "text": "boolean"
1757
1623
  },
1758
- "description": "If set, disables the combobox.",
1759
- "attribute": "disabled",
1760
- "reflects": true
1624
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1625
+ "fieldName": "largeFullscreenHeadline"
1761
1626
  },
1762
1627
  {
1763
- "kind": "field",
1764
- "name": "dropdownId",
1765
- "privacy": "private",
1766
- "type": {
1767
- "text": "string"
1768
- },
1769
- "description": "ID for the dropdown."
1770
- },
1628
+ "name": "fullscreenbreakpoint",
1629
+ "type": {
1630
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1631
+ },
1632
+ "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.",
1633
+ "default": "'sm'",
1634
+ "fieldName": "fullscreenBreakpoint"
1635
+ }
1636
+ ],
1637
+ "superclass": {
1638
+ "name": "AuroElement",
1639
+ "module": "/components/layoutElement/src/auroElement.js"
1640
+ },
1641
+ "tagName": "auro-combobox",
1642
+ "customElement": true
1643
+ }
1644
+ ],
1645
+ "exports": [
1646
+ {
1647
+ "kind": "js",
1648
+ "name": "AuroCombobox",
1649
+ "declaration": {
1650
+ "name": "AuroCombobox",
1651
+ "module": "components/combobox/src/auro-combobox.js"
1652
+ }
1653
+ }
1654
+ ]
1655
+ },
1656
+ {
1657
+ "kind": "javascript-module",
1658
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1659
+ "declarations": [
1660
+ {
1661
+ "kind": "variable",
1662
+ "name": "comboboxKeyboardStrategy",
1663
+ "type": {
1664
+ "text": "object"
1665
+ },
1666
+ "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)) { if (evt.shiftKey) { if (selectAndExitBackward(component)) { evt.preventDefault(); } return; } selectAndClose(component); if (ctx.isModal) { // Fullscreen close does not automatically restore focus to the input. component.setClearBtnFocus(); } } } }"
1667
+ }
1668
+ ],
1669
+ "exports": [
1670
+ {
1671
+ "kind": "js",
1672
+ "name": "comboboxKeyboardStrategy",
1673
+ "declaration": {
1674
+ "name": "comboboxKeyboardStrategy",
1675
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1676
+ }
1677
+ }
1678
+ ]
1679
+ },
1680
+ {
1681
+ "kind": "javascript-module",
1682
+ "path": "components/combobox/src/index.js",
1683
+ "declarations": [],
1684
+ "exports": [
1685
+ {
1686
+ "kind": "js",
1687
+ "name": "AuroCombobox",
1688
+ "declaration": {
1689
+ "name": "AuroCombobox",
1690
+ "module": "components/combobox/src/index.js"
1691
+ }
1692
+ }
1693
+ ]
1694
+ },
1695
+ {
1696
+ "kind": "javascript-module",
1697
+ "path": "components/combobox/src/registered.js",
1698
+ "declarations": [],
1699
+ "exports": [
1700
+ {
1701
+ "kind": "js",
1702
+ "name": "AuroCombobox",
1703
+ "declaration": {
1704
+ "name": "AuroCombobox",
1705
+ "module": "components/combobox/src/registered.js"
1706
+ }
1707
+ }
1708
+ ]
1709
+ },
1710
+ {
1711
+ "kind": "javascript-module",
1712
+ "path": "components/checkbox/src/auro-checkbox-group.js",
1713
+ "declarations": [
1714
+ {
1715
+ "kind": "class",
1716
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1717
+ "name": "AuroCheckboxGroup",
1718
+ "cssParts": [
1719
+ {
1720
+ "description": "Apply css to the help text element that displays helper or error messages.",
1721
+ "name": "helpText"
1722
+ }
1723
+ ],
1724
+ "slots": [
1771
1725
  {
1772
- "kind": "field",
1773
- "name": "dropdownOpen",
1774
- "privacy": "private",
1775
- "type": {
1776
- "text": "boolean"
1777
- },
1778
- "description": "Whether or not the dropdown is open."
1726
+ "description": "Allows for the legend to be overridden.",
1727
+ "name": "legend"
1779
1728
  },
1780
1729
  {
1781
- "kind": "field",
1782
- "name": "dvInputOnly",
1783
- "privacy": "public",
1784
- "type": {
1785
- "text": "boolean"
1786
- },
1787
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1788
- "attribute": "dvinputonly",
1789
- "reflects": true
1730
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1731
+ "name": "optionalLabel"
1790
1732
  },
1791
1733
  {
1792
- "kind": "field",
1793
- "name": "error",
1794
- "privacy": "public",
1795
- "type": {
1796
- "text": "string"
1797
- },
1798
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1799
- "attribute": "error",
1800
- "reflects": true
1734
+ "description": "Allows for the helper text to be overridden.",
1735
+ "name": "helpText"
1801
1736
  },
1802
1737
  {
1803
- "kind": "field",
1804
- "name": "format",
1805
- "privacy": "public",
1806
- "type": {
1807
- "text": "string"
1808
- },
1809
- "description": "Specifies the input mask format.",
1810
- "attribute": "format",
1811
- "reflects": true
1812
- },
1738
+ "description": "The default slot for the checkbox items.",
1739
+ "name": "default"
1740
+ }
1741
+ ],
1742
+ "members": [
1813
1743
  {
1814
- "kind": "field",
1815
- "name": "inputmode",
1816
- "privacy": "public",
1817
- "type": {
1818
- "text": "string"
1819
- },
1820
- "description": "Exposes inputmode attribute for input.",
1821
- "attribute": "inputmode",
1822
- "reflects": true
1744
+ "kind": "method",
1745
+ "name": "_initializeDefaults"
1823
1746
  },
1824
1747
  {
1825
- "kind": "field",
1826
- "name": "layout",
1827
- "privacy": "public",
1828
- "type": {
1829
- "text": "'classic' | 'emphasized' | 'snowflake'"
1830
- },
1831
- "description": "Sets the layout of the combobox.",
1832
- "default": "'classic'",
1833
- "attribute": "layout",
1834
- "reflects": true
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."
1835
1763
  },
1836
1764
  {
1837
- "kind": "field",
1838
- "name": "shape",
1839
- "privacy": "public",
1840
- "type": {
1841
- "text": "'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'"
1842
- },
1843
- "description": "Sets the shape of the combobox.",
1844
- "default": "'classic'",
1845
- "attribute": "shape",
1846
- "reflects": true
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.",
1784
+ "privacy": "private",
1785
+ "return": {
1786
+ "type": {
1787
+ "text": "void"
1788
+ }
1789
+ }
1847
1790
  },
1848
1791
  {
1849
- "kind": "field",
1850
- "name": "size",
1851
- "privacy": "public",
1852
- "type": {
1853
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
1854
- },
1855
- "description": "Sets the size of the combobox.",
1856
- "default": "'xl'",
1857
- "attribute": "size",
1858
- "reflects": true
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
+ }
1859
1801
  },
1860
1802
  {
1861
- "kind": "field",
1862
- "name": "matchWidth",
1803
+ "kind": "method",
1804
+ "name": "handleItems",
1805
+ "description": "Helper method that handles the state of checkboxes.",
1863
1806
  "privacy": "private",
1864
- "type": {
1865
- "text": "boolean"
1866
- },
1867
- "description": "If declared, the popover and trigger will be set to the same width.",
1868
- "attribute": "matchwidth",
1869
- "reflects": true
1807
+ "return": {
1808
+ "type": {
1809
+ "text": "void"
1810
+ }
1811
+ }
1870
1812
  },
1871
1813
  {
1872
- "kind": "field",
1873
- "name": "noFilter",
1874
- "privacy": "public",
1875
- "type": {
1876
- "text": "boolean"
1877
- },
1878
- "description": "If set, combobox will not filter menuoptions based on input.",
1879
- "attribute": "nofilter",
1880
- "reflects": true
1814
+ "kind": "method",
1815
+ "name": "reset",
1816
+ "description": "Resets component to initial state.",
1817
+ "return": {
1818
+ "type": {
1819
+ "text": "void"
1820
+ }
1821
+ }
1881
1822
  },
1882
1823
  {
1883
- "kind": "field",
1884
- "name": "noFlip",
1885
- "privacy": "public",
1886
- "type": {
1887
- "text": "boolean"
1888
- },
1889
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1890
- "attribute": "noflip",
1891
- "reflects": true
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."
1892
1838
  },
1893
1839
  {
1894
1840
  "kind": "field",
1895
- "name": "shift",
1841
+ "name": "appearance",
1896
1842
  "privacy": "public",
1897
1843
  "type": {
1898
- "text": "boolean"
1844
+ "text": "'default' | 'inverse'"
1899
1845
  },
1900
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1901
- "attribute": "shift",
1846
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1847
+ "default": "'default'",
1848
+ "attribute": "appearance",
1902
1849
  "reflects": true
1903
1850
  },
1904
1851
  {
1905
1852
  "kind": "field",
1906
- "name": "noValidate",
1853
+ "name": "disabled",
1907
1854
  "privacy": "public",
1908
1855
  "type": {
1909
1856
  "text": "boolean"
1910
1857
  },
1911
- "description": "If set, disables auto-validation on blur.",
1912
- "attribute": "novalidate",
1913
- "reflects": true
1914
- },
1915
- {
1916
- "kind": "field",
1917
- "name": "offset",
1918
- "privacy": "public",
1919
- "type": {
1920
- "text": "number"
1921
- },
1922
- "description": "Gap between the trigger element and bib.",
1923
- "default": "0",
1924
- "attribute": "offset",
1858
+ "description": "If set, disables the checkbox group.",
1859
+ "attribute": "disabled",
1925
1860
  "reflects": true
1926
1861
  },
1927
1862
  {
1928
1863
  "kind": "field",
1929
- "name": "onDark",
1930
- "privacy": "public",
1931
- "type": {
1932
- "text": "boolean"
1933
- },
1934
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1935
- "attribute": "ondark",
1936
- "reflects": true,
1937
- "deprecated": "Use `appearance=\"inverse\"` instead.",
1938
- "inheritedFrom": {
1939
- "name": "AuroElement",
1940
- "module": "components/layoutElement/src/auroElement.js"
1941
- }
1942
- },
1943
- {
1944
- "kind": "field",
1945
- "name": "optionSelected",
1864
+ "name": "error",
1946
1865
  "privacy": "public",
1947
1866
  "type": {
1948
- "text": "HTMLElement"
1867
+ "text": "string"
1949
1868
  },
1950
- "description": "Specifies the current selected option.",
1951
- "attribute": "optionselected"
1869
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1870
+ "attribute": "error",
1871
+ "reflects": true
1952
1872
  },
1953
1873
  {
1954
1874
  "kind": "field",
1955
- "name": "persistInput",
1875
+ "name": "horizontal",
1956
1876
  "privacy": "public",
1957
1877
  "type": {
1958
1878
  "text": "boolean"
1959
1879
  },
1960
- "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.",
1961
- "attribute": "persistinput",
1880
+ "description": "If set, checkboxes will be aligned horizontally.",
1881
+ "attribute": "horizontal",
1962
1882
  "reflects": true
1963
1883
  },
1964
1884
  {
1965
1885
  "kind": "field",
1966
- "name": "placement",
1886
+ "name": "noValidate",
1967
1887
  "privacy": "public",
1968
1888
  "type": {
1969
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1889
+ "text": "boolean"
1970
1890
  },
1971
- "description": "Position where the bib should appear relative to the trigger.",
1972
- "default": "'bottom-start'",
1973
- "attribute": "placement",
1891
+ "description": "If set, disables auto-validation on blur.",
1892
+ "attribute": "novalidate",
1974
1893
  "reflects": true
1975
1894
  },
1976
1895
  {
1977
1896
  "kind": "field",
1978
- "name": "placeholder",
1897
+ "name": "onDark",
1979
1898
  "privacy": "public",
1980
1899
  "type": {
1981
- "text": "string"
1900
+ "text": "boolean"
1982
1901
  },
1983
- "description": "Define custom placeholder text, only supported by date input formats.",
1984
- "attribute": "placeholder",
1902
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1903
+ "deprecated": "Use `appearance=\"inverse\"` instead.",
1904
+ "attribute": "ondark",
1985
1905
  "reflects": true
1986
1906
  },
1987
1907
  {
@@ -1991,7 +1911,7 @@
1991
1911
  "type": {
1992
1912
  "text": "boolean"
1993
1913
  },
1994
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1914
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1995
1915
  "attribute": "required",
1996
1916
  "reflects": true
1997
1917
  },
@@ -2027,553 +1947,624 @@
2027
1947
  },
2028
1948
  {
2029
1949
  "kind": "field",
2030
- "name": "setCustomValidityValueMissingFilter",
1950
+ "name": "validity",
2031
1951
  "privacy": "public",
2032
1952
  "type": {
2033
1953
  "text": "string"
2034
1954
  },
2035
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2036
- "attribute": "setcustomvalidityvaluemissingfilter"
1955
+ "description": "Specifies the `validityState` this element is in.",
1956
+ "attribute": "validity",
1957
+ "reflects": true
1958
+ }
1959
+ ],
1960
+ "events": [
1961
+ {
1962
+ "name": "input",
1963
+ "type": {
1964
+ "text": "CustomEvent"
1965
+ },
1966
+ "description": "Notifies when the group's value changes due to a checkbox selection being added or removed."
2037
1967
  },
2038
1968
  {
2039
- "kind": "field",
2040
- "name": "touched",
2041
- "privacy": "private",
1969
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1970
+ "name": "auroFormElement-validated"
1971
+ }
1972
+ ],
1973
+ "attributes": [
1974
+ {
1975
+ "name": "appearance",
1976
+ "type": {
1977
+ "text": "'default' | 'inverse'"
1978
+ },
1979
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1980
+ "default": "'default'",
1981
+ "fieldName": "appearance"
1982
+ },
1983
+ {
1984
+ "name": "disabled",
2042
1985
  "type": {
2043
1986
  "text": "boolean"
2044
1987
  },
2045
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1988
+ "description": "If set, disables the checkbox group.",
1989
+ "fieldName": "disabled"
2046
1990
  },
2047
1991
  {
2048
- "kind": "field",
2049
- "name": "triggerIcon",
2050
- "privacy": "public",
1992
+ "name": "error",
1993
+ "type": {
1994
+ "text": "string"
1995
+ },
1996
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1997
+ "fieldName": "error"
1998
+ },
1999
+ {
2000
+ "name": "horizontal",
2051
2001
  "type": {
2052
2002
  "text": "boolean"
2053
2003
  },
2054
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.\nIcon rendering is currently limited to `type=\"credit-card\"`. Setting `triggerIcon`\nwithout a supported `type` propagates the attribute but does not render a visible icon.",
2055
- "attribute": "triggericon",
2056
- "reflects": true
2004
+ "description": "If set, checkboxes will be aligned horizontally.",
2005
+ "fieldName": "horizontal"
2057
2006
  },
2058
2007
  {
2059
- "kind": "field",
2060
- "name": "type",
2061
- "privacy": "public",
2008
+ "name": "novalidate",
2062
2009
  "type": {
2063
- "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
2010
+ "text": "boolean"
2064
2011
  },
2065
- "description": "Applies the defined value as the type attribute on `auro-input`.",
2066
- "attribute": "type",
2067
- "reflects": true
2012
+ "description": "If set, disables auto-validation on blur.",
2013
+ "fieldName": "noValidate"
2068
2014
  },
2069
2015
  {
2070
- "kind": "field",
2071
- "name": "typedValue",
2072
- "privacy": "public",
2016
+ "name": "ondark",
2073
2017
  "type": {
2074
- "text": "string"
2018
+ "text": "boolean"
2075
2019
  },
2076
- "description": "Specifies the value of the input element within the combobox.",
2077
- "attribute": "typedvalue",
2078
- "reflects": true
2020
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2021
+ "deprecated": "Use `appearance=\"inverse\"` instead.",
2022
+ "fieldName": "onDark"
2079
2023
  },
2080
2024
  {
2081
- "kind": "field",
2082
- "name": "validity",
2083
- "privacy": "public",
2025
+ "name": "required",
2026
+ "type": {
2027
+ "text": "boolean"
2028
+ },
2029
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
2030
+ "fieldName": "required"
2031
+ },
2032
+ {
2033
+ "name": "setcustomvalidity",
2084
2034
  "type": {
2085
2035
  "text": "string"
2086
2036
  },
2087
- "description": "Specifies the `validityState` this element is in.",
2088
- "attribute": "validity",
2089
- "reflects": true
2037
+ "description": "Sets a custom help text message to display for all validityStates.",
2038
+ "fieldName": "setCustomValidity"
2090
2039
  },
2091
2040
  {
2092
- "kind": "field",
2093
- "name": "value",
2094
- "privacy": "public",
2041
+ "name": "setcustomvaliditycustomerror",
2095
2042
  "type": {
2096
2043
  "text": "string"
2097
2044
  },
2098
- "description": "Value selected for the dropdown menu. When set programmatically or as a preset attribute, the value must match a selectable option. If it matches an option marked `disabled` or `static`, the selection is rejected: `value` and `optionSelected` are cleared to `undefined`. `hidden` options (including those filtered out by type-ahead) remain selectable by value.",
2099
- "attribute": "value"
2045
+ "description": "Custom help text message to display when validity = `customError`.",
2046
+ "fieldName": "setCustomValidityCustomError"
2100
2047
  },
2101
2048
  {
2102
- "kind": "field",
2103
- "name": "largeFullscreenHeadline",
2104
- "privacy": "public",
2049
+ "name": "setcustomvalidityvaluemissing",
2105
2050
  "type": {
2106
- "text": "boolean"
2051
+ "text": "string"
2107
2052
  },
2108
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2109
- "attribute": "largefullscreenheadline",
2110
- "reflects": true
2053
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2054
+ "fieldName": "setCustomValidityValueMissing"
2111
2055
  },
2112
2056
  {
2113
- "kind": "field",
2114
- "name": "fullscreenBreakpoint",
2115
- "privacy": "public",
2057
+ "name": "validity",
2116
2058
  "type": {
2117
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2059
+ "text": "string"
2118
2060
  },
2119
- "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.",
2120
- "default": "'sm'",
2121
- "attribute": "fullscreenbreakpoint",
2122
- "reflects": true
2061
+ "description": "Specifies the `validityState` this element is in.",
2062
+ "fieldName": "validity"
2063
+ }
2064
+ ],
2065
+ "superclass": {
2066
+ "name": "LitElement",
2067
+ "package": "lit"
2068
+ },
2069
+ "tagName": "auro-checkbox-group",
2070
+ "customElement": true
2071
+ }
2072
+ ],
2073
+ "exports": [
2074
+ {
2075
+ "kind": "js",
2076
+ "name": "AuroCheckboxGroup",
2077
+ "declaration": {
2078
+ "name": "AuroCheckboxGroup",
2079
+ "module": "components/checkbox/src/auro-checkbox-group.js"
2080
+ }
2081
+ }
2082
+ ]
2083
+ },
2084
+ {
2085
+ "kind": "javascript-module",
2086
+ "path": "components/checkbox/src/auro-checkbox.js",
2087
+ "declarations": [
2088
+ {
2089
+ "kind": "class",
2090
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2091
+ "name": "AuroCheckbox",
2092
+ "cssParts": [
2093
+ {
2094
+ "description": "apply css to a specific checkbox.",
2095
+ "name": "checkbox"
2123
2096
  },
2124
2097
  {
2125
- "kind": "field",
2126
- "name": "optionActive",
2098
+ "description": "apply css to a specific checkbox's input.",
2099
+ "name": "checkbox-input"
2100
+ },
2101
+ {
2102
+ "description": "apply css to a specific checkbox's label.",
2103
+ "name": "checkbox-label"
2104
+ }
2105
+ ],
2106
+ "slots": [
2107
+ {
2108
+ "description": "The default slot for the checkbox label.",
2109
+ "name": "default"
2110
+ }
2111
+ ],
2112
+ "members": [
2113
+ {
2114
+ "kind": "method",
2115
+ "name": "_initializeDefaults"
2116
+ },
2117
+ {
2118
+ "kind": "method",
2119
+ "name": "register",
2120
+ "static": true,
2121
+ "parameters": [
2122
+ {
2123
+ "name": "name",
2124
+ "default": "\"auro-checkbox\"",
2125
+ "description": "The name of element that you want to register to.",
2126
+ "optional": true,
2127
+ "type": {
2128
+ "text": "string"
2129
+ }
2130
+ }
2131
+ ],
2132
+ "description": "This will register this element with the browser."
2133
+ },
2134
+ {
2135
+ "kind": "method",
2136
+ "name": "handleChange",
2137
+ "parameters": [
2138
+ {
2139
+ "name": "event",
2140
+ "description": "The change event from the checkbox input.",
2141
+ "type": {
2142
+ "text": "Event"
2143
+ }
2144
+ }
2145
+ ],
2146
+ "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.",
2147
+ "privacy": "private",
2148
+ "return": {
2149
+ "type": {
2150
+ "text": "void"
2151
+ }
2152
+ }
2153
+ },
2154
+ {
2155
+ "kind": "method",
2156
+ "name": "handleInput",
2157
+ "parameters": [
2158
+ {
2159
+ "name": "event",
2160
+ "description": "The input event from the checkbox input.",
2161
+ "type": {
2162
+ "text": "Event"
2163
+ }
2164
+ }
2165
+ ],
2166
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2127
2167
  "privacy": "private",
2128
- "type": {
2129
- "text": "HTMLElement"
2130
- },
2131
- "description": "Specifies the currently active option."
2168
+ "return": {
2169
+ "type": {
2170
+ "text": "void"
2171
+ }
2172
+ }
2132
2173
  },
2133
2174
  {
2134
- "kind": "field",
2135
- "name": "componentHasFocus",
2136
- "description": "Returns true if the element has focus.",
2175
+ "kind": "method",
2176
+ "name": "handleFocusin",
2177
+ "description": "Function to support",
2137
2178
  "privacy": "private",
2138
2179
  "return": {
2139
2180
  "type": {
2140
- "text": "boolean"
2181
+ "text": "void"
2141
2182
  }
2142
- },
2143
- "readonly": true,
2144
- "inheritedFrom": {
2145
- "name": "AuroElement",
2146
- "module": "components/layoutElement/src/auroElement.js"
2147
2183
  }
2148
2184
  },
2149
2185
  {
2150
2186
  "kind": "method",
2151
- "name": "resetShapeClasses",
2152
- "inheritedFrom": {
2153
- "name": "AuroElement",
2154
- "module": "components/layoutElement/src/auroElement.js"
2187
+ "name": "generateIconHtml",
2188
+ "description": "Function to generate checkmark svg.",
2189
+ "privacy": "private",
2190
+ "return": {
2191
+ "type": {
2192
+ "text": "HTMLElement"
2193
+ }
2155
2194
  }
2156
2195
  },
2157
2196
  {
2158
2197
  "kind": "method",
2159
- "name": "resetLayoutClasses",
2160
- "inheritedFrom": {
2161
- "name": "AuroElement",
2162
- "module": "components/layoutElement/src/auroElement.js"
2198
+ "name": "reset",
2199
+ "description": "Resets component to initial state.",
2200
+ "return": {
2201
+ "type": {
2202
+ "text": "void"
2203
+ }
2163
2204
  }
2164
2205
  },
2165
2206
  {
2166
2207
  "kind": "method",
2167
- "name": "updateComponentArchitecture",
2168
- "inheritedFrom": {
2169
- "name": "AuroElement",
2170
- "module": "components/layoutElement/src/auroElement.js"
2208
+ "name": "updateAriaLabel",
2209
+ "description": "Updates the aria-label based on slot content.",
2210
+ "privacy": "private",
2211
+ "return": {
2212
+ "type": {
2213
+ "text": "void"
2214
+ }
2171
2215
  }
2172
- }
2173
- ],
2174
- "events": [
2175
- {
2176
- "name": "inputValue",
2177
- "type": {
2178
- "text": "CustomEvent"
2179
- },
2180
- "description": "Notifies that the components internal HTML5 input value has changed."
2181
- },
2182
- {
2183
- "name": "input",
2184
- "type": {
2185
- "text": "CustomEvent"
2186
- },
2187
- "description": "Notifies that the component has a new value set."
2188
2216
  },
2189
2217
  {
2190
- "name": "auroCombobox-valueSet",
2191
- "type": {
2192
- "text": "CustomEvent"
2193
- },
2194
- "description": "Notifies that the component has a new value set. **DEPRECATED** - Use the `input` event instead.",
2195
- "deprecated": "Use the `input` event instead."
2218
+ "kind": "method",
2219
+ "name": "handleKeyDown",
2220
+ "parameters": [
2221
+ {
2222
+ "name": "event",
2223
+ "description": "The keydown event from the checkbox input.",
2224
+ "type": {
2225
+ "text": "KeyboardEvent"
2226
+ }
2227
+ }
2228
+ ],
2229
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
2230
+ "privacy": "private",
2231
+ "return": {
2232
+ "type": {
2233
+ "text": "void"
2234
+ }
2235
+ }
2196
2236
  },
2197
2237
  {
2198
- "description": "Notifies that the component value(s) have been validated.",
2199
- "name": "auroFormElement-validated"
2200
- }
2201
- ],
2202
- "attributes": [
2203
- {
2238
+ "kind": "field",
2204
2239
  "name": "appearance",
2240
+ "privacy": "public",
2205
2241
  "type": {
2206
2242
  "text": "'default' | 'inverse'"
2207
2243
  },
2208
2244
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
2209
2245
  "default": "'default'",
2210
- "fieldName": "appearance"
2211
- },
2212
- {
2213
- "name": "autocomplete",
2214
- "type": {
2215
- "text": "string"
2216
- },
2217
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2218
- "fieldName": "autocomplete"
2219
- },
2220
- {
2221
- "name": "autoplacement",
2222
- "type": {
2223
- "text": "boolean"
2224
- },
2225
- "description": "If declared, bib's position will be automatically calculated where to appear.",
2226
- "fieldName": "autoPlacement"
2227
- },
2228
- {
2229
- "name": "behavior",
2230
- "type": {
2231
- "text": "'filter' | 'suggestion'"
2232
- },
2233
- "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.",
2234
- "default": "'suggestion'",
2235
- "fieldName": "behavior"
2246
+ "attribute": "appearance",
2247
+ "reflects": true
2236
2248
  },
2237
2249
  {
2238
- "name": "checkmark",
2250
+ "kind": "field",
2251
+ "name": "checked",
2252
+ "privacy": "public",
2239
2253
  "type": {
2240
2254
  "text": "boolean"
2241
2255
  },
2242
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
2243
- "fieldName": "checkmark"
2256
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2257
+ "attribute": "checked",
2258
+ "reflects": true
2244
2259
  },
2245
2260
  {
2261
+ "kind": "field",
2246
2262
  "name": "disabled",
2263
+ "privacy": "public",
2247
2264
  "type": {
2248
2265
  "text": "boolean"
2249
2266
  },
2250
- "description": "If set, disables the combobox.",
2251
- "fieldName": "disabled"
2267
+ "description": "If set to true, the checkbox will not be clickable.",
2268
+ "attribute": "disabled",
2269
+ "reflects": true
2252
2270
  },
2253
2271
  {
2254
- "name": "dvinputonly",
2272
+ "kind": "field",
2273
+ "name": "error",
2274
+ "privacy": "public",
2255
2275
  "type": {
2256
2276
  "text": "boolean"
2257
2277
  },
2258
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2259
- "fieldName": "dvInputOnly"
2278
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2279
+ "attribute": "error",
2280
+ "reflects": true
2260
2281
  },
2261
2282
  {
2262
- "name": "error",
2283
+ "kind": "field",
2284
+ "name": "id",
2285
+ "privacy": "public",
2263
2286
  "type": {
2264
2287
  "text": "string"
2265
2288
  },
2266
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2267
- "fieldName": "error"
2289
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2290
+ "attribute": "id",
2291
+ "reflects": true
2268
2292
  },
2269
2293
  {
2270
- "name": "format",
2294
+ "kind": "field",
2295
+ "name": "inputId",
2296
+ "privacy": "private",
2271
2297
  "type": {
2272
2298
  "text": "string"
2273
2299
  },
2274
- "description": "Specifies the input mask format.",
2275
- "fieldName": "format"
2300
+ "description": "The id for input node."
2276
2301
  },
2277
2302
  {
2278
- "name": "inputmode",
2303
+ "kind": "field",
2304
+ "name": "name",
2305
+ "privacy": "public",
2279
2306
  "type": {
2280
2307
  "text": "string"
2281
2308
  },
2282
- "description": "Exposes inputmode attribute for input.",
2283
- "fieldName": "inputmode"
2284
- },
2285
- {
2286
- "name": "layout",
2287
- "type": {
2288
- "text": "'classic' | 'emphasized' | 'snowflake'"
2289
- },
2290
- "description": "Sets the layout of the combobox.",
2291
- "default": "'classic'",
2292
- "fieldName": "layout"
2293
- },
2294
- {
2295
- "name": "shape",
2296
- "type": {
2297
- "text": "'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'"
2298
- },
2299
- "description": "Sets the shape of the combobox.",
2300
- "default": "'classic'",
2301
- "fieldName": "shape"
2302
- },
2303
- {
2304
- "name": "size",
2305
- "type": {
2306
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
2307
- },
2308
- "description": "Sets the size of the combobox.",
2309
- "default": "'xl'",
2310
- "fieldName": "size"
2309
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2310
+ "attribute": "name"
2311
2311
  },
2312
2312
  {
2313
- "name": "matchwidth",
2313
+ "kind": "field",
2314
+ "name": "onDark",
2315
+ "privacy": "public",
2314
2316
  "type": {
2315
2317
  "text": "boolean"
2316
2318
  },
2317
- "description": "If declared, the popover and trigger will be set to the same width.",
2318
- "fieldName": "matchWidth"
2319
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2320
+ "deprecated": "Use `appearance=\"inverse\"` instead.",
2321
+ "attribute": "ondark",
2322
+ "reflects": true
2319
2323
  },
2320
2324
  {
2321
- "name": "nofilter",
2325
+ "kind": "field",
2326
+ "name": "touched",
2327
+ "privacy": "private",
2322
2328
  "type": {
2323
2329
  "text": "boolean"
2324
2330
  },
2325
- "description": "If set, combobox will not filter menuoptions based on input.",
2326
- "fieldName": "noFilter"
2331
+ "description": "Indicates whether the checkbox has been interacted with."
2327
2332
  },
2328
2333
  {
2329
- "name": "noflip",
2334
+ "kind": "field",
2335
+ "name": "value",
2336
+ "privacy": "public",
2330
2337
  "type": {
2331
- "text": "boolean"
2338
+ "text": "string"
2332
2339
  },
2333
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2334
- "fieldName": "noFlip"
2340
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2341
+ "attribute": "value"
2335
2342
  },
2336
2343
  {
2337
- "name": "shift",
2344
+ "kind": "field",
2345
+ "name": "tabIndex",
2346
+ "privacy": "private",
2338
2347
  "type": {
2339
- "text": "boolean"
2348
+ "text": "number"
2340
2349
  },
2341
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2342
- "fieldName": "shift"
2350
+ "description": "The tabindex attribute for the checkbox.",
2351
+ "attribute": "tabindex",
2352
+ "reflects": true
2343
2353
  },
2344
2354
  {
2345
- "name": "novalidate",
2355
+ "kind": "field",
2356
+ "name": "ariaChecked",
2357
+ "privacy": "private",
2346
2358
  "type": {
2347
- "text": "boolean"
2359
+ "text": "string"
2348
2360
  },
2349
- "description": "If set, disables auto-validation on blur.",
2350
- "fieldName": "noValidate"
2361
+ "description": "The aria-checked attribute for the checkbox.",
2362
+ "attribute": "aria-checked",
2363
+ "reflects": true
2351
2364
  },
2352
2365
  {
2353
- "name": "offset",
2366
+ "kind": "field",
2367
+ "name": "ariaDisabled",
2368
+ "privacy": "private",
2354
2369
  "type": {
2355
- "text": "number"
2370
+ "text": "string"
2356
2371
  },
2357
- "description": "Gap between the trigger element and bib.",
2358
- "default": "0",
2359
- "fieldName": "offset"
2372
+ "description": "The aria-disabled attribute for the checkbox.",
2373
+ "attribute": "aria-disabled",
2374
+ "reflects": true
2360
2375
  },
2361
2376
  {
2362
- "name": "ondark",
2377
+ "kind": "field",
2378
+ "name": "role",
2379
+ "privacy": "private",
2363
2380
  "type": {
2364
- "text": "boolean"
2381
+ "text": "string"
2365
2382
  },
2366
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2367
- "fieldName": "onDark",
2368
- "deprecated": "Use `appearance=\"inverse\"` instead.",
2369
- "inheritedFrom": {
2370
- "name": "AuroElement",
2371
- "module": "components/layoutElement/src/auroElement.js"
2372
- }
2373
- },
2383
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2384
+ "attribute": "role",
2385
+ "reflects": true
2386
+ }
2387
+ ],
2388
+ "events": [
2374
2389
  {
2375
- "name": "optionselected",
2390
+ "name": "auroCheckbox-input",
2376
2391
  "type": {
2377
- "text": "HTMLElement"
2392
+ "text": "CustomEvent"
2378
2393
  },
2379
- "description": "Specifies the current selected option.",
2380
- "fieldName": "optionSelected"
2394
+ "description": "Notifies when the checked value is changed by user interaction. **DEPRECATED** - Use the `input` event instead.",
2395
+ "deprecated": "Use the `input` event instead."
2381
2396
  },
2382
2397
  {
2383
- "name": "persistinput",
2398
+ "name": "auroCheckbox-focusin",
2384
2399
  "type": {
2385
- "text": "boolean"
2400
+ "text": "CustomEvent"
2386
2401
  },
2387
- "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.",
2388
- "fieldName": "persistInput"
2402
+ "description": "Notifies when the checkbox receives focus."
2389
2403
  },
2390
2404
  {
2391
- "name": "placement",
2405
+ "name": "auroCheckbox-focusout",
2392
2406
  "type": {
2393
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2407
+ "text": "CustomEvent"
2394
2408
  },
2395
- "description": "Position where the bib should appear relative to the trigger.",
2396
- "default": "'bottom-start'",
2397
- "fieldName": "placement"
2409
+ "description": "Notifies when the checkbox loses focus."
2398
2410
  },
2399
2411
  {
2400
- "name": "placeholder",
2412
+ "description": "Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.",
2413
+ "name": "change",
2414
+ "deprecated": "Use the `input` event instead."
2415
+ },
2416
+ {
2417
+ "description": "Notifies when checked value is changed by user's interface.",
2418
+ "name": "input"
2419
+ }
2420
+ ],
2421
+ "attributes": [
2422
+ {
2423
+ "name": "appearance",
2401
2424
  "type": {
2402
- "text": "string"
2425
+ "text": "'default' | 'inverse'"
2403
2426
  },
2404
- "description": "Define custom placeholder text, only supported by date input formats.",
2405
- "fieldName": "placeholder"
2427
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2428
+ "default": "'default'",
2429
+ "fieldName": "appearance"
2406
2430
  },
2407
2431
  {
2408
- "name": "required",
2432
+ "name": "checked",
2409
2433
  "type": {
2410
2434
  "text": "boolean"
2411
2435
  },
2412
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2413
- "fieldName": "required"
2436
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2437
+ "fieldName": "checked"
2414
2438
  },
2415
2439
  {
2416
- "name": "setcustomvalidity",
2440
+ "name": "disabled",
2417
2441
  "type": {
2418
- "text": "string"
2442
+ "text": "boolean"
2419
2443
  },
2420
- "description": "Sets a custom help text message to display for all validityStates.",
2421
- "fieldName": "setCustomValidity"
2444
+ "description": "If set to true, the checkbox will not be clickable.",
2445
+ "fieldName": "disabled"
2422
2446
  },
2423
2447
  {
2424
- "name": "setcustomvaliditycustomerror",
2448
+ "name": "error",
2425
2449
  "type": {
2426
- "text": "string"
2450
+ "text": "boolean"
2427
2451
  },
2428
- "description": "Custom help text message to display when validity = `customError`.",
2429
- "fieldName": "setCustomValidityCustomError"
2452
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2453
+ "fieldName": "error"
2430
2454
  },
2431
2455
  {
2432
- "name": "setcustomvalidityvaluemissing",
2456
+ "name": "id",
2433
2457
  "type": {
2434
2458
  "text": "string"
2435
2459
  },
2436
- "description": "Custom help text message to display when validity = `valueMissing`.",
2437
- "fieldName": "setCustomValidityValueMissing"
2460
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2461
+ "fieldName": "id"
2438
2462
  },
2439
2463
  {
2440
- "name": "setcustomvalidityvaluemissingfilter",
2464
+ "name": "name",
2441
2465
  "type": {
2442
2466
  "text": "string"
2443
2467
  },
2444
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2445
- "fieldName": "setCustomValidityValueMissingFilter"
2468
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2469
+ "fieldName": "name"
2446
2470
  },
2447
2471
  {
2448
- "name": "triggericon",
2472
+ "name": "ondark",
2449
2473
  "type": {
2450
2474
  "text": "boolean"
2451
2475
  },
2452
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.\nIcon rendering is currently limited to `type=\"credit-card\"`. Setting `triggerIcon`\nwithout a supported `type` propagates the attribute but does not render a visible icon.",
2453
- "fieldName": "triggerIcon"
2454
- },
2455
- {
2456
- "name": "type",
2457
- "type": {
2458
- "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
2459
- },
2460
- "description": "Applies the defined value as the type attribute on `auro-input`.",
2461
- "fieldName": "type"
2476
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2477
+ "deprecated": "Use `appearance=\"inverse\"` instead.",
2478
+ "fieldName": "onDark"
2462
2479
  },
2463
2480
  {
2464
- "name": "typedvalue",
2481
+ "name": "value",
2465
2482
  "type": {
2466
2483
  "text": "string"
2467
2484
  },
2468
- "description": "Specifies the value of the input element within the combobox.",
2469
- "fieldName": "typedValue"
2485
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2486
+ "fieldName": "value"
2470
2487
  },
2471
2488
  {
2472
- "name": "validity",
2489
+ "name": "tabindex",
2473
2490
  "type": {
2474
- "text": "string"
2491
+ "text": "number"
2475
2492
  },
2476
- "description": "Specifies the `validityState` this element is in.",
2477
- "fieldName": "validity"
2493
+ "description": "The tabindex attribute for the checkbox.",
2494
+ "fieldName": "tabIndex"
2478
2495
  },
2479
2496
  {
2480
- "name": "value",
2497
+ "name": "aria-checked",
2481
2498
  "type": {
2482
2499
  "text": "string"
2483
2500
  },
2484
- "description": "Value selected for the dropdown menu. When set programmatically or as a preset attribute, the value must match a selectable option. If it matches an option marked `disabled` or `static`, the selection is rejected: `value` and `optionSelected` are cleared to `undefined`. `hidden` options (including those filtered out by type-ahead) remain selectable by value.",
2485
- "fieldName": "value"
2501
+ "description": "The aria-checked attribute for the checkbox.",
2502
+ "fieldName": "ariaChecked"
2486
2503
  },
2487
2504
  {
2488
- "name": "largefullscreenheadline",
2505
+ "name": "aria-disabled",
2489
2506
  "type": {
2490
- "text": "boolean"
2507
+ "text": "string"
2491
2508
  },
2492
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2493
- "fieldName": "largeFullscreenHeadline"
2509
+ "description": "The aria-disabled attribute for the checkbox.",
2510
+ "fieldName": "ariaDisabled"
2494
2511
  },
2495
2512
  {
2496
- "name": "fullscreenbreakpoint",
2513
+ "name": "role",
2497
2514
  "type": {
2498
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2515
+ "text": "string"
2499
2516
  },
2500
- "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.",
2501
- "default": "'sm'",
2502
- "fieldName": "fullscreenBreakpoint"
2517
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2518
+ "fieldName": "role"
2503
2519
  }
2504
2520
  ],
2505
2521
  "superclass": {
2506
- "name": "AuroElement",
2507
- "module": "/components/layoutElement/src/auroElement.js"
2522
+ "name": "LitElement",
2523
+ "package": "lit"
2508
2524
  },
2509
- "tagName": "auro-combobox",
2525
+ "tagName": "auro-checkbox",
2510
2526
  "customElement": true
2511
2527
  }
2512
2528
  ],
2513
2529
  "exports": [
2514
2530
  {
2515
2531
  "kind": "js",
2516
- "name": "AuroCombobox",
2532
+ "name": "AuroCheckbox",
2517
2533
  "declaration": {
2518
- "name": "AuroCombobox",
2519
- "module": "components/combobox/src/auro-combobox.js"
2534
+ "name": "AuroCheckbox",
2535
+ "module": "components/checkbox/src/auro-checkbox.js"
2520
2536
  }
2521
2537
  }
2522
2538
  ]
2523
2539
  },
2524
2540
  {
2525
2541
  "kind": "javascript-module",
2526
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2527
- "declarations": [
2528
- {
2529
- "kind": "variable",
2530
- "name": "comboboxKeyboardStrategy",
2531
- "type": {
2532
- "text": "object"
2533
- },
2534
- "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)) { if (evt.shiftKey) { if (selectAndExitBackward(component)) { evt.preventDefault(); } return; } selectAndClose(component); if (ctx.isModal) { // Fullscreen close does not automatically restore focus to the input. component.setClearBtnFocus(); } } } }"
2535
- }
2536
- ],
2542
+ "path": "components/checkbox/src/index.js",
2543
+ "declarations": [],
2537
2544
  "exports": [
2538
2545
  {
2539
2546
  "kind": "js",
2540
- "name": "comboboxKeyboardStrategy",
2547
+ "name": "AuroCheckbox",
2541
2548
  "declaration": {
2542
- "name": "comboboxKeyboardStrategy",
2543
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2549
+ "name": "AuroCheckbox",
2550
+ "module": "components/checkbox/src/index.js"
2544
2551
  }
2545
- }
2546
- ]
2547
- },
2548
- {
2549
- "kind": "javascript-module",
2550
- "path": "components/combobox/src/index.js",
2551
- "declarations": [],
2552
- "exports": [
2552
+ },
2553
2553
  {
2554
2554
  "kind": "js",
2555
- "name": "AuroCombobox",
2555
+ "name": "AuroCheckboxGroup",
2556
2556
  "declaration": {
2557
- "name": "AuroCombobox",
2558
- "module": "components/combobox/src/index.js"
2557
+ "name": "AuroCheckboxGroup",
2558
+ "module": "components/checkbox/src/index.js"
2559
2559
  }
2560
2560
  }
2561
2561
  ]
2562
2562
  },
2563
2563
  {
2564
2564
  "kind": "javascript-module",
2565
- "path": "components/combobox/src/registered.js",
2565
+ "path": "components/checkbox/src/registered.js",
2566
2566
  "declarations": [],
2567
- "exports": [
2568
- {
2569
- "kind": "js",
2570
- "name": "AuroCombobox",
2571
- "declaration": {
2572
- "name": "AuroCombobox",
2573
- "module": "components/combobox/src/registered.js"
2574
- }
2575
- }
2576
- ]
2567
+ "exports": []
2577
2568
  },
2578
2569
  {
2579
2570
  "kind": "javascript-module",
@@ -3148,7 +3139,7 @@
3148
3139
  "name": "fullscreenBreakpoint",
3149
3140
  "privacy": "public",
3150
3141
  "type": {
3151
- "text": "string"
3142
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
3152
3143
  },
3153
3144
  "description": "Defines the screen size breakpoint at 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.",
3154
3145
  "default": "'sm'",
@@ -3208,7 +3199,7 @@
3208
3199
  "name": "placement",
3209
3200
  "privacy": "public",
3210
3201
  "type": {
3211
- "text": "string"
3202
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
3212
3203
  },
3213
3204
  "description": "Position where the bib should appear relative to the trigger.",
3214
3205
  "default": "'bottom-start'",
@@ -3427,7 +3418,7 @@
3427
3418
  {
3428
3419
  "name": "fullscreenbreakpoint",
3429
3420
  "type": {
3430
- "text": "string"
3421
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
3431
3422
  },
3432
3423
  "description": "Defines the screen size breakpoint at 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.",
3433
3424
  "default": "'sm'",
@@ -3549,7 +3540,7 @@
3549
3540
  {
3550
3541
  "name": "placement",
3551
3542
  "type": {
3552
- "text": "string"
3543
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
3553
3544
  },
3554
3545
  "description": "Position where the bib should appear relative to the trigger.",
3555
3546
  "default": "'bottom-start'",
@@ -7775,7 +7766,7 @@
7775
7766
  "name": "fullscreenBreakpoint",
7776
7767
  "privacy": "public",
7777
7768
  "type": {
7778
- "text": "string"
7769
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
7779
7770
  },
7780
7771
  "description": "Defines the screen size breakpoint at 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.",
7781
7772
  "default": "'sm'",
@@ -7795,7 +7786,7 @@
7795
7786
  "name": "placement",
7796
7787
  "privacy": "public",
7797
7788
  "type": {
7798
- "text": "string"
7789
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
7799
7790
  },
7800
7791
  "description": "Position where the bib should appear relative to the trigger.",
7801
7792
  "default": "'bottom-start'",
@@ -8378,7 +8369,7 @@
8378
8369
  {
8379
8370
  "name": "fullscreenbreakpoint",
8380
8371
  "type": {
8381
- "text": "string"
8372
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
8382
8373
  },
8383
8374
  "description": "Defines the screen size breakpoint at 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.",
8384
8375
  "default": "'sm'",
@@ -8538,7 +8529,7 @@
8538
8529
  {
8539
8530
  "name": "placement",
8540
8531
  "type": {
8541
- "text": "string"
8532
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
8542
8533
  },
8543
8534
  "description": "Position where the bib should appear relative to the trigger.",
8544
8535
  "default": "'bottom-start'",
@@ -10108,8 +10099,7 @@
10108
10099
  "type": {
10109
10100
  "text": "() => void"
10110
10101
  },
10111
- "description": "If declared, and a function is set, that function will execute when the slot content is updated.",
10112
- "attribute": "onslotchange"
10102
+ "description": "If declared, and a function is set, that function will execute when the slot content is updated."
10113
10103
  },
10114
10104
  {
10115
10105
  "kind": "field",
@@ -10437,14 +10427,6 @@
10437
10427
  "module": "components/layoutElement/src/auroElement.js"
10438
10428
  }
10439
10429
  },
10440
- {
10441
- "name": "onslotchange",
10442
- "type": {
10443
- "text": "() => void"
10444
- },
10445
- "description": "If declared, and a function is set, that function will execute when the slot content is updated.",
10446
- "fieldName": "onSlotChange"
10447
- },
10448
10430
  {
10449
10431
  "name": "placement",
10450
10432
  "type": {
@@ -10635,8 +10617,7 @@
10635
10617
  "type": {
10636
10618
  "text": "object"
10637
10619
  },
10638
- "description": "A reference to the associated bib template element.",
10639
- "attribute": "bibtemplate"
10620
+ "description": "A reference to the associated bib template element."
10640
10621
  },
10641
10622
  {
10642
10623
  "kind": "field",
@@ -10729,14 +10710,6 @@
10729
10710
  "description": "If declared, will apply border-radius to the bib.",
10730
10711
  "fieldName": "rounded"
10731
10712
  },
10732
- {
10733
- "name": "bibtemplate",
10734
- "type": {
10735
- "text": "object"
10736
- },
10737
- "description": "A reference to the associated bib template element.",
10738
- "fieldName": "bibTemplate"
10739
- },
10740
10713
  {
10741
10714
  "name": "shape",
10742
10715
  "type": {
@@ -18402,8 +18375,7 @@
18402
18375
  "type": {
18403
18376
  "text": "HTMLElement"
18404
18377
  },
18405
- "description": "Specifies the current selected radio button.",
18406
- "attribute": "optionselected"
18378
+ "description": "Specifies the current selected radio button."
18407
18379
  },
18408
18380
  {
18409
18381
  "kind": "field",
@@ -18541,14 +18513,6 @@
18541
18513
  "deprecated": "Use `appearance=\"inverse\"` instead.",
18542
18514
  "fieldName": "onDark"
18543
18515
  },
18544
- {
18545
- "name": "optionselected",
18546
- "type": {
18547
- "text": "HTMLElement"
18548
- },
18549
- "description": "Specifies the current selected radio button.",
18550
- "fieldName": "optionSelected"
18551
- },
18552
18516
  {
18553
18517
  "name": "required",
18554
18518
  "type": {
@@ -19985,8 +19949,7 @@
19985
19949
  "type": {
19986
19950
  "text": "HTMLElement|Array<HTMLElement>"
19987
19951
  },
19988
- "description": "Specifies the current selected menuOption. Default type is `HTMLElement`, changing to `Array<HTMLElement>` when `multiSelect` is true.",
19989
- "attribute": "optionselected"
19952
+ "description": "Specifies the current selected menuOption. Default type is `HTMLElement`, changing to `Array<HTMLElement>` when `multiSelect` is true."
19990
19953
  },
19991
19954
  {
19992
19955
  "kind": "field",
@@ -20332,14 +20295,6 @@
20332
20295
  "module": "components/layoutElement/src/auroElement.js"
20333
20296
  }
20334
20297
  },
20335
- {
20336
- "name": "optionselected",
20337
- "type": {
20338
- "text": "HTMLElement|Array<HTMLElement>"
20339
- },
20340
- "description": "Specifies the current selected menuOption. Default type is `HTMLElement`, changing to `Array<HTMLElement>` when `multiSelect` is true.",
20341
- "fieldName": "optionSelected"
20342
- },
20343
20298
  {
20344
20299
  "name": "placeholder",
20345
20300
  "type": {