@aurodesignsystem-dev/auro-formkit 0.0.0-pr1603.4 → 0.0.0-pr1604.0

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