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