@aurodesignsystem-dev/auro-formkit 0.0.0-pr1483.10 → 0.0.0-pr1483.12

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