@aurodesignsystem-dev/auro-formkit 0.0.0-pr1615.0 → 0.0.0-pr1619.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 (47) 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/customize.html +3 -0
  12. package/components/counter/demo/customize.min.js +149 -142
  13. package/components/counter/demo/getting-started.min.js +2 -2
  14. package/components/counter/demo/index.min.js +2 -2
  15. package/components/counter/dist/index.js +2 -2
  16. package/components/counter/dist/registered.js +2 -2
  17. package/components/datepicker/demo/customize.min.js +3 -3
  18. package/components/datepicker/demo/getting-started.min.js +3 -3
  19. package/components/datepicker/demo/index.min.js +3 -3
  20. package/components/datepicker/dist/index.js +3 -3
  21. package/components/datepicker/dist/registered.js +3 -3
  22. package/components/dropdown/demo/customize.min.js +1 -1
  23. package/components/dropdown/demo/getting-started.min.js +2 -2
  24. package/components/dropdown/demo/index.min.js +1 -1
  25. package/components/dropdown/dist/index.js +1 -1
  26. package/components/dropdown/dist/registered.js +1 -1
  27. package/components/form/demo/customize.min.js +13 -13
  28. package/components/form/demo/getting-started.min.js +13 -13
  29. package/components/form/demo/index.min.js +13 -13
  30. package/components/form/demo/registerDemoDeps.min.js +13 -13
  31. package/components/input/demo/customize.min.js +1 -1
  32. package/components/input/demo/getting-started.min.js +1 -1
  33. package/components/input/demo/index.min.js +1 -1
  34. package/components/input/dist/index.js +1 -1
  35. package/components/input/dist/registered.js +1 -1
  36. package/components/radio/demo/customize.min.js +1 -1
  37. package/components/radio/demo/getting-started.min.js +1 -1
  38. package/components/radio/demo/index.min.js +1 -1
  39. package/components/radio/dist/index.js +1 -1
  40. package/components/radio/dist/registered.js +1 -1
  41. package/components/select/demo/customize.min.js +2 -2
  42. package/components/select/demo/getting-started.min.js +2 -2
  43. package/components/select/demo/index.min.js +2 -2
  44. package/components/select/dist/index.js +2 -2
  45. package/components/select/dist/registered.js +2 -2
  46. package/custom-elements.json +1526 -1526
  47. package/package.json +1 -1
@@ -279,113 +279,44 @@
279
279
  },
280
280
  {
281
281
  "kind": "javascript-module",
282
- "path": "components/combobox/src/auro-combobox.js",
282
+ "path": "components/checkbox/src/auro-checkbox-group.js",
283
283
  "declarations": [
284
284
  {
285
285
  "kind": "class",
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",
286
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
287
+ "name": "AuroCheckboxGroup",
288
288
  "cssParts": [
289
289
  {
290
- "description": "The help text and error message content container.",
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.",
291
295
  "name": "helpText"
292
296
  }
293
297
  ],
294
298
  "slots": [
295
299
  {
296
- "description": "Default slot for the menu content.",
297
- "name": ""
300
+ "description": "Allows for the legend to be overridden.",
301
+ "name": "legend"
298
302
  },
299
303
  {
300
- "type": {
301
- "text": "HTMLSlotElement"
302
- },
303
304
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
304
305
  "name": "optionalLabel"
305
306
  },
306
307
  {
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.",
308
+ "description": "Allows for the helper text to be overridden.",
324
309
  "name": "helpText"
325
310
  },
326
311
  {
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"
312
+ "description": "The default slot for the checkbox items.",
313
+ "name": "default"
329
314
  }
330
315
  ],
331
316
  "members": [
332
317
  {
333
318
  "kind": "method",
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
- }
319
+ "name": "_initializeDefaults"
389
320
  },
390
321
  {
391
322
  "kind": "method",
@@ -394,7 +325,7 @@
394
325
  "parameters": [
395
326
  {
396
327
  "name": "name",
397
- "default": "'auro-combobox'",
328
+ "default": "\"auro-checkbox-group\"",
398
329
  "description": "The name of the element that you want to register.",
399
330
  "optional": true,
400
331
  "type": {
@@ -406,96 +337,35 @@
406
337
  },
407
338
  {
408
339
  "kind": "method",
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",
340
+ "name": "handleValueUpdate",
449
341
  "parameters": [
450
342
  {
451
- "name": "label",
452
- "description": "The label of the selected option.",
343
+ "name": "value",
344
+ "description": "The value of the checkbox.",
453
345
  "type": {
454
- "text": "string"
346
+ "text": "String"
455
347
  }
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": [
348
+ },
465
349
  {
466
- "name": "nextValue",
467
- "description": "The value to write to both inputs.",
350
+ "name": "selected",
351
+ "description": "The checked state of the checkbox.",
468
352
  "type": {
469
- "text": "string"
353
+ "text": "Boolean"
470
354
  }
471
355
  }
472
356
  ],
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.",
357
+ "description": "Helper method to handle checkbox value changing.",
358
+ "privacy": "private",
474
359
  "return": {
475
360
  "type": {
476
- "text": "Promise<void>"
361
+ "text": "void"
477
362
  }
478
- },
479
- "privacy": "private"
363
+ }
480
364
  },
481
365
  {
482
366
  "kind": "method",
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.",
367
+ "name": "handlePreselectedItems",
368
+ "description": "Helper method that handles the state of preselected checkboxes.",
499
369
  "privacy": "private",
500
370
  "return": {
501
371
  "type": {
@@ -505,8 +375,8 @@
505
375
  },
506
376
  {
507
377
  "kind": "method",
508
- "name": "generateOptionsArray",
509
- "description": "Determines the element error state based on the `required` attribute and input value.",
378
+ "name": "handleItems",
379
+ "description": "Helper method that handles the state of checkboxes.",
510
380
  "privacy": "private",
511
381
  "return": {
512
382
  "type": {
@@ -515,19 +385,22 @@
515
385
  }
516
386
  },
517
387
  {
518
- "kind": "method",
519
- "name": "hideBib",
520
- "description": "Hides the dropdown bib if its open.",
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",
521
392
  "return": {
522
393
  "type": {
523
- "text": "void"
394
+ "text": "boolean"
524
395
  }
525
- }
396
+ },
397
+ "readonly": true
526
398
  },
527
399
  {
528
400
  "kind": "method",
529
- "name": "showBib",
530
- "description": "Shows the dropdown bib if there are options to show.",
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",
531
404
  "return": {
532
405
  "type": {
533
406
  "text": "void"
@@ -536,9 +409,8 @@
536
409
  },
537
410
  {
538
411
  "kind": "method",
539
- "name": "configureDropdown",
540
- "description": "Binds all behavior needed to the dropdown after rendering.",
541
- "privacy": "private",
412
+ "name": "reset",
413
+ "description": "Resets component to initial state.",
542
414
  "return": {
543
415
  "type": {
544
416
  "text": "void"
@@ -547,131 +419,328 @@
547
419
  },
548
420
  {
549
421
  "kind": "method",
550
- "name": "setClearBtnFocus",
551
- "privacy": "private"
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."
552
435
  },
553
436
  {
554
- "kind": "method",
555
- "name": "setTriggerInputFocus",
556
- "privacy": "private"
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
557
447
  },
558
448
  {
559
- "kind": "method",
560
- "name": "setInputFocus",
561
- "privacy": "private"
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
562
458
  },
563
459
  {
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"
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
568
469
  },
569
470
  {
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"
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
574
480
  },
575
481
  {
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
- }
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
585
491
  },
586
492
  {
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
- }
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
596
503
  },
597
504
  {
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
- }
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"
644
+ },
645
+ {
646
+ "name": "setcustomvalidityvaluemissing",
647
+ "type": {
648
+ "text": "string"
649
+ },
650
+ "description": "Custom help text message to display when validity = `valueMissing`.",
651
+ "fieldName": "setCustomValidityValueMissing"
652
+ },
653
+ {
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"
693
+ },
694
+ {
695
+ "description": "apply css to a specific checkbox's input.",
696
+ "name": "checkbox-input"
607
697
  },
698
+ {
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": [
608
710
  {
609
711
  "kind": "method",
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
- }
712
+ "name": "_initializeDefaults"
627
713
  },
628
714
  {
629
715
  "kind": "method",
630
- "name": "handleMenuLoadingChange",
716
+ "name": "register",
717
+ "static": true,
631
718
  "parameters": [
632
719
  {
633
- "name": "event",
634
- "description": "The event object containing details about the loading state change.",
635
- "type": {
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",
720
+ "name": "name",
721
+ "default": "\"auro-checkbox\"",
722
+ "description": "The name of element that you want to register to.",
723
+ "optional": true,
649
724
  "type": {
650
- "text": "boolean"
725
+ "text": "string"
651
726
  }
652
727
  }
653
728
  ],
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
- }
729
+ "description": "This will register this element with the browser."
661
730
  },
662
731
  {
663
732
  "kind": "method",
664
- "name": "handleInputValueChange",
733
+ "name": "handleChange",
665
734
  "parameters": [
666
735
  {
667
736
  "name": "event",
668
- "description": "The input event triggered by the input element.",
737
+ "description": "The change event from the checkbox input.",
669
738
  "type": {
670
739
  "text": "Event"
671
740
  }
672
741
  }
673
742
  ],
674
- "description": "Handle changes to the input value and trigger changes that should result.",
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.",
675
744
  "privacy": "private",
676
745
  "return": {
677
746
  "type": {
@@ -681,17 +750,17 @@
681
750
  },
682
751
  {
683
752
  "kind": "method",
684
- "name": "handleTriggerInputValueChange",
753
+ "name": "handleInput",
685
754
  "parameters": [
686
755
  {
687
756
  "name": "event",
688
- "description": "The input event from the trigger input element.",
757
+ "description": "The input event from the checkbox input.",
689
758
  "type": {
690
759
  "text": "Event"
691
760
  }
692
761
  }
693
762
  ],
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.",
763
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
695
764
  "privacy": "private",
696
765
  "return": {
697
766
  "type": {
@@ -701,8 +770,8 @@
701
770
  },
702
771
  {
703
772
  "kind": "method",
704
- "name": "configureCombobox",
705
- "description": "Binds all behavior needed to the combobox after rendering.",
773
+ "name": "handleFocusin",
774
+ "description": "Function to support",
706
775
  "privacy": "private",
707
776
  "return": {
708
777
  "type": {
@@ -712,30 +781,12 @@
712
781
  },
713
782
  {
714
783
  "kind": "method",
715
- "name": "focus",
716
- "description": "Focuses the combobox trigger input.",
717
- "return": {
718
- "type": {
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.",
784
+ "name": "generateIconHtml",
785
+ "description": "Function to generate checkmark svg.",
786
+ "privacy": "private",
736
787
  "return": {
737
788
  "type": {
738
- "text": "void"
789
+ "text": "HTMLElement"
739
790
  }
740
791
  }
741
792
  },
@@ -751,162 +802,56 @@
751
802
  },
752
803
  {
753
804
  "kind": "method",
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.",
805
- "privacy": "private",
806
- "return": {
807
- "type": {
808
- "text": "void"
809
- }
810
- }
811
- },
812
- {
813
- "kind": "method",
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",
829
- "parameters": [
830
- {
831
- "name": "event",
832
- "description": "`slotchange` event.",
833
- "type": {
834
- "text": "Event"
835
- }
836
- }
837
- ],
838
- "description": "Watch for slot changes and recalculate the menuoptions.",
839
- "privacy": "private",
840
- "return": {
841
- "type": {
842
- "text": "void"
843
- }
844
- }
845
- },
846
- {
847
- "kind": "field",
848
- "name": "appearance",
849
- "privacy": "public",
850
- "type": {
851
- "text": "'default' | 'inverse'"
852
- },
853
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
854
- "default": "'default'",
855
- "attribute": "appearance",
856
- "reflects": true
857
- },
858
- {
859
- "kind": "field",
860
- "name": "autocomplete",
861
- "privacy": "public",
862
- "type": {
863
- "text": "string"
864
- },
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",
867
- "reflects": true
868
- },
869
- {
870
- "kind": "field",
871
- "name": "autoPlacement",
872
- "privacy": "public",
873
- "type": {
874
- "text": "boolean"
875
- },
876
- "description": "If declared, bib's position will be automatically calculated where to appear.",
877
- "attribute": "autoplacement",
878
- "reflects": true
805
+ "name": "updateAriaLabel",
806
+ "description": "Updates the aria-label based on slot content.",
807
+ "privacy": "private",
808
+ "return": {
809
+ "type": {
810
+ "text": "void"
811
+ }
812
+ }
879
813
  },
880
814
  {
881
- "kind": "field",
882
- "name": "availableOptions",
815
+ "kind": "method",
816
+ "name": "handleKeyDown",
817
+ "parameters": [
818
+ {
819
+ "name": "event",
820
+ "description": "The keydown event from the checkbox input.",
821
+ "type": {
822
+ "text": "KeyboardEvent"
823
+ }
824
+ }
825
+ ],
826
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
883
827
  "privacy": "private",
884
- "type": {
885
- "text": "HTMLElement[]"
886
- },
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)."
828
+ "return": {
829
+ "type": {
830
+ "text": "void"
831
+ }
832
+ }
888
833
  },
889
834
  {
890
835
  "kind": "field",
891
- "name": "behavior",
836
+ "name": "appearance",
892
837
  "privacy": "public",
893
838
  "type": {
894
- "text": "'filter' | 'suggestion'"
839
+ "text": "'default' | 'inverse'"
895
840
  },
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",
841
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
842
+ "default": "'default'",
843
+ "attribute": "appearance",
899
844
  "reflects": true
900
845
  },
901
846
  {
902
847
  "kind": "field",
903
- "name": "checkmark",
848
+ "name": "checked",
904
849
  "privacy": "public",
905
850
  "type": {
906
851
  "text": "boolean"
907
852
  },
908
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
909
- "attribute": "checkmark",
853
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
854
+ "attribute": "checked",
910
855
  "reflects": true
911
856
  },
912
857
  {
@@ -916,1039 +861,1173 @@
916
861
  "type": {
917
862
  "text": "boolean"
918
863
  },
919
- "description": "If set, disables the combobox.",
864
+ "description": "If set to true, the checkbox will not be clickable.",
920
865
  "attribute": "disabled",
921
866
  "reflects": true
922
867
  },
923
- {
924
- "kind": "field",
925
- "name": "dropdownId",
926
- "privacy": "private",
927
- "type": {
928
- "text": "string"
929
- },
930
- "description": "ID for the dropdown."
931
- },
932
- {
933
- "kind": "field",
934
- "name": "dropdownOpen",
935
- "privacy": "private",
936
- "type": {
937
- "text": "boolean"
938
- },
939
- "description": "Whether or not the dropdown is open."
940
- },
941
- {
942
- "kind": "field",
943
- "name": "dvInputOnly",
944
- "privacy": "public",
945
- "type": {
946
- "text": "boolean"
947
- },
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
951
- },
952
868
  {
953
869
  "kind": "field",
954
870
  "name": "error",
955
871
  "privacy": "public",
956
872
  "type": {
957
- "text": "string"
873
+ "text": "boolean"
958
874
  },
959
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
875
+ "description": "If set to true, the checkbox will be displayed with an error state.",
960
876
  "attribute": "error",
961
877
  "reflects": true
962
878
  },
963
879
  {
964
880
  "kind": "field",
965
- "name": "format",
881
+ "name": "id",
966
882
  "privacy": "public",
967
883
  "type": {
968
884
  "text": "string"
969
885
  },
970
- "description": "Specifies the input mask format.",
971
- "attribute": "format",
886
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
887
+ "attribute": "id",
972
888
  "reflects": true
973
889
  },
974
890
  {
975
891
  "kind": "field",
976
- "name": "inputmode",
977
- "privacy": "public",
892
+ "name": "inputId",
893
+ "privacy": "private",
978
894
  "type": {
979
895
  "text": "string"
980
896
  },
981
- "description": "Exposes inputmode attribute for input.",
982
- "attribute": "inputmode",
983
- "reflects": true
984
- },
985
- {
986
- "kind": "field",
987
- "name": "layout",
988
- "privacy": "public",
989
- "type": {
990
- "text": "'classic' | 'emphasized' | 'snowflake'"
991
- },
992
- "description": "Sets the layout of the combobox.",
993
- "default": "'classic'",
994
- "attribute": "layout",
995
- "reflects": true
897
+ "description": "The id for input node."
996
898
  },
997
899
  {
998
900
  "kind": "field",
999
- "name": "shape",
901
+ "name": "name",
1000
902
  "privacy": "public",
1001
903
  "type": {
1002
- "text": "'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'"
904
+ "text": "string"
1003
905
  },
1004
- "description": "Sets the shape of the combobox.",
1005
- "default": "'classic'",
1006
- "attribute": "shape",
1007
- "reflects": true
906
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
907
+ "attribute": "name"
1008
908
  },
1009
909
  {
1010
910
  "kind": "field",
1011
- "name": "size",
911
+ "name": "onDark",
1012
912
  "privacy": "public",
1013
913
  "type": {
1014
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
914
+ "text": "boolean"
1015
915
  },
1016
- "description": "Sets the size of the combobox.",
1017
- "default": "'xl'",
1018
- "attribute": "size",
916
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
917
+ "deprecated": "Use `appearance=\"inverse\"` instead.",
918
+ "attribute": "ondark",
1019
919
  "reflects": true
1020
920
  },
1021
921
  {
1022
922
  "kind": "field",
1023
- "name": "matchWidth",
923
+ "name": "touched",
1024
924
  "privacy": "private",
1025
925
  "type": {
1026
926
  "text": "boolean"
1027
927
  },
1028
- "description": "If declared, the popover and trigger will be set to the same width.",
1029
- "attribute": "matchwidth",
1030
- "reflects": true
928
+ "description": "Indicates whether the checkbox has been interacted with."
1031
929
  },
1032
930
  {
1033
931
  "kind": "field",
1034
- "name": "noFilter",
932
+ "name": "value",
1035
933
  "privacy": "public",
1036
934
  "type": {
1037
- "text": "boolean"
935
+ "text": "string"
1038
936
  },
1039
- "description": "If set, combobox will not filter menuoptions based on input.",
1040
- "attribute": "nofilter",
1041
- "reflects": true
937
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
938
+ "attribute": "value"
1042
939
  },
1043
940
  {
1044
941
  "kind": "field",
1045
- "name": "noFlip",
1046
- "privacy": "public",
942
+ "name": "tabIndex",
943
+ "privacy": "private",
1047
944
  "type": {
1048
- "text": "boolean"
945
+ "text": "number"
1049
946
  },
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",
947
+ "description": "The tabindex attribute for the checkbox.",
948
+ "attribute": "tabindex",
1052
949
  "reflects": true
1053
950
  },
1054
951
  {
1055
952
  "kind": "field",
1056
- "name": "shift",
1057
- "privacy": "public",
953
+ "name": "ariaChecked",
954
+ "privacy": "private",
1058
955
  "type": {
1059
- "text": "boolean"
956
+ "text": "string"
1060
957
  },
1061
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1062
- "attribute": "shift",
958
+ "description": "The aria-checked attribute for the checkbox.",
959
+ "attribute": "aria-checked",
1063
960
  "reflects": true
1064
961
  },
1065
962
  {
1066
963
  "kind": "field",
1067
- "name": "noValidate",
1068
- "privacy": "public",
964
+ "name": "ariaDisabled",
965
+ "privacy": "private",
1069
966
  "type": {
1070
- "text": "boolean"
967
+ "text": "string"
1071
968
  },
1072
- "description": "If set, disables auto-validation on blur.",
1073
- "attribute": "novalidate",
969
+ "description": "The aria-disabled attribute for the checkbox.",
970
+ "attribute": "aria-disabled",
1074
971
  "reflects": true
1075
972
  },
1076
973
  {
1077
974
  "kind": "field",
1078
- "name": "offset",
1079
- "privacy": "public",
975
+ "name": "role",
976
+ "privacy": "private",
1080
977
  "type": {
1081
- "text": "number"
978
+ "text": "string"
1082
979
  },
1083
- "description": "Gap between the trigger element and bib.",
1084
- "default": "0",
1085
- "attribute": "offset",
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",
1086
982
  "reflects": true
1087
- },
983
+ }
984
+ ],
985
+ "events": [
1088
986
  {
1089
- "kind": "field",
1090
- "name": "onDark",
1091
- "privacy": "public",
987
+ "name": "auroCheckbox-input",
1092
988
  "type": {
1093
- "text": "boolean"
989
+ "text": "CustomEvent"
1094
990
  },
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
- }
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."
1103
993
  },
1104
994
  {
1105
- "kind": "field",
1106
- "name": "optionSelected",
1107
- "privacy": "public",
995
+ "name": "auroCheckbox-focusin",
1108
996
  "type": {
1109
- "text": "HTMLElement"
997
+ "text": "CustomEvent"
1110
998
  },
1111
- "description": "Specifies the current selected option."
999
+ "description": "Notifies when the checkbox receives focus."
1112
1000
  },
1113
1001
  {
1114
- "kind": "field",
1115
- "name": "persistInput",
1116
- "privacy": "public",
1002
+ "name": "auroCheckbox-focusout",
1117
1003
  "type": {
1118
- "text": "boolean"
1004
+ "text": "CustomEvent"
1119
1005
  },
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
1006
+ "description": "Notifies when the checkbox loses focus."
1123
1007
  },
1124
1008
  {
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
1009
+ "description": "Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.",
1010
+ "name": "change",
1011
+ "deprecated": "Use the `input` event instead."
1135
1012
  },
1136
1013
  {
1137
- "kind": "field",
1138
- "name": "placeholder",
1139
- "privacy": "public",
1014
+ "description": "Notifies when checked value is changed by user's interface.",
1015
+ "name": "input"
1016
+ }
1017
+ ],
1018
+ "attributes": [
1019
+ {
1020
+ "name": "appearance",
1140
1021
  "type": {
1141
- "text": "string"
1022
+ "text": "'default' | 'inverse'"
1142
1023
  },
1143
- "description": "Define custom placeholder text, only supported by date input formats.",
1144
- "attribute": "placeholder",
1145
- "reflects": true
1024
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1025
+ "default": "'default'",
1026
+ "fieldName": "appearance"
1146
1027
  },
1147
1028
  {
1148
- "kind": "field",
1149
- "name": "required",
1150
- "privacy": "public",
1029
+ "name": "checked",
1151
1030
  "type": {
1152
1031
  "text": "boolean"
1153
1032
  },
1154
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1155
- "attribute": "required",
1156
- "reflects": true
1033
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
1034
+ "fieldName": "checked"
1157
1035
  },
1158
1036
  {
1159
- "kind": "field",
1160
- "name": "setCustomValidity",
1161
- "privacy": "public",
1037
+ "name": "disabled",
1162
1038
  "type": {
1163
- "text": "string"
1039
+ "text": "boolean"
1164
1040
  },
1165
- "description": "Sets a custom help text message to display for all validityStates.",
1166
- "attribute": "setcustomvalidity"
1041
+ "description": "If set to true, the checkbox will not be clickable.",
1042
+ "fieldName": "disabled"
1167
1043
  },
1168
1044
  {
1169
- "kind": "field",
1170
- "name": "setCustomValidityCustomError",
1171
- "privacy": "public",
1045
+ "name": "error",
1172
1046
  "type": {
1173
- "text": "string"
1047
+ "text": "boolean"
1174
1048
  },
1175
- "description": "Custom help text message to display when validity = `customError`.",
1176
- "attribute": "setcustomvaliditycustomerror"
1049
+ "description": "If set to true, the checkbox will be displayed with an error state.",
1050
+ "fieldName": "error"
1177
1051
  },
1178
1052
  {
1179
- "kind": "field",
1180
- "name": "setCustomValidityValueMissing",
1181
- "privacy": "public",
1053
+ "name": "id",
1182
1054
  "type": {
1183
1055
  "text": "string"
1184
1056
  },
1185
- "description": "Custom help text message to display when validity = `valueMissing`.",
1186
- "attribute": "setcustomvalidityvaluemissing"
1057
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
1058
+ "fieldName": "id"
1187
1059
  },
1188
1060
  {
1189
- "kind": "field",
1190
- "name": "setCustomValidityValueMissingFilter",
1191
- "privacy": "public",
1061
+ "name": "name",
1192
1062
  "type": {
1193
1063
  "text": "string"
1194
1064
  },
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"
1065
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
1066
+ "fieldName": "name"
1197
1067
  },
1198
1068
  {
1199
- "kind": "field",
1200
- "name": "touched",
1201
- "privacy": "private",
1069
+ "name": "ondark",
1202
1070
  "type": {
1203
1071
  "text": "boolean"
1204
1072
  },
1205
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1073
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1074
+ "deprecated": "Use `appearance=\"inverse\"` instead.",
1075
+ "fieldName": "onDark"
1206
1076
  },
1207
1077
  {
1208
- "kind": "field",
1209
- "name": "triggerIcon",
1210
- "privacy": "public",
1078
+ "name": "value",
1211
1079
  "type": {
1212
- "text": "boolean"
1080
+ "text": "string"
1213
1081
  },
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
1082
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1083
+ "fieldName": "value"
1217
1084
  },
1218
1085
  {
1219
- "kind": "field",
1220
- "name": "type",
1221
- "privacy": "public",
1086
+ "name": "tabindex",
1222
1087
  "type": {
1223
- "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
1088
+ "text": "number"
1224
1089
  },
1225
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1226
- "attribute": "type",
1227
- "reflects": true
1090
+ "description": "The tabindex attribute for the checkbox.",
1091
+ "fieldName": "tabIndex"
1228
1092
  },
1229
1093
  {
1230
- "kind": "field",
1231
- "name": "typedValue",
1232
- "privacy": "public",
1094
+ "name": "aria-checked",
1233
1095
  "type": {
1234
1096
  "text": "string"
1235
1097
  },
1236
- "description": "Specifies the value of the input element within the combobox.",
1237
- "attribute": "typedvalue",
1238
- "reflects": true
1098
+ "description": "The aria-checked attribute for the checkbox.",
1099
+ "fieldName": "ariaChecked"
1239
1100
  },
1240
1101
  {
1241
- "kind": "field",
1242
- "name": "validity",
1243
- "privacy": "public",
1102
+ "name": "aria-disabled",
1244
1103
  "type": {
1245
1104
  "text": "string"
1246
1105
  },
1247
- "description": "Specifies the `validityState` this element is in.",
1248
- "attribute": "validity",
1249
- "reflects": true
1106
+ "description": "The aria-disabled attribute for the checkbox.",
1107
+ "fieldName": "ariaDisabled"
1250
1108
  },
1251
1109
  {
1252
- "kind": "field",
1253
- "name": "value",
1254
- "privacy": "public",
1110
+ "name": "role",
1255
1111
  "type": {
1256
1112
  "text": "string"
1257
1113
  },
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"
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": [
1175
+ {
1176
+ "description": "The help text and error message content container.",
1177
+ "name": "helpText"
1178
+ }
1179
+ ],
1180
+ "slots": [
1181
+ {
1182
+ "description": "Default slot for the menu content.",
1183
+ "name": ""
1260
1184
  },
1261
1185
  {
1262
- "kind": "field",
1263
- "name": "largeFullscreenHeadline",
1264
- "privacy": "public",
1265
1186
  "type": {
1266
- "text": "boolean"
1187
+ "text": "HTMLSlotElement"
1267
1188
  },
1268
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1269
- "attribute": "largefullscreenheadline",
1270
- "reflects": true
1189
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1190
+ "name": "optionalLabel"
1271
1191
  },
1272
1192
  {
1273
- "kind": "field",
1274
- "name": "fullscreenBreakpoint",
1275
- "privacy": "public",
1276
- "type": {
1277
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1193
+ "description": "Sets aria-label on clear button",
1194
+ "name": "ariaLabel.input.clear"
1195
+ },
1196
+ {
1197
+ "description": "Sets aria-label on close button in fullscreen bib",
1198
+ "name": "ariaLabel.bib.close"
1199
+ },
1200
+ {
1201
+ "description": "Defines the headline to display above menu-options",
1202
+ "name": "bib.fullscreen.headline"
1203
+ },
1204
+ {
1205
+ "description": "Defines the content of the label.",
1206
+ "name": "label"
1207
+ },
1208
+ {
1209
+ "description": "Defines the content of the helpText.",
1210
+ "name": "helpText"
1211
+ },
1212
+ {
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": [
1218
+ {
1219
+ "kind": "method",
1220
+ "name": "_initializeDefaults",
1221
+ "privacy": "private",
1222
+ "return": {
1223
+ "type": {
1224
+ "text": "void"
1225
+ }
1226
+ }
1227
+ },
1228
+ {
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
+ }
1278
1252
  },
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
1253
+ "privacy": "private"
1283
1254
  },
1284
1255
  {
1285
1256
  "kind": "field",
1286
- "name": "optionActive",
1287
- "privacy": "private",
1288
- "type": {
1289
- "text": "HTMLElement"
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
+ }
1290
1263
  },
1291
- "description": "Specifies the currently active option."
1264
+ "readonly": true
1292
1265
  },
1293
1266
  {
1294
- "kind": "field",
1295
- "name": "componentHasFocus",
1296
- "description": "Returns true if the element has focus.",
1297
- "privacy": "private",
1267
+ "kind": "method",
1268
+ "name": "isValid",
1269
+ "description": "Checks if the element is valid.",
1298
1270
  "return": {
1299
1271
  "type": {
1300
1272
  "text": "boolean"
1301
1273
  }
1302
- },
1303
- "readonly": true,
1304
- "inheritedFrom": {
1305
- "name": "AuroElement",
1306
- "module": "components/layoutElement/src/auroElement.js"
1307
1274
  }
1308
1275
  },
1309
1276
  {
1310
1277
  "kind": "method",
1311
- "name": "resetShapeClasses",
1312
- "inheritedFrom": {
1313
- "name": "AuroElement",
1314
- "module": "components/layoutElement/src/auroElement.js"
1315
- }
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."
1316
1292
  },
1317
1293
  {
1318
1294
  "kind": "method",
1319
- "name": "resetLayoutClasses",
1320
- "inheritedFrom": {
1321
- "name": "AuroElement",
1322
- "module": "components/layoutElement/src/auroElement.js"
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
+ }
1323
1302
  }
1324
1303
  },
1325
1304
  {
1326
1305
  "kind": "method",
1327
- "name": "updateComponentArchitecture",
1328
- "inheritedFrom": {
1329
- "name": "AuroElement",
1330
- "module": "components/layoutElement/src/auroElement.js"
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
+ }
1331
1313
  }
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."
1341
- },
1342
- {
1343
- "name": "input",
1344
- "type": {
1345
- "text": "CustomEvent"
1346
- },
1347
- "description": "Notifies that the component has a new value set."
1348
- },
1349
- {
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."
1356
- },
1357
- {
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"
1371
1314
  },
1372
1315
  {
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"
1316
+ "kind": "method",
1317
+ "name": "updateFilter",
1318
+ "description": "Updates the filter for the available options based on the input value.",
1319
+ "privacy": "private"
1379
1320
  },
1380
1321
  {
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"
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
+ }
1387
1331
  },
1388
1332
  {
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"
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"
1396
1346
  },
1397
1347
  {
1398
- "name": "checkmark",
1399
- "type": {
1400
- "text": "boolean"
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
+ }
1401
1364
  },
1402
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1403
- "fieldName": "checkmark"
1365
+ "privacy": "private"
1404
1366
  },
1405
1367
  {
1406
- "name": "disabled",
1407
- "type": {
1408
- "text": "boolean"
1409
- },
1410
- "description": "If set, disables the combobox.",
1411
- "fieldName": "disabled"
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.",
1385
+ "privacy": "private",
1386
+ "return": {
1387
+ "type": {
1388
+ "text": "void"
1389
+ }
1390
+ }
1412
1391
  },
1413
1392
  {
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"
1393
+ "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
+ }
1401
+ }
1420
1402
  },
1421
1403
  {
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"
1404
+ "kind": "method",
1405
+ "name": "hideBib",
1406
+ "description": "Hides the dropdown bib if its open.",
1407
+ "return": {
1408
+ "type": {
1409
+ "text": "void"
1410
+ }
1411
+ }
1428
1412
  },
1429
1413
  {
1430
- "name": "format",
1431
- "type": {
1432
- "text": "string"
1433
- },
1434
- "description": "Specifies the input mask format.",
1435
- "fieldName": "format"
1414
+ "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
+ }
1421
+ }
1436
1422
  },
1437
1423
  {
1438
- "name": "inputmode",
1439
- "type": {
1440
- "text": "string"
1441
- },
1442
- "description": "Exposes inputmode attribute for input.",
1443
- "fieldName": "inputmode"
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
+ }
1444
1433
  },
1445
1434
  {
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"
1435
+ "kind": "method",
1436
+ "name": "setClearBtnFocus",
1437
+ "privacy": "private"
1453
1438
  },
1454
1439
  {
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"
1440
+ "kind": "method",
1441
+ "name": "setTriggerInputFocus",
1442
+ "privacy": "private"
1462
1443
  },
1463
1444
  {
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"
1445
+ "kind": "method",
1446
+ "name": "setInputFocus",
1447
+ "privacy": "private"
1471
1448
  },
1472
1449
  {
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"
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"
1479
1454
  },
1480
1455
  {
1481
- "name": "nofilter",
1482
- "type": {
1483
- "text": "boolean"
1484
- },
1485
- "description": "If set, combobox will not filter menuoptions based on input.",
1486
- "fieldName": "noFilter"
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"
1487
1460
  },
1488
1461
  {
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"
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
+ }
1495
1471
  },
1496
1472
  {
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"
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
+ }
1503
1482
  },
1504
1483
  {
1505
- "name": "novalidate",
1506
- "type": {
1507
- "text": "boolean"
1508
- },
1509
- "description": "If set, disables auto-validation on blur.",
1510
- "fieldName": "noValidate"
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
+ }
1511
1493
  },
1512
1494
  {
1513
- "name": "offset",
1514
- "type": {
1515
- "text": "number"
1516
- },
1517
- "description": "Gap between the trigger element and bib.",
1518
- "default": "0",
1519
- "fieldName": "offset"
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
+ }
1520
1513
  },
1521
1514
  {
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"
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
+ }
1532
1546
  }
1533
1547
  },
1534
1548
  {
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"
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
+ }
1541
1567
  },
1542
1568
  {
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"
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
+ }
1550
1587
  },
1551
1588
  {
1552
- "name": "placeholder",
1553
- "type": {
1554
- "text": "string"
1555
- },
1556
- "description": "Define custom placeholder text, only supported by date input formats.",
1557
- "fieldName": "placeholder"
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
+ }
1558
1598
  },
1559
1599
  {
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"
1600
+ "kind": "method",
1601
+ "name": "focus",
1602
+ "description": "Focuses the combobox trigger input.",
1603
+ "return": {
1604
+ "type": {
1605
+ "text": "void"
1606
+ }
1607
+ }
1566
1608
  },
1567
1609
  {
1568
- "name": "setcustomvalidity",
1569
- "type": {
1570
- "text": "string"
1571
- },
1572
- "description": "Sets a custom help text message to display for all validityStates.",
1573
- "fieldName": "setCustomValidity"
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
+ }
1627
+ },
1628
+ {
1629
+ "kind": "method",
1630
+ "name": "reset",
1631
+ "description": "Resets component to initial state.",
1632
+ "return": {
1633
+ "type": {
1634
+ "text": "void"
1635
+ }
1636
+ }
1574
1637
  },
1575
1638
  {
1576
- "name": "setcustomvaliditycustomerror",
1577
- "type": {
1578
- "text": "string"
1579
- },
1580
- "description": "Custom help text message to display when validity = `customError`.",
1581
- "fieldName": "setCustomValidityCustomError"
1639
+ "kind": "method",
1640
+ "name": "clear",
1641
+ "description": "Clears the current value of the combobox.",
1642
+ "return": {
1643
+ "type": {
1644
+ "text": "void"
1645
+ }
1646
+ }
1582
1647
  },
1583
1648
  {
1584
- "name": "setcustomvalidityvaluemissing",
1585
- "type": {
1586
- "text": "string"
1587
- },
1588
- "description": "Custom help text message to display when validity = `valueMissing`.",
1589
- "fieldName": "setCustomValidityValueMissing"
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."
1590
1663
  },
1591
1664
  {
1592
- "name": "setcustomvalidityvaluemissingfilter",
1593
- "type": {
1594
- "text": "string"
1595
- },
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"
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
+ }
1696
+ }
1598
1697
  },
1599
1698
  {
1600
- "name": "triggericon",
1601
- "type": {
1602
- "text": "boolean"
1603
- },
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"
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."
1606
1711
  },
1607
1712
  {
1608
- "name": "type",
1609
- "type": {
1610
- "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
1611
- },
1612
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1613
- "fieldName": "type"
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
+ }
1614
1731
  },
1615
1732
  {
1616
- "name": "typedvalue",
1733
+ "kind": "field",
1734
+ "name": "appearance",
1735
+ "privacy": "public",
1617
1736
  "type": {
1618
- "text": "string"
1737
+ "text": "'default' | 'inverse'"
1619
1738
  },
1620
- "description": "Specifies the value of the input element within the combobox.",
1621
- "fieldName": "typedValue"
1739
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1740
+ "default": "'default'",
1741
+ "attribute": "appearance",
1742
+ "reflects": true
1622
1743
  },
1623
1744
  {
1624
- "name": "validity",
1745
+ "kind": "field",
1746
+ "name": "autocomplete",
1747
+ "privacy": "public",
1625
1748
  "type": {
1626
1749
  "text": "string"
1627
1750
  },
1628
- "description": "Specifies the `validityState` this element is in.",
1629
- "fieldName": "validity"
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
1630
1754
  },
1631
1755
  {
1632
- "name": "value",
1756
+ "kind": "field",
1757
+ "name": "autoPlacement",
1758
+ "privacy": "public",
1633
1759
  "type": {
1634
- "text": "string"
1760
+ "text": "boolean"
1635
1761
  },
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"
1762
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1763
+ "attribute": "autoplacement",
1764
+ "reflects": true
1638
1765
  },
1639
1766
  {
1640
- "name": "largefullscreenheadline",
1767
+ "kind": "field",
1768
+ "name": "availableOptions",
1769
+ "privacy": "private",
1641
1770
  "type": {
1642
- "text": "boolean"
1771
+ "text": "HTMLElement[]"
1643
1772
  },
1644
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1645
- "fieldName": "largeFullscreenHeadline"
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)."
1646
1774
  },
1647
1775
  {
1648
- "name": "fullscreenbreakpoint",
1776
+ "kind": "field",
1777
+ "name": "behavior",
1778
+ "privacy": "public",
1649
1779
  "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": [
1780
+ "text": "'filter' | 'suggestion'"
1781
+ },
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
1786
+ },
1739
1787
  {
1740
- "description": "Apply css to the fieldset element in the shadow DOM",
1741
- "name": "checkbox-group"
1788
+ "kind": "field",
1789
+ "name": "checkmark",
1790
+ "privacy": "public",
1791
+ "type": {
1792
+ "text": "boolean"
1793
+ },
1794
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1795
+ "attribute": "checkmark",
1796
+ "reflects": true
1742
1797
  },
1743
1798
  {
1744
- "description": "Apply css to the help text element that displays helper or error messages.",
1745
- "name": "helpText"
1746
- }
1747
- ],
1748
- "slots": [
1799
+ "kind": "field",
1800
+ "name": "disabled",
1801
+ "privacy": "public",
1802
+ "type": {
1803
+ "text": "boolean"
1804
+ },
1805
+ "description": "If set, disables the combobox.",
1806
+ "attribute": "disabled",
1807
+ "reflects": true
1808
+ },
1749
1809
  {
1750
- "description": "Allows for the legend to be overridden.",
1751
- "name": "legend"
1810
+ "kind": "field",
1811
+ "name": "dropdownId",
1812
+ "privacy": "private",
1813
+ "type": {
1814
+ "text": "string"
1815
+ },
1816
+ "description": "ID for the dropdown."
1752
1817
  },
1753
1818
  {
1754
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1755
- "name": "optionalLabel"
1819
+ "kind": "field",
1820
+ "name": "dropdownOpen",
1821
+ "privacy": "private",
1822
+ "type": {
1823
+ "text": "boolean"
1824
+ },
1825
+ "description": "Whether or not the dropdown is open."
1756
1826
  },
1757
1827
  {
1758
- "description": "Allows for the helper text to be overridden.",
1759
- "name": "helpText"
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
1760
1837
  },
1761
1838
  {
1762
- "description": "The default slot for the checkbox items.",
1763
- "name": "default"
1764
- }
1765
- ],
1766
- "members": [
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
1848
+ },
1767
1849
  {
1768
- "kind": "method",
1769
- "name": "_initializeDefaults"
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
1770
1859
  },
1771
1860
  {
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."
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
1787
1870
  },
1788
1871
  {
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
- }
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
1814
1882
  },
1815
1883
  {
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
- }
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
1825
1894
  },
1826
1895
  {
1827
- "kind": "method",
1828
- "name": "handleItems",
1829
- "description": "Helper method that handles the state of checkboxes.",
1830
- "privacy": "private",
1831
- "return": {
1832
- "type": {
1833
- "text": "void"
1834
- }
1835
- }
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
1836
1906
  },
1837
1907
  {
1838
1908
  "kind": "field",
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.",
1909
+ "name": "matchWidth",
1841
1910
  "privacy": "private",
1842
- "return": {
1843
- "type": {
1844
- "text": "boolean"
1845
- }
1911
+ "type": {
1912
+ "text": "boolean"
1846
1913
  },
1847
- "readonly": true
1914
+ "description": "If declared, the popover and trigger will be set to the same width.",
1915
+ "attribute": "matchwidth",
1916
+ "reflects": true
1848
1917
  },
1849
1918
  {
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
- }
1919
+ "kind": "field",
1920
+ "name": "noFilter",
1921
+ "privacy": "public",
1922
+ "type": {
1923
+ "text": "boolean"
1924
+ },
1925
+ "description": "If set, combobox will not filter menuoptions based on input.",
1926
+ "attribute": "nofilter",
1927
+ "reflects": true
1859
1928
  },
1860
1929
  {
1861
- "kind": "method",
1862
- "name": "reset",
1863
- "description": "Resets component to initial state.",
1864
- "return": {
1865
- "type": {
1866
- "text": "void"
1867
- }
1868
- }
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
1869
1939
  },
1870
1940
  {
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."
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
1950
+ },
1951
+ {
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
1885
1961
  },
1886
1962
  {
1887
1963
  "kind": "field",
1888
- "name": "appearance",
1964
+ "name": "offset",
1889
1965
  "privacy": "public",
1890
1966
  "type": {
1891
- "text": "'default' | 'inverse'"
1967
+ "text": "number"
1892
1968
  },
1893
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1894
- "default": "'default'",
1895
- "attribute": "appearance",
1969
+ "description": "Gap between the trigger element and bib.",
1970
+ "default": "0",
1971
+ "attribute": "offset",
1896
1972
  "reflects": true
1897
1973
  },
1898
1974
  {
1899
1975
  "kind": "field",
1900
- "name": "disabled",
1976
+ "name": "onDark",
1901
1977
  "privacy": "public",
1902
1978
  "type": {
1903
1979
  "text": "boolean"
1904
1980
  },
1905
- "description": "If set, disables the checkbox group.",
1906
- "attribute": "disabled",
1907
- "reflects": true
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
+ }
1908
1989
  },
1909
1990
  {
1910
1991
  "kind": "field",
1911
- "name": "error",
1992
+ "name": "optionSelected",
1912
1993
  "privacy": "public",
1913
1994
  "type": {
1914
- "text": "string"
1995
+ "text": "HTMLElement"
1915
1996
  },
1916
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1917
- "attribute": "error",
1918
- "reflects": true
1997
+ "description": "Specifies the current selected option."
1919
1998
  },
1920
1999
  {
1921
2000
  "kind": "field",
1922
- "name": "horizontal",
2001
+ "name": "persistInput",
1923
2002
  "privacy": "public",
1924
2003
  "type": {
1925
2004
  "text": "boolean"
1926
2005
  },
1927
- "description": "If set, checkboxes will be aligned horizontally.",
1928
- "attribute": "horizontal",
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",
1929
2008
  "reflects": true
1930
2009
  },
1931
2010
  {
1932
2011
  "kind": "field",
1933
- "name": "noValidate",
2012
+ "name": "placement",
1934
2013
  "privacy": "public",
1935
2014
  "type": {
1936
- "text": "boolean"
2015
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1937
2016
  },
1938
- "description": "If set, disables auto-validation on blur.",
1939
- "attribute": "novalidate",
2017
+ "description": "Position where the bib should appear relative to the trigger.",
2018
+ "default": "'bottom-start'",
2019
+ "attribute": "placement",
1940
2020
  "reflects": true
1941
2021
  },
1942
2022
  {
1943
2023
  "kind": "field",
1944
- "name": "onDark",
2024
+ "name": "placeholder",
1945
2025
  "privacy": "public",
1946
2026
  "type": {
1947
- "text": "boolean"
2027
+ "text": "string"
1948
2028
  },
1949
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1950
- "deprecated": "Use `appearance=\"inverse\"` instead.",
1951
- "attribute": "ondark",
2029
+ "description": "Define custom placeholder text, only supported by date input formats.",
2030
+ "attribute": "placeholder",
1952
2031
  "reflects": true
1953
2032
  },
1954
2033
  {
@@ -1958,7 +2037,7 @@
1958
2037
  "type": {
1959
2038
  "text": "boolean"
1960
2039
  },
1961
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
2040
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1962
2041
  "attribute": "required",
1963
2042
  "reflects": true
1964
2043
  },
@@ -1994,624 +2073,545 @@
1994
2073
  },
1995
2074
  {
1996
2075
  "kind": "field",
1997
- "name": "validity",
2076
+ "name": "setCustomValidityValueMissingFilter",
1998
2077
  "privacy": "public",
1999
2078
  "type": {
2000
2079
  "text": "string"
2001
2080
  },
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."
2014
- },
2015
- {
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",
2032
- "type": {
2033
- "text": "boolean"
2034
- },
2035
- "description": "If set, disables the checkbox group.",
2036
- "fieldName": "disabled"
2037
- },
2038
- {
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",
2048
- "type": {
2049
- "text": "boolean"
2050
- },
2051
- "description": "If set, checkboxes will be aligned horizontally.",
2052
- "fieldName": "horizontal"
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"
2053
2083
  },
2054
2084
  {
2055
- "name": "novalidate",
2085
+ "kind": "field",
2086
+ "name": "touched",
2087
+ "privacy": "private",
2056
2088
  "type": {
2057
2089
  "text": "boolean"
2058
2090
  },
2059
- "description": "If set, disables auto-validation on blur.",
2060
- "fieldName": "noValidate"
2091
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
2061
2092
  },
2062
2093
  {
2063
- "name": "ondark",
2094
+ "kind": "field",
2095
+ "name": "triggerIcon",
2096
+ "privacy": "public",
2064
2097
  "type": {
2065
2098
  "text": "boolean"
2066
2099
  },
2067
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2068
- "deprecated": "Use `appearance=\"inverse\"` instead.",
2069
- "fieldName": "onDark"
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
2070
2103
  },
2071
2104
  {
2072
- "name": "required",
2105
+ "kind": "field",
2106
+ "name": "type",
2107
+ "privacy": "public",
2073
2108
  "type": {
2074
- "text": "boolean"
2109
+ "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
2075
2110
  },
2076
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
2077
- "fieldName": "required"
2111
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2112
+ "attribute": "type",
2113
+ "reflects": true
2078
2114
  },
2079
2115
  {
2080
- "name": "setcustomvalidity",
2116
+ "kind": "field",
2117
+ "name": "typedValue",
2118
+ "privacy": "public",
2081
2119
  "type": {
2082
2120
  "text": "string"
2083
2121
  },
2084
- "description": "Sets a custom help text message to display for all validityStates.",
2085
- "fieldName": "setCustomValidity"
2122
+ "description": "Specifies the value of the input element within the combobox.",
2123
+ "attribute": "typedvalue",
2124
+ "reflects": true
2086
2125
  },
2087
2126
  {
2088
- "name": "setcustomvaliditycustomerror",
2127
+ "kind": "field",
2128
+ "name": "validity",
2129
+ "privacy": "public",
2089
2130
  "type": {
2090
2131
  "text": "string"
2091
2132
  },
2092
- "description": "Custom help text message to display when validity = `customError`.",
2093
- "fieldName": "setCustomValidityCustomError"
2133
+ "description": "Specifies the `validityState` this element is in.",
2134
+ "attribute": "validity",
2135
+ "reflects": true
2094
2136
  },
2095
2137
  {
2096
- "name": "setcustomvalidityvaluemissing",
2138
+ "kind": "field",
2139
+ "name": "value",
2140
+ "privacy": "public",
2097
2141
  "type": {
2098
2142
  "text": "string"
2099
2143
  },
2100
- "description": "Custom help text message to display when validity = `valueMissing`.",
2101
- "fieldName": "setCustomValidityValueMissing"
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"
2102
2146
  },
2103
2147
  {
2104
- "name": "validity",
2148
+ "kind": "field",
2149
+ "name": "largeFullscreenHeadline",
2150
+ "privacy": "public",
2105
2151
  "type": {
2106
- "text": "string"
2152
+ "text": "boolean"
2107
2153
  },
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."
2154
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2155
+ "attribute": "largefullscreenheadline",
2156
+ "reflects": true
2180
2157
  },
2181
2158
  {
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
- }
2159
+ "kind": "field",
2160
+ "name": "fullscreenBreakpoint",
2161
+ "privacy": "public",
2162
+ "type": {
2163
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2164
+ },
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
2200
2169
  },
2201
2170
  {
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.",
2171
+ "kind": "field",
2172
+ "name": "optionActive",
2214
2173
  "privacy": "private",
2215
- "return": {
2216
- "type": {
2217
- "text": "void"
2218
- }
2219
- }
2174
+ "type": {
2175
+ "text": "HTMLElement"
2176
+ },
2177
+ "description": "Specifies the currently active option."
2220
2178
  },
2221
2179
  {
2222
- "kind": "method",
2223
- "name": "handleFocusin",
2224
- "description": "Function to support",
2180
+ "kind": "field",
2181
+ "name": "componentHasFocus",
2182
+ "description": "Returns true if the element has focus.",
2225
2183
  "privacy": "private",
2226
2184
  "return": {
2227
2185
  "type": {
2228
- "text": "void"
2186
+ "text": "boolean"
2229
2187
  }
2188
+ },
2189
+ "readonly": true,
2190
+ "inheritedFrom": {
2191
+ "name": "AuroElement",
2192
+ "module": "components/layoutElement/src/auroElement.js"
2230
2193
  }
2231
2194
  },
2232
2195
  {
2233
2196
  "kind": "method",
2234
- "name": "generateIconHtml",
2235
- "description": "Function to generate checkmark svg.",
2236
- "privacy": "private",
2237
- "return": {
2238
- "type": {
2239
- "text": "HTMLElement"
2240
- }
2197
+ "name": "resetShapeClasses",
2198
+ "inheritedFrom": {
2199
+ "name": "AuroElement",
2200
+ "module": "components/layoutElement/src/auroElement.js"
2241
2201
  }
2242
2202
  },
2243
2203
  {
2244
2204
  "kind": "method",
2245
- "name": "reset",
2246
- "description": "Resets component to initial state.",
2247
- "return": {
2248
- "type": {
2249
- "text": "void"
2250
- }
2205
+ "name": "resetLayoutClasses",
2206
+ "inheritedFrom": {
2207
+ "name": "AuroElement",
2208
+ "module": "components/layoutElement/src/auroElement.js"
2251
2209
  }
2252
2210
  },
2253
2211
  {
2254
2212
  "kind": "method",
2255
- "name": "updateAriaLabel",
2256
- "description": "Updates the aria-label based on slot content.",
2257
- "privacy": "private",
2258
- "return": {
2259
- "type": {
2260
- "text": "void"
2261
- }
2213
+ "name": "updateComponentArchitecture",
2214
+ "inheritedFrom": {
2215
+ "name": "AuroElement",
2216
+ "module": "components/layoutElement/src/auroElement.js"
2262
2217
  }
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."
2263
2227
  },
2264
2228
  {
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
- }
2229
+ "name": "input",
2230
+ "type": {
2231
+ "text": "CustomEvent"
2232
+ },
2233
+ "description": "Notifies that the component has a new value set."
2283
2234
  },
2284
2235
  {
2285
- "kind": "field",
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."
2242
+ },
2243
+ {
2244
+ "description": "Notifies that the component value(s) have been validated.",
2245
+ "name": "auroFormElement-validated"
2246
+ }
2247
+ ],
2248
+ "attributes": [
2249
+ {
2286
2250
  "name": "appearance",
2287
- "privacy": "public",
2288
2251
  "type": {
2289
2252
  "text": "'default' | 'inverse'"
2290
2253
  },
2291
2254
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
2292
2255
  "default": "'default'",
2293
- "attribute": "appearance",
2294
- "reflects": true
2256
+ "fieldName": "appearance"
2295
2257
  },
2296
2258
  {
2297
- "kind": "field",
2298
- "name": "checked",
2299
- "privacy": "public",
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",
2300
2268
  "type": {
2301
2269
  "text": "boolean"
2302
2270
  },
2303
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2304
- "attribute": "checked",
2305
- "reflects": true
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"
2282
+ },
2283
+ {
2284
+ "name": "checkmark",
2285
+ "type": {
2286
+ "text": "boolean"
2287
+ },
2288
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
2289
+ "fieldName": "checkmark"
2306
2290
  },
2307
2291
  {
2308
- "kind": "field",
2309
2292
  "name": "disabled",
2310
- "privacy": "public",
2311
2293
  "type": {
2312
2294
  "text": "boolean"
2313
2295
  },
2314
- "description": "If set to true, the checkbox will not be clickable.",
2315
- "attribute": "disabled",
2316
- "reflects": true
2296
+ "description": "If set, disables the combobox.",
2297
+ "fieldName": "disabled"
2317
2298
  },
2318
2299
  {
2319
- "kind": "field",
2320
- "name": "error",
2321
- "privacy": "public",
2300
+ "name": "dvinputonly",
2322
2301
  "type": {
2323
2302
  "text": "boolean"
2324
2303
  },
2325
- "description": "If set to true, the checkbox will be displayed with an error state.",
2326
- "attribute": "error",
2327
- "reflects": true
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"
2328
2306
  },
2329
2307
  {
2330
- "kind": "field",
2331
- "name": "id",
2332
- "privacy": "public",
2308
+ "name": "error",
2333
2309
  "type": {
2334
2310
  "text": "string"
2335
2311
  },
2336
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2337
- "attribute": "id",
2338
- "reflects": true
2312
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2313
+ "fieldName": "error"
2339
2314
  },
2340
2315
  {
2341
- "kind": "field",
2342
- "name": "inputId",
2343
- "privacy": "private",
2316
+ "name": "format",
2344
2317
  "type": {
2345
2318
  "text": "string"
2346
2319
  },
2347
- "description": "The id for input node."
2320
+ "description": "Specifies the input mask format.",
2321
+ "fieldName": "format"
2348
2322
  },
2349
2323
  {
2350
- "kind": "field",
2351
- "name": "name",
2352
- "privacy": "public",
2324
+ "name": "inputmode",
2353
2325
  "type": {
2354
2326
  "text": "string"
2355
2327
  },
2356
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2357
- "attribute": "name"
2328
+ "description": "Exposes inputmode attribute for input.",
2329
+ "fieldName": "inputmode"
2358
2330
  },
2359
2331
  {
2360
- "kind": "field",
2361
- "name": "onDark",
2362
- "privacy": "public",
2332
+ "name": "layout",
2363
2333
  "type": {
2364
- "text": "boolean"
2334
+ "text": "'classic' | 'emphasized' | 'snowflake'"
2365
2335
  },
2366
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2367
- "deprecated": "Use `appearance=\"inverse\"` instead.",
2368
- "attribute": "ondark",
2369
- "reflects": true
2336
+ "description": "Sets the layout of the combobox.",
2337
+ "default": "'classic'",
2338
+ "fieldName": "layout"
2370
2339
  },
2371
2340
  {
2372
- "kind": "field",
2373
- "name": "touched",
2374
- "privacy": "private",
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"
2348
+ },
2349
+ {
2350
+ "name": "size",
2351
+ "type": {
2352
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
2353
+ },
2354
+ "description": "Sets the size of the combobox.",
2355
+ "default": "'xl'",
2356
+ "fieldName": "size"
2357
+ },
2358
+ {
2359
+ "name": "matchwidth",
2375
2360
  "type": {
2376
2361
  "text": "boolean"
2377
2362
  },
2378
- "description": "Indicates whether the checkbox has been interacted with."
2363
+ "description": "If declared, the popover and trigger will be set to the same width.",
2364
+ "fieldName": "matchWidth"
2379
2365
  },
2380
2366
  {
2381
- "kind": "field",
2382
- "name": "value",
2383
- "privacy": "public",
2367
+ "name": "nofilter",
2384
2368
  "type": {
2385
- "text": "string"
2369
+ "text": "boolean"
2386
2370
  },
2387
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2388
- "attribute": "value"
2371
+ "description": "If set, combobox will not filter menuoptions based on input.",
2372
+ "fieldName": "noFilter"
2389
2373
  },
2390
2374
  {
2391
- "kind": "field",
2392
- "name": "tabIndex",
2393
- "privacy": "private",
2375
+ "name": "noflip",
2394
2376
  "type": {
2395
- "text": "number"
2377
+ "text": "boolean"
2396
2378
  },
2397
- "description": "The tabindex attribute for the checkbox.",
2398
- "attribute": "tabindex",
2399
- "reflects": true
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"
2400
2381
  },
2401
2382
  {
2402
- "kind": "field",
2403
- "name": "ariaChecked",
2404
- "privacy": "private",
2383
+ "name": "shift",
2405
2384
  "type": {
2406
- "text": "string"
2385
+ "text": "boolean"
2407
2386
  },
2408
- "description": "The aria-checked attribute for the checkbox.",
2409
- "attribute": "aria-checked",
2410
- "reflects": true
2387
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2388
+ "fieldName": "shift"
2411
2389
  },
2412
2390
  {
2413
- "kind": "field",
2414
- "name": "ariaDisabled",
2415
- "privacy": "private",
2391
+ "name": "novalidate",
2416
2392
  "type": {
2417
- "text": "string"
2393
+ "text": "boolean"
2418
2394
  },
2419
- "description": "The aria-disabled attribute for the checkbox.",
2420
- "attribute": "aria-disabled",
2421
- "reflects": true
2395
+ "description": "If set, disables auto-validation on blur.",
2396
+ "fieldName": "noValidate"
2422
2397
  },
2423
2398
  {
2424
- "kind": "field",
2425
- "name": "role",
2426
- "privacy": "private",
2399
+ "name": "offset",
2427
2400
  "type": {
2428
- "text": "string"
2401
+ "text": "number"
2429
2402
  },
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": [
2403
+ "description": "Gap between the trigger element and bib.",
2404
+ "default": "0",
2405
+ "fieldName": "offset"
2406
+ },
2436
2407
  {
2437
- "name": "auroCheckbox-input",
2408
+ "name": "ondark",
2438
2409
  "type": {
2439
- "text": "CustomEvent"
2410
+ "text": "boolean"
2440
2411
  },
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."
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
+ }
2443
2419
  },
2444
2420
  {
2445
- "name": "auroCheckbox-focusin",
2421
+ "name": "persistinput",
2446
2422
  "type": {
2447
- "text": "CustomEvent"
2423
+ "text": "boolean"
2448
2424
  },
2449
- "description": "Notifies when the checkbox receives focus."
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"
2450
2427
  },
2451
2428
  {
2452
- "name": "auroCheckbox-focusout",
2429
+ "name": "placement",
2453
2430
  "type": {
2454
- "text": "CustomEvent"
2431
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2455
2432
  },
2456
- "description": "Notifies when the checkbox loses focus."
2457
- },
2458
- {
2459
- "description": "Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.",
2460
- "name": "change",
2461
- "deprecated": "Use the `input` event instead."
2433
+ "description": "Position where the bib should appear relative to the trigger.",
2434
+ "default": "'bottom-start'",
2435
+ "fieldName": "placement"
2462
2436
  },
2463
2437
  {
2464
- "description": "Notifies when checked value is changed by user's interface.",
2465
- "name": "input"
2466
- }
2467
- ],
2468
- "attributes": [
2469
- {
2470
- "name": "appearance",
2438
+ "name": "placeholder",
2471
2439
  "type": {
2472
- "text": "'default' | 'inverse'"
2440
+ "text": "string"
2473
2441
  },
2474
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2475
- "default": "'default'",
2476
- "fieldName": "appearance"
2442
+ "description": "Define custom placeholder text, only supported by date input formats.",
2443
+ "fieldName": "placeholder"
2477
2444
  },
2478
2445
  {
2479
- "name": "checked",
2446
+ "name": "required",
2480
2447
  "type": {
2481
2448
  "text": "boolean"
2482
2449
  },
2483
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2484
- "fieldName": "checked"
2450
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2451
+ "fieldName": "required"
2485
2452
  },
2486
2453
  {
2487
- "name": "disabled",
2454
+ "name": "setcustomvalidity",
2488
2455
  "type": {
2489
- "text": "boolean"
2456
+ "text": "string"
2490
2457
  },
2491
- "description": "If set to true, the checkbox will not be clickable.",
2492
- "fieldName": "disabled"
2458
+ "description": "Sets a custom help text message to display for all validityStates.",
2459
+ "fieldName": "setCustomValidity"
2493
2460
  },
2494
2461
  {
2495
- "name": "error",
2462
+ "name": "setcustomvaliditycustomerror",
2496
2463
  "type": {
2497
- "text": "boolean"
2464
+ "text": "string"
2498
2465
  },
2499
- "description": "If set to true, the checkbox will be displayed with an error state.",
2500
- "fieldName": "error"
2466
+ "description": "Custom help text message to display when validity = `customError`.",
2467
+ "fieldName": "setCustomValidityCustomError"
2501
2468
  },
2502
2469
  {
2503
- "name": "id",
2470
+ "name": "setcustomvalidityvaluemissing",
2504
2471
  "type": {
2505
2472
  "text": "string"
2506
2473
  },
2507
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2508
- "fieldName": "id"
2474
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2475
+ "fieldName": "setCustomValidityValueMissing"
2509
2476
  },
2510
2477
  {
2511
- "name": "name",
2478
+ "name": "setcustomvalidityvaluemissingfilter",
2512
2479
  "type": {
2513
2480
  "text": "string"
2514
2481
  },
2515
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2516
- "fieldName": "name"
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"
2517
2484
  },
2518
2485
  {
2519
- "name": "ondark",
2486
+ "name": "triggericon",
2520
2487
  "type": {
2521
2488
  "text": "boolean"
2522
2489
  },
2523
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2524
- "deprecated": "Use `appearance=\"inverse\"` instead.",
2525
- "fieldName": "onDark"
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"
2526
2492
  },
2527
2493
  {
2528
- "name": "value",
2494
+ "name": "type",
2529
2495
  "type": {
2530
- "text": "string"
2496
+ "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
2531
2497
  },
2532
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2533
- "fieldName": "value"
2498
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2499
+ "fieldName": "type"
2534
2500
  },
2535
2501
  {
2536
- "name": "tabindex",
2502
+ "name": "typedvalue",
2537
2503
  "type": {
2538
- "text": "number"
2504
+ "text": "string"
2539
2505
  },
2540
- "description": "The tabindex attribute for the checkbox.",
2541
- "fieldName": "tabIndex"
2506
+ "description": "Specifies the value of the input element within the combobox.",
2507
+ "fieldName": "typedValue"
2542
2508
  },
2543
2509
  {
2544
- "name": "aria-checked",
2510
+ "name": "validity",
2545
2511
  "type": {
2546
2512
  "text": "string"
2547
2513
  },
2548
- "description": "The aria-checked attribute for the checkbox.",
2549
- "fieldName": "ariaChecked"
2514
+ "description": "Specifies the `validityState` this element is in.",
2515
+ "fieldName": "validity"
2550
2516
  },
2551
2517
  {
2552
- "name": "aria-disabled",
2518
+ "name": "value",
2553
2519
  "type": {
2554
2520
  "text": "string"
2555
2521
  },
2556
- "description": "The aria-disabled attribute for the checkbox.",
2557
- "fieldName": "ariaDisabled"
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"
2558
2524
  },
2559
2525
  {
2560
- "name": "role",
2526
+ "name": "largefullscreenheadline",
2561
2527
  "type": {
2562
- "text": "string"
2528
+ "text": "boolean"
2563
2529
  },
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"
2530
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2531
+ "fieldName": "largeFullscreenHeadline"
2532
+ },
2533
+ {
2534
+ "name": "fullscreenbreakpoint",
2535
+ "type": {
2536
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2537
+ },
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"
2566
2541
  }
2567
2542
  ],
2568
2543
  "superclass": {
2569
- "name": "LitElement",
2570
- "package": "lit"
2544
+ "name": "AuroElement",
2545
+ "module": "/components/layoutElement/src/auroElement.js"
2571
2546
  },
2572
- "tagName": "auro-checkbox",
2547
+ "tagName": "auro-combobox",
2573
2548
  "customElement": true
2574
2549
  }
2575
2550
  ],
2576
2551
  "exports": [
2577
2552
  {
2578
2553
  "kind": "js",
2579
- "name": "AuroCheckbox",
2554
+ "name": "AuroCombobox",
2580
2555
  "declaration": {
2581
- "name": "AuroCheckbox",
2582
- "module": "components/checkbox/src/auro-checkbox.js"
2556
+ "name": "AuroCombobox",
2557
+ "module": "components/combobox/src/auro-combobox.js"
2583
2558
  }
2584
2559
  }
2585
2560
  ]
2586
2561
  },
2587
2562
  {
2588
2563
  "kind": "javascript-module",
2589
- "path": "components/checkbox/src/index.js",
2590
- "declarations": [],
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
+ ],
2591
2575
  "exports": [
2592
2576
  {
2593
2577
  "kind": "js",
2594
- "name": "AuroCheckbox",
2578
+ "name": "comboboxKeyboardStrategy",
2595
2579
  "declaration": {
2596
- "name": "AuroCheckbox",
2597
- "module": "components/checkbox/src/index.js"
2580
+ "name": "comboboxKeyboardStrategy",
2581
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2598
2582
  }
2599
- },
2583
+ }
2584
+ ]
2585
+ },
2586
+ {
2587
+ "kind": "javascript-module",
2588
+ "path": "components/combobox/src/index.js",
2589
+ "declarations": [],
2590
+ "exports": [
2600
2591
  {
2601
2592
  "kind": "js",
2602
- "name": "AuroCheckboxGroup",
2593
+ "name": "AuroCombobox",
2603
2594
  "declaration": {
2604
- "name": "AuroCheckboxGroup",
2605
- "module": "components/checkbox/src/index.js"
2595
+ "name": "AuroCombobox",
2596
+ "module": "components/combobox/src/index.js"
2606
2597
  }
2607
2598
  }
2608
2599
  ]
2609
2600
  },
2610
2601
  {
2611
2602
  "kind": "javascript-module",
2612
- "path": "components/checkbox/src/registered.js",
2603
+ "path": "components/combobox/src/registered.js",
2613
2604
  "declarations": [],
2614
- "exports": []
2605
+ "exports": [
2606
+ {
2607
+ "kind": "js",
2608
+ "name": "AuroCombobox",
2609
+ "declaration": {
2610
+ "name": "AuroCombobox",
2611
+ "module": "components/combobox/src/registered.js"
2612
+ }
2613
+ }
2614
+ ]
2615
2615
  },
2616
2616
  {
2617
2617
  "kind": "javascript-module",