@aurodesignsystem-dev/auro-formkit 0.0.0-pr1475.4 → 0.0.0-pr1477.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 (73) hide show
  1. package/components/bibtemplate/dist/auro-bibtemplate.d.ts +0 -7
  2. package/components/bibtemplate/dist/index.js +1 -9
  3. package/components/bibtemplate/dist/registered.js +1 -9
  4. package/components/checkbox/demo/customize.min.js +1 -1
  5. package/components/checkbox/demo/getting-started.min.js +1 -1
  6. package/components/checkbox/demo/index.min.js +1 -1
  7. package/components/checkbox/dist/index.js +1 -1
  8. package/components/checkbox/dist/registered.js +1 -1
  9. package/components/combobox/demo/customize.min.js +18 -234
  10. package/components/combobox/demo/getting-started.min.js +18 -234
  11. package/components/combobox/demo/index.min.js +18 -234
  12. package/components/combobox/demo/keyboard-behavior.md +68 -8
  13. package/components/combobox/dist/index.js +18 -234
  14. package/components/combobox/dist/registered.js +18 -234
  15. package/components/counter/demo/customize.min.js +15 -231
  16. package/components/counter/demo/index.min.js +15 -231
  17. package/components/counter/demo/keyboard-behavior.md +0 -1
  18. package/components/counter/dist/index.js +433 -45
  19. package/components/counter/dist/registered.js +2 -10
  20. package/components/datepicker/demo/accessibility.md +3 -51
  21. package/components/datepicker/demo/api.md +0 -9
  22. package/components/datepicker/demo/customize.html +0 -2
  23. package/components/datepicker/demo/customize.md +8 -72
  24. package/components/datepicker/demo/design.md +1 -3
  25. package/components/datepicker/demo/index.js +1 -5
  26. package/components/datepicker/demo/index.md +1 -81
  27. package/components/datepicker/demo/index.min.js +101 -1350
  28. package/components/datepicker/demo/keyboard-behavior.md +2 -201
  29. package/components/datepicker/demo/voiceover.md +12 -19
  30. package/components/datepicker/dist/index.js +111 -1284
  31. package/components/datepicker/dist/registered.js +111 -1284
  32. package/components/datepicker/dist/src/auro-calendar-cell.d.ts +1 -64
  33. package/components/datepicker/dist/src/auro-calendar-month.d.ts +0 -28
  34. package/components/datepicker/dist/src/auro-calendar.d.ts +0 -84
  35. package/components/datepicker/dist/src/auro-datepicker.d.ts +0 -80
  36. package/components/datepicker/dist/src/datepickerKeyboardStrategy.d.ts +3 -5
  37. package/components/dropdown/demo/accessibility.md +0 -11
  38. package/components/dropdown/demo/api.md +0 -1
  39. package/components/dropdown/demo/customize.md +0 -3
  40. package/components/dropdown/demo/customize.min.js +13 -221
  41. package/components/dropdown/demo/getting-started.min.js +13 -221
  42. package/components/dropdown/demo/index.min.js +13 -221
  43. package/components/dropdown/demo/keyboard-behavior.md +0 -1
  44. package/components/dropdown/dist/auro-dropdown.d.ts +1 -31
  45. package/components/dropdown/dist/index.js +13 -221
  46. package/components/dropdown/dist/registered.js +13 -221
  47. package/components/form/demo/customize.min.js +987 -2806
  48. package/components/form/demo/getting-started.min.js +987 -2806
  49. package/components/form/demo/index.min.js +987 -2806
  50. package/components/form/demo/registerDemoDeps.min.js +982 -2801
  51. package/components/input/demo/customize.min.js +1 -1
  52. package/components/input/demo/getting-started.min.js +1 -1
  53. package/components/input/demo/index.min.js +1 -1
  54. package/components/input/dist/index.js +1 -1
  55. package/components/input/dist/registered.js +1 -1
  56. package/components/radio/demo/getting-started.js +1 -1
  57. package/components/radio/demo/getting-started.md +1 -1
  58. package/components/radio/demo/index.min.js +1 -1
  59. package/components/radio/dist/index.js +1 -1
  60. package/components/radio/dist/registered.js +1 -1
  61. package/components/select/demo/customize.min.js +33 -247
  62. package/components/select/demo/getting-started.min.js +33 -247
  63. package/components/select/demo/index.min.js +33 -247
  64. package/components/select/demo/keyboard-behavior.md +54 -9
  65. package/components/select/dist/index.js +33 -247
  66. package/components/select/dist/registered.js +33 -247
  67. package/custom-elements.json +1491 -2163
  68. package/package.json +2 -2
  69. package/components/datepicker/demo/customize.js +0 -19
  70. package/components/datepicker/demo/customize.min.js +0 -25810
  71. package/components/radio/demo/customize.min.js +0 -2186
  72. package/components/radio/demo/demo-support.min.js +0 -55807
  73. package/components/radio/demo/getting-started.min.js +0 -2205
@@ -128,17 +128,6 @@
128
128
  },
129
129
  "attribute": "isFullscreen",
130
130
  "reflects": true
131
- },
132
- {
133
- "kind": "field",
134
- "name": "showFooter",
135
- "privacy": "public",
136
- "type": {
137
- "text": "boolean"
138
- },
139
- "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
140
- "attribute": "showFooter",
141
- "reflects": true
142
131
  }
143
132
  ],
144
133
  "events": [
@@ -170,14 +159,6 @@
170
159
  },
171
160
  "default": "false",
172
161
  "fieldName": "large"
173
- },
174
- {
175
- "name": "showFooter",
176
- "type": {
177
- "text": "boolean"
178
- },
179
- "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
180
- "fieldName": "showFooter"
181
162
  }
182
163
  ],
183
164
  "superclass": {
@@ -267,80 +248,34 @@
267
248
  },
268
249
  {
269
250
  "kind": "javascript-module",
270
- "path": "components/combobox/src/auro-combobox.js",
251
+ "path": "components/checkbox/src/auro-checkbox-group.js",
271
252
  "declarations": [
272
253
  {
273
254
  "kind": "class",
274
- "description": "The `auro-combobox` element provides users with a way to select an option from a list of filtered or suggested options based on user input.",
275
- "name": "AuroCombobox",
255
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
256
+ "name": "AuroCheckboxGroup",
276
257
  "slots": [
277
258
  {
278
- "description": "Default slot for the menu content.",
279
- "name": ""
259
+ "description": "Allows for the legend to be overridden.",
260
+ "name": "legend"
280
261
  },
281
262
  {
282
- "type": {
283
- "text": "HTMLSlotElement"
284
- },
285
263
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
286
264
  "name": "optionalLabel"
287
265
  },
288
266
  {
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.",
267
+ "description": "Allows for the helper text to be overridden.",
306
268
  "name": "helpText"
307
269
  },
308
270
  {
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"
271
+ "description": "The default slot for the checkbox items.",
272
+ "name": "default"
311
273
  }
312
274
  ],
313
275
  "members": [
314
276
  {
315
277
  "kind": "method",
316
- "name": "_initializeDefaults",
317
- "privacy": "private",
318
- "return": {
319
- "type": {
320
- "text": "void"
321
- }
322
- }
323
- },
324
- {
325
- "kind": "field",
326
- "name": "inputValue",
327
- "description": "Returns the current value of the input element within the combobox.",
328
- "return": {
329
- "type": {
330
- "text": "string|undefined"
331
- }
332
- },
333
- "readonly": true
334
- },
335
- {
336
- "kind": "method",
337
- "name": "isValid",
338
- "description": "Checks if the element is valid.",
339
- "return": {
340
- "type": {
341
- "text": "boolean"
342
- }
343
- }
278
+ "name": "_initializeDefaults"
344
279
  },
345
280
  {
346
281
  "kind": "method",
@@ -349,7 +284,7 @@
349
284
  "parameters": [
350
285
  {
351
286
  "name": "name",
352
- "default": "'auro-combobox'",
287
+ "default": "\"auro-checkbox-group\"",
353
288
  "description": "The name of the element that you want to register.",
354
289
  "optional": true,
355
290
  "type": {
@@ -361,62 +296,24 @@
361
296
  },
362
297
  {
363
298
  "kind": "method",
364
- "name": "activateFirstEnabledAvailableOption",
365
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
366
- "privacy": "private",
367
- "return": {
368
- "type": {
369
- "text": "void"
370
- }
371
- }
372
- },
373
- {
374
- "kind": "method",
375
- "name": "activateLastEnabledAvailableOption",
376
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
377
- "privacy": "private",
378
- "return": {
379
- "type": {
380
- "text": "void"
381
- }
382
- }
383
- },
384
- {
385
- "kind": "method",
386
- "name": "updateFilter",
387
- "description": "Updates the filter for the available options based on the input value.",
388
- "privacy": "private"
389
- },
390
- {
391
- "kind": "method",
392
- "name": "syncValuesAndStates",
393
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
394
- "privacy": "private",
395
- "return": {
396
- "type": {
397
- "text": "void"
398
- }
399
- }
400
- },
401
- {
402
- "kind": "method",
403
- "name": "updateTriggerTextDisplay",
299
+ "name": "handleValueUpdate",
404
300
  "parameters": [
405
301
  {
406
- "name": "label",
407
- "description": "The label of the selected option.",
302
+ "name": "value",
303
+ "description": "The value of the checkbox.",
408
304
  "type": {
409
- "text": "string"
305
+ "text": "String"
306
+ }
307
+ },
308
+ {
309
+ "name": "selected",
310
+ "description": "The checked state of the checkbox.",
311
+ "type": {
312
+ "text": "Boolean"
410
313
  }
411
314
  }
412
315
  ],
413
- "description": "Update displayValue or input.value, it's called when making a selection.",
414
- "privacy": "private"
415
- },
416
- {
417
- "kind": "method",
418
- "name": "handleMenuOptions",
419
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
316
+ "description": "Helper method to handle checkbox value changing.",
420
317
  "privacy": "private",
421
318
  "return": {
422
319
  "type": {
@@ -426,8 +323,8 @@
426
323
  },
427
324
  {
428
325
  "kind": "method",
429
- "name": "generateOptionsArray",
430
- "description": "Determines the element error state based on the `required` attribute and input value.",
326
+ "name": "handlePreselectedItems",
327
+ "description": "Helper method that handles the state of preselected checkboxes.",
431
328
  "privacy": "private",
432
329
  "return": {
433
330
  "type": {
@@ -437,8 +334,9 @@
437
334
  },
438
335
  {
439
336
  "kind": "method",
440
- "name": "hideBib",
441
- "description": "Hides the dropdown bib if its open.",
337
+ "name": "handleItems",
338
+ "description": "Helper method that handles the state of checkboxes.",
339
+ "privacy": "private",
442
340
  "return": {
443
341
  "type": {
444
342
  "text": "void"
@@ -447,8 +345,8 @@
447
345
  },
448
346
  {
449
347
  "kind": "method",
450
- "name": "showBib",
451
- "description": "Shows the dropdown bib if there are options to show.",
348
+ "name": "reset",
349
+ "description": "Resets component to initial state.",
452
350
  "return": {
453
351
  "type": {
454
352
  "text": "void"
@@ -457,554 +355,86 @@
457
355
  },
458
356
  {
459
357
  "kind": "method",
460
- "name": "configureDropdown",
461
- "description": "Binds all behavior needed to the dropdown after rendering.",
462
- "privacy": "private",
463
- "return": {
464
- "type": {
465
- "text": "void"
358
+ "name": "validate",
359
+ "parameters": [
360
+ {
361
+ "name": "force",
362
+ "default": "false",
363
+ "description": "Whether to force validation.",
364
+ "optional": true,
365
+ "type": {
366
+ "text": "boolean"
367
+ }
466
368
  }
467
- }
369
+ ],
370
+ "description": "Validates value."
468
371
  },
469
372
  {
470
- "kind": "method",
471
- "name": "setClearBtnFocus",
472
- "privacy": "private"
373
+ "kind": "field",
374
+ "name": "appearance",
375
+ "privacy": "public",
376
+ "type": {
377
+ "text": "'default' | 'inverse'"
378
+ },
379
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
380
+ "default": "'default'",
381
+ "attribute": "appearance",
382
+ "reflects": true
473
383
  },
474
384
  {
475
- "kind": "method",
476
- "name": "setTriggerInputFocus",
477
- "privacy": "private"
385
+ "kind": "field",
386
+ "name": "disabled",
387
+ "privacy": "public",
388
+ "type": {
389
+ "text": "boolean"
390
+ },
391
+ "description": "If set, disables the checkbox group.",
392
+ "attribute": "disabled",
393
+ "reflects": true
478
394
  },
479
395
  {
480
- "kind": "method",
481
- "name": "setInputFocus",
482
- "privacy": "private"
396
+ "kind": "field",
397
+ "name": "error",
398
+ "privacy": "public",
399
+ "type": {
400
+ "text": "string"
401
+ },
402
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
403
+ "attribute": "error",
404
+ "reflects": true
483
405
  },
484
406
  {
485
- "kind": "method",
486
- "name": "updateBibDialogRole",
487
- "description": "Suppresses or restores dialog semantics on the bib's dialog element.\nOn desktop (non-fullscreen), VoiceOver verbosely announces \"listbox inside\nof a dialog\" which disrupts combobox usage. Setting role=\"presentation\"\nsuppresses this. In fullscreen mode, dialog semantics are restored.",
488
- "privacy": "private"
407
+ "kind": "field",
408
+ "name": "horizontal",
409
+ "privacy": "public",
410
+ "type": {
411
+ "text": "boolean"
412
+ },
413
+ "description": "If set, checkboxes will be aligned horizontally.",
414
+ "attribute": "horizontal",
415
+ "reflects": true
489
416
  },
490
417
  {
491
- "kind": "method",
492
- "name": "updateMenuShapeSize",
493
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
494
- "privacy": "private"
418
+ "kind": "field",
419
+ "name": "noValidate",
420
+ "privacy": "public",
421
+ "type": {
422
+ "text": "boolean"
423
+ },
424
+ "description": "If set, disables auto-validation on blur.",
425
+ "attribute": "noValidate",
426
+ "reflects": true
495
427
  },
496
428
  {
497
- "kind": "method",
498
- "name": "_getAnnouncementRoot",
499
- "description": "Returns the shadow root containing the live region for screen reader announcements.\nWhen the bib is open in fullscreen modal mode, everything outside the <dialog>\nis inert, so we target the bib's own shadow root instead of the host's.",
500
- "privacy": "private",
501
- "return": {
502
- "type": {
503
- "text": "ShadowRoot"
504
- }
505
- }
506
- },
507
- {
508
- "kind": "method",
509
- "name": "configureMenu",
510
- "description": "Binds all behavior needed to the menu after rendering.",
511
- "privacy": "private",
512
- "return": {
513
- "type": {
514
- "text": "void"
515
- }
516
- }
517
- },
518
- {
519
- "kind": "method",
520
- "name": "configureInput",
521
- "description": "Binds all behavior needed to the input after rendering.",
522
- "privacy": "private",
523
- "return": {
524
- "type": {
525
- "text": "void"
526
- }
527
- }
528
- },
529
- {
530
- "kind": "method",
531
- "name": "handleMenuLoadingChange",
532
- "parameters": [
533
- {
534
- "name": "event",
535
- "description": "The event object containing details about the loading state change.",
536
- "type": {
537
- "text": "CustomEvent"
538
- }
539
- },
540
- {
541
- "description": "Indicates whether the menu is currently loading.",
542
- "name": "event.detail.loading",
543
- "type": {
544
- "text": "boolean"
545
- }
546
- },
547
- {
548
- "description": "Indicates if there are loading placeholders present.",
549
- "name": "event.detail.hasLoadingPlaceholder",
550
- "type": {
551
- "text": "boolean"
552
- }
553
- }
554
- ],
555
- "description": "Manages the visibility of the dropdown based on loading state changes.\n\nThis method listens for loading state changes and adjusts the visibility of the dropdown accordingly.\nIf the dropdown is visible and loading is true without any loading placeholders, it hides the dropdown\nand sets a flag to indicate it is hidden while loading. If loading is false and the dropdown was previously\nhidden, it checks if the active element is within the dropdown and shows it again if true.",
556
- "privacy": "private",
557
- "return": {
558
- "type": {
559
- "text": "void"
560
- }
561
- }
562
- },
563
- {
564
- "kind": "method",
565
- "name": "handleInputValueChange",
566
- "parameters": [
567
- {
568
- "name": "event",
569
- "description": "The input event triggered by the input element.",
570
- "type": {
571
- "text": "Event"
572
- }
573
- }
574
- ],
575
- "description": "Handle changes to the input value and trigger changes that should result.",
576
- "privacy": "private",
577
- "return": {
578
- "type": {
579
- "text": "void"
580
- }
581
- }
582
- },
583
- {
584
- "kind": "method",
585
- "name": "configureCombobox",
586
- "description": "Binds all behavior needed to the combobox after rendering.",
587
- "privacy": "private",
588
- "return": {
589
- "type": {
590
- "text": "void"
591
- }
592
- }
593
- },
594
- {
595
- "kind": "method",
596
- "name": "focus",
597
- "description": "Focuses the combobox trigger input.",
598
- "return": {
599
- "type": {
600
- "text": "void"
601
- }
602
- }
603
- },
604
- {
605
- "kind": "method",
606
- "name": "setMenuValue",
607
- "parameters": [
608
- {
609
- "name": "value",
610
- "description": "The value to set on the menu.",
611
- "type": {
612
- "text": "string"
613
- }
614
- }
615
- ],
616
- "description": "Sets the menu value if menu is available.",
617
- "return": {
618
- "type": {
619
- "text": "void"
620
- }
621
- }
622
- },
623
- {
624
- "kind": "method",
625
- "name": "reset",
626
- "description": "Resets component to initial state.",
627
- "return": {
628
- "type": {
629
- "text": "void"
630
- }
631
- }
632
- },
633
- {
634
- "kind": "method",
635
- "name": "clear",
636
- "description": "Clears the current value of the combobox.",
637
- "return": {
638
- "type": {
639
- "text": "void"
640
- }
641
- }
642
- },
643
- {
644
- "kind": "method",
645
- "name": "validate",
646
- "parameters": [
647
- {
648
- "name": "force",
649
- "default": "false",
650
- "description": "Whether to force validation.",
651
- "optional": true,
652
- "type": {
653
- "text": "boolean"
654
- }
655
- }
656
- ],
657
- "description": "Validates value."
658
- },
659
- {
660
- "kind": "method",
661
- "name": "transportAssignedNodes",
662
- "parameters": [
663
- {
664
- "name": "slot",
665
- "description": "The slot element containing the nodes to apply.",
666
- "type": {
667
- "text": "HTMLSlotElement"
668
- }
669
- },
670
- {
671
- "name": "target",
672
- "description": "The target element to apply the nodes to.",
673
- "type": {
674
- "text": "HTMLElement"
675
- }
676
- },
677
- {
678
- "name": "newSlotName",
679
- "description": "The new slot name for the applied nodes.",
680
- "type": {
681
- "text": "string"
682
- }
683
- }
684
- ],
685
- "description": "Applies slotted nodes to a target element with a new slot name.",
686
- "privacy": "private",
687
- "return": {
688
- "type": {
689
- "text": "void"
690
- }
691
- }
692
- },
693
- {
694
- "kind": "method",
695
- "name": "updateActiveOption",
696
- "parameters": [
697
- {
698
- "name": "index",
699
- "description": "Index of the option to make active.",
700
- "type": {
701
- "text": "number"
702
- }
703
- }
704
- ],
705
- "description": "Updates the active option in the menu."
706
- },
707
- {
708
- "kind": "method",
709
- "name": "handleSlotChange",
710
- "parameters": [
711
- {
712
- "name": "event",
713
- "description": "`slotchange` event.",
714
- "type": {
715
- "text": "Event"
716
- }
717
- }
718
- ],
719
- "description": "Watch for slot changes and recalculate the menuoptions.",
720
- "privacy": "private",
721
- "return": {
722
- "type": {
723
- "text": "void"
724
- }
725
- }
726
- },
727
- {
728
- "kind": "field",
729
- "name": "appearance",
730
- "privacy": "public",
731
- "type": {
732
- "text": "string"
733
- },
734
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
735
- "default": "'default'",
736
- "attribute": "appearance",
737
- "reflects": true
738
- },
739
- {
740
- "kind": "field",
741
- "name": "autocomplete",
742
- "privacy": "public",
743
- "type": {
744
- "text": "string"
745
- },
746
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
747
- "attribute": "autocomplete",
748
- "reflects": true
749
- },
750
- {
751
- "kind": "field",
752
- "name": "autoPlacement",
753
- "privacy": "public",
754
- "type": {
755
- "text": "boolean"
756
- },
757
- "description": "If declared, bib's position will be automatically calculated where to appear.",
758
- "attribute": "autoPlacement",
759
- "reflects": true
760
- },
761
- {
762
- "kind": "field",
763
- "name": "availableOptions",
764
- "privacy": "private",
765
- "type": {
766
- "text": "array"
767
- },
768
- "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
769
- "attribute": "availableOptions"
770
- },
771
- {
772
- "kind": "field",
773
- "name": "behavior",
774
- "privacy": "public",
775
- "type": {
776
- "text": "'filter' | 'suggestion'"
777
- },
778
- "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
779
- "default": "'suggestion'",
780
- "attribute": "behavior",
781
- "reflects": true
782
- },
783
- {
784
- "kind": "field",
785
- "name": "checkmark",
786
- "privacy": "public",
787
- "type": {
788
- "text": "boolean"
789
- },
790
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
791
- "attribute": "checkmark",
792
- "reflects": true
793
- },
794
- {
795
- "kind": "field",
796
- "name": "disabled",
797
- "privacy": "public",
798
- "type": {
799
- "text": "boolean"
800
- },
801
- "description": "If set, disables the combobox.",
802
- "attribute": "disabled",
803
- "reflects": true
804
- },
805
- {
806
- "kind": "field",
807
- "name": "dropdownId",
808
- "privacy": "private",
809
- "type": {
810
- "text": "string"
811
- },
812
- "description": "ID for the dropdown."
813
- },
814
- {
815
- "kind": "field",
816
- "name": "dropdownOpen",
817
- "privacy": "private",
818
- "type": {
819
- "text": "boolean"
820
- },
821
- "description": "Whether or not the dropdown is open."
822
- },
823
- {
824
- "kind": "field",
825
- "name": "dvInputOnly",
826
- "privacy": "public",
827
- "type": {
828
- "text": "boolean"
829
- },
830
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
831
- "attribute": "dvInputOnly",
832
- "reflects": true
833
- },
834
- {
835
- "kind": "field",
836
- "name": "error",
837
- "privacy": "public",
838
- "type": {
839
- "text": "string"
840
- },
841
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
842
- "attribute": "error",
843
- "reflects": true
844
- },
845
- {
846
- "kind": "field",
847
- "name": "format",
848
- "privacy": "public",
849
- "type": {
850
- "text": "string"
851
- },
852
- "description": "Specifies the input mask format.",
853
- "attribute": "format",
854
- "reflects": true
855
- },
856
- {
857
- "kind": "field",
858
- "name": "inputmode",
859
- "privacy": "public",
860
- "type": {
861
- "text": "string"
862
- },
863
- "description": "Exposes inputmode attribute for input.",
864
- "attribute": "inputmode",
865
- "reflects": true
866
- },
867
- {
868
- "kind": "field",
869
- "name": "layout",
870
- "privacy": "public",
871
- "type": {
872
- "text": "string"
873
- },
874
- "description": "Sets the layout of the combobox.",
875
- "default": "'classic'",
876
- "attribute": "layout",
877
- "reflects": true,
878
- "inheritedFrom": {
879
- "name": "AuroElement",
880
- "module": "components/layoutElement/src/auroElement.js"
881
- }
882
- },
883
- {
884
- "kind": "field",
885
- "name": "matchWidth",
886
- "privacy": "private",
887
- "type": {
888
- "text": "boolean"
889
- },
890
- "description": "If declared, the popover and trigger will be set to the same width.",
891
- "attribute": "matchWidth",
892
- "reflects": true
893
- },
894
- {
895
- "kind": "field",
896
- "name": "noFilter",
897
- "privacy": "public",
898
- "type": {
899
- "text": "boolean"
900
- },
901
- "description": "If set, combobox will not filter menuoptions based on input.",
902
- "attribute": "noFilter",
903
- "reflects": true
904
- },
905
- {
906
- "kind": "field",
907
- "name": "noFlip",
908
- "privacy": "public",
909
- "type": {
910
- "text": "boolean"
911
- },
912
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
913
- "attribute": "noFlip",
914
- "reflects": true
915
- },
916
- {
917
- "kind": "field",
918
- "name": "shift",
919
- "privacy": "public",
920
- "type": {
921
- "text": "boolean"
922
- },
923
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
924
- "attribute": "shift",
925
- "reflects": true
926
- },
927
- {
928
- "kind": "field",
929
- "name": "noValidate",
930
- "privacy": "public",
931
- "type": {
932
- "text": "boolean"
933
- },
934
- "description": "If set, disables auto-validation on blur.",
935
- "attribute": "noValidate",
936
- "reflects": true
937
- },
938
- {
939
- "kind": "field",
940
- "name": "offset",
941
- "privacy": "public",
942
- "type": {
943
- "text": "number"
944
- },
945
- "description": "Gap between the trigger element and bib.",
946
- "default": "0",
947
- "attribute": "offset",
948
- "reflects": true
949
- },
950
- {
951
- "kind": "field",
952
- "name": "onDark",
953
- "privacy": "public",
954
- "type": {
955
- "text": "boolean"
956
- },
957
- "attribute": "onDark",
958
- "reflects": true,
959
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
960
- "inheritedFrom": {
961
- "name": "AuroElement",
962
- "module": "components/layoutElement/src/auroElement.js"
963
- }
964
- },
965
- {
966
- "kind": "field",
967
- "name": "optionSelected",
968
- "privacy": "public",
969
- "type": {
970
- "text": "HTMLElement"
971
- },
972
- "description": "Specifies the current selected option.",
973
- "attribute": "optionSelected"
974
- },
975
- {
976
- "kind": "field",
977
- "name": "persistInput",
978
- "privacy": "public",
979
- "type": {
980
- "text": "boolean"
981
- },
982
- "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
983
- "attribute": "persistInput",
984
- "reflects": true
985
- },
986
- {
987
- "kind": "field",
988
- "name": "placement",
989
- "privacy": "public",
990
- "type": {
991
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
992
- },
993
- "description": "Position where the bib should appear relative to the trigger.",
994
- "default": "'bottom-start'",
995
- "attribute": "placement",
996
- "reflects": true
997
- },
998
- {
999
- "kind": "field",
1000
- "name": "placeholder",
1001
- "privacy": "public",
1002
- "type": {
1003
- "text": "string"
1004
- },
1005
- "description": "Define custom placeholder text, only supported by date input formats.",
1006
- "attribute": "placeholder",
1007
- "reflects": true
429
+ "kind": "field",
430
+ "name": "onDark",
431
+ "privacy": "public",
432
+ "type": {
433
+ "text": "boolean"
434
+ },
435
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
436
+ "attribute": "onDark",
437
+ "reflects": true
1008
438
  },
1009
439
  {
1010
440
  "kind": "field",
@@ -1013,7 +443,7 @@
1013
443
  "type": {
1014
444
  "text": "boolean"
1015
445
  },
1016
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
446
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1017
447
  "attribute": "required",
1018
448
  "reflects": true
1019
449
  },
@@ -1047,58 +477,6 @@
1047
477
  "description": "Custom help text message to display when validity = `valueMissing`.",
1048
478
  "attribute": "setCustomValidityValueMissing"
1049
479
  },
1050
- {
1051
- "kind": "field",
1052
- "name": "setCustomValidityValueMissingFilter",
1053
- "privacy": "public",
1054
- "type": {
1055
- "text": "string"
1056
- },
1057
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1058
- "attribute": "setCustomValidityValueMissingFilter"
1059
- },
1060
- {
1061
- "kind": "field",
1062
- "name": "touched",
1063
- "privacy": "private",
1064
- "type": {
1065
- "text": "boolean"
1066
- },
1067
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1068
- },
1069
- {
1070
- "kind": "field",
1071
- "name": "triggerIcon",
1072
- "privacy": "public",
1073
- "type": {
1074
- "text": "boolean"
1075
- },
1076
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1077
- "attribute": "triggerIcon",
1078
- "reflects": true
1079
- },
1080
- {
1081
- "kind": "field",
1082
- "name": "type",
1083
- "privacy": "public",
1084
- "type": {
1085
- "text": "string"
1086
- },
1087
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1088
- "attribute": "type",
1089
- "reflects": true
1090
- },
1091
- {
1092
- "kind": "field",
1093
- "name": "typedValue",
1094
- "privacy": "public",
1095
- "type": {
1096
- "text": "string"
1097
- },
1098
- "description": "Specifies the value of the input element within the combobox.",
1099
- "attribute": "typedValue",
1100
- "reflects": true
1101
- },
1102
480
  {
1103
481
  "kind": "field",
1104
482
  "name": "validity",
@@ -1109,620 +487,896 @@
1109
487
  "description": "Specifies the `validityState` this element is in.",
1110
488
  "attribute": "validity",
1111
489
  "reflects": true
1112
- },
1113
- {
1114
- "kind": "field",
1115
- "name": "value",
1116
- "privacy": "public",
1117
- "type": {
1118
- "text": "string"
1119
- },
1120
- "description": "Value selected for the dropdown menu.",
1121
- "attribute": "value"
1122
- },
490
+ }
491
+ ],
492
+ "events": [
1123
493
  {
1124
- "kind": "field",
1125
- "name": "largeFullscreenHeadline",
1126
- "privacy": "public",
494
+ "name": "input",
1127
495
  "type": {
1128
- "text": "boolean"
1129
- },
1130
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1131
- "attribute": "largeFullscreenHeadline",
1132
- "reflects": true
496
+ "text": "CustomEvent"
497
+ }
1133
498
  },
1134
499
  {
1135
- "kind": "field",
1136
- "name": "fullscreenBreakpoint",
1137
- "privacy": "public",
1138
- "type": {
1139
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1140
- },
1141
- "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
1142
- "default": "'sm'",
1143
- "attribute": "fullscreenBreakpoint",
1144
- "reflects": true
1145
- },
500
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
501
+ "name": "auroFormElement-validated"
502
+ }
503
+ ],
504
+ "attributes": [
1146
505
  {
1147
- "kind": "field",
1148
- "name": "optionActive",
1149
- "privacy": "private",
506
+ "name": "appearance",
1150
507
  "type": {
1151
- "text": "object"
508
+ "text": "'default' | 'inverse'"
1152
509
  },
1153
- "description": "Specifies the currently active option."
510
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
511
+ "default": "'default'",
512
+ "fieldName": "appearance"
1154
513
  },
1155
514
  {
1156
- "kind": "field",
1157
- "name": "triggerExpandedState",
1158
- "privacy": "private",
515
+ "name": "disabled",
1159
516
  "type": {
1160
517
  "text": "boolean"
1161
518
  },
1162
- "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1163
- },
1164
- {
1165
- "kind": "field",
1166
- "name": "componentHasFocus",
1167
- "description": "Returns true if the element has focus.",
1168
- "privacy": "private",
1169
- "return": {
1170
- "type": {
1171
- "text": "boolean"
1172
- }
1173
- },
1174
- "readonly": true,
1175
- "inheritedFrom": {
1176
- "name": "AuroElement",
1177
- "module": "components/layoutElement/src/auroElement.js"
1178
- }
1179
- },
1180
- {
1181
- "kind": "method",
1182
- "name": "resetShapeClasses",
1183
- "inheritedFrom": {
1184
- "name": "AuroElement",
1185
- "module": "components/layoutElement/src/auroElement.js"
1186
- }
1187
- },
1188
- {
1189
- "kind": "method",
1190
- "name": "resetLayoutClasses",
1191
- "inheritedFrom": {
1192
- "name": "AuroElement",
1193
- "module": "components/layoutElement/src/auroElement.js"
1194
- }
1195
- },
1196
- {
1197
- "kind": "method",
1198
- "name": "updateComponentArchitecture",
1199
- "inheritedFrom": {
1200
- "name": "AuroElement",
1201
- "module": "components/layoutElement/src/auroElement.js"
1202
- }
1203
- },
1204
- {
1205
- "kind": "field",
1206
- "name": "shape",
1207
- "privacy": "public",
1208
- "type": {
1209
- "text": "string"
1210
- },
1211
- "attribute": "shape",
1212
- "reflects": true,
1213
- "inheritedFrom": {
1214
- "name": "AuroElement",
1215
- "module": "components/layoutElement/src/auroElement.js"
1216
- }
519
+ "description": "If set, disables the checkbox group.",
520
+ "fieldName": "disabled"
1217
521
  },
1218
522
  {
1219
- "kind": "field",
1220
- "name": "size",
1221
- "privacy": "public",
523
+ "name": "error",
1222
524
  "type": {
1223
525
  "text": "string"
1224
526
  },
1225
- "attribute": "size",
1226
- "reflects": true,
1227
- "inheritedFrom": {
1228
- "name": "AuroElement",
1229
- "module": "components/layoutElement/src/auroElement.js"
1230
- }
1231
- }
1232
- ],
1233
- "events": [
527
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
528
+ "fieldName": "error"
529
+ },
1234
530
  {
1235
- "name": "inputValue",
531
+ "name": "horizontal",
1236
532
  "type": {
1237
- "text": "CustomEvent"
533
+ "text": "boolean"
1238
534
  },
1239
- "description": "Notifies that the components internal HTML5 input value has changed."
535
+ "description": "If set, checkboxes will be aligned horizontally.",
536
+ "fieldName": "horizontal"
1240
537
  },
1241
538
  {
1242
- "name": "input",
539
+ "name": "noValidate",
1243
540
  "type": {
1244
- "text": "CustomEvent"
541
+ "text": "boolean"
1245
542
  },
1246
- "description": "Notifies that the component has a new value set."
543
+ "description": "If set, disables auto-validation on blur.",
544
+ "fieldName": "noValidate"
1247
545
  },
1248
546
  {
1249
- "name": "auroCombobox-valueSet",
547
+ "name": "onDark",
1250
548
  "type": {
1251
- "text": "CustomEvent"
549
+ "text": "boolean"
1252
550
  },
1253
- "description": "(Deprecated) Notifies that the component has a new value set."
551
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
552
+ "fieldName": "onDark"
1254
553
  },
1255
554
  {
1256
- "description": "Notifies that the component value(s) have been validated.",
1257
- "name": "auroFormElement-validated"
1258
- }
1259
- ],
1260
- "attributes": [
1261
- {
1262
- "name": "appearance",
555
+ "name": "required",
1263
556
  "type": {
1264
- "text": "string"
557
+ "text": "boolean"
1265
558
  },
1266
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1267
- "default": "'default'",
1268
- "fieldName": "appearance"
559
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
560
+ "fieldName": "required"
1269
561
  },
1270
562
  {
1271
- "name": "autocomplete",
563
+ "name": "setCustomValidity",
1272
564
  "type": {
1273
565
  "text": "string"
1274
566
  },
1275
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1276
- "fieldName": "autocomplete"
567
+ "description": "Sets a custom help text message to display for all validityStates.",
568
+ "fieldName": "setCustomValidity"
1277
569
  },
1278
570
  {
1279
- "name": "autoPlacement",
571
+ "name": "setCustomValidityCustomError",
1280
572
  "type": {
1281
- "text": "boolean"
573
+ "text": "string"
1282
574
  },
1283
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1284
- "fieldName": "autoPlacement"
575
+ "description": "Custom help text message to display when validity = `customError`.",
576
+ "fieldName": "setCustomValidityCustomError"
1285
577
  },
1286
578
  {
1287
- "name": "availableOptions",
579
+ "name": "setCustomValidityValueMissing",
1288
580
  "type": {
1289
- "text": "array"
581
+ "text": "string"
1290
582
  },
1291
- "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
1292
- "fieldName": "availableOptions"
583
+ "description": "Custom help text message to display when validity = `valueMissing`.",
584
+ "fieldName": "setCustomValidityValueMissing"
1293
585
  },
1294
586
  {
1295
- "name": "behavior",
587
+ "name": "validity",
1296
588
  "type": {
1297
- "text": "'filter' | 'suggestion'"
589
+ "text": "string"
1298
590
  },
1299
- "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
1300
- "default": "'suggestion'",
1301
- "fieldName": "behavior"
591
+ "description": "Specifies the `validityState` this element is in.",
592
+ "fieldName": "validity"
593
+ }
594
+ ],
595
+ "superclass": {
596
+ "name": "LitElement",
597
+ "package": "lit"
598
+ },
599
+ "tagName": "auro-checkbox-group",
600
+ "customElement": true
601
+ }
602
+ ],
603
+ "exports": [
604
+ {
605
+ "kind": "js",
606
+ "name": "AuroCheckboxGroup",
607
+ "declaration": {
608
+ "name": "AuroCheckboxGroup",
609
+ "module": "components/checkbox/src/auro-checkbox-group.js"
610
+ }
611
+ }
612
+ ]
613
+ },
614
+ {
615
+ "kind": "javascript-module",
616
+ "path": "components/checkbox/src/auro-checkbox.js",
617
+ "declarations": [
618
+ {
619
+ "kind": "class",
620
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
621
+ "name": "AuroCheckbox",
622
+ "cssParts": [
623
+ {
624
+ "description": "apply css to a specific checkbox.",
625
+ "name": "checkbox"
626
+ },
627
+ {
628
+ "description": "apply css to a specific checkbox's input.",
629
+ "name": "checkbox-input"
630
+ },
631
+ {
632
+ "description": "apply css to a specific checkbox's label.",
633
+ "name": "checkbox-label"
634
+ }
635
+ ],
636
+ "slots": [
637
+ {
638
+ "description": "The default slot for the checkbox label.",
639
+ "name": "default"
640
+ }
641
+ ],
642
+ "members": [
643
+ {
644
+ "kind": "method",
645
+ "name": "_initializeDefaults"
646
+ },
647
+ {
648
+ "kind": "method",
649
+ "name": "register",
650
+ "static": true,
651
+ "parameters": [
652
+ {
653
+ "name": "name",
654
+ "default": "\"auro-checkbox\"",
655
+ "description": "The name of element that you want to register to.",
656
+ "optional": true,
657
+ "type": {
658
+ "text": "string"
659
+ }
660
+ }
661
+ ],
662
+ "description": "This will register this element with the browser."
663
+ },
664
+ {
665
+ "kind": "method",
666
+ "name": "handleChange",
667
+ "parameters": [
668
+ {
669
+ "name": "event",
670
+ "description": "The change event from the checkbox input.",
671
+ "type": {
672
+ "text": "Event"
673
+ }
674
+ }
675
+ ],
676
+ "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.",
677
+ "privacy": "private",
678
+ "return": {
679
+ "type": {
680
+ "text": "void"
681
+ }
682
+ }
683
+ },
684
+ {
685
+ "kind": "method",
686
+ "name": "handleInput",
687
+ "parameters": [
688
+ {
689
+ "name": "event",
690
+ "description": "The input event from the checkbox input.",
691
+ "type": {
692
+ "text": "Event"
693
+ }
694
+ }
695
+ ],
696
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
697
+ "privacy": "private",
698
+ "return": {
699
+ "type": {
700
+ "text": "void"
701
+ }
702
+ }
703
+ },
704
+ {
705
+ "kind": "method",
706
+ "name": "handleFocusin",
707
+ "description": "Function to support",
708
+ "privacy": "private",
709
+ "return": {
710
+ "type": {
711
+ "text": "void"
712
+ }
713
+ }
714
+ },
715
+ {
716
+ "kind": "method",
717
+ "name": "generateIconHtml",
718
+ "description": "Function to generate checkmark svg.",
719
+ "privacy": "private",
720
+ "return": {
721
+ "type": {
722
+ "text": "HTMLElement"
723
+ }
724
+ }
725
+ },
726
+ {
727
+ "kind": "method",
728
+ "name": "reset",
729
+ "description": "Resets component to initial state.",
730
+ "return": {
731
+ "type": {
732
+ "text": "void"
733
+ }
734
+ }
735
+ },
736
+ {
737
+ "kind": "method",
738
+ "name": "updateAriaLabel",
739
+ "description": "Updates the aria-label based on slot content.",
740
+ "privacy": "private",
741
+ "return": {
742
+ "type": {
743
+ "text": "void"
744
+ }
745
+ }
746
+ },
747
+ {
748
+ "kind": "method",
749
+ "name": "handleKeyDown",
750
+ "parameters": [
751
+ {
752
+ "name": "event",
753
+ "description": "The keydown event from the checkbox input.",
754
+ "type": {
755
+ "text": "KeyboardEvent"
756
+ }
757
+ }
758
+ ],
759
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
760
+ "privacy": "private",
761
+ "return": {
762
+ "type": {
763
+ "text": "void"
764
+ }
765
+ }
1302
766
  },
1303
767
  {
1304
- "name": "checkmark",
768
+ "kind": "field",
769
+ "name": "appearance",
770
+ "privacy": "public",
1305
771
  "type": {
1306
- "text": "boolean"
772
+ "text": "'default' | 'inverse'"
1307
773
  },
1308
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1309
- "fieldName": "checkmark"
774
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
775
+ "default": "'default'",
776
+ "attribute": "appearance",
777
+ "reflects": true
1310
778
  },
1311
779
  {
1312
- "name": "disabled",
780
+ "kind": "field",
781
+ "name": "checked",
782
+ "privacy": "public",
1313
783
  "type": {
1314
784
  "text": "boolean"
1315
785
  },
1316
- "description": "If set, disables the combobox.",
1317
- "fieldName": "disabled"
786
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
787
+ "attribute": "checked",
788
+ "reflects": true
1318
789
  },
1319
790
  {
1320
- "name": "dvInputOnly",
791
+ "kind": "field",
792
+ "name": "disabled",
793
+ "privacy": "public",
1321
794
  "type": {
1322
795
  "text": "boolean"
1323
796
  },
1324
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1325
- "fieldName": "dvInputOnly"
797
+ "description": "If set to true, the checkbox will not be clickable.",
798
+ "attribute": "disabled",
799
+ "reflects": true
1326
800
  },
1327
801
  {
802
+ "kind": "field",
1328
803
  "name": "error",
804
+ "privacy": "public",
1329
805
  "type": {
1330
- "text": "string"
806
+ "text": "boolean"
1331
807
  },
1332
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1333
- "fieldName": "error"
808
+ "description": "If set to true, the checkbox will be displayed with an error state.",
809
+ "attribute": "error",
810
+ "reflects": true
1334
811
  },
1335
812
  {
1336
- "name": "format",
813
+ "kind": "field",
814
+ "name": "id",
815
+ "privacy": "public",
1337
816
  "type": {
1338
817
  "text": "string"
1339
818
  },
1340
- "description": "Specifies the input mask format.",
1341
- "fieldName": "format"
819
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
820
+ "attribute": "id",
821
+ "reflects": true
1342
822
  },
1343
823
  {
1344
- "name": "inputmode",
824
+ "kind": "field",
825
+ "name": "inputId",
826
+ "privacy": "private",
1345
827
  "type": {
1346
828
  "text": "string"
1347
829
  },
1348
- "description": "Exposes inputmode attribute for input.",
1349
- "fieldName": "inputmode"
830
+ "description": "The id for input node."
1350
831
  },
1351
832
  {
1352
- "name": "layout",
833
+ "kind": "field",
834
+ "name": "name",
835
+ "privacy": "public",
1353
836
  "type": {
1354
837
  "text": "string"
1355
838
  },
1356
- "description": "Sets the layout of the combobox.",
1357
- "default": "'classic'",
1358
- "fieldName": "layout",
1359
- "inheritedFrom": {
1360
- "name": "AuroElement",
1361
- "module": "components/layoutElement/src/auroElement.js"
1362
- }
1363
- },
1364
- {
1365
- "name": "matchWidth",
1366
- "type": {
1367
- "text": "boolean"
1368
- },
1369
- "description": "If declared, the popover and trigger will be set to the same width.",
1370
- "fieldName": "matchWidth"
1371
- },
1372
- {
1373
- "name": "noFilter",
1374
- "type": {
1375
- "text": "boolean"
1376
- },
1377
- "description": "If set, combobox will not filter menuoptions based on input.",
1378
- "fieldName": "noFilter"
839
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
840
+ "attribute": "name"
1379
841
  },
1380
842
  {
1381
- "name": "noFlip",
843
+ "kind": "field",
844
+ "name": "onDark",
845
+ "privacy": "public",
1382
846
  "type": {
1383
847
  "text": "boolean"
1384
848
  },
1385
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1386
- "fieldName": "noFlip"
849
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
850
+ "attribute": "onDark",
851
+ "reflects": true
1387
852
  },
1388
853
  {
1389
- "name": "shift",
854
+ "kind": "field",
855
+ "name": "touched",
856
+ "privacy": "private",
1390
857
  "type": {
1391
858
  "text": "boolean"
1392
859
  },
1393
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1394
- "fieldName": "shift"
860
+ "description": "Indicates whether the checkbox has been interacted with."
1395
861
  },
1396
862
  {
1397
- "name": "noValidate",
863
+ "kind": "field",
864
+ "name": "value",
865
+ "privacy": "public",
1398
866
  "type": {
1399
- "text": "boolean"
867
+ "text": "string"
1400
868
  },
1401
- "description": "If set, disables auto-validation on blur.",
1402
- "fieldName": "noValidate"
869
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
870
+ "attribute": "value"
1403
871
  },
1404
872
  {
1405
- "name": "offset",
873
+ "kind": "field",
874
+ "name": "tabIndex",
875
+ "privacy": "private",
1406
876
  "type": {
1407
877
  "text": "number"
1408
878
  },
1409
- "description": "Gap between the trigger element and bib.",
1410
- "default": "0",
1411
- "fieldName": "offset"
879
+ "description": "The tabindex attribute for the checkbox.",
880
+ "attribute": "tabindex",
881
+ "reflects": true
1412
882
  },
1413
883
  {
1414
- "name": "onDark",
884
+ "kind": "field",
885
+ "name": "ariaChecked",
886
+ "privacy": "private",
1415
887
  "type": {
1416
- "text": "boolean"
888
+ "text": "string"
1417
889
  },
1418
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1419
- "fieldName": "onDark"
890
+ "description": "The aria-checked attribute for the checkbox.",
891
+ "attribute": "aria-checked",
892
+ "reflects": true
1420
893
  },
1421
894
  {
1422
- "name": "optionSelected",
895
+ "kind": "field",
896
+ "name": "ariaDisabled",
897
+ "privacy": "private",
1423
898
  "type": {
1424
- "text": "HTMLElement"
899
+ "text": "string"
1425
900
  },
1426
- "description": "Specifies the current selected option.",
1427
- "fieldName": "optionSelected"
901
+ "description": "The aria-disabled attribute for the checkbox.",
902
+ "attribute": "aria-disabled",
903
+ "reflects": true
1428
904
  },
1429
905
  {
1430
- "name": "persistInput",
906
+ "kind": "field",
907
+ "name": "role",
908
+ "privacy": "private",
1431
909
  "type": {
1432
- "text": "boolean"
910
+ "text": "string"
1433
911
  },
1434
- "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
1435
- "fieldName": "persistInput"
1436
- },
912
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
913
+ "attribute": "role",
914
+ "reflects": true
915
+ }
916
+ ],
917
+ "events": [
1437
918
  {
1438
- "name": "placement",
919
+ "name": "auroCheckbox-input",
1439
920
  "type": {
1440
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1441
- },
1442
- "description": "Position where the bib should appear relative to the trigger.",
1443
- "default": "'bottom-start'",
1444
- "fieldName": "placement"
921
+ "text": "CustomEvent"
922
+ }
1445
923
  },
1446
924
  {
1447
- "name": "placeholder",
925
+ "name": "auroCheckbox-focusin",
1448
926
  "type": {
1449
- "text": "string"
1450
- },
1451
- "description": "Define custom placeholder text, only supported by date input formats.",
1452
- "fieldName": "placeholder"
927
+ "text": "CustomEvent"
928
+ }
1453
929
  },
1454
930
  {
1455
- "name": "required",
931
+ "name": "auroCheckbox-focusout",
1456
932
  "type": {
1457
- "text": "boolean"
1458
- },
1459
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1460
- "fieldName": "required"
933
+ "text": "CustomEvent"
934
+ }
1461
935
  },
1462
936
  {
1463
- "name": "setCustomValidity",
1464
- "type": {
1465
- "text": "string"
1466
- },
1467
- "description": "Sets a custom help text message to display for all validityStates.",
1468
- "fieldName": "setCustomValidity"
937
+ "description": "(Deprecated) Notifies when checked value is changed.",
938
+ "name": "change"
1469
939
  },
1470
940
  {
1471
- "name": "setCustomValidityCustomError",
1472
- "type": {
1473
- "text": "string"
1474
- },
1475
- "description": "Custom help text message to display when validity = `customError`.",
1476
- "fieldName": "setCustomValidityCustomError"
1477
- },
941
+ "description": "Notifies when when checked value is changed by user's interface.",
942
+ "name": "input"
943
+ }
944
+ ],
945
+ "attributes": [
1478
946
  {
1479
- "name": "setCustomValidityValueMissing",
947
+ "name": "appearance",
1480
948
  "type": {
1481
- "text": "string"
949
+ "text": "'default' | 'inverse'"
1482
950
  },
1483
- "description": "Custom help text message to display when validity = `valueMissing`.",
1484
- "fieldName": "setCustomValidityValueMissing"
951
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
952
+ "default": "'default'",
953
+ "fieldName": "appearance"
1485
954
  },
1486
955
  {
1487
- "name": "setCustomValidityValueMissingFilter",
956
+ "name": "checked",
1488
957
  "type": {
1489
- "text": "string"
958
+ "text": "boolean"
1490
959
  },
1491
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1492
- "fieldName": "setCustomValidityValueMissingFilter"
960
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
961
+ "fieldName": "checked"
1493
962
  },
1494
963
  {
1495
- "name": "triggerIcon",
964
+ "name": "disabled",
1496
965
  "type": {
1497
966
  "text": "boolean"
1498
967
  },
1499
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1500
- "fieldName": "triggerIcon"
968
+ "description": "If set to true, the checkbox will not be clickable.",
969
+ "fieldName": "disabled"
1501
970
  },
1502
971
  {
1503
- "name": "type",
972
+ "name": "error",
1504
973
  "type": {
1505
- "text": "string"
974
+ "text": "boolean"
1506
975
  },
1507
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1508
- "fieldName": "type"
976
+ "description": "If set to true, the checkbox will be displayed with an error state.",
977
+ "fieldName": "error"
1509
978
  },
1510
979
  {
1511
- "name": "typedValue",
980
+ "name": "id",
1512
981
  "type": {
1513
982
  "text": "string"
1514
983
  },
1515
- "description": "Specifies the value of the input element within the combobox.",
1516
- "fieldName": "typedValue"
984
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
985
+ "fieldName": "id"
1517
986
  },
1518
987
  {
1519
- "name": "validity",
988
+ "name": "name",
1520
989
  "type": {
1521
990
  "text": "string"
1522
991
  },
1523
- "description": "Specifies the `validityState` this element is in.",
1524
- "fieldName": "validity"
992
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
993
+ "fieldName": "name"
1525
994
  },
1526
995
  {
1527
- "name": "value",
996
+ "name": "onDark",
1528
997
  "type": {
1529
- "text": "string"
998
+ "text": "boolean"
1530
999
  },
1531
- "description": "Value selected for the dropdown menu.",
1532
- "fieldName": "value"
1000
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1001
+ "fieldName": "onDark"
1533
1002
  },
1534
1003
  {
1535
- "name": "largeFullscreenHeadline",
1004
+ "name": "value",
1536
1005
  "type": {
1537
- "text": "boolean"
1006
+ "text": "string"
1538
1007
  },
1539
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1540
- "fieldName": "largeFullscreenHeadline"
1008
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1009
+ "fieldName": "value"
1541
1010
  },
1542
1011
  {
1543
- "name": "fullscreenBreakpoint",
1012
+ "name": "tabindex",
1544
1013
  "type": {
1545
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1014
+ "text": "number"
1546
1015
  },
1547
- "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
1548
- "default": "'sm'",
1549
- "fieldName": "fullscreenBreakpoint"
1016
+ "description": "The tabindex attribute for the checkbox.",
1017
+ "fieldName": "tabIndex"
1550
1018
  },
1551
1019
  {
1552
- "name": "shape",
1020
+ "name": "aria-checked",
1553
1021
  "type": {
1554
1022
  "text": "string"
1555
1023
  },
1556
- "fieldName": "shape",
1557
- "inheritedFrom": {
1558
- "name": "AuroElement",
1559
- "module": "components/layoutElement/src/auroElement.js"
1560
- }
1024
+ "description": "The aria-checked attribute for the checkbox.",
1025
+ "fieldName": "ariaChecked"
1561
1026
  },
1562
1027
  {
1563
- "name": "size",
1028
+ "name": "aria-disabled",
1564
1029
  "type": {
1565
1030
  "text": "string"
1566
1031
  },
1567
- "fieldName": "size",
1568
- "inheritedFrom": {
1569
- "name": "AuroElement",
1570
- "module": "components/layoutElement/src/auroElement.js"
1571
- }
1032
+ "description": "The aria-disabled attribute for the checkbox.",
1033
+ "fieldName": "ariaDisabled"
1572
1034
  },
1573
1035
  {
1574
- "name": "ondark",
1036
+ "name": "role",
1575
1037
  "type": {
1576
- "text": "boolean"
1038
+ "text": "string"
1577
1039
  },
1578
- "fieldName": "onDark",
1579
- "inheritedFrom": {
1580
- "name": "AuroElement",
1581
- "module": "components/layoutElement/src/auroElement.js"
1582
- }
1040
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
1041
+ "fieldName": "role"
1583
1042
  }
1584
1043
  ],
1585
1044
  "superclass": {
1586
- "name": "AuroElement",
1587
- "module": "/components/layoutElement/src/auroElement.js"
1045
+ "name": "LitElement",
1046
+ "package": "lit"
1588
1047
  },
1589
- "tagName": "auro-combobox",
1048
+ "tagName": "auro-checkbox",
1590
1049
  "customElement": true
1591
1050
  }
1592
1051
  ],
1593
1052
  "exports": [
1594
1053
  {
1595
1054
  "kind": "js",
1596
- "name": "AuroCombobox",
1055
+ "name": "AuroCheckbox",
1597
1056
  "declaration": {
1598
- "name": "AuroCombobox",
1599
- "module": "components/combobox/src/auro-combobox.js"
1057
+ "name": "AuroCheckbox",
1058
+ "module": "components/checkbox/src/auro-checkbox.js"
1600
1059
  }
1601
1060
  }
1602
1061
  ]
1603
1062
  },
1604
1063
  {
1605
1064
  "kind": "javascript-module",
1606
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1607
- "declarations": [
1608
- {
1609
- "kind": "variable",
1610
- "name": "comboboxKeyboardStrategy",
1611
- "type": {
1612
- "text": "object"
1613
- },
1614
- "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { navigateArrow(component, 'down'); } } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
1615
- }
1616
- ],
1065
+ "path": "components/checkbox/src/index.js",
1066
+ "declarations": [],
1617
1067
  "exports": [
1618
1068
  {
1619
1069
  "kind": "js",
1620
- "name": "comboboxKeyboardStrategy",
1070
+ "name": "AuroCheckbox",
1621
1071
  "declaration": {
1622
- "name": "comboboxKeyboardStrategy",
1623
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1072
+ "name": "AuroCheckbox",
1073
+ "module": "components/checkbox/src/index.js"
1624
1074
  }
1625
- }
1626
- ]
1627
- },
1628
- {
1629
- "kind": "javascript-module",
1630
- "path": "components/combobox/src/index.js",
1631
- "declarations": [],
1632
- "exports": [
1075
+ },
1633
1076
  {
1634
1077
  "kind": "js",
1635
- "name": "AuroCombobox",
1078
+ "name": "AuroCheckboxGroup",
1636
1079
  "declaration": {
1637
- "name": "AuroCombobox",
1638
- "module": "components/combobox/src/index.js"
1080
+ "name": "AuroCheckboxGroup",
1081
+ "module": "components/checkbox/src/index.js"
1639
1082
  }
1640
1083
  }
1641
1084
  ]
1642
1085
  },
1643
1086
  {
1644
1087
  "kind": "javascript-module",
1645
- "path": "components/combobox/src/registered.js",
1088
+ "path": "components/checkbox/src/registered.js",
1646
1089
  "declarations": [],
1647
- "exports": [
1648
- {
1649
- "kind": "js",
1650
- "name": "AuroCombobox",
1651
- "declaration": {
1652
- "name": "AuroCombobox",
1653
- "module": "components/combobox/src/registered.js"
1654
- }
1655
- }
1656
- ]
1090
+ "exports": []
1657
1091
  },
1658
1092
  {
1659
1093
  "kind": "javascript-module",
1660
- "path": "components/checkbox/src/auro-checkbox-group.js",
1094
+ "path": "components/combobox/src/auro-combobox.js",
1661
1095
  "declarations": [
1662
1096
  {
1663
1097
  "kind": "class",
1664
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1665
- "name": "AuroCheckboxGroup",
1098
+ "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.",
1099
+ "name": "AuroCombobox",
1666
1100
  "slots": [
1667
1101
  {
1668
- "description": "Allows for the legend to be overridden.",
1669
- "name": "legend"
1102
+ "description": "Default slot for the menu content.",
1103
+ "name": ""
1104
+ },
1105
+ {
1106
+ "type": {
1107
+ "text": "HTMLSlotElement"
1108
+ },
1109
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1110
+ "name": "optionalLabel"
1111
+ },
1112
+ {
1113
+ "description": "Sets aria-label on clear button",
1114
+ "name": "ariaLabel.input.clear"
1115
+ },
1116
+ {
1117
+ "description": "Sets aria-label on close button in fullscreen bib",
1118
+ "name": "ariaLabel.bib.close"
1119
+ },
1120
+ {
1121
+ "description": "Defines the headline to display above menu-options",
1122
+ "name": "bib.fullscreen.headline"
1123
+ },
1124
+ {
1125
+ "description": "Defines the content of the label.",
1126
+ "name": "label"
1127
+ },
1128
+ {
1129
+ "description": "Defines the content of the helpText.",
1130
+ "name": "helpText"
1131
+ },
1132
+ {
1133
+ "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
1134
+ "name": "displayValue"
1135
+ }
1136
+ ],
1137
+ "members": [
1138
+ {
1139
+ "kind": "method",
1140
+ "name": "_initializeDefaults",
1141
+ "privacy": "private",
1142
+ "return": {
1143
+ "type": {
1144
+ "text": "void"
1145
+ }
1146
+ }
1147
+ },
1148
+ {
1149
+ "kind": "field",
1150
+ "name": "inputValue",
1151
+ "description": "Returns the current value of the input element within the combobox.",
1152
+ "return": {
1153
+ "type": {
1154
+ "text": "string|undefined"
1155
+ }
1156
+ },
1157
+ "readonly": true
1158
+ },
1159
+ {
1160
+ "kind": "method",
1161
+ "name": "isValid",
1162
+ "description": "Checks if the element is valid.",
1163
+ "return": {
1164
+ "type": {
1165
+ "text": "boolean"
1166
+ }
1167
+ }
1168
+ },
1169
+ {
1170
+ "kind": "method",
1171
+ "name": "register",
1172
+ "static": true,
1173
+ "parameters": [
1174
+ {
1175
+ "name": "name",
1176
+ "default": "'auro-combobox'",
1177
+ "description": "The name of the element that you want to register.",
1178
+ "optional": true,
1179
+ "type": {
1180
+ "text": "string"
1181
+ }
1182
+ }
1183
+ ],
1184
+ "description": "This will register this element with the browser."
1185
+ },
1186
+ {
1187
+ "kind": "method",
1188
+ "name": "activateFirstEnabledAvailableOption",
1189
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
1190
+ "privacy": "private",
1191
+ "return": {
1192
+ "type": {
1193
+ "text": "void"
1194
+ }
1195
+ }
1196
+ },
1197
+ {
1198
+ "kind": "method",
1199
+ "name": "activateLastEnabledAvailableOption",
1200
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
1201
+ "privacy": "private",
1202
+ "return": {
1203
+ "type": {
1204
+ "text": "void"
1205
+ }
1206
+ }
1207
+ },
1208
+ {
1209
+ "kind": "method",
1210
+ "name": "updateFilter",
1211
+ "description": "Updates the filter for the available options based on the input value.",
1212
+ "privacy": "private"
1213
+ },
1214
+ {
1215
+ "kind": "method",
1216
+ "name": "syncValuesAndStates",
1217
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1218
+ "privacy": "private",
1219
+ "return": {
1220
+ "type": {
1221
+ "text": "void"
1222
+ }
1223
+ }
1224
+ },
1225
+ {
1226
+ "kind": "method",
1227
+ "name": "updateTriggerTextDisplay",
1228
+ "parameters": [
1229
+ {
1230
+ "name": "label",
1231
+ "description": "The label of the selected option.",
1232
+ "type": {
1233
+ "text": "string"
1234
+ }
1235
+ }
1236
+ ],
1237
+ "description": "Update displayValue or input.value, it's called when making a selection.",
1238
+ "privacy": "private"
1239
+ },
1240
+ {
1241
+ "kind": "method",
1242
+ "name": "handleMenuOptions",
1243
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1244
+ "privacy": "private",
1245
+ "return": {
1246
+ "type": {
1247
+ "text": "void"
1248
+ }
1249
+ }
1250
+ },
1251
+ {
1252
+ "kind": "method",
1253
+ "name": "generateOptionsArray",
1254
+ "description": "Determines the element error state based on the `required` attribute and input value.",
1255
+ "privacy": "private",
1256
+ "return": {
1257
+ "type": {
1258
+ "text": "void"
1259
+ }
1260
+ }
1670
1261
  },
1671
1262
  {
1672
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1673
- "name": "optionalLabel"
1263
+ "kind": "method",
1264
+ "name": "hideBib",
1265
+ "description": "Hides the dropdown bib if its open.",
1266
+ "return": {
1267
+ "type": {
1268
+ "text": "void"
1269
+ }
1270
+ }
1674
1271
  },
1675
1272
  {
1676
- "description": "Allows for the helper text to be overridden.",
1677
- "name": "helpText"
1273
+ "kind": "method",
1274
+ "name": "showBib",
1275
+ "description": "Shows the dropdown bib if there are options to show.",
1276
+ "return": {
1277
+ "type": {
1278
+ "text": "void"
1279
+ }
1280
+ }
1678
1281
  },
1679
1282
  {
1680
- "description": "The default slot for the checkbox items.",
1681
- "name": "default"
1682
- }
1683
- ],
1684
- "members": [
1283
+ "kind": "method",
1284
+ "name": "configureDropdown",
1285
+ "description": "Binds all behavior needed to the dropdown after rendering.",
1286
+ "privacy": "private",
1287
+ "return": {
1288
+ "type": {
1289
+ "text": "void"
1290
+ }
1291
+ }
1292
+ },
1685
1293
  {
1686
1294
  "kind": "method",
1687
- "name": "_initializeDefaults"
1295
+ "name": "setClearBtnFocus",
1296
+ "privacy": "private"
1688
1297
  },
1689
1298
  {
1690
1299
  "kind": "method",
1691
- "name": "register",
1692
- "static": true,
1693
- "parameters": [
1694
- {
1695
- "name": "name",
1696
- "default": "\"auro-checkbox-group\"",
1697
- "description": "The name of the element that you want to register.",
1698
- "optional": true,
1699
- "type": {
1700
- "text": "string"
1701
- }
1300
+ "name": "setTriggerInputFocus",
1301
+ "privacy": "private"
1302
+ },
1303
+ {
1304
+ "kind": "method",
1305
+ "name": "setInputFocus",
1306
+ "privacy": "private"
1307
+ },
1308
+ {
1309
+ "kind": "method",
1310
+ "name": "updateBibDialogRole",
1311
+ "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.",
1312
+ "privacy": "private"
1313
+ },
1314
+ {
1315
+ "kind": "method",
1316
+ "name": "updateMenuShapeSize",
1317
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1318
+ "privacy": "private"
1319
+ },
1320
+ {
1321
+ "kind": "method",
1322
+ "name": "_getAnnouncementRoot",
1323
+ "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.",
1324
+ "privacy": "private",
1325
+ "return": {
1326
+ "type": {
1327
+ "text": "ShadowRoot"
1702
1328
  }
1703
- ],
1704
- "description": "This will register this element with the browser."
1329
+ }
1705
1330
  },
1706
1331
  {
1707
1332
  "kind": "method",
1708
- "name": "handleValueUpdate",
1333
+ "name": "configureMenu",
1334
+ "description": "Binds all behavior needed to the menu after rendering.",
1335
+ "privacy": "private",
1336
+ "return": {
1337
+ "type": {
1338
+ "text": "void"
1339
+ }
1340
+ }
1341
+ },
1342
+ {
1343
+ "kind": "method",
1344
+ "name": "configureInput",
1345
+ "description": "Binds all behavior needed to the input after rendering.",
1346
+ "privacy": "private",
1347
+ "return": {
1348
+ "type": {
1349
+ "text": "void"
1350
+ }
1351
+ }
1352
+ },
1353
+ {
1354
+ "kind": "method",
1355
+ "name": "handleMenuLoadingChange",
1709
1356
  "parameters": [
1710
1357
  {
1711
- "name": "value",
1712
- "description": "The value of the checkbox.",
1358
+ "name": "event",
1359
+ "description": "The event object containing details about the loading state change.",
1713
1360
  "type": {
1714
- "text": "String"
1361
+ "text": "CustomEvent"
1715
1362
  }
1716
1363
  },
1717
1364
  {
1718
- "name": "selected",
1719
- "description": "The checked state of the checkbox.",
1365
+ "description": "Indicates whether the menu is currently loading.",
1366
+ "name": "event.detail.loading",
1720
1367
  "type": {
1721
- "text": "Boolean"
1368
+ "text": "boolean"
1369
+ }
1370
+ },
1371
+ {
1372
+ "description": "Indicates if there are loading placeholders present.",
1373
+ "name": "event.detail.hasLoadingPlaceholder",
1374
+ "type": {
1375
+ "text": "boolean"
1722
1376
  }
1723
1377
  }
1724
1378
  ],
1725
- "description": "Helper method to handle checkbox value changing.",
1379
+ "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.",
1726
1380
  "privacy": "private",
1727
1381
  "return": {
1728
1382
  "type": {
@@ -1732,8 +1386,17 @@
1732
1386
  },
1733
1387
  {
1734
1388
  "kind": "method",
1735
- "name": "handlePreselectedItems",
1736
- "description": "Helper method that handles the state of preselected checkboxes.",
1389
+ "name": "handleInputValueChange",
1390
+ "parameters": [
1391
+ {
1392
+ "name": "event",
1393
+ "description": "The input event triggered by the input element.",
1394
+ "type": {
1395
+ "text": "Event"
1396
+ }
1397
+ }
1398
+ ],
1399
+ "description": "Handle changes to the input value and trigger changes that should result.",
1737
1400
  "privacy": "private",
1738
1401
  "return": {
1739
1402
  "type": {
@@ -1743,8 +1406,8 @@
1743
1406
  },
1744
1407
  {
1745
1408
  "kind": "method",
1746
- "name": "handleItems",
1747
- "description": "Helper method that handles the state of checkboxes.",
1409
+ "name": "configureCombobox",
1410
+ "description": "Binds all behavior needed to the combobox after rendering.",
1748
1411
  "privacy": "private",
1749
1412
  "return": {
1750
1413
  "type": {
@@ -1752,6 +1415,35 @@
1752
1415
  }
1753
1416
  }
1754
1417
  },
1418
+ {
1419
+ "kind": "method",
1420
+ "name": "focus",
1421
+ "description": "Focuses the combobox trigger input.",
1422
+ "return": {
1423
+ "type": {
1424
+ "text": "void"
1425
+ }
1426
+ }
1427
+ },
1428
+ {
1429
+ "kind": "method",
1430
+ "name": "setMenuValue",
1431
+ "parameters": [
1432
+ {
1433
+ "name": "value",
1434
+ "description": "The value to set on the menu.",
1435
+ "type": {
1436
+ "text": "string"
1437
+ }
1438
+ }
1439
+ ],
1440
+ "description": "Sets the menu value if menu is available.",
1441
+ "return": {
1442
+ "type": {
1443
+ "text": "void"
1444
+ }
1445
+ }
1446
+ },
1755
1447
  {
1756
1448
  "kind": "method",
1757
1449
  "name": "reset",
@@ -1762,6 +1454,16 @@
1762
1454
  }
1763
1455
  }
1764
1456
  },
1457
+ {
1458
+ "kind": "method",
1459
+ "name": "clear",
1460
+ "description": "Clears the current value of the combobox.",
1461
+ "return": {
1462
+ "type": {
1463
+ "text": "void"
1464
+ }
1465
+ }
1466
+ },
1765
1467
  {
1766
1468
  "kind": "method",
1767
1469
  "name": "validate",
@@ -1772,24 +1474,147 @@
1772
1474
  "description": "Whether to force validation.",
1773
1475
  "optional": true,
1774
1476
  "type": {
1775
- "text": "boolean"
1477
+ "text": "boolean"
1478
+ }
1479
+ }
1480
+ ],
1481
+ "description": "Validates value."
1482
+ },
1483
+ {
1484
+ "kind": "method",
1485
+ "name": "transportAssignedNodes",
1486
+ "parameters": [
1487
+ {
1488
+ "name": "slot",
1489
+ "description": "The slot element containing the nodes to apply.",
1490
+ "type": {
1491
+ "text": "HTMLSlotElement"
1492
+ }
1493
+ },
1494
+ {
1495
+ "name": "target",
1496
+ "description": "The target element to apply the nodes to.",
1497
+ "type": {
1498
+ "text": "HTMLElement"
1499
+ }
1500
+ },
1501
+ {
1502
+ "name": "newSlotName",
1503
+ "description": "The new slot name for the applied nodes.",
1504
+ "type": {
1505
+ "text": "string"
1506
+ }
1507
+ }
1508
+ ],
1509
+ "description": "Applies slotted nodes to a target element with a new slot name.",
1510
+ "privacy": "private",
1511
+ "return": {
1512
+ "type": {
1513
+ "text": "void"
1514
+ }
1515
+ }
1516
+ },
1517
+ {
1518
+ "kind": "method",
1519
+ "name": "updateActiveOption",
1520
+ "parameters": [
1521
+ {
1522
+ "name": "index",
1523
+ "description": "Index of the option to make active.",
1524
+ "type": {
1525
+ "text": "number"
1526
+ }
1527
+ }
1528
+ ],
1529
+ "description": "Updates the active option in the menu."
1530
+ },
1531
+ {
1532
+ "kind": "method",
1533
+ "name": "handleSlotChange",
1534
+ "parameters": [
1535
+ {
1536
+ "name": "event",
1537
+ "description": "`slotchange` event.",
1538
+ "type": {
1539
+ "text": "Event"
1776
1540
  }
1777
1541
  }
1778
1542
  ],
1779
- "description": "Validates value."
1543
+ "description": "Watch for slot changes and recalculate the menuoptions.",
1544
+ "privacy": "private",
1545
+ "return": {
1546
+ "type": {
1547
+ "text": "void"
1548
+ }
1549
+ }
1780
1550
  },
1781
1551
  {
1782
1552
  "kind": "field",
1783
1553
  "name": "appearance",
1784
1554
  "privacy": "public",
1785
1555
  "type": {
1786
- "text": "'default' | 'inverse'"
1556
+ "text": "string"
1787
1557
  },
1788
1558
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
1789
1559
  "default": "'default'",
1790
1560
  "attribute": "appearance",
1791
1561
  "reflects": true
1792
1562
  },
1563
+ {
1564
+ "kind": "field",
1565
+ "name": "autocomplete",
1566
+ "privacy": "public",
1567
+ "type": {
1568
+ "text": "string"
1569
+ },
1570
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1571
+ "attribute": "autocomplete",
1572
+ "reflects": true
1573
+ },
1574
+ {
1575
+ "kind": "field",
1576
+ "name": "autoPlacement",
1577
+ "privacy": "public",
1578
+ "type": {
1579
+ "text": "boolean"
1580
+ },
1581
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1582
+ "attribute": "autoPlacement",
1583
+ "reflects": true
1584
+ },
1585
+ {
1586
+ "kind": "field",
1587
+ "name": "availableOptions",
1588
+ "privacy": "private",
1589
+ "type": {
1590
+ "text": "array"
1591
+ },
1592
+ "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).",
1593
+ "attribute": "availableOptions"
1594
+ },
1595
+ {
1596
+ "kind": "field",
1597
+ "name": "behavior",
1598
+ "privacy": "public",
1599
+ "type": {
1600
+ "text": "'filter' | 'suggestion'"
1601
+ },
1602
+ "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.",
1603
+ "default": "'suggestion'",
1604
+ "attribute": "behavior",
1605
+ "reflects": true
1606
+ },
1607
+ {
1608
+ "kind": "field",
1609
+ "name": "checkmark",
1610
+ "privacy": "public",
1611
+ "type": {
1612
+ "text": "boolean"
1613
+ },
1614
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1615
+ "attribute": "checkmark",
1616
+ "reflects": true
1617
+ },
1793
1618
  {
1794
1619
  "kind": "field",
1795
1620
  "name": "disabled",
@@ -1797,10 +1622,39 @@
1797
1622
  "type": {
1798
1623
  "text": "boolean"
1799
1624
  },
1800
- "description": "If set, disables the checkbox group.",
1625
+ "description": "If set, disables the combobox.",
1801
1626
  "attribute": "disabled",
1802
1627
  "reflects": true
1803
1628
  },
1629
+ {
1630
+ "kind": "field",
1631
+ "name": "dropdownId",
1632
+ "privacy": "private",
1633
+ "type": {
1634
+ "text": "string"
1635
+ },
1636
+ "description": "ID for the dropdown."
1637
+ },
1638
+ {
1639
+ "kind": "field",
1640
+ "name": "dropdownOpen",
1641
+ "privacy": "private",
1642
+ "type": {
1643
+ "text": "boolean"
1644
+ },
1645
+ "description": "Whether or not the dropdown is open."
1646
+ },
1647
+ {
1648
+ "kind": "field",
1649
+ "name": "dvInputOnly",
1650
+ "privacy": "public",
1651
+ "type": {
1652
+ "text": "boolean"
1653
+ },
1654
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1655
+ "attribute": "dvInputOnly",
1656
+ "reflects": true
1657
+ },
1804
1658
  {
1805
1659
  "kind": "field",
1806
1660
  "name": "error",
@@ -1814,689 +1668,816 @@
1814
1668
  },
1815
1669
  {
1816
1670
  "kind": "field",
1817
- "name": "horizontal",
1671
+ "name": "format",
1672
+ "privacy": "public",
1673
+ "type": {
1674
+ "text": "string"
1675
+ },
1676
+ "description": "Specifies the input mask format.",
1677
+ "attribute": "format",
1678
+ "reflects": true
1679
+ },
1680
+ {
1681
+ "kind": "field",
1682
+ "name": "inputmode",
1683
+ "privacy": "public",
1684
+ "type": {
1685
+ "text": "string"
1686
+ },
1687
+ "description": "Exposes inputmode attribute for input.",
1688
+ "attribute": "inputmode",
1689
+ "reflects": true
1690
+ },
1691
+ {
1692
+ "kind": "field",
1693
+ "name": "layout",
1694
+ "privacy": "public",
1695
+ "type": {
1696
+ "text": "string"
1697
+ },
1698
+ "description": "Sets the layout of the combobox.",
1699
+ "default": "'classic'",
1700
+ "attribute": "layout",
1701
+ "reflects": true,
1702
+ "inheritedFrom": {
1703
+ "name": "AuroElement",
1704
+ "module": "components/layoutElement/src/auroElement.js"
1705
+ }
1706
+ },
1707
+ {
1708
+ "kind": "field",
1709
+ "name": "matchWidth",
1710
+ "privacy": "private",
1711
+ "type": {
1712
+ "text": "boolean"
1713
+ },
1714
+ "description": "If declared, the popover and trigger will be set to the same width.",
1715
+ "attribute": "matchWidth",
1716
+ "reflects": true
1717
+ },
1718
+ {
1719
+ "kind": "field",
1720
+ "name": "noFilter",
1818
1721
  "privacy": "public",
1819
1722
  "type": {
1820
1723
  "text": "boolean"
1821
1724
  },
1822
- "description": "If set, checkboxes will be aligned horizontally.",
1823
- "attribute": "horizontal",
1725
+ "description": "If set, combobox will not filter menuoptions based on input.",
1726
+ "attribute": "noFilter",
1824
1727
  "reflects": true
1825
1728
  },
1826
1729
  {
1827
1730
  "kind": "field",
1828
- "name": "noValidate",
1731
+ "name": "noFlip",
1829
1732
  "privacy": "public",
1830
1733
  "type": {
1831
1734
  "text": "boolean"
1832
1735
  },
1833
- "description": "If set, disables auto-validation on blur.",
1834
- "attribute": "noValidate",
1736
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1737
+ "attribute": "noFlip",
1835
1738
  "reflects": true
1836
1739
  },
1837
1740
  {
1838
1741
  "kind": "field",
1839
- "name": "onDark",
1742
+ "name": "shift",
1840
1743
  "privacy": "public",
1841
1744
  "type": {
1842
1745
  "text": "boolean"
1843
1746
  },
1844
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1845
- "attribute": "onDark",
1747
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1748
+ "attribute": "shift",
1846
1749
  "reflects": true
1847
1750
  },
1848
1751
  {
1849
1752
  "kind": "field",
1850
- "name": "required",
1753
+ "name": "noValidate",
1851
1754
  "privacy": "public",
1852
1755
  "type": {
1853
1756
  "text": "boolean"
1854
1757
  },
1855
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1856
- "attribute": "required",
1758
+ "description": "If set, disables auto-validation on blur.",
1759
+ "attribute": "noValidate",
1857
1760
  "reflects": true
1858
1761
  },
1859
1762
  {
1860
1763
  "kind": "field",
1861
- "name": "setCustomValidity",
1764
+ "name": "offset",
1862
1765
  "privacy": "public",
1863
1766
  "type": {
1864
- "text": "string"
1767
+ "text": "number"
1865
1768
  },
1866
- "description": "Sets a custom help text message to display for all validityStates.",
1867
- "attribute": "setCustomValidity"
1769
+ "description": "Gap between the trigger element and bib.",
1770
+ "default": "0",
1771
+ "attribute": "offset",
1772
+ "reflects": true
1868
1773
  },
1869
1774
  {
1870
1775
  "kind": "field",
1871
- "name": "setCustomValidityCustomError",
1776
+ "name": "onDark",
1872
1777
  "privacy": "public",
1873
1778
  "type": {
1874
- "text": "string"
1779
+ "text": "boolean"
1875
1780
  },
1876
- "description": "Custom help text message to display when validity = `customError`.",
1877
- "attribute": "setCustomValidityCustomError"
1781
+ "attribute": "onDark",
1782
+ "reflects": true,
1783
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1784
+ "inheritedFrom": {
1785
+ "name": "AuroElement",
1786
+ "module": "components/layoutElement/src/auroElement.js"
1787
+ }
1878
1788
  },
1879
1789
  {
1880
1790
  "kind": "field",
1881
- "name": "setCustomValidityValueMissing",
1791
+ "name": "optionSelected",
1882
1792
  "privacy": "public",
1883
1793
  "type": {
1884
- "text": "string"
1794
+ "text": "HTMLElement"
1885
1795
  },
1886
- "description": "Custom help text message to display when validity = `valueMissing`.",
1887
- "attribute": "setCustomValidityValueMissing"
1796
+ "description": "Specifies the current selected option.",
1797
+ "attribute": "optionSelected"
1888
1798
  },
1889
1799
  {
1890
1800
  "kind": "field",
1891
- "name": "validity",
1801
+ "name": "persistInput",
1892
1802
  "privacy": "public",
1893
1803
  "type": {
1894
- "text": "string"
1804
+ "text": "boolean"
1895
1805
  },
1896
- "description": "Specifies the `validityState` this element is in.",
1897
- "attribute": "validity",
1806
+ "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.",
1807
+ "attribute": "persistInput",
1898
1808
  "reflects": true
1899
- }
1900
- ],
1901
- "events": [
1809
+ },
1902
1810
  {
1903
- "name": "input",
1811
+ "kind": "field",
1812
+ "name": "placement",
1813
+ "privacy": "public",
1904
1814
  "type": {
1905
- "text": "CustomEvent"
1906
- }
1815
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1816
+ },
1817
+ "description": "Position where the bib should appear relative to the trigger.",
1818
+ "default": "'bottom-start'",
1819
+ "attribute": "placement",
1820
+ "reflects": true
1907
1821
  },
1908
1822
  {
1909
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1910
- "name": "auroFormElement-validated"
1911
- }
1912
- ],
1913
- "attributes": [
1823
+ "kind": "field",
1824
+ "name": "placeholder",
1825
+ "privacy": "public",
1826
+ "type": {
1827
+ "text": "string"
1828
+ },
1829
+ "description": "Define custom placeholder text, only supported by date input formats.",
1830
+ "attribute": "placeholder",
1831
+ "reflects": true
1832
+ },
1914
1833
  {
1915
- "name": "appearance",
1834
+ "kind": "field",
1835
+ "name": "required",
1836
+ "privacy": "public",
1916
1837
  "type": {
1917
- "text": "'default' | 'inverse'"
1838
+ "text": "boolean"
1918
1839
  },
1919
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1920
- "default": "'default'",
1921
- "fieldName": "appearance"
1840
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1841
+ "attribute": "required",
1842
+ "reflects": true
1922
1843
  },
1923
1844
  {
1924
- "name": "disabled",
1845
+ "kind": "field",
1846
+ "name": "setCustomValidity",
1847
+ "privacy": "public",
1925
1848
  "type": {
1926
- "text": "boolean"
1849
+ "text": "string"
1927
1850
  },
1928
- "description": "If set, disables the checkbox group.",
1929
- "fieldName": "disabled"
1851
+ "description": "Sets a custom help text message to display for all validityStates.",
1852
+ "attribute": "setCustomValidity"
1930
1853
  },
1931
1854
  {
1932
- "name": "error",
1855
+ "kind": "field",
1856
+ "name": "setCustomValidityCustomError",
1857
+ "privacy": "public",
1933
1858
  "type": {
1934
1859
  "text": "string"
1935
1860
  },
1936
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1937
- "fieldName": "error"
1861
+ "description": "Custom help text message to display when validity = `customError`.",
1862
+ "attribute": "setCustomValidityCustomError"
1938
1863
  },
1939
1864
  {
1940
- "name": "horizontal",
1865
+ "kind": "field",
1866
+ "name": "setCustomValidityValueMissing",
1867
+ "privacy": "public",
1941
1868
  "type": {
1942
- "text": "boolean"
1869
+ "text": "string"
1943
1870
  },
1944
- "description": "If set, checkboxes will be aligned horizontally.",
1945
- "fieldName": "horizontal"
1871
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1872
+ "attribute": "setCustomValidityValueMissing"
1946
1873
  },
1947
1874
  {
1948
- "name": "noValidate",
1875
+ "kind": "field",
1876
+ "name": "setCustomValidityValueMissingFilter",
1877
+ "privacy": "public",
1949
1878
  "type": {
1950
- "text": "boolean"
1879
+ "text": "string"
1951
1880
  },
1952
- "description": "If set, disables auto-validation on blur.",
1953
- "fieldName": "noValidate"
1881
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1882
+ "attribute": "setCustomValidityValueMissingFilter"
1954
1883
  },
1955
1884
  {
1956
- "name": "onDark",
1885
+ "kind": "field",
1886
+ "name": "touched",
1887
+ "privacy": "private",
1957
1888
  "type": {
1958
1889
  "text": "boolean"
1959
1890
  },
1960
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1961
- "fieldName": "onDark"
1891
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1962
1892
  },
1963
1893
  {
1964
- "name": "required",
1894
+ "kind": "field",
1895
+ "name": "triggerIcon",
1896
+ "privacy": "public",
1965
1897
  "type": {
1966
1898
  "text": "boolean"
1967
1899
  },
1968
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1969
- "fieldName": "required"
1900
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1901
+ "attribute": "triggerIcon",
1902
+ "reflects": true
1970
1903
  },
1971
1904
  {
1972
- "name": "setCustomValidity",
1905
+ "kind": "field",
1906
+ "name": "type",
1907
+ "privacy": "public",
1973
1908
  "type": {
1974
1909
  "text": "string"
1975
1910
  },
1976
- "description": "Sets a custom help text message to display for all validityStates.",
1977
- "fieldName": "setCustomValidity"
1911
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1912
+ "attribute": "type",
1913
+ "reflects": true
1978
1914
  },
1979
1915
  {
1980
- "name": "setCustomValidityCustomError",
1916
+ "kind": "field",
1917
+ "name": "typedValue",
1918
+ "privacy": "public",
1981
1919
  "type": {
1982
1920
  "text": "string"
1983
1921
  },
1984
- "description": "Custom help text message to display when validity = `customError`.",
1985
- "fieldName": "setCustomValidityCustomError"
1922
+ "description": "Specifies the value of the input element within the combobox.",
1923
+ "attribute": "typedValue",
1924
+ "reflects": true
1986
1925
  },
1987
1926
  {
1988
- "name": "setCustomValidityValueMissing",
1927
+ "kind": "field",
1928
+ "name": "validity",
1929
+ "privacy": "public",
1989
1930
  "type": {
1990
1931
  "text": "string"
1991
1932
  },
1992
- "description": "Custom help text message to display when validity = `valueMissing`.",
1993
- "fieldName": "setCustomValidityValueMissing"
1933
+ "description": "Specifies the `validityState` this element is in.",
1934
+ "attribute": "validity",
1935
+ "reflects": true
1994
1936
  },
1995
1937
  {
1996
- "name": "validity",
1938
+ "kind": "field",
1939
+ "name": "value",
1940
+ "privacy": "public",
1997
1941
  "type": {
1998
1942
  "text": "string"
1999
1943
  },
2000
- "description": "Specifies the `validityState` this element is in.",
2001
- "fieldName": "validity"
2002
- }
2003
- ],
2004
- "superclass": {
2005
- "name": "LitElement",
2006
- "package": "lit"
2007
- },
2008
- "tagName": "auro-checkbox-group",
2009
- "customElement": true
2010
- }
2011
- ],
2012
- "exports": [
2013
- {
2014
- "kind": "js",
2015
- "name": "AuroCheckboxGroup",
2016
- "declaration": {
2017
- "name": "AuroCheckboxGroup",
2018
- "module": "components/checkbox/src/auro-checkbox-group.js"
2019
- }
2020
- }
2021
- ]
2022
- },
2023
- {
2024
- "kind": "javascript-module",
2025
- "path": "components/checkbox/src/auro-checkbox.js",
2026
- "declarations": [
2027
- {
2028
- "kind": "class",
2029
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2030
- "name": "AuroCheckbox",
2031
- "cssParts": [
2032
- {
2033
- "description": "apply css to a specific checkbox.",
2034
- "name": "checkbox"
1944
+ "description": "Value selected for the dropdown menu.",
1945
+ "attribute": "value"
2035
1946
  },
2036
1947
  {
2037
- "description": "apply css to a specific checkbox's input.",
2038
- "name": "checkbox-input"
1948
+ "kind": "field",
1949
+ "name": "largeFullscreenHeadline",
1950
+ "privacy": "public",
1951
+ "type": {
1952
+ "text": "boolean"
1953
+ },
1954
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1955
+ "attribute": "largeFullscreenHeadline",
1956
+ "reflects": true
2039
1957
  },
2040
1958
  {
2041
- "description": "apply css to a specific checkbox's label.",
2042
- "name": "checkbox-label"
2043
- }
2044
- ],
2045
- "slots": [
2046
- {
2047
- "description": "The default slot for the checkbox label.",
2048
- "name": "default"
2049
- }
2050
- ],
2051
- "members": [
1959
+ "kind": "field",
1960
+ "name": "fullscreenBreakpoint",
1961
+ "privacy": "public",
1962
+ "type": {
1963
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1964
+ },
1965
+ "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.",
1966
+ "default": "'sm'",
1967
+ "attribute": "fullscreenBreakpoint",
1968
+ "reflects": true
1969
+ },
2052
1970
  {
2053
- "kind": "method",
2054
- "name": "_initializeDefaults"
1971
+ "kind": "field",
1972
+ "name": "optionActive",
1973
+ "privacy": "private",
1974
+ "type": {
1975
+ "text": "object"
1976
+ },
1977
+ "description": "Specifies the currently active option."
2055
1978
  },
2056
1979
  {
2057
- "kind": "method",
2058
- "name": "register",
2059
- "static": true,
2060
- "parameters": [
2061
- {
2062
- "name": "name",
2063
- "default": "\"auro-checkbox\"",
2064
- "description": "The name of element that you want to register to.",
2065
- "optional": true,
2066
- "type": {
2067
- "text": "string"
2068
- }
2069
- }
2070
- ],
2071
- "description": "This will register this element with the browser."
1980
+ "kind": "field",
1981
+ "name": "triggerExpandedState",
1982
+ "privacy": "private",
1983
+ "type": {
1984
+ "text": "boolean"
1985
+ },
1986
+ "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
2072
1987
  },
2073
1988
  {
2074
- "kind": "method",
2075
- "name": "handleChange",
2076
- "parameters": [
2077
- {
2078
- "name": "event",
2079
- "description": "The change event from the checkbox input.",
2080
- "type": {
2081
- "text": "Event"
2082
- }
2083
- }
2084
- ],
2085
- "description": "Handles the change event for the checkbox input.\nUpdates the checked state and dispatches a corresponding custom event.\nThis custom event is only for the purpose of supporting IE.",
1989
+ "kind": "field",
1990
+ "name": "componentHasFocus",
1991
+ "description": "Returns true if the element has focus.",
2086
1992
  "privacy": "private",
2087
1993
  "return": {
2088
1994
  "type": {
2089
- "text": "void"
1995
+ "text": "boolean"
2090
1996
  }
1997
+ },
1998
+ "readonly": true,
1999
+ "inheritedFrom": {
2000
+ "name": "AuroElement",
2001
+ "module": "components/layoutElement/src/auroElement.js"
2091
2002
  }
2092
2003
  },
2093
2004
  {
2094
2005
  "kind": "method",
2095
- "name": "handleInput",
2096
- "parameters": [
2097
- {
2098
- "name": "event",
2099
- "description": "The input event from the checkbox input.",
2100
- "type": {
2101
- "text": "Event"
2102
- }
2103
- }
2104
- ],
2105
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2106
- "privacy": "private",
2107
- "return": {
2108
- "type": {
2109
- "text": "void"
2110
- }
2006
+ "name": "resetShapeClasses",
2007
+ "inheritedFrom": {
2008
+ "name": "AuroElement",
2009
+ "module": "components/layoutElement/src/auroElement.js"
2111
2010
  }
2112
2011
  },
2113
2012
  {
2114
2013
  "kind": "method",
2115
- "name": "handleFocusin",
2116
- "description": "Function to support",
2117
- "privacy": "private",
2118
- "return": {
2119
- "type": {
2120
- "text": "void"
2121
- }
2014
+ "name": "resetLayoutClasses",
2015
+ "inheritedFrom": {
2016
+ "name": "AuroElement",
2017
+ "module": "components/layoutElement/src/auroElement.js"
2122
2018
  }
2123
2019
  },
2124
2020
  {
2125
2021
  "kind": "method",
2126
- "name": "generateIconHtml",
2127
- "description": "Function to generate checkmark svg.",
2128
- "privacy": "private",
2129
- "return": {
2130
- "type": {
2131
- "text": "HTMLElement"
2132
- }
2022
+ "name": "updateComponentArchitecture",
2023
+ "inheritedFrom": {
2024
+ "name": "AuroElement",
2025
+ "module": "components/layoutElement/src/auroElement.js"
2026
+ }
2027
+ },
2028
+ {
2029
+ "kind": "field",
2030
+ "name": "shape",
2031
+ "privacy": "public",
2032
+ "type": {
2033
+ "text": "string"
2034
+ },
2035
+ "attribute": "shape",
2036
+ "reflects": true,
2037
+ "inheritedFrom": {
2038
+ "name": "AuroElement",
2039
+ "module": "components/layoutElement/src/auroElement.js"
2133
2040
  }
2134
2041
  },
2135
2042
  {
2136
- "kind": "method",
2137
- "name": "reset",
2138
- "description": "Resets component to initial state.",
2139
- "return": {
2140
- "type": {
2141
- "text": "void"
2142
- }
2043
+ "kind": "field",
2044
+ "name": "size",
2045
+ "privacy": "public",
2046
+ "type": {
2047
+ "text": "string"
2048
+ },
2049
+ "attribute": "size",
2050
+ "reflects": true,
2051
+ "inheritedFrom": {
2052
+ "name": "AuroElement",
2053
+ "module": "components/layoutElement/src/auroElement.js"
2143
2054
  }
2055
+ }
2056
+ ],
2057
+ "events": [
2058
+ {
2059
+ "name": "inputValue",
2060
+ "type": {
2061
+ "text": "CustomEvent"
2062
+ },
2063
+ "description": "Notifies that the components internal HTML5 input value has changed."
2144
2064
  },
2145
2065
  {
2146
- "kind": "method",
2147
- "name": "updateAriaLabel",
2148
- "description": "Updates the aria-label based on slot content.",
2149
- "privacy": "private",
2150
- "return": {
2151
- "type": {
2152
- "text": "void"
2153
- }
2154
- }
2066
+ "name": "input",
2067
+ "type": {
2068
+ "text": "CustomEvent"
2069
+ },
2070
+ "description": "Notifies that the component has a new value set."
2155
2071
  },
2156
2072
  {
2157
- "kind": "method",
2158
- "name": "handleKeyDown",
2159
- "parameters": [
2160
- {
2161
- "name": "event",
2162
- "description": "The keydown event from the checkbox input.",
2163
- "type": {
2164
- "text": "KeyboardEvent"
2165
- }
2166
- }
2167
- ],
2168
- "description": "Handles keydown event to toggle the checkbox with Space key.",
2169
- "privacy": "private",
2170
- "return": {
2171
- "type": {
2172
- "text": "void"
2173
- }
2174
- }
2073
+ "name": "auroCombobox-valueSet",
2074
+ "type": {
2075
+ "text": "CustomEvent"
2076
+ },
2077
+ "description": "(Deprecated) Notifies that the component has a new value set."
2175
2078
  },
2176
2079
  {
2177
- "kind": "field",
2080
+ "description": "Notifies that the component value(s) have been validated.",
2081
+ "name": "auroFormElement-validated"
2082
+ }
2083
+ ],
2084
+ "attributes": [
2085
+ {
2178
2086
  "name": "appearance",
2179
- "privacy": "public",
2180
2087
  "type": {
2181
- "text": "'default' | 'inverse'"
2088
+ "text": "string"
2182
2089
  },
2183
2090
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
2184
2091
  "default": "'default'",
2185
- "attribute": "appearance",
2186
- "reflects": true
2092
+ "fieldName": "appearance"
2187
2093
  },
2188
2094
  {
2189
- "kind": "field",
2190
- "name": "checked",
2191
- "privacy": "public",
2095
+ "name": "autocomplete",
2096
+ "type": {
2097
+ "text": "string"
2098
+ },
2099
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2100
+ "fieldName": "autocomplete"
2101
+ },
2102
+ {
2103
+ "name": "autoPlacement",
2192
2104
  "type": {
2193
2105
  "text": "boolean"
2194
2106
  },
2195
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2196
- "attribute": "checked",
2197
- "reflects": true
2107
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
2108
+ "fieldName": "autoPlacement"
2109
+ },
2110
+ {
2111
+ "name": "availableOptions",
2112
+ "type": {
2113
+ "text": "array"
2114
+ },
2115
+ "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).",
2116
+ "fieldName": "availableOptions"
2117
+ },
2118
+ {
2119
+ "name": "behavior",
2120
+ "type": {
2121
+ "text": "'filter' | 'suggestion'"
2122
+ },
2123
+ "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.",
2124
+ "default": "'suggestion'",
2125
+ "fieldName": "behavior"
2126
+ },
2127
+ {
2128
+ "name": "checkmark",
2129
+ "type": {
2130
+ "text": "boolean"
2131
+ },
2132
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
2133
+ "fieldName": "checkmark"
2198
2134
  },
2199
2135
  {
2200
- "kind": "field",
2201
2136
  "name": "disabled",
2202
- "privacy": "public",
2203
2137
  "type": {
2204
2138
  "text": "boolean"
2205
2139
  },
2206
- "description": "If set to true, the checkbox will not be clickable.",
2207
- "attribute": "disabled",
2208
- "reflects": true
2140
+ "description": "If set, disables the combobox.",
2141
+ "fieldName": "disabled"
2209
2142
  },
2210
2143
  {
2211
- "kind": "field",
2212
- "name": "error",
2213
- "privacy": "public",
2144
+ "name": "dvInputOnly",
2214
2145
  "type": {
2215
2146
  "text": "boolean"
2216
2147
  },
2217
- "description": "If set to true, the checkbox will be displayed with an error state.",
2218
- "attribute": "error",
2219
- "reflects": true
2148
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2149
+ "fieldName": "dvInputOnly"
2220
2150
  },
2221
2151
  {
2222
- "kind": "field",
2223
- "name": "id",
2224
- "privacy": "public",
2152
+ "name": "error",
2225
2153
  "type": {
2226
2154
  "text": "string"
2227
2155
  },
2228
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2229
- "attribute": "id",
2230
- "reflects": true
2156
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2157
+ "fieldName": "error"
2231
2158
  },
2232
2159
  {
2233
- "kind": "field",
2234
- "name": "inputId",
2235
- "privacy": "private",
2160
+ "name": "format",
2236
2161
  "type": {
2237
2162
  "text": "string"
2238
2163
  },
2239
- "description": "The id for input node."
2164
+ "description": "Specifies the input mask format.",
2165
+ "fieldName": "format"
2240
2166
  },
2241
2167
  {
2242
- "kind": "field",
2243
- "name": "name",
2244
- "privacy": "public",
2168
+ "name": "inputmode",
2245
2169
  "type": {
2246
2170
  "text": "string"
2247
2171
  },
2248
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2249
- "attribute": "name"
2172
+ "description": "Exposes inputmode attribute for input.",
2173
+ "fieldName": "inputmode"
2250
2174
  },
2251
2175
  {
2252
- "kind": "field",
2253
- "name": "onDark",
2254
- "privacy": "public",
2176
+ "name": "layout",
2177
+ "type": {
2178
+ "text": "string"
2179
+ },
2180
+ "description": "Sets the layout of the combobox.",
2181
+ "default": "'classic'",
2182
+ "fieldName": "layout",
2183
+ "inheritedFrom": {
2184
+ "name": "AuroElement",
2185
+ "module": "components/layoutElement/src/auroElement.js"
2186
+ }
2187
+ },
2188
+ {
2189
+ "name": "matchWidth",
2255
2190
  "type": {
2256
2191
  "text": "boolean"
2257
2192
  },
2258
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2259
- "attribute": "onDark",
2260
- "reflects": true
2193
+ "description": "If declared, the popover and trigger will be set to the same width.",
2194
+ "fieldName": "matchWidth"
2261
2195
  },
2262
2196
  {
2263
- "kind": "field",
2264
- "name": "touched",
2265
- "privacy": "private",
2197
+ "name": "noFilter",
2266
2198
  "type": {
2267
2199
  "text": "boolean"
2268
2200
  },
2269
- "description": "Indicates whether the checkbox has been interacted with."
2201
+ "description": "If set, combobox will not filter menuoptions based on input.",
2202
+ "fieldName": "noFilter"
2270
2203
  },
2271
2204
  {
2272
- "kind": "field",
2273
- "name": "value",
2274
- "privacy": "public",
2205
+ "name": "noFlip",
2275
2206
  "type": {
2276
- "text": "string"
2207
+ "text": "boolean"
2277
2208
  },
2278
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2279
- "attribute": "value"
2209
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2210
+ "fieldName": "noFlip"
2280
2211
  },
2281
2212
  {
2282
- "kind": "field",
2283
- "name": "tabIndex",
2284
- "privacy": "private",
2213
+ "name": "shift",
2214
+ "type": {
2215
+ "text": "boolean"
2216
+ },
2217
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2218
+ "fieldName": "shift"
2219
+ },
2220
+ {
2221
+ "name": "noValidate",
2222
+ "type": {
2223
+ "text": "boolean"
2224
+ },
2225
+ "description": "If set, disables auto-validation on blur.",
2226
+ "fieldName": "noValidate"
2227
+ },
2228
+ {
2229
+ "name": "offset",
2285
2230
  "type": {
2286
2231
  "text": "number"
2287
2232
  },
2288
- "description": "The tabindex attribute for the checkbox.",
2289
- "attribute": "tabindex",
2290
- "reflects": true
2233
+ "description": "Gap between the trigger element and bib.",
2234
+ "default": "0",
2235
+ "fieldName": "offset"
2291
2236
  },
2292
2237
  {
2293
- "kind": "field",
2294
- "name": "ariaChecked",
2295
- "privacy": "private",
2238
+ "name": "onDark",
2296
2239
  "type": {
2297
- "text": "string"
2240
+ "text": "boolean"
2298
2241
  },
2299
- "description": "The aria-checked attribute for the checkbox.",
2300
- "attribute": "aria-checked",
2301
- "reflects": true
2242
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2243
+ "fieldName": "onDark"
2302
2244
  },
2303
2245
  {
2304
- "kind": "field",
2305
- "name": "ariaDisabled",
2306
- "privacy": "private",
2246
+ "name": "optionSelected",
2307
2247
  "type": {
2308
- "text": "string"
2248
+ "text": "HTMLElement"
2309
2249
  },
2310
- "description": "The aria-disabled attribute for the checkbox.",
2311
- "attribute": "aria-disabled",
2312
- "reflects": true
2250
+ "description": "Specifies the current selected option.",
2251
+ "fieldName": "optionSelected"
2313
2252
  },
2314
2253
  {
2315
- "kind": "field",
2316
- "name": "role",
2317
- "privacy": "private",
2254
+ "name": "persistInput",
2318
2255
  "type": {
2319
- "text": "string"
2256
+ "text": "boolean"
2320
2257
  },
2321
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2322
- "attribute": "role",
2323
- "reflects": true
2324
- }
2325
- ],
2326
- "events": [
2258
+ "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.",
2259
+ "fieldName": "persistInput"
2260
+ },
2327
2261
  {
2328
- "name": "auroCheckbox-input",
2262
+ "name": "placement",
2329
2263
  "type": {
2330
- "text": "CustomEvent"
2331
- }
2264
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2265
+ },
2266
+ "description": "Position where the bib should appear relative to the trigger.",
2267
+ "default": "'bottom-start'",
2268
+ "fieldName": "placement"
2332
2269
  },
2333
2270
  {
2334
- "name": "auroCheckbox-focusin",
2271
+ "name": "placeholder",
2335
2272
  "type": {
2336
- "text": "CustomEvent"
2337
- }
2273
+ "text": "string"
2274
+ },
2275
+ "description": "Define custom placeholder text, only supported by date input formats.",
2276
+ "fieldName": "placeholder"
2338
2277
  },
2339
2278
  {
2340
- "name": "auroCheckbox-focusout",
2279
+ "name": "required",
2341
2280
  "type": {
2342
- "text": "CustomEvent"
2343
- }
2281
+ "text": "boolean"
2282
+ },
2283
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2284
+ "fieldName": "required"
2344
2285
  },
2345
2286
  {
2346
- "description": "(Deprecated) Notifies when checked value is changed.",
2347
- "name": "change"
2287
+ "name": "setCustomValidity",
2288
+ "type": {
2289
+ "text": "string"
2290
+ },
2291
+ "description": "Sets a custom help text message to display for all validityStates.",
2292
+ "fieldName": "setCustomValidity"
2348
2293
  },
2349
2294
  {
2350
- "description": "Notifies when when checked value is changed by user's interface.",
2351
- "name": "input"
2352
- }
2353
- ],
2354
- "attributes": [
2355
- {
2356
- "name": "appearance",
2295
+ "name": "setCustomValidityCustomError",
2357
2296
  "type": {
2358
- "text": "'default' | 'inverse'"
2297
+ "text": "string"
2359
2298
  },
2360
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2361
- "default": "'default'",
2362
- "fieldName": "appearance"
2299
+ "description": "Custom help text message to display when validity = `customError`.",
2300
+ "fieldName": "setCustomValidityCustomError"
2363
2301
  },
2364
2302
  {
2365
- "name": "checked",
2303
+ "name": "setCustomValidityValueMissing",
2366
2304
  "type": {
2367
- "text": "boolean"
2305
+ "text": "string"
2368
2306
  },
2369
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2370
- "fieldName": "checked"
2307
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2308
+ "fieldName": "setCustomValidityValueMissing"
2371
2309
  },
2372
2310
  {
2373
- "name": "disabled",
2311
+ "name": "setCustomValidityValueMissingFilter",
2374
2312
  "type": {
2375
- "text": "boolean"
2313
+ "text": "string"
2376
2314
  },
2377
- "description": "If set to true, the checkbox will not be clickable.",
2378
- "fieldName": "disabled"
2315
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2316
+ "fieldName": "setCustomValidityValueMissingFilter"
2379
2317
  },
2380
2318
  {
2381
- "name": "error",
2319
+ "name": "triggerIcon",
2382
2320
  "type": {
2383
2321
  "text": "boolean"
2384
2322
  },
2385
- "description": "If set to true, the checkbox will be displayed with an error state.",
2386
- "fieldName": "error"
2323
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2324
+ "fieldName": "triggerIcon"
2387
2325
  },
2388
2326
  {
2389
- "name": "id",
2327
+ "name": "type",
2390
2328
  "type": {
2391
2329
  "text": "string"
2392
2330
  },
2393
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2394
- "fieldName": "id"
2331
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2332
+ "fieldName": "type"
2395
2333
  },
2396
2334
  {
2397
- "name": "name",
2335
+ "name": "typedValue",
2398
2336
  "type": {
2399
2337
  "text": "string"
2400
2338
  },
2401
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2402
- "fieldName": "name"
2339
+ "description": "Specifies the value of the input element within the combobox.",
2340
+ "fieldName": "typedValue"
2403
2341
  },
2404
2342
  {
2405
- "name": "onDark",
2343
+ "name": "validity",
2406
2344
  "type": {
2407
- "text": "boolean"
2345
+ "text": "string"
2408
2346
  },
2409
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2410
- "fieldName": "onDark"
2347
+ "description": "Specifies the `validityState` this element is in.",
2348
+ "fieldName": "validity"
2411
2349
  },
2412
2350
  {
2413
2351
  "name": "value",
2414
2352
  "type": {
2415
2353
  "text": "string"
2416
2354
  },
2417
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2355
+ "description": "Value selected for the dropdown menu.",
2418
2356
  "fieldName": "value"
2419
2357
  },
2420
2358
  {
2421
- "name": "tabindex",
2359
+ "name": "largeFullscreenHeadline",
2422
2360
  "type": {
2423
- "text": "number"
2361
+ "text": "boolean"
2424
2362
  },
2425
- "description": "The tabindex attribute for the checkbox.",
2426
- "fieldName": "tabIndex"
2363
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2364
+ "fieldName": "largeFullscreenHeadline"
2427
2365
  },
2428
2366
  {
2429
- "name": "aria-checked",
2367
+ "name": "fullscreenBreakpoint",
2430
2368
  "type": {
2431
- "text": "string"
2369
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2432
2370
  },
2433
- "description": "The aria-checked attribute for the checkbox.",
2434
- "fieldName": "ariaChecked"
2371
+ "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.",
2372
+ "default": "'sm'",
2373
+ "fieldName": "fullscreenBreakpoint"
2435
2374
  },
2436
2375
  {
2437
- "name": "aria-disabled",
2376
+ "name": "shape",
2438
2377
  "type": {
2439
2378
  "text": "string"
2440
2379
  },
2441
- "description": "The aria-disabled attribute for the checkbox.",
2442
- "fieldName": "ariaDisabled"
2380
+ "fieldName": "shape",
2381
+ "inheritedFrom": {
2382
+ "name": "AuroElement",
2383
+ "module": "components/layoutElement/src/auroElement.js"
2384
+ }
2443
2385
  },
2444
2386
  {
2445
- "name": "role",
2387
+ "name": "size",
2446
2388
  "type": {
2447
2389
  "text": "string"
2448
2390
  },
2449
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2450
- "fieldName": "role"
2391
+ "fieldName": "size",
2392
+ "inheritedFrom": {
2393
+ "name": "AuroElement",
2394
+ "module": "components/layoutElement/src/auroElement.js"
2395
+ }
2396
+ },
2397
+ {
2398
+ "name": "ondark",
2399
+ "type": {
2400
+ "text": "boolean"
2401
+ },
2402
+ "fieldName": "onDark",
2403
+ "inheritedFrom": {
2404
+ "name": "AuroElement",
2405
+ "module": "components/layoutElement/src/auroElement.js"
2406
+ }
2451
2407
  }
2452
2408
  ],
2453
2409
  "superclass": {
2454
- "name": "LitElement",
2455
- "package": "lit"
2410
+ "name": "AuroElement",
2411
+ "module": "/components/layoutElement/src/auroElement.js"
2456
2412
  },
2457
- "tagName": "auro-checkbox",
2413
+ "tagName": "auro-combobox",
2458
2414
  "customElement": true
2459
2415
  }
2460
2416
  ],
2461
2417
  "exports": [
2462
2418
  {
2463
2419
  "kind": "js",
2464
- "name": "AuroCheckbox",
2420
+ "name": "AuroCombobox",
2465
2421
  "declaration": {
2466
- "name": "AuroCheckbox",
2467
- "module": "components/checkbox/src/auro-checkbox.js"
2422
+ "name": "AuroCombobox",
2423
+ "module": "components/combobox/src/auro-combobox.js"
2468
2424
  }
2469
2425
  }
2470
2426
  ]
2471
2427
  },
2472
2428
  {
2473
2429
  "kind": "javascript-module",
2474
- "path": "components/checkbox/src/index.js",
2475
- "declarations": [],
2430
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2431
+ "declarations": [
2432
+ {
2433
+ "kind": "variable",
2434
+ "name": "comboboxKeyboardStrategy",
2435
+ "type": {
2436
+ "text": "object"
2437
+ },
2438
+ "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { navigateArrow(component, 'down'); } } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. 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(); } } }, }"
2439
+ }
2440
+ ],
2476
2441
  "exports": [
2477
2442
  {
2478
2443
  "kind": "js",
2479
- "name": "AuroCheckbox",
2444
+ "name": "comboboxKeyboardStrategy",
2480
2445
  "declaration": {
2481
- "name": "AuroCheckbox",
2482
- "module": "components/checkbox/src/index.js"
2446
+ "name": "comboboxKeyboardStrategy",
2447
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2483
2448
  }
2484
- },
2449
+ }
2450
+ ]
2451
+ },
2452
+ {
2453
+ "kind": "javascript-module",
2454
+ "path": "components/combobox/src/index.js",
2455
+ "declarations": [],
2456
+ "exports": [
2485
2457
  {
2486
2458
  "kind": "js",
2487
- "name": "AuroCheckboxGroup",
2459
+ "name": "AuroCombobox",
2488
2460
  "declaration": {
2489
- "name": "AuroCheckboxGroup",
2490
- "module": "components/checkbox/src/index.js"
2461
+ "name": "AuroCombobox",
2462
+ "module": "components/combobox/src/index.js"
2491
2463
  }
2492
2464
  }
2493
2465
  ]
2494
2466
  },
2495
2467
  {
2496
2468
  "kind": "javascript-module",
2497
- "path": "components/checkbox/src/registered.js",
2469
+ "path": "components/combobox/src/registered.js",
2498
2470
  "declarations": [],
2499
- "exports": []
2471
+ "exports": [
2472
+ {
2473
+ "kind": "js",
2474
+ "name": "AuroCombobox",
2475
+ "declaration": {
2476
+ "name": "AuroCombobox",
2477
+ "module": "components/combobox/src/registered.js"
2478
+ }
2479
+ }
2480
+ ]
2500
2481
  },
2501
2482
  {
2502
2483
  "kind": "javascript-module",
@@ -4219,72 +4200,27 @@
4219
4200
  "type": {
4220
4201
  "text": "void"
4221
4202
  }
4222
- }
4223
- },
4224
- {
4225
- "kind": "method",
4226
- "name": "handleTap",
4227
- "description": "Handles user click events and calls datepicker to update the value(s).",
4228
- "privacy": "private",
4229
- "return": {
4230
- "type": {
4231
- "text": "void"
4232
- }
4233
- }
4234
- },
4235
- {
4236
- "kind": "method",
4237
- "name": "handleHover",
4238
- "description": "Handles user hover events and dispatches a custom event.",
4239
- "privacy": "private",
4240
- "return": {
4241
- "type": {
4242
- "text": "void"
4243
- }
4244
- }
4245
- },
4246
- {
4247
- "kind": "method",
4248
- "name": "isOutOfRange",
4249
- "parameters": [
4250
- {
4251
- "name": "day",
4252
- "description": "An object containing the dateFrom and day of month values.",
4253
- "type": {
4254
- "text": "Object"
4255
- }
4256
- },
4257
- {
4258
- "name": "min",
4259
- "description": "The minimum date value.",
4260
- "type": {
4261
- "text": "Number"
4262
- }
4263
- },
4264
- {
4265
- "name": "max",
4266
- "description": "The maximum date value.",
4267
- "type": {
4268
- "text": "Number"
4269
- }
4270
- }
4271
- ],
4272
- "description": "Checks if the current date is outside the valid min/max range.\nOut-of-range cells are not focusable and are hidden from screen readers.",
4203
+ }
4204
+ },
4205
+ {
4206
+ "kind": "method",
4207
+ "name": "handleTap",
4208
+ "description": "Handles user click events and calls datepicker to update the value(s).",
4273
4209
  "privacy": "private",
4274
4210
  "return": {
4275
4211
  "type": {
4276
- "text": "Boolean"
4212
+ "text": "void"
4277
4213
  }
4278
4214
  }
4279
4215
  },
4280
4216
  {
4281
4217
  "kind": "method",
4282
- "name": "isBlackout",
4283
- "description": "Checks if the current date is a blackout date (in disabledDays but within range).\nBlackout cells are focusable but not selectable.",
4218
+ "name": "handleHover",
4219
+ "description": "Handles user hover events and dispatches a custom event.",
4284
4220
  "privacy": "private",
4285
4221
  "return": {
4286
4222
  "type": {
4287
- "text": "Boolean"
4223
+ "text": "void"
4288
4224
  }
4289
4225
  }
4290
4226
  },
@@ -4321,7 +4257,7 @@
4321
4257
  }
4322
4258
  }
4323
4259
  ],
4324
- "description": "Checks if the current date is disabled based on min/max range or the\nlegacy disabledDays timestamp list. Sets the `disabled` attribute on the\nhost when the date falls outside the allowed range or appears in\ndisabledDays. Note: blackout dates are handled separately by `isBlackout()`.",
4260
+ "description": "Checks if the current date is a valid date depending on the min and max values.",
4325
4261
  "privacy": "private",
4326
4262
  "return": {
4327
4263
  "type": {
@@ -4329,39 +4265,6 @@
4329
4265
  }
4330
4266
  }
4331
4267
  },
4332
- {
4333
- "kind": "method",
4334
- "name": "getCellId",
4335
- "description": "Generates a unique cell ID in the format cell-YYYY-MM-DD.",
4336
- "privacy": "private",
4337
- "return": {
4338
- "type": {
4339
- "text": "String"
4340
- }
4341
- }
4342
- },
4343
- {
4344
- "kind": "method",
4345
- "name": "getAriaLabel",
4346
- "description": "Generates a localized aria-label for the cell button using Intl.DateTimeFormat.\nIncludes range position and blackout status.",
4347
- "privacy": "private",
4348
- "return": {
4349
- "type": {
4350
- "text": "String"
4351
- }
4352
- }
4353
- },
4354
- {
4355
- "kind": "method",
4356
- "name": "getRangePosition",
4357
- "description": "Determines the range position of this cell relative to the current selection.",
4358
- "privacy": "private",
4359
- "return": {
4360
- "type": {
4361
- "text": "String|null"
4362
- }
4363
- }
4364
- },
4365
4268
  {
4366
4269
  "kind": "method",
4367
4270
  "name": "isDepartDate",
@@ -4559,31 +4462,6 @@
4559
4462
  }
4560
4463
  }
4561
4464
  },
4562
- {
4563
- "kind": "method",
4564
- "name": "configurePopover",
4565
- "description": "Configures the popover instance with the calendar month boundary.\nCalled from firstUpdated and updated because the popover element is only\nrendered after hasPopoverContent becomes true (set by handleSlotContent).",
4566
- "privacy": "private",
4567
- "return": {
4568
- "type": {
4569
- "text": "void"
4570
- }
4571
- }
4572
- },
4573
- {
4574
- "kind": "method",
4575
- "name": "focusButton",
4576
- "description": "Programmatically focuses the cell's interactive button element.",
4577
- "return": {
4578
- "type": {
4579
- "text": "void"
4580
- }
4581
- }
4582
- },
4583
- {
4584
- "kind": "method",
4585
- "name": "renderCellButton"
4586
- },
4587
4465
  {
4588
4466
  "kind": "field",
4589
4467
  "name": "day",
@@ -4733,27 +4611,6 @@
4733
4611
  "default": "false",
4734
4612
  "attribute": "renderForDateSlot"
4735
4613
  },
4736
- {
4737
- "kind": "field",
4738
- "name": "active",
4739
- "privacy": "public",
4740
- "type": {
4741
- "text": "boolean"
4742
- },
4743
- "default": "false",
4744
- "attribute": "active",
4745
- "reflects": true
4746
- },
4747
- {
4748
- "kind": "field",
4749
- "name": "hasPopoverContent",
4750
- "privacy": "public",
4751
- "type": {
4752
- "text": "boolean"
4753
- },
4754
- "default": "false",
4755
- "attribute": "hasPopoverContent"
4756
- },
4757
4614
  {
4758
4615
  "kind": "field",
4759
4616
  "name": "runtimeUtils",
@@ -4765,12 +4622,6 @@
4765
4622
  }
4766
4623
  ],
4767
4624
  "events": [
4768
- {
4769
- "name": "calendar-cell-activate",
4770
- "type": {
4771
- "text": "CustomEvent"
4772
- }
4773
- },
4774
4625
  {
4775
4626
  "name": "date-is-hovered",
4776
4627
  "type": {
@@ -4897,22 +4748,6 @@
4897
4748
  },
4898
4749
  "default": "false",
4899
4750
  "fieldName": "renderForDateSlot"
4900
- },
4901
- {
4902
- "name": "active",
4903
- "type": {
4904
- "text": "boolean"
4905
- },
4906
- "default": "false",
4907
- "fieldName": "active"
4908
- },
4909
- {
4910
- "name": "hasPopoverContent",
4911
- "type": {
4912
- "text": "boolean"
4913
- },
4914
- "default": "false",
4915
- "fieldName": "hasPopoverContent"
4916
4751
  }
4917
4752
  ],
4918
4753
  "superclass": {
@@ -4971,78 +4806,10 @@
4971
4806
  }
4972
4807
  }
4973
4808
  },
4974
- {
4975
- "kind": "method",
4976
- "name": "getHeadingId",
4977
- "description": "Returns the unique heading ID for this month, used by aria-labelledby.",
4978
- "privacy": "private",
4979
- "return": {
4980
- "type": {
4981
- "text": "String"
4982
- }
4983
- }
4984
- },
4985
4809
  {
4986
4810
  "kind": "method",
4987
4811
  "name": "localeChanged",
4988
- "description": "Determines the current month name based on locale.\nAlso builds parallel arrays of full day names for abbr attributes.\nThis is a rewrite of the function used in the class RangeDatepickerCalendar and should not be removed from here.",
4989
- "privacy": "private",
4990
- "return": {
4991
- "type": {
4992
- "text": "void"
4993
- }
4994
- }
4995
- },
4996
- {
4997
- "kind": "method",
4998
- "name": "renderDayOfWeek",
4999
- "parameters": [
5000
- {
5001
- "name": "dayOfWeek",
5002
- "description": "The short day name.",
5003
- "type": {
5004
- "text": "String"
5005
- }
5006
- },
5007
- {
5008
- "name": "index",
5009
- "description": "The index in the dayNamesOfTheWeek array.",
5010
- "type": {
5011
- "text": "Number"
5012
- }
5013
- }
5014
- ],
5015
- "description": "Renders a day-of-week header with abbr attribute for the full day name.",
5016
- "privacy": "private",
5017
- "return": {
5018
- "type": {
5019
- "text": "Object"
5020
- }
5021
- }
5022
- },
5023
- {
5024
- "kind": "method",
5025
- "name": "getFocusableCells",
5026
- "description": "Returns all focusable cell elements (enabled + blackout, not out-of-range) in this month.",
5027
- "return": {
5028
- "type": {
5029
- "text": "Array"
5030
- }
5031
- }
5032
- },
5033
- {
5034
- "kind": "method",
5035
- "name": "handleGridKeyDown",
5036
- "parameters": [
5037
- {
5038
- "name": "event",
5039
- "description": "The keyboard event.",
5040
- "type": {
5041
- "text": "KeyboardEvent"
5042
- }
5043
- }
5044
- ],
5045
- "description": "Handles arrow key navigation within the month grid.\nDispatches a cross-month navigation event when the boundary is reached.",
4812
+ "description": "Determines the current month name based on locale.\nThis is a rewrite of the function used in the class RangeDatepickerCalendar and should not be removed from here.",
5046
4813
  "privacy": "private",
5047
4814
  "return": {
5048
4815
  "type": {
@@ -5050,15 +4817,6 @@
5050
4817
  }
5051
4818
  }
5052
4819
  },
5053
- {
5054
- "kind": "method",
5055
- "name": "renderWeek",
5056
- "parameters": [
5057
- {
5058
- "name": "week"
5059
- }
5060
- ]
5061
- },
5062
4820
  {
5063
4821
  "kind": "method",
5064
4822
  "name": "renderDay",
@@ -5079,20 +4837,6 @@
5079
4837
  "reflects": true
5080
4838
  }
5081
4839
  ],
5082
- "events": [
5083
- {
5084
- "name": "calendar-month-boundary",
5085
- "type": {
5086
- "text": "CustomEvent"
5087
- }
5088
- },
5089
- {
5090
- "name": "calendar-cell-activate",
5091
- "type": {
5092
- "text": "CustomEvent"
5093
- }
5094
- }
5095
- ],
5096
4840
  "attributes": [
5097
4841
  {
5098
4842
  "name": "monthFirst",
@@ -5128,134 +4872,21 @@
5128
4872
  }
5129
4873
  }
5130
4874
  ]
5131
- },
5132
- {
5133
- "kind": "javascript-module",
5134
- "path": "components/datepicker/src/auro-calendar.js",
5135
- "declarations": [
5136
- {
5137
- "kind": "class",
5138
- "description": "",
5139
- "name": "AuroCalendar",
5140
- "members": [
5141
- {
5142
- "kind": "method",
5143
- "name": "handlePrevMonth",
5144
- "description": "Updates the month and year when the user navigates to the previous calendar month.",
5145
- "privacy": "private",
5146
- "return": {
5147
- "type": {
5148
- "text": "void"
5149
- }
5150
- }
5151
- },
5152
- {
5153
- "kind": "method",
5154
- "name": "handleNextMonth",
5155
- "description": "Updates the month and year when the user navigates to the next calendar month.",
5156
- "privacy": "private",
5157
- "return": {
5158
- "type": {
5159
- "text": "void"
5160
- }
5161
- }
5162
- },
5163
- {
5164
- "kind": "method",
5165
- "name": "announceMonthChange",
5166
- "description": "Announces the current month and year via the live region after navigation.",
5167
- "privacy": "private",
5168
- "return": {
5169
- "type": {
5170
- "text": "void"
5171
- }
5172
- }
5173
- },
5174
- {
5175
- "kind": "method",
5176
- "name": "renderAllCalendars",
5177
- "description": "Renders all of the auro-calendar-months HTML.",
5178
- "privacy": "private",
5179
- "return": {
5180
- "type": {
5181
- "text": "Object"
5182
- }
5183
- }
5184
- },
5185
- {
5186
- "kind": "method",
5187
- "name": "focusCloseButton",
5188
- "description": "Focuses the close button inside the calendar's bibtemplate.\nUsed by datepicker to set initial focus when the fullscreen dialog opens.",
5189
- "return": {
5190
- "type": {
5191
- "text": "void"
5192
- }
5193
- }
5194
- },
5195
- {
5196
- "kind": "method",
5197
- "name": "scrollMonthIntoView",
5198
- "parameters": [
5199
- {
5200
- "name": "date",
5201
- "description": "The date to scroll into view.",
5202
- "type": {
5203
- "text": "String"
5204
- }
5205
- }
5206
- ],
5207
- "description": "Request the calendar be scrolled to a given date.",
5208
- "return": {
5209
- "type": {
5210
- "text": "void"
5211
- }
5212
- }
5213
- },
5214
- {
5215
- "kind": "method",
5216
- "name": "getMonthComponents",
5217
- "description": "Gets all rendered month components.",
5218
- "privacy": "private",
5219
- "return": {
5220
- "type": {
5221
- "text": "Array"
5222
- }
5223
- }
5224
- },
4875
+ },
4876
+ {
4877
+ "kind": "javascript-module",
4878
+ "path": "components/datepicker/src/auro-calendar.js",
4879
+ "declarations": [
4880
+ {
4881
+ "kind": "class",
4882
+ "description": "",
4883
+ "name": "AuroCalendar",
4884
+ "members": [
5225
4885
  {
5226
4886
  "kind": "method",
5227
- "name": "getAllFocusableCells",
5228
- "description": "Gets all focusable cells across all rendered months.",
4887
+ "name": "handlePrevMonth",
4888
+ "description": "Updates the month and year when the user navigates to the previous calendar month.",
5229
4889
  "privacy": "private",
5230
- "return": {
5231
- "type": {
5232
- "text": "Array"
5233
- }
5234
- }
5235
- },
5236
- {
5237
- "kind": "method",
5238
- "name": "setActiveCell",
5239
- "parameters": [
5240
- {
5241
- "name": "date",
5242
- "description": "Unix timestamp of the cell to activate.",
5243
- "type": {
5244
- "text": "Number"
5245
- }
5246
- }
5247
- ],
5248
- "description": "Sets the active cell across all months. Only one cell has tabindex=\"0\" at a time.",
5249
- "return": {
5250
- "type": {
5251
- "text": "void"
5252
- }
5253
- }
5254
- },
5255
- {
5256
- "kind": "method",
5257
- "name": "focusActiveCell",
5258
- "description": "Focuses the currently active cell. If activeCellDate is set but no cell\nhas the active attribute yet, sets it first. Waits for the cell's render\nto complete so the focused button is the final DOM element.",
5259
4890
  "return": {
5260
4891
  "type": {
5261
4892
  "text": "void"
@@ -5264,28 +4895,8 @@
5264
4895
  },
5265
4896
  {
5266
4897
  "kind": "method",
5267
- "name": "computeActiveDate",
5268
- "description": "Computes the initial active date from data properties alone — no DOM required.\nPriority:\n 1. Selected date (dateFrom) if within range\n 2. Today's date if not disabled (in-range and not blackout)\n 3. First future non-disabled date (scans day-by-day from today up to 1 year)\n 4. First previous non-disabled date (scans day-by-day from today up to 1 year)\n 5. undefined — no valid target",
5269
- "privacy": "private",
5270
- "return": {
5271
- "type": {
5272
- "text": "Number|undefined"
5273
- }
5274
- }
5275
- },
5276
- {
5277
- "kind": "method",
5278
- "name": "handleMonthBoundary",
5279
- "parameters": [
5280
- {
5281
- "name": "event",
5282
- "description": "The boundary event with direction and source date info.",
5283
- "type": {
5284
- "text": "CustomEvent"
5285
- }
5286
- }
5287
- ],
5288
- "description": "Handles cross-month boundary navigation events from month components.",
4898
+ "name": "handleNextMonth",
4899
+ "description": "Updates the month and year when the user navigates to the next calendar month.",
5289
4900
  "privacy": "private",
5290
4901
  "return": {
5291
4902
  "type": {
@@ -5295,29 +4906,19 @@
5295
4906
  },
5296
4907
  {
5297
4908
  "kind": "method",
5298
- "name": "handleCellActivate",
5299
- "parameters": [
5300
- {
5301
- "name": "event",
5302
- "description": "The activation event with target date.",
5303
- "type": {
5304
- "text": "CustomEvent"
5305
- }
5306
- }
5307
- ],
5308
- "description": "Handles cell activation events from month components.",
4909
+ "name": "renderAllCalendars",
4910
+ "description": "Renders all of the auro-calendar-months HTML.",
5309
4911
  "privacy": "private",
5310
4912
  "return": {
5311
4913
  "type": {
5312
- "text": "void"
4914
+ "text": "Object"
5313
4915
  }
5314
4916
  }
5315
4917
  },
5316
4918
  {
5317
4919
  "kind": "method",
5318
- "name": "scrollToActiveCell",
5319
- "description": "Scrolls the calendar to ensure the month containing the active cell is visible.",
5320
- "privacy": "private",
4920
+ "name": "focusCloseButton",
4921
+ "description": "Focuses the close button inside the calendar's bibtemplate.\nUsed by datepicker to set initial focus when the fullscreen dialog opens.",
5321
4922
  "return": {
5322
4923
  "type": {
5323
4924
  "text": "void"
@@ -5326,44 +4927,23 @@
5326
4927
  },
5327
4928
  {
5328
4929
  "kind": "method",
5329
- "name": "announceSelection",
4930
+ "name": "scrollMonthIntoView",
5330
4931
  "parameters": [
5331
4932
  {
5332
- "name": "dateStr",
5333
- "description": "The localized date string to announce.",
4933
+ "name": "date",
4934
+ "description": "The date to scroll into view.",
5334
4935
  "type": {
5335
4936
  "text": "String"
5336
4937
  }
5337
4938
  }
5338
4939
  ],
5339
- "description": "Announces a date selection via the live region.",
5340
- "privacy": "private",
4940
+ "description": "Request the calendar be scrolled to a given date.",
5341
4941
  "return": {
5342
4942
  "type": {
5343
4943
  "text": "void"
5344
4944
  }
5345
4945
  }
5346
4946
  },
5347
- {
5348
- "kind": "method",
5349
- "name": "formatAnnouncementDate",
5350
- "parameters": [
5351
- {
5352
- "name": "timestamp",
5353
- "description": "Unix timestamp in seconds.",
5354
- "type": {
5355
- "text": "String|Number"
5356
- }
5357
- }
5358
- ],
5359
- "description": "Formats a Unix timestamp (seconds) as a localized date string for SR announcements.",
5360
- "privacy": "private",
5361
- "return": {
5362
- "type": {
5363
- "text": "String"
5364
- }
5365
- }
5366
- },
5367
4947
  {
5368
4948
  "kind": "method",
5369
4949
  "name": "injectSlot",
@@ -5467,16 +5047,6 @@
5467
5047
  "attribute": "isFullscreen",
5468
5048
  "reflects": true
5469
5049
  },
5470
- {
5471
- "kind": "field",
5472
- "name": "activeCellDate",
5473
- "type": {
5474
- "text": "null"
5475
- },
5476
- "description": "The date of the currently active cell (Unix timestamp).\nOnly one cell across the entire calendar has tabindex=\"0\" at a time.",
5477
- "privacy": "private",
5478
- "default": "null"
5479
- },
5480
5050
  {
5481
5051
  "kind": "field",
5482
5052
  "name": "firstMonthRenderable",
@@ -6101,17 +5671,6 @@
6101
5671
  }
6102
5672
  }
6103
5673
  },
6104
- {
6105
- "kind": "method",
6106
- "name": "focusActiveCellWhenReady",
6107
- "description": "Attempts to focus the active calendar cell using a rAF retry loop.\nShared by both fullscreen and desktop open paths.",
6108
- "privacy": "private",
6109
- "return": {
6110
- "type": {
6111
- "text": "void"
6112
- }
6113
- }
6114
- },
6115
5674
  {
6116
5675
  "kind": "method",
6117
5676
  "name": "configureDropdown",
@@ -6592,114 +6151,6 @@
6592
6151
  "attribute": "range",
6593
6152
  "reflects": true
6594
6153
  },
6595
- {
6596
- "kind": "field",
6597
- "name": "rangeLabelStart",
6598
- "privacy": "public",
6599
- "type": {
6600
- "text": "string"
6601
- },
6602
- "description": "Label announced for the range start date cell.",
6603
- "default": "'range start'",
6604
- "attribute": "rangeLabelStart",
6605
- "reflects": true
6606
- },
6607
- {
6608
- "kind": "field",
6609
- "name": "rangeLabelEnd",
6610
- "privacy": "public",
6611
- "type": {
6612
- "text": "string"
6613
- },
6614
- "description": "Label announced for the range end date cell.",
6615
- "default": "'range end'",
6616
- "attribute": "rangeLabelEnd",
6617
- "reflects": true
6618
- },
6619
- {
6620
- "kind": "field",
6621
- "name": "rangeLabelBeforeRange",
6622
- "privacy": "public",
6623
- "type": {
6624
- "text": "string"
6625
- },
6626
- "description": "Label announced for cells before the range start.",
6627
- "default": "'before range'",
6628
- "attribute": "rangeLabelBeforeRange",
6629
- "reflects": true
6630
- },
6631
- {
6632
- "kind": "field",
6633
- "name": "rangeLabelInRange",
6634
- "privacy": "public",
6635
- "type": {
6636
- "text": "string"
6637
- },
6638
- "description": "Label announced for cells within the selected range.",
6639
- "default": "'in range'",
6640
- "attribute": "rangeLabelInRange",
6641
- "reflects": true
6642
- },
6643
- {
6644
- "kind": "field",
6645
- "name": "rangeLabelAfterRange",
6646
- "privacy": "public",
6647
- "type": {
6648
- "text": "string"
6649
- },
6650
- "description": "Label announced for cells after the range (or after start when no end is selected).",
6651
- "default": "'after range'",
6652
- "attribute": "rangeLabelAfterRange",
6653
- "reflects": true
6654
- },
6655
- {
6656
- "kind": "field",
6657
- "name": "blackoutDates",
6658
- "privacy": "public",
6659
- "type": {
6660
- "text": "array"
6661
- },
6662
- "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
6663
- "default": "[]",
6664
- "attribute": "blackoutDates",
6665
- "reflects": true
6666
- },
6667
- {
6668
- "kind": "field",
6669
- "name": "blackoutLabel",
6670
- "privacy": "public",
6671
- "type": {
6672
- "text": "string"
6673
- },
6674
- "description": "Label announced for blackout (disabled but in-range) date cells.",
6675
- "default": "'unavailable'",
6676
- "attribute": "blackoutLabel",
6677
- "reflects": true
6678
- },
6679
- {
6680
- "kind": "field",
6681
- "name": "navLabelPrevMonth",
6682
- "privacy": "public",
6683
- "type": {
6684
- "text": "string"
6685
- },
6686
- "description": "Accessible label for the previous month navigation button.",
6687
- "default": "'Previous month'",
6688
- "attribute": "navLabelPrevMonth",
6689
- "reflects": true
6690
- },
6691
- {
6692
- "kind": "field",
6693
- "name": "navLabelNextMonth",
6694
- "privacy": "public",
6695
- "type": {
6696
- "text": "string"
6697
- },
6698
- "description": "Accessible label for the next month navigation button.",
6699
- "default": "'Next month'",
6700
- "attribute": "navLabelNextMonth",
6701
- "reflects": true
6702
- },
6703
6154
  {
6704
6155
  "kind": "field",
6705
6156
  "name": "stacked",
@@ -7529,87 +6980,6 @@
7529
6980
  "default": "false",
7530
6981
  "fieldName": "range"
7531
6982
  },
7532
- {
7533
- "name": "rangeLabelStart",
7534
- "type": {
7535
- "text": "string"
7536
- },
7537
- "description": "Label announced for the range start date cell.",
7538
- "default": "'range start'",
7539
- "fieldName": "rangeLabelStart"
7540
- },
7541
- {
7542
- "name": "rangeLabelEnd",
7543
- "type": {
7544
- "text": "string"
7545
- },
7546
- "description": "Label announced for the range end date cell.",
7547
- "default": "'range end'",
7548
- "fieldName": "rangeLabelEnd"
7549
- },
7550
- {
7551
- "name": "rangeLabelBeforeRange",
7552
- "type": {
7553
- "text": "string"
7554
- },
7555
- "description": "Label announced for cells before the range start.",
7556
- "default": "'before range'",
7557
- "fieldName": "rangeLabelBeforeRange"
7558
- },
7559
- {
7560
- "name": "rangeLabelInRange",
7561
- "type": {
7562
- "text": "string"
7563
- },
7564
- "description": "Label announced for cells within the selected range.",
7565
- "default": "'in range'",
7566
- "fieldName": "rangeLabelInRange"
7567
- },
7568
- {
7569
- "name": "rangeLabelAfterRange",
7570
- "type": {
7571
- "text": "string"
7572
- },
7573
- "description": "Label announced for cells after the range (or after start when no end is selected).",
7574
- "default": "'after range'",
7575
- "fieldName": "rangeLabelAfterRange"
7576
- },
7577
- {
7578
- "name": "blackoutDates",
7579
- "type": {
7580
- "text": "array"
7581
- },
7582
- "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
7583
- "default": "[]",
7584
- "fieldName": "blackoutDates"
7585
- },
7586
- {
7587
- "name": "blackoutLabel",
7588
- "type": {
7589
- "text": "string"
7590
- },
7591
- "description": "Label announced for blackout (disabled but in-range) date cells.",
7592
- "default": "'unavailable'",
7593
- "fieldName": "blackoutLabel"
7594
- },
7595
- {
7596
- "name": "navLabelPrevMonth",
7597
- "type": {
7598
- "text": "string"
7599
- },
7600
- "description": "Accessible label for the previous month navigation button.",
7601
- "default": "'Previous month'",
7602
- "fieldName": "navLabelPrevMonth"
7603
- },
7604
- {
7605
- "name": "navLabelNextMonth",
7606
- "type": {
7607
- "text": "string"
7608
- },
7609
- "description": "Accessible label for the next month navigation button.",
7610
- "default": "'Next month'",
7611
- "fieldName": "navLabelNextMonth"
7612
- },
7613
6983
  {
7614
6984
  "name": "referenceDates",
7615
6985
  "type": {
@@ -7781,7 +7151,7 @@
7781
7151
  "type": {
7782
7152
  "text": "object"
7783
7153
  },
7784
- "default": "{ Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Stop propagation so parent containers (auro-dialog, auro-drawer) // don't also react to Escape. evt.stopPropagation(); evt.preventDefault(); component.hideBib(); }, Enter(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, ' '(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, }"
7154
+ "default": "{ Escape(component, evt) { if (!component.dropdown || !component.dropdown.isPopoverVisible) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups. // Because stopPropagation prevents the document-level floatingUI keydown handler from // seeing this event, we must also close the dropdown explicitly. evt.stopPropagation(); component.dropdown.hide(); }, }"
7785
7155
  }
7786
7156
  ],
7787
7157
  "exports": [
@@ -8635,29 +8005,6 @@
8635
8005
  "name": "updateFocusTrap",
8636
8006
  "privacy": "private"
8637
8007
  },
8638
- {
8639
- "kind": "method",
8640
- "name": "_getActiveElements",
8641
- "description": "Returns the chain of active (focused) elements through shadow roots.",
8642
- "privacy": "private",
8643
- "return": {
8644
- "type": {
8645
- "text": "Array<HTMLElement>"
8646
- }
8647
- }
8648
- },
8649
- {
8650
- "kind": "method",
8651
- "name": "_setPageInert",
8652
- "description": "Sets `inert` on sibling elements of the dropdown's top-level host\nso that content outside the dropdown is not interactive while the modal is open.\nWalks up through shadow DOM boundaries to find the outermost host element\nin the light DOM, then sets `inert` on siblings at each ancestor level\nto ensure all page content outside the host subtree is inert.",
8653
- "privacy": "private"
8654
- },
8655
- {
8656
- "kind": "method",
8657
- "name": "_clearPageInert",
8658
- "description": "Restores `inert` state on siblings that were made inert by `_setPageInert`.",
8659
- "privacy": "private"
8660
- },
8661
8008
  {
8662
8009
  "kind": "method",
8663
8010
  "name": "handleFocusout",
@@ -8964,17 +8311,6 @@
8964
8311
  "attribute": "autoPlacement",
8965
8312
  "reflects": true
8966
8313
  },
8967
- {
8968
- "kind": "field",
8969
- "name": "desktopModal",
8970
- "privacy": "public",
8971
- "type": {
8972
- "text": "boolean"
8973
- },
8974
- "description": "If declared, the dropdown will behave as a modal dialog when in a desktop viewport size.",
8975
- "attribute": "desktopModal",
8976
- "reflects": true
8977
- },
8978
8314
  {
8979
8315
  "kind": "field",
8980
8316
  "name": "disableEventShow",
@@ -9281,14 +8617,6 @@
9281
8617
  "description": "If declared, bib's position will be automatically calculated where to appear.",
9282
8618
  "fieldName": "autoPlacement"
9283
8619
  },
9284
- {
9285
- "name": "desktopModal",
9286
- "type": {
9287
- "text": "boolean"
9288
- },
9289
- "description": "If declared, the dropdown will behave as a modal dialog when in a desktop viewport size.",
9290
- "fieldName": "desktopModal"
9291
- },
9292
8620
  {
9293
8621
  "name": "disableEventShow",
9294
8622
  "type": {
@@ -19465,7 +18793,7 @@
19465
18793
  "type": {
19466
18794
  "text": "object"
19467
18795
  },
19468
- "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (evt.altKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); return; } navigateArrow(component, 'down', { ctx, showFn: () => component.dropdown.show(), }); }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (evt.altKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); return; } navigateArrow(component, 'up', { ctx, showFn: () => component.dropdown.show(), }); }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const lastOption = [...component.menu.menuService.menuOptions].reverse().find((option) => !option.disabled); if (lastOption) { component.menu.updateActiveOption(lastOption); } }, Enter(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const firstOption = component.menu.menuService.menuOptions.find((option) => !option.disabled); if (firstOption) { component.menu.updateActiveOption(firstOption); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { component.updateActiveOptionBasedOnKey(evt.key); if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (ctx.isExpanded) { component.dropdown.hide(); return; } component.dropdown.show(); } }, }"
18796
+ "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const lastOption = [...component.menu.menuService.menuOptions].reverse().find((option) => !option.disabled); if (lastOption) { component.menu.updateActiveOption(lastOption); } }, Enter(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const firstOption = component.menu.menuService.menuOptions.find((option) => !option.disabled); if (firstOption) { component.menu.updateActiveOption(firstOption); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { component.updateActiveOptionBasedOnKey(evt.key); if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (ctx.isExpanded) { component.dropdown.hide(); return; } component.dropdown.show(); } }, }"
19469
18797
  }
19470
18798
  ],
19471
18799
  "exports": [