@aurodesignsystem-dev/auro-formkit 0.0.0-pr1619.0 → 0.0.0-pr1621.0

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