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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/components/checkbox/demo/customize.min.js +1 -1
  2. package/components/checkbox/demo/getting-started.min.js +1 -1
  3. package/components/checkbox/demo/index.min.js +1 -1
  4. package/components/checkbox/dist/index.js +1 -1
  5. package/components/checkbox/dist/registered.js +1 -1
  6. package/components/combobox/demo/customize.min.js +29 -42
  7. package/components/combobox/demo/getting-started.min.js +29 -42
  8. package/components/combobox/demo/index.min.js +29 -42
  9. package/components/combobox/dist/index.js +29 -42
  10. package/components/combobox/dist/registered.js +29 -42
  11. package/components/counter/demo/customize.min.js +2 -2
  12. package/components/counter/demo/index.min.js +2 -2
  13. package/components/counter/dist/index.js +2 -2
  14. package/components/counter/dist/registered.js +2 -2
  15. package/components/datepicker/demo/customize.min.js +29 -42
  16. package/components/datepicker/demo/index.min.js +29 -42
  17. package/components/datepicker/dist/index.js +29 -42
  18. package/components/datepicker/dist/registered.js +29 -42
  19. package/components/dropdown/demo/customize.min.js +1 -1
  20. package/components/dropdown/demo/getting-started.min.js +1 -1
  21. package/components/dropdown/demo/index.min.js +1 -1
  22. package/components/dropdown/dist/index.js +1 -1
  23. package/components/dropdown/dist/registered.js +1 -1
  24. package/components/form/demo/customize.min.js +151 -144
  25. package/components/form/demo/getting-started.min.js +151 -144
  26. package/components/form/demo/index.min.js +151 -144
  27. package/components/form/demo/registerDemoDeps.min.js +151 -144
  28. package/components/input/demo/customize.min.js +27 -40
  29. package/components/input/demo/getting-started.min.js +27 -40
  30. package/components/input/demo/index.min.js +27 -40
  31. package/components/input/dist/base-input.d.ts +4 -20
  32. package/components/input/dist/index.js +27 -40
  33. package/components/input/dist/registered.js +27 -40
  34. package/components/radio/demo/customize.min.js +1 -1
  35. package/components/radio/demo/getting-started.min.js +1 -1
  36. package/components/radio/demo/index.min.js +1 -1
  37. package/components/radio/dist/index.js +1 -1
  38. package/components/radio/dist/registered.js +1 -1
  39. package/components/select/demo/customize.min.js +62 -16
  40. package/components/select/demo/getting-started.min.js +62 -16
  41. package/components/select/demo/index.min.js +62 -16
  42. package/components/select/dist/auro-select.d.ts +6 -0
  43. package/components/select/dist/index.js +62 -16
  44. package/components/select/dist/registered.js +62 -16
  45. package/custom-elements.json +1561 -1615
  46. package/package.json +1 -1
@@ -267,34 +267,107 @@
267
267
  },
268
268
  {
269
269
  "kind": "javascript-module",
270
- "path": "components/checkbox/src/auro-checkbox-group.js",
270
+ "path": "components/combobox/src/auro-combobox.js",
271
271
  "declarations": [
272
272
  {
273
273
  "kind": "class",
274
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
275
- "name": "AuroCheckboxGroup",
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",
276
276
  "slots": [
277
277
  {
278
- "description": "Allows for the legend to be overridden.",
279
- "name": "legend"
278
+ "description": "Default slot for the menu content.",
279
+ "name": ""
280
280
  },
281
281
  {
282
+ "type": {
283
+ "text": "HTMLSlotElement"
284
+ },
282
285
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
283
286
  "name": "optionalLabel"
284
287
  },
285
288
  {
286
- "description": "Allows for the helper text to be overridden.",
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.",
287
306
  "name": "helpText"
288
307
  },
289
308
  {
290
- "description": "The default slot for the checkbox items.",
291
- "name": "default"
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"
292
311
  }
293
312
  ],
294
313
  "members": [
295
314
  {
296
315
  "kind": "method",
297
- "name": "_initializeDefaults"
316
+ "name": "_initializeDefaults",
317
+ "privacy": "private",
318
+ "return": {
319
+ "type": {
320
+ "text": "void"
321
+ }
322
+ }
323
+ },
324
+ {
325
+ "kind": "method",
326
+ "name": "_scheduleTimer",
327
+ "parameters": [
328
+ {
329
+ "name": "fn",
330
+ "description": "Callback to run.",
331
+ "type": {
332
+ "text": "Function"
333
+ }
334
+ },
335
+ {
336
+ "name": "ms",
337
+ "description": "Delay in milliseconds.",
338
+ "type": {
339
+ "text": "number"
340
+ }
341
+ }
342
+ ],
343
+ "description": "Wraps setTimeout and records the timer id so disconnectedCallback\ncan cancel any outstanding callbacks. The id is removed from the set\nonce the callback fires so the set doesn't grow unbounded.",
344
+ "return": {
345
+ "type": {
346
+ "text": "number"
347
+ }
348
+ },
349
+ "privacy": "private"
350
+ },
351
+ {
352
+ "kind": "field",
353
+ "name": "inputValue",
354
+ "description": "Returns the current value of the input element within the combobox.",
355
+ "return": {
356
+ "type": {
357
+ "text": "string|undefined"
358
+ }
359
+ },
360
+ "readonly": true
361
+ },
362
+ {
363
+ "kind": "method",
364
+ "name": "isValid",
365
+ "description": "Checks if the element is valid.",
366
+ "return": {
367
+ "type": {
368
+ "text": "boolean"
369
+ }
370
+ }
298
371
  },
299
372
  {
300
373
  "kind": "method",
@@ -303,7 +376,7 @@
303
376
  "parameters": [
304
377
  {
305
378
  "name": "name",
306
- "default": "\"auro-checkbox-group\"",
379
+ "default": "'auro-combobox'",
307
380
  "description": "The name of the element that you want to register.",
308
381
  "optional": true,
309
382
  "type": {
@@ -315,24 +388,82 @@
315
388
  },
316
389
  {
317
390
  "kind": "method",
318
- "name": "handleValueUpdate",
391
+ "name": "activateFirstEnabledAvailableOption",
392
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
393
+ "privacy": "private",
394
+ "return": {
395
+ "type": {
396
+ "text": "void"
397
+ }
398
+ }
399
+ },
400
+ {
401
+ "kind": "method",
402
+ "name": "activateLastEnabledAvailableOption",
403
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
404
+ "privacy": "private",
405
+ "return": {
406
+ "type": {
407
+ "text": "void"
408
+ }
409
+ }
410
+ },
411
+ {
412
+ "kind": "method",
413
+ "name": "updateFilter",
414
+ "description": "Updates the filter for the available options based on the input value.",
415
+ "privacy": "private"
416
+ },
417
+ {
418
+ "kind": "method",
419
+ "name": "syncValuesAndStates",
420
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
421
+ "privacy": "private",
422
+ "return": {
423
+ "type": {
424
+ "text": "void"
425
+ }
426
+ }
427
+ },
428
+ {
429
+ "kind": "method",
430
+ "name": "updateTriggerTextDisplay",
319
431
  "parameters": [
320
432
  {
321
- "name": "value",
322
- "description": "The value of the checkbox.",
433
+ "name": "label",
434
+ "description": "The label of the selected option.",
323
435
  "type": {
324
- "text": "String"
436
+ "text": "string"
325
437
  }
326
- },
438
+ }
439
+ ],
440
+ "description": "Update displayValue or input.value, it's called when making a selection.",
441
+ "privacy": "private"
442
+ },
443
+ {
444
+ "kind": "method",
445
+ "name": "syncInputValuesAcrossTriggerAndBib",
446
+ "parameters": [
327
447
  {
328
- "name": "selected",
329
- "description": "The checked state of the checkbox.",
448
+ "name": "nextValue",
449
+ "description": "The value to write to both inputs.",
330
450
  "type": {
331
- "text": "Boolean"
451
+ "text": "string"
332
452
  }
333
453
  }
334
454
  ],
335
- "description": "Helper method to handle checkbox value changing.",
455
+ "description": "Writes nextValue to the trigger input and the bib input when their current\nvalue differs, then re-asserts imask after Lit's update flushes.",
456
+ "return": {
457
+ "type": {
458
+ "text": "Promise<void>"
459
+ }
460
+ },
461
+ "privacy": "private"
462
+ },
463
+ {
464
+ "kind": "method",
465
+ "name": "handleMenuOptions",
466
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
336
467
  "privacy": "private",
337
468
  "return": {
338
469
  "type": {
@@ -342,8 +473,8 @@
342
473
  },
343
474
  {
344
475
  "kind": "method",
345
- "name": "handlePreselectedItems",
346
- "description": "Helper method that handles the state of preselected checkboxes.",
476
+ "name": "generateOptionsArray",
477
+ "description": "Determines the element error state based on the `required` attribute and input value.",
347
478
  "privacy": "private",
348
479
  "return": {
349
480
  "type": {
@@ -353,9 +484,8 @@
353
484
  },
354
485
  {
355
486
  "kind": "method",
356
- "name": "handleItems",
357
- "description": "Helper method that handles the state of checkboxes.",
358
- "privacy": "private",
487
+ "name": "hideBib",
488
+ "description": "Hides the dropdown bib if its open.",
359
489
  "return": {
360
490
  "type": {
361
491
  "text": "void"
@@ -364,8 +494,8 @@
364
494
  },
365
495
  {
366
496
  "kind": "method",
367
- "name": "reset",
368
- "description": "Resets component to initial state.",
497
+ "name": "showBib",
498
+ "description": "Shows the dropdown bib if there are options to show.",
369
499
  "return": {
370
500
  "type": {
371
501
  "text": "void"
@@ -374,325 +504,252 @@
374
504
  },
375
505
  {
376
506
  "kind": "method",
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
- }
507
+ "name": "configureDropdown",
508
+ "description": "Binds all behavior needed to the dropdown after rendering.",
509
+ "privacy": "private",
510
+ "return": {
511
+ "type": {
512
+ "text": "void"
387
513
  }
388
- ],
389
- "description": "Validates value."
514
+ }
390
515
  },
391
516
  {
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
517
+ "kind": "method",
518
+ "name": "setClearBtnFocus",
519
+ "privacy": "private"
402
520
  },
403
521
  {
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
522
+ "kind": "method",
523
+ "name": "setTriggerInputFocus",
524
+ "privacy": "private"
413
525
  },
414
526
  {
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
527
+ "kind": "method",
528
+ "name": "setInputFocus",
529
+ "privacy": "private"
424
530
  },
425
531
  {
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
532
+ "kind": "method",
533
+ "name": "updateBibDialogRole",
534
+ "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.",
535
+ "privacy": "private"
435
536
  },
436
537
  {
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
446
- },
447
- {
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
538
+ "kind": "method",
539
+ "name": "updateMenuShapeSize",
540
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
541
+ "privacy": "private"
457
542
  },
458
543
  {
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
544
+ "kind": "method",
545
+ "name": "_getAnnouncementRoot",
546
+ "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.",
547
+ "privacy": "private",
548
+ "return": {
549
+ "type": {
550
+ "text": "ShadowRoot"
551
+ }
552
+ }
468
553
  },
469
554
  {
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"
555
+ "kind": "method",
556
+ "name": "configureMenu",
557
+ "description": "Binds all behavior needed to the menu after rendering.",
558
+ "privacy": "private",
559
+ "return": {
560
+ "type": {
561
+ "text": "void"
562
+ }
563
+ }
478
564
  },
479
565
  {
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"
566
+ "kind": "method",
567
+ "name": "configureInput",
568
+ "description": "Binds all behavior needed to the input after rendering.",
569
+ "privacy": "private",
570
+ "return": {
571
+ "type": {
572
+ "text": "void"
573
+ }
574
+ }
488
575
  },
489
576
  {
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"
577
+ "kind": "method",
578
+ "name": "handleMenuLoadingChange",
579
+ "parameters": [
580
+ {
581
+ "name": "event",
582
+ "description": "The event object containing details about the loading state change.",
583
+ "type": {
584
+ "text": "CustomEvent"
585
+ }
586
+ },
587
+ {
588
+ "description": "Indicates whether the menu is currently loading.",
589
+ "name": "event.detail.loading",
590
+ "type": {
591
+ "text": "boolean"
592
+ }
593
+ },
594
+ {
595
+ "description": "Indicates if there are loading placeholders present.",
596
+ "name": "event.detail.hasLoadingPlaceholder",
597
+ "type": {
598
+ "text": "boolean"
599
+ }
600
+ }
601
+ ],
602
+ "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.",
603
+ "privacy": "private",
604
+ "return": {
605
+ "type": {
606
+ "text": "void"
607
+ }
608
+ }
498
609
  },
499
610
  {
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"
611
+ "kind": "method",
612
+ "name": "handleInputValueChange",
613
+ "parameters": [
614
+ {
615
+ "name": "event",
616
+ "description": "The input event triggered by the input element.",
617
+ "type": {
618
+ "text": "Event"
619
+ }
620
+ }
621
+ ],
622
+ "description": "Handle changes to the input value and trigger changes that should result.",
623
+ "privacy": "private",
624
+ "return": {
625
+ "type": {
626
+ "text": "void"
627
+ }
516
628
  }
517
629
  },
518
630
  {
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"
631
+ "kind": "method",
632
+ "name": "handleTriggerInputValueChange",
633
+ "parameters": [
634
+ {
635
+ "name": "event",
636
+ "description": "The input event from the trigger input element.",
637
+ "type": {
638
+ "text": "Event"
639
+ }
640
+ }
641
+ ],
642
+ "description": "Handles input value changes originating from the trigger input.\nRefreshes menu options and filtering, delegates to handleInputValueChange\nfor value synchronization, and manages fullscreen bib focus.",
643
+ "privacy": "private",
644
+ "return": {
645
+ "type": {
646
+ "text": "void"
647
+ }
648
+ }
532
649
  },
533
650
  {
534
- "name": "disabled",
535
- "type": {
536
- "text": "boolean"
537
- },
538
- "description": "If set, disables the checkbox group.",
539
- "fieldName": "disabled"
651
+ "kind": "method",
652
+ "name": "configureCombobox",
653
+ "description": "Binds all behavior needed to the combobox after rendering.",
654
+ "privacy": "private",
655
+ "return": {
656
+ "type": {
657
+ "text": "void"
658
+ }
659
+ }
540
660
  },
541
661
  {
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"
662
+ "kind": "method",
663
+ "name": "focus",
664
+ "description": "Focuses the combobox trigger input.",
665
+ "return": {
666
+ "type": {
667
+ "text": "void"
668
+ }
669
+ }
548
670
  },
549
671
  {
550
- "name": "horizontal",
551
- "type": {
552
- "text": "boolean"
553
- },
554
- "description": "If set, checkboxes will be aligned horizontally.",
555
- "fieldName": "horizontal"
672
+ "kind": "method",
673
+ "name": "setMenuValue",
674
+ "parameters": [
675
+ {
676
+ "name": "value",
677
+ "description": "The value to set on the menu.",
678
+ "type": {
679
+ "text": "string"
680
+ }
681
+ }
682
+ ],
683
+ "description": "Sets the menu value if menu is available.",
684
+ "return": {
685
+ "type": {
686
+ "text": "void"
687
+ }
688
+ }
556
689
  },
557
690
  {
558
- "name": "noValidate",
559
- "type": {
560
- "text": "boolean"
561
- },
562
- "description": "If set, disables auto-validation on blur.",
563
- "fieldName": "noValidate"
691
+ "kind": "method",
692
+ "name": "reset",
693
+ "description": "Resets component to initial state.",
694
+ "return": {
695
+ "type": {
696
+ "text": "void"
697
+ }
698
+ }
564
699
  },
565
700
  {
566
- "name": "onDark",
567
- "type": {
568
- "text": "boolean"
569
- },
570
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
571
- "fieldName": "onDark"
701
+ "kind": "method",
702
+ "name": "clear",
703
+ "description": "Clears the current value of the combobox.",
704
+ "return": {
705
+ "type": {
706
+ "text": "void"
707
+ }
708
+ }
572
709
  },
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": [
662
710
  {
663
711
  "kind": "method",
664
- "name": "_initializeDefaults"
665
- },
666
- {
667
- "kind": "method",
668
- "name": "register",
669
- "static": true,
712
+ "name": "validate",
670
713
  "parameters": [
671
714
  {
672
- "name": "name",
673
- "default": "\"auro-checkbox\"",
674
- "description": "The name of element that you want to register to.",
715
+ "name": "force",
716
+ "default": "false",
717
+ "description": "Whether to force validation.",
675
718
  "optional": true,
676
719
  "type": {
677
- "text": "string"
720
+ "text": "boolean"
678
721
  }
679
722
  }
680
723
  ],
681
- "description": "This will register this element with the browser."
724
+ "description": "Validates value."
682
725
  },
683
726
  {
684
727
  "kind": "method",
685
- "name": "handleChange",
728
+ "name": "transportAssignedNodes",
686
729
  "parameters": [
687
730
  {
688
- "name": "event",
689
- "description": "The change event from the checkbox input.",
731
+ "name": "slot",
732
+ "description": "The slot element containing the nodes to apply.",
690
733
  "type": {
691
- "text": "Event"
734
+ "text": "HTMLSlotElement"
735
+ }
736
+ },
737
+ {
738
+ "name": "target",
739
+ "description": "The target element to apply the nodes to.",
740
+ "type": {
741
+ "text": "HTMLElement"
742
+ }
743
+ },
744
+ {
745
+ "name": "newSlotName",
746
+ "description": "The new slot name for the applied nodes.",
747
+ "type": {
748
+ "text": "string"
692
749
  }
693
750
  }
694
751
  ],
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.",
752
+ "description": "Applies slotted nodes to a target element with a new slot name.",
696
753
  "privacy": "private",
697
754
  "return": {
698
755
  "type": {
@@ -702,80 +759,31 @@
702
759
  },
703
760
  {
704
761
  "kind": "method",
705
- "name": "handleInput",
762
+ "name": "updateActiveOption",
706
763
  "parameters": [
707
764
  {
708
- "name": "event",
709
- "description": "The input event from the checkbox input.",
765
+ "name": "index",
766
+ "description": "Index of the option to make active.",
710
767
  "type": {
711
- "text": "Event"
768
+ "text": "number"
712
769
  }
713
770
  }
714
771
  ],
715
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
716
- "privacy": "private",
717
- "return": {
718
- "type": {
719
- "text": "void"
720
- }
721
- }
722
- },
723
- {
724
- "kind": "method",
725
- "name": "handleFocusin",
726
- "description": "Function to support",
727
- "privacy": "private",
728
- "return": {
729
- "type": {
730
- "text": "void"
731
- }
732
- }
733
- },
734
- {
735
- "kind": "method",
736
- "name": "generateIconHtml",
737
- "description": "Function to generate checkmark svg.",
738
- "privacy": "private",
739
- "return": {
740
- "type": {
741
- "text": "HTMLElement"
742
- }
743
- }
744
- },
745
- {
746
- "kind": "method",
747
- "name": "reset",
748
- "description": "Resets component to initial state.",
749
- "return": {
750
- "type": {
751
- "text": "void"
752
- }
753
- }
754
- },
755
- {
756
- "kind": "method",
757
- "name": "updateAriaLabel",
758
- "description": "Updates the aria-label based on slot content.",
759
- "privacy": "private",
760
- "return": {
761
- "type": {
762
- "text": "void"
763
- }
764
- }
772
+ "description": "Updates the active option in the menu."
765
773
  },
766
774
  {
767
775
  "kind": "method",
768
- "name": "handleKeyDown",
776
+ "name": "handleSlotChange",
769
777
  "parameters": [
770
778
  {
771
779
  "name": "event",
772
- "description": "The keydown event from the checkbox input.",
780
+ "description": "`slotchange` event.",
773
781
  "type": {
774
- "text": "KeyboardEvent"
782
+ "text": "Event"
775
783
  }
776
784
  }
777
785
  ],
778
- "description": "Handles keydown event to toggle the checkbox with Space key.",
786
+ "description": "Watch for slot changes and recalculate the menuoptions.",
779
787
  "privacy": "private",
780
788
  "return": {
781
789
  "type": {
@@ -788,7 +796,7 @@
788
796
  "name": "appearance",
789
797
  "privacy": "public",
790
798
  "type": {
791
- "text": "'default' | 'inverse'"
799
+ "text": "string"
792
800
  },
793
801
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
794
802
  "default": "'default'",
@@ -797,802 +805,982 @@
797
805
  },
798
806
  {
799
807
  "kind": "field",
800
- "name": "checked",
808
+ "name": "autocomplete",
801
809
  "privacy": "public",
802
810
  "type": {
803
- "text": "boolean"
811
+ "text": "string"
804
812
  },
805
- "description": "If set to true, the checkbox will be filled with a checkmark.",
806
- "attribute": "checked",
813
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
814
+ "attribute": "autocomplete",
807
815
  "reflects": true
808
816
  },
809
817
  {
810
818
  "kind": "field",
811
- "name": "disabled",
819
+ "name": "autoPlacement",
812
820
  "privacy": "public",
813
821
  "type": {
814
822
  "text": "boolean"
815
823
  },
816
- "description": "If set to true, the checkbox will not be clickable.",
817
- "attribute": "disabled",
824
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
825
+ "attribute": "autoPlacement",
818
826
  "reflects": true
819
827
  },
820
828
  {
821
829
  "kind": "field",
822
- "name": "error",
823
- "privacy": "public",
830
+ "name": "availableOptions",
831
+ "privacy": "private",
824
832
  "type": {
825
- "text": "boolean"
833
+ "text": "array"
826
834
  },
827
- "description": "If set to true, the checkbox will be displayed with an error state.",
828
- "attribute": "error",
829
- "reflects": true
835
+ "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).",
836
+ "attribute": "availableOptions"
830
837
  },
831
838
  {
832
839
  "kind": "field",
833
- "name": "id",
840
+ "name": "behavior",
834
841
  "privacy": "public",
835
842
  "type": {
836
- "text": "string"
843
+ "text": "'filter' | 'suggestion'"
837
844
  },
838
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
839
- "attribute": "id",
845
+ "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.",
846
+ "default": "'suggestion'",
847
+ "attribute": "behavior",
840
848
  "reflects": true
841
849
  },
842
850
  {
843
851
  "kind": "field",
844
- "name": "inputId",
845
- "privacy": "private",
846
- "type": {
847
- "text": "string"
848
- },
849
- "description": "The id for input node."
850
- },
851
- {
852
- "kind": "field",
853
- "name": "name",
852
+ "name": "checkmark",
854
853
  "privacy": "public",
855
854
  "type": {
856
- "text": "string"
855
+ "text": "boolean"
857
856
  },
858
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
859
- "attribute": "name"
857
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
858
+ "attribute": "checkmark",
859
+ "reflects": true
860
860
  },
861
861
  {
862
862
  "kind": "field",
863
- "name": "onDark",
863
+ "name": "disabled",
864
864
  "privacy": "public",
865
865
  "type": {
866
866
  "text": "boolean"
867
867
  },
868
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
869
- "attribute": "onDark",
868
+ "description": "If set, disables the combobox.",
869
+ "attribute": "disabled",
870
870
  "reflects": true
871
871
  },
872
872
  {
873
873
  "kind": "field",
874
- "name": "touched",
874
+ "name": "dropdownId",
875
875
  "privacy": "private",
876
876
  "type": {
877
- "text": "boolean"
877
+ "text": "string"
878
878
  },
879
- "description": "Indicates whether the checkbox has been interacted with."
879
+ "description": "ID for the dropdown."
880
880
  },
881
881
  {
882
882
  "kind": "field",
883
- "name": "value",
884
- "privacy": "public",
883
+ "name": "dropdownOpen",
884
+ "privacy": "private",
885
885
  "type": {
886
- "text": "string"
886
+ "text": "boolean"
887
887
  },
888
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
889
- "attribute": "value"
888
+ "description": "Whether or not the dropdown is open."
890
889
  },
891
890
  {
892
891
  "kind": "field",
893
- "name": "tabIndex",
894
- "privacy": "private",
892
+ "name": "dvInputOnly",
893
+ "privacy": "public",
895
894
  "type": {
896
- "text": "number"
895
+ "text": "boolean"
897
896
  },
898
- "description": "The tabindex attribute for the checkbox.",
899
- "attribute": "tabindex",
897
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
898
+ "attribute": "dvInputOnly",
900
899
  "reflects": true
901
900
  },
902
901
  {
903
902
  "kind": "field",
904
- "name": "ariaChecked",
905
- "privacy": "private",
903
+ "name": "error",
904
+ "privacy": "public",
906
905
  "type": {
907
906
  "text": "string"
908
907
  },
909
- "description": "The aria-checked attribute for the checkbox.",
910
- "attribute": "aria-checked",
908
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
909
+ "attribute": "error",
911
910
  "reflects": true
912
911
  },
913
912
  {
914
913
  "kind": "field",
915
- "name": "ariaDisabled",
916
- "privacy": "private",
914
+ "name": "format",
915
+ "privacy": "public",
917
916
  "type": {
918
917
  "text": "string"
919
918
  },
920
- "description": "The aria-disabled attribute for the checkbox.",
921
- "attribute": "aria-disabled",
919
+ "description": "Specifies the input mask format.",
920
+ "attribute": "format",
922
921
  "reflects": true
923
922
  },
924
923
  {
925
924
  "kind": "field",
926
- "name": "role",
927
- "privacy": "private",
925
+ "name": "inputmode",
926
+ "privacy": "public",
928
927
  "type": {
929
928
  "text": "string"
930
929
  },
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",
930
+ "description": "Exposes inputmode attribute for input.",
931
+ "attribute": "inputmode",
933
932
  "reflects": true
934
- }
935
- ],
936
- "events": [
933
+ },
937
934
  {
938
- "name": "auroCheckbox-input",
935
+ "kind": "field",
936
+ "name": "layout",
937
+ "privacy": "public",
939
938
  "type": {
940
- "text": "CustomEvent"
939
+ "text": "string"
940
+ },
941
+ "description": "Sets the layout of the combobox.",
942
+ "default": "'classic'",
943
+ "attribute": "layout",
944
+ "reflects": true,
945
+ "inheritedFrom": {
946
+ "name": "AuroElement",
947
+ "module": "components/layoutElement/src/auroElement.js"
941
948
  }
942
949
  },
943
950
  {
944
- "name": "auroCheckbox-focusin",
951
+ "kind": "field",
952
+ "name": "matchWidth",
953
+ "privacy": "private",
945
954
  "type": {
946
- "text": "CustomEvent"
947
- }
955
+ "text": "boolean"
956
+ },
957
+ "description": "If declared, the popover and trigger will be set to the same width.",
958
+ "attribute": "matchWidth",
959
+ "reflects": true
948
960
  },
949
961
  {
950
- "name": "auroCheckbox-focusout",
962
+ "kind": "field",
963
+ "name": "noFilter",
964
+ "privacy": "public",
951
965
  "type": {
952
- "text": "CustomEvent"
953
- }
966
+ "text": "boolean"
967
+ },
968
+ "description": "If set, combobox will not filter menuoptions based on input.",
969
+ "attribute": "noFilter",
970
+ "reflects": true
954
971
  },
955
972
  {
956
- "description": "(Deprecated) Notifies when checked value is changed.",
957
- "name": "change"
973
+ "kind": "field",
974
+ "name": "noFlip",
975
+ "privacy": "public",
976
+ "type": {
977
+ "text": "boolean"
978
+ },
979
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
980
+ "attribute": "noFlip",
981
+ "reflects": true
958
982
  },
959
983
  {
960
- "description": "Notifies when when checked value is changed by user's interface.",
961
- "name": "input"
962
- }
963
- ],
964
- "attributes": [
965
- {
966
- "name": "appearance",
984
+ "kind": "field",
985
+ "name": "shift",
986
+ "privacy": "public",
967
987
  "type": {
968
- "text": "'default' | 'inverse'"
988
+ "text": "boolean"
969
989
  },
970
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
971
- "default": "'default'",
972
- "fieldName": "appearance"
990
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
991
+ "attribute": "shift",
992
+ "reflects": true
973
993
  },
974
994
  {
975
- "name": "checked",
995
+ "kind": "field",
996
+ "name": "noValidate",
997
+ "privacy": "public",
976
998
  "type": {
977
999
  "text": "boolean"
978
1000
  },
979
- "description": "If set to true, the checkbox will be filled with a checkmark.",
980
- "fieldName": "checked"
1001
+ "description": "If set, disables auto-validation on blur.",
1002
+ "attribute": "noValidate",
1003
+ "reflects": true
981
1004
  },
982
1005
  {
983
- "name": "disabled",
1006
+ "kind": "field",
1007
+ "name": "offset",
1008
+ "privacy": "public",
1009
+ "type": {
1010
+ "text": "number"
1011
+ },
1012
+ "description": "Gap between the trigger element and bib.",
1013
+ "default": "0",
1014
+ "attribute": "offset",
1015
+ "reflects": true
1016
+ },
1017
+ {
1018
+ "kind": "field",
1019
+ "name": "onDark",
1020
+ "privacy": "public",
984
1021
  "type": {
985
1022
  "text": "boolean"
986
1023
  },
987
- "description": "If set to true, the checkbox will not be clickable.",
988
- "fieldName": "disabled"
1024
+ "attribute": "onDark",
1025
+ "reflects": true,
1026
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1027
+ "inheritedFrom": {
1028
+ "name": "AuroElement",
1029
+ "module": "components/layoutElement/src/auroElement.js"
1030
+ }
989
1031
  },
990
1032
  {
991
- "name": "error",
1033
+ "kind": "field",
1034
+ "name": "optionSelected",
1035
+ "privacy": "public",
1036
+ "type": {
1037
+ "text": "HTMLElement"
1038
+ },
1039
+ "description": "Specifies the current selected option.",
1040
+ "attribute": "optionSelected"
1041
+ },
1042
+ {
1043
+ "kind": "field",
1044
+ "name": "persistInput",
1045
+ "privacy": "public",
992
1046
  "type": {
993
1047
  "text": "boolean"
994
1048
  },
995
- "description": "If set to true, the checkbox will be displayed with an error state.",
996
- "fieldName": "error"
1049
+ "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.",
1050
+ "attribute": "persistInput",
1051
+ "reflects": true
997
1052
  },
998
1053
  {
999
- "name": "id",
1054
+ "kind": "field",
1055
+ "name": "placement",
1056
+ "privacy": "public",
1000
1057
  "type": {
1001
- "text": "string"
1058
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1002
1059
  },
1003
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
1004
- "fieldName": "id"
1060
+ "description": "Position where the bib should appear relative to the trigger.",
1061
+ "default": "'bottom-start'",
1062
+ "attribute": "placement",
1063
+ "reflects": true
1005
1064
  },
1006
1065
  {
1007
- "name": "name",
1066
+ "kind": "field",
1067
+ "name": "placeholder",
1068
+ "privacy": "public",
1008
1069
  "type": {
1009
1070
  "text": "string"
1010
1071
  },
1011
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
1012
- "fieldName": "name"
1072
+ "description": "Define custom placeholder text, only supported by date input formats.",
1073
+ "attribute": "placeholder",
1074
+ "reflects": true
1013
1075
  },
1014
1076
  {
1015
- "name": "onDark",
1077
+ "kind": "field",
1078
+ "name": "required",
1079
+ "privacy": "public",
1016
1080
  "type": {
1017
1081
  "text": "boolean"
1018
1082
  },
1019
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1020
- "fieldName": "onDark"
1083
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1084
+ "attribute": "required",
1085
+ "reflects": true
1021
1086
  },
1022
1087
  {
1023
- "name": "value",
1088
+ "kind": "field",
1089
+ "name": "setCustomValidity",
1090
+ "privacy": "public",
1024
1091
  "type": {
1025
1092
  "text": "string"
1026
1093
  },
1027
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1028
- "fieldName": "value"
1094
+ "description": "Sets a custom help text message to display for all validityStates.",
1095
+ "attribute": "setCustomValidity"
1029
1096
  },
1030
1097
  {
1031
- "name": "tabindex",
1098
+ "kind": "field",
1099
+ "name": "setCustomValidityCustomError",
1100
+ "privacy": "public",
1032
1101
  "type": {
1033
- "text": "number"
1102
+ "text": "string"
1034
1103
  },
1035
- "description": "The tabindex attribute for the checkbox.",
1036
- "fieldName": "tabIndex"
1104
+ "description": "Custom help text message to display when validity = `customError`.",
1105
+ "attribute": "setCustomValidityCustomError"
1037
1106
  },
1038
1107
  {
1039
- "name": "aria-checked",
1108
+ "kind": "field",
1109
+ "name": "setCustomValidityValueMissing",
1110
+ "privacy": "public",
1040
1111
  "type": {
1041
1112
  "text": "string"
1042
1113
  },
1043
- "description": "The aria-checked attribute for the checkbox.",
1044
- "fieldName": "ariaChecked"
1114
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1115
+ "attribute": "setCustomValidityValueMissing"
1045
1116
  },
1046
1117
  {
1047
- "name": "aria-disabled",
1118
+ "kind": "field",
1119
+ "name": "setCustomValidityValueMissingFilter",
1120
+ "privacy": "public",
1048
1121
  "type": {
1049
1122
  "text": "string"
1050
1123
  },
1051
- "description": "The aria-disabled attribute for the checkbox.",
1052
- "fieldName": "ariaDisabled"
1124
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1125
+ "attribute": "setCustomValidityValueMissingFilter"
1053
1126
  },
1054
1127
  {
1055
- "name": "role",
1128
+ "kind": "field",
1129
+ "name": "touched",
1130
+ "privacy": "private",
1056
1131
  "type": {
1057
- "text": "string"
1132
+ "text": "boolean"
1058
1133
  },
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": ""
1134
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1123
1135
  },
1124
1136
  {
1137
+ "kind": "field",
1138
+ "name": "triggerIcon",
1139
+ "privacy": "public",
1125
1140
  "type": {
1126
- "text": "HTMLSlotElement"
1141
+ "text": "boolean"
1127
1142
  },
1128
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1129
- "name": "optionalLabel"
1130
- },
1131
- {
1132
- "description": "Sets aria-label on clear button",
1133
- "name": "ariaLabel.input.clear"
1143
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1144
+ "attribute": "triggerIcon",
1145
+ "reflects": true
1134
1146
  },
1135
1147
  {
1136
- "description": "Sets aria-label on close button in fullscreen bib",
1137
- "name": "ariaLabel.bib.close"
1148
+ "kind": "field",
1149
+ "name": "type",
1150
+ "privacy": "public",
1151
+ "type": {
1152
+ "text": "string"
1153
+ },
1154
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1155
+ "attribute": "type",
1156
+ "reflects": true
1138
1157
  },
1139
1158
  {
1140
- "description": "Defines the headline to display above menu-options",
1141
- "name": "bib.fullscreen.headline"
1159
+ "kind": "field",
1160
+ "name": "typedValue",
1161
+ "privacy": "public",
1162
+ "type": {
1163
+ "text": "string"
1164
+ },
1165
+ "description": "Specifies the value of the input element within the combobox.",
1166
+ "attribute": "typedValue",
1167
+ "reflects": true
1142
1168
  },
1143
1169
  {
1144
- "description": "Defines the content of the label.",
1145
- "name": "label"
1170
+ "kind": "field",
1171
+ "name": "validity",
1172
+ "privacy": "public",
1173
+ "type": {
1174
+ "text": "string"
1175
+ },
1176
+ "description": "Specifies the `validityState` this element is in.",
1177
+ "attribute": "validity",
1178
+ "reflects": true
1146
1179
  },
1147
1180
  {
1148
- "description": "Defines the content of the helpText.",
1149
- "name": "helpText"
1181
+ "kind": "field",
1182
+ "name": "value",
1183
+ "privacy": "public",
1184
+ "type": {
1185
+ "text": "string"
1186
+ },
1187
+ "description": "Value selected for the dropdown menu.",
1188
+ "attribute": "value"
1150
1189
  },
1151
1190
  {
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": [
1157
- {
1158
- "kind": "method",
1159
- "name": "_initializeDefaults",
1160
- "privacy": "private",
1161
- "return": {
1162
- "type": {
1163
- "text": "void"
1164
- }
1165
- }
1191
+ "kind": "field",
1192
+ "name": "largeFullscreenHeadline",
1193
+ "privacy": "public",
1194
+ "type": {
1195
+ "text": "boolean"
1196
+ },
1197
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1198
+ "attribute": "largeFullscreenHeadline",
1199
+ "reflects": true
1166
1200
  },
1167
1201
  {
1168
- "kind": "method",
1169
- "name": "_scheduleTimer",
1170
- "parameters": [
1171
- {
1172
- "name": "fn",
1173
- "description": "Callback to run.",
1174
- "type": {
1175
- "text": "Function"
1176
- }
1177
- },
1178
- {
1179
- "name": "ms",
1180
- "description": "Delay in milliseconds.",
1181
- "type": {
1182
- "text": "number"
1183
- }
1184
- }
1185
- ],
1186
- "description": "Wraps setTimeout and records the timer id so disconnectedCallback\ncan cancel any outstanding callbacks. The id is removed from the set\nonce the callback fires so the set doesn't grow unbounded.",
1187
- "return": {
1188
- "type": {
1189
- "text": "number"
1190
- }
1202
+ "kind": "field",
1203
+ "name": "fullscreenBreakpoint",
1204
+ "privacy": "public",
1205
+ "type": {
1206
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1191
1207
  },
1192
- "privacy": "private"
1208
+ "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.",
1209
+ "default": "'sm'",
1210
+ "attribute": "fullscreenBreakpoint",
1211
+ "reflects": true
1193
1212
  },
1194
1213
  {
1195
1214
  "kind": "field",
1196
- "name": "inputValue",
1197
- "description": "Returns the current value of the input element within the combobox.",
1198
- "return": {
1199
- "type": {
1200
- "text": "string|undefined"
1201
- }
1215
+ "name": "optionActive",
1216
+ "privacy": "private",
1217
+ "type": {
1218
+ "text": "object"
1202
1219
  },
1203
- "readonly": true
1220
+ "description": "Specifies the currently active option."
1204
1221
  },
1205
1222
  {
1206
- "kind": "method",
1207
- "name": "isValid",
1208
- "description": "Checks if the element is valid.",
1223
+ "kind": "field",
1224
+ "name": "componentHasFocus",
1225
+ "description": "Returns true if the element has focus.",
1226
+ "privacy": "private",
1209
1227
  "return": {
1210
1228
  "type": {
1211
1229
  "text": "boolean"
1212
1230
  }
1231
+ },
1232
+ "readonly": true,
1233
+ "inheritedFrom": {
1234
+ "name": "AuroElement",
1235
+ "module": "components/layoutElement/src/auroElement.js"
1213
1236
  }
1214
1237
  },
1215
1238
  {
1216
1239
  "kind": "method",
1217
- "name": "register",
1218
- "static": true,
1219
- "parameters": [
1220
- {
1221
- "name": "name",
1222
- "default": "'auro-combobox'",
1223
- "description": "The name of the element that you want to register.",
1224
- "optional": true,
1225
- "type": {
1226
- "text": "string"
1227
- }
1228
- }
1229
- ],
1230
- "description": "This will register this element with the browser."
1231
- },
1232
- {
1233
- "kind": "method",
1234
- "name": "activateFirstEnabledAvailableOption",
1235
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
1236
- "privacy": "private",
1237
- "return": {
1238
- "type": {
1239
- "text": "void"
1240
- }
1240
+ "name": "resetShapeClasses",
1241
+ "inheritedFrom": {
1242
+ "name": "AuroElement",
1243
+ "module": "components/layoutElement/src/auroElement.js"
1241
1244
  }
1242
1245
  },
1243
1246
  {
1244
1247
  "kind": "method",
1245
- "name": "activateLastEnabledAvailableOption",
1246
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
1247
- "privacy": "private",
1248
- "return": {
1249
- "type": {
1250
- "text": "void"
1251
- }
1248
+ "name": "resetLayoutClasses",
1249
+ "inheritedFrom": {
1250
+ "name": "AuroElement",
1251
+ "module": "components/layoutElement/src/auroElement.js"
1252
1252
  }
1253
1253
  },
1254
1254
  {
1255
1255
  "kind": "method",
1256
- "name": "updateFilter",
1257
- "description": "Updates the filter for the available options based on the input value.",
1258
- "privacy": "private"
1256
+ "name": "updateComponentArchitecture",
1257
+ "inheritedFrom": {
1258
+ "name": "AuroElement",
1259
+ "module": "components/layoutElement/src/auroElement.js"
1260
+ }
1259
1261
  },
1260
1262
  {
1261
- "kind": "method",
1262
- "name": "syncValuesAndStates",
1263
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1264
- "privacy": "private",
1265
- "return": {
1266
- "type": {
1267
- "text": "void"
1268
- }
1263
+ "kind": "field",
1264
+ "name": "shape",
1265
+ "privacy": "public",
1266
+ "type": {
1267
+ "text": "string"
1268
+ },
1269
+ "attribute": "shape",
1270
+ "reflects": true,
1271
+ "inheritedFrom": {
1272
+ "name": "AuroElement",
1273
+ "module": "components/layoutElement/src/auroElement.js"
1269
1274
  }
1270
1275
  },
1271
1276
  {
1272
- "kind": "method",
1273
- "name": "updateTriggerTextDisplay",
1274
- "parameters": [
1275
- {
1276
- "name": "label",
1277
- "description": "The label of the selected option.",
1278
- "type": {
1279
- "text": "string"
1280
- }
1281
- }
1282
- ],
1283
- "description": "Update displayValue or input.value, it's called when making a selection.",
1284
- "privacy": "private"
1277
+ "kind": "field",
1278
+ "name": "size",
1279
+ "privacy": "public",
1280
+ "type": {
1281
+ "text": "string"
1282
+ },
1283
+ "attribute": "size",
1284
+ "reflects": true,
1285
+ "inheritedFrom": {
1286
+ "name": "AuroElement",
1287
+ "module": "components/layoutElement/src/auroElement.js"
1288
+ }
1289
+ }
1290
+ ],
1291
+ "events": [
1292
+ {
1293
+ "name": "inputValue",
1294
+ "type": {
1295
+ "text": "CustomEvent"
1296
+ },
1297
+ "description": "Notifies that the components internal HTML5 input value has changed."
1285
1298
  },
1286
1299
  {
1287
- "kind": "method",
1288
- "name": "syncInputValuesAcrossTriggerAndBib",
1289
- "parameters": [
1290
- {
1291
- "name": "nextValue",
1292
- "description": "The value to write to both inputs.",
1293
- "type": {
1294
- "text": "string"
1295
- }
1296
- }
1297
- ],
1298
- "description": "Writes nextValue to the trigger input and the bib input when their current\nvalue differs, then re-asserts imask after Lit's update flushes.",
1299
- "return": {
1300
- "type": {
1301
- "text": "Promise<void>"
1302
- }
1300
+ "name": "input",
1301
+ "type": {
1302
+ "text": "CustomEvent"
1303
1303
  },
1304
- "privacy": "private"
1304
+ "description": "Notifies that the component has a new value set."
1305
1305
  },
1306
1306
  {
1307
- "kind": "method",
1308
- "name": "handleMenuOptions",
1309
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1310
- "privacy": "private",
1311
- "return": {
1312
- "type": {
1313
- "text": "void"
1314
- }
1315
- }
1307
+ "name": "auroCombobox-valueSet",
1308
+ "type": {
1309
+ "text": "CustomEvent"
1310
+ },
1311
+ "description": "(Deprecated) Notifies that the component has a new value set."
1316
1312
  },
1317
1313
  {
1318
- "kind": "method",
1319
- "name": "generateOptionsArray",
1320
- "description": "Determines the element error state based on the `required` attribute and input value.",
1321
- "privacy": "private",
1322
- "return": {
1323
- "type": {
1324
- "text": "void"
1325
- }
1326
- }
1314
+ "description": "Notifies that the component value(s) have been validated.",
1315
+ "name": "auroFormElement-validated"
1316
+ }
1317
+ ],
1318
+ "attributes": [
1319
+ {
1320
+ "name": "appearance",
1321
+ "type": {
1322
+ "text": "string"
1323
+ },
1324
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1325
+ "default": "'default'",
1326
+ "fieldName": "appearance"
1327
1327
  },
1328
1328
  {
1329
- "kind": "method",
1330
- "name": "hideBib",
1331
- "description": "Hides the dropdown bib if its open.",
1332
- "return": {
1333
- "type": {
1334
- "text": "void"
1335
- }
1336
- }
1329
+ "name": "autocomplete",
1330
+ "type": {
1331
+ "text": "string"
1332
+ },
1333
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1334
+ "fieldName": "autocomplete"
1337
1335
  },
1338
1336
  {
1339
- "kind": "method",
1340
- "name": "showBib",
1341
- "description": "Shows the dropdown bib if there are options to show.",
1342
- "return": {
1343
- "type": {
1344
- "text": "void"
1345
- }
1346
- }
1337
+ "name": "autoPlacement",
1338
+ "type": {
1339
+ "text": "boolean"
1340
+ },
1341
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1342
+ "fieldName": "autoPlacement"
1347
1343
  },
1348
1344
  {
1349
- "kind": "method",
1350
- "name": "configureDropdown",
1351
- "description": "Binds all behavior needed to the dropdown after rendering.",
1352
- "privacy": "private",
1353
- "return": {
1354
- "type": {
1355
- "text": "void"
1356
- }
1357
- }
1345
+ "name": "availableOptions",
1346
+ "type": {
1347
+ "text": "array"
1348
+ },
1349
+ "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).",
1350
+ "fieldName": "availableOptions"
1358
1351
  },
1359
1352
  {
1360
- "kind": "method",
1361
- "name": "setClearBtnFocus",
1362
- "privacy": "private"
1353
+ "name": "behavior",
1354
+ "type": {
1355
+ "text": "'filter' | 'suggestion'"
1356
+ },
1357
+ "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.",
1358
+ "default": "'suggestion'",
1359
+ "fieldName": "behavior"
1363
1360
  },
1364
1361
  {
1365
- "kind": "method",
1366
- "name": "setTriggerInputFocus",
1367
- "privacy": "private"
1362
+ "name": "checkmark",
1363
+ "type": {
1364
+ "text": "boolean"
1365
+ },
1366
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1367
+ "fieldName": "checkmark"
1368
1368
  },
1369
1369
  {
1370
- "kind": "method",
1371
- "name": "setInputFocus",
1372
- "privacy": "private"
1370
+ "name": "disabled",
1371
+ "type": {
1372
+ "text": "boolean"
1373
+ },
1374
+ "description": "If set, disables the combobox.",
1375
+ "fieldName": "disabled"
1373
1376
  },
1374
1377
  {
1375
- "kind": "method",
1376
- "name": "updateBibDialogRole",
1377
- "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.",
1378
- "privacy": "private"
1378
+ "name": "dvInputOnly",
1379
+ "type": {
1380
+ "text": "boolean"
1381
+ },
1382
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1383
+ "fieldName": "dvInputOnly"
1379
1384
  },
1380
1385
  {
1381
- "kind": "method",
1382
- "name": "updateMenuShapeSize",
1383
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1384
- "privacy": "private"
1386
+ "name": "error",
1387
+ "type": {
1388
+ "text": "string"
1389
+ },
1390
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1391
+ "fieldName": "error"
1385
1392
  },
1386
1393
  {
1387
- "kind": "method",
1388
- "name": "_getAnnouncementRoot",
1389
- "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.",
1390
- "privacy": "private",
1391
- "return": {
1392
- "type": {
1393
- "text": "ShadowRoot"
1394
- }
1395
- }
1394
+ "name": "format",
1395
+ "type": {
1396
+ "text": "string"
1397
+ },
1398
+ "description": "Specifies the input mask format.",
1399
+ "fieldName": "format"
1396
1400
  },
1397
1401
  {
1398
- "kind": "method",
1399
- "name": "configureMenu",
1400
- "description": "Binds all behavior needed to the menu after rendering.",
1401
- "privacy": "private",
1402
- "return": {
1403
- "type": {
1404
- "text": "void"
1405
- }
1406
- }
1402
+ "name": "inputmode",
1403
+ "type": {
1404
+ "text": "string"
1405
+ },
1406
+ "description": "Exposes inputmode attribute for input.",
1407
+ "fieldName": "inputmode"
1407
1408
  },
1408
1409
  {
1409
- "kind": "method",
1410
- "name": "configureInput",
1411
- "description": "Binds all behavior needed to the input after rendering.",
1412
- "privacy": "private",
1413
- "return": {
1414
- "type": {
1415
- "text": "void"
1416
- }
1410
+ "name": "layout",
1411
+ "type": {
1412
+ "text": "string"
1413
+ },
1414
+ "description": "Sets the layout of the combobox.",
1415
+ "default": "'classic'",
1416
+ "fieldName": "layout",
1417
+ "inheritedFrom": {
1418
+ "name": "AuroElement",
1419
+ "module": "components/layoutElement/src/auroElement.js"
1417
1420
  }
1418
1421
  },
1419
1422
  {
1420
- "kind": "method",
1421
- "name": "handleMenuLoadingChange",
1422
- "parameters": [
1423
- {
1424
- "name": "event",
1425
- "description": "The event object containing details about the loading state change.",
1426
- "type": {
1427
- "text": "CustomEvent"
1428
- }
1429
- },
1430
- {
1431
- "description": "Indicates whether the menu is currently loading.",
1432
- "name": "event.detail.loading",
1433
- "type": {
1434
- "text": "boolean"
1435
- }
1436
- },
1437
- {
1438
- "description": "Indicates if there are loading placeholders present.",
1439
- "name": "event.detail.hasLoadingPlaceholder",
1440
- "type": {
1441
- "text": "boolean"
1442
- }
1443
- }
1444
- ],
1445
- "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.",
1446
- "privacy": "private",
1447
- "return": {
1448
- "type": {
1449
- "text": "void"
1450
- }
1451
- }
1423
+ "name": "matchWidth",
1424
+ "type": {
1425
+ "text": "boolean"
1426
+ },
1427
+ "description": "If declared, the popover and trigger will be set to the same width.",
1428
+ "fieldName": "matchWidth"
1452
1429
  },
1453
1430
  {
1454
- "kind": "method",
1455
- "name": "handleInputValueChange",
1456
- "parameters": [
1457
- {
1458
- "name": "event",
1459
- "description": "The input event triggered by the input element.",
1460
- "type": {
1461
- "text": "Event"
1462
- }
1463
- }
1464
- ],
1465
- "description": "Handle changes to the input value and trigger changes that should result.",
1466
- "privacy": "private",
1467
- "return": {
1468
- "type": {
1469
- "text": "void"
1470
- }
1471
- }
1431
+ "name": "noFilter",
1432
+ "type": {
1433
+ "text": "boolean"
1434
+ },
1435
+ "description": "If set, combobox will not filter menuoptions based on input.",
1436
+ "fieldName": "noFilter"
1472
1437
  },
1473
1438
  {
1474
- "kind": "method",
1475
- "name": "handleTriggerInputValueChange",
1476
- "parameters": [
1477
- {
1478
- "name": "event",
1479
- "description": "The input event from the trigger input element.",
1480
- "type": {
1481
- "text": "Event"
1482
- }
1483
- }
1484
- ],
1485
- "description": "Handles input value changes originating from the trigger input.\nRefreshes menu options and filtering, delegates to handleInputValueChange\nfor value synchronization, and manages fullscreen bib focus.",
1486
- "privacy": "private",
1487
- "return": {
1488
- "type": {
1489
- "text": "void"
1490
- }
1439
+ "name": "noFlip",
1440
+ "type": {
1441
+ "text": "boolean"
1442
+ },
1443
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1444
+ "fieldName": "noFlip"
1445
+ },
1446
+ {
1447
+ "name": "shift",
1448
+ "type": {
1449
+ "text": "boolean"
1450
+ },
1451
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1452
+ "fieldName": "shift"
1453
+ },
1454
+ {
1455
+ "name": "noValidate",
1456
+ "type": {
1457
+ "text": "boolean"
1458
+ },
1459
+ "description": "If set, disables auto-validation on blur.",
1460
+ "fieldName": "noValidate"
1461
+ },
1462
+ {
1463
+ "name": "offset",
1464
+ "type": {
1465
+ "text": "number"
1466
+ },
1467
+ "description": "Gap between the trigger element and bib.",
1468
+ "default": "0",
1469
+ "fieldName": "offset"
1470
+ },
1471
+ {
1472
+ "name": "onDark",
1473
+ "type": {
1474
+ "text": "boolean"
1475
+ },
1476
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1477
+ "fieldName": "onDark"
1478
+ },
1479
+ {
1480
+ "name": "optionSelected",
1481
+ "type": {
1482
+ "text": "HTMLElement"
1483
+ },
1484
+ "description": "Specifies the current selected option.",
1485
+ "fieldName": "optionSelected"
1486
+ },
1487
+ {
1488
+ "name": "persistInput",
1489
+ "type": {
1490
+ "text": "boolean"
1491
+ },
1492
+ "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.",
1493
+ "fieldName": "persistInput"
1494
+ },
1495
+ {
1496
+ "name": "placement",
1497
+ "type": {
1498
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1499
+ },
1500
+ "description": "Position where the bib should appear relative to the trigger.",
1501
+ "default": "'bottom-start'",
1502
+ "fieldName": "placement"
1503
+ },
1504
+ {
1505
+ "name": "placeholder",
1506
+ "type": {
1507
+ "text": "string"
1508
+ },
1509
+ "description": "Define custom placeholder text, only supported by date input formats.",
1510
+ "fieldName": "placeholder"
1511
+ },
1512
+ {
1513
+ "name": "required",
1514
+ "type": {
1515
+ "text": "boolean"
1516
+ },
1517
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1518
+ "fieldName": "required"
1519
+ },
1520
+ {
1521
+ "name": "setCustomValidity",
1522
+ "type": {
1523
+ "text": "string"
1524
+ },
1525
+ "description": "Sets a custom help text message to display for all validityStates.",
1526
+ "fieldName": "setCustomValidity"
1527
+ },
1528
+ {
1529
+ "name": "setCustomValidityCustomError",
1530
+ "type": {
1531
+ "text": "string"
1532
+ },
1533
+ "description": "Custom help text message to display when validity = `customError`.",
1534
+ "fieldName": "setCustomValidityCustomError"
1535
+ },
1536
+ {
1537
+ "name": "setCustomValidityValueMissing",
1538
+ "type": {
1539
+ "text": "string"
1540
+ },
1541
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1542
+ "fieldName": "setCustomValidityValueMissing"
1543
+ },
1544
+ {
1545
+ "name": "setCustomValidityValueMissingFilter",
1546
+ "type": {
1547
+ "text": "string"
1548
+ },
1549
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1550
+ "fieldName": "setCustomValidityValueMissingFilter"
1551
+ },
1552
+ {
1553
+ "name": "triggerIcon",
1554
+ "type": {
1555
+ "text": "boolean"
1556
+ },
1557
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1558
+ "fieldName": "triggerIcon"
1559
+ },
1560
+ {
1561
+ "name": "type",
1562
+ "type": {
1563
+ "text": "string"
1564
+ },
1565
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1566
+ "fieldName": "type"
1567
+ },
1568
+ {
1569
+ "name": "typedValue",
1570
+ "type": {
1571
+ "text": "string"
1572
+ },
1573
+ "description": "Specifies the value of the input element within the combobox.",
1574
+ "fieldName": "typedValue"
1575
+ },
1576
+ {
1577
+ "name": "validity",
1578
+ "type": {
1579
+ "text": "string"
1580
+ },
1581
+ "description": "Specifies the `validityState` this element is in.",
1582
+ "fieldName": "validity"
1583
+ },
1584
+ {
1585
+ "name": "value",
1586
+ "type": {
1587
+ "text": "string"
1588
+ },
1589
+ "description": "Value selected for the dropdown menu.",
1590
+ "fieldName": "value"
1591
+ },
1592
+ {
1593
+ "name": "largeFullscreenHeadline",
1594
+ "type": {
1595
+ "text": "boolean"
1596
+ },
1597
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1598
+ "fieldName": "largeFullscreenHeadline"
1599
+ },
1600
+ {
1601
+ "name": "fullscreenBreakpoint",
1602
+ "type": {
1603
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1604
+ },
1605
+ "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.",
1606
+ "default": "'sm'",
1607
+ "fieldName": "fullscreenBreakpoint"
1608
+ },
1609
+ {
1610
+ "name": "shape",
1611
+ "type": {
1612
+ "text": "string"
1613
+ },
1614
+ "fieldName": "shape",
1615
+ "inheritedFrom": {
1616
+ "name": "AuroElement",
1617
+ "module": "components/layoutElement/src/auroElement.js"
1491
1618
  }
1492
1619
  },
1493
1620
  {
1494
- "kind": "method",
1495
- "name": "configureCombobox",
1496
- "description": "Binds all behavior needed to the combobox after rendering.",
1497
- "privacy": "private",
1498
- "return": {
1499
- "type": {
1500
- "text": "void"
1501
- }
1621
+ "name": "size",
1622
+ "type": {
1623
+ "text": "string"
1624
+ },
1625
+ "fieldName": "size",
1626
+ "inheritedFrom": {
1627
+ "name": "AuroElement",
1628
+ "module": "components/layoutElement/src/auroElement.js"
1502
1629
  }
1503
1630
  },
1504
1631
  {
1505
- "kind": "method",
1506
- "name": "focus",
1507
- "description": "Focuses the combobox trigger input.",
1508
- "return": {
1509
- "type": {
1510
- "text": "void"
1511
- }
1632
+ "name": "ondark",
1633
+ "type": {
1634
+ "text": "boolean"
1635
+ },
1636
+ "fieldName": "onDark",
1637
+ "inheritedFrom": {
1638
+ "name": "AuroElement",
1639
+ "module": "components/layoutElement/src/auroElement.js"
1512
1640
  }
1641
+ }
1642
+ ],
1643
+ "superclass": {
1644
+ "name": "AuroElement",
1645
+ "module": "/components/layoutElement/src/auroElement.js"
1646
+ },
1647
+ "tagName": "auro-combobox",
1648
+ "customElement": true
1649
+ }
1650
+ ],
1651
+ "exports": [
1652
+ {
1653
+ "kind": "js",
1654
+ "name": "AuroCombobox",
1655
+ "declaration": {
1656
+ "name": "AuroCombobox",
1657
+ "module": "components/combobox/src/auro-combobox.js"
1658
+ }
1659
+ }
1660
+ ]
1661
+ },
1662
+ {
1663
+ "kind": "javascript-module",
1664
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1665
+ "declarations": [
1666
+ {
1667
+ "kind": "variable",
1668
+ "name": "comboboxKeyboardStrategy",
1669
+ "type": {
1670
+ "text": "object"
1671
+ },
1672
+ "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'down'); } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'up'); } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { // Forms should not submit on Enter from a combobox, regardless of which // child element (input, clear button, menu) is focused. evt.stopPropagation(); if (isClearBtnFocused(ctx)) { // Let the browser dispatch Enter to the focused clear button so its // built-in activation fires and clears the selection. Do NOT call // preventDefault — that would block the activation. return; } if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); } else { evt.preventDefault(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // 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(); } } } }"
1673
+ }
1674
+ ],
1675
+ "exports": [
1676
+ {
1677
+ "kind": "js",
1678
+ "name": "comboboxKeyboardStrategy",
1679
+ "declaration": {
1680
+ "name": "comboboxKeyboardStrategy",
1681
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1682
+ }
1683
+ }
1684
+ ]
1685
+ },
1686
+ {
1687
+ "kind": "javascript-module",
1688
+ "path": "components/combobox/src/index.js",
1689
+ "declarations": [],
1690
+ "exports": [
1691
+ {
1692
+ "kind": "js",
1693
+ "name": "AuroCombobox",
1694
+ "declaration": {
1695
+ "name": "AuroCombobox",
1696
+ "module": "components/combobox/src/index.js"
1697
+ }
1698
+ }
1699
+ ]
1700
+ },
1701
+ {
1702
+ "kind": "javascript-module",
1703
+ "path": "components/combobox/src/registered.js",
1704
+ "declarations": [],
1705
+ "exports": [
1706
+ {
1707
+ "kind": "js",
1708
+ "name": "AuroCombobox",
1709
+ "declaration": {
1710
+ "name": "AuroCombobox",
1711
+ "module": "components/combobox/src/registered.js"
1712
+ }
1713
+ }
1714
+ ]
1715
+ },
1716
+ {
1717
+ "kind": "javascript-module",
1718
+ "path": "components/checkbox/src/auro-checkbox-group.js",
1719
+ "declarations": [
1720
+ {
1721
+ "kind": "class",
1722
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1723
+ "name": "AuroCheckboxGroup",
1724
+ "slots": [
1725
+ {
1726
+ "description": "Allows for the legend to be overridden.",
1727
+ "name": "legend"
1513
1728
  },
1514
1729
  {
1515
- "kind": "method",
1516
- "name": "setMenuValue",
1517
- "parameters": [
1518
- {
1519
- "name": "value",
1520
- "description": "The value to set on the menu.",
1521
- "type": {
1522
- "text": "string"
1523
- }
1524
- }
1525
- ],
1526
- "description": "Sets the menu value if menu is available.",
1527
- "return": {
1528
- "type": {
1529
- "text": "void"
1530
- }
1531
- }
1730
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1731
+ "name": "optionalLabel"
1532
1732
  },
1533
1733
  {
1534
- "kind": "method",
1535
- "name": "reset",
1536
- "description": "Resets component to initial state.",
1537
- "return": {
1538
- "type": {
1539
- "text": "void"
1540
- }
1541
- }
1734
+ "description": "Allows for the helper text to be overridden.",
1735
+ "name": "helpText"
1542
1736
  },
1737
+ {
1738
+ "description": "The default slot for the checkbox items.",
1739
+ "name": "default"
1740
+ }
1741
+ ],
1742
+ "members": [
1543
1743
  {
1544
1744
  "kind": "method",
1545
- "name": "clear",
1546
- "description": "Clears the current value of the combobox.",
1547
- "return": {
1548
- "type": {
1549
- "text": "void"
1550
- }
1551
- }
1745
+ "name": "_initializeDefaults"
1552
1746
  },
1553
1747
  {
1554
1748
  "kind": "method",
1555
- "name": "validate",
1749
+ "name": "register",
1750
+ "static": true,
1556
1751
  "parameters": [
1557
1752
  {
1558
- "name": "force",
1559
- "default": "false",
1560
- "description": "Whether to force validation.",
1753
+ "name": "name",
1754
+ "default": "\"auro-checkbox-group\"",
1755
+ "description": "The name of the element that you want to register.",
1561
1756
  "optional": true,
1562
1757
  "type": {
1563
- "text": "boolean"
1758
+ "text": "string"
1564
1759
  }
1565
1760
  }
1566
1761
  ],
1567
- "description": "Validates value."
1762
+ "description": "This will register this element with the browser."
1568
1763
  },
1569
1764
  {
1570
1765
  "kind": "method",
1571
- "name": "transportAssignedNodes",
1766
+ "name": "handleValueUpdate",
1572
1767
  "parameters": [
1573
1768
  {
1574
- "name": "slot",
1575
- "description": "The slot element containing the nodes to apply.",
1576
- "type": {
1577
- "text": "HTMLSlotElement"
1578
- }
1579
- },
1580
- {
1581
- "name": "target",
1582
- "description": "The target element to apply the nodes to.",
1769
+ "name": "value",
1770
+ "description": "The value of the checkbox.",
1583
1771
  "type": {
1584
- "text": "HTMLElement"
1772
+ "text": "String"
1585
1773
  }
1586
1774
  },
1587
1775
  {
1588
- "name": "newSlotName",
1589
- "description": "The new slot name for the applied nodes.",
1776
+ "name": "selected",
1777
+ "description": "The checked state of the checkbox.",
1590
1778
  "type": {
1591
- "text": "string"
1779
+ "text": "Boolean"
1592
1780
  }
1593
1781
  }
1594
1782
  ],
1595
- "description": "Applies slotted nodes to a target element with a new slot name.",
1783
+ "description": "Helper method to handle checkbox value changing.",
1596
1784
  "privacy": "private",
1597
1785
  "return": {
1598
1786
  "type": {
@@ -1602,31 +1790,19 @@
1602
1790
  },
1603
1791
  {
1604
1792
  "kind": "method",
1605
- "name": "updateActiveOption",
1606
- "parameters": [
1607
- {
1608
- "name": "index",
1609
- "description": "Index of the option to make active.",
1610
- "type": {
1611
- "text": "number"
1612
- }
1793
+ "name": "handlePreselectedItems",
1794
+ "description": "Helper method that handles the state of preselected checkboxes.",
1795
+ "privacy": "private",
1796
+ "return": {
1797
+ "type": {
1798
+ "text": "void"
1613
1799
  }
1614
- ],
1615
- "description": "Updates the active option in the menu."
1800
+ }
1616
1801
  },
1617
1802
  {
1618
1803
  "kind": "method",
1619
- "name": "handleSlotChange",
1620
- "parameters": [
1621
- {
1622
- "name": "event",
1623
- "description": "`slotchange` event.",
1624
- "type": {
1625
- "text": "Event"
1626
- }
1627
- }
1628
- ],
1629
- "description": "Watch for slot changes and recalculate the menuoptions.",
1804
+ "name": "handleItems",
1805
+ "description": "Helper method that handles the state of checkboxes.",
1630
1806
  "privacy": "private",
1631
1807
  "return": {
1632
1808
  "type": {
@@ -1635,203 +1811,74 @@
1635
1811
  }
1636
1812
  },
1637
1813
  {
1638
- "kind": "field",
1639
- "name": "appearance",
1640
- "privacy": "public",
1641
- "type": {
1642
- "text": "string"
1643
- },
1644
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1645
- "default": "'default'",
1646
- "attribute": "appearance",
1647
- "reflects": true
1648
- },
1649
- {
1650
- "kind": "field",
1651
- "name": "autocomplete",
1652
- "privacy": "public",
1653
- "type": {
1654
- "text": "string"
1655
- },
1656
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1657
- "attribute": "autocomplete",
1658
- "reflects": true
1659
- },
1660
- {
1661
- "kind": "field",
1662
- "name": "autoPlacement",
1663
- "privacy": "public",
1664
- "type": {
1665
- "text": "boolean"
1666
- },
1667
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1668
- "attribute": "autoPlacement",
1669
- "reflects": true
1670
- },
1671
- {
1672
- "kind": "field",
1673
- "name": "availableOptions",
1674
- "privacy": "private",
1675
- "type": {
1676
- "text": "array"
1677
- },
1678
- "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).",
1679
- "attribute": "availableOptions"
1680
- },
1681
- {
1682
- "kind": "field",
1683
- "name": "behavior",
1684
- "privacy": "public",
1685
- "type": {
1686
- "text": "'filter' | 'suggestion'"
1687
- },
1688
- "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.",
1689
- "default": "'suggestion'",
1690
- "attribute": "behavior",
1691
- "reflects": true
1692
- },
1693
- {
1694
- "kind": "field",
1695
- "name": "checkmark",
1696
- "privacy": "public",
1697
- "type": {
1698
- "text": "boolean"
1699
- },
1700
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1701
- "attribute": "checkmark",
1702
- "reflects": true
1703
- },
1704
- {
1705
- "kind": "field",
1706
- "name": "disabled",
1707
- "privacy": "public",
1708
- "type": {
1709
- "text": "boolean"
1710
- },
1711
- "description": "If set, disables the combobox.",
1712
- "attribute": "disabled",
1713
- "reflects": true
1714
- },
1715
- {
1716
- "kind": "field",
1717
- "name": "dropdownId",
1718
- "privacy": "private",
1719
- "type": {
1720
- "text": "string"
1721
- },
1722
- "description": "ID for the dropdown."
1723
- },
1724
- {
1725
- "kind": "field",
1726
- "name": "dropdownOpen",
1727
- "privacy": "private",
1728
- "type": {
1729
- "text": "boolean"
1730
- },
1731
- "description": "Whether or not the dropdown is open."
1732
- },
1733
- {
1734
- "kind": "field",
1735
- "name": "dvInputOnly",
1736
- "privacy": "public",
1737
- "type": {
1738
- "text": "boolean"
1739
- },
1740
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1741
- "attribute": "dvInputOnly",
1742
- "reflects": true
1743
- },
1744
- {
1745
- "kind": "field",
1746
- "name": "error",
1747
- "privacy": "public",
1748
- "type": {
1749
- "text": "string"
1750
- },
1751
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1752
- "attribute": "error",
1753
- "reflects": true
1754
- },
1755
- {
1756
- "kind": "field",
1757
- "name": "format",
1758
- "privacy": "public",
1759
- "type": {
1760
- "text": "string"
1761
- },
1762
- "description": "Specifies the input mask format.",
1763
- "attribute": "format",
1764
- "reflects": true
1765
- },
1766
- {
1767
- "kind": "field",
1768
- "name": "inputmode",
1769
- "privacy": "public",
1770
- "type": {
1771
- "text": "string"
1772
- },
1773
- "description": "Exposes inputmode attribute for input.",
1774
- "attribute": "inputmode",
1775
- "reflects": true
1814
+ "kind": "method",
1815
+ "name": "reset",
1816
+ "description": "Resets component to initial state.",
1817
+ "return": {
1818
+ "type": {
1819
+ "text": "void"
1820
+ }
1821
+ }
1776
1822
  },
1777
1823
  {
1778
- "kind": "field",
1779
- "name": "layout",
1780
- "privacy": "public",
1781
- "type": {
1782
- "text": "string"
1783
- },
1784
- "description": "Sets the layout of the combobox.",
1785
- "default": "'classic'",
1786
- "attribute": "layout",
1787
- "reflects": true,
1788
- "inheritedFrom": {
1789
- "name": "AuroElement",
1790
- "module": "components/layoutElement/src/auroElement.js"
1791
- }
1824
+ "kind": "method",
1825
+ "name": "validate",
1826
+ "parameters": [
1827
+ {
1828
+ "name": "force",
1829
+ "default": "false",
1830
+ "description": "Whether to force validation.",
1831
+ "optional": true,
1832
+ "type": {
1833
+ "text": "boolean"
1834
+ }
1835
+ }
1836
+ ],
1837
+ "description": "Validates value."
1792
1838
  },
1793
1839
  {
1794
1840
  "kind": "field",
1795
- "name": "matchWidth",
1796
- "privacy": "private",
1841
+ "name": "appearance",
1842
+ "privacy": "public",
1797
1843
  "type": {
1798
- "text": "boolean"
1844
+ "text": "'default' | 'inverse'"
1799
1845
  },
1800
- "description": "If declared, the popover and trigger will be set to the same width.",
1801
- "attribute": "matchWidth",
1846
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1847
+ "default": "'default'",
1848
+ "attribute": "appearance",
1802
1849
  "reflects": true
1803
1850
  },
1804
1851
  {
1805
1852
  "kind": "field",
1806
- "name": "noFilter",
1853
+ "name": "disabled",
1807
1854
  "privacy": "public",
1808
1855
  "type": {
1809
1856
  "text": "boolean"
1810
1857
  },
1811
- "description": "If set, combobox will not filter menuoptions based on input.",
1812
- "attribute": "noFilter",
1858
+ "description": "If set, disables the checkbox group.",
1859
+ "attribute": "disabled",
1813
1860
  "reflects": true
1814
1861
  },
1815
1862
  {
1816
1863
  "kind": "field",
1817
- "name": "noFlip",
1864
+ "name": "error",
1818
1865
  "privacy": "public",
1819
1866
  "type": {
1820
- "text": "boolean"
1867
+ "text": "string"
1821
1868
  },
1822
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1823
- "attribute": "noFlip",
1869
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1870
+ "attribute": "error",
1824
1871
  "reflects": true
1825
1872
  },
1826
1873
  {
1827
1874
  "kind": "field",
1828
- "name": "shift",
1875
+ "name": "horizontal",
1829
1876
  "privacy": "public",
1830
1877
  "type": {
1831
1878
  "text": "boolean"
1832
1879
  },
1833
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1834
- "attribute": "shift",
1880
+ "description": "If set, checkboxes will be aligned horizontally.",
1881
+ "attribute": "horizontal",
1835
1882
  "reflects": true
1836
1883
  },
1837
1884
  {
@@ -1845,18 +1892,6 @@
1845
1892
  "attribute": "noValidate",
1846
1893
  "reflects": true
1847
1894
  },
1848
- {
1849
- "kind": "field",
1850
- "name": "offset",
1851
- "privacy": "public",
1852
- "type": {
1853
- "text": "number"
1854
- },
1855
- "description": "Gap between the trigger element and bib.",
1856
- "default": "0",
1857
- "attribute": "offset",
1858
- "reflects": true
1859
- },
1860
1895
  {
1861
1896
  "kind": "field",
1862
1897
  "name": "onDark",
@@ -1864,56 +1899,8 @@
1864
1899
  "type": {
1865
1900
  "text": "boolean"
1866
1901
  },
1867
- "attribute": "onDark",
1868
- "reflects": true,
1869
1902
  "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1870
- "inheritedFrom": {
1871
- "name": "AuroElement",
1872
- "module": "components/layoutElement/src/auroElement.js"
1873
- }
1874
- },
1875
- {
1876
- "kind": "field",
1877
- "name": "optionSelected",
1878
- "privacy": "public",
1879
- "type": {
1880
- "text": "HTMLElement"
1881
- },
1882
- "description": "Specifies the current selected option.",
1883
- "attribute": "optionSelected"
1884
- },
1885
- {
1886
- "kind": "field",
1887
- "name": "persistInput",
1888
- "privacy": "public",
1889
- "type": {
1890
- "text": "boolean"
1891
- },
1892
- "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.",
1893
- "attribute": "persistInput",
1894
- "reflects": true
1895
- },
1896
- {
1897
- "kind": "field",
1898
- "name": "placement",
1899
- "privacy": "public",
1900
- "type": {
1901
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1902
- },
1903
- "description": "Position where the bib should appear relative to the trigger.",
1904
- "default": "'bottom-start'",
1905
- "attribute": "placement",
1906
- "reflects": true
1907
- },
1908
- {
1909
- "kind": "field",
1910
- "name": "placeholder",
1911
- "privacy": "public",
1912
- "type": {
1913
- "text": "string"
1914
- },
1915
- "description": "Define custom placeholder text, only supported by date input formats.",
1916
- "attribute": "placeholder",
1903
+ "attribute": "onDark",
1917
1904
  "reflects": true
1918
1905
  },
1919
1906
  {
@@ -1923,7 +1910,7 @@
1923
1910
  "type": {
1924
1911
  "text": "boolean"
1925
1912
  },
1926
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1913
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1927
1914
  "attribute": "required",
1928
1915
  "reflects": true
1929
1916
  },
@@ -1957,58 +1944,6 @@
1957
1944
  "description": "Custom help text message to display when validity = `valueMissing`.",
1958
1945
  "attribute": "setCustomValidityValueMissing"
1959
1946
  },
1960
- {
1961
- "kind": "field",
1962
- "name": "setCustomValidityValueMissingFilter",
1963
- "privacy": "public",
1964
- "type": {
1965
- "text": "string"
1966
- },
1967
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1968
- "attribute": "setCustomValidityValueMissingFilter"
1969
- },
1970
- {
1971
- "kind": "field",
1972
- "name": "touched",
1973
- "privacy": "private",
1974
- "type": {
1975
- "text": "boolean"
1976
- },
1977
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1978
- },
1979
- {
1980
- "kind": "field",
1981
- "name": "triggerIcon",
1982
- "privacy": "public",
1983
- "type": {
1984
- "text": "boolean"
1985
- },
1986
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1987
- "attribute": "triggerIcon",
1988
- "reflects": true
1989
- },
1990
- {
1991
- "kind": "field",
1992
- "name": "type",
1993
- "privacy": "public",
1994
- "type": {
1995
- "text": "string"
1996
- },
1997
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1998
- "attribute": "type",
1999
- "reflects": true
2000
- },
2001
- {
2002
- "kind": "field",
2003
- "name": "typedValue",
2004
- "privacy": "public",
2005
- "type": {
2006
- "text": "string"
2007
- },
2008
- "description": "Specifies the value of the input element within the combobox.",
2009
- "attribute": "typedValue",
2010
- "reflects": true
2011
- },
2012
1947
  {
2013
1948
  "kind": "field",
2014
1949
  "name": "validity",
@@ -2019,542 +1954,607 @@
2019
1954
  "description": "Specifies the `validityState` this element is in.",
2020
1955
  "attribute": "validity",
2021
1956
  "reflects": true
2022
- },
2023
- {
2024
- "kind": "field",
2025
- "name": "value",
2026
- "privacy": "public",
2027
- "type": {
2028
- "text": "string"
2029
- },
2030
- "description": "Value selected for the dropdown menu.",
2031
- "attribute": "value"
2032
- },
2033
- {
2034
- "kind": "field",
2035
- "name": "largeFullscreenHeadline",
2036
- "privacy": "public",
2037
- "type": {
2038
- "text": "boolean"
2039
- },
2040
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2041
- "attribute": "largeFullscreenHeadline",
2042
- "reflects": true
2043
- },
2044
- {
2045
- "kind": "field",
2046
- "name": "fullscreenBreakpoint",
2047
- "privacy": "public",
2048
- "type": {
2049
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2050
- },
2051
- "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.",
2052
- "default": "'sm'",
2053
- "attribute": "fullscreenBreakpoint",
2054
- "reflects": true
2055
- },
1957
+ }
1958
+ ],
1959
+ "events": [
2056
1960
  {
2057
- "kind": "field",
2058
- "name": "optionActive",
2059
- "privacy": "private",
1961
+ "name": "input",
2060
1962
  "type": {
2061
- "text": "object"
2062
- },
2063
- "description": "Specifies the currently active option."
2064
- },
2065
- {
2066
- "kind": "field",
2067
- "name": "componentHasFocus",
2068
- "description": "Returns true if the element has focus.",
2069
- "privacy": "private",
2070
- "return": {
2071
- "type": {
2072
- "text": "boolean"
2073
- }
2074
- },
2075
- "readonly": true,
2076
- "inheritedFrom": {
2077
- "name": "AuroElement",
2078
- "module": "components/layoutElement/src/auroElement.js"
2079
- }
2080
- },
2081
- {
2082
- "kind": "method",
2083
- "name": "resetShapeClasses",
2084
- "inheritedFrom": {
2085
- "name": "AuroElement",
2086
- "module": "components/layoutElement/src/auroElement.js"
1963
+ "text": "CustomEvent"
2087
1964
  }
2088
1965
  },
2089
1966
  {
2090
- "kind": "method",
2091
- "name": "resetLayoutClasses",
2092
- "inheritedFrom": {
2093
- "name": "AuroElement",
2094
- "module": "components/layoutElement/src/auroElement.js"
2095
- }
1967
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1968
+ "name": "auroFormElement-validated"
1969
+ }
1970
+ ],
1971
+ "attributes": [
1972
+ {
1973
+ "name": "appearance",
1974
+ "type": {
1975
+ "text": "'default' | 'inverse'"
1976
+ },
1977
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1978
+ "default": "'default'",
1979
+ "fieldName": "appearance"
2096
1980
  },
2097
1981
  {
2098
- "kind": "method",
2099
- "name": "updateComponentArchitecture",
2100
- "inheritedFrom": {
2101
- "name": "AuroElement",
2102
- "module": "components/layoutElement/src/auroElement.js"
2103
- }
1982
+ "name": "disabled",
1983
+ "type": {
1984
+ "text": "boolean"
1985
+ },
1986
+ "description": "If set, disables the checkbox group.",
1987
+ "fieldName": "disabled"
2104
1988
  },
2105
1989
  {
2106
- "kind": "field",
2107
- "name": "shape",
2108
- "privacy": "public",
1990
+ "name": "error",
2109
1991
  "type": {
2110
1992
  "text": "string"
2111
1993
  },
2112
- "attribute": "shape",
2113
- "reflects": true,
2114
- "inheritedFrom": {
2115
- "name": "AuroElement",
2116
- "module": "components/layoutElement/src/auroElement.js"
2117
- }
1994
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1995
+ "fieldName": "error"
2118
1996
  },
2119
1997
  {
2120
- "kind": "field",
2121
- "name": "size",
2122
- "privacy": "public",
1998
+ "name": "horizontal",
2123
1999
  "type": {
2124
- "text": "string"
2000
+ "text": "boolean"
2125
2001
  },
2126
- "attribute": "size",
2127
- "reflects": true,
2128
- "inheritedFrom": {
2129
- "name": "AuroElement",
2130
- "module": "components/layoutElement/src/auroElement.js"
2131
- }
2132
- }
2133
- ],
2134
- "events": [
2002
+ "description": "If set, checkboxes will be aligned horizontally.",
2003
+ "fieldName": "horizontal"
2004
+ },
2135
2005
  {
2136
- "name": "inputValue",
2006
+ "name": "noValidate",
2137
2007
  "type": {
2138
- "text": "CustomEvent"
2008
+ "text": "boolean"
2139
2009
  },
2140
- "description": "Notifies that the components internal HTML5 input value has changed."
2010
+ "description": "If set, disables auto-validation on blur.",
2011
+ "fieldName": "noValidate"
2141
2012
  },
2142
2013
  {
2143
- "name": "input",
2014
+ "name": "onDark",
2144
2015
  "type": {
2145
- "text": "CustomEvent"
2016
+ "text": "boolean"
2146
2017
  },
2147
- "description": "Notifies that the component has a new value set."
2018
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2019
+ "fieldName": "onDark"
2148
2020
  },
2149
2021
  {
2150
- "name": "auroCombobox-valueSet",
2022
+ "name": "required",
2151
2023
  "type": {
2152
- "text": "CustomEvent"
2024
+ "text": "boolean"
2153
2025
  },
2154
- "description": "(Deprecated) Notifies that the component has a new value set."
2026
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
2027
+ "fieldName": "required"
2155
2028
  },
2156
2029
  {
2157
- "description": "Notifies that the component value(s) have been validated.",
2158
- "name": "auroFormElement-validated"
2159
- }
2160
- ],
2161
- "attributes": [
2030
+ "name": "setCustomValidity",
2031
+ "type": {
2032
+ "text": "string"
2033
+ },
2034
+ "description": "Sets a custom help text message to display for all validityStates.",
2035
+ "fieldName": "setCustomValidity"
2036
+ },
2162
2037
  {
2163
- "name": "appearance",
2038
+ "name": "setCustomValidityCustomError",
2164
2039
  "type": {
2165
2040
  "text": "string"
2166
2041
  },
2167
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2168
- "default": "'default'",
2169
- "fieldName": "appearance"
2042
+ "description": "Custom help text message to display when validity = `customError`.",
2043
+ "fieldName": "setCustomValidityCustomError"
2170
2044
  },
2171
2045
  {
2172
- "name": "autocomplete",
2046
+ "name": "setCustomValidityValueMissing",
2173
2047
  "type": {
2174
2048
  "text": "string"
2175
2049
  },
2176
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2177
- "fieldName": "autocomplete"
2050
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2051
+ "fieldName": "setCustomValidityValueMissing"
2178
2052
  },
2179
2053
  {
2180
- "name": "autoPlacement",
2054
+ "name": "validity",
2181
2055
  "type": {
2182
- "text": "boolean"
2056
+ "text": "string"
2183
2057
  },
2184
- "description": "If declared, bib's position will be automatically calculated where to appear.",
2185
- "fieldName": "autoPlacement"
2058
+ "description": "Specifies the `validityState` this element is in.",
2059
+ "fieldName": "validity"
2060
+ }
2061
+ ],
2062
+ "superclass": {
2063
+ "name": "LitElement",
2064
+ "package": "lit"
2065
+ },
2066
+ "tagName": "auro-checkbox-group",
2067
+ "customElement": true
2068
+ }
2069
+ ],
2070
+ "exports": [
2071
+ {
2072
+ "kind": "js",
2073
+ "name": "AuroCheckboxGroup",
2074
+ "declaration": {
2075
+ "name": "AuroCheckboxGroup",
2076
+ "module": "components/checkbox/src/auro-checkbox-group.js"
2077
+ }
2078
+ }
2079
+ ]
2080
+ },
2081
+ {
2082
+ "kind": "javascript-module",
2083
+ "path": "components/checkbox/src/auro-checkbox.js",
2084
+ "declarations": [
2085
+ {
2086
+ "kind": "class",
2087
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2088
+ "name": "AuroCheckbox",
2089
+ "cssParts": [
2090
+ {
2091
+ "description": "apply css to a specific checkbox.",
2092
+ "name": "checkbox"
2093
+ },
2094
+ {
2095
+ "description": "apply css to a specific checkbox's input.",
2096
+ "name": "checkbox-input"
2097
+ },
2098
+ {
2099
+ "description": "apply css to a specific checkbox's label.",
2100
+ "name": "checkbox-label"
2101
+ }
2102
+ ],
2103
+ "slots": [
2104
+ {
2105
+ "description": "The default slot for the checkbox label.",
2106
+ "name": "default"
2107
+ }
2108
+ ],
2109
+ "members": [
2110
+ {
2111
+ "kind": "method",
2112
+ "name": "_initializeDefaults"
2113
+ },
2114
+ {
2115
+ "kind": "method",
2116
+ "name": "register",
2117
+ "static": true,
2118
+ "parameters": [
2119
+ {
2120
+ "name": "name",
2121
+ "default": "\"auro-checkbox\"",
2122
+ "description": "The name of element that you want to register to.",
2123
+ "optional": true,
2124
+ "type": {
2125
+ "text": "string"
2126
+ }
2127
+ }
2128
+ ],
2129
+ "description": "This will register this element with the browser."
2130
+ },
2131
+ {
2132
+ "kind": "method",
2133
+ "name": "handleChange",
2134
+ "parameters": [
2135
+ {
2136
+ "name": "event",
2137
+ "description": "The change event from the checkbox input.",
2138
+ "type": {
2139
+ "text": "Event"
2140
+ }
2141
+ }
2142
+ ],
2143
+ "description": "Handles the change event for the checkbox input.\nUpdates the checked state and dispatches a corresponding custom event.\nThis custom event is only for the purpose of supporting IE.",
2144
+ "privacy": "private",
2145
+ "return": {
2146
+ "type": {
2147
+ "text": "void"
2148
+ }
2149
+ }
2150
+ },
2151
+ {
2152
+ "kind": "method",
2153
+ "name": "handleInput",
2154
+ "parameters": [
2155
+ {
2156
+ "name": "event",
2157
+ "description": "The input event from the checkbox input.",
2158
+ "type": {
2159
+ "text": "Event"
2160
+ }
2161
+ }
2162
+ ],
2163
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2164
+ "privacy": "private",
2165
+ "return": {
2166
+ "type": {
2167
+ "text": "void"
2168
+ }
2169
+ }
2170
+ },
2171
+ {
2172
+ "kind": "method",
2173
+ "name": "handleFocusin",
2174
+ "description": "Function to support",
2175
+ "privacy": "private",
2176
+ "return": {
2177
+ "type": {
2178
+ "text": "void"
2179
+ }
2180
+ }
2181
+ },
2182
+ {
2183
+ "kind": "method",
2184
+ "name": "generateIconHtml",
2185
+ "description": "Function to generate checkmark svg.",
2186
+ "privacy": "private",
2187
+ "return": {
2188
+ "type": {
2189
+ "text": "HTMLElement"
2190
+ }
2191
+ }
2192
+ },
2193
+ {
2194
+ "kind": "method",
2195
+ "name": "reset",
2196
+ "description": "Resets component to initial state.",
2197
+ "return": {
2198
+ "type": {
2199
+ "text": "void"
2200
+ }
2201
+ }
2202
+ },
2203
+ {
2204
+ "kind": "method",
2205
+ "name": "updateAriaLabel",
2206
+ "description": "Updates the aria-label based on slot content.",
2207
+ "privacy": "private",
2208
+ "return": {
2209
+ "type": {
2210
+ "text": "void"
2211
+ }
2212
+ }
2186
2213
  },
2187
2214
  {
2188
- "name": "availableOptions",
2189
- "type": {
2190
- "text": "array"
2191
- },
2192
- "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).",
2193
- "fieldName": "availableOptions"
2215
+ "kind": "method",
2216
+ "name": "handleKeyDown",
2217
+ "parameters": [
2218
+ {
2219
+ "name": "event",
2220
+ "description": "The keydown event from the checkbox input.",
2221
+ "type": {
2222
+ "text": "KeyboardEvent"
2223
+ }
2224
+ }
2225
+ ],
2226
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
2227
+ "privacy": "private",
2228
+ "return": {
2229
+ "type": {
2230
+ "text": "void"
2231
+ }
2232
+ }
2194
2233
  },
2195
2234
  {
2196
- "name": "behavior",
2235
+ "kind": "field",
2236
+ "name": "appearance",
2237
+ "privacy": "public",
2197
2238
  "type": {
2198
- "text": "'filter' | 'suggestion'"
2239
+ "text": "'default' | 'inverse'"
2199
2240
  },
2200
- "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.",
2201
- "default": "'suggestion'",
2202
- "fieldName": "behavior"
2241
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2242
+ "default": "'default'",
2243
+ "attribute": "appearance",
2244
+ "reflects": true
2203
2245
  },
2204
2246
  {
2205
- "name": "checkmark",
2247
+ "kind": "field",
2248
+ "name": "checked",
2249
+ "privacy": "public",
2206
2250
  "type": {
2207
2251
  "text": "boolean"
2208
2252
  },
2209
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
2210
- "fieldName": "checkmark"
2253
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2254
+ "attribute": "checked",
2255
+ "reflects": true
2211
2256
  },
2212
2257
  {
2258
+ "kind": "field",
2213
2259
  "name": "disabled",
2260
+ "privacy": "public",
2214
2261
  "type": {
2215
2262
  "text": "boolean"
2216
2263
  },
2217
- "description": "If set, disables the combobox.",
2218
- "fieldName": "disabled"
2219
- },
2220
- {
2221
- "name": "dvInputOnly",
2222
- "type": {
2223
- "text": "boolean"
2224
- },
2225
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2226
- "fieldName": "dvInputOnly"
2264
+ "description": "If set to true, the checkbox will not be clickable.",
2265
+ "attribute": "disabled",
2266
+ "reflects": true
2227
2267
  },
2228
2268
  {
2269
+ "kind": "field",
2229
2270
  "name": "error",
2271
+ "privacy": "public",
2230
2272
  "type": {
2231
- "text": "string"
2273
+ "text": "boolean"
2232
2274
  },
2233
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2234
- "fieldName": "error"
2275
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2276
+ "attribute": "error",
2277
+ "reflects": true
2235
2278
  },
2236
2279
  {
2237
- "name": "format",
2280
+ "kind": "field",
2281
+ "name": "id",
2282
+ "privacy": "public",
2238
2283
  "type": {
2239
2284
  "text": "string"
2240
2285
  },
2241
- "description": "Specifies the input mask format.",
2242
- "fieldName": "format"
2286
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2287
+ "attribute": "id",
2288
+ "reflects": true
2243
2289
  },
2244
2290
  {
2245
- "name": "inputmode",
2291
+ "kind": "field",
2292
+ "name": "inputId",
2293
+ "privacy": "private",
2246
2294
  "type": {
2247
2295
  "text": "string"
2248
2296
  },
2249
- "description": "Exposes inputmode attribute for input.",
2250
- "fieldName": "inputmode"
2297
+ "description": "The id for input node."
2251
2298
  },
2252
2299
  {
2253
- "name": "layout",
2300
+ "kind": "field",
2301
+ "name": "name",
2302
+ "privacy": "public",
2254
2303
  "type": {
2255
2304
  "text": "string"
2256
2305
  },
2257
- "description": "Sets the layout of the combobox.",
2258
- "default": "'classic'",
2259
- "fieldName": "layout",
2260
- "inheritedFrom": {
2261
- "name": "AuroElement",
2262
- "module": "components/layoutElement/src/auroElement.js"
2263
- }
2264
- },
2265
- {
2266
- "name": "matchWidth",
2267
- "type": {
2268
- "text": "boolean"
2269
- },
2270
- "description": "If declared, the popover and trigger will be set to the same width.",
2271
- "fieldName": "matchWidth"
2272
- },
2273
- {
2274
- "name": "noFilter",
2275
- "type": {
2276
- "text": "boolean"
2277
- },
2278
- "description": "If set, combobox will not filter menuoptions based on input.",
2279
- "fieldName": "noFilter"
2306
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2307
+ "attribute": "name"
2280
2308
  },
2281
2309
  {
2282
- "name": "noFlip",
2310
+ "kind": "field",
2311
+ "name": "onDark",
2312
+ "privacy": "public",
2283
2313
  "type": {
2284
2314
  "text": "boolean"
2285
2315
  },
2286
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2287
- "fieldName": "noFlip"
2316
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2317
+ "attribute": "onDark",
2318
+ "reflects": true
2288
2319
  },
2289
2320
  {
2290
- "name": "shift",
2321
+ "kind": "field",
2322
+ "name": "touched",
2323
+ "privacy": "private",
2291
2324
  "type": {
2292
2325
  "text": "boolean"
2293
2326
  },
2294
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2295
- "fieldName": "shift"
2327
+ "description": "Indicates whether the checkbox has been interacted with."
2296
2328
  },
2297
2329
  {
2298
- "name": "noValidate",
2330
+ "kind": "field",
2331
+ "name": "value",
2332
+ "privacy": "public",
2299
2333
  "type": {
2300
- "text": "boolean"
2334
+ "text": "string"
2301
2335
  },
2302
- "description": "If set, disables auto-validation on blur.",
2303
- "fieldName": "noValidate"
2336
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2337
+ "attribute": "value"
2304
2338
  },
2305
2339
  {
2306
- "name": "offset",
2340
+ "kind": "field",
2341
+ "name": "tabIndex",
2342
+ "privacy": "private",
2307
2343
  "type": {
2308
2344
  "text": "number"
2309
2345
  },
2310
- "description": "Gap between the trigger element and bib.",
2311
- "default": "0",
2312
- "fieldName": "offset"
2346
+ "description": "The tabindex attribute for the checkbox.",
2347
+ "attribute": "tabindex",
2348
+ "reflects": true
2313
2349
  },
2314
2350
  {
2315
- "name": "onDark",
2351
+ "kind": "field",
2352
+ "name": "ariaChecked",
2353
+ "privacy": "private",
2316
2354
  "type": {
2317
- "text": "boolean"
2355
+ "text": "string"
2318
2356
  },
2319
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2320
- "fieldName": "onDark"
2357
+ "description": "The aria-checked attribute for the checkbox.",
2358
+ "attribute": "aria-checked",
2359
+ "reflects": true
2321
2360
  },
2322
2361
  {
2323
- "name": "optionSelected",
2362
+ "kind": "field",
2363
+ "name": "ariaDisabled",
2364
+ "privacy": "private",
2324
2365
  "type": {
2325
- "text": "HTMLElement"
2366
+ "text": "string"
2326
2367
  },
2327
- "description": "Specifies the current selected option.",
2328
- "fieldName": "optionSelected"
2368
+ "description": "The aria-disabled attribute for the checkbox.",
2369
+ "attribute": "aria-disabled",
2370
+ "reflects": true
2329
2371
  },
2330
2372
  {
2331
- "name": "persistInput",
2373
+ "kind": "field",
2374
+ "name": "role",
2375
+ "privacy": "private",
2332
2376
  "type": {
2333
- "text": "boolean"
2377
+ "text": "string"
2334
2378
  },
2335
- "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.",
2336
- "fieldName": "persistInput"
2337
- },
2379
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2380
+ "attribute": "role",
2381
+ "reflects": true
2382
+ }
2383
+ ],
2384
+ "events": [
2338
2385
  {
2339
- "name": "placement",
2386
+ "name": "auroCheckbox-input",
2340
2387
  "type": {
2341
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2342
- },
2343
- "description": "Position where the bib should appear relative to the trigger.",
2344
- "default": "'bottom-start'",
2345
- "fieldName": "placement"
2388
+ "text": "CustomEvent"
2389
+ }
2346
2390
  },
2347
2391
  {
2348
- "name": "placeholder",
2392
+ "name": "auroCheckbox-focusin",
2349
2393
  "type": {
2350
- "text": "string"
2351
- },
2352
- "description": "Define custom placeholder text, only supported by date input formats.",
2353
- "fieldName": "placeholder"
2394
+ "text": "CustomEvent"
2395
+ }
2354
2396
  },
2355
2397
  {
2356
- "name": "required",
2398
+ "name": "auroCheckbox-focusout",
2357
2399
  "type": {
2358
- "text": "boolean"
2359
- },
2360
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2361
- "fieldName": "required"
2400
+ "text": "CustomEvent"
2401
+ }
2362
2402
  },
2363
2403
  {
2364
- "name": "setCustomValidity",
2365
- "type": {
2366
- "text": "string"
2367
- },
2368
- "description": "Sets a custom help text message to display for all validityStates.",
2369
- "fieldName": "setCustomValidity"
2404
+ "description": "(Deprecated) Notifies when checked value is changed.",
2405
+ "name": "change"
2370
2406
  },
2371
2407
  {
2372
- "name": "setCustomValidityCustomError",
2408
+ "description": "Notifies when when checked value is changed by user's interface.",
2409
+ "name": "input"
2410
+ }
2411
+ ],
2412
+ "attributes": [
2413
+ {
2414
+ "name": "appearance",
2373
2415
  "type": {
2374
- "text": "string"
2416
+ "text": "'default' | 'inverse'"
2375
2417
  },
2376
- "description": "Custom help text message to display when validity = `customError`.",
2377
- "fieldName": "setCustomValidityCustomError"
2418
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2419
+ "default": "'default'",
2420
+ "fieldName": "appearance"
2378
2421
  },
2379
2422
  {
2380
- "name": "setCustomValidityValueMissing",
2423
+ "name": "checked",
2381
2424
  "type": {
2382
- "text": "string"
2425
+ "text": "boolean"
2383
2426
  },
2384
- "description": "Custom help text message to display when validity = `valueMissing`.",
2385
- "fieldName": "setCustomValidityValueMissing"
2427
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2428
+ "fieldName": "checked"
2386
2429
  },
2387
2430
  {
2388
- "name": "setCustomValidityValueMissingFilter",
2431
+ "name": "disabled",
2389
2432
  "type": {
2390
- "text": "string"
2433
+ "text": "boolean"
2391
2434
  },
2392
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2393
- "fieldName": "setCustomValidityValueMissingFilter"
2435
+ "description": "If set to true, the checkbox will not be clickable.",
2436
+ "fieldName": "disabled"
2394
2437
  },
2395
2438
  {
2396
- "name": "triggerIcon",
2439
+ "name": "error",
2397
2440
  "type": {
2398
2441
  "text": "boolean"
2399
2442
  },
2400
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2401
- "fieldName": "triggerIcon"
2443
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2444
+ "fieldName": "error"
2402
2445
  },
2403
2446
  {
2404
- "name": "type",
2447
+ "name": "id",
2405
2448
  "type": {
2406
2449
  "text": "string"
2407
2450
  },
2408
- "description": "Applies the defined value as the type attribute on `auro-input`.",
2409
- "fieldName": "type"
2451
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2452
+ "fieldName": "id"
2410
2453
  },
2411
2454
  {
2412
- "name": "typedValue",
2455
+ "name": "name",
2413
2456
  "type": {
2414
2457
  "text": "string"
2415
2458
  },
2416
- "description": "Specifies the value of the input element within the combobox.",
2417
- "fieldName": "typedValue"
2459
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2460
+ "fieldName": "name"
2418
2461
  },
2419
2462
  {
2420
- "name": "validity",
2463
+ "name": "onDark",
2421
2464
  "type": {
2422
- "text": "string"
2465
+ "text": "boolean"
2423
2466
  },
2424
- "description": "Specifies the `validityState` this element is in.",
2425
- "fieldName": "validity"
2467
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2468
+ "fieldName": "onDark"
2426
2469
  },
2427
2470
  {
2428
2471
  "name": "value",
2429
2472
  "type": {
2430
2473
  "text": "string"
2431
2474
  },
2432
- "description": "Value selected for the dropdown menu.",
2475
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2433
2476
  "fieldName": "value"
2434
2477
  },
2435
2478
  {
2436
- "name": "largeFullscreenHeadline",
2437
- "type": {
2438
- "text": "boolean"
2439
- },
2440
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2441
- "fieldName": "largeFullscreenHeadline"
2442
- },
2443
- {
2444
- "name": "fullscreenBreakpoint",
2479
+ "name": "tabindex",
2445
2480
  "type": {
2446
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2481
+ "text": "number"
2447
2482
  },
2448
- "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.",
2449
- "default": "'sm'",
2450
- "fieldName": "fullscreenBreakpoint"
2483
+ "description": "The tabindex attribute for the checkbox.",
2484
+ "fieldName": "tabIndex"
2451
2485
  },
2452
2486
  {
2453
- "name": "shape",
2487
+ "name": "aria-checked",
2454
2488
  "type": {
2455
2489
  "text": "string"
2456
2490
  },
2457
- "fieldName": "shape",
2458
- "inheritedFrom": {
2459
- "name": "AuroElement",
2460
- "module": "components/layoutElement/src/auroElement.js"
2461
- }
2491
+ "description": "The aria-checked attribute for the checkbox.",
2492
+ "fieldName": "ariaChecked"
2462
2493
  },
2463
2494
  {
2464
- "name": "size",
2495
+ "name": "aria-disabled",
2465
2496
  "type": {
2466
2497
  "text": "string"
2467
2498
  },
2468
- "fieldName": "size",
2469
- "inheritedFrom": {
2470
- "name": "AuroElement",
2471
- "module": "components/layoutElement/src/auroElement.js"
2472
- }
2499
+ "description": "The aria-disabled attribute for the checkbox.",
2500
+ "fieldName": "ariaDisabled"
2473
2501
  },
2474
2502
  {
2475
- "name": "ondark",
2503
+ "name": "role",
2476
2504
  "type": {
2477
- "text": "boolean"
2505
+ "text": "string"
2478
2506
  },
2479
- "fieldName": "onDark",
2480
- "inheritedFrom": {
2481
- "name": "AuroElement",
2482
- "module": "components/layoutElement/src/auroElement.js"
2483
- }
2507
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2508
+ "fieldName": "role"
2484
2509
  }
2485
2510
  ],
2486
2511
  "superclass": {
2487
- "name": "AuroElement",
2488
- "module": "/components/layoutElement/src/auroElement.js"
2512
+ "name": "LitElement",
2513
+ "package": "lit"
2489
2514
  },
2490
- "tagName": "auro-combobox",
2515
+ "tagName": "auro-checkbox",
2491
2516
  "customElement": true
2492
2517
  }
2493
2518
  ],
2494
2519
  "exports": [
2495
2520
  {
2496
2521
  "kind": "js",
2497
- "name": "AuroCombobox",
2522
+ "name": "AuroCheckbox",
2498
2523
  "declaration": {
2499
- "name": "AuroCombobox",
2500
- "module": "components/combobox/src/auro-combobox.js"
2524
+ "name": "AuroCheckbox",
2525
+ "module": "components/checkbox/src/auro-checkbox.js"
2501
2526
  }
2502
2527
  }
2503
2528
  ]
2504
2529
  },
2505
2530
  {
2506
2531
  "kind": "javascript-module",
2507
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2508
- "declarations": [
2509
- {
2510
- "kind": "variable",
2511
- "name": "comboboxKeyboardStrategy",
2512
- "type": {
2513
- "text": "object"
2514
- },
2515
- "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'down'); } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'up'); } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { // Forms should not submit on Enter from a combobox, regardless of which // child element (input, clear button, menu) is focused. evt.stopPropagation(); if (isClearBtnFocused(ctx)) { // Let the browser dispatch Enter to the focused clear button so its // built-in activation fires and clears the selection. Do NOT call // preventDefault — that would block the activation. return; } if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); } else { evt.preventDefault(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // 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(); } } } }"
2516
- }
2517
- ],
2532
+ "path": "components/checkbox/src/index.js",
2533
+ "declarations": [],
2518
2534
  "exports": [
2519
2535
  {
2520
2536
  "kind": "js",
2521
- "name": "comboboxKeyboardStrategy",
2537
+ "name": "AuroCheckbox",
2522
2538
  "declaration": {
2523
- "name": "comboboxKeyboardStrategy",
2524
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2539
+ "name": "AuroCheckbox",
2540
+ "module": "components/checkbox/src/index.js"
2525
2541
  }
2526
- }
2527
- ]
2528
- },
2529
- {
2530
- "kind": "javascript-module",
2531
- "path": "components/combobox/src/index.js",
2532
- "declarations": [],
2533
- "exports": [
2542
+ },
2534
2543
  {
2535
2544
  "kind": "js",
2536
- "name": "AuroCombobox",
2545
+ "name": "AuroCheckboxGroup",
2537
2546
  "declaration": {
2538
- "name": "AuroCombobox",
2539
- "module": "components/combobox/src/index.js"
2547
+ "name": "AuroCheckboxGroup",
2548
+ "module": "components/checkbox/src/index.js"
2540
2549
  }
2541
2550
  }
2542
2551
  ]
2543
2552
  },
2544
2553
  {
2545
2554
  "kind": "javascript-module",
2546
- "path": "components/combobox/src/registered.js",
2555
+ "path": "components/checkbox/src/registered.js",
2547
2556
  "declarations": [],
2548
- "exports": [
2549
- {
2550
- "kind": "js",
2551
- "name": "AuroCombobox",
2552
- "declaration": {
2553
- "name": "AuroCombobox",
2554
- "module": "components/combobox/src/registered.js"
2555
- }
2556
- }
2557
- ]
2557
+ "exports": []
2558
2558
  },
2559
2559
  {
2560
2560
  "kind": "javascript-module",
@@ -12202,39 +12202,6 @@
12202
12202
  "module": "components/input/src/base-input.js"
12203
12203
  }
12204
12204
  },
12205
- {
12206
- "kind": "field",
12207
- "name": "format",
12208
- "privacy": "public",
12209
- "type": {
12210
- "text": "string"
12211
- },
12212
- "description": "Overrides LitElement's generated accessor so we can track whether the\nconsumer explicitly set `format`. Locale-derived updates use\n`_setFormatFromLocale` instead, which skips this flag.",
12213
- "attribute": "format",
12214
- "reflects": true,
12215
- "inheritedFrom": {
12216
- "name": "BaseInput",
12217
- "module": "components/input/src/base-input.js"
12218
- }
12219
- },
12220
- {
12221
- "kind": "method",
12222
- "name": "_setFormatFromLocale",
12223
- "parameters": [
12224
- {
12225
- "name": "value",
12226
- "type": {
12227
- "text": "string"
12228
- }
12229
- }
12230
- ],
12231
- "description": "Sets format without marking it as user-set. Used by locale auto-derive\nso that a subsequent locale change can still update the format.",
12232
- "privacy": "private",
12233
- "inheritedFrom": {
12234
- "name": "BaseInput",
12235
- "module": "components/input/src/base-input.js"
12236
- }
12237
- },
12238
12205
  {
12239
12206
  "kind": "method",
12240
12207
  "name": "patchInputEvent",
@@ -12785,28 +12752,6 @@
12785
12752
  "module": "components/input/src/base-input.js"
12786
12753
  }
12787
12754
  },
12788
- {
12789
- "kind": "field",
12790
- "name": "_format",
12791
- "default": "undefined",
12792
- "inheritedFrom": {
12793
- "name": "BaseInput",
12794
- "module": "components/input/src/base-input.js"
12795
- }
12796
- },
12797
- {
12798
- "kind": "field",
12799
- "name": "_userSetFormat",
12800
- "type": {
12801
- "text": "boolean"
12802
- },
12803
- "privacy": "private",
12804
- "default": "false",
12805
- "inheritedFrom": {
12806
- "name": "BaseInput",
12807
- "module": "components/input/src/base-input.js"
12808
- }
12809
- },
12810
12755
  {
12811
12756
  "kind": "field",
12812
12757
  "name": "max",
@@ -12901,6 +12846,15 @@
12901
12846
  "module": "components/layoutElement/src/auroElement.js"
12902
12847
  }
12903
12848
  },
12849
+ {
12850
+ "kind": "field",
12851
+ "name": "_rawMaskValue",
12852
+ "default": "undefined",
12853
+ "inheritedFrom": {
12854
+ "name": "BaseInput",
12855
+ "module": "components/input/src/base-input.js"
12856
+ }
12857
+ },
12904
12858
  {
12905
12859
  "kind": "field",
12906
12860
  "name": "required",
@@ -13205,6 +13159,21 @@
13205
13159
  "module": "components/input/src/base-input.js"
13206
13160
  }
13207
13161
  },
13162
+ {
13163
+ "kind": "field",
13164
+ "name": "format",
13165
+ "privacy": "public",
13166
+ "type": {
13167
+ "text": "string"
13168
+ },
13169
+ "description": "Specifies the input mask format.",
13170
+ "attribute": "format",
13171
+ "reflects": true,
13172
+ "inheritedFrom": {
13173
+ "name": "BaseInput",
13174
+ "module": "components/input/src/base-input.js"
13175
+ }
13176
+ },
13208
13177
  {
13209
13178
  "kind": "field",
13210
13179
  "name": "hasFocus",
@@ -13777,7 +13746,7 @@
13777
13746
  "type": {
13778
13747
  "text": "string"
13779
13748
  },
13780
- "description": "Overrides LitElement's generated accessor so we can track whether the\nconsumer explicitly set `format`. Locale-derived updates use\n`_setFormatFromLocale` instead, which skips this flag.",
13749
+ "description": "Specifies the input mask format.",
13781
13750
  "fieldName": "format",
13782
13751
  "inheritedFrom": {
13783
13752
  "name": "BaseInput",
@@ -14353,31 +14322,6 @@
14353
14322
  },
14354
14323
  "readonly": true
14355
14324
  },
14356
- {
14357
- "kind": "field",
14358
- "name": "format",
14359
- "privacy": "public",
14360
- "type": {
14361
- "text": "string"
14362
- },
14363
- "description": "Overrides LitElement's generated accessor so we can track whether the\nconsumer explicitly set `format`. Locale-derived updates use\n`_setFormatFromLocale` instead, which skips this flag.",
14364
- "attribute": "format",
14365
- "reflects": true
14366
- },
14367
- {
14368
- "kind": "method",
14369
- "name": "_setFormatFromLocale",
14370
- "parameters": [
14371
- {
14372
- "name": "value",
14373
- "type": {
14374
- "text": "string"
14375
- }
14376
- }
14377
- ],
14378
- "description": "Sets format without marking it as user-set. Used by locale auto-derive\nso that a subsequent locale change can still update the format.",
14379
- "privacy": "private"
14380
- },
14381
14325
  {
14382
14326
  "kind": "method",
14383
14327
  "name": "patchInputEvent",
@@ -14792,20 +14736,6 @@
14792
14736
  "attribute": "locale",
14793
14737
  "reflects": true
14794
14738
  },
14795
- {
14796
- "kind": "field",
14797
- "name": "_format",
14798
- "default": "undefined"
14799
- },
14800
- {
14801
- "kind": "field",
14802
- "name": "_userSetFormat",
14803
- "type": {
14804
- "text": "boolean"
14805
- },
14806
- "privacy": "private",
14807
- "default": "false"
14808
- },
14809
14739
  {
14810
14740
  "kind": "field",
14811
14741
  "name": "max",
@@ -14880,6 +14810,11 @@
14880
14810
  "module": "components/layoutElement/src/auroElement.js"
14881
14811
  }
14882
14812
  },
14813
+ {
14814
+ "kind": "field",
14815
+ "name": "_rawMaskValue",
14816
+ "default": "undefined"
14817
+ },
14883
14818
  {
14884
14819
  "kind": "field",
14885
14820
  "name": "required",
@@ -15104,6 +15039,17 @@
15104
15039
  "description": "Contains the help text message for the current validity error.",
15105
15040
  "attribute": "errorMessage"
15106
15041
  },
15042
+ {
15043
+ "kind": "field",
15044
+ "name": "format",
15045
+ "privacy": "public",
15046
+ "type": {
15047
+ "text": "string"
15048
+ },
15049
+ "description": "Specifies the input mask format.",
15050
+ "attribute": "format",
15051
+ "reflects": true
15052
+ },
15107
15053
  {
15108
15054
  "kind": "field",
15109
15055
  "name": "hasFocus",
@@ -15534,7 +15480,7 @@
15534
15480
  "type": {
15535
15481
  "text": "string"
15536
15482
  },
15537
- "description": "Overrides LitElement's generated accessor so we can track whether the\nconsumer explicitly set `format`. Locale-derived updates use\n`_setFormatFromLocale` instead, which skips this flag.",
15483
+ "description": "Specifies the input mask format.",
15538
15484
  "fieldName": "format"
15539
15485
  },
15540
15486
  {
@@ -19168,7 +19114,7 @@
19168
19114
  {
19169
19115
  "kind": "method",
19170
19116
  "name": "configureMenu",
19171
- "description": "Binds all behavior needed to the menu after rendering.",
19117
+ "description": "Binds all behavior needed to the menu after rendering.\n\nThe `<auro-menu>` reference is captured once and not re-targeted on\n`slotchange`. Runtime option mutations are covered via\n`auroMenu-optionsChange`, so swap options inside the menu freely; do not\nswap the `<auro-menu>` element itself under a live select — remount the\nparent `<auro-select>` instead.",
19172
19118
  "privacy": "private",
19173
19119
  "return": {
19174
19120
  "type": {
@@ -20372,7 +20318,7 @@
20372
20318
  "type": {
20373
20319
  "text": "object"
20374
20320
  },
20375
- "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) { evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getEnabledOptions returns a fresh filtered array. const lastOption = getEnabledOptions(component.menu).pop(); if (!lastOption) { return; } // Pre-stash before show() so the auroDropdown-toggled handler's // `!optionActive` guard short-circuits the firstActive/selected fallback — // otherwise show() synchronously fires the handler and writes // aria-activedescendant once before we overwrite it. component.menu.updateActiveOption(lastOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Enter(component, evt, ctx) { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit. Matches APG select-only combobox // and native <select> behavior: Enter opens the listbox when closed, selects // the active option when open — it does not submit a parent form. evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getEnabledOptions(component.menu); if (!firstOption) { return; } // See End() for why this must run before show(). component.menu.updateActiveOption(firstOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, 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); }, }"
20321
+ "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) { evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getActiveOptions returns a fresh filtered array. // Uses \"active\" (not \"enabled\") so hidden and static rows — which a screen // reader must not announce as focused — are skipped. const lastOption = getActiveOptions(component.menu).pop(); if (!lastOption) { return; } // Pre-stash before show() so the auroDropdown-toggled handler's // `!optionActive` guard short-circuits the firstActive/selected fallback — // otherwise show() synchronously fires the handler and writes // aria-activedescendant once before we overwrite it. component.menu.updateActiveOption(lastOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Enter(component, evt, ctx) { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit. Matches APG select-only combobox // and native <select> behavior: Enter opens the listbox when closed, selects // the active option when open — it does not submit a parent form. evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getActiveOptions(component.menu); if (!firstOption) { return; } // See End() for why this must run before show(). component.menu.updateActiveOption(firstOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, 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) { // Ignore keys chorded with Ctrl/Meta/Alt so browser/OS shortcuts // (Cmd+C, Ctrl+V, Alt+X, Cmd+Space, …) don't leak into typeahead // or toggle the bib. Native <select> ignores modified keys. // ArrowUp/ArrowDown handle modifier+arrow explicitly above; this // guard only affects the default (printable/Space) branch. if (evt.ctrlKey || evt.metaKey || evt.altKey) { return; } // 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); }, }"
20376
20322
  }
20377
20323
  ],
20378
20324
  "exports": [