@aurodesignsystem-dev/auro-formkit 0.0.0-pr1478.0 → 0.0.0-pr1478.1

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 (69) hide show
  1. package/components/checkbox/demo/customize.html +1 -2
  2. package/components/checkbox/demo/customize.min.js +1 -1
  3. package/components/checkbox/demo/getting-started.min.js +1 -1
  4. package/components/checkbox/demo/index.min.js +1 -1
  5. package/components/checkbox/dist/index.js +1 -1
  6. package/components/checkbox/dist/registered.js +1 -1
  7. package/components/combobox/demo/customize.html +1 -2
  8. package/components/combobox/demo/customize.md +108 -132
  9. package/components/combobox/demo/customize.min.js +14 -23
  10. package/components/combobox/demo/getting-started.min.js +14 -23
  11. package/components/combobox/demo/index.min.js +14 -23
  12. package/components/combobox/dist/index.js +12 -21
  13. package/components/combobox/dist/registered.js +12 -21
  14. package/components/counter/demo/customize.min.js +10 -2
  15. package/components/counter/demo/index.min.js +10 -2
  16. package/components/counter/dist/index.js +10 -2
  17. package/components/counter/dist/registered.js +10 -2
  18. package/components/datepicker/demo/api.md +2 -0
  19. package/components/datepicker/demo/customize.js +0 -2
  20. package/components/datepicker/demo/customize.md +138 -38
  21. package/components/datepicker/demo/customize.min.js +17 -23
  22. package/components/datepicker/demo/index.min.js +17 -5
  23. package/components/datepicker/dist/index.js +17 -5
  24. package/components/datepicker/dist/registered.js +17 -5
  25. package/components/datepicker/dist/src/auro-datepicker.d.ts +2 -0
  26. package/components/dropdown/demo/customize.min.js +9 -1
  27. package/components/dropdown/demo/getting-started.min.js +9 -1
  28. package/components/dropdown/demo/index.min.js +9 -1
  29. package/components/dropdown/dist/auro-dropdown.d.ts +1 -0
  30. package/components/dropdown/dist/index.js +9 -1
  31. package/components/dropdown/dist/registered.js +9 -1
  32. package/components/form/demo/customize.html +6 -6
  33. package/components/form/demo/customize.js +19 -0
  34. package/components/form/demo/customize.md +203 -51
  35. package/components/form/demo/customize.min.js +620 -96
  36. package/components/form/demo/getting-started.min.js +548 -96
  37. package/components/form/demo/index.min.js +548 -96
  38. package/components/form/demo/registerDemoDeps.min.js +185 -59
  39. package/components/form/dist/auro-form.d.ts +122 -4
  40. package/components/form/dist/index.js +363 -37
  41. package/components/form/dist/registered.js +363 -37
  42. package/components/input/demo/customize.html +1 -2
  43. package/components/input/demo/customize.md +54 -53
  44. package/components/input/demo/customize.min.js +1 -1
  45. package/components/input/demo/getting-started.min.js +1 -1
  46. package/components/input/demo/index.min.js +1 -1
  47. package/components/input/dist/index.js +1 -1
  48. package/components/input/dist/registered.js +1 -1
  49. package/components/menu/demo/index.min.js +2 -2
  50. package/components/menu/dist/index.js +2 -2
  51. package/components/menu/dist/registered.js +2 -2
  52. package/components/radio/demo/customize.min.js +1 -1
  53. package/components/radio/demo/getting-started.min.js +1 -1
  54. package/components/radio/demo/index.min.js +1 -1
  55. package/components/radio/dist/index.js +1 -1
  56. package/components/radio/dist/registered.js +1 -1
  57. package/components/select/demo/api.md +1 -0
  58. package/components/select/demo/customize.html +1 -2
  59. package/components/select/demo/customize.md +71 -0
  60. package/components/select/demo/customize.min.js +143 -28
  61. package/components/select/demo/getting-started.min.js +143 -28
  62. package/components/select/demo/index.min.js +143 -28
  63. package/components/select/demo/keyboard-behavior.md +18 -0
  64. package/components/select/dist/auro-select.d.ts +38 -2
  65. package/components/select/dist/index.js +141 -26
  66. package/components/select/dist/registered.js +141 -26
  67. package/components/select/dist/selectUtils.d.ts +12 -0
  68. package/custom-elements.json +1641 -1420
  69. package/package.json +1 -1
@@ -267,80 +267,34 @@
267
267
  },
268
268
  {
269
269
  "kind": "javascript-module",
270
- "path": "components/combobox/src/auro-combobox.js",
270
+ "path": "components/checkbox/src/auro-checkbox-group.js",
271
271
  "declarations": [
272
272
  {
273
273
  "kind": "class",
274
- "description": "The `auro-combobox` element provides users with a way to select an option from a list of filtered or suggested options based on user input.",
275
- "name": "AuroCombobox",
274
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
275
+ "name": "AuroCheckboxGroup",
276
276
  "slots": [
277
277
  {
278
- "description": "Default slot for the menu content.",
279
- "name": ""
278
+ "description": "Allows for the legend to be overridden.",
279
+ "name": "legend"
280
280
  },
281
281
  {
282
- "type": {
283
- "text": "HTMLSlotElement"
284
- },
285
282
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
286
283
  "name": "optionalLabel"
287
284
  },
288
285
  {
289
- "description": "Sets aria-label on clear button",
290
- "name": "ariaLabel.input.clear"
291
- },
292
- {
293
- "description": "Sets aria-label on close button in fullscreen bib",
294
- "name": "ariaLabel.bib.close"
295
- },
296
- {
297
- "description": "Defines the headline to display above menu-options",
298
- "name": "bib.fullscreen.headline"
299
- },
300
- {
301
- "description": "Defines the content of the label.",
302
- "name": "label"
303
- },
304
- {
305
- "description": "Defines the content of the helpText.",
286
+ "description": "Allows for the helper text to be overridden.",
306
287
  "name": "helpText"
307
288
  },
308
289
  {
309
- "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
310
- "name": "displayValue"
290
+ "description": "The default slot for the checkbox items.",
291
+ "name": "default"
311
292
  }
312
293
  ],
313
294
  "members": [
314
295
  {
315
296
  "kind": "method",
316
- "name": "_initializeDefaults",
317
- "privacy": "private",
318
- "return": {
319
- "type": {
320
- "text": "void"
321
- }
322
- }
323
- },
324
- {
325
- "kind": "field",
326
- "name": "inputValue",
327
- "description": "Returns the current value of the input element within the combobox.",
328
- "return": {
329
- "type": {
330
- "text": "string|undefined"
331
- }
332
- },
333
- "readonly": true
334
- },
335
- {
336
- "kind": "method",
337
- "name": "isValid",
338
- "description": "Checks if the element is valid.",
339
- "return": {
340
- "type": {
341
- "text": "boolean"
342
- }
343
- }
297
+ "name": "_initializeDefaults"
344
298
  },
345
299
  {
346
300
  "kind": "method",
@@ -349,7 +303,7 @@
349
303
  "parameters": [
350
304
  {
351
305
  "name": "name",
352
- "default": "'auro-combobox'",
306
+ "default": "\"auro-checkbox-group\"",
353
307
  "description": "The name of the element that you want to register.",
354
308
  "optional": true,
355
309
  "type": {
@@ -361,62 +315,24 @@
361
315
  },
362
316
  {
363
317
  "kind": "method",
364
- "name": "activateFirstEnabledAvailableOption",
365
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
366
- "privacy": "private",
367
- "return": {
368
- "type": {
369
- "text": "void"
370
- }
371
- }
372
- },
373
- {
374
- "kind": "method",
375
- "name": "activateLastEnabledAvailableOption",
376
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
377
- "privacy": "private",
378
- "return": {
379
- "type": {
380
- "text": "void"
381
- }
382
- }
383
- },
384
- {
385
- "kind": "method",
386
- "name": "updateFilter",
387
- "description": "Updates the filter for the available options based on the input value.",
388
- "privacy": "private"
389
- },
390
- {
391
- "kind": "method",
392
- "name": "syncValuesAndStates",
393
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
394
- "privacy": "private",
395
- "return": {
396
- "type": {
397
- "text": "void"
398
- }
399
- }
400
- },
401
- {
402
- "kind": "method",
403
- "name": "updateTriggerTextDisplay",
318
+ "name": "handleValueUpdate",
404
319
  "parameters": [
405
320
  {
406
- "name": "label",
407
- "description": "The label of the selected option.",
321
+ "name": "value",
322
+ "description": "The value of the checkbox.",
408
323
  "type": {
409
- "text": "string"
324
+ "text": "String"
325
+ }
326
+ },
327
+ {
328
+ "name": "selected",
329
+ "description": "The checked state of the checkbox.",
330
+ "type": {
331
+ "text": "Boolean"
410
332
  }
411
333
  }
412
334
  ],
413
- "description": "Update displayValue or input.value, it's called when making a selection.",
414
- "privacy": "private"
415
- },
416
- {
417
- "kind": "method",
418
- "name": "handleMenuOptions",
419
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
335
+ "description": "Helper method to handle checkbox value changing.",
420
336
  "privacy": "private",
421
337
  "return": {
422
338
  "type": {
@@ -426,8 +342,8 @@
426
342
  },
427
343
  {
428
344
  "kind": "method",
429
- "name": "generateOptionsArray",
430
- "description": "Determines the element error state based on the `required` attribute and input value.",
345
+ "name": "handlePreselectedItems",
346
+ "description": "Helper method that handles the state of preselected checkboxes.",
431
347
  "privacy": "private",
432
348
  "return": {
433
349
  "type": {
@@ -437,8 +353,9 @@
437
353
  },
438
354
  {
439
355
  "kind": "method",
440
- "name": "hideBib",
441
- "description": "Hides the dropdown bib if its open.",
356
+ "name": "handleItems",
357
+ "description": "Helper method that handles the state of checkboxes.",
358
+ "privacy": "private",
442
359
  "return": {
443
360
  "type": {
444
361
  "text": "void"
@@ -447,8 +364,8 @@
447
364
  },
448
365
  {
449
366
  "kind": "method",
450
- "name": "showBib",
451
- "description": "Shows the dropdown bib if there are options to show.",
367
+ "name": "reset",
368
+ "description": "Resets component to initial state.",
452
369
  "return": {
453
370
  "type": {
454
371
  "text": "void"
@@ -457,102 +374,325 @@
457
374
  },
458
375
  {
459
376
  "kind": "method",
460
- "name": "configureDropdown",
461
- "description": "Binds all behavior needed to the dropdown after rendering.",
462
- "privacy": "private",
463
- "return": {
464
- "type": {
465
- "text": "void"
377
+ "name": "validate",
378
+ "parameters": [
379
+ {
380
+ "name": "force",
381
+ "default": "false",
382
+ "description": "Whether to force validation.",
383
+ "optional": true,
384
+ "type": {
385
+ "text": "boolean"
386
+ }
466
387
  }
467
- }
468
- },
469
- {
470
- "kind": "method",
471
- "name": "setClearBtnFocus",
472
- "privacy": "private"
388
+ ],
389
+ "description": "Validates value."
473
390
  },
474
391
  {
475
- "kind": "method",
476
- "name": "setTriggerInputFocus",
477
- "privacy": "private"
392
+ "kind": "field",
393
+ "name": "appearance",
394
+ "privacy": "public",
395
+ "type": {
396
+ "text": "'default' | 'inverse'"
397
+ },
398
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
399
+ "default": "'default'",
400
+ "attribute": "appearance",
401
+ "reflects": true
478
402
  },
479
403
  {
480
- "kind": "method",
481
- "name": "setInputFocus",
482
- "privacy": "private"
404
+ "kind": "field",
405
+ "name": "disabled",
406
+ "privacy": "public",
407
+ "type": {
408
+ "text": "boolean"
409
+ },
410
+ "description": "If set, disables the checkbox group.",
411
+ "attribute": "disabled",
412
+ "reflects": true
483
413
  },
484
414
  {
485
- "kind": "method",
486
- "name": "updateBibDialogRole",
487
- "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.",
488
- "privacy": "private"
415
+ "kind": "field",
416
+ "name": "error",
417
+ "privacy": "public",
418
+ "type": {
419
+ "text": "string"
420
+ },
421
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
422
+ "attribute": "error",
423
+ "reflects": true
489
424
  },
490
425
  {
491
- "kind": "method",
492
- "name": "updateMenuShapeSize",
493
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
494
- "privacy": "private"
426
+ "kind": "field",
427
+ "name": "horizontal",
428
+ "privacy": "public",
429
+ "type": {
430
+ "text": "boolean"
431
+ },
432
+ "description": "If set, checkboxes will be aligned horizontally.",
433
+ "attribute": "horizontal",
434
+ "reflects": true
495
435
  },
496
436
  {
497
- "kind": "method",
498
- "name": "_getAnnouncementRoot",
499
- "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.",
500
- "privacy": "private",
501
- "return": {
502
- "type": {
503
- "text": "ShadowRoot"
504
- }
505
- }
437
+ "kind": "field",
438
+ "name": "noValidate",
439
+ "privacy": "public",
440
+ "type": {
441
+ "text": "boolean"
442
+ },
443
+ "description": "If set, disables auto-validation on blur.",
444
+ "attribute": "noValidate",
445
+ "reflects": true
506
446
  },
507
447
  {
508
- "kind": "method",
509
- "name": "configureMenu",
510
- "description": "Binds all behavior needed to the menu after rendering.",
511
- "privacy": "private",
512
- "return": {
513
- "type": {
514
- "text": "void"
515
- }
516
- }
448
+ "kind": "field",
449
+ "name": "onDark",
450
+ "privacy": "public",
451
+ "type": {
452
+ "text": "boolean"
453
+ },
454
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
455
+ "attribute": "onDark",
456
+ "reflects": true
517
457
  },
518
458
  {
519
- "kind": "method",
520
- "name": "configureInput",
521
- "description": "Binds all behavior needed to the input after rendering.",
522
- "privacy": "private",
523
- "return": {
524
- "type": {
525
- "text": "void"
526
- }
459
+ "kind": "field",
460
+ "name": "required",
461
+ "privacy": "public",
462
+ "type": {
463
+ "text": "boolean"
464
+ },
465
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
466
+ "attribute": "required",
467
+ "reflects": true
468
+ },
469
+ {
470
+ "kind": "field",
471
+ "name": "setCustomValidity",
472
+ "privacy": "public",
473
+ "type": {
474
+ "text": "string"
475
+ },
476
+ "description": "Sets a custom help text message to display for all validityStates.",
477
+ "attribute": "setCustomValidity"
478
+ },
479
+ {
480
+ "kind": "field",
481
+ "name": "setCustomValidityCustomError",
482
+ "privacy": "public",
483
+ "type": {
484
+ "text": "string"
485
+ },
486
+ "description": "Custom help text message to display when validity = `customError`.",
487
+ "attribute": "setCustomValidityCustomError"
488
+ },
489
+ {
490
+ "kind": "field",
491
+ "name": "setCustomValidityValueMissing",
492
+ "privacy": "public",
493
+ "type": {
494
+ "text": "string"
495
+ },
496
+ "description": "Custom help text message to display when validity = `valueMissing`.",
497
+ "attribute": "setCustomValidityValueMissing"
498
+ },
499
+ {
500
+ "kind": "field",
501
+ "name": "validity",
502
+ "privacy": "public",
503
+ "type": {
504
+ "text": "string"
505
+ },
506
+ "description": "Specifies the `validityState` this element is in.",
507
+ "attribute": "validity",
508
+ "reflects": true
509
+ }
510
+ ],
511
+ "events": [
512
+ {
513
+ "name": "input",
514
+ "type": {
515
+ "text": "CustomEvent"
527
516
  }
528
517
  },
518
+ {
519
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
520
+ "name": "auroFormElement-validated"
521
+ }
522
+ ],
523
+ "attributes": [
524
+ {
525
+ "name": "appearance",
526
+ "type": {
527
+ "text": "'default' | 'inverse'"
528
+ },
529
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
530
+ "default": "'default'",
531
+ "fieldName": "appearance"
532
+ },
533
+ {
534
+ "name": "disabled",
535
+ "type": {
536
+ "text": "boolean"
537
+ },
538
+ "description": "If set, disables the checkbox group.",
539
+ "fieldName": "disabled"
540
+ },
541
+ {
542
+ "name": "error",
543
+ "type": {
544
+ "text": "string"
545
+ },
546
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
547
+ "fieldName": "error"
548
+ },
549
+ {
550
+ "name": "horizontal",
551
+ "type": {
552
+ "text": "boolean"
553
+ },
554
+ "description": "If set, checkboxes will be aligned horizontally.",
555
+ "fieldName": "horizontal"
556
+ },
557
+ {
558
+ "name": "noValidate",
559
+ "type": {
560
+ "text": "boolean"
561
+ },
562
+ "description": "If set, disables auto-validation on blur.",
563
+ "fieldName": "noValidate"
564
+ },
565
+ {
566
+ "name": "onDark",
567
+ "type": {
568
+ "text": "boolean"
569
+ },
570
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
571
+ "fieldName": "onDark"
572
+ },
573
+ {
574
+ "name": "required",
575
+ "type": {
576
+ "text": "boolean"
577
+ },
578
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
579
+ "fieldName": "required"
580
+ },
581
+ {
582
+ "name": "setCustomValidity",
583
+ "type": {
584
+ "text": "string"
585
+ },
586
+ "description": "Sets a custom help text message to display for all validityStates.",
587
+ "fieldName": "setCustomValidity"
588
+ },
589
+ {
590
+ "name": "setCustomValidityCustomError",
591
+ "type": {
592
+ "text": "string"
593
+ },
594
+ "description": "Custom help text message to display when validity = `customError`.",
595
+ "fieldName": "setCustomValidityCustomError"
596
+ },
597
+ {
598
+ "name": "setCustomValidityValueMissing",
599
+ "type": {
600
+ "text": "string"
601
+ },
602
+ "description": "Custom help text message to display when validity = `valueMissing`.",
603
+ "fieldName": "setCustomValidityValueMissing"
604
+ },
605
+ {
606
+ "name": "validity",
607
+ "type": {
608
+ "text": "string"
609
+ },
610
+ "description": "Specifies the `validityState` this element is in.",
611
+ "fieldName": "validity"
612
+ }
613
+ ],
614
+ "superclass": {
615
+ "name": "LitElement",
616
+ "package": "lit"
617
+ },
618
+ "tagName": "auro-checkbox-group",
619
+ "customElement": true
620
+ }
621
+ ],
622
+ "exports": [
623
+ {
624
+ "kind": "js",
625
+ "name": "AuroCheckboxGroup",
626
+ "declaration": {
627
+ "name": "AuroCheckboxGroup",
628
+ "module": "components/checkbox/src/auro-checkbox-group.js"
629
+ }
630
+ }
631
+ ]
632
+ },
633
+ {
634
+ "kind": "javascript-module",
635
+ "path": "components/checkbox/src/auro-checkbox.js",
636
+ "declarations": [
637
+ {
638
+ "kind": "class",
639
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
640
+ "name": "AuroCheckbox",
641
+ "cssParts": [
642
+ {
643
+ "description": "apply css to a specific checkbox.",
644
+ "name": "checkbox"
645
+ },
646
+ {
647
+ "description": "apply css to a specific checkbox's input.",
648
+ "name": "checkbox-input"
649
+ },
650
+ {
651
+ "description": "apply css to a specific checkbox's label.",
652
+ "name": "checkbox-label"
653
+ }
654
+ ],
655
+ "slots": [
656
+ {
657
+ "description": "The default slot for the checkbox label.",
658
+ "name": "default"
659
+ }
660
+ ],
661
+ "members": [
529
662
  {
530
663
  "kind": "method",
531
- "name": "handleMenuLoadingChange",
664
+ "name": "_initializeDefaults"
665
+ },
666
+ {
667
+ "kind": "method",
668
+ "name": "register",
669
+ "static": true,
532
670
  "parameters": [
533
671
  {
534
- "name": "event",
535
- "description": "The event object containing details about the loading state change.",
536
- "type": {
537
- "text": "CustomEvent"
538
- }
539
- },
540
- {
541
- "description": "Indicates whether the menu is currently loading.",
542
- "name": "event.detail.loading",
672
+ "name": "name",
673
+ "default": "\"auro-checkbox\"",
674
+ "description": "The name of element that you want to register to.",
675
+ "optional": true,
543
676
  "type": {
544
- "text": "boolean"
677
+ "text": "string"
545
678
  }
546
- },
679
+ }
680
+ ],
681
+ "description": "This will register this element with the browser."
682
+ },
683
+ {
684
+ "kind": "method",
685
+ "name": "handleChange",
686
+ "parameters": [
547
687
  {
548
- "description": "Indicates if there are loading placeholders present.",
549
- "name": "event.detail.hasLoadingPlaceholder",
688
+ "name": "event",
689
+ "description": "The change event from the checkbox input.",
550
690
  "type": {
551
- "text": "boolean"
691
+ "text": "Event"
552
692
  }
553
693
  }
554
694
  ],
555
- "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.",
695
+ "description": "Handles the change event for the checkbox input.\nUpdates the checked state and dispatches a corresponding custom event.\nThis custom event is only for the purpose of supporting IE.",
556
696
  "privacy": "private",
557
697
  "return": {
558
698
  "type": {
@@ -562,17 +702,17 @@
562
702
  },
563
703
  {
564
704
  "kind": "method",
565
- "name": "handleInputValueChange",
705
+ "name": "handleInput",
566
706
  "parameters": [
567
707
  {
568
708
  "name": "event",
569
- "description": "The input event triggered by the input element.",
709
+ "description": "The input event from the checkbox input.",
570
710
  "type": {
571
711
  "text": "Event"
572
712
  }
573
713
  }
574
714
  ],
575
- "description": "Handle changes to the input value and trigger changes that should result.",
715
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
576
716
  "privacy": "private",
577
717
  "return": {
578
718
  "type": {
@@ -582,8 +722,8 @@
582
722
  },
583
723
  {
584
724
  "kind": "method",
585
- "name": "configureCombobox",
586
- "description": "Binds all behavior needed to the combobox after rendering.",
725
+ "name": "handleFocusin",
726
+ "description": "Function to support",
587
727
  "privacy": "private",
588
728
  "return": {
589
729
  "type": {
@@ -593,30 +733,12 @@
593
733
  },
594
734
  {
595
735
  "kind": "method",
596
- "name": "focus",
597
- "description": "Focuses the combobox trigger input.",
598
- "return": {
599
- "type": {
600
- "text": "void"
601
- }
602
- }
603
- },
604
- {
605
- "kind": "method",
606
- "name": "setMenuValue",
607
- "parameters": [
608
- {
609
- "name": "value",
610
- "description": "The value to set on the menu.",
611
- "type": {
612
- "text": "string"
613
- }
614
- }
615
- ],
616
- "description": "Sets the menu value if menu is available.",
736
+ "name": "generateIconHtml",
737
+ "description": "Function to generate checkmark svg.",
738
+ "privacy": "private",
617
739
  "return": {
618
740
  "type": {
619
- "text": "void"
741
+ "text": "HTMLElement"
620
742
  }
621
743
  }
622
744
  },
@@ -632,57 +754,8 @@
632
754
  },
633
755
  {
634
756
  "kind": "method",
635
- "name": "clear",
636
- "description": "Clears the current value of the combobox.",
637
- "return": {
638
- "type": {
639
- "text": "void"
640
- }
641
- }
642
- },
643
- {
644
- "kind": "method",
645
- "name": "validate",
646
- "parameters": [
647
- {
648
- "name": "force",
649
- "default": "false",
650
- "description": "Whether to force validation.",
651
- "optional": true,
652
- "type": {
653
- "text": "boolean"
654
- }
655
- }
656
- ],
657
- "description": "Validates value."
658
- },
659
- {
660
- "kind": "method",
661
- "name": "transportAssignedNodes",
662
- "parameters": [
663
- {
664
- "name": "slot",
665
- "description": "The slot element containing the nodes to apply.",
666
- "type": {
667
- "text": "HTMLSlotElement"
668
- }
669
- },
670
- {
671
- "name": "target",
672
- "description": "The target element to apply the nodes to.",
673
- "type": {
674
- "text": "HTMLElement"
675
- }
676
- },
677
- {
678
- "name": "newSlotName",
679
- "description": "The new slot name for the applied nodes.",
680
- "type": {
681
- "text": "string"
682
- }
683
- }
684
- ],
685
- "description": "Applies slotted nodes to a target element with a new slot name.",
757
+ "name": "updateAriaLabel",
758
+ "description": "Updates the aria-label based on slot content.",
686
759
  "privacy": "private",
687
760
  "return": {
688
761
  "type": {
@@ -692,31 +765,17 @@
692
765
  },
693
766
  {
694
767
  "kind": "method",
695
- "name": "updateActiveOption",
696
- "parameters": [
697
- {
698
- "name": "index",
699
- "description": "Index of the option to make active.",
700
- "type": {
701
- "text": "number"
702
- }
703
- }
704
- ],
705
- "description": "Updates the active option in the menu."
706
- },
707
- {
708
- "kind": "method",
709
- "name": "handleSlotChange",
768
+ "name": "handleKeyDown",
710
769
  "parameters": [
711
770
  {
712
771
  "name": "event",
713
- "description": "`slotchange` event.",
772
+ "description": "The keydown event from the checkbox input.",
714
773
  "type": {
715
- "text": "Event"
774
+ "text": "KeyboardEvent"
716
775
  }
717
776
  }
718
777
  ],
719
- "description": "Watch for slot changes and recalculate the menuoptions.",
778
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
720
779
  "privacy": "private",
721
780
  "return": {
722
781
  "type": {
@@ -729,7 +788,7 @@
729
788
  "name": "appearance",
730
789
  "privacy": "public",
731
790
  "type": {
732
- "text": "string"
791
+ "text": "'default' | 'inverse'"
733
792
  },
734
793
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
735
794
  "default": "'default'",
@@ -738,991 +797,625 @@
738
797
  },
739
798
  {
740
799
  "kind": "field",
741
- "name": "autocomplete",
742
- "privacy": "public",
743
- "type": {
744
- "text": "string"
745
- },
746
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
747
- "attribute": "autocomplete",
748
- "reflects": true
749
- },
750
- {
751
- "kind": "field",
752
- "name": "autoPlacement",
800
+ "name": "checked",
753
801
  "privacy": "public",
754
802
  "type": {
755
803
  "text": "boolean"
756
804
  },
757
- "description": "If declared, bib's position will be automatically calculated where to appear.",
758
- "attribute": "autoPlacement",
805
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
806
+ "attribute": "checked",
759
807
  "reflects": true
760
808
  },
761
809
  {
762
810
  "kind": "field",
763
- "name": "availableOptions",
764
- "privacy": "private",
765
- "type": {
766
- "text": "array"
767
- },
768
- "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).",
769
- "attribute": "availableOptions"
770
- },
771
- {
772
- "kind": "field",
773
- "name": "behavior",
811
+ "name": "disabled",
774
812
  "privacy": "public",
775
813
  "type": {
776
- "text": "'filter' | 'suggestion'"
814
+ "text": "boolean"
777
815
  },
778
- "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.",
779
- "default": "'suggestion'",
780
- "attribute": "behavior",
816
+ "description": "If set to true, the checkbox will not be clickable.",
817
+ "attribute": "disabled",
781
818
  "reflects": true
782
819
  },
783
820
  {
784
821
  "kind": "field",
785
- "name": "checkmark",
822
+ "name": "error",
786
823
  "privacy": "public",
787
824
  "type": {
788
825
  "text": "boolean"
789
826
  },
790
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
791
- "attribute": "checkmark",
827
+ "description": "If set to true, the checkbox will be displayed with an error state.",
828
+ "attribute": "error",
792
829
  "reflects": true
793
830
  },
794
831
  {
795
832
  "kind": "field",
796
- "name": "disabled",
833
+ "name": "id",
797
834
  "privacy": "public",
798
835
  "type": {
799
- "text": "boolean"
836
+ "text": "string"
800
837
  },
801
- "description": "If set, disables the combobox.",
802
- "attribute": "disabled",
838
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
839
+ "attribute": "id",
803
840
  "reflects": true
804
841
  },
805
842
  {
806
843
  "kind": "field",
807
- "name": "dropdownId",
844
+ "name": "inputId",
808
845
  "privacy": "private",
809
846
  "type": {
810
847
  "text": "string"
811
848
  },
812
- "description": "ID for the dropdown."
849
+ "description": "The id for input node."
813
850
  },
814
851
  {
815
852
  "kind": "field",
816
- "name": "dropdownOpen",
817
- "privacy": "private",
853
+ "name": "name",
854
+ "privacy": "public",
818
855
  "type": {
819
- "text": "boolean"
856
+ "text": "string"
820
857
  },
821
- "description": "Whether or not the dropdown is open."
858
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
859
+ "attribute": "name"
822
860
  },
823
861
  {
824
862
  "kind": "field",
825
- "name": "dvInputOnly",
863
+ "name": "onDark",
826
864
  "privacy": "public",
827
865
  "type": {
828
866
  "text": "boolean"
829
867
  },
830
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
831
- "attribute": "dvInputOnly",
868
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
869
+ "attribute": "onDark",
832
870
  "reflects": true
833
871
  },
834
872
  {
835
873
  "kind": "field",
836
- "name": "error",
837
- "privacy": "public",
874
+ "name": "touched",
875
+ "privacy": "private",
838
876
  "type": {
839
- "text": "string"
877
+ "text": "boolean"
840
878
  },
841
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
842
- "attribute": "error",
843
- "reflects": true
879
+ "description": "Indicates whether the checkbox has been interacted with."
844
880
  },
845
881
  {
846
882
  "kind": "field",
847
- "name": "format",
883
+ "name": "value",
848
884
  "privacy": "public",
849
885
  "type": {
850
886
  "text": "string"
851
887
  },
852
- "description": "Specifies the input mask format.",
853
- "attribute": "format",
854
- "reflects": true
888
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
889
+ "attribute": "value"
855
890
  },
856
891
  {
857
892
  "kind": "field",
858
- "name": "inputmode",
859
- "privacy": "public",
893
+ "name": "tabIndex",
894
+ "privacy": "private",
860
895
  "type": {
861
- "text": "string"
896
+ "text": "number"
862
897
  },
863
- "description": "Exposes inputmode attribute for input.",
864
- "attribute": "inputmode",
898
+ "description": "The tabindex attribute for the checkbox.",
899
+ "attribute": "tabindex",
865
900
  "reflects": true
866
901
  },
867
902
  {
868
903
  "kind": "field",
869
- "name": "layout",
870
- "privacy": "public",
904
+ "name": "ariaChecked",
905
+ "privacy": "private",
871
906
  "type": {
872
907
  "text": "string"
873
908
  },
874
- "description": "Sets the layout of the combobox.",
875
- "default": "'classic'",
876
- "attribute": "layout",
877
- "reflects": true,
878
- "inheritedFrom": {
879
- "name": "AuroElement",
880
- "module": "components/layoutElement/src/auroElement.js"
881
- }
909
+ "description": "The aria-checked attribute for the checkbox.",
910
+ "attribute": "aria-checked",
911
+ "reflects": true
882
912
  },
883
913
  {
884
914
  "kind": "field",
885
- "name": "matchWidth",
915
+ "name": "ariaDisabled",
886
916
  "privacy": "private",
887
917
  "type": {
888
- "text": "boolean"
918
+ "text": "string"
889
919
  },
890
- "description": "If declared, the popover and trigger will be set to the same width.",
891
- "attribute": "matchWidth",
920
+ "description": "The aria-disabled attribute for the checkbox.",
921
+ "attribute": "aria-disabled",
892
922
  "reflects": true
893
923
  },
894
924
  {
895
925
  "kind": "field",
896
- "name": "noFilter",
897
- "privacy": "public",
926
+ "name": "role",
927
+ "privacy": "private",
898
928
  "type": {
899
- "text": "boolean"
929
+ "text": "string"
900
930
  },
901
- "description": "If set, combobox will not filter menuoptions based on input.",
902
- "attribute": "noFilter",
931
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
932
+ "attribute": "role",
903
933
  "reflects": true
904
- },
934
+ }
935
+ ],
936
+ "events": [
905
937
  {
906
- "kind": "field",
907
- "name": "noFlip",
908
- "privacy": "public",
938
+ "name": "auroCheckbox-input",
909
939
  "type": {
910
- "text": "boolean"
911
- },
912
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
913
- "attribute": "noFlip",
914
- "reflects": true
940
+ "text": "CustomEvent"
941
+ }
915
942
  },
916
943
  {
917
- "kind": "field",
918
- "name": "shift",
919
- "privacy": "public",
944
+ "name": "auroCheckbox-focusin",
920
945
  "type": {
921
- "text": "boolean"
922
- },
923
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
924
- "attribute": "shift",
925
- "reflects": true
946
+ "text": "CustomEvent"
947
+ }
926
948
  },
927
949
  {
928
- "kind": "field",
929
- "name": "noValidate",
930
- "privacy": "public",
950
+ "name": "auroCheckbox-focusout",
931
951
  "type": {
932
- "text": "boolean"
933
- },
934
- "description": "If set, disables auto-validation on blur.",
935
- "attribute": "noValidate",
936
- "reflects": true
952
+ "text": "CustomEvent"
953
+ }
937
954
  },
938
955
  {
939
- "kind": "field",
940
- "name": "offset",
941
- "privacy": "public",
956
+ "description": "(Deprecated) Notifies when checked value is changed.",
957
+ "name": "change"
958
+ },
959
+ {
960
+ "description": "Notifies when when checked value is changed by user's interface.",
961
+ "name": "input"
962
+ }
963
+ ],
964
+ "attributes": [
965
+ {
966
+ "name": "appearance",
942
967
  "type": {
943
- "text": "number"
968
+ "text": "'default' | 'inverse'"
944
969
  },
945
- "description": "Gap between the trigger element and bib.",
946
- "default": "0",
947
- "attribute": "offset",
948
- "reflects": true
970
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
971
+ "default": "'default'",
972
+ "fieldName": "appearance"
949
973
  },
950
974
  {
951
- "kind": "field",
952
- "name": "onDark",
953
- "privacy": "public",
975
+ "name": "checked",
954
976
  "type": {
955
977
  "text": "boolean"
956
978
  },
957
- "attribute": "onDark",
958
- "reflects": true,
959
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
960
- "inheritedFrom": {
961
- "name": "AuroElement",
962
- "module": "components/layoutElement/src/auroElement.js"
963
- }
979
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
980
+ "fieldName": "checked"
964
981
  },
965
982
  {
966
- "kind": "field",
967
- "name": "optionSelected",
968
- "privacy": "public",
983
+ "name": "disabled",
969
984
  "type": {
970
- "text": "HTMLElement"
985
+ "text": "boolean"
971
986
  },
972
- "description": "Specifies the current selected option.",
973
- "attribute": "optionSelected"
987
+ "description": "If set to true, the checkbox will not be clickable.",
988
+ "fieldName": "disabled"
974
989
  },
975
990
  {
976
- "kind": "field",
977
- "name": "persistInput",
978
- "privacy": "public",
991
+ "name": "error",
979
992
  "type": {
980
993
  "text": "boolean"
981
994
  },
982
- "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.",
983
- "attribute": "persistInput",
984
- "reflects": true
995
+ "description": "If set to true, the checkbox will be displayed with an error state.",
996
+ "fieldName": "error"
985
997
  },
986
998
  {
987
- "kind": "field",
988
- "name": "placement",
989
- "privacy": "public",
999
+ "name": "id",
990
1000
  "type": {
991
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1001
+ "text": "string"
992
1002
  },
993
- "description": "Position where the bib should appear relative to the trigger.",
994
- "default": "'bottom-start'",
995
- "attribute": "placement",
996
- "reflects": true
1003
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
1004
+ "fieldName": "id"
997
1005
  },
998
1006
  {
999
- "kind": "field",
1000
- "name": "placeholder",
1001
- "privacy": "public",
1007
+ "name": "name",
1002
1008
  "type": {
1003
1009
  "text": "string"
1004
1010
  },
1005
- "description": "Define custom placeholder text, only supported by date input formats.",
1006
- "attribute": "placeholder",
1007
- "reflects": true
1011
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
1012
+ "fieldName": "name"
1008
1013
  },
1009
1014
  {
1010
- "kind": "field",
1011
- "name": "required",
1012
- "privacy": "public",
1015
+ "name": "onDark",
1013
1016
  "type": {
1014
1017
  "text": "boolean"
1015
1018
  },
1016
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1017
- "attribute": "required",
1018
- "reflects": true
1019
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1020
+ "fieldName": "onDark"
1019
1021
  },
1020
1022
  {
1021
- "kind": "field",
1022
- "name": "setCustomValidity",
1023
- "privacy": "public",
1023
+ "name": "value",
1024
1024
  "type": {
1025
1025
  "text": "string"
1026
1026
  },
1027
- "description": "Sets a custom help text message to display for all validityStates.",
1028
- "attribute": "setCustomValidity"
1027
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1028
+ "fieldName": "value"
1029
1029
  },
1030
1030
  {
1031
- "kind": "field",
1032
- "name": "setCustomValidityCustomError",
1033
- "privacy": "public",
1031
+ "name": "tabindex",
1034
1032
  "type": {
1035
- "text": "string"
1033
+ "text": "number"
1036
1034
  },
1037
- "description": "Custom help text message to display when validity = `customError`.",
1038
- "attribute": "setCustomValidityCustomError"
1035
+ "description": "The tabindex attribute for the checkbox.",
1036
+ "fieldName": "tabIndex"
1039
1037
  },
1040
1038
  {
1041
- "kind": "field",
1042
- "name": "setCustomValidityValueMissing",
1043
- "privacy": "public",
1039
+ "name": "aria-checked",
1044
1040
  "type": {
1045
1041
  "text": "string"
1046
1042
  },
1047
- "description": "Custom help text message to display when validity = `valueMissing`.",
1048
- "attribute": "setCustomValidityValueMissing"
1043
+ "description": "The aria-checked attribute for the checkbox.",
1044
+ "fieldName": "ariaChecked"
1049
1045
  },
1050
1046
  {
1051
- "kind": "field",
1052
- "name": "setCustomValidityValueMissingFilter",
1053
- "privacy": "public",
1047
+ "name": "aria-disabled",
1054
1048
  "type": {
1055
1049
  "text": "string"
1056
1050
  },
1057
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1058
- "attribute": "setCustomValidityValueMissingFilter"
1051
+ "description": "The aria-disabled attribute for the checkbox.",
1052
+ "fieldName": "ariaDisabled"
1059
1053
  },
1060
1054
  {
1061
- "kind": "field",
1062
- "name": "touched",
1063
- "privacy": "private",
1055
+ "name": "role",
1064
1056
  "type": {
1065
- "text": "boolean"
1057
+ "text": "string"
1066
1058
  },
1067
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1059
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
1060
+ "fieldName": "role"
1061
+ }
1062
+ ],
1063
+ "superclass": {
1064
+ "name": "LitElement",
1065
+ "package": "lit"
1066
+ },
1067
+ "tagName": "auro-checkbox",
1068
+ "customElement": true
1069
+ }
1070
+ ],
1071
+ "exports": [
1072
+ {
1073
+ "kind": "js",
1074
+ "name": "AuroCheckbox",
1075
+ "declaration": {
1076
+ "name": "AuroCheckbox",
1077
+ "module": "components/checkbox/src/auro-checkbox.js"
1078
+ }
1079
+ }
1080
+ ]
1081
+ },
1082
+ {
1083
+ "kind": "javascript-module",
1084
+ "path": "components/checkbox/src/index.js",
1085
+ "declarations": [],
1086
+ "exports": [
1087
+ {
1088
+ "kind": "js",
1089
+ "name": "AuroCheckbox",
1090
+ "declaration": {
1091
+ "name": "AuroCheckbox",
1092
+ "module": "components/checkbox/src/index.js"
1093
+ }
1094
+ },
1095
+ {
1096
+ "kind": "js",
1097
+ "name": "AuroCheckboxGroup",
1098
+ "declaration": {
1099
+ "name": "AuroCheckboxGroup",
1100
+ "module": "components/checkbox/src/index.js"
1101
+ }
1102
+ }
1103
+ ]
1104
+ },
1105
+ {
1106
+ "kind": "javascript-module",
1107
+ "path": "components/checkbox/src/registered.js",
1108
+ "declarations": [],
1109
+ "exports": []
1110
+ },
1111
+ {
1112
+ "kind": "javascript-module",
1113
+ "path": "components/combobox/src/auro-combobox.js",
1114
+ "declarations": [
1115
+ {
1116
+ "kind": "class",
1117
+ "description": "The `auro-combobox` element provides users with a way to select an option from a list of filtered or suggested options based on user input.",
1118
+ "name": "AuroCombobox",
1119
+ "slots": [
1120
+ {
1121
+ "description": "Default slot for the menu content.",
1122
+ "name": ""
1068
1123
  },
1069
1124
  {
1070
- "kind": "field",
1071
- "name": "triggerIcon",
1072
- "privacy": "public",
1073
1125
  "type": {
1074
- "text": "boolean"
1126
+ "text": "HTMLSlotElement"
1075
1127
  },
1076
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1077
- "attribute": "triggerIcon",
1078
- "reflects": true
1128
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1129
+ "name": "optionalLabel"
1079
1130
  },
1080
1131
  {
1081
- "kind": "field",
1082
- "name": "type",
1083
- "privacy": "public",
1084
- "type": {
1085
- "text": "string"
1086
- },
1087
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1088
- "attribute": "type",
1089
- "reflects": true
1132
+ "description": "Sets aria-label on clear button",
1133
+ "name": "ariaLabel.input.clear"
1090
1134
  },
1091
1135
  {
1092
- "kind": "field",
1093
- "name": "typedValue",
1094
- "privacy": "public",
1095
- "type": {
1096
- "text": "string"
1097
- },
1098
- "description": "Specifies the value of the input element within the combobox.",
1099
- "attribute": "typedValue",
1100
- "reflects": true
1136
+ "description": "Sets aria-label on close button in fullscreen bib",
1137
+ "name": "ariaLabel.bib.close"
1101
1138
  },
1102
1139
  {
1103
- "kind": "field",
1104
- "name": "validity",
1105
- "privacy": "public",
1106
- "type": {
1107
- "text": "string"
1108
- },
1109
- "description": "Specifies the `validityState` this element is in.",
1110
- "attribute": "validity",
1111
- "reflects": true
1140
+ "description": "Defines the headline to display above menu-options",
1141
+ "name": "bib.fullscreen.headline"
1112
1142
  },
1113
1143
  {
1114
- "kind": "field",
1115
- "name": "value",
1116
- "privacy": "public",
1117
- "type": {
1118
- "text": "string"
1119
- },
1120
- "description": "Value selected for the dropdown menu.",
1121
- "attribute": "value"
1144
+ "description": "Defines the content of the label.",
1145
+ "name": "label"
1122
1146
  },
1123
1147
  {
1124
- "kind": "field",
1125
- "name": "largeFullscreenHeadline",
1126
- "privacy": "public",
1127
- "type": {
1128
- "text": "boolean"
1129
- },
1130
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1131
- "attribute": "largeFullscreenHeadline",
1132
- "reflects": true
1148
+ "description": "Defines the content of the helpText.",
1149
+ "name": "helpText"
1133
1150
  },
1134
1151
  {
1135
- "kind": "field",
1136
- "name": "fullscreenBreakpoint",
1137
- "privacy": "public",
1138
- "type": {
1139
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1140
- },
1141
- "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.",
1142
- "default": "'sm'",
1143
- "attribute": "fullscreenBreakpoint",
1144
- "reflects": true
1145
- },
1152
+ "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
1153
+ "name": "displayValue"
1154
+ }
1155
+ ],
1156
+ "members": [
1146
1157
  {
1147
- "kind": "field",
1148
- "name": "optionActive",
1158
+ "kind": "method",
1159
+ "name": "_initializeDefaults",
1149
1160
  "privacy": "private",
1150
- "type": {
1151
- "text": "object"
1152
- },
1153
- "description": "Specifies the currently active option."
1161
+ "return": {
1162
+ "type": {
1163
+ "text": "void"
1164
+ }
1165
+ }
1154
1166
  },
1155
1167
  {
1156
1168
  "kind": "field",
1157
- "name": "triggerExpandedState",
1158
- "privacy": "private",
1159
- "type": {
1160
- "text": "boolean"
1169
+ "name": "inputValue",
1170
+ "description": "Returns the current value of the input element within the combobox.",
1171
+ "return": {
1172
+ "type": {
1173
+ "text": "string|undefined"
1174
+ }
1161
1175
  },
1162
- "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1176
+ "readonly": true
1163
1177
  },
1164
1178
  {
1165
- "kind": "field",
1166
- "name": "componentHasFocus",
1167
- "description": "Returns true if the element has focus.",
1168
- "privacy": "private",
1179
+ "kind": "method",
1180
+ "name": "isValid",
1181
+ "description": "Checks if the element is valid.",
1169
1182
  "return": {
1170
1183
  "type": {
1171
1184
  "text": "boolean"
1172
1185
  }
1173
- },
1174
- "readonly": true,
1175
- "inheritedFrom": {
1176
- "name": "AuroElement",
1177
- "module": "components/layoutElement/src/auroElement.js"
1178
1186
  }
1179
1187
  },
1180
1188
  {
1181
1189
  "kind": "method",
1182
- "name": "resetShapeClasses",
1183
- "inheritedFrom": {
1184
- "name": "AuroElement",
1185
- "module": "components/layoutElement/src/auroElement.js"
1186
- }
1190
+ "name": "register",
1191
+ "static": true,
1192
+ "parameters": [
1193
+ {
1194
+ "name": "name",
1195
+ "default": "'auro-combobox'",
1196
+ "description": "The name of the element that you want to register.",
1197
+ "optional": true,
1198
+ "type": {
1199
+ "text": "string"
1200
+ }
1201
+ }
1202
+ ],
1203
+ "description": "This will register this element with the browser."
1187
1204
  },
1188
1205
  {
1189
1206
  "kind": "method",
1190
- "name": "resetLayoutClasses",
1191
- "inheritedFrom": {
1192
- "name": "AuroElement",
1193
- "module": "components/layoutElement/src/auroElement.js"
1207
+ "name": "activateFirstEnabledAvailableOption",
1208
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
1209
+ "privacy": "private",
1210
+ "return": {
1211
+ "type": {
1212
+ "text": "void"
1213
+ }
1194
1214
  }
1195
1215
  },
1196
1216
  {
1197
1217
  "kind": "method",
1198
- "name": "updateComponentArchitecture",
1199
- "inheritedFrom": {
1200
- "name": "AuroElement",
1201
- "module": "components/layoutElement/src/auroElement.js"
1218
+ "name": "activateLastEnabledAvailableOption",
1219
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
1220
+ "privacy": "private",
1221
+ "return": {
1222
+ "type": {
1223
+ "text": "void"
1224
+ }
1202
1225
  }
1203
1226
  },
1204
1227
  {
1205
- "kind": "field",
1206
- "name": "shape",
1207
- "privacy": "public",
1208
- "type": {
1209
- "text": "string"
1210
- },
1211
- "attribute": "shape",
1212
- "reflects": true,
1213
- "inheritedFrom": {
1214
- "name": "AuroElement",
1215
- "module": "components/layoutElement/src/auroElement.js"
1216
- }
1228
+ "kind": "method",
1229
+ "name": "updateFilter",
1230
+ "description": "Updates the filter for the available options based on the input value.",
1231
+ "privacy": "private"
1217
1232
  },
1218
1233
  {
1219
- "kind": "field",
1220
- "name": "size",
1221
- "privacy": "public",
1222
- "type": {
1223
- "text": "string"
1224
- },
1225
- "attribute": "size",
1226
- "reflects": true,
1227
- "inheritedFrom": {
1228
- "name": "AuroElement",
1229
- "module": "components/layoutElement/src/auroElement.js"
1234
+ "kind": "method",
1235
+ "name": "syncValuesAndStates",
1236
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1237
+ "privacy": "private",
1238
+ "return": {
1239
+ "type": {
1240
+ "text": "void"
1241
+ }
1230
1242
  }
1231
- }
1232
- ],
1233
- "events": [
1234
- {
1235
- "name": "inputValue",
1236
- "type": {
1237
- "text": "CustomEvent"
1238
- },
1239
- "description": "Notifies that the components internal HTML5 input value has changed."
1240
1243
  },
1241
1244
  {
1242
- "name": "input",
1243
- "type": {
1244
- "text": "CustomEvent"
1245
- },
1246
- "description": "Notifies that the component has a new value set."
1245
+ "kind": "method",
1246
+ "name": "updateTriggerTextDisplay",
1247
+ "parameters": [
1248
+ {
1249
+ "name": "label",
1250
+ "description": "The label of the selected option.",
1251
+ "type": {
1252
+ "text": "string"
1253
+ }
1254
+ }
1255
+ ],
1256
+ "description": "Update displayValue or input.value, it's called when making a selection.",
1257
+ "privacy": "private"
1247
1258
  },
1248
1259
  {
1249
- "name": "auroCombobox-valueSet",
1250
- "type": {
1251
- "text": "CustomEvent"
1252
- },
1253
- "description": "(Deprecated) Notifies that the component has a new value set."
1260
+ "kind": "method",
1261
+ "name": "handleMenuOptions",
1262
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1263
+ "privacy": "private",
1264
+ "return": {
1265
+ "type": {
1266
+ "text": "void"
1267
+ }
1268
+ }
1254
1269
  },
1255
1270
  {
1256
- "description": "Notifies that the component value(s) have been validated.",
1257
- "name": "auroFormElement-validated"
1258
- }
1259
- ],
1260
- "attributes": [
1261
- {
1262
- "name": "appearance",
1263
- "type": {
1264
- "text": "string"
1265
- },
1266
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1267
- "default": "'default'",
1268
- "fieldName": "appearance"
1271
+ "kind": "method",
1272
+ "name": "generateOptionsArray",
1273
+ "description": "Determines the element error state based on the `required` attribute and input value.",
1274
+ "privacy": "private",
1275
+ "return": {
1276
+ "type": {
1277
+ "text": "void"
1278
+ }
1279
+ }
1269
1280
  },
1270
1281
  {
1271
- "name": "autocomplete",
1272
- "type": {
1273
- "text": "string"
1274
- },
1275
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1276
- "fieldName": "autocomplete"
1282
+ "kind": "method",
1283
+ "name": "hideBib",
1284
+ "description": "Hides the dropdown bib if its open.",
1285
+ "return": {
1286
+ "type": {
1287
+ "text": "void"
1288
+ }
1289
+ }
1277
1290
  },
1278
1291
  {
1279
- "name": "autoPlacement",
1280
- "type": {
1281
- "text": "boolean"
1282
- },
1283
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1284
- "fieldName": "autoPlacement"
1292
+ "kind": "method",
1293
+ "name": "showBib",
1294
+ "description": "Shows the dropdown bib if there are options to show.",
1295
+ "return": {
1296
+ "type": {
1297
+ "text": "void"
1298
+ }
1299
+ }
1285
1300
  },
1286
1301
  {
1287
- "name": "availableOptions",
1288
- "type": {
1289
- "text": "array"
1290
- },
1291
- "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).",
1292
- "fieldName": "availableOptions"
1302
+ "kind": "method",
1303
+ "name": "configureDropdown",
1304
+ "description": "Binds all behavior needed to the dropdown after rendering.",
1305
+ "privacy": "private",
1306
+ "return": {
1307
+ "type": {
1308
+ "text": "void"
1309
+ }
1310
+ }
1293
1311
  },
1294
1312
  {
1295
- "name": "behavior",
1296
- "type": {
1297
- "text": "'filter' | 'suggestion'"
1298
- },
1299
- "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.",
1300
- "default": "'suggestion'",
1301
- "fieldName": "behavior"
1313
+ "kind": "method",
1314
+ "name": "setClearBtnFocus",
1315
+ "privacy": "private"
1302
1316
  },
1303
1317
  {
1304
- "name": "checkmark",
1305
- "type": {
1306
- "text": "boolean"
1307
- },
1308
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1309
- "fieldName": "checkmark"
1310
- },
1311
- {
1312
- "name": "disabled",
1313
- "type": {
1314
- "text": "boolean"
1315
- },
1316
- "description": "If set, disables the combobox.",
1317
- "fieldName": "disabled"
1318
- },
1319
- {
1320
- "name": "dvInputOnly",
1321
- "type": {
1322
- "text": "boolean"
1323
- },
1324
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1325
- "fieldName": "dvInputOnly"
1326
- },
1327
- {
1328
- "name": "error",
1329
- "type": {
1330
- "text": "string"
1331
- },
1332
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1333
- "fieldName": "error"
1334
- },
1335
- {
1336
- "name": "format",
1337
- "type": {
1338
- "text": "string"
1339
- },
1340
- "description": "Specifies the input mask format.",
1341
- "fieldName": "format"
1342
- },
1343
- {
1344
- "name": "inputmode",
1345
- "type": {
1346
- "text": "string"
1347
- },
1348
- "description": "Exposes inputmode attribute for input.",
1349
- "fieldName": "inputmode"
1350
- },
1351
- {
1352
- "name": "layout",
1353
- "type": {
1354
- "text": "string"
1355
- },
1356
- "description": "Sets the layout of the combobox.",
1357
- "default": "'classic'",
1358
- "fieldName": "layout",
1359
- "inheritedFrom": {
1360
- "name": "AuroElement",
1361
- "module": "components/layoutElement/src/auroElement.js"
1362
- }
1363
- },
1364
- {
1365
- "name": "matchWidth",
1366
- "type": {
1367
- "text": "boolean"
1368
- },
1369
- "description": "If declared, the popover and trigger will be set to the same width.",
1370
- "fieldName": "matchWidth"
1371
- },
1372
- {
1373
- "name": "noFilter",
1374
- "type": {
1375
- "text": "boolean"
1376
- },
1377
- "description": "If set, combobox will not filter menuoptions based on input.",
1378
- "fieldName": "noFilter"
1379
- },
1380
- {
1381
- "name": "noFlip",
1382
- "type": {
1383
- "text": "boolean"
1384
- },
1385
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1386
- "fieldName": "noFlip"
1387
- },
1388
- {
1389
- "name": "shift",
1390
- "type": {
1391
- "text": "boolean"
1392
- },
1393
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1394
- "fieldName": "shift"
1395
- },
1396
- {
1397
- "name": "noValidate",
1398
- "type": {
1399
- "text": "boolean"
1400
- },
1401
- "description": "If set, disables auto-validation on blur.",
1402
- "fieldName": "noValidate"
1403
- },
1404
- {
1405
- "name": "offset",
1406
- "type": {
1407
- "text": "number"
1408
- },
1409
- "description": "Gap between the trigger element and bib.",
1410
- "default": "0",
1411
- "fieldName": "offset"
1412
- },
1413
- {
1414
- "name": "onDark",
1415
- "type": {
1416
- "text": "boolean"
1417
- },
1418
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1419
- "fieldName": "onDark"
1420
- },
1421
- {
1422
- "name": "optionSelected",
1423
- "type": {
1424
- "text": "HTMLElement"
1425
- },
1426
- "description": "Specifies the current selected option.",
1427
- "fieldName": "optionSelected"
1428
- },
1429
- {
1430
- "name": "persistInput",
1431
- "type": {
1432
- "text": "boolean"
1433
- },
1434
- "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.",
1435
- "fieldName": "persistInput"
1436
- },
1437
- {
1438
- "name": "placement",
1439
- "type": {
1440
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1441
- },
1442
- "description": "Position where the bib should appear relative to the trigger.",
1443
- "default": "'bottom-start'",
1444
- "fieldName": "placement"
1445
- },
1446
- {
1447
- "name": "placeholder",
1448
- "type": {
1449
- "text": "string"
1450
- },
1451
- "description": "Define custom placeholder text, only supported by date input formats.",
1452
- "fieldName": "placeholder"
1453
- },
1454
- {
1455
- "name": "required",
1456
- "type": {
1457
- "text": "boolean"
1458
- },
1459
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1460
- "fieldName": "required"
1461
- },
1462
- {
1463
- "name": "setCustomValidity",
1464
- "type": {
1465
- "text": "string"
1466
- },
1467
- "description": "Sets a custom help text message to display for all validityStates.",
1468
- "fieldName": "setCustomValidity"
1469
- },
1470
- {
1471
- "name": "setCustomValidityCustomError",
1472
- "type": {
1473
- "text": "string"
1474
- },
1475
- "description": "Custom help text message to display when validity = `customError`.",
1476
- "fieldName": "setCustomValidityCustomError"
1477
- },
1478
- {
1479
- "name": "setCustomValidityValueMissing",
1480
- "type": {
1481
- "text": "string"
1482
- },
1483
- "description": "Custom help text message to display when validity = `valueMissing`.",
1484
- "fieldName": "setCustomValidityValueMissing"
1485
- },
1486
- {
1487
- "name": "setCustomValidityValueMissingFilter",
1488
- "type": {
1489
- "text": "string"
1490
- },
1491
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1492
- "fieldName": "setCustomValidityValueMissingFilter"
1493
- },
1494
- {
1495
- "name": "triggerIcon",
1496
- "type": {
1497
- "text": "boolean"
1498
- },
1499
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1500
- "fieldName": "triggerIcon"
1501
- },
1502
- {
1503
- "name": "type",
1504
- "type": {
1505
- "text": "string"
1506
- },
1507
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1508
- "fieldName": "type"
1509
- },
1510
- {
1511
- "name": "typedValue",
1512
- "type": {
1513
- "text": "string"
1514
- },
1515
- "description": "Specifies the value of the input element within the combobox.",
1516
- "fieldName": "typedValue"
1517
- },
1518
- {
1519
- "name": "validity",
1520
- "type": {
1521
- "text": "string"
1522
- },
1523
- "description": "Specifies the `validityState` this element is in.",
1524
- "fieldName": "validity"
1525
- },
1526
- {
1527
- "name": "value",
1528
- "type": {
1529
- "text": "string"
1530
- },
1531
- "description": "Value selected for the dropdown menu.",
1532
- "fieldName": "value"
1318
+ "kind": "method",
1319
+ "name": "setTriggerInputFocus",
1320
+ "privacy": "private"
1533
1321
  },
1534
1322
  {
1535
- "name": "largeFullscreenHeadline",
1536
- "type": {
1537
- "text": "boolean"
1538
- },
1539
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1540
- "fieldName": "largeFullscreenHeadline"
1323
+ "kind": "method",
1324
+ "name": "setInputFocus",
1325
+ "privacy": "private"
1541
1326
  },
1542
1327
  {
1543
- "name": "fullscreenBreakpoint",
1544
- "type": {
1545
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1546
- },
1547
- "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.",
1548
- "default": "'sm'",
1549
- "fieldName": "fullscreenBreakpoint"
1328
+ "kind": "method",
1329
+ "name": "updateBibDialogRole",
1330
+ "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.",
1331
+ "privacy": "private"
1550
1332
  },
1551
1333
  {
1552
- "name": "shape",
1553
- "type": {
1554
- "text": "string"
1555
- },
1556
- "fieldName": "shape",
1557
- "inheritedFrom": {
1558
- "name": "AuroElement",
1559
- "module": "components/layoutElement/src/auroElement.js"
1560
- }
1334
+ "kind": "method",
1335
+ "name": "updateMenuShapeSize",
1336
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1337
+ "privacy": "private"
1561
1338
  },
1562
1339
  {
1563
- "name": "size",
1564
- "type": {
1565
- "text": "string"
1566
- },
1567
- "fieldName": "size",
1568
- "inheritedFrom": {
1569
- "name": "AuroElement",
1570
- "module": "components/layoutElement/src/auroElement.js"
1340
+ "kind": "method",
1341
+ "name": "_getAnnouncementRoot",
1342
+ "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.",
1343
+ "privacy": "private",
1344
+ "return": {
1345
+ "type": {
1346
+ "text": "ShadowRoot"
1347
+ }
1571
1348
  }
1572
1349
  },
1573
1350
  {
1574
- "name": "ondark",
1575
- "type": {
1576
- "text": "boolean"
1577
- },
1578
- "fieldName": "onDark",
1579
- "inheritedFrom": {
1580
- "name": "AuroElement",
1581
- "module": "components/layoutElement/src/auroElement.js"
1351
+ "kind": "method",
1352
+ "name": "configureMenu",
1353
+ "description": "Binds all behavior needed to the menu after rendering.",
1354
+ "privacy": "private",
1355
+ "return": {
1356
+ "type": {
1357
+ "text": "void"
1358
+ }
1582
1359
  }
1583
- }
1584
- ],
1585
- "superclass": {
1586
- "name": "AuroElement",
1587
- "module": "/components/layoutElement/src/auroElement.js"
1588
- },
1589
- "tagName": "auro-combobox",
1590
- "customElement": true
1591
- }
1592
- ],
1593
- "exports": [
1594
- {
1595
- "kind": "js",
1596
- "name": "AuroCombobox",
1597
- "declaration": {
1598
- "name": "AuroCombobox",
1599
- "module": "components/combobox/src/auro-combobox.js"
1600
- }
1601
- }
1602
- ]
1603
- },
1604
- {
1605
- "kind": "javascript-module",
1606
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1607
- "declarations": [
1608
- {
1609
- "kind": "variable",
1610
- "name": "comboboxKeyboardStrategy",
1611
- "type": {
1612
- "text": "object"
1613
- },
1614
- "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) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { 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) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
1615
- }
1616
- ],
1617
- "exports": [
1618
- {
1619
- "kind": "js",
1620
- "name": "comboboxKeyboardStrategy",
1621
- "declaration": {
1622
- "name": "comboboxKeyboardStrategy",
1623
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1624
- }
1625
- }
1626
- ]
1627
- },
1628
- {
1629
- "kind": "javascript-module",
1630
- "path": "components/combobox/src/index.js",
1631
- "declarations": [],
1632
- "exports": [
1633
- {
1634
- "kind": "js",
1635
- "name": "AuroCombobox",
1636
- "declaration": {
1637
- "name": "AuroCombobox",
1638
- "module": "components/combobox/src/index.js"
1639
- }
1640
- }
1641
- ]
1642
- },
1643
- {
1644
- "kind": "javascript-module",
1645
- "path": "components/combobox/src/registered.js",
1646
- "declarations": [],
1647
- "exports": [
1648
- {
1649
- "kind": "js",
1650
- "name": "AuroCombobox",
1651
- "declaration": {
1652
- "name": "AuroCombobox",
1653
- "module": "components/combobox/src/registered.js"
1654
- }
1655
- }
1656
- ]
1657
- },
1658
- {
1659
- "kind": "javascript-module",
1660
- "path": "components/checkbox/src/auro-checkbox-group.js",
1661
- "declarations": [
1662
- {
1663
- "kind": "class",
1664
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1665
- "name": "AuroCheckboxGroup",
1666
- "slots": [
1667
- {
1668
- "description": "Allows for the legend to be overridden.",
1669
- "name": "legend"
1670
- },
1671
- {
1672
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1673
- "name": "optionalLabel"
1674
- },
1675
- {
1676
- "description": "Allows for the helper text to be overridden.",
1677
- "name": "helpText"
1678
1360
  },
1679
- {
1680
- "description": "The default slot for the checkbox items.",
1681
- "name": "default"
1682
- }
1683
- ],
1684
- "members": [
1685
1361
  {
1686
1362
  "kind": "method",
1687
- "name": "_initializeDefaults"
1363
+ "name": "configureInput",
1364
+ "description": "Binds all behavior needed to the input after rendering.",
1365
+ "privacy": "private",
1366
+ "return": {
1367
+ "type": {
1368
+ "text": "void"
1369
+ }
1370
+ }
1688
1371
  },
1689
1372
  {
1690
1373
  "kind": "method",
1691
- "name": "register",
1692
- "static": true,
1374
+ "name": "handleMenuLoadingChange",
1693
1375
  "parameters": [
1694
1376
  {
1695
- "name": "name",
1696
- "default": "\"auro-checkbox-group\"",
1697
- "description": "The name of the element that you want to register.",
1698
- "optional": true,
1377
+ "name": "event",
1378
+ "description": "The event object containing details about the loading state change.",
1699
1379
  "type": {
1700
- "text": "string"
1380
+ "text": "CustomEvent"
1701
1381
  }
1702
- }
1703
- ],
1704
- "description": "This will register this element with the browser."
1705
- },
1706
- {
1707
- "kind": "method",
1708
- "name": "handleValueUpdate",
1709
- "parameters": [
1382
+ },
1710
1383
  {
1711
- "name": "value",
1712
- "description": "The value of the checkbox.",
1384
+ "description": "Indicates whether the menu is currently loading.",
1385
+ "name": "event.detail.loading",
1713
1386
  "type": {
1714
- "text": "String"
1387
+ "text": "boolean"
1715
1388
  }
1716
1389
  },
1717
1390
  {
1718
- "name": "selected",
1719
- "description": "The checked state of the checkbox.",
1391
+ "description": "Indicates if there are loading placeholders present.",
1392
+ "name": "event.detail.hasLoadingPlaceholder",
1393
+ "type": {
1394
+ "text": "boolean"
1395
+ }
1396
+ }
1397
+ ],
1398
+ "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.",
1399
+ "privacy": "private",
1400
+ "return": {
1401
+ "type": {
1402
+ "text": "void"
1403
+ }
1404
+ }
1405
+ },
1406
+ {
1407
+ "kind": "method",
1408
+ "name": "handleInputValueChange",
1409
+ "parameters": [
1410
+ {
1411
+ "name": "event",
1412
+ "description": "The input event triggered by the input element.",
1720
1413
  "type": {
1721
- "text": "Boolean"
1414
+ "text": "Event"
1722
1415
  }
1723
1416
  }
1724
1417
  ],
1725
- "description": "Helper method to handle checkbox value changing.",
1418
+ "description": "Handle changes to the input value and trigger changes that should result.",
1726
1419
  "privacy": "private",
1727
1420
  "return": {
1728
1421
  "type": {
@@ -1732,8 +1425,8 @@
1732
1425
  },
1733
1426
  {
1734
1427
  "kind": "method",
1735
- "name": "handlePreselectedItems",
1736
- "description": "Helper method that handles the state of preselected checkboxes.",
1428
+ "name": "configureCombobox",
1429
+ "description": "Binds all behavior needed to the combobox after rendering.",
1737
1430
  "privacy": "private",
1738
1431
  "return": {
1739
1432
  "type": {
@@ -1743,9 +1436,27 @@
1743
1436
  },
1744
1437
  {
1745
1438
  "kind": "method",
1746
- "name": "handleItems",
1747
- "description": "Helper method that handles the state of checkboxes.",
1748
- "privacy": "private",
1439
+ "name": "focus",
1440
+ "description": "Focuses the combobox trigger input.",
1441
+ "return": {
1442
+ "type": {
1443
+ "text": "void"
1444
+ }
1445
+ }
1446
+ },
1447
+ {
1448
+ "kind": "method",
1449
+ "name": "setMenuValue",
1450
+ "parameters": [
1451
+ {
1452
+ "name": "value",
1453
+ "description": "The value to set on the menu.",
1454
+ "type": {
1455
+ "text": "string"
1456
+ }
1457
+ }
1458
+ ],
1459
+ "description": "Sets the menu value if menu is available.",
1749
1460
  "return": {
1750
1461
  "type": {
1751
1462
  "text": "void"
@@ -1762,6 +1473,16 @@
1762
1473
  }
1763
1474
  }
1764
1475
  },
1476
+ {
1477
+ "kind": "method",
1478
+ "name": "clear",
1479
+ "description": "Clears the current value of the combobox.",
1480
+ "return": {
1481
+ "type": {
1482
+ "text": "void"
1483
+ }
1484
+ }
1485
+ },
1765
1486
  {
1766
1487
  "kind": "method",
1767
1488
  "name": "validate",
@@ -1778,49 +1499,272 @@
1778
1499
  ],
1779
1500
  "description": "Validates value."
1780
1501
  },
1502
+ {
1503
+ "kind": "method",
1504
+ "name": "transportAssignedNodes",
1505
+ "parameters": [
1506
+ {
1507
+ "name": "slot",
1508
+ "description": "The slot element containing the nodes to apply.",
1509
+ "type": {
1510
+ "text": "HTMLSlotElement"
1511
+ }
1512
+ },
1513
+ {
1514
+ "name": "target",
1515
+ "description": "The target element to apply the nodes to.",
1516
+ "type": {
1517
+ "text": "HTMLElement"
1518
+ }
1519
+ },
1520
+ {
1521
+ "name": "newSlotName",
1522
+ "description": "The new slot name for the applied nodes.",
1523
+ "type": {
1524
+ "text": "string"
1525
+ }
1526
+ }
1527
+ ],
1528
+ "description": "Applies slotted nodes to a target element with a new slot name.",
1529
+ "privacy": "private",
1530
+ "return": {
1531
+ "type": {
1532
+ "text": "void"
1533
+ }
1534
+ }
1535
+ },
1536
+ {
1537
+ "kind": "method",
1538
+ "name": "updateActiveOption",
1539
+ "parameters": [
1540
+ {
1541
+ "name": "index",
1542
+ "description": "Index of the option to make active.",
1543
+ "type": {
1544
+ "text": "number"
1545
+ }
1546
+ }
1547
+ ],
1548
+ "description": "Updates the active option in the menu."
1549
+ },
1550
+ {
1551
+ "kind": "method",
1552
+ "name": "handleSlotChange",
1553
+ "parameters": [
1554
+ {
1555
+ "name": "event",
1556
+ "description": "`slotchange` event.",
1557
+ "type": {
1558
+ "text": "Event"
1559
+ }
1560
+ }
1561
+ ],
1562
+ "description": "Watch for slot changes and recalculate the menuoptions.",
1563
+ "privacy": "private",
1564
+ "return": {
1565
+ "type": {
1566
+ "text": "void"
1567
+ }
1568
+ }
1569
+ },
1570
+ {
1571
+ "kind": "field",
1572
+ "name": "appearance",
1573
+ "privacy": "public",
1574
+ "type": {
1575
+ "text": "string"
1576
+ },
1577
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1578
+ "default": "'default'",
1579
+ "attribute": "appearance",
1580
+ "reflects": true
1581
+ },
1582
+ {
1583
+ "kind": "field",
1584
+ "name": "autocomplete",
1585
+ "privacy": "public",
1586
+ "type": {
1587
+ "text": "string"
1588
+ },
1589
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1590
+ "attribute": "autocomplete",
1591
+ "reflects": true
1592
+ },
1593
+ {
1594
+ "kind": "field",
1595
+ "name": "autoPlacement",
1596
+ "privacy": "public",
1597
+ "type": {
1598
+ "text": "boolean"
1599
+ },
1600
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1601
+ "attribute": "autoPlacement",
1602
+ "reflects": true
1603
+ },
1604
+ {
1605
+ "kind": "field",
1606
+ "name": "availableOptions",
1607
+ "privacy": "private",
1608
+ "type": {
1609
+ "text": "array"
1610
+ },
1611
+ "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).",
1612
+ "attribute": "availableOptions"
1613
+ },
1614
+ {
1615
+ "kind": "field",
1616
+ "name": "behavior",
1617
+ "privacy": "public",
1618
+ "type": {
1619
+ "text": "'filter' | 'suggestion'"
1620
+ },
1621
+ "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.",
1622
+ "default": "'suggestion'",
1623
+ "attribute": "behavior",
1624
+ "reflects": true
1625
+ },
1626
+ {
1627
+ "kind": "field",
1628
+ "name": "checkmark",
1629
+ "privacy": "public",
1630
+ "type": {
1631
+ "text": "boolean"
1632
+ },
1633
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1634
+ "attribute": "checkmark",
1635
+ "reflects": true
1636
+ },
1637
+ {
1638
+ "kind": "field",
1639
+ "name": "disabled",
1640
+ "privacy": "public",
1641
+ "type": {
1642
+ "text": "boolean"
1643
+ },
1644
+ "description": "If set, disables the combobox.",
1645
+ "attribute": "disabled",
1646
+ "reflects": true
1647
+ },
1648
+ {
1649
+ "kind": "field",
1650
+ "name": "dropdownId",
1651
+ "privacy": "private",
1652
+ "type": {
1653
+ "text": "string"
1654
+ },
1655
+ "description": "ID for the dropdown."
1656
+ },
1657
+ {
1658
+ "kind": "field",
1659
+ "name": "dropdownOpen",
1660
+ "privacy": "private",
1661
+ "type": {
1662
+ "text": "boolean"
1663
+ },
1664
+ "description": "Whether or not the dropdown is open."
1665
+ },
1666
+ {
1667
+ "kind": "field",
1668
+ "name": "dvInputOnly",
1669
+ "privacy": "public",
1670
+ "type": {
1671
+ "text": "boolean"
1672
+ },
1673
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1674
+ "attribute": "dvInputOnly",
1675
+ "reflects": true
1676
+ },
1677
+ {
1678
+ "kind": "field",
1679
+ "name": "error",
1680
+ "privacy": "public",
1681
+ "type": {
1682
+ "text": "string"
1683
+ },
1684
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1685
+ "attribute": "error",
1686
+ "reflects": true
1687
+ },
1688
+ {
1689
+ "kind": "field",
1690
+ "name": "format",
1691
+ "privacy": "public",
1692
+ "type": {
1693
+ "text": "string"
1694
+ },
1695
+ "description": "Specifies the input mask format.",
1696
+ "attribute": "format",
1697
+ "reflects": true
1698
+ },
1699
+ {
1700
+ "kind": "field",
1701
+ "name": "inputmode",
1702
+ "privacy": "public",
1703
+ "type": {
1704
+ "text": "string"
1705
+ },
1706
+ "description": "Exposes inputmode attribute for input.",
1707
+ "attribute": "inputmode",
1708
+ "reflects": true
1709
+ },
1781
1710
  {
1782
1711
  "kind": "field",
1783
- "name": "appearance",
1712
+ "name": "layout",
1784
1713
  "privacy": "public",
1785
1714
  "type": {
1786
- "text": "'default' | 'inverse'"
1715
+ "text": "string"
1787
1716
  },
1788
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1789
- "default": "'default'",
1790
- "attribute": "appearance",
1717
+ "description": "Sets the layout of the combobox.",
1718
+ "default": "'classic'",
1719
+ "attribute": "layout",
1720
+ "reflects": true,
1721
+ "inheritedFrom": {
1722
+ "name": "AuroElement",
1723
+ "module": "components/layoutElement/src/auroElement.js"
1724
+ }
1725
+ },
1726
+ {
1727
+ "kind": "field",
1728
+ "name": "matchWidth",
1729
+ "privacy": "private",
1730
+ "type": {
1731
+ "text": "boolean"
1732
+ },
1733
+ "description": "If declared, the popover and trigger will be set to the same width.",
1734
+ "attribute": "matchWidth",
1791
1735
  "reflects": true
1792
1736
  },
1793
1737
  {
1794
1738
  "kind": "field",
1795
- "name": "disabled",
1739
+ "name": "noFilter",
1796
1740
  "privacy": "public",
1797
1741
  "type": {
1798
1742
  "text": "boolean"
1799
1743
  },
1800
- "description": "If set, disables the checkbox group.",
1801
- "attribute": "disabled",
1744
+ "description": "If set, combobox will not filter menuoptions based on input.",
1745
+ "attribute": "noFilter",
1802
1746
  "reflects": true
1803
1747
  },
1804
1748
  {
1805
1749
  "kind": "field",
1806
- "name": "error",
1750
+ "name": "noFlip",
1807
1751
  "privacy": "public",
1808
1752
  "type": {
1809
- "text": "string"
1753
+ "text": "boolean"
1810
1754
  },
1811
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1812
- "attribute": "error",
1755
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1756
+ "attribute": "noFlip",
1813
1757
  "reflects": true
1814
1758
  },
1815
1759
  {
1816
1760
  "kind": "field",
1817
- "name": "horizontal",
1761
+ "name": "shift",
1818
1762
  "privacy": "public",
1819
1763
  "type": {
1820
1764
  "text": "boolean"
1821
1765
  },
1822
- "description": "If set, checkboxes will be aligned horizontally.",
1823
- "attribute": "horizontal",
1766
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1767
+ "attribute": "shift",
1824
1768
  "reflects": true
1825
1769
  },
1826
1770
  {
@@ -1836,667 +1780,723 @@
1836
1780
  },
1837
1781
  {
1838
1782
  "kind": "field",
1839
- "name": "onDark",
1783
+ "name": "offset",
1840
1784
  "privacy": "public",
1841
1785
  "type": {
1842
- "text": "boolean"
1786
+ "text": "number"
1843
1787
  },
1844
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1845
- "attribute": "onDark",
1788
+ "description": "Gap between the trigger element and bib.",
1789
+ "default": "0",
1790
+ "attribute": "offset",
1846
1791
  "reflects": true
1847
1792
  },
1848
1793
  {
1849
1794
  "kind": "field",
1850
- "name": "required",
1795
+ "name": "onDark",
1851
1796
  "privacy": "public",
1852
1797
  "type": {
1853
1798
  "text": "boolean"
1854
1799
  },
1855
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1856
- "attribute": "required",
1857
- "reflects": true
1800
+ "attribute": "onDark",
1801
+ "reflects": true,
1802
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1803
+ "inheritedFrom": {
1804
+ "name": "AuroElement",
1805
+ "module": "components/layoutElement/src/auroElement.js"
1806
+ }
1858
1807
  },
1859
1808
  {
1860
1809
  "kind": "field",
1861
- "name": "setCustomValidity",
1810
+ "name": "optionSelected",
1862
1811
  "privacy": "public",
1863
1812
  "type": {
1864
- "text": "string"
1813
+ "text": "HTMLElement"
1865
1814
  },
1866
- "description": "Sets a custom help text message to display for all validityStates.",
1867
- "attribute": "setCustomValidity"
1815
+ "description": "Specifies the current selected option.",
1816
+ "attribute": "optionSelected"
1868
1817
  },
1869
1818
  {
1870
1819
  "kind": "field",
1871
- "name": "setCustomValidityCustomError",
1820
+ "name": "persistInput",
1872
1821
  "privacy": "public",
1873
1822
  "type": {
1874
- "text": "string"
1823
+ "text": "boolean"
1875
1824
  },
1876
- "description": "Custom help text message to display when validity = `customError`.",
1877
- "attribute": "setCustomValidityCustomError"
1825
+ "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.",
1826
+ "attribute": "persistInput",
1827
+ "reflects": true
1878
1828
  },
1879
1829
  {
1880
1830
  "kind": "field",
1881
- "name": "setCustomValidityValueMissing",
1831
+ "name": "placement",
1882
1832
  "privacy": "public",
1883
1833
  "type": {
1884
- "text": "string"
1834
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1885
1835
  },
1886
- "description": "Custom help text message to display when validity = `valueMissing`.",
1887
- "attribute": "setCustomValidityValueMissing"
1836
+ "description": "Position where the bib should appear relative to the trigger.",
1837
+ "default": "'bottom-start'",
1838
+ "attribute": "placement",
1839
+ "reflects": true
1888
1840
  },
1889
1841
  {
1890
1842
  "kind": "field",
1891
- "name": "validity",
1843
+ "name": "placeholder",
1892
1844
  "privacy": "public",
1893
1845
  "type": {
1894
1846
  "text": "string"
1895
1847
  },
1896
- "description": "Specifies the `validityState` this element is in.",
1897
- "attribute": "validity",
1848
+ "description": "Define custom placeholder text, only supported by date input formats.",
1849
+ "attribute": "placeholder",
1898
1850
  "reflects": true
1899
- }
1900
- ],
1901
- "events": [
1902
- {
1903
- "name": "input",
1904
- "type": {
1905
- "text": "CustomEvent"
1906
- }
1907
1851
  },
1908
1852
  {
1909
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1910
- "name": "auroFormElement-validated"
1911
- }
1912
- ],
1913
- "attributes": [
1914
- {
1915
- "name": "appearance",
1853
+ "kind": "field",
1854
+ "name": "required",
1855
+ "privacy": "public",
1916
1856
  "type": {
1917
- "text": "'default' | 'inverse'"
1857
+ "text": "boolean"
1918
1858
  },
1919
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1920
- "default": "'default'",
1921
- "fieldName": "appearance"
1859
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1860
+ "attribute": "required",
1861
+ "reflects": true
1922
1862
  },
1923
1863
  {
1924
- "name": "disabled",
1864
+ "kind": "field",
1865
+ "name": "setCustomValidity",
1866
+ "privacy": "public",
1925
1867
  "type": {
1926
- "text": "boolean"
1868
+ "text": "string"
1927
1869
  },
1928
- "description": "If set, disables the checkbox group.",
1929
- "fieldName": "disabled"
1870
+ "description": "Sets a custom help text message to display for all validityStates.",
1871
+ "attribute": "setCustomValidity"
1930
1872
  },
1931
1873
  {
1932
- "name": "error",
1874
+ "kind": "field",
1875
+ "name": "setCustomValidityCustomError",
1876
+ "privacy": "public",
1933
1877
  "type": {
1934
1878
  "text": "string"
1935
1879
  },
1936
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1937
- "fieldName": "error"
1880
+ "description": "Custom help text message to display when validity = `customError`.",
1881
+ "attribute": "setCustomValidityCustomError"
1938
1882
  },
1939
1883
  {
1940
- "name": "horizontal",
1884
+ "kind": "field",
1885
+ "name": "setCustomValidityValueMissing",
1886
+ "privacy": "public",
1941
1887
  "type": {
1942
- "text": "boolean"
1888
+ "text": "string"
1943
1889
  },
1944
- "description": "If set, checkboxes will be aligned horizontally.",
1945
- "fieldName": "horizontal"
1890
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1891
+ "attribute": "setCustomValidityValueMissing"
1946
1892
  },
1947
1893
  {
1948
- "name": "noValidate",
1894
+ "kind": "field",
1895
+ "name": "setCustomValidityValueMissingFilter",
1896
+ "privacy": "public",
1949
1897
  "type": {
1950
- "text": "boolean"
1898
+ "text": "string"
1951
1899
  },
1952
- "description": "If set, disables auto-validation on blur.",
1953
- "fieldName": "noValidate"
1900
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1901
+ "attribute": "setCustomValidityValueMissingFilter"
1954
1902
  },
1955
1903
  {
1956
- "name": "onDark",
1904
+ "kind": "field",
1905
+ "name": "touched",
1906
+ "privacy": "private",
1957
1907
  "type": {
1958
1908
  "text": "boolean"
1959
1909
  },
1960
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1961
- "fieldName": "onDark"
1910
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1962
1911
  },
1963
1912
  {
1964
- "name": "required",
1913
+ "kind": "field",
1914
+ "name": "triggerIcon",
1915
+ "privacy": "public",
1965
1916
  "type": {
1966
1917
  "text": "boolean"
1967
1918
  },
1968
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1969
- "fieldName": "required"
1919
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1920
+ "attribute": "triggerIcon",
1921
+ "reflects": true
1970
1922
  },
1971
1923
  {
1972
- "name": "setCustomValidity",
1924
+ "kind": "field",
1925
+ "name": "type",
1926
+ "privacy": "public",
1973
1927
  "type": {
1974
1928
  "text": "string"
1975
1929
  },
1976
- "description": "Sets a custom help text message to display for all validityStates.",
1977
- "fieldName": "setCustomValidity"
1930
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1931
+ "attribute": "type",
1932
+ "reflects": true
1978
1933
  },
1979
1934
  {
1980
- "name": "setCustomValidityCustomError",
1935
+ "kind": "field",
1936
+ "name": "typedValue",
1937
+ "privacy": "public",
1981
1938
  "type": {
1982
1939
  "text": "string"
1983
1940
  },
1984
- "description": "Custom help text message to display when validity = `customError`.",
1985
- "fieldName": "setCustomValidityCustomError"
1941
+ "description": "Specifies the value of the input element within the combobox.",
1942
+ "attribute": "typedValue",
1943
+ "reflects": true
1986
1944
  },
1987
1945
  {
1988
- "name": "setCustomValidityValueMissing",
1946
+ "kind": "field",
1947
+ "name": "validity",
1948
+ "privacy": "public",
1989
1949
  "type": {
1990
1950
  "text": "string"
1991
1951
  },
1992
- "description": "Custom help text message to display when validity = `valueMissing`.",
1993
- "fieldName": "setCustomValidityValueMissing"
1952
+ "description": "Specifies the `validityState` this element is in.",
1953
+ "attribute": "validity",
1954
+ "reflects": true
1994
1955
  },
1995
1956
  {
1996
- "name": "validity",
1957
+ "kind": "field",
1958
+ "name": "value",
1959
+ "privacy": "public",
1997
1960
  "type": {
1998
1961
  "text": "string"
1999
1962
  },
2000
- "description": "Specifies the `validityState` this element is in.",
2001
- "fieldName": "validity"
2002
- }
2003
- ],
2004
- "superclass": {
2005
- "name": "LitElement",
2006
- "package": "lit"
2007
- },
2008
- "tagName": "auro-checkbox-group",
2009
- "customElement": true
2010
- }
2011
- ],
2012
- "exports": [
2013
- {
2014
- "kind": "js",
2015
- "name": "AuroCheckboxGroup",
2016
- "declaration": {
2017
- "name": "AuroCheckboxGroup",
2018
- "module": "components/checkbox/src/auro-checkbox-group.js"
2019
- }
2020
- }
2021
- ]
2022
- },
2023
- {
2024
- "kind": "javascript-module",
2025
- "path": "components/checkbox/src/auro-checkbox.js",
2026
- "declarations": [
2027
- {
2028
- "kind": "class",
2029
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2030
- "name": "AuroCheckbox",
2031
- "cssParts": [
1963
+ "description": "Value selected for the dropdown menu.",
1964
+ "attribute": "value"
1965
+ },
2032
1966
  {
2033
- "description": "apply css to a specific checkbox.",
2034
- "name": "checkbox"
1967
+ "kind": "field",
1968
+ "name": "largeFullscreenHeadline",
1969
+ "privacy": "public",
1970
+ "type": {
1971
+ "text": "boolean"
1972
+ },
1973
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1974
+ "attribute": "largeFullscreenHeadline",
1975
+ "reflects": true
2035
1976
  },
2036
1977
  {
2037
- "description": "apply css to a specific checkbox's input.",
2038
- "name": "checkbox-input"
1978
+ "kind": "field",
1979
+ "name": "fullscreenBreakpoint",
1980
+ "privacy": "public",
1981
+ "type": {
1982
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1983
+ },
1984
+ "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.",
1985
+ "default": "'sm'",
1986
+ "attribute": "fullscreenBreakpoint",
1987
+ "reflects": true
2039
1988
  },
2040
1989
  {
2041
- "description": "apply css to a specific checkbox's label.",
2042
- "name": "checkbox-label"
2043
- }
2044
- ],
2045
- "slots": [
2046
- {
2047
- "description": "The default slot for the checkbox label.",
2048
- "name": "default"
2049
- }
2050
- ],
2051
- "members": [
2052
- {
2053
- "kind": "method",
2054
- "name": "_initializeDefaults"
1990
+ "kind": "field",
1991
+ "name": "optionActive",
1992
+ "privacy": "private",
1993
+ "type": {
1994
+ "text": "object"
1995
+ },
1996
+ "description": "Specifies the currently active option."
2055
1997
  },
2056
1998
  {
2057
- "kind": "method",
2058
- "name": "register",
2059
- "static": true,
2060
- "parameters": [
2061
- {
2062
- "name": "name",
2063
- "default": "\"auro-checkbox\"",
2064
- "description": "The name of element that you want to register to.",
2065
- "optional": true,
2066
- "type": {
2067
- "text": "string"
2068
- }
2069
- }
2070
- ],
2071
- "description": "This will register this element with the browser."
1999
+ "kind": "field",
2000
+ "name": "triggerExpandedState",
2001
+ "privacy": "private",
2002
+ "type": {
2003
+ "text": "boolean"
2004
+ },
2005
+ "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
2072
2006
  },
2073
2007
  {
2074
- "kind": "method",
2075
- "name": "handleChange",
2076
- "parameters": [
2077
- {
2078
- "name": "event",
2079
- "description": "The change event from the checkbox input.",
2080
- "type": {
2081
- "text": "Event"
2082
- }
2083
- }
2084
- ],
2085
- "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.",
2008
+ "kind": "field",
2009
+ "name": "componentHasFocus",
2010
+ "description": "Returns true if the element has focus.",
2086
2011
  "privacy": "private",
2087
2012
  "return": {
2088
2013
  "type": {
2089
- "text": "void"
2014
+ "text": "boolean"
2090
2015
  }
2016
+ },
2017
+ "readonly": true,
2018
+ "inheritedFrom": {
2019
+ "name": "AuroElement",
2020
+ "module": "components/layoutElement/src/auroElement.js"
2091
2021
  }
2092
2022
  },
2093
2023
  {
2094
2024
  "kind": "method",
2095
- "name": "handleInput",
2096
- "parameters": [
2097
- {
2098
- "name": "event",
2099
- "description": "The input event from the checkbox input.",
2100
- "type": {
2101
- "text": "Event"
2102
- }
2103
- }
2104
- ],
2105
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2106
- "privacy": "private",
2107
- "return": {
2108
- "type": {
2109
- "text": "void"
2110
- }
2025
+ "name": "resetShapeClasses",
2026
+ "inheritedFrom": {
2027
+ "name": "AuroElement",
2028
+ "module": "components/layoutElement/src/auroElement.js"
2111
2029
  }
2112
2030
  },
2113
2031
  {
2114
2032
  "kind": "method",
2115
- "name": "handleFocusin",
2116
- "description": "Function to support",
2117
- "privacy": "private",
2118
- "return": {
2119
- "type": {
2120
- "text": "void"
2121
- }
2033
+ "name": "resetLayoutClasses",
2034
+ "inheritedFrom": {
2035
+ "name": "AuroElement",
2036
+ "module": "components/layoutElement/src/auroElement.js"
2122
2037
  }
2123
2038
  },
2124
2039
  {
2125
2040
  "kind": "method",
2126
- "name": "generateIconHtml",
2127
- "description": "Function to generate checkmark svg.",
2128
- "privacy": "private",
2129
- "return": {
2130
- "type": {
2131
- "text": "HTMLElement"
2132
- }
2041
+ "name": "updateComponentArchitecture",
2042
+ "inheritedFrom": {
2043
+ "name": "AuroElement",
2044
+ "module": "components/layoutElement/src/auroElement.js"
2133
2045
  }
2134
2046
  },
2135
2047
  {
2136
- "kind": "method",
2137
- "name": "reset",
2138
- "description": "Resets component to initial state.",
2139
- "return": {
2140
- "type": {
2141
- "text": "void"
2142
- }
2048
+ "kind": "field",
2049
+ "name": "shape",
2050
+ "privacy": "public",
2051
+ "type": {
2052
+ "text": "string"
2053
+ },
2054
+ "attribute": "shape",
2055
+ "reflects": true,
2056
+ "inheritedFrom": {
2057
+ "name": "AuroElement",
2058
+ "module": "components/layoutElement/src/auroElement.js"
2143
2059
  }
2144
2060
  },
2145
2061
  {
2146
- "kind": "method",
2147
- "name": "updateAriaLabel",
2148
- "description": "Updates the aria-label based on slot content.",
2149
- "privacy": "private",
2150
- "return": {
2151
- "type": {
2152
- "text": "void"
2153
- }
2062
+ "kind": "field",
2063
+ "name": "size",
2064
+ "privacy": "public",
2065
+ "type": {
2066
+ "text": "string"
2067
+ },
2068
+ "attribute": "size",
2069
+ "reflects": true,
2070
+ "inheritedFrom": {
2071
+ "name": "AuroElement",
2072
+ "module": "components/layoutElement/src/auroElement.js"
2154
2073
  }
2074
+ }
2075
+ ],
2076
+ "events": [
2077
+ {
2078
+ "name": "inputValue",
2079
+ "type": {
2080
+ "text": "CustomEvent"
2081
+ },
2082
+ "description": "Notifies that the components internal HTML5 input value has changed."
2155
2083
  },
2156
2084
  {
2157
- "kind": "method",
2158
- "name": "handleKeyDown",
2159
- "parameters": [
2160
- {
2161
- "name": "event",
2162
- "description": "The keydown event from the checkbox input.",
2163
- "type": {
2164
- "text": "KeyboardEvent"
2165
- }
2166
- }
2167
- ],
2168
- "description": "Handles keydown event to toggle the checkbox with Space key.",
2169
- "privacy": "private",
2170
- "return": {
2171
- "type": {
2172
- "text": "void"
2173
- }
2174
- }
2085
+ "name": "input",
2086
+ "type": {
2087
+ "text": "CustomEvent"
2088
+ },
2089
+ "description": "Notifies that the component has a new value set."
2175
2090
  },
2176
2091
  {
2177
- "kind": "field",
2092
+ "name": "auroCombobox-valueSet",
2093
+ "type": {
2094
+ "text": "CustomEvent"
2095
+ },
2096
+ "description": "(Deprecated) Notifies that the component has a new value set."
2097
+ },
2098
+ {
2099
+ "description": "Notifies that the component value(s) have been validated.",
2100
+ "name": "auroFormElement-validated"
2101
+ }
2102
+ ],
2103
+ "attributes": [
2104
+ {
2178
2105
  "name": "appearance",
2179
- "privacy": "public",
2180
2106
  "type": {
2181
- "text": "'default' | 'inverse'"
2107
+ "text": "string"
2182
2108
  },
2183
2109
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
2184
2110
  "default": "'default'",
2185
- "attribute": "appearance",
2186
- "reflects": true
2111
+ "fieldName": "appearance"
2187
2112
  },
2188
2113
  {
2189
- "kind": "field",
2190
- "name": "checked",
2191
- "privacy": "public",
2114
+ "name": "autocomplete",
2115
+ "type": {
2116
+ "text": "string"
2117
+ },
2118
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2119
+ "fieldName": "autocomplete"
2120
+ },
2121
+ {
2122
+ "name": "autoPlacement",
2123
+ "type": {
2124
+ "text": "boolean"
2125
+ },
2126
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
2127
+ "fieldName": "autoPlacement"
2128
+ },
2129
+ {
2130
+ "name": "availableOptions",
2131
+ "type": {
2132
+ "text": "array"
2133
+ },
2134
+ "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).",
2135
+ "fieldName": "availableOptions"
2136
+ },
2137
+ {
2138
+ "name": "behavior",
2139
+ "type": {
2140
+ "text": "'filter' | 'suggestion'"
2141
+ },
2142
+ "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.",
2143
+ "default": "'suggestion'",
2144
+ "fieldName": "behavior"
2145
+ },
2146
+ {
2147
+ "name": "checkmark",
2148
+ "type": {
2149
+ "text": "boolean"
2150
+ },
2151
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
2152
+ "fieldName": "checkmark"
2153
+ },
2154
+ {
2155
+ "name": "disabled",
2192
2156
  "type": {
2193
2157
  "text": "boolean"
2194
2158
  },
2195
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2196
- "attribute": "checked",
2197
- "reflects": true
2159
+ "description": "If set, disables the combobox.",
2160
+ "fieldName": "disabled"
2198
2161
  },
2199
2162
  {
2200
- "kind": "field",
2201
- "name": "disabled",
2202
- "privacy": "public",
2163
+ "name": "dvInputOnly",
2203
2164
  "type": {
2204
2165
  "text": "boolean"
2205
2166
  },
2206
- "description": "If set to true, the checkbox will not be clickable.",
2207
- "attribute": "disabled",
2208
- "reflects": true
2167
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2168
+ "fieldName": "dvInputOnly"
2209
2169
  },
2210
2170
  {
2211
- "kind": "field",
2212
2171
  "name": "error",
2213
- "privacy": "public",
2214
2172
  "type": {
2215
- "text": "boolean"
2173
+ "text": "string"
2216
2174
  },
2217
- "description": "If set to true, the checkbox will be displayed with an error state.",
2218
- "attribute": "error",
2219
- "reflects": true
2175
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2176
+ "fieldName": "error"
2220
2177
  },
2221
2178
  {
2222
- "kind": "field",
2223
- "name": "id",
2224
- "privacy": "public",
2179
+ "name": "format",
2225
2180
  "type": {
2226
2181
  "text": "string"
2227
2182
  },
2228
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2229
- "attribute": "id",
2230
- "reflects": true
2183
+ "description": "Specifies the input mask format.",
2184
+ "fieldName": "format"
2231
2185
  },
2232
2186
  {
2233
- "kind": "field",
2234
- "name": "inputId",
2235
- "privacy": "private",
2187
+ "name": "inputmode",
2236
2188
  "type": {
2237
2189
  "text": "string"
2238
2190
  },
2239
- "description": "The id for input node."
2191
+ "description": "Exposes inputmode attribute for input.",
2192
+ "fieldName": "inputmode"
2240
2193
  },
2241
2194
  {
2242
- "kind": "field",
2243
- "name": "name",
2244
- "privacy": "public",
2195
+ "name": "layout",
2245
2196
  "type": {
2246
2197
  "text": "string"
2247
2198
  },
2248
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2249
- "attribute": "name"
2199
+ "description": "Sets the layout of the combobox.",
2200
+ "default": "'classic'",
2201
+ "fieldName": "layout",
2202
+ "inheritedFrom": {
2203
+ "name": "AuroElement",
2204
+ "module": "components/layoutElement/src/auroElement.js"
2205
+ }
2250
2206
  },
2251
2207
  {
2252
- "kind": "field",
2253
- "name": "onDark",
2254
- "privacy": "public",
2208
+ "name": "matchWidth",
2255
2209
  "type": {
2256
2210
  "text": "boolean"
2257
2211
  },
2258
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2259
- "attribute": "onDark",
2260
- "reflects": true
2212
+ "description": "If declared, the popover and trigger will be set to the same width.",
2213
+ "fieldName": "matchWidth"
2261
2214
  },
2262
2215
  {
2263
- "kind": "field",
2264
- "name": "touched",
2265
- "privacy": "private",
2216
+ "name": "noFilter",
2266
2217
  "type": {
2267
2218
  "text": "boolean"
2268
2219
  },
2269
- "description": "Indicates whether the checkbox has been interacted with."
2220
+ "description": "If set, combobox will not filter menuoptions based on input.",
2221
+ "fieldName": "noFilter"
2270
2222
  },
2271
2223
  {
2272
- "kind": "field",
2273
- "name": "value",
2274
- "privacy": "public",
2224
+ "name": "noFlip",
2275
2225
  "type": {
2276
- "text": "string"
2226
+ "text": "boolean"
2277
2227
  },
2278
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2279
- "attribute": "value"
2228
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2229
+ "fieldName": "noFlip"
2280
2230
  },
2281
2231
  {
2282
- "kind": "field",
2283
- "name": "tabIndex",
2284
- "privacy": "private",
2232
+ "name": "shift",
2285
2233
  "type": {
2286
- "text": "number"
2234
+ "text": "boolean"
2287
2235
  },
2288
- "description": "The tabindex attribute for the checkbox.",
2289
- "attribute": "tabindex",
2290
- "reflects": true
2236
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2237
+ "fieldName": "shift"
2291
2238
  },
2292
2239
  {
2293
- "kind": "field",
2294
- "name": "ariaChecked",
2295
- "privacy": "private",
2240
+ "name": "noValidate",
2296
2241
  "type": {
2297
- "text": "string"
2242
+ "text": "boolean"
2298
2243
  },
2299
- "description": "The aria-checked attribute for the checkbox.",
2300
- "attribute": "aria-checked",
2301
- "reflects": true
2244
+ "description": "If set, disables auto-validation on blur.",
2245
+ "fieldName": "noValidate"
2302
2246
  },
2303
2247
  {
2304
- "kind": "field",
2305
- "name": "ariaDisabled",
2306
- "privacy": "private",
2248
+ "name": "offset",
2307
2249
  "type": {
2308
- "text": "string"
2250
+ "text": "number"
2309
2251
  },
2310
- "description": "The aria-disabled attribute for the checkbox.",
2311
- "attribute": "aria-disabled",
2312
- "reflects": true
2252
+ "description": "Gap between the trigger element and bib.",
2253
+ "default": "0",
2254
+ "fieldName": "offset"
2313
2255
  },
2314
2256
  {
2315
- "kind": "field",
2316
- "name": "role",
2317
- "privacy": "private",
2257
+ "name": "onDark",
2318
2258
  "type": {
2319
- "text": "string"
2259
+ "text": "boolean"
2320
2260
  },
2321
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2322
- "attribute": "role",
2323
- "reflects": true
2324
- }
2325
- ],
2326
- "events": [
2261
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2262
+ "fieldName": "onDark"
2263
+ },
2327
2264
  {
2328
- "name": "auroCheckbox-input",
2265
+ "name": "optionSelected",
2329
2266
  "type": {
2330
- "text": "CustomEvent"
2331
- }
2267
+ "text": "HTMLElement"
2268
+ },
2269
+ "description": "Specifies the current selected option.",
2270
+ "fieldName": "optionSelected"
2332
2271
  },
2333
2272
  {
2334
- "name": "auroCheckbox-focusin",
2273
+ "name": "persistInput",
2335
2274
  "type": {
2336
- "text": "CustomEvent"
2337
- }
2275
+ "text": "boolean"
2276
+ },
2277
+ "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.",
2278
+ "fieldName": "persistInput"
2338
2279
  },
2339
2280
  {
2340
- "name": "auroCheckbox-focusout",
2281
+ "name": "placement",
2341
2282
  "type": {
2342
- "text": "CustomEvent"
2343
- }
2283
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2284
+ },
2285
+ "description": "Position where the bib should appear relative to the trigger.",
2286
+ "default": "'bottom-start'",
2287
+ "fieldName": "placement"
2344
2288
  },
2345
2289
  {
2346
- "description": "(Deprecated) Notifies when checked value is changed.",
2347
- "name": "change"
2290
+ "name": "placeholder",
2291
+ "type": {
2292
+ "text": "string"
2293
+ },
2294
+ "description": "Define custom placeholder text, only supported by date input formats.",
2295
+ "fieldName": "placeholder"
2348
2296
  },
2349
2297
  {
2350
- "description": "Notifies when when checked value is changed by user's interface.",
2351
- "name": "input"
2352
- }
2353
- ],
2354
- "attributes": [
2298
+ "name": "required",
2299
+ "type": {
2300
+ "text": "boolean"
2301
+ },
2302
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2303
+ "fieldName": "required"
2304
+ },
2355
2305
  {
2356
- "name": "appearance",
2306
+ "name": "setCustomValidity",
2357
2307
  "type": {
2358
- "text": "'default' | 'inverse'"
2308
+ "text": "string"
2359
2309
  },
2360
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2361
- "default": "'default'",
2362
- "fieldName": "appearance"
2310
+ "description": "Sets a custom help text message to display for all validityStates.",
2311
+ "fieldName": "setCustomValidity"
2363
2312
  },
2364
2313
  {
2365
- "name": "checked",
2314
+ "name": "setCustomValidityCustomError",
2366
2315
  "type": {
2367
- "text": "boolean"
2316
+ "text": "string"
2368
2317
  },
2369
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2370
- "fieldName": "checked"
2318
+ "description": "Custom help text message to display when validity = `customError`.",
2319
+ "fieldName": "setCustomValidityCustomError"
2371
2320
  },
2372
2321
  {
2373
- "name": "disabled",
2322
+ "name": "setCustomValidityValueMissing",
2374
2323
  "type": {
2375
- "text": "boolean"
2324
+ "text": "string"
2376
2325
  },
2377
- "description": "If set to true, the checkbox will not be clickable.",
2378
- "fieldName": "disabled"
2326
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2327
+ "fieldName": "setCustomValidityValueMissing"
2379
2328
  },
2380
2329
  {
2381
- "name": "error",
2330
+ "name": "setCustomValidityValueMissingFilter",
2331
+ "type": {
2332
+ "text": "string"
2333
+ },
2334
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2335
+ "fieldName": "setCustomValidityValueMissingFilter"
2336
+ },
2337
+ {
2338
+ "name": "triggerIcon",
2382
2339
  "type": {
2383
2340
  "text": "boolean"
2384
2341
  },
2385
- "description": "If set to true, the checkbox will be displayed with an error state.",
2386
- "fieldName": "error"
2342
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2343
+ "fieldName": "triggerIcon"
2387
2344
  },
2388
2345
  {
2389
- "name": "id",
2346
+ "name": "type",
2390
2347
  "type": {
2391
2348
  "text": "string"
2392
2349
  },
2393
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2394
- "fieldName": "id"
2350
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2351
+ "fieldName": "type"
2395
2352
  },
2396
2353
  {
2397
- "name": "name",
2354
+ "name": "typedValue",
2398
2355
  "type": {
2399
2356
  "text": "string"
2400
2357
  },
2401
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2402
- "fieldName": "name"
2358
+ "description": "Specifies the value of the input element within the combobox.",
2359
+ "fieldName": "typedValue"
2403
2360
  },
2404
2361
  {
2405
- "name": "onDark",
2362
+ "name": "validity",
2406
2363
  "type": {
2407
- "text": "boolean"
2364
+ "text": "string"
2408
2365
  },
2409
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2410
- "fieldName": "onDark"
2366
+ "description": "Specifies the `validityState` this element is in.",
2367
+ "fieldName": "validity"
2411
2368
  },
2412
2369
  {
2413
2370
  "name": "value",
2414
2371
  "type": {
2415
2372
  "text": "string"
2416
2373
  },
2417
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2374
+ "description": "Value selected for the dropdown menu.",
2418
2375
  "fieldName": "value"
2419
2376
  },
2420
2377
  {
2421
- "name": "tabindex",
2378
+ "name": "largeFullscreenHeadline",
2422
2379
  "type": {
2423
- "text": "number"
2380
+ "text": "boolean"
2424
2381
  },
2425
- "description": "The tabindex attribute for the checkbox.",
2426
- "fieldName": "tabIndex"
2382
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2383
+ "fieldName": "largeFullscreenHeadline"
2427
2384
  },
2428
2385
  {
2429
- "name": "aria-checked",
2386
+ "name": "fullscreenBreakpoint",
2387
+ "type": {
2388
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2389
+ },
2390
+ "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.",
2391
+ "default": "'sm'",
2392
+ "fieldName": "fullscreenBreakpoint"
2393
+ },
2394
+ {
2395
+ "name": "shape",
2430
2396
  "type": {
2431
2397
  "text": "string"
2432
2398
  },
2433
- "description": "The aria-checked attribute for the checkbox.",
2434
- "fieldName": "ariaChecked"
2399
+ "fieldName": "shape",
2400
+ "inheritedFrom": {
2401
+ "name": "AuroElement",
2402
+ "module": "components/layoutElement/src/auroElement.js"
2403
+ }
2435
2404
  },
2436
2405
  {
2437
- "name": "aria-disabled",
2406
+ "name": "size",
2438
2407
  "type": {
2439
2408
  "text": "string"
2440
2409
  },
2441
- "description": "The aria-disabled attribute for the checkbox.",
2442
- "fieldName": "ariaDisabled"
2410
+ "fieldName": "size",
2411
+ "inheritedFrom": {
2412
+ "name": "AuroElement",
2413
+ "module": "components/layoutElement/src/auroElement.js"
2414
+ }
2443
2415
  },
2444
2416
  {
2445
- "name": "role",
2417
+ "name": "ondark",
2446
2418
  "type": {
2447
- "text": "string"
2419
+ "text": "boolean"
2448
2420
  },
2449
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2450
- "fieldName": "role"
2421
+ "fieldName": "onDark",
2422
+ "inheritedFrom": {
2423
+ "name": "AuroElement",
2424
+ "module": "components/layoutElement/src/auroElement.js"
2425
+ }
2451
2426
  }
2452
2427
  ],
2453
2428
  "superclass": {
2454
- "name": "LitElement",
2455
- "package": "lit"
2429
+ "name": "AuroElement",
2430
+ "module": "/components/layoutElement/src/auroElement.js"
2456
2431
  },
2457
- "tagName": "auro-checkbox",
2432
+ "tagName": "auro-combobox",
2458
2433
  "customElement": true
2459
2434
  }
2460
2435
  ],
2461
2436
  "exports": [
2462
2437
  {
2463
2438
  "kind": "js",
2464
- "name": "AuroCheckbox",
2439
+ "name": "AuroCombobox",
2465
2440
  "declaration": {
2466
- "name": "AuroCheckbox",
2467
- "module": "components/checkbox/src/auro-checkbox.js"
2441
+ "name": "AuroCombobox",
2442
+ "module": "components/combobox/src/auro-combobox.js"
2468
2443
  }
2469
2444
  }
2470
2445
  ]
2471
2446
  },
2472
2447
  {
2473
2448
  "kind": "javascript-module",
2474
- "path": "components/checkbox/src/index.js",
2475
- "declarations": [],
2449
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2450
+ "declarations": [
2451
+ {
2452
+ "kind": "variable",
2453
+ "name": "comboboxKeyboardStrategy",
2454
+ "type": {
2455
+ "text": "object"
2456
+ },
2457
+ "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) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { 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) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
2458
+ }
2459
+ ],
2476
2460
  "exports": [
2477
2461
  {
2478
2462
  "kind": "js",
2479
- "name": "AuroCheckbox",
2463
+ "name": "comboboxKeyboardStrategy",
2480
2464
  "declaration": {
2481
- "name": "AuroCheckbox",
2482
- "module": "components/checkbox/src/index.js"
2465
+ "name": "comboboxKeyboardStrategy",
2466
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2483
2467
  }
2484
- },
2468
+ }
2469
+ ]
2470
+ },
2471
+ {
2472
+ "kind": "javascript-module",
2473
+ "path": "components/combobox/src/index.js",
2474
+ "declarations": [],
2475
+ "exports": [
2485
2476
  {
2486
2477
  "kind": "js",
2487
- "name": "AuroCheckboxGroup",
2478
+ "name": "AuroCombobox",
2488
2479
  "declaration": {
2489
- "name": "AuroCheckboxGroup",
2490
- "module": "components/checkbox/src/index.js"
2480
+ "name": "AuroCombobox",
2481
+ "module": "components/combobox/src/index.js"
2491
2482
  }
2492
2483
  }
2493
2484
  ]
2494
2485
  },
2495
2486
  {
2496
2487
  "kind": "javascript-module",
2497
- "path": "components/checkbox/src/registered.js",
2488
+ "path": "components/combobox/src/registered.js",
2498
2489
  "declarations": [],
2499
- "exports": []
2490
+ "exports": [
2491
+ {
2492
+ "kind": "js",
2493
+ "name": "AuroCombobox",
2494
+ "declaration": {
2495
+ "name": "AuroCombobox",
2496
+ "module": "components/combobox/src/registered.js"
2497
+ }
2498
+ }
2499
+ ]
2500
2500
  },
2501
2501
  {
2502
2502
  "kind": "javascript-module",
@@ -6305,6 +6305,14 @@
6305
6305
  "description": "Defines the label content for the first input.",
6306
6306
  "name": "fromLabel"
6307
6307
  },
6308
+ {
6309
+ "description": "Overrides the \"(optional)\" text rendered next to the first input's label when the datepicker is not `required`.",
6310
+ "name": "optionalFromLabel"
6311
+ },
6312
+ {
6313
+ "description": "Overrides the \"(optional)\" text rendered next to the second input's label when `range` is set and the datepicker is not `required`.",
6314
+ "name": "optionalToLabel"
6315
+ },
6308
6316
  {
6309
6317
  "description": "Defines the content to display in the auro-calendar-cell for the specified date. The content text is colored using the success state token when the `highlight` attribute is applied to the slot.",
6310
6318
  "name": "date_YYYY_MM_DD"
@@ -10493,6 +10501,46 @@
10493
10501
  },
10494
10502
  "privacy": "private"
10495
10503
  },
10504
+ {
10505
+ "kind": "method",
10506
+ "name": "_isDisabled",
10507
+ "parameters": [
10508
+ {
10509
+ "name": "element",
10510
+ "description": "The element to check.",
10511
+ "type": {
10512
+ "text": "HTMLElement | undefined | null"
10513
+ }
10514
+ }
10515
+ ],
10516
+ "description": "Whether a given element is currently disabled. Disabled controls are excluded\nfrom submission, validity, and initial-state checks per the HTML spec\n(section 4.10.19.2 \"Enabling and disabling form controls\":\nhttps://www.w3.org/TR/2011/WD-html5-20110113/association-of-controls-and-forms.html).\n\nImplementation note: we deliberately read only the attribute. Every Auro\nform element in `formElementTags` declares `disabled` with `reflect: true`,\nso the attribute and property stay in sync. Reading the attribute also\nlets the MutationObserver in `connectedCallback` (which is filtered to\n`['disabled', 'name']`) be the single source of truth for re-renders.\nIf a future form-element type ships without attribute reflection, expand\nthis helper to also read `element.disabled`.",
10517
+ "return": {
10518
+ "type": {
10519
+ "text": "boolean"
10520
+ }
10521
+ },
10522
+ "privacy": "private"
10523
+ },
10524
+ {
10525
+ "kind": "method",
10526
+ "name": "_isNameDisabled",
10527
+ "parameters": [
10528
+ {
10529
+ "name": "name",
10530
+ "description": "The `name` attribute used to register the element.",
10531
+ "type": {
10532
+ "text": "string"
10533
+ }
10534
+ }
10535
+ ],
10536
+ "description": "Whether the tracked form element registered under `name` is currently disabled.\nSee `_isDisabled` for the HTML-spec rationale behind excluding disabled\ncontrols from form state.\n\nReads a cached flag on `formState[name]` populated by `_addElementToState`\nat registration and refreshed by `_handleAttributeMutations` whenever the\nelement's `disabled` attribute toggles. The cache is fed by the same\n`hasAttribute('disabled')` read as `_isDisabled`, so the \"future form-element\ntype without attribute reflection\" caveat documented there applies here too.",
10537
+ "return": {
10538
+ "type": {
10539
+ "text": "boolean"
10540
+ }
10541
+ },
10542
+ "privacy": "private"
10543
+ },
10496
10544
  {
10497
10545
  "kind": "method",
10498
10546
  "name": "_eventIsValidFormEvent",
@@ -10574,10 +10622,52 @@
10574
10622
  "privacy": "private",
10575
10623
  "readonly": true
10576
10624
  },
10625
+ {
10626
+ "kind": "method",
10627
+ "name": "_isFormValid",
10628
+ "description": "Raw constraint-validation check. Returns `true` when no enabled field\nhas a validity error. Unlike the public `validity` getter, this does\nNOT gate on `isInitialState` — callers that need to make a decision\nbased on the actual constraint state (submit-button enablement, the\ninternal `submit()` gate) read this so a pre-filled valid form is\ncorrectly recognized as submittable at first render.",
10629
+ "return": {
10630
+ "type": {
10631
+ "text": "boolean"
10632
+ }
10633
+ },
10634
+ "privacy": "private"
10635
+ },
10636
+ {
10637
+ "kind": "method",
10638
+ "name": "_hasResetableState",
10639
+ "description": "Whether the reset button should be enabled. True when the form has\ndiverged from its initial state (so the user can always return to\ndefaults — even if the dirty value lives behind a now-disabled field),\nOR when any non-disabled field has a current value or captured initial\nvalue (covers pre-filled forms and user-cleared-back-to-empty cases).",
10640
+ "return": {
10641
+ "type": {
10642
+ "text": "boolean"
10643
+ }
10644
+ },
10645
+ "privacy": "private"
10646
+ },
10647
+ {
10648
+ "kind": "method",
10649
+ "name": "_normalizeEmpty",
10650
+ "parameters": [
10651
+ {
10652
+ "name": "value",
10653
+ "description": "Value to normalize.",
10654
+ "type": {
10655
+ "text": "*"
10656
+ }
10657
+ }
10658
+ ],
10659
+ "description": "Collapse empty representations to a single canonical `null`.\n\n`_addElementToState` captures `null` for a field that mounts without a\n`value` attribute (`element.value || element.getAttribute('value')` is\nfalsy → resolves to `null`), but `sharedInputListener` later stores the\nraw `event.target.value` — which is `''` for a user-cleared text input.\nWithout this normalization, backspacing back to empty would taint the\nform forever (`'' !== null`) and Reset would stay enabled with nothing\nto actually reset.\n\n`''`, `undefined`, and `[]` all collapse to `null`. The empty-array case\ncovers checkbox-group, radio-group, and multiselect, where `[]` means\n\"no selection\" — semantically the same as `null`/`''`. Genuine values\n— including `0`, `false`, non-empty strings, and non-empty arrays —\npass through unchanged so number, boolean, and populated multi-value\nfields still compare correctly.",
10660
+ "return": {
10661
+ "type": {
10662
+ "text": "*"
10663
+ }
10664
+ },
10665
+ "privacy": "private"
10666
+ },
10577
10667
  {
10578
10668
  "kind": "method",
10579
10669
  "name": "_calculateValidity",
10580
- "description": "Infer validity status based on current formState.",
10670
+ "description": "Infer validity status based on current formState.\n\nValidity stays `null` while the form is in its initial state — this is\nthe \"stay quiet until the user interacts\" UX contract that consumers\ndepend on to delay error indicators. Code that needs the raw\nconstraint-validation result regardless of interaction (e.g.,\nsubmit-button enablement) should call `_isFormValid()` directly.",
10581
10671
  "privacy": "private"
10582
10672
  },
10583
10673
  {
@@ -10594,7 +10684,7 @@
10594
10684
  {
10595
10685
  "kind": "method",
10596
10686
  "name": "_setInitialState",
10597
- "description": "Determines whether the form is in its initial (untouched) state and updates `_isInitialState` accordingly.",
10687
+ "description": "Determines whether the form is in its initial (untouched) state.\n\nA field is tainted if either:\n - its value differs from the value captured on first render, OR\n - its validity is failing (anything other than `null` or `'valid'`).\n\nValidity acts as a backup signal: it catches users who interact with a\nfield without changing its value (e.g., focusing and blurring a required\nfield). We skip `null` (not yet validated) and `'valid'` (the default\nafter Auro's auto-validation on mount) because neither proves the user\ntouched anything.",
10598
10688
  "return": {
10599
10689
  "type": {
10600
10690
  "text": "void"
@@ -10754,6 +10844,26 @@
10754
10844
  },
10755
10845
  "privacy": "private"
10756
10846
  },
10847
+ {
10848
+ "kind": "method",
10849
+ "name": "_handleAttributeMutations",
10850
+ "parameters": [
10851
+ {
10852
+ "name": "mutations",
10853
+ "description": "The batched mutation records.",
10854
+ "type": {
10855
+ "text": "MutationRecord[]"
10856
+ }
10857
+ }
10858
+ ],
10859
+ "description": "Handle batched MutationObserver records for `disabled` and `name`\nattribute changes on tracked form elements. A `name` change invalidates\nthe formState keying — we resolve it by re-initializing state. A `disabled`\nchange simply needs a re-render (so `value` / `validity` getters re-evaluate)\nand a refresh of the submit/reset button enablement.",
10860
+ "return": {
10861
+ "type": {
10862
+ "text": "void"
10863
+ }
10864
+ },
10865
+ "privacy": "private"
10866
+ },
10757
10867
  {
10758
10868
  "kind": "method",
10759
10869
  "name": "mutationEventListener",
@@ -10847,6 +10957,25 @@
10847
10957
  },
10848
10958
  "privacy": "private",
10849
10959
  "default": "[]"
10960
+ },
10961
+ {
10962
+ "kind": "field",
10963
+ "name": "_initialValues",
10964
+ "type": {
10965
+ "text": "Record<string, string | number | boolean | string[] | null | undefined>"
10966
+ },
10967
+ "description": "Captured initial (default) value per field `name`. Populated on first\nsight of each name in `_addElementToState` and preserved across\nsubsequent `initializeState` cycles (slot change, rename, reset) so\n`_setInitialState` can detect user edits as `current !== initial`,\nmatching HTML's `dirtyValueFlag` semantics.",
10968
+ "privacy": "private",
10969
+ "default": "{}"
10970
+ },
10971
+ {
10972
+ "kind": "field",
10973
+ "name": "_attributeObserver",
10974
+ "type": {
10975
+ "text": "MutationObserver | null"
10976
+ },
10977
+ "privacy": "private",
10978
+ "default": "null"
10850
10979
  }
10851
10980
  ],
10852
10981
  "events": [
@@ -18598,6 +18727,32 @@
18598
18727
  ],
18599
18728
  "description": "Updates the active option in the menu."
18600
18729
  },
18730
+ {
18731
+ "kind": "method",
18732
+ "name": "_getOptionDisplayText",
18733
+ "parameters": [
18734
+ {
18735
+ "name": "option",
18736
+ "description": "The menu option element.",
18737
+ "type": {
18738
+ "text": "HTMLElement"
18739
+ }
18740
+ }
18741
+ ],
18742
+ "description": "Returns the lowercase, trimmed text content of a menu option.",
18743
+ "privacy": "private",
18744
+ "return": {
18745
+ "type": {
18746
+ "text": "string"
18747
+ }
18748
+ }
18749
+ },
18750
+ {
18751
+ "kind": "method",
18752
+ "name": "_clearTypeaheadBuffer",
18753
+ "description": "Empties the type-ahead buffer and cancels any pending reset timeout.\nCalled when focus leaves the component, when Escape closes the bib, and on disconnect\nso a stale buffer never bridges into a fresh interaction.",
18754
+ "privacy": "private"
18755
+ },
18601
18756
  {
18602
18757
  "kind": "method",
18603
18758
  "name": "updateActiveOptionBasedOnKey",
@@ -18610,7 +18765,7 @@
18610
18765
  }
18611
18766
  }
18612
18767
  ],
18613
- "description": "Updates the active option in the menu based on keyboard input.",
18768
+ "description": "Updates the active option in the menu based on keyboard input.\n\nImplements the WAI-ARIA APG Listbox type-ahead pattern: accumulates printable\nkeystrokes into a buffer that resets after `typeaheadTimeoutMs` of inactivity.\nA multi-character buffer matches the first option whose displayed text starts\nwith the buffer; repeating a single character cycles through options that start\nwith that character.",
18614
18769
  "privacy": "private",
18615
18770
  "return": {
18616
18771
  "type": {
@@ -19006,6 +19161,24 @@
19006
19161
  },
19007
19162
  "default": "false"
19008
19163
  },
19164
+ {
19165
+ "kind": "field",
19166
+ "name": "typeaheadBuffer",
19167
+ "type": {
19168
+ "text": "string"
19169
+ },
19170
+ "privacy": "private",
19171
+ "default": "''"
19172
+ },
19173
+ {
19174
+ "kind": "field",
19175
+ "name": "_typeaheadTimeout",
19176
+ "type": {
19177
+ "text": "null"
19178
+ },
19179
+ "privacy": "private",
19180
+ "default": "null"
19181
+ },
19009
19182
  {
19010
19183
  "kind": "field",
19011
19184
  "name": "appearance",
@@ -19290,6 +19463,18 @@
19290
19463
  },
19291
19464
  "description": "Indicates whether the input is in a dirty state (has been interacted with)."
19292
19465
  },
19466
+ {
19467
+ "kind": "field",
19468
+ "name": "typeaheadTimeoutMs",
19469
+ "privacy": "public",
19470
+ "type": {
19471
+ "text": "number"
19472
+ },
19473
+ "description": "Milliseconds of keyboard inactivity before the type-ahead buffer resets.\nIncrease for users who type slowly.",
19474
+ "default": "500",
19475
+ "attribute": "typeaheadTimeoutMs",
19476
+ "reflects": true
19477
+ },
19293
19478
  {
19294
19479
  "kind": "field",
19295
19480
  "name": "validity",
@@ -19642,6 +19827,15 @@
19642
19827
  "module": "components/layoutElement/src/auroElement.js"
19643
19828
  }
19644
19829
  },
19830
+ {
19831
+ "name": "typeaheadTimeoutMs",
19832
+ "type": {
19833
+ "text": "number"
19834
+ },
19835
+ "description": "Milliseconds of keyboard inactivity before the type-ahead buffer resets.\nIncrease for users who type slowly.",
19836
+ "default": "500",
19837
+ "fieldName": "typeaheadTimeoutMs"
19838
+ },
19645
19839
  {
19646
19840
  "name": "validity",
19647
19841
  "type": {
@@ -19720,7 +19914,7 @@
19720
19914
  "type": {
19721
19915
  "text": "object"
19722
19916
  },
19723
- "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getEnabledOptions returns a fresh filtered array. const lastOption = getEnabledOptions(component.menu).pop(); if (lastOption) { component.menu.updateActiveOption(lastOption); } }, Enter(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getEnabledOptions(component.menu); if (firstOption) { component.menu.updateActiveOption(firstOption); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { component.updateActiveOptionBasedOnKey(evt.key); if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (ctx.isExpanded) { component.dropdown.hide(); return; } component.dropdown.show(); } }, }"
19917
+ "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { // Always clear the type-ahead buffer — Escape is a universal cancel. // Safe to call when the buffer is empty. // eslint-disable-next-line no-underscore-dangle if (typeof component._clearTypeaheadBuffer === 'function') { // eslint-disable-next-line no-underscore-dangle component._clearTypeaheadBuffer(); } if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getEnabledOptions returns a fresh filtered array. const lastOption = getEnabledOptions(component.menu).pop(); if (lastOption) { component.menu.updateActiveOption(lastOption); } }, Enter(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getEnabledOptions(component.menu); if (firstOption) { component.menu.updateActiveOption(firstOption); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { // Space resolves to either typeahead-buffer extension or bib toggle // depending on whether a type-ahead buffer is active. Mirrors native // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space // is a search character (e.g. \"San Francisco\"); otherwise it toggles. if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) { component.updateActiveOptionBasedOnKey(evt.key); return; } if (ctx.isExpanded) { component.dropdown.hide(); } else { component.dropdown.show(); } return; } component.updateActiveOptionBasedOnKey(evt.key); }, }"
19724
19918
  }
19725
19919
  ],
19726
19920
  "exports": [
@@ -19756,6 +19950,25 @@
19756
19950
  "text": "Array<HTMLElement>"
19757
19951
  }
19758
19952
  }
19953
+ },
19954
+ {
19955
+ "kind": "function",
19956
+ "name": "getActiveOptions",
19957
+ "parameters": [
19958
+ {
19959
+ "name": "menu",
19960
+ "description": "The auro-menu element.",
19961
+ "type": {
19962
+ "text": "HTMLElement | null | undefined"
19963
+ }
19964
+ }
19965
+ ],
19966
+ "description": "Returns the active (selectable + visible) options for type-ahead navigation.\n\nUses auro-menuoption's `isActive` getter, which excludes disabled, hidden,\nand static options (e.g. `static nomatch` placeholders) so the type-ahead\ncursor never lands on a non-actionable item. Same empty-safe handling as\n`getEnabledOptions`.",
19967
+ "return": {
19968
+ "type": {
19969
+ "text": "Array<HTMLElement>"
19970
+ }
19971
+ }
19759
19972
  }
19760
19973
  ],
19761
19974
  "exports": [
@@ -19766,6 +19979,14 @@
19766
19979
  "name": "getEnabledOptions",
19767
19980
  "module": "components/select/src/selectUtils.js"
19768
19981
  }
19982
+ },
19983
+ {
19984
+ "kind": "js",
19985
+ "name": "getActiveOptions",
19986
+ "declaration": {
19987
+ "name": "getActiveOptions",
19988
+ "module": "components/select/src/selectUtils.js"
19989
+ }
19769
19990
  }
19770
19991
  ]
19771
19992
  }