@aurodesignsystem-dev/auro-formkit 0.0.0-pr1611.0 → 0.0.0-pr1613.0

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