@aurodesignsystem-dev/auro-formkit 0.0.0-pr1625.0 → 0.0.0-pr1625.1

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