@aurodesignsystem-dev/auro-formkit 0.0.0-pr1480.1 → 0.0.0-pr1480.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/components/checkbox/demo/customize.min.js +1 -1
  2. package/components/checkbox/demo/getting-started.min.js +1 -1
  3. package/components/checkbox/demo/index.min.js +1 -1
  4. package/components/checkbox/dist/index.js +1 -1
  5. package/components/checkbox/dist/registered.js +1 -1
  6. package/components/combobox/demo/customize.min.js +3 -3
  7. package/components/combobox/demo/getting-started.min.js +3 -3
  8. package/components/combobox/demo/index.min.js +3 -3
  9. package/components/combobox/dist/index.js +3 -3
  10. package/components/combobox/dist/registered.js +3 -3
  11. package/components/counter/demo/customize.min.js +2 -2
  12. package/components/counter/demo/index.min.js +2 -2
  13. package/components/counter/dist/index.js +1 -1
  14. package/components/counter/dist/registered.js +1 -1
  15. package/components/datepicker/demo/customize.min.js +250 -87
  16. package/components/datepicker/demo/index.min.js +266 -92
  17. package/components/datepicker/dist/index.js +250 -87
  18. package/components/datepicker/dist/registered.js +250 -87
  19. package/components/datepicker/dist/src/auro-calendar-cell.d.ts +3 -4
  20. package/components/datepicker/dist/src/auro-calendar.d.ts +74 -5
  21. package/components/dropdown/demo/customize.min.js +1 -1
  22. package/components/dropdown/demo/getting-started.min.js +1 -1
  23. package/components/dropdown/demo/index.min.js +1 -1
  24. package/components/dropdown/dist/index.js +1 -1
  25. package/components/dropdown/dist/registered.js +1 -1
  26. package/components/form/demo/customize.min.js +259 -96
  27. package/components/form/demo/getting-started.min.js +259 -96
  28. package/components/form/demo/index.min.js +259 -96
  29. package/components/form/demo/registerDemoDeps.min.js +259 -96
  30. package/components/input/demo/customize.min.js +1 -1
  31. package/components/input/demo/getting-started.min.js +1 -1
  32. package/components/input/demo/index.min.js +1 -1
  33. package/components/input/dist/index.js +1 -1
  34. package/components/input/dist/registered.js +1 -1
  35. package/components/radio/demo/customize.min.js +1 -1
  36. package/components/radio/demo/getting-started.min.js +1 -1
  37. package/components/radio/demo/index.min.js +1 -1
  38. package/components/radio/dist/index.js +1 -1
  39. package/components/radio/dist/registered.js +1 -1
  40. package/components/select/demo/customize.min.js +2 -2
  41. package/components/select/demo/getting-started.min.js +2 -2
  42. package/components/select/demo/index.min.js +2 -2
  43. package/components/select/dist/index.js +2 -2
  44. package/components/select/dist/registered.js +2 -2
  45. package/custom-elements.json +1536 -1442
  46. package/package.json +1 -1
@@ -267,80 +267,34 @@
267
267
  },
268
268
  {
269
269
  "kind": "javascript-module",
270
- "path": "components/combobox/src/auro-combobox.js",
270
+ "path": "components/checkbox/src/auro-checkbox-group.js",
271
271
  "declarations": [
272
272
  {
273
273
  "kind": "class",
274
- "description": "The `auro-combobox` element provides users with a way to select an option from a list of filtered or suggested options based on user input.",
275
- "name": "AuroCombobox",
274
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
275
+ "name": "AuroCheckboxGroup",
276
276
  "slots": [
277
277
  {
278
- "description": "Default slot for the menu content.",
279
- "name": ""
278
+ "description": "Allows for the legend to be overridden.",
279
+ "name": "legend"
280
280
  },
281
281
  {
282
- "type": {
283
- "text": "HTMLSlotElement"
284
- },
285
282
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
286
283
  "name": "optionalLabel"
287
284
  },
288
285
  {
289
- "description": "Sets aria-label on clear button",
290
- "name": "ariaLabel.input.clear"
291
- },
292
- {
293
- "description": "Sets aria-label on close button in fullscreen bib",
294
- "name": "ariaLabel.bib.close"
295
- },
296
- {
297
- "description": "Defines the headline to display above menu-options",
298
- "name": "bib.fullscreen.headline"
299
- },
300
- {
301
- "description": "Defines the content of the label.",
302
- "name": "label"
303
- },
304
- {
305
- "description": "Defines the content of the helpText.",
286
+ "description": "Allows for the helper text to be overridden.",
306
287
  "name": "helpText"
307
288
  },
308
289
  {
309
- "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
310
- "name": "displayValue"
290
+ "description": "The default slot for the checkbox items.",
291
+ "name": "default"
311
292
  }
312
293
  ],
313
294
  "members": [
314
295
  {
315
296
  "kind": "method",
316
- "name": "_initializeDefaults",
317
- "privacy": "private",
318
- "return": {
319
- "type": {
320
- "text": "void"
321
- }
322
- }
323
- },
324
- {
325
- "kind": "field",
326
- "name": "inputValue",
327
- "description": "Returns the current value of the input element within the combobox.",
328
- "return": {
329
- "type": {
330
- "text": "string|undefined"
331
- }
332
- },
333
- "readonly": true
334
- },
335
- {
336
- "kind": "method",
337
- "name": "isValid",
338
- "description": "Checks if the element is valid.",
339
- "return": {
340
- "type": {
341
- "text": "boolean"
342
- }
343
- }
297
+ "name": "_initializeDefaults"
344
298
  },
345
299
  {
346
300
  "kind": "method",
@@ -349,7 +303,7 @@
349
303
  "parameters": [
350
304
  {
351
305
  "name": "name",
352
- "default": "'auro-combobox'",
306
+ "default": "\"auro-checkbox-group\"",
353
307
  "description": "The name of the element that you want to register.",
354
308
  "optional": true,
355
309
  "type": {
@@ -361,62 +315,24 @@
361
315
  },
362
316
  {
363
317
  "kind": "method",
364
- "name": "activateFirstEnabledAvailableOption",
365
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
366
- "privacy": "private",
367
- "return": {
368
- "type": {
369
- "text": "void"
370
- }
371
- }
372
- },
373
- {
374
- "kind": "method",
375
- "name": "activateLastEnabledAvailableOption",
376
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
377
- "privacy": "private",
378
- "return": {
379
- "type": {
380
- "text": "void"
381
- }
382
- }
383
- },
384
- {
385
- "kind": "method",
386
- "name": "updateFilter",
387
- "description": "Updates the filter for the available options based on the input value.",
388
- "privacy": "private"
389
- },
390
- {
391
- "kind": "method",
392
- "name": "syncValuesAndStates",
393
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
394
- "privacy": "private",
395
- "return": {
396
- "type": {
397
- "text": "void"
398
- }
399
- }
400
- },
401
- {
402
- "kind": "method",
403
- "name": "updateTriggerTextDisplay",
318
+ "name": "handleValueUpdate",
404
319
  "parameters": [
405
320
  {
406
- "name": "label",
407
- "description": "The label of the selected option.",
321
+ "name": "value",
322
+ "description": "The value of the checkbox.",
408
323
  "type": {
409
- "text": "string"
324
+ "text": "String"
325
+ }
326
+ },
327
+ {
328
+ "name": "selected",
329
+ "description": "The checked state of the checkbox.",
330
+ "type": {
331
+ "text": "Boolean"
410
332
  }
411
333
  }
412
334
  ],
413
- "description": "Update displayValue or input.value, it's called when making a selection.",
414
- "privacy": "private"
415
- },
416
- {
417
- "kind": "method",
418
- "name": "handleMenuOptions",
419
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
335
+ "description": "Helper method to handle checkbox value changing.",
420
336
  "privacy": "private",
421
337
  "return": {
422
338
  "type": {
@@ -426,8 +342,8 @@
426
342
  },
427
343
  {
428
344
  "kind": "method",
429
- "name": "generateOptionsArray",
430
- "description": "Determines the element error state based on the `required` attribute and input value.",
345
+ "name": "handlePreselectedItems",
346
+ "description": "Helper method that handles the state of preselected checkboxes.",
431
347
  "privacy": "private",
432
348
  "return": {
433
349
  "type": {
@@ -437,8 +353,9 @@
437
353
  },
438
354
  {
439
355
  "kind": "method",
440
- "name": "hideBib",
441
- "description": "Hides the dropdown bib if its open.",
356
+ "name": "handleItems",
357
+ "description": "Helper method that handles the state of checkboxes.",
358
+ "privacy": "private",
442
359
  "return": {
443
360
  "type": {
444
361
  "text": "void"
@@ -447,8 +364,8 @@
447
364
  },
448
365
  {
449
366
  "kind": "method",
450
- "name": "showBib",
451
- "description": "Shows the dropdown bib if there are options to show.",
367
+ "name": "reset",
368
+ "description": "Resets component to initial state.",
452
369
  "return": {
453
370
  "type": {
454
371
  "text": "void"
@@ -457,102 +374,325 @@
457
374
  },
458
375
  {
459
376
  "kind": "method",
460
- "name": "configureDropdown",
461
- "description": "Binds all behavior needed to the dropdown after rendering.",
462
- "privacy": "private",
463
- "return": {
464
- "type": {
465
- "text": "void"
377
+ "name": "validate",
378
+ "parameters": [
379
+ {
380
+ "name": "force",
381
+ "default": "false",
382
+ "description": "Whether to force validation.",
383
+ "optional": true,
384
+ "type": {
385
+ "text": "boolean"
386
+ }
466
387
  }
467
- }
468
- },
469
- {
470
- "kind": "method",
471
- "name": "setClearBtnFocus",
472
- "privacy": "private"
388
+ ],
389
+ "description": "Validates value."
473
390
  },
474
391
  {
475
- "kind": "method",
476
- "name": "setTriggerInputFocus",
477
- "privacy": "private"
392
+ "kind": "field",
393
+ "name": "appearance",
394
+ "privacy": "public",
395
+ "type": {
396
+ "text": "'default' | 'inverse'"
397
+ },
398
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
399
+ "default": "'default'",
400
+ "attribute": "appearance",
401
+ "reflects": true
478
402
  },
479
403
  {
480
- "kind": "method",
481
- "name": "setInputFocus",
482
- "privacy": "private"
404
+ "kind": "field",
405
+ "name": "disabled",
406
+ "privacy": "public",
407
+ "type": {
408
+ "text": "boolean"
409
+ },
410
+ "description": "If set, disables the checkbox group.",
411
+ "attribute": "disabled",
412
+ "reflects": true
483
413
  },
484
414
  {
485
- "kind": "method",
486
- "name": "updateBibDialogRole",
487
- "description": "Suppresses or restores dialog semantics on the bib's dialog element.\nOn desktop (non-fullscreen), VoiceOver verbosely announces \"listbox inside\nof a dialog\" which disrupts combobox usage. Setting role=\"presentation\"\nsuppresses this. In fullscreen mode, dialog semantics are restored.",
488
- "privacy": "private"
415
+ "kind": "field",
416
+ "name": "error",
417
+ "privacy": "public",
418
+ "type": {
419
+ "text": "string"
420
+ },
421
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
422
+ "attribute": "error",
423
+ "reflects": true
489
424
  },
490
425
  {
491
- "kind": "method",
492
- "name": "updateMenuShapeSize",
493
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
494
- "privacy": "private"
426
+ "kind": "field",
427
+ "name": "horizontal",
428
+ "privacy": "public",
429
+ "type": {
430
+ "text": "boolean"
431
+ },
432
+ "description": "If set, checkboxes will be aligned horizontally.",
433
+ "attribute": "horizontal",
434
+ "reflects": true
495
435
  },
496
436
  {
497
- "kind": "method",
498
- "name": "_getAnnouncementRoot",
499
- "description": "Returns the shadow root containing the live region for screen reader announcements.\nWhen the bib is open in fullscreen modal mode, everything outside the <dialog>\nis inert, so we target the bib's own shadow root instead of the host's.",
500
- "privacy": "private",
501
- "return": {
502
- "type": {
503
- "text": "ShadowRoot"
504
- }
505
- }
437
+ "kind": "field",
438
+ "name": "noValidate",
439
+ "privacy": "public",
440
+ "type": {
441
+ "text": "boolean"
442
+ },
443
+ "description": "If set, disables auto-validation on blur.",
444
+ "attribute": "noValidate",
445
+ "reflects": true
506
446
  },
507
447
  {
508
- "kind": "method",
509
- "name": "configureMenu",
510
- "description": "Binds all behavior needed to the menu after rendering.",
511
- "privacy": "private",
512
- "return": {
513
- "type": {
514
- "text": "void"
515
- }
516
- }
448
+ "kind": "field",
449
+ "name": "onDark",
450
+ "privacy": "public",
451
+ "type": {
452
+ "text": "boolean"
453
+ },
454
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
455
+ "attribute": "onDark",
456
+ "reflects": true
517
457
  },
518
458
  {
519
- "kind": "method",
520
- "name": "configureInput",
521
- "description": "Binds all behavior needed to the input after rendering.",
522
- "privacy": "private",
523
- "return": {
524
- "type": {
525
- "text": "void"
526
- }
459
+ "kind": "field",
460
+ "name": "required",
461
+ "privacy": "public",
462
+ "type": {
463
+ "text": "boolean"
464
+ },
465
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
466
+ "attribute": "required",
467
+ "reflects": true
468
+ },
469
+ {
470
+ "kind": "field",
471
+ "name": "setCustomValidity",
472
+ "privacy": "public",
473
+ "type": {
474
+ "text": "string"
475
+ },
476
+ "description": "Sets a custom help text message to display for all validityStates.",
477
+ "attribute": "setCustomValidity"
478
+ },
479
+ {
480
+ "kind": "field",
481
+ "name": "setCustomValidityCustomError",
482
+ "privacy": "public",
483
+ "type": {
484
+ "text": "string"
485
+ },
486
+ "description": "Custom help text message to display when validity = `customError`.",
487
+ "attribute": "setCustomValidityCustomError"
488
+ },
489
+ {
490
+ "kind": "field",
491
+ "name": "setCustomValidityValueMissing",
492
+ "privacy": "public",
493
+ "type": {
494
+ "text": "string"
495
+ },
496
+ "description": "Custom help text message to display when validity = `valueMissing`.",
497
+ "attribute": "setCustomValidityValueMissing"
498
+ },
499
+ {
500
+ "kind": "field",
501
+ "name": "validity",
502
+ "privacy": "public",
503
+ "type": {
504
+ "text": "string"
505
+ },
506
+ "description": "Specifies the `validityState` this element is in.",
507
+ "attribute": "validity",
508
+ "reflects": true
509
+ }
510
+ ],
511
+ "events": [
512
+ {
513
+ "name": "input",
514
+ "type": {
515
+ "text": "CustomEvent"
527
516
  }
528
517
  },
518
+ {
519
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
520
+ "name": "auroFormElement-validated"
521
+ }
522
+ ],
523
+ "attributes": [
524
+ {
525
+ "name": "appearance",
526
+ "type": {
527
+ "text": "'default' | 'inverse'"
528
+ },
529
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
530
+ "default": "'default'",
531
+ "fieldName": "appearance"
532
+ },
533
+ {
534
+ "name": "disabled",
535
+ "type": {
536
+ "text": "boolean"
537
+ },
538
+ "description": "If set, disables the checkbox group.",
539
+ "fieldName": "disabled"
540
+ },
541
+ {
542
+ "name": "error",
543
+ "type": {
544
+ "text": "string"
545
+ },
546
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
547
+ "fieldName": "error"
548
+ },
549
+ {
550
+ "name": "horizontal",
551
+ "type": {
552
+ "text": "boolean"
553
+ },
554
+ "description": "If set, checkboxes will be aligned horizontally.",
555
+ "fieldName": "horizontal"
556
+ },
557
+ {
558
+ "name": "noValidate",
559
+ "type": {
560
+ "text": "boolean"
561
+ },
562
+ "description": "If set, disables auto-validation on blur.",
563
+ "fieldName": "noValidate"
564
+ },
565
+ {
566
+ "name": "onDark",
567
+ "type": {
568
+ "text": "boolean"
569
+ },
570
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
571
+ "fieldName": "onDark"
572
+ },
573
+ {
574
+ "name": "required",
575
+ "type": {
576
+ "text": "boolean"
577
+ },
578
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
579
+ "fieldName": "required"
580
+ },
581
+ {
582
+ "name": "setCustomValidity",
583
+ "type": {
584
+ "text": "string"
585
+ },
586
+ "description": "Sets a custom help text message to display for all validityStates.",
587
+ "fieldName": "setCustomValidity"
588
+ },
589
+ {
590
+ "name": "setCustomValidityCustomError",
591
+ "type": {
592
+ "text": "string"
593
+ },
594
+ "description": "Custom help text message to display when validity = `customError`.",
595
+ "fieldName": "setCustomValidityCustomError"
596
+ },
597
+ {
598
+ "name": "setCustomValidityValueMissing",
599
+ "type": {
600
+ "text": "string"
601
+ },
602
+ "description": "Custom help text message to display when validity = `valueMissing`.",
603
+ "fieldName": "setCustomValidityValueMissing"
604
+ },
605
+ {
606
+ "name": "validity",
607
+ "type": {
608
+ "text": "string"
609
+ },
610
+ "description": "Specifies the `validityState` this element is in.",
611
+ "fieldName": "validity"
612
+ }
613
+ ],
614
+ "superclass": {
615
+ "name": "LitElement",
616
+ "package": "lit"
617
+ },
618
+ "tagName": "auro-checkbox-group",
619
+ "customElement": true
620
+ }
621
+ ],
622
+ "exports": [
623
+ {
624
+ "kind": "js",
625
+ "name": "AuroCheckboxGroup",
626
+ "declaration": {
627
+ "name": "AuroCheckboxGroup",
628
+ "module": "components/checkbox/src/auro-checkbox-group.js"
629
+ }
630
+ }
631
+ ]
632
+ },
633
+ {
634
+ "kind": "javascript-module",
635
+ "path": "components/checkbox/src/auro-checkbox.js",
636
+ "declarations": [
637
+ {
638
+ "kind": "class",
639
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
640
+ "name": "AuroCheckbox",
641
+ "cssParts": [
642
+ {
643
+ "description": "apply css to a specific checkbox.",
644
+ "name": "checkbox"
645
+ },
646
+ {
647
+ "description": "apply css to a specific checkbox's input.",
648
+ "name": "checkbox-input"
649
+ },
650
+ {
651
+ "description": "apply css to a specific checkbox's label.",
652
+ "name": "checkbox-label"
653
+ }
654
+ ],
655
+ "slots": [
656
+ {
657
+ "description": "The default slot for the checkbox label.",
658
+ "name": "default"
659
+ }
660
+ ],
661
+ "members": [
529
662
  {
530
663
  "kind": "method",
531
- "name": "handleMenuLoadingChange",
664
+ "name": "_initializeDefaults"
665
+ },
666
+ {
667
+ "kind": "method",
668
+ "name": "register",
669
+ "static": true,
532
670
  "parameters": [
533
671
  {
534
- "name": "event",
535
- "description": "The event object containing details about the loading state change.",
536
- "type": {
537
- "text": "CustomEvent"
538
- }
539
- },
540
- {
541
- "description": "Indicates whether the menu is currently loading.",
542
- "name": "event.detail.loading",
672
+ "name": "name",
673
+ "default": "\"auro-checkbox\"",
674
+ "description": "The name of element that you want to register to.",
675
+ "optional": true,
543
676
  "type": {
544
- "text": "boolean"
677
+ "text": "string"
545
678
  }
546
- },
679
+ }
680
+ ],
681
+ "description": "This will register this element with the browser."
682
+ },
683
+ {
684
+ "kind": "method",
685
+ "name": "handleChange",
686
+ "parameters": [
547
687
  {
548
- "description": "Indicates if there are loading placeholders present.",
549
- "name": "event.detail.hasLoadingPlaceholder",
688
+ "name": "event",
689
+ "description": "The change event from the checkbox input.",
550
690
  "type": {
551
- "text": "boolean"
691
+ "text": "Event"
552
692
  }
553
693
  }
554
694
  ],
555
- "description": "Manages the visibility of the dropdown based on loading state changes.\n\nThis method listens for loading state changes and adjusts the visibility of the dropdown accordingly.\nIf the dropdown is visible and loading is true without any loading placeholders, it hides the dropdown\nand sets a flag to indicate it is hidden while loading. If loading is false and the dropdown was previously\nhidden, it checks if the active element is within the dropdown and shows it again if true.",
695
+ "description": "Handles the change event for the checkbox input.\nUpdates the checked state and dispatches a corresponding custom event.\nThis custom event is only for the purpose of supporting IE.",
556
696
  "privacy": "private",
557
697
  "return": {
558
698
  "type": {
@@ -562,17 +702,17 @@
562
702
  },
563
703
  {
564
704
  "kind": "method",
565
- "name": "handleInputValueChange",
705
+ "name": "handleInput",
566
706
  "parameters": [
567
707
  {
568
708
  "name": "event",
569
- "description": "The input event triggered by the input element.",
709
+ "description": "The input event from the checkbox input.",
570
710
  "type": {
571
711
  "text": "Event"
572
712
  }
573
713
  }
574
714
  ],
575
- "description": "Handle changes to the input value and trigger changes that should result.",
715
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
576
716
  "privacy": "private",
577
717
  "return": {
578
718
  "type": {
@@ -582,8 +722,8 @@
582
722
  },
583
723
  {
584
724
  "kind": "method",
585
- "name": "configureCombobox",
586
- "description": "Binds all behavior needed to the combobox after rendering.",
725
+ "name": "handleFocusin",
726
+ "description": "Function to support",
587
727
  "privacy": "private",
588
728
  "return": {
589
729
  "type": {
@@ -593,30 +733,12 @@
593
733
  },
594
734
  {
595
735
  "kind": "method",
596
- "name": "focus",
597
- "description": "Focuses the combobox trigger input.",
598
- "return": {
599
- "type": {
600
- "text": "void"
601
- }
602
- }
603
- },
604
- {
605
- "kind": "method",
606
- "name": "setMenuValue",
607
- "parameters": [
608
- {
609
- "name": "value",
610
- "description": "The value to set on the menu.",
611
- "type": {
612
- "text": "string"
613
- }
614
- }
615
- ],
616
- "description": "Sets the menu value if menu is available.",
736
+ "name": "generateIconHtml",
737
+ "description": "Function to generate checkmark svg.",
738
+ "privacy": "private",
617
739
  "return": {
618
740
  "type": {
619
- "text": "void"
741
+ "text": "HTMLElement"
620
742
  }
621
743
  }
622
744
  },
@@ -632,57 +754,8 @@
632
754
  },
633
755
  {
634
756
  "kind": "method",
635
- "name": "clear",
636
- "description": "Clears the current value of the combobox.",
637
- "return": {
638
- "type": {
639
- "text": "void"
640
- }
641
- }
642
- },
643
- {
644
- "kind": "method",
645
- "name": "validate",
646
- "parameters": [
647
- {
648
- "name": "force",
649
- "default": "false",
650
- "description": "Whether to force validation.",
651
- "optional": true,
652
- "type": {
653
- "text": "boolean"
654
- }
655
- }
656
- ],
657
- "description": "Validates value."
658
- },
659
- {
660
- "kind": "method",
661
- "name": "transportAssignedNodes",
662
- "parameters": [
663
- {
664
- "name": "slot",
665
- "description": "The slot element containing the nodes to apply.",
666
- "type": {
667
- "text": "HTMLSlotElement"
668
- }
669
- },
670
- {
671
- "name": "target",
672
- "description": "The target element to apply the nodes to.",
673
- "type": {
674
- "text": "HTMLElement"
675
- }
676
- },
677
- {
678
- "name": "newSlotName",
679
- "description": "The new slot name for the applied nodes.",
680
- "type": {
681
- "text": "string"
682
- }
683
- }
684
- ],
685
- "description": "Applies slotted nodes to a target element with a new slot name.",
757
+ "name": "updateAriaLabel",
758
+ "description": "Updates the aria-label based on slot content.",
686
759
  "privacy": "private",
687
760
  "return": {
688
761
  "type": {
@@ -692,31 +765,17 @@
692
765
  },
693
766
  {
694
767
  "kind": "method",
695
- "name": "updateActiveOption",
696
- "parameters": [
697
- {
698
- "name": "index",
699
- "description": "Index of the option to make active.",
700
- "type": {
701
- "text": "number"
702
- }
703
- }
704
- ],
705
- "description": "Updates the active option in the menu."
706
- },
707
- {
708
- "kind": "method",
709
- "name": "handleSlotChange",
768
+ "name": "handleKeyDown",
710
769
  "parameters": [
711
770
  {
712
771
  "name": "event",
713
- "description": "`slotchange` event.",
772
+ "description": "The keydown event from the checkbox input.",
714
773
  "type": {
715
- "text": "Event"
774
+ "text": "KeyboardEvent"
716
775
  }
717
776
  }
718
777
  ],
719
- "description": "Watch for slot changes and recalculate the menuoptions.",
778
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
720
779
  "privacy": "private",
721
780
  "return": {
722
781
  "type": {
@@ -729,7 +788,7 @@
729
788
  "name": "appearance",
730
789
  "privacy": "public",
731
790
  "type": {
732
- "text": "string"
791
+ "text": "'default' | 'inverse'"
733
792
  },
734
793
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
735
794
  "default": "'default'",
@@ -738,991 +797,769 @@
738
797
  },
739
798
  {
740
799
  "kind": "field",
741
- "name": "autocomplete",
742
- "privacy": "public",
743
- "type": {
744
- "text": "string"
745
- },
746
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
747
- "attribute": "autocomplete",
748
- "reflects": true
749
- },
750
- {
751
- "kind": "field",
752
- "name": "autoPlacement",
800
+ "name": "checked",
753
801
  "privacy": "public",
754
802
  "type": {
755
803
  "text": "boolean"
756
804
  },
757
- "description": "If declared, bib's position will be automatically calculated where to appear.",
758
- "attribute": "autoPlacement",
805
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
806
+ "attribute": "checked",
759
807
  "reflects": true
760
808
  },
761
809
  {
762
810
  "kind": "field",
763
- "name": "availableOptions",
764
- "privacy": "private",
765
- "type": {
766
- "text": "array"
767
- },
768
- "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
769
- "attribute": "availableOptions"
770
- },
771
- {
772
- "kind": "field",
773
- "name": "behavior",
811
+ "name": "disabled",
774
812
  "privacy": "public",
775
813
  "type": {
776
- "text": "'filter' | 'suggestion'"
814
+ "text": "boolean"
777
815
  },
778
- "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
779
- "default": "'suggestion'",
780
- "attribute": "behavior",
816
+ "description": "If set to true, the checkbox will not be clickable.",
817
+ "attribute": "disabled",
781
818
  "reflects": true
782
819
  },
783
820
  {
784
821
  "kind": "field",
785
- "name": "checkmark",
822
+ "name": "error",
786
823
  "privacy": "public",
787
824
  "type": {
788
825
  "text": "boolean"
789
826
  },
790
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
791
- "attribute": "checkmark",
827
+ "description": "If set to true, the checkbox will be displayed with an error state.",
828
+ "attribute": "error",
792
829
  "reflects": true
793
830
  },
794
831
  {
795
832
  "kind": "field",
796
- "name": "disabled",
833
+ "name": "id",
797
834
  "privacy": "public",
798
835
  "type": {
799
- "text": "boolean"
836
+ "text": "string"
800
837
  },
801
- "description": "If set, disables the combobox.",
802
- "attribute": "disabled",
838
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
839
+ "attribute": "id",
803
840
  "reflects": true
804
841
  },
805
842
  {
806
843
  "kind": "field",
807
- "name": "dropdownId",
844
+ "name": "inputId",
808
845
  "privacy": "private",
809
846
  "type": {
810
847
  "text": "string"
811
848
  },
812
- "description": "ID for the dropdown."
849
+ "description": "The id for input node."
813
850
  },
814
851
  {
815
852
  "kind": "field",
816
- "name": "dropdownOpen",
817
- "privacy": "private",
853
+ "name": "name",
854
+ "privacy": "public",
818
855
  "type": {
819
- "text": "boolean"
856
+ "text": "string"
820
857
  },
821
- "description": "Whether or not the dropdown is open."
858
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
859
+ "attribute": "name"
822
860
  },
823
861
  {
824
862
  "kind": "field",
825
- "name": "dvInputOnly",
863
+ "name": "onDark",
826
864
  "privacy": "public",
827
865
  "type": {
828
866
  "text": "boolean"
829
867
  },
830
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
831
- "attribute": "dvInputOnly",
868
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
869
+ "attribute": "onDark",
832
870
  "reflects": true
833
871
  },
834
872
  {
835
873
  "kind": "field",
836
- "name": "error",
837
- "privacy": "public",
874
+ "name": "touched",
875
+ "privacy": "private",
838
876
  "type": {
839
- "text": "string"
877
+ "text": "boolean"
840
878
  },
841
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
842
- "attribute": "error",
843
- "reflects": true
879
+ "description": "Indicates whether the checkbox has been interacted with."
844
880
  },
845
881
  {
846
882
  "kind": "field",
847
- "name": "format",
883
+ "name": "value",
848
884
  "privacy": "public",
849
885
  "type": {
850
886
  "text": "string"
851
887
  },
852
- "description": "Specifies the input mask format.",
853
- "attribute": "format",
854
- "reflects": true
888
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
889
+ "attribute": "value"
855
890
  },
856
891
  {
857
892
  "kind": "field",
858
- "name": "inputmode",
859
- "privacy": "public",
893
+ "name": "tabIndex",
894
+ "privacy": "private",
860
895
  "type": {
861
- "text": "string"
896
+ "text": "number"
862
897
  },
863
- "description": "Exposes inputmode attribute for input.",
864
- "attribute": "inputmode",
898
+ "description": "The tabindex attribute for the checkbox.",
899
+ "attribute": "tabindex",
865
900
  "reflects": true
866
901
  },
867
902
  {
868
903
  "kind": "field",
869
- "name": "layout",
870
- "privacy": "public",
904
+ "name": "ariaChecked",
905
+ "privacy": "private",
871
906
  "type": {
872
907
  "text": "string"
873
908
  },
874
- "description": "Sets the layout of the combobox.",
875
- "default": "'classic'",
876
- "attribute": "layout",
877
- "reflects": true,
878
- "inheritedFrom": {
879
- "name": "AuroElement",
880
- "module": "components/layoutElement/src/auroElement.js"
881
- }
909
+ "description": "The aria-checked attribute for the checkbox.",
910
+ "attribute": "aria-checked",
911
+ "reflects": true
882
912
  },
883
913
  {
884
914
  "kind": "field",
885
- "name": "matchWidth",
915
+ "name": "ariaDisabled",
886
916
  "privacy": "private",
887
917
  "type": {
888
- "text": "boolean"
918
+ "text": "string"
889
919
  },
890
- "description": "If declared, the popover and trigger will be set to the same width.",
891
- "attribute": "matchWidth",
920
+ "description": "The aria-disabled attribute for the checkbox.",
921
+ "attribute": "aria-disabled",
892
922
  "reflects": true
893
923
  },
894
924
  {
895
925
  "kind": "field",
896
- "name": "noFilter",
897
- "privacy": "public",
926
+ "name": "role",
927
+ "privacy": "private",
898
928
  "type": {
899
- "text": "boolean"
929
+ "text": "string"
900
930
  },
901
- "description": "If set, combobox will not filter menuoptions based on input.",
902
- "attribute": "noFilter",
931
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
932
+ "attribute": "role",
903
933
  "reflects": true
904
- },
934
+ }
935
+ ],
936
+ "events": [
905
937
  {
906
- "kind": "field",
907
- "name": "noFlip",
908
- "privacy": "public",
938
+ "name": "auroCheckbox-input",
909
939
  "type": {
910
- "text": "boolean"
911
- },
912
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
913
- "attribute": "noFlip",
914
- "reflects": true
940
+ "text": "CustomEvent"
941
+ }
915
942
  },
916
943
  {
917
- "kind": "field",
918
- "name": "shift",
919
- "privacy": "public",
944
+ "name": "auroCheckbox-focusin",
920
945
  "type": {
921
- "text": "boolean"
922
- },
923
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
924
- "attribute": "shift",
925
- "reflects": true
946
+ "text": "CustomEvent"
947
+ }
926
948
  },
927
949
  {
928
- "kind": "field",
929
- "name": "noValidate",
930
- "privacy": "public",
950
+ "name": "auroCheckbox-focusout",
931
951
  "type": {
932
- "text": "boolean"
933
- },
934
- "description": "If set, disables auto-validation on blur.",
935
- "attribute": "noValidate",
936
- "reflects": true
952
+ "text": "CustomEvent"
953
+ }
937
954
  },
938
955
  {
939
- "kind": "field",
940
- "name": "offset",
941
- "privacy": "public",
956
+ "description": "(Deprecated) Notifies when checked value is changed.",
957
+ "name": "change"
958
+ },
959
+ {
960
+ "description": "Notifies when when checked value is changed by user's interface.",
961
+ "name": "input"
962
+ }
963
+ ],
964
+ "attributes": [
965
+ {
966
+ "name": "appearance",
942
967
  "type": {
943
- "text": "number"
968
+ "text": "'default' | 'inverse'"
944
969
  },
945
- "description": "Gap between the trigger element and bib.",
946
- "default": "0",
947
- "attribute": "offset",
948
- "reflects": true
970
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
971
+ "default": "'default'",
972
+ "fieldName": "appearance"
949
973
  },
950
974
  {
951
- "kind": "field",
952
- "name": "onDark",
953
- "privacy": "public",
975
+ "name": "checked",
954
976
  "type": {
955
977
  "text": "boolean"
956
978
  },
957
- "attribute": "onDark",
958
- "reflects": true,
959
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
960
- "inheritedFrom": {
961
- "name": "AuroElement",
962
- "module": "components/layoutElement/src/auroElement.js"
963
- }
979
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
980
+ "fieldName": "checked"
964
981
  },
965
982
  {
966
- "kind": "field",
967
- "name": "optionSelected",
968
- "privacy": "public",
983
+ "name": "disabled",
969
984
  "type": {
970
- "text": "HTMLElement"
985
+ "text": "boolean"
971
986
  },
972
- "description": "Specifies the current selected option.",
973
- "attribute": "optionSelected"
987
+ "description": "If set to true, the checkbox will not be clickable.",
988
+ "fieldName": "disabled"
974
989
  },
975
990
  {
976
- "kind": "field",
977
- "name": "persistInput",
978
- "privacy": "public",
991
+ "name": "error",
979
992
  "type": {
980
993
  "text": "boolean"
981
994
  },
982
- "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
983
- "attribute": "persistInput",
984
- "reflects": true
995
+ "description": "If set to true, the checkbox will be displayed with an error state.",
996
+ "fieldName": "error"
985
997
  },
986
998
  {
987
- "kind": "field",
988
- "name": "placement",
989
- "privacy": "public",
999
+ "name": "id",
990
1000
  "type": {
991
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1001
+ "text": "string"
992
1002
  },
993
- "description": "Position where the bib should appear relative to the trigger.",
994
- "default": "'bottom-start'",
995
- "attribute": "placement",
996
- "reflects": true
1003
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
1004
+ "fieldName": "id"
997
1005
  },
998
1006
  {
999
- "kind": "field",
1000
- "name": "placeholder",
1001
- "privacy": "public",
1007
+ "name": "name",
1002
1008
  "type": {
1003
1009
  "text": "string"
1004
1010
  },
1005
- "description": "Define custom placeholder text, only supported by date input formats.",
1006
- "attribute": "placeholder",
1007
- "reflects": true
1011
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
1012
+ "fieldName": "name"
1008
1013
  },
1009
1014
  {
1010
- "kind": "field",
1011
- "name": "required",
1012
- "privacy": "public",
1015
+ "name": "onDark",
1013
1016
  "type": {
1014
1017
  "text": "boolean"
1015
1018
  },
1016
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1017
- "attribute": "required",
1018
- "reflects": true
1019
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1020
+ "fieldName": "onDark"
1019
1021
  },
1020
1022
  {
1021
- "kind": "field",
1022
- "name": "setCustomValidity",
1023
- "privacy": "public",
1023
+ "name": "value",
1024
1024
  "type": {
1025
1025
  "text": "string"
1026
1026
  },
1027
- "description": "Sets a custom help text message to display for all validityStates.",
1028
- "attribute": "setCustomValidity"
1027
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1028
+ "fieldName": "value"
1029
1029
  },
1030
1030
  {
1031
- "kind": "field",
1032
- "name": "setCustomValidityCustomError",
1033
- "privacy": "public",
1031
+ "name": "tabindex",
1034
1032
  "type": {
1035
- "text": "string"
1033
+ "text": "number"
1036
1034
  },
1037
- "description": "Custom help text message to display when validity = `customError`.",
1038
- "attribute": "setCustomValidityCustomError"
1035
+ "description": "The tabindex attribute for the checkbox.",
1036
+ "fieldName": "tabIndex"
1039
1037
  },
1040
1038
  {
1041
- "kind": "field",
1042
- "name": "setCustomValidityValueMissing",
1043
- "privacy": "public",
1039
+ "name": "aria-checked",
1044
1040
  "type": {
1045
1041
  "text": "string"
1046
1042
  },
1047
- "description": "Custom help text message to display when validity = `valueMissing`.",
1048
- "attribute": "setCustomValidityValueMissing"
1043
+ "description": "The aria-checked attribute for the checkbox.",
1044
+ "fieldName": "ariaChecked"
1049
1045
  },
1050
1046
  {
1051
- "kind": "field",
1052
- "name": "setCustomValidityValueMissingFilter",
1053
- "privacy": "public",
1047
+ "name": "aria-disabled",
1054
1048
  "type": {
1055
1049
  "text": "string"
1056
1050
  },
1057
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1058
- "attribute": "setCustomValidityValueMissingFilter"
1051
+ "description": "The aria-disabled attribute for the checkbox.",
1052
+ "fieldName": "ariaDisabled"
1059
1053
  },
1060
1054
  {
1061
- "kind": "field",
1062
- "name": "touched",
1063
- "privacy": "private",
1055
+ "name": "role",
1064
1056
  "type": {
1065
- "text": "boolean"
1057
+ "text": "string"
1066
1058
  },
1067
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1059
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
1060
+ "fieldName": "role"
1061
+ }
1062
+ ],
1063
+ "superclass": {
1064
+ "name": "LitElement",
1065
+ "package": "lit"
1066
+ },
1067
+ "tagName": "auro-checkbox",
1068
+ "customElement": true
1069
+ }
1070
+ ],
1071
+ "exports": [
1072
+ {
1073
+ "kind": "js",
1074
+ "name": "AuroCheckbox",
1075
+ "declaration": {
1076
+ "name": "AuroCheckbox",
1077
+ "module": "components/checkbox/src/auro-checkbox.js"
1078
+ }
1079
+ }
1080
+ ]
1081
+ },
1082
+ {
1083
+ "kind": "javascript-module",
1084
+ "path": "components/checkbox/src/index.js",
1085
+ "declarations": [],
1086
+ "exports": [
1087
+ {
1088
+ "kind": "js",
1089
+ "name": "AuroCheckbox",
1090
+ "declaration": {
1091
+ "name": "AuroCheckbox",
1092
+ "module": "components/checkbox/src/index.js"
1093
+ }
1094
+ },
1095
+ {
1096
+ "kind": "js",
1097
+ "name": "AuroCheckboxGroup",
1098
+ "declaration": {
1099
+ "name": "AuroCheckboxGroup",
1100
+ "module": "components/checkbox/src/index.js"
1101
+ }
1102
+ }
1103
+ ]
1104
+ },
1105
+ {
1106
+ "kind": "javascript-module",
1107
+ "path": "components/checkbox/src/registered.js",
1108
+ "declarations": [],
1109
+ "exports": []
1110
+ },
1111
+ {
1112
+ "kind": "javascript-module",
1113
+ "path": "components/combobox/src/auro-combobox.js",
1114
+ "declarations": [
1115
+ {
1116
+ "kind": "class",
1117
+ "description": "The `auro-combobox` element provides users with a way to select an option from a list of filtered or suggested options based on user input.",
1118
+ "name": "AuroCombobox",
1119
+ "slots": [
1120
+ {
1121
+ "description": "Default slot for the menu content.",
1122
+ "name": ""
1068
1123
  },
1069
1124
  {
1070
- "kind": "field",
1071
- "name": "triggerIcon",
1072
- "privacy": "public",
1073
1125
  "type": {
1074
- "text": "boolean"
1126
+ "text": "HTMLSlotElement"
1075
1127
  },
1076
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1077
- "attribute": "triggerIcon",
1078
- "reflects": true
1128
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1129
+ "name": "optionalLabel"
1079
1130
  },
1080
1131
  {
1081
- "kind": "field",
1082
- "name": "type",
1083
- "privacy": "public",
1084
- "type": {
1085
- "text": "string"
1086
- },
1087
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1088
- "attribute": "type",
1089
- "reflects": true
1132
+ "description": "Sets aria-label on clear button",
1133
+ "name": "ariaLabel.input.clear"
1090
1134
  },
1091
1135
  {
1092
- "kind": "field",
1093
- "name": "typedValue",
1094
- "privacy": "public",
1095
- "type": {
1096
- "text": "string"
1097
- },
1098
- "description": "Specifies the value of the input element within the combobox.",
1099
- "attribute": "typedValue",
1100
- "reflects": true
1136
+ "description": "Sets aria-label on close button in fullscreen bib",
1137
+ "name": "ariaLabel.bib.close"
1101
1138
  },
1102
1139
  {
1103
- "kind": "field",
1104
- "name": "validity",
1105
- "privacy": "public",
1106
- "type": {
1107
- "text": "string"
1108
- },
1109
- "description": "Specifies the `validityState` this element is in.",
1110
- "attribute": "validity",
1111
- "reflects": true
1140
+ "description": "Defines the headline to display above menu-options",
1141
+ "name": "bib.fullscreen.headline"
1112
1142
  },
1113
1143
  {
1114
- "kind": "field",
1115
- "name": "value",
1116
- "privacy": "public",
1117
- "type": {
1118
- "text": "string"
1119
- },
1120
- "description": "Value selected for the dropdown menu.",
1121
- "attribute": "value"
1144
+ "description": "Defines the content of the label.",
1145
+ "name": "label"
1122
1146
  },
1123
1147
  {
1124
- "kind": "field",
1125
- "name": "largeFullscreenHeadline",
1126
- "privacy": "public",
1127
- "type": {
1128
- "text": "boolean"
1129
- },
1130
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1131
- "attribute": "largeFullscreenHeadline",
1132
- "reflects": true
1148
+ "description": "Defines the content of the helpText.",
1149
+ "name": "helpText"
1133
1150
  },
1134
1151
  {
1135
- "kind": "field",
1136
- "name": "fullscreenBreakpoint",
1137
- "privacy": "public",
1138
- "type": {
1139
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1140
- },
1141
- "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
1142
- "default": "'sm'",
1143
- "attribute": "fullscreenBreakpoint",
1144
- "reflects": true
1145
- },
1152
+ "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
1153
+ "name": "displayValue"
1154
+ }
1155
+ ],
1156
+ "members": [
1146
1157
  {
1147
- "kind": "field",
1148
- "name": "optionActive",
1158
+ "kind": "method",
1159
+ "name": "_initializeDefaults",
1149
1160
  "privacy": "private",
1150
- "type": {
1151
- "text": "object"
1152
- },
1153
- "description": "Specifies the currently active option."
1161
+ "return": {
1162
+ "type": {
1163
+ "text": "void"
1164
+ }
1165
+ }
1154
1166
  },
1155
1167
  {
1156
1168
  "kind": "field",
1157
- "name": "triggerExpandedState",
1158
- "privacy": "private",
1159
- "type": {
1160
- "text": "boolean"
1169
+ "name": "inputValue",
1170
+ "description": "Returns the current value of the input element within the combobox.",
1171
+ "return": {
1172
+ "type": {
1173
+ "text": "string|undefined"
1174
+ }
1161
1175
  },
1162
- "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1176
+ "readonly": true
1163
1177
  },
1164
1178
  {
1165
- "kind": "field",
1166
- "name": "componentHasFocus",
1167
- "description": "Returns true if the element has focus.",
1168
- "privacy": "private",
1179
+ "kind": "method",
1180
+ "name": "isValid",
1181
+ "description": "Checks if the element is valid.",
1169
1182
  "return": {
1170
1183
  "type": {
1171
1184
  "text": "boolean"
1172
1185
  }
1173
- },
1174
- "readonly": true,
1175
- "inheritedFrom": {
1176
- "name": "AuroElement",
1177
- "module": "components/layoutElement/src/auroElement.js"
1178
1186
  }
1179
1187
  },
1180
1188
  {
1181
1189
  "kind": "method",
1182
- "name": "resetShapeClasses",
1183
- "inheritedFrom": {
1184
- "name": "AuroElement",
1185
- "module": "components/layoutElement/src/auroElement.js"
1186
- }
1190
+ "name": "register",
1191
+ "static": true,
1192
+ "parameters": [
1193
+ {
1194
+ "name": "name",
1195
+ "default": "'auro-combobox'",
1196
+ "description": "The name of the element that you want to register.",
1197
+ "optional": true,
1198
+ "type": {
1199
+ "text": "string"
1200
+ }
1201
+ }
1202
+ ],
1203
+ "description": "This will register this element with the browser."
1187
1204
  },
1188
1205
  {
1189
1206
  "kind": "method",
1190
- "name": "resetLayoutClasses",
1191
- "inheritedFrom": {
1192
- "name": "AuroElement",
1193
- "module": "components/layoutElement/src/auroElement.js"
1207
+ "name": "activateFirstEnabledAvailableOption",
1208
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
1209
+ "privacy": "private",
1210
+ "return": {
1211
+ "type": {
1212
+ "text": "void"
1213
+ }
1194
1214
  }
1195
1215
  },
1196
1216
  {
1197
1217
  "kind": "method",
1198
- "name": "updateComponentArchitecture",
1199
- "inheritedFrom": {
1200
- "name": "AuroElement",
1201
- "module": "components/layoutElement/src/auroElement.js"
1218
+ "name": "activateLastEnabledAvailableOption",
1219
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
1220
+ "privacy": "private",
1221
+ "return": {
1222
+ "type": {
1223
+ "text": "void"
1224
+ }
1202
1225
  }
1203
1226
  },
1204
1227
  {
1205
- "kind": "field",
1206
- "name": "shape",
1207
- "privacy": "public",
1208
- "type": {
1209
- "text": "string"
1210
- },
1211
- "attribute": "shape",
1212
- "reflects": true,
1213
- "inheritedFrom": {
1214
- "name": "AuroElement",
1215
- "module": "components/layoutElement/src/auroElement.js"
1216
- }
1228
+ "kind": "method",
1229
+ "name": "updateFilter",
1230
+ "description": "Updates the filter for the available options based on the input value.",
1231
+ "privacy": "private"
1217
1232
  },
1218
1233
  {
1219
- "kind": "field",
1220
- "name": "size",
1221
- "privacy": "public",
1222
- "type": {
1223
- "text": "string"
1224
- },
1225
- "attribute": "size",
1226
- "reflects": true,
1227
- "inheritedFrom": {
1228
- "name": "AuroElement",
1229
- "module": "components/layoutElement/src/auroElement.js"
1234
+ "kind": "method",
1235
+ "name": "syncValuesAndStates",
1236
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1237
+ "privacy": "private",
1238
+ "return": {
1239
+ "type": {
1240
+ "text": "void"
1241
+ }
1230
1242
  }
1231
- }
1232
- ],
1233
- "events": [
1234
- {
1235
- "name": "inputValue",
1236
- "type": {
1237
- "text": "CustomEvent"
1238
- },
1239
- "description": "Notifies that the components internal HTML5 input value has changed."
1240
1243
  },
1241
1244
  {
1242
- "name": "input",
1243
- "type": {
1244
- "text": "CustomEvent"
1245
- },
1246
- "description": "Notifies that the component has a new value set."
1245
+ "kind": "method",
1246
+ "name": "updateTriggerTextDisplay",
1247
+ "parameters": [
1248
+ {
1249
+ "name": "label",
1250
+ "description": "The label of the selected option.",
1251
+ "type": {
1252
+ "text": "string"
1253
+ }
1254
+ }
1255
+ ],
1256
+ "description": "Update displayValue or input.value, it's called when making a selection.",
1257
+ "privacy": "private"
1247
1258
  },
1248
1259
  {
1249
- "name": "auroCombobox-valueSet",
1250
- "type": {
1251
- "text": "CustomEvent"
1252
- },
1253
- "description": "(Deprecated) Notifies that the component has a new value set."
1260
+ "kind": "method",
1261
+ "name": "handleMenuOptions",
1262
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1263
+ "privacy": "private",
1264
+ "return": {
1265
+ "type": {
1266
+ "text": "void"
1267
+ }
1268
+ }
1254
1269
  },
1255
1270
  {
1256
- "description": "Notifies that the component value(s) have been validated.",
1257
- "name": "auroFormElement-validated"
1258
- }
1259
- ],
1260
- "attributes": [
1261
- {
1262
- "name": "appearance",
1263
- "type": {
1264
- "text": "string"
1265
- },
1266
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1267
- "default": "'default'",
1268
- "fieldName": "appearance"
1271
+ "kind": "method",
1272
+ "name": "generateOptionsArray",
1273
+ "description": "Determines the element error state based on the `required` attribute and input value.",
1274
+ "privacy": "private",
1275
+ "return": {
1276
+ "type": {
1277
+ "text": "void"
1278
+ }
1279
+ }
1269
1280
  },
1270
1281
  {
1271
- "name": "autocomplete",
1272
- "type": {
1273
- "text": "string"
1274
- },
1275
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1276
- "fieldName": "autocomplete"
1282
+ "kind": "method",
1283
+ "name": "hideBib",
1284
+ "description": "Hides the dropdown bib if its open.",
1285
+ "return": {
1286
+ "type": {
1287
+ "text": "void"
1288
+ }
1289
+ }
1277
1290
  },
1278
1291
  {
1279
- "name": "autoPlacement",
1280
- "type": {
1281
- "text": "boolean"
1282
- },
1283
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1284
- "fieldName": "autoPlacement"
1292
+ "kind": "method",
1293
+ "name": "showBib",
1294
+ "description": "Shows the dropdown bib if there are options to show.",
1295
+ "return": {
1296
+ "type": {
1297
+ "text": "void"
1298
+ }
1299
+ }
1285
1300
  },
1286
1301
  {
1287
- "name": "availableOptions",
1288
- "type": {
1289
- "text": "array"
1290
- },
1291
- "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
1292
- "fieldName": "availableOptions"
1302
+ "kind": "method",
1303
+ "name": "configureDropdown",
1304
+ "description": "Binds all behavior needed to the dropdown after rendering.",
1305
+ "privacy": "private",
1306
+ "return": {
1307
+ "type": {
1308
+ "text": "void"
1309
+ }
1310
+ }
1293
1311
  },
1294
1312
  {
1295
- "name": "behavior",
1296
- "type": {
1297
- "text": "'filter' | 'suggestion'"
1298
- },
1299
- "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
1300
- "default": "'suggestion'",
1301
- "fieldName": "behavior"
1313
+ "kind": "method",
1314
+ "name": "setClearBtnFocus",
1315
+ "privacy": "private"
1302
1316
  },
1303
1317
  {
1304
- "name": "checkmark",
1305
- "type": {
1306
- "text": "boolean"
1307
- },
1308
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1309
- "fieldName": "checkmark"
1310
- },
1311
- {
1312
- "name": "disabled",
1313
- "type": {
1314
- "text": "boolean"
1315
- },
1316
- "description": "If set, disables the combobox.",
1317
- "fieldName": "disabled"
1318
- },
1319
- {
1320
- "name": "dvInputOnly",
1321
- "type": {
1322
- "text": "boolean"
1323
- },
1324
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1325
- "fieldName": "dvInputOnly"
1318
+ "kind": "method",
1319
+ "name": "setTriggerInputFocus",
1320
+ "privacy": "private"
1326
1321
  },
1327
1322
  {
1328
- "name": "error",
1329
- "type": {
1330
- "text": "string"
1331
- },
1332
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1333
- "fieldName": "error"
1323
+ "kind": "method",
1324
+ "name": "setInputFocus",
1325
+ "privacy": "private"
1334
1326
  },
1335
1327
  {
1336
- "name": "format",
1337
- "type": {
1338
- "text": "string"
1339
- },
1340
- "description": "Specifies the input mask format.",
1341
- "fieldName": "format"
1328
+ "kind": "method",
1329
+ "name": "updateBibDialogRole",
1330
+ "description": "Suppresses or restores dialog semantics on the bib's dialog element.\nOn desktop (non-fullscreen), VoiceOver verbosely announces \"listbox inside\nof a dialog\" which disrupts combobox usage. Setting role=\"presentation\"\nsuppresses this. In fullscreen mode, dialog semantics are restored.",
1331
+ "privacy": "private"
1342
1332
  },
1343
1333
  {
1344
- "name": "inputmode",
1345
- "type": {
1346
- "text": "string"
1347
- },
1348
- "description": "Exposes inputmode attribute for input.",
1349
- "fieldName": "inputmode"
1334
+ "kind": "method",
1335
+ "name": "updateMenuShapeSize",
1336
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1337
+ "privacy": "private"
1350
1338
  },
1351
1339
  {
1352
- "name": "layout",
1353
- "type": {
1354
- "text": "string"
1355
- },
1356
- "description": "Sets the layout of the combobox.",
1357
- "default": "'classic'",
1358
- "fieldName": "layout",
1359
- "inheritedFrom": {
1360
- "name": "AuroElement",
1361
- "module": "components/layoutElement/src/auroElement.js"
1340
+ "kind": "method",
1341
+ "name": "_getAnnouncementRoot",
1342
+ "description": "Returns the shadow root containing the live region for screen reader announcements.\nWhen the bib is open in fullscreen modal mode, everything outside the <dialog>\nis inert, so we target the bib's own shadow root instead of the host's.",
1343
+ "privacy": "private",
1344
+ "return": {
1345
+ "type": {
1346
+ "text": "ShadowRoot"
1347
+ }
1362
1348
  }
1363
1349
  },
1364
1350
  {
1365
- "name": "matchWidth",
1366
- "type": {
1367
- "text": "boolean"
1368
- },
1369
- "description": "If declared, the popover and trigger will be set to the same width.",
1370
- "fieldName": "matchWidth"
1371
- },
1372
- {
1373
- "name": "noFilter",
1374
- "type": {
1375
- "text": "boolean"
1376
- },
1377
- "description": "If set, combobox will not filter menuoptions based on input.",
1378
- "fieldName": "noFilter"
1379
- },
1380
- {
1381
- "name": "noFlip",
1382
- "type": {
1383
- "text": "boolean"
1384
- },
1385
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1386
- "fieldName": "noFlip"
1387
- },
1388
- {
1389
- "name": "shift",
1390
- "type": {
1391
- "text": "boolean"
1392
- },
1393
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1394
- "fieldName": "shift"
1395
- },
1396
- {
1397
- "name": "noValidate",
1398
- "type": {
1399
- "text": "boolean"
1400
- },
1401
- "description": "If set, disables auto-validation on blur.",
1402
- "fieldName": "noValidate"
1403
- },
1404
- {
1405
- "name": "offset",
1406
- "type": {
1407
- "text": "number"
1408
- },
1409
- "description": "Gap between the trigger element and bib.",
1410
- "default": "0",
1411
- "fieldName": "offset"
1412
- },
1413
- {
1414
- "name": "onDark",
1415
- "type": {
1416
- "text": "boolean"
1417
- },
1418
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1419
- "fieldName": "onDark"
1420
- },
1421
- {
1422
- "name": "optionSelected",
1423
- "type": {
1424
- "text": "HTMLElement"
1425
- },
1426
- "description": "Specifies the current selected option.",
1427
- "fieldName": "optionSelected"
1428
- },
1429
- {
1430
- "name": "persistInput",
1431
- "type": {
1432
- "text": "boolean"
1433
- },
1434
- "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
1435
- "fieldName": "persistInput"
1436
- },
1437
- {
1438
- "name": "placement",
1439
- "type": {
1440
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1441
- },
1442
- "description": "Position where the bib should appear relative to the trigger.",
1443
- "default": "'bottom-start'",
1444
- "fieldName": "placement"
1445
- },
1446
- {
1447
- "name": "placeholder",
1448
- "type": {
1449
- "text": "string"
1450
- },
1451
- "description": "Define custom placeholder text, only supported by date input formats.",
1452
- "fieldName": "placeholder"
1453
- },
1454
- {
1455
- "name": "required",
1456
- "type": {
1457
- "text": "boolean"
1458
- },
1459
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1460
- "fieldName": "required"
1461
- },
1462
- {
1463
- "name": "setCustomValidity",
1464
- "type": {
1465
- "text": "string"
1466
- },
1467
- "description": "Sets a custom help text message to display for all validityStates.",
1468
- "fieldName": "setCustomValidity"
1469
- },
1470
- {
1471
- "name": "setCustomValidityCustomError",
1472
- "type": {
1473
- "text": "string"
1474
- },
1475
- "description": "Custom help text message to display when validity = `customError`.",
1476
- "fieldName": "setCustomValidityCustomError"
1477
- },
1478
- {
1479
- "name": "setCustomValidityValueMissing",
1480
- "type": {
1481
- "text": "string"
1482
- },
1483
- "description": "Custom help text message to display when validity = `valueMissing`.",
1484
- "fieldName": "setCustomValidityValueMissing"
1485
- },
1486
- {
1487
- "name": "setCustomValidityValueMissingFilter",
1488
- "type": {
1489
- "text": "string"
1490
- },
1491
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1492
- "fieldName": "setCustomValidityValueMissingFilter"
1493
- },
1494
- {
1495
- "name": "triggerIcon",
1496
- "type": {
1497
- "text": "boolean"
1498
- },
1499
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1500
- "fieldName": "triggerIcon"
1501
- },
1502
- {
1503
- "name": "type",
1504
- "type": {
1505
- "text": "string"
1506
- },
1507
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1508
- "fieldName": "type"
1509
- },
1510
- {
1511
- "name": "typedValue",
1512
- "type": {
1513
- "text": "string"
1514
- },
1515
- "description": "Specifies the value of the input element within the combobox.",
1516
- "fieldName": "typedValue"
1517
- },
1518
- {
1519
- "name": "validity",
1520
- "type": {
1521
- "text": "string"
1522
- },
1523
- "description": "Specifies the `validityState` this element is in.",
1524
- "fieldName": "validity"
1525
- },
1526
- {
1527
- "name": "value",
1528
- "type": {
1529
- "text": "string"
1530
- },
1531
- "description": "Value selected for the dropdown menu.",
1532
- "fieldName": "value"
1533
- },
1534
- {
1535
- "name": "largeFullscreenHeadline",
1536
- "type": {
1537
- "text": "boolean"
1538
- },
1539
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1540
- "fieldName": "largeFullscreenHeadline"
1541
- },
1542
- {
1543
- "name": "fullscreenBreakpoint",
1544
- "type": {
1545
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1546
- },
1547
- "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
1548
- "default": "'sm'",
1549
- "fieldName": "fullscreenBreakpoint"
1550
- },
1551
- {
1552
- "name": "shape",
1553
- "type": {
1554
- "text": "string"
1555
- },
1556
- "fieldName": "shape",
1557
- "inheritedFrom": {
1558
- "name": "AuroElement",
1559
- "module": "components/layoutElement/src/auroElement.js"
1351
+ "kind": "method",
1352
+ "name": "configureMenu",
1353
+ "description": "Binds all behavior needed to the menu after rendering.",
1354
+ "privacy": "private",
1355
+ "return": {
1356
+ "type": {
1357
+ "text": "void"
1358
+ }
1560
1359
  }
1561
1360
  },
1562
1361
  {
1563
- "name": "size",
1564
- "type": {
1565
- "text": "string"
1566
- },
1567
- "fieldName": "size",
1568
- "inheritedFrom": {
1569
- "name": "AuroElement",
1570
- "module": "components/layoutElement/src/auroElement.js"
1362
+ "kind": "method",
1363
+ "name": "configureInput",
1364
+ "description": "Binds all behavior needed to the input after rendering.",
1365
+ "privacy": "private",
1366
+ "return": {
1367
+ "type": {
1368
+ "text": "void"
1369
+ }
1571
1370
  }
1572
1371
  },
1573
1372
  {
1574
- "name": "ondark",
1575
- "type": {
1576
- "text": "boolean"
1577
- },
1578
- "fieldName": "onDark",
1579
- "inheritedFrom": {
1580
- "name": "AuroElement",
1581
- "module": "components/layoutElement/src/auroElement.js"
1582
- }
1583
- }
1584
- ],
1585
- "superclass": {
1586
- "name": "AuroElement",
1587
- "module": "/components/layoutElement/src/auroElement.js"
1588
- },
1589
- "tagName": "auro-combobox",
1590
- "customElement": true
1591
- }
1592
- ],
1593
- "exports": [
1594
- {
1595
- "kind": "js",
1596
- "name": "AuroCombobox",
1597
- "declaration": {
1598
- "name": "AuroCombobox",
1599
- "module": "components/combobox/src/auro-combobox.js"
1600
- }
1601
- }
1602
- ]
1603
- },
1604
- {
1605
- "kind": "javascript-module",
1606
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1607
- "declarations": [
1608
- {
1609
- "kind": "variable",
1610
- "name": "comboboxKeyboardStrategy",
1611
- "type": {
1612
- "text": "object"
1613
- },
1614
- "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.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
- ],
1617
- "exports": [
1618
- {
1619
- "kind": "js",
1620
- "name": "comboboxKeyboardStrategy",
1621
- "declaration": {
1622
- "name": "comboboxKeyboardStrategy",
1623
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1624
- }
1625
- }
1626
- ]
1627
- },
1628
- {
1629
- "kind": "javascript-module",
1630
- "path": "components/combobox/src/index.js",
1631
- "declarations": [],
1632
- "exports": [
1633
- {
1634
- "kind": "js",
1635
- "name": "AuroCombobox",
1636
- "declaration": {
1637
- "name": "AuroCombobox",
1638
- "module": "components/combobox/src/index.js"
1639
- }
1640
- }
1641
- ]
1642
- },
1643
- {
1644
- "kind": "javascript-module",
1645
- "path": "components/combobox/src/registered.js",
1646
- "declarations": [],
1647
- "exports": [
1648
- {
1649
- "kind": "js",
1650
- "name": "AuroCombobox",
1651
- "declaration": {
1652
- "name": "AuroCombobox",
1653
- "module": "components/combobox/src/registered.js"
1654
- }
1655
- }
1656
- ]
1657
- },
1658
- {
1659
- "kind": "javascript-module",
1660
- "path": "components/checkbox/src/auro-checkbox-group.js",
1661
- "declarations": [
1662
- {
1663
- "kind": "class",
1664
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1665
- "name": "AuroCheckboxGroup",
1666
- "slots": [
1373
+ "kind": "method",
1374
+ "name": "handleMenuLoadingChange",
1375
+ "parameters": [
1376
+ {
1377
+ "name": "event",
1378
+ "description": "The event object containing details about the loading state change.",
1379
+ "type": {
1380
+ "text": "CustomEvent"
1381
+ }
1382
+ },
1383
+ {
1384
+ "description": "Indicates whether the menu is currently loading.",
1385
+ "name": "event.detail.loading",
1386
+ "type": {
1387
+ "text": "boolean"
1388
+ }
1389
+ },
1390
+ {
1391
+ "description": "Indicates if there are loading placeholders present.",
1392
+ "name": "event.detail.hasLoadingPlaceholder",
1393
+ "type": {
1394
+ "text": "boolean"
1395
+ }
1396
+ }
1397
+ ],
1398
+ "description": "Manages the visibility of the dropdown based on loading state changes.\n\nThis method listens for loading state changes and adjusts the visibility of the dropdown accordingly.\nIf the dropdown is visible and loading is true without any loading placeholders, it hides the dropdown\nand sets a flag to indicate it is hidden while loading. If loading is false and the dropdown was previously\nhidden, it checks if the active element is within the dropdown and shows it again if true.",
1399
+ "privacy": "private",
1400
+ "return": {
1401
+ "type": {
1402
+ "text": "void"
1403
+ }
1404
+ }
1405
+ },
1667
1406
  {
1668
- "description": "Allows for the legend to be overridden.",
1669
- "name": "legend"
1407
+ "kind": "method",
1408
+ "name": "handleInputValueChange",
1409
+ "parameters": [
1410
+ {
1411
+ "name": "event",
1412
+ "description": "The input event triggered by the input element.",
1413
+ "type": {
1414
+ "text": "Event"
1415
+ }
1416
+ }
1417
+ ],
1418
+ "description": "Handle changes to the input value and trigger changes that should result.",
1419
+ "privacy": "private",
1420
+ "return": {
1421
+ "type": {
1422
+ "text": "void"
1423
+ }
1424
+ }
1670
1425
  },
1671
1426
  {
1672
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1673
- "name": "optionalLabel"
1427
+ "kind": "method",
1428
+ "name": "configureCombobox",
1429
+ "description": "Binds all behavior needed to the combobox after rendering.",
1430
+ "privacy": "private",
1431
+ "return": {
1432
+ "type": {
1433
+ "text": "void"
1434
+ }
1435
+ }
1674
1436
  },
1675
1437
  {
1676
- "description": "Allows for the helper text to be overridden.",
1677
- "name": "helpText"
1438
+ "kind": "method",
1439
+ "name": "focus",
1440
+ "description": "Focuses the combobox trigger input.",
1441
+ "return": {
1442
+ "type": {
1443
+ "text": "void"
1444
+ }
1445
+ }
1678
1446
  },
1679
1447
  {
1680
- "description": "The default slot for the checkbox items.",
1681
- "name": "default"
1682
- }
1683
- ],
1684
- "members": [
1448
+ "kind": "method",
1449
+ "name": "setMenuValue",
1450
+ "parameters": [
1451
+ {
1452
+ "name": "value",
1453
+ "description": "The value to set on the menu.",
1454
+ "type": {
1455
+ "text": "string"
1456
+ }
1457
+ }
1458
+ ],
1459
+ "description": "Sets the menu value if menu is available.",
1460
+ "return": {
1461
+ "type": {
1462
+ "text": "void"
1463
+ }
1464
+ }
1465
+ },
1685
1466
  {
1686
1467
  "kind": "method",
1687
- "name": "_initializeDefaults"
1468
+ "name": "reset",
1469
+ "description": "Resets component to initial state.",
1470
+ "return": {
1471
+ "type": {
1472
+ "text": "void"
1473
+ }
1474
+ }
1688
1475
  },
1689
1476
  {
1690
1477
  "kind": "method",
1691
- "name": "register",
1692
- "static": true,
1478
+ "name": "clear",
1479
+ "description": "Clears the current value of the combobox.",
1480
+ "return": {
1481
+ "type": {
1482
+ "text": "void"
1483
+ }
1484
+ }
1485
+ },
1486
+ {
1487
+ "kind": "method",
1488
+ "name": "validate",
1693
1489
  "parameters": [
1694
1490
  {
1695
- "name": "name",
1696
- "default": "\"auro-checkbox-group\"",
1697
- "description": "The name of the element that you want to register.",
1491
+ "name": "force",
1492
+ "default": "false",
1493
+ "description": "Whether to force validation.",
1698
1494
  "optional": true,
1699
1495
  "type": {
1700
- "text": "string"
1496
+ "text": "boolean"
1701
1497
  }
1702
1498
  }
1703
1499
  ],
1704
- "description": "This will register this element with the browser."
1500
+ "description": "Validates value."
1705
1501
  },
1706
1502
  {
1707
1503
  "kind": "method",
1708
- "name": "handleValueUpdate",
1504
+ "name": "transportAssignedNodes",
1709
1505
  "parameters": [
1710
1506
  {
1711
- "name": "value",
1712
- "description": "The value of the checkbox.",
1507
+ "name": "slot",
1508
+ "description": "The slot element containing the nodes to apply.",
1713
1509
  "type": {
1714
- "text": "String"
1510
+ "text": "HTMLSlotElement"
1715
1511
  }
1716
1512
  },
1717
1513
  {
1718
- "name": "selected",
1719
- "description": "The checked state of the checkbox.",
1514
+ "name": "target",
1515
+ "description": "The target element to apply the nodes to.",
1720
1516
  "type": {
1721
- "text": "Boolean"
1517
+ "text": "HTMLElement"
1518
+ }
1519
+ },
1520
+ {
1521
+ "name": "newSlotName",
1522
+ "description": "The new slot name for the applied nodes.",
1523
+ "type": {
1524
+ "text": "string"
1722
1525
  }
1723
1526
  }
1724
1527
  ],
1725
- "description": "Helper method to handle checkbox value changing.",
1528
+ "description": "Applies slotted nodes to a target element with a new slot name.",
1529
+ "privacy": "private",
1530
+ "return": {
1531
+ "type": {
1532
+ "text": "void"
1533
+ }
1534
+ }
1535
+ },
1536
+ {
1537
+ "kind": "method",
1538
+ "name": "updateActiveOption",
1539
+ "parameters": [
1540
+ {
1541
+ "name": "index",
1542
+ "description": "Index of the option to make active.",
1543
+ "type": {
1544
+ "text": "number"
1545
+ }
1546
+ }
1547
+ ],
1548
+ "description": "Updates the active option in the menu."
1549
+ },
1550
+ {
1551
+ "kind": "method",
1552
+ "name": "handleSlotChange",
1553
+ "parameters": [
1554
+ {
1555
+ "name": "event",
1556
+ "description": "`slotchange` event.",
1557
+ "type": {
1558
+ "text": "Event"
1559
+ }
1560
+ }
1561
+ ],
1562
+ "description": "Watch for slot changes and recalculate the menuoptions.",
1726
1563
  "privacy": "private",
1727
1564
  "return": {
1728
1565
  "type": {
@@ -1731,96 +1568,203 @@
1731
1568
  }
1732
1569
  },
1733
1570
  {
1734
- "kind": "method",
1735
- "name": "handlePreselectedItems",
1736
- "description": "Helper method that handles the state of preselected checkboxes.",
1571
+ "kind": "field",
1572
+ "name": "appearance",
1573
+ "privacy": "public",
1574
+ "type": {
1575
+ "text": "string"
1576
+ },
1577
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1578
+ "default": "'default'",
1579
+ "attribute": "appearance",
1580
+ "reflects": true
1581
+ },
1582
+ {
1583
+ "kind": "field",
1584
+ "name": "autocomplete",
1585
+ "privacy": "public",
1586
+ "type": {
1587
+ "text": "string"
1588
+ },
1589
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1590
+ "attribute": "autocomplete",
1591
+ "reflects": true
1592
+ },
1593
+ {
1594
+ "kind": "field",
1595
+ "name": "autoPlacement",
1596
+ "privacy": "public",
1597
+ "type": {
1598
+ "text": "boolean"
1599
+ },
1600
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1601
+ "attribute": "autoPlacement",
1602
+ "reflects": true
1603
+ },
1604
+ {
1605
+ "kind": "field",
1606
+ "name": "availableOptions",
1607
+ "privacy": "private",
1608
+ "type": {
1609
+ "text": "array"
1610
+ },
1611
+ "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
1612
+ "attribute": "availableOptions"
1613
+ },
1614
+ {
1615
+ "kind": "field",
1616
+ "name": "behavior",
1617
+ "privacy": "public",
1618
+ "type": {
1619
+ "text": "'filter' | 'suggestion'"
1620
+ },
1621
+ "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
1622
+ "default": "'suggestion'",
1623
+ "attribute": "behavior",
1624
+ "reflects": true
1625
+ },
1626
+ {
1627
+ "kind": "field",
1628
+ "name": "checkmark",
1629
+ "privacy": "public",
1630
+ "type": {
1631
+ "text": "boolean"
1632
+ },
1633
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1634
+ "attribute": "checkmark",
1635
+ "reflects": true
1636
+ },
1637
+ {
1638
+ "kind": "field",
1639
+ "name": "disabled",
1640
+ "privacy": "public",
1641
+ "type": {
1642
+ "text": "boolean"
1643
+ },
1644
+ "description": "If set, disables the combobox.",
1645
+ "attribute": "disabled",
1646
+ "reflects": true
1647
+ },
1648
+ {
1649
+ "kind": "field",
1650
+ "name": "dropdownId",
1651
+ "privacy": "private",
1652
+ "type": {
1653
+ "text": "string"
1654
+ },
1655
+ "description": "ID for the dropdown."
1656
+ },
1657
+ {
1658
+ "kind": "field",
1659
+ "name": "dropdownOpen",
1737
1660
  "privacy": "private",
1738
- "return": {
1739
- "type": {
1740
- "text": "void"
1741
- }
1742
- }
1661
+ "type": {
1662
+ "text": "boolean"
1663
+ },
1664
+ "description": "Whether or not the dropdown is open."
1743
1665
  },
1744
1666
  {
1745
- "kind": "method",
1746
- "name": "handleItems",
1747
- "description": "Helper method that handles the state of checkboxes.",
1748
- "privacy": "private",
1749
- "return": {
1750
- "type": {
1751
- "text": "void"
1752
- }
1753
- }
1667
+ "kind": "field",
1668
+ "name": "dvInputOnly",
1669
+ "privacy": "public",
1670
+ "type": {
1671
+ "text": "boolean"
1672
+ },
1673
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1674
+ "attribute": "dvInputOnly",
1675
+ "reflects": true
1754
1676
  },
1755
1677
  {
1756
- "kind": "method",
1757
- "name": "reset",
1758
- "description": "Resets component to initial state.",
1759
- "return": {
1760
- "type": {
1761
- "text": "void"
1762
- }
1763
- }
1678
+ "kind": "field",
1679
+ "name": "error",
1680
+ "privacy": "public",
1681
+ "type": {
1682
+ "text": "string"
1683
+ },
1684
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1685
+ "attribute": "error",
1686
+ "reflects": true
1764
1687
  },
1765
1688
  {
1766
- "kind": "method",
1767
- "name": "validate",
1768
- "parameters": [
1769
- {
1770
- "name": "force",
1771
- "default": "false",
1772
- "description": "Whether to force validation.",
1773
- "optional": true,
1774
- "type": {
1775
- "text": "boolean"
1776
- }
1777
- }
1778
- ],
1779
- "description": "Validates value."
1689
+ "kind": "field",
1690
+ "name": "format",
1691
+ "privacy": "public",
1692
+ "type": {
1693
+ "text": "string"
1694
+ },
1695
+ "description": "Specifies the input mask format.",
1696
+ "attribute": "format",
1697
+ "reflects": true
1780
1698
  },
1781
1699
  {
1782
1700
  "kind": "field",
1783
- "name": "appearance",
1701
+ "name": "inputmode",
1784
1702
  "privacy": "public",
1785
1703
  "type": {
1786
- "text": "'default' | 'inverse'"
1704
+ "text": "string"
1787
1705
  },
1788
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1789
- "default": "'default'",
1790
- "attribute": "appearance",
1706
+ "description": "Exposes inputmode attribute for input.",
1707
+ "attribute": "inputmode",
1791
1708
  "reflects": true
1792
1709
  },
1793
1710
  {
1794
1711
  "kind": "field",
1795
- "name": "disabled",
1712
+ "name": "layout",
1796
1713
  "privacy": "public",
1714
+ "type": {
1715
+ "text": "string"
1716
+ },
1717
+ "description": "Sets the layout of the combobox.",
1718
+ "default": "'classic'",
1719
+ "attribute": "layout",
1720
+ "reflects": true,
1721
+ "inheritedFrom": {
1722
+ "name": "AuroElement",
1723
+ "module": "components/layoutElement/src/auroElement.js"
1724
+ }
1725
+ },
1726
+ {
1727
+ "kind": "field",
1728
+ "name": "matchWidth",
1729
+ "privacy": "private",
1797
1730
  "type": {
1798
1731
  "text": "boolean"
1799
1732
  },
1800
- "description": "If set, disables the checkbox group.",
1801
- "attribute": "disabled",
1733
+ "description": "If declared, the popover and trigger will be set to the same width.",
1734
+ "attribute": "matchWidth",
1802
1735
  "reflects": true
1803
1736
  },
1804
1737
  {
1805
1738
  "kind": "field",
1806
- "name": "error",
1739
+ "name": "noFilter",
1807
1740
  "privacy": "public",
1808
1741
  "type": {
1809
- "text": "string"
1742
+ "text": "boolean"
1810
1743
  },
1811
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1812
- "attribute": "error",
1744
+ "description": "If set, combobox will not filter menuoptions based on input.",
1745
+ "attribute": "noFilter",
1813
1746
  "reflects": true
1814
1747
  },
1815
1748
  {
1816
1749
  "kind": "field",
1817
- "name": "horizontal",
1750
+ "name": "noFlip",
1818
1751
  "privacy": "public",
1819
1752
  "type": {
1820
1753
  "text": "boolean"
1821
1754
  },
1822
- "description": "If set, checkboxes will be aligned horizontally.",
1823
- "attribute": "horizontal",
1755
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1756
+ "attribute": "noFlip",
1757
+ "reflects": true
1758
+ },
1759
+ {
1760
+ "kind": "field",
1761
+ "name": "shift",
1762
+ "privacy": "public",
1763
+ "type": {
1764
+ "text": "boolean"
1765
+ },
1766
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1767
+ "attribute": "shift",
1824
1768
  "reflects": true
1825
1769
  },
1826
1770
  {
@@ -1834,6 +1778,18 @@
1834
1778
  "attribute": "noValidate",
1835
1779
  "reflects": true
1836
1780
  },
1781
+ {
1782
+ "kind": "field",
1783
+ "name": "offset",
1784
+ "privacy": "public",
1785
+ "type": {
1786
+ "text": "number"
1787
+ },
1788
+ "description": "Gap between the trigger element and bib.",
1789
+ "default": "0",
1790
+ "attribute": "offset",
1791
+ "reflects": true
1792
+ },
1837
1793
  {
1838
1794
  "kind": "field",
1839
1795
  "name": "onDark",
@@ -1841,8 +1797,56 @@
1841
1797
  "type": {
1842
1798
  "text": "boolean"
1843
1799
  },
1844
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1845
1800
  "attribute": "onDark",
1801
+ "reflects": true,
1802
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1803
+ "inheritedFrom": {
1804
+ "name": "AuroElement",
1805
+ "module": "components/layoutElement/src/auroElement.js"
1806
+ }
1807
+ },
1808
+ {
1809
+ "kind": "field",
1810
+ "name": "optionSelected",
1811
+ "privacy": "public",
1812
+ "type": {
1813
+ "text": "HTMLElement"
1814
+ },
1815
+ "description": "Specifies the current selected option.",
1816
+ "attribute": "optionSelected"
1817
+ },
1818
+ {
1819
+ "kind": "field",
1820
+ "name": "persistInput",
1821
+ "privacy": "public",
1822
+ "type": {
1823
+ "text": "boolean"
1824
+ },
1825
+ "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
1826
+ "attribute": "persistInput",
1827
+ "reflects": true
1828
+ },
1829
+ {
1830
+ "kind": "field",
1831
+ "name": "placement",
1832
+ "privacy": "public",
1833
+ "type": {
1834
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1835
+ },
1836
+ "description": "Position where the bib should appear relative to the trigger.",
1837
+ "default": "'bottom-start'",
1838
+ "attribute": "placement",
1839
+ "reflects": true
1840
+ },
1841
+ {
1842
+ "kind": "field",
1843
+ "name": "placeholder",
1844
+ "privacy": "public",
1845
+ "type": {
1846
+ "text": "string"
1847
+ },
1848
+ "description": "Define custom placeholder text, only supported by date input formats.",
1849
+ "attribute": "placeholder",
1846
1850
  "reflects": true
1847
1851
  },
1848
1852
  {
@@ -1852,7 +1856,7 @@
1852
1856
  "type": {
1853
1857
  "text": "boolean"
1854
1858
  },
1855
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1859
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1856
1860
  "attribute": "required",
1857
1861
  "reflects": true
1858
1862
  },
@@ -1888,615 +1892,611 @@
1888
1892
  },
1889
1893
  {
1890
1894
  "kind": "field",
1891
- "name": "validity",
1895
+ "name": "setCustomValidityValueMissingFilter",
1892
1896
  "privacy": "public",
1893
1897
  "type": {
1894
1898
  "text": "string"
1895
1899
  },
1896
- "description": "Specifies the `validityState` this element is in.",
1897
- "attribute": "validity",
1898
- "reflects": true
1899
- }
1900
- ],
1901
- "events": [
1900
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1901
+ "attribute": "setCustomValidityValueMissingFilter"
1902
+ },
1902
1903
  {
1903
- "name": "input",
1904
+ "kind": "field",
1905
+ "name": "touched",
1906
+ "privacy": "private",
1904
1907
  "type": {
1905
- "text": "CustomEvent"
1906
- }
1908
+ "text": "boolean"
1909
+ },
1910
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1907
1911
  },
1908
1912
  {
1909
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1910
- "name": "auroFormElement-validated"
1911
- }
1912
- ],
1913
- "attributes": [
1913
+ "kind": "field",
1914
+ "name": "triggerIcon",
1915
+ "privacy": "public",
1916
+ "type": {
1917
+ "text": "boolean"
1918
+ },
1919
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1920
+ "attribute": "triggerIcon",
1921
+ "reflects": true
1922
+ },
1914
1923
  {
1915
- "name": "appearance",
1924
+ "kind": "field",
1925
+ "name": "type",
1926
+ "privacy": "public",
1916
1927
  "type": {
1917
- "text": "'default' | 'inverse'"
1928
+ "text": "string"
1918
1929
  },
1919
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1920
- "default": "'default'",
1921
- "fieldName": "appearance"
1930
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1931
+ "attribute": "type",
1932
+ "reflects": true
1922
1933
  },
1923
1934
  {
1924
- "name": "disabled",
1935
+ "kind": "field",
1936
+ "name": "typedValue",
1937
+ "privacy": "public",
1938
+ "type": {
1939
+ "text": "string"
1940
+ },
1941
+ "description": "Specifies the value of the input element within the combobox.",
1942
+ "attribute": "typedValue",
1943
+ "reflects": true
1944
+ },
1945
+ {
1946
+ "kind": "field",
1947
+ "name": "validity",
1948
+ "privacy": "public",
1925
1949
  "type": {
1926
- "text": "boolean"
1950
+ "text": "string"
1927
1951
  },
1928
- "description": "If set, disables the checkbox group.",
1929
- "fieldName": "disabled"
1952
+ "description": "Specifies the `validityState` this element is in.",
1953
+ "attribute": "validity",
1954
+ "reflects": true
1930
1955
  },
1931
1956
  {
1932
- "name": "error",
1957
+ "kind": "field",
1958
+ "name": "value",
1959
+ "privacy": "public",
1933
1960
  "type": {
1934
1961
  "text": "string"
1935
1962
  },
1936
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1937
- "fieldName": "error"
1963
+ "description": "Value selected for the dropdown menu.",
1964
+ "attribute": "value"
1938
1965
  },
1939
1966
  {
1940
- "name": "horizontal",
1967
+ "kind": "field",
1968
+ "name": "largeFullscreenHeadline",
1969
+ "privacy": "public",
1941
1970
  "type": {
1942
1971
  "text": "boolean"
1943
1972
  },
1944
- "description": "If set, checkboxes will be aligned horizontally.",
1945
- "fieldName": "horizontal"
1973
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1974
+ "attribute": "largeFullscreenHeadline",
1975
+ "reflects": true
1946
1976
  },
1947
1977
  {
1948
- "name": "noValidate",
1978
+ "kind": "field",
1979
+ "name": "fullscreenBreakpoint",
1980
+ "privacy": "public",
1949
1981
  "type": {
1950
- "text": "boolean"
1982
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1951
1983
  },
1952
- "description": "If set, disables auto-validation on blur.",
1953
- "fieldName": "noValidate"
1984
+ "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
1985
+ "default": "'sm'",
1986
+ "attribute": "fullscreenBreakpoint",
1987
+ "reflects": true
1954
1988
  },
1955
1989
  {
1956
- "name": "onDark",
1990
+ "kind": "field",
1991
+ "name": "optionActive",
1992
+ "privacy": "private",
1957
1993
  "type": {
1958
- "text": "boolean"
1994
+ "text": "object"
1959
1995
  },
1960
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1961
- "fieldName": "onDark"
1996
+ "description": "Specifies the currently active option."
1962
1997
  },
1963
1998
  {
1964
- "name": "required",
1999
+ "kind": "field",
2000
+ "name": "triggerExpandedState",
2001
+ "privacy": "private",
1965
2002
  "type": {
1966
2003
  "text": "boolean"
1967
2004
  },
1968
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1969
- "fieldName": "required"
2005
+ "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1970
2006
  },
1971
2007
  {
1972
- "name": "setCustomValidity",
1973
- "type": {
1974
- "text": "string"
2008
+ "kind": "field",
2009
+ "name": "componentHasFocus",
2010
+ "description": "Returns true if the element has focus.",
2011
+ "privacy": "private",
2012
+ "return": {
2013
+ "type": {
2014
+ "text": "boolean"
2015
+ }
1975
2016
  },
1976
- "description": "Sets a custom help text message to display for all validityStates.",
1977
- "fieldName": "setCustomValidity"
2017
+ "readonly": true,
2018
+ "inheritedFrom": {
2019
+ "name": "AuroElement",
2020
+ "module": "components/layoutElement/src/auroElement.js"
2021
+ }
1978
2022
  },
1979
2023
  {
1980
- "name": "setCustomValidityCustomError",
1981
- "type": {
1982
- "text": "string"
1983
- },
1984
- "description": "Custom help text message to display when validity = `customError`.",
1985
- "fieldName": "setCustomValidityCustomError"
2024
+ "kind": "method",
2025
+ "name": "resetShapeClasses",
2026
+ "inheritedFrom": {
2027
+ "name": "AuroElement",
2028
+ "module": "components/layoutElement/src/auroElement.js"
2029
+ }
1986
2030
  },
1987
2031
  {
1988
- "name": "setCustomValidityValueMissing",
2032
+ "kind": "method",
2033
+ "name": "resetLayoutClasses",
2034
+ "inheritedFrom": {
2035
+ "name": "AuroElement",
2036
+ "module": "components/layoutElement/src/auroElement.js"
2037
+ }
2038
+ },
2039
+ {
2040
+ "kind": "method",
2041
+ "name": "updateComponentArchitecture",
2042
+ "inheritedFrom": {
2043
+ "name": "AuroElement",
2044
+ "module": "components/layoutElement/src/auroElement.js"
2045
+ }
2046
+ },
2047
+ {
2048
+ "kind": "field",
2049
+ "name": "shape",
2050
+ "privacy": "public",
1989
2051
  "type": {
1990
2052
  "text": "string"
1991
2053
  },
1992
- "description": "Custom help text message to display when validity = `valueMissing`.",
1993
- "fieldName": "setCustomValidityValueMissing"
2054
+ "attribute": "shape",
2055
+ "reflects": true,
2056
+ "inheritedFrom": {
2057
+ "name": "AuroElement",
2058
+ "module": "components/layoutElement/src/auroElement.js"
2059
+ }
1994
2060
  },
1995
2061
  {
1996
- "name": "validity",
2062
+ "kind": "field",
2063
+ "name": "size",
2064
+ "privacy": "public",
1997
2065
  "type": {
1998
2066
  "text": "string"
1999
2067
  },
2000
- "description": "Specifies the `validityState` this element is in.",
2001
- "fieldName": "validity"
2068
+ "attribute": "size",
2069
+ "reflects": true,
2070
+ "inheritedFrom": {
2071
+ "name": "AuroElement",
2072
+ "module": "components/layoutElement/src/auroElement.js"
2073
+ }
2002
2074
  }
2003
2075
  ],
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": [
2076
+ "events": [
2032
2077
  {
2033
- "description": "apply css to a specific checkbox.",
2034
- "name": "checkbox"
2078
+ "name": "inputValue",
2079
+ "type": {
2080
+ "text": "CustomEvent"
2081
+ },
2082
+ "description": "Notifies that the components internal HTML5 input value has changed."
2035
2083
  },
2036
2084
  {
2037
- "description": "apply css to a specific checkbox's input.",
2038
- "name": "checkbox-input"
2085
+ "name": "input",
2086
+ "type": {
2087
+ "text": "CustomEvent"
2088
+ },
2089
+ "description": "Notifies that the component has a new value set."
2039
2090
  },
2040
2091
  {
2041
- "description": "apply css to a specific checkbox's label.",
2042
- "name": "checkbox-label"
2043
- }
2044
- ],
2045
- "slots": [
2092
+ "name": "auroCombobox-valueSet",
2093
+ "type": {
2094
+ "text": "CustomEvent"
2095
+ },
2096
+ "description": "(Deprecated) Notifies that the component has a new value set."
2097
+ },
2046
2098
  {
2047
- "description": "The default slot for the checkbox label.",
2048
- "name": "default"
2099
+ "description": "Notifies that the component value(s) have been validated.",
2100
+ "name": "auroFormElement-validated"
2049
2101
  }
2050
2102
  ],
2051
- "members": [
2052
- {
2053
- "kind": "method",
2054
- "name": "_initializeDefaults"
2055
- },
2056
- {
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."
2072
- },
2073
- {
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.",
2086
- "privacy": "private",
2087
- "return": {
2088
- "type": {
2089
- "text": "void"
2090
- }
2091
- }
2092
- },
2093
- {
2094
- "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
- }
2111
- }
2112
- },
2103
+ "attributes": [
2113
2104
  {
2114
- "kind": "method",
2115
- "name": "handleFocusin",
2116
- "description": "Function to support",
2117
- "privacy": "private",
2118
- "return": {
2119
- "type": {
2120
- "text": "void"
2121
- }
2122
- }
2105
+ "name": "appearance",
2106
+ "type": {
2107
+ "text": "string"
2108
+ },
2109
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2110
+ "default": "'default'",
2111
+ "fieldName": "appearance"
2123
2112
  },
2124
2113
  {
2125
- "kind": "method",
2126
- "name": "generateIconHtml",
2127
- "description": "Function to generate checkmark svg.",
2128
- "privacy": "private",
2129
- "return": {
2130
- "type": {
2131
- "text": "HTMLElement"
2132
- }
2133
- }
2114
+ "name": "autocomplete",
2115
+ "type": {
2116
+ "text": "string"
2117
+ },
2118
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2119
+ "fieldName": "autocomplete"
2134
2120
  },
2135
2121
  {
2136
- "kind": "method",
2137
- "name": "reset",
2138
- "description": "Resets component to initial state.",
2139
- "return": {
2140
- "type": {
2141
- "text": "void"
2142
- }
2143
- }
2122
+ "name": "autoPlacement",
2123
+ "type": {
2124
+ "text": "boolean"
2125
+ },
2126
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
2127
+ "fieldName": "autoPlacement"
2144
2128
  },
2145
2129
  {
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
- }
2130
+ "name": "availableOptions",
2131
+ "type": {
2132
+ "text": "array"
2133
+ },
2134
+ "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
2135
+ "fieldName": "availableOptions"
2155
2136
  },
2156
2137
  {
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
- }
2138
+ "name": "behavior",
2139
+ "type": {
2140
+ "text": "'filter' | 'suggestion'"
2141
+ },
2142
+ "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
2143
+ "default": "'suggestion'",
2144
+ "fieldName": "behavior"
2175
2145
  },
2176
2146
  {
2177
- "kind": "field",
2178
- "name": "appearance",
2179
- "privacy": "public",
2147
+ "name": "checkmark",
2180
2148
  "type": {
2181
- "text": "'default' | 'inverse'"
2149
+ "text": "boolean"
2182
2150
  },
2183
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2184
- "default": "'default'",
2185
- "attribute": "appearance",
2186
- "reflects": true
2151
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
2152
+ "fieldName": "checkmark"
2187
2153
  },
2188
2154
  {
2189
- "kind": "field",
2190
- "name": "checked",
2191
- "privacy": "public",
2155
+ "name": "disabled",
2192
2156
  "type": {
2193
2157
  "text": "boolean"
2194
2158
  },
2195
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2196
- "attribute": "checked",
2197
- "reflects": true
2159
+ "description": "If set, disables the combobox.",
2160
+ "fieldName": "disabled"
2198
2161
  },
2199
2162
  {
2200
- "kind": "field",
2201
- "name": "disabled",
2202
- "privacy": "public",
2163
+ "name": "dvInputOnly",
2203
2164
  "type": {
2204
2165
  "text": "boolean"
2205
2166
  },
2206
- "description": "If set to true, the checkbox will not be clickable.",
2207
- "attribute": "disabled",
2208
- "reflects": true
2167
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2168
+ "fieldName": "dvInputOnly"
2209
2169
  },
2210
2170
  {
2211
- "kind": "field",
2212
2171
  "name": "error",
2213
- "privacy": "public",
2214
2172
  "type": {
2215
- "text": "boolean"
2173
+ "text": "string"
2216
2174
  },
2217
- "description": "If set to true, the checkbox will be displayed with an error state.",
2218
- "attribute": "error",
2219
- "reflects": true
2175
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2176
+ "fieldName": "error"
2220
2177
  },
2221
2178
  {
2222
- "kind": "field",
2223
- "name": "id",
2224
- "privacy": "public",
2179
+ "name": "format",
2225
2180
  "type": {
2226
2181
  "text": "string"
2227
2182
  },
2228
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2229
- "attribute": "id",
2230
- "reflects": true
2183
+ "description": "Specifies the input mask format.",
2184
+ "fieldName": "format"
2231
2185
  },
2232
2186
  {
2233
- "kind": "field",
2234
- "name": "inputId",
2235
- "privacy": "private",
2187
+ "name": "inputmode",
2236
2188
  "type": {
2237
2189
  "text": "string"
2238
2190
  },
2239
- "description": "The id for input node."
2191
+ "description": "Exposes inputmode attribute for input.",
2192
+ "fieldName": "inputmode"
2240
2193
  },
2241
2194
  {
2242
- "kind": "field",
2243
- "name": "name",
2244
- "privacy": "public",
2195
+ "name": "layout",
2245
2196
  "type": {
2246
2197
  "text": "string"
2247
2198
  },
2248
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2249
- "attribute": "name"
2199
+ "description": "Sets the layout of the combobox.",
2200
+ "default": "'classic'",
2201
+ "fieldName": "layout",
2202
+ "inheritedFrom": {
2203
+ "name": "AuroElement",
2204
+ "module": "components/layoutElement/src/auroElement.js"
2205
+ }
2250
2206
  },
2251
2207
  {
2252
- "kind": "field",
2253
- "name": "onDark",
2254
- "privacy": "public",
2208
+ "name": "matchWidth",
2255
2209
  "type": {
2256
2210
  "text": "boolean"
2257
2211
  },
2258
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2259
- "attribute": "onDark",
2260
- "reflects": true
2212
+ "description": "If declared, the popover and trigger will be set to the same width.",
2213
+ "fieldName": "matchWidth"
2261
2214
  },
2262
2215
  {
2263
- "kind": "field",
2264
- "name": "touched",
2265
- "privacy": "private",
2216
+ "name": "noFilter",
2266
2217
  "type": {
2267
2218
  "text": "boolean"
2268
2219
  },
2269
- "description": "Indicates whether the checkbox has been interacted with."
2220
+ "description": "If set, combobox will not filter menuoptions based on input.",
2221
+ "fieldName": "noFilter"
2270
2222
  },
2271
2223
  {
2272
- "kind": "field",
2273
- "name": "value",
2274
- "privacy": "public",
2224
+ "name": "noFlip",
2275
2225
  "type": {
2276
- "text": "string"
2226
+ "text": "boolean"
2277
2227
  },
2278
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2279
- "attribute": "value"
2228
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2229
+ "fieldName": "noFlip"
2280
2230
  },
2281
2231
  {
2282
- "kind": "field",
2283
- "name": "tabIndex",
2284
- "privacy": "private",
2232
+ "name": "shift",
2233
+ "type": {
2234
+ "text": "boolean"
2235
+ },
2236
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2237
+ "fieldName": "shift"
2238
+ },
2239
+ {
2240
+ "name": "noValidate",
2241
+ "type": {
2242
+ "text": "boolean"
2243
+ },
2244
+ "description": "If set, disables auto-validation on blur.",
2245
+ "fieldName": "noValidate"
2246
+ },
2247
+ {
2248
+ "name": "offset",
2285
2249
  "type": {
2286
2250
  "text": "number"
2287
2251
  },
2288
- "description": "The tabindex attribute for the checkbox.",
2289
- "attribute": "tabindex",
2290
- "reflects": true
2252
+ "description": "Gap between the trigger element and bib.",
2253
+ "default": "0",
2254
+ "fieldName": "offset"
2291
2255
  },
2292
2256
  {
2293
- "kind": "field",
2294
- "name": "ariaChecked",
2295
- "privacy": "private",
2257
+ "name": "onDark",
2296
2258
  "type": {
2297
- "text": "string"
2259
+ "text": "boolean"
2298
2260
  },
2299
- "description": "The aria-checked attribute for the checkbox.",
2300
- "attribute": "aria-checked",
2301
- "reflects": true
2261
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2262
+ "fieldName": "onDark"
2302
2263
  },
2303
2264
  {
2304
- "kind": "field",
2305
- "name": "ariaDisabled",
2306
- "privacy": "private",
2265
+ "name": "optionSelected",
2307
2266
  "type": {
2308
- "text": "string"
2267
+ "text": "HTMLElement"
2309
2268
  },
2310
- "description": "The aria-disabled attribute for the checkbox.",
2311
- "attribute": "aria-disabled",
2312
- "reflects": true
2269
+ "description": "Specifies the current selected option.",
2270
+ "fieldName": "optionSelected"
2313
2271
  },
2314
2272
  {
2315
- "kind": "field",
2316
- "name": "role",
2317
- "privacy": "private",
2273
+ "name": "persistInput",
2318
2274
  "type": {
2319
- "text": "string"
2275
+ "text": "boolean"
2320
2276
  },
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": [
2277
+ "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
2278
+ "fieldName": "persistInput"
2279
+ },
2327
2280
  {
2328
- "name": "auroCheckbox-input",
2281
+ "name": "placement",
2329
2282
  "type": {
2330
- "text": "CustomEvent"
2331
- }
2283
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2284
+ },
2285
+ "description": "Position where the bib should appear relative to the trigger.",
2286
+ "default": "'bottom-start'",
2287
+ "fieldName": "placement"
2332
2288
  },
2333
2289
  {
2334
- "name": "auroCheckbox-focusin",
2290
+ "name": "placeholder",
2335
2291
  "type": {
2336
- "text": "CustomEvent"
2337
- }
2292
+ "text": "string"
2293
+ },
2294
+ "description": "Define custom placeholder text, only supported by date input formats.",
2295
+ "fieldName": "placeholder"
2296
+ },
2297
+ {
2298
+ "name": "required",
2299
+ "type": {
2300
+ "text": "boolean"
2301
+ },
2302
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2303
+ "fieldName": "required"
2338
2304
  },
2339
2305
  {
2340
- "name": "auroCheckbox-focusout",
2306
+ "name": "setCustomValidity",
2341
2307
  "type": {
2342
- "text": "CustomEvent"
2343
- }
2344
- },
2345
- {
2346
- "description": "(Deprecated) Notifies when checked value is changed.",
2347
- "name": "change"
2308
+ "text": "string"
2309
+ },
2310
+ "description": "Sets a custom help text message to display for all validityStates.",
2311
+ "fieldName": "setCustomValidity"
2348
2312
  },
2349
2313
  {
2350
- "description": "Notifies when when checked value is changed by user's interface.",
2351
- "name": "input"
2352
- }
2353
- ],
2354
- "attributes": [
2355
- {
2356
- "name": "appearance",
2314
+ "name": "setCustomValidityCustomError",
2357
2315
  "type": {
2358
- "text": "'default' | 'inverse'"
2316
+ "text": "string"
2359
2317
  },
2360
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2361
- "default": "'default'",
2362
- "fieldName": "appearance"
2318
+ "description": "Custom help text message to display when validity = `customError`.",
2319
+ "fieldName": "setCustomValidityCustomError"
2363
2320
  },
2364
2321
  {
2365
- "name": "checked",
2322
+ "name": "setCustomValidityValueMissing",
2366
2323
  "type": {
2367
- "text": "boolean"
2324
+ "text": "string"
2368
2325
  },
2369
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2370
- "fieldName": "checked"
2326
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2327
+ "fieldName": "setCustomValidityValueMissing"
2371
2328
  },
2372
2329
  {
2373
- "name": "disabled",
2330
+ "name": "setCustomValidityValueMissingFilter",
2374
2331
  "type": {
2375
- "text": "boolean"
2332
+ "text": "string"
2376
2333
  },
2377
- "description": "If set to true, the checkbox will not be clickable.",
2378
- "fieldName": "disabled"
2334
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2335
+ "fieldName": "setCustomValidityValueMissingFilter"
2379
2336
  },
2380
2337
  {
2381
- "name": "error",
2338
+ "name": "triggerIcon",
2382
2339
  "type": {
2383
2340
  "text": "boolean"
2384
2341
  },
2385
- "description": "If set to true, the checkbox will be displayed with an error state.",
2386
- "fieldName": "error"
2342
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2343
+ "fieldName": "triggerIcon"
2387
2344
  },
2388
2345
  {
2389
- "name": "id",
2346
+ "name": "type",
2390
2347
  "type": {
2391
2348
  "text": "string"
2392
2349
  },
2393
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2394
- "fieldName": "id"
2350
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2351
+ "fieldName": "type"
2395
2352
  },
2396
2353
  {
2397
- "name": "name",
2354
+ "name": "typedValue",
2398
2355
  "type": {
2399
2356
  "text": "string"
2400
2357
  },
2401
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2402
- "fieldName": "name"
2358
+ "description": "Specifies the value of the input element within the combobox.",
2359
+ "fieldName": "typedValue"
2403
2360
  },
2404
2361
  {
2405
- "name": "onDark",
2362
+ "name": "validity",
2406
2363
  "type": {
2407
- "text": "boolean"
2364
+ "text": "string"
2408
2365
  },
2409
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2410
- "fieldName": "onDark"
2366
+ "description": "Specifies the `validityState` this element is in.",
2367
+ "fieldName": "validity"
2411
2368
  },
2412
2369
  {
2413
2370
  "name": "value",
2414
2371
  "type": {
2415
2372
  "text": "string"
2416
2373
  },
2417
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2374
+ "description": "Value selected for the dropdown menu.",
2418
2375
  "fieldName": "value"
2419
2376
  },
2420
2377
  {
2421
- "name": "tabindex",
2378
+ "name": "largeFullscreenHeadline",
2422
2379
  "type": {
2423
- "text": "number"
2380
+ "text": "boolean"
2424
2381
  },
2425
- "description": "The tabindex attribute for the checkbox.",
2426
- "fieldName": "tabIndex"
2382
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2383
+ "fieldName": "largeFullscreenHeadline"
2427
2384
  },
2428
2385
  {
2429
- "name": "aria-checked",
2386
+ "name": "fullscreenBreakpoint",
2430
2387
  "type": {
2431
- "text": "string"
2388
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2432
2389
  },
2433
- "description": "The aria-checked attribute for the checkbox.",
2434
- "fieldName": "ariaChecked"
2390
+ "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
2391
+ "default": "'sm'",
2392
+ "fieldName": "fullscreenBreakpoint"
2435
2393
  },
2436
2394
  {
2437
- "name": "aria-disabled",
2395
+ "name": "shape",
2438
2396
  "type": {
2439
2397
  "text": "string"
2440
2398
  },
2441
- "description": "The aria-disabled attribute for the checkbox.",
2442
- "fieldName": "ariaDisabled"
2399
+ "fieldName": "shape",
2400
+ "inheritedFrom": {
2401
+ "name": "AuroElement",
2402
+ "module": "components/layoutElement/src/auroElement.js"
2403
+ }
2443
2404
  },
2444
2405
  {
2445
- "name": "role",
2406
+ "name": "size",
2446
2407
  "type": {
2447
2408
  "text": "string"
2448
2409
  },
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"
2410
+ "fieldName": "size",
2411
+ "inheritedFrom": {
2412
+ "name": "AuroElement",
2413
+ "module": "components/layoutElement/src/auroElement.js"
2414
+ }
2415
+ },
2416
+ {
2417
+ "name": "ondark",
2418
+ "type": {
2419
+ "text": "boolean"
2420
+ },
2421
+ "fieldName": "onDark",
2422
+ "inheritedFrom": {
2423
+ "name": "AuroElement",
2424
+ "module": "components/layoutElement/src/auroElement.js"
2425
+ }
2451
2426
  }
2452
2427
  ],
2453
2428
  "superclass": {
2454
- "name": "LitElement",
2455
- "package": "lit"
2429
+ "name": "AuroElement",
2430
+ "module": "/components/layoutElement/src/auroElement.js"
2456
2431
  },
2457
- "tagName": "auro-checkbox",
2432
+ "tagName": "auro-combobox",
2458
2433
  "customElement": true
2459
2434
  }
2460
2435
  ],
2461
2436
  "exports": [
2462
2437
  {
2463
2438
  "kind": "js",
2464
- "name": "AuroCheckbox",
2439
+ "name": "AuroCombobox",
2465
2440
  "declaration": {
2466
- "name": "AuroCheckbox",
2467
- "module": "components/checkbox/src/auro-checkbox.js"
2441
+ "name": "AuroCombobox",
2442
+ "module": "components/combobox/src/auro-combobox.js"
2468
2443
  }
2469
2444
  }
2470
2445
  ]
2471
2446
  },
2472
2447
  {
2473
2448
  "kind": "javascript-module",
2474
- "path": "components/checkbox/src/index.js",
2475
- "declarations": [],
2449
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2450
+ "declarations": [
2451
+ {
2452
+ "kind": "variable",
2453
+ "name": "comboboxKeyboardStrategy",
2454
+ "type": {
2455
+ "text": "object"
2456
+ },
2457
+ "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.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(); } } }, }"
2458
+ }
2459
+ ],
2476
2460
  "exports": [
2477
2461
  {
2478
2462
  "kind": "js",
2479
- "name": "AuroCheckbox",
2463
+ "name": "comboboxKeyboardStrategy",
2480
2464
  "declaration": {
2481
- "name": "AuroCheckbox",
2482
- "module": "components/checkbox/src/index.js"
2465
+ "name": "comboboxKeyboardStrategy",
2466
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2483
2467
  }
2484
- },
2468
+ }
2469
+ ]
2470
+ },
2471
+ {
2472
+ "kind": "javascript-module",
2473
+ "path": "components/combobox/src/index.js",
2474
+ "declarations": [],
2475
+ "exports": [
2485
2476
  {
2486
2477
  "kind": "js",
2487
- "name": "AuroCheckboxGroup",
2478
+ "name": "AuroCombobox",
2488
2479
  "declaration": {
2489
- "name": "AuroCheckboxGroup",
2490
- "module": "components/checkbox/src/index.js"
2480
+ "name": "AuroCombobox",
2481
+ "module": "components/combobox/src/index.js"
2491
2482
  }
2492
2483
  }
2493
2484
  ]
2494
2485
  },
2495
2486
  {
2496
2487
  "kind": "javascript-module",
2497
- "path": "components/checkbox/src/registered.js",
2488
+ "path": "components/combobox/src/registered.js",
2498
2489
  "declarations": [],
2499
- "exports": []
2490
+ "exports": [
2491
+ {
2492
+ "kind": "js",
2493
+ "name": "AuroCombobox",
2494
+ "declaration": {
2495
+ "name": "AuroCombobox",
2496
+ "module": "components/combobox/src/registered.js"
2497
+ }
2498
+ }
2499
+ ]
2500
2500
  },
2501
2501
  {
2502
2502
  "kind": "javascript-module",
@@ -4598,7 +4598,7 @@
4598
4598
  {
4599
4599
  "kind": "method",
4600
4600
  "name": "setActive",
4601
- "description": "Imperatively marks this cell as active (tabindex=\"0\") without\ntriggering a Lit re-render.",
4601
+ "description": "Imperatively marks this cell as active without triggering a Lit re-render.\nNote: buttons stay tabindex=\"-1\" because the grid uses aria-activedescendant.",
4602
4602
  "return": {
4603
4603
  "type": {
4604
4604
  "text": "void"
@@ -4608,7 +4608,7 @@
4608
4608
  {
4609
4609
  "kind": "method",
4610
4610
  "name": "clearActive",
4611
- "description": "Imperatively marks this cell as inactive (tabindex=\"-1\") without\ntriggering a Lit re-render.",
4611
+ "description": "Imperatively marks this cell as inactive without triggering a Lit re-render.",
4612
4612
  "return": {
4613
4613
  "type": {
4614
4614
  "text": "void"
@@ -5197,6 +5197,16 @@
5197
5197
  {
5198
5198
  "kind": "method",
5199
5199
  "name": "handlePrevMonth",
5200
+ "parameters": [
5201
+ {
5202
+ "name": "options",
5203
+ "description": "Optional settings.",
5204
+ "optional": true,
5205
+ "type": {
5206
+ "text": "@param {boolean} [options.skipActiveUpdate=false] - When true, skip the active cell\n * recomputation. Used by arrow key handlers that manage the active cell themselves.\n * "
5207
+ }
5208
+ }
5209
+ ],
5200
5210
  "description": "Updates the month and year when the user navigates to the previous calendar month.",
5201
5211
  "privacy": "private",
5202
5212
  "return": {
@@ -5208,6 +5218,16 @@
5208
5218
  {
5209
5219
  "kind": "method",
5210
5220
  "name": "handleNextMonth",
5221
+ "parameters": [
5222
+ {
5223
+ "name": "options",
5224
+ "description": "Optional settings.",
5225
+ "optional": true,
5226
+ "type": {
5227
+ "text": "@param {boolean} [options.skipActiveUpdate=false] - When true, skip the active cell\n * recomputation. Used by arrow key handlers that manage the active cell themselves.\n * "
5228
+ }
5229
+ }
5230
+ ],
5211
5231
  "description": "Updates the month and year when the user navigates to the next calendar month.",
5212
5232
  "privacy": "private",
5213
5233
  "return": {
@@ -5230,7 +5250,7 @@
5230
5250
  {
5231
5251
  "kind": "method",
5232
5252
  "name": "updateActiveCellForVisibleMonth",
5233
- "description": "Recomputes and sets the active cell for the newly visible month after\nmonth navigation. Without this, activeCellDate can point at a date in\nthe old month, leaving no tabindex=\"0\" cell in the grid.",
5253
+ "description": "Updates the active cell after month navigation (prev/next buttons).\nAlways moves the active cell to the first enabled date in the newly\nvisible months so that tabbing back to the grid lands on an enabled cell.",
5234
5254
  "privacy": "private",
5235
5255
  "return": {
5236
5256
  "type": {
@@ -5322,7 +5342,29 @@
5322
5342
  {
5323
5343
  "kind": "method",
5324
5344
  "name": "focusActiveCell",
5325
- "description": "Focuses the calendar grid wrapper and sets the active cell.\nDOM focus stays on the grid wrapper; ariaActiveDescendantElement\ntells the screen reader which cell is \"active\".",
5345
+ "description": "Focuses the calendar grid wrapper and sets the active cell.\nDOM focus stays on the grid wrapper; the aria-live region\ntells the screen reader which cell is \"active\".",
5346
+ "return": {
5347
+ "type": {
5348
+ "text": "void"
5349
+ }
5350
+ }
5351
+ },
5352
+ {
5353
+ "kind": "method",
5354
+ "name": "handleGridFocusIn",
5355
+ "description": "Shows the activeCell ring when the grid gains focus.",
5356
+ "privacy": "private",
5357
+ "return": {
5358
+ "type": {
5359
+ "text": "void"
5360
+ }
5361
+ }
5362
+ },
5363
+ {
5364
+ "kind": "method",
5365
+ "name": "handleGridFocusOut",
5366
+ "description": "Hides the activeCell ring when the grid loses focus.",
5367
+ "privacy": "private",
5326
5368
  "return": {
5327
5369
  "type": {
5328
5370
  "text": "void"
@@ -5351,6 +5393,26 @@
5351
5393
  }
5352
5394
  }
5353
5395
  },
5396
+ {
5397
+ "kind": "method",
5398
+ "name": "isDateInRange",
5399
+ "parameters": [
5400
+ {
5401
+ "name": "targetTs",
5402
+ "description": "Unix timestamp in seconds.",
5403
+ "type": {
5404
+ "text": "Number"
5405
+ }
5406
+ }
5407
+ ],
5408
+ "description": "Checks if a target date (unix seconds) is within the configured [min, max] range.\nReturns false if the date falls outside the range, preventing navigation\nto months where all dates are disabled.",
5409
+ "privacy": "private",
5410
+ "return": {
5411
+ "type": {
5412
+ "text": "Boolean"
5413
+ }
5414
+ }
5415
+ },
5354
5416
  {
5355
5417
  "kind": "method",
5356
5418
  "name": "handleGridKeyDown",
@@ -5553,6 +5615,28 @@
5553
5615
  }
5554
5616
  }
5555
5617
  },
5618
+ {
5619
+ "kind": "method",
5620
+ "name": "_getLiveRegionId",
5621
+ "description": "Generates a unique ID for the live region scoped to this datepicker.\nUses the datepicker host's id attribute if present, otherwise falls\nback to a random hash.",
5622
+ "privacy": "private",
5623
+ "return": {
5624
+ "type": {
5625
+ "text": "string"
5626
+ }
5627
+ }
5628
+ },
5629
+ {
5630
+ "kind": "method",
5631
+ "name": "getOrCreateLiveRegion",
5632
+ "description": "Returns (and lazily creates) a document-level aria-live region.\nChrome does not reliably observe aria-live regions inside shadow DOM\n(even one level up in a parent component's shadow root), so this\nelement must be appended to document.body. Each datepicker instance\ngets its own uniquely-identified live region.",
5633
+ "privacy": "private",
5634
+ "return": {
5635
+ "type": {
5636
+ "text": "HTMLElement"
5637
+ }
5638
+ }
5639
+ },
5556
5640
  {
5557
5641
  "kind": "method",
5558
5642
  "name": "announceSelection",
@@ -5565,7 +5649,7 @@
5565
5649
  }
5566
5650
  }
5567
5651
  ],
5568
- "description": "Announces a date selection or focus change via the live region.",
5652
+ "description": "Announces a date selection or focus change via the live region.\nUses requestAnimationFrame to ensure the clear and set happen in\nseparate rendering frames — Chrome may coalesce synchronous or\nmicrotask-deferred mutations into a single accessibility tree update.",
5569
5653
  "privacy": "private",
5570
5654
  "return": {
5571
5655
  "type": {
@@ -5726,6 +5810,16 @@
5726
5810
  "privacy": "private",
5727
5811
  "default": "null"
5728
5812
  },
5813
+ {
5814
+ "kind": "field",
5815
+ "name": "_gridHasFocus",
5816
+ "type": {
5817
+ "text": "boolean"
5818
+ },
5819
+ "description": "Whether the #calendarGrid wrapper currently has focus.\nUsed to determine whether the visualFocus ring should be shown.",
5820
+ "privacy": "private",
5821
+ "default": "false"
5822
+ },
5729
5823
  {
5730
5824
  "kind": "field",
5731
5825
  "name": "firstMonthRenderable",