@aurodesignsystem-dev/auro-formkit 0.0.0-pr1576.1 → 0.0.0-pr1576.3

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