@aurodesignsystem-dev/auro-formkit 0.0.0-pr1621.0 → 0.0.0-pr1624.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 (50) hide show
  1. package/components/checkbox/demo/customize.min.js +1 -1
  2. package/components/checkbox/demo/getting-started.min.js +1 -1
  3. package/components/checkbox/demo/index.min.js +1 -1
  4. package/components/checkbox/dist/index.js +1 -1
  5. package/components/checkbox/dist/registered.js +1 -1
  6. package/components/combobox/demo/customize.min.js +30 -6
  7. package/components/combobox/demo/getting-started.min.js +30 -6
  8. package/components/combobox/demo/index.min.js +30 -6
  9. package/components/combobox/dist/index.js +30 -6
  10. package/components/combobox/dist/registered.js +30 -6
  11. package/components/counter/demo/api.md +0 -1
  12. package/components/counter/demo/customize.md +4 -4
  13. package/components/counter/demo/customize.min.js +4 -12
  14. package/components/counter/demo/getting-started.min.js +4 -12
  15. package/components/counter/demo/index.min.js +4 -12
  16. package/components/counter/dist/auro-counter-group.d.ts +0 -7
  17. package/components/counter/dist/index.js +4 -12
  18. package/components/counter/dist/registered.js +4 -12
  19. package/components/datepicker/demo/customize.min.js +30 -6
  20. package/components/datepicker/demo/getting-started.min.js +30 -6
  21. package/components/datepicker/demo/index.min.js +30 -6
  22. package/components/datepicker/dist/index.js +30 -6
  23. package/components/datepicker/dist/registered.js +30 -6
  24. package/components/dropdown/demo/customize.min.js +1 -1
  25. package/components/dropdown/demo/getting-started.min.js +29 -5
  26. package/components/dropdown/demo/index.min.js +1 -1
  27. package/components/dropdown/dist/index.js +1 -1
  28. package/components/dropdown/dist/registered.js +1 -1
  29. package/components/form/demo/customize.min.js +97 -33
  30. package/components/form/demo/getting-started.min.js +97 -33
  31. package/components/form/demo/index.min.js +97 -33
  32. package/components/form/demo/registerDemoDeps.min.js +97 -33
  33. package/components/input/demo/customize.min.js +28 -4
  34. package/components/input/demo/getting-started.min.js +28 -4
  35. package/components/input/demo/index.min.js +28 -4
  36. package/components/input/dist/auro-input.d.ts +14 -0
  37. package/components/input/dist/index.js +28 -4
  38. package/components/input/dist/registered.js +28 -4
  39. package/components/radio/demo/customize.min.js +1 -1
  40. package/components/radio/demo/getting-started.min.js +1 -1
  41. package/components/radio/demo/index.min.js +1 -1
  42. package/components/radio/dist/index.js +1 -1
  43. package/components/radio/dist/registered.js +1 -1
  44. package/components/select/demo/customize.min.js +3 -3
  45. package/components/select/demo/getting-started.min.js +3 -3
  46. package/components/select/demo/index.min.js +3 -3
  47. package/components/select/dist/index.js +3 -3
  48. package/components/select/dist/registered.js +3 -3
  49. package/custom-elements.json +1530 -1524
  50. 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"
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."
552
435
  },
553
436
  {
554
- "kind": "method",
555
- "name": "setTriggerInputFocus",
556
- "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
557
447
  },
558
448
  {
559
- "kind": "method",
560
- "name": "setInputFocus",
561
- "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
562
458
  },
563
459
  {
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"
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
568
469
  },
569
470
  {
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"
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
574
480
  },
575
481
  {
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
- }
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
585
491
  },
586
492
  {
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
- }
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
596
503
  },
597
504
  {
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
- }
505
+ "kind": "field",
506
+ "name": "required",
507
+ "privacy": "public",
508
+ "type": {
509
+ "text": "boolean"
510
+ },
511
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
512
+ "attribute": "required",
513
+ "reflects": true
514
+ },
515
+ {
516
+ "kind": "field",
517
+ "name": "setCustomValidity",
518
+ "privacy": "public",
519
+ "type": {
520
+ "text": "string"
521
+ },
522
+ "description": "Sets a custom help text message to display for all validityStates.",
523
+ "attribute": "setcustomvalidity"
524
+ },
525
+ {
526
+ "kind": "field",
527
+ "name": "setCustomValidityCustomError",
528
+ "privacy": "public",
529
+ "type": {
530
+ "text": "string"
531
+ },
532
+ "description": "Custom help text message to display when validity = `customError`.",
533
+ "attribute": "setcustomvaliditycustomerror"
534
+ },
535
+ {
536
+ "kind": "field",
537
+ "name": "setCustomValidityValueMissing",
538
+ "privacy": "public",
539
+ "type": {
540
+ "text": "string"
541
+ },
542
+ "description": "Custom help text message to display when validity = `valueMissing`.",
543
+ "attribute": "setcustomvalidityvaluemissing"
544
+ },
545
+ {
546
+ "kind": "field",
547
+ "name": "validity",
548
+ "privacy": "public",
549
+ "type": {
550
+ "text": "string"
551
+ },
552
+ "description": "Specifies the `validityState` this element is in.",
553
+ "attribute": "validity",
554
+ "reflects": true
555
+ }
556
+ ],
557
+ "events": [
558
+ {
559
+ "name": "input",
560
+ "type": {
561
+ "text": "CustomEvent"
562
+ },
563
+ "description": "Notifies when the group's value changes due to a checkbox selection being added or removed."
564
+ },
565
+ {
566
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
567
+ "name": "auroFormElement-validated"
568
+ }
569
+ ],
570
+ "attributes": [
571
+ {
572
+ "name": "appearance",
573
+ "type": {
574
+ "text": "'default' | 'inverse'"
575
+ },
576
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
577
+ "default": "'default'",
578
+ "fieldName": "appearance"
579
+ },
580
+ {
581
+ "name": "disabled",
582
+ "type": {
583
+ "text": "boolean"
584
+ },
585
+ "description": "If set, disables the checkbox group.",
586
+ "fieldName": "disabled"
587
+ },
588
+ {
589
+ "name": "error",
590
+ "type": {
591
+ "text": "string"
592
+ },
593
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
594
+ "fieldName": "error"
595
+ },
596
+ {
597
+ "name": "horizontal",
598
+ "type": {
599
+ "text": "boolean"
600
+ },
601
+ "description": "If set, checkboxes will be aligned horizontally.",
602
+ "fieldName": "horizontal"
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"
607
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,57 +802,8 @@
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
+ "name": "updateAriaLabel",
806
+ "description": "Updates the aria-label based on slot content.",
805
807
  "privacy": "private",
806
808
  "return": {
807
809
  "type": {
@@ -811,102 +813,45 @@
811
813
  },
812
814
  {
813
815
  "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",
816
+ "name": "handleKeyDown",
829
817
  "parameters": [
830
818
  {
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.",
839
- "privacy": "private",
840
- "return": {
841
- "type": {
842
- "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
879
- },
880
- {
881
- "kind": "field",
882
- "name": "availableOptions",
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,1039 +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
1031
  "text": "boolean"
1153
1032
  },
1154
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1155
- "attribute": "required",
1156
- "reflects": true
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'"
1193
+ "description": "Sets aria-label on clear button",
1194
+ "name": "ariaLabel.input.clear"
1195
+ },
1196
+ {
1197
+ "description": "Sets aria-label on close button in fullscreen bib",
1198
+ "name": "ariaLabel.bib.close"
1199
+ },
1200
+ {
1201
+ "description": "Defines the headline to display above menu-options",
1202
+ "name": "bib.fullscreen.headline"
1203
+ },
1204
+ {
1205
+ "description": "Defines the content of the label.",
1206
+ "name": "label"
1207
+ },
1208
+ {
1209
+ "description": "Defines the content of the helpText.",
1210
+ "name": "helpText"
1211
+ },
1212
+ {
1213
+ "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
1214
+ "name": "displayValue"
1215
+ }
1216
+ ],
1217
+ "members": [
1218
+ {
1219
+ "kind": "method",
1220
+ "name": "_initializeDefaults",
1221
+ "privacy": "private",
1222
+ "return": {
1223
+ "type": {
1224
+ "text": "void"
1225
+ }
1226
+ }
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
+ }
1278
1252
  },
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
1253
+ "privacy": "private"
1283
1254
  },
1284
1255
  {
1285
1256
  "kind": "field",
1286
- "name": "optionActive",
1287
- "privacy": "private",
1288
- "type": {
1289
- "text": "HTMLElement"
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
+ }
1290
1263
  },
1291
- "description": "Specifies the currently active option."
1264
+ "readonly": true
1265
+ },
1266
+ {
1267
+ "kind": "method",
1268
+ "name": "isValid",
1269
+ "description": "Checks if the element is valid.",
1270
+ "return": {
1271
+ "type": {
1272
+ "text": "boolean"
1273
+ }
1274
+ }
1275
+ },
1276
+ {
1277
+ "kind": "method",
1278
+ "name": "register",
1279
+ "static": true,
1280
+ "parameters": [
1281
+ {
1282
+ "name": "name",
1283
+ "default": "'auro-combobox'",
1284
+ "description": "The name of the element that you want to register.",
1285
+ "optional": true,
1286
+ "type": {
1287
+ "text": "string"
1288
+ }
1289
+ }
1290
+ ],
1291
+ "description": "This will register this element with the browser."
1292
1292
  },
1293
1293
  {
1294
- "kind": "field",
1295
- "name": "componentHasFocus",
1296
- "description": "Returns true if the element has focus.",
1294
+ "kind": "method",
1295
+ "name": "activateFirstEnabledAvailableOption",
1296
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
1297
1297
  "privacy": "private",
1298
1298
  "return": {
1299
1299
  "type": {
1300
- "text": "boolean"
1300
+ "text": "void"
1301
1301
  }
1302
- },
1303
- "readonly": true,
1304
- "inheritedFrom": {
1305
- "name": "AuroElement",
1306
- "module": "components/layoutElement/src/auroElement.js"
1307
1302
  }
1308
1303
  },
1309
1304
  {
1310
1305
  "kind": "method",
1311
- "name": "resetShapeClasses",
1312
- "inheritedFrom": {
1313
- "name": "AuroElement",
1314
- "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
+ }
1315
1313
  }
1316
1314
  },
1317
1315
  {
1318
1316
  "kind": "method",
1319
- "name": "resetLayoutClasses",
1320
- "inheritedFrom": {
1321
- "name": "AuroElement",
1322
- "module": "components/layoutElement/src/auroElement.js"
1323
- }
1317
+ "name": "updateFilter",
1318
+ "description": "Updates the filter for the available options based on the input value.",
1319
+ "privacy": "private"
1324
1320
  },
1325
1321
  {
1326
1322
  "kind": "method",
1327
- "name": "updateComponentArchitecture",
1328
- "inheritedFrom": {
1329
- "name": "AuroElement",
1330
- "module": "components/layoutElement/src/auroElement.js"
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
+ }
1331
1330
  }
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
1331
  },
1342
1332
  {
1343
- "name": "input",
1344
- "type": {
1345
- "text": "CustomEvent"
1346
- },
1347
- "description": "Notifies that the component has a new value set."
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"
1348
1346
  },
1349
1347
  {
1350
- "name": "auroCombobox-valueSet",
1351
- "type": {
1352
- "text": "CustomEvent"
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
+ }
1353
1364
  },
1354
- "description": "Notifies that the component has a new value set. **DEPRECATED** - Use the `input` event instead.",
1355
- "deprecated": "Use the `input` event instead."
1365
+ "privacy": "private"
1356
1366
  },
1357
1367
  {
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"
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
+ }
1371
1391
  },
1372
1392
  {
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"
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
+ }
1379
1402
  },
1380
1403
  {
1381
- "name": "autoplacement",
1382
- "type": {
1383
- "text": "boolean"
1384
- },
1385
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1386
- "fieldName": "autoPlacement"
1404
+ "kind": "method",
1405
+ "name": "hideBib",
1406
+ "description": "Hides the dropdown bib if its open.",
1407
+ "return": {
1408
+ "type": {
1409
+ "text": "void"
1410
+ }
1411
+ }
1387
1412
  },
1388
1413
  {
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"
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
+ }
1396
1422
  },
1397
1423
  {
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"
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
+ }
1404
1433
  },
1405
1434
  {
1406
- "name": "disabled",
1407
- "type": {
1408
- "text": "boolean"
1409
- },
1410
- "description": "If set, disables the combobox.",
1411
- "fieldName": "disabled"
1435
+ "kind": "method",
1436
+ "name": "setClearBtnFocus",
1437
+ "privacy": "private"
1412
1438
  },
1413
1439
  {
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"
1440
+ "kind": "method",
1441
+ "name": "setTriggerInputFocus",
1442
+ "privacy": "private"
1420
1443
  },
1421
1444
  {
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"
1445
+ "kind": "method",
1446
+ "name": "setInputFocus",
1447
+ "privacy": "private"
1428
1448
  },
1429
1449
  {
1430
- "name": "format",
1431
- "type": {
1432
- "text": "string"
1433
- },
1434
- "description": "Specifies the input mask format.",
1435
- "fieldName": "format"
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"
1436
1454
  },
1437
1455
  {
1438
- "name": "inputmode",
1439
- "type": {
1440
- "text": "string"
1441
- },
1442
- "description": "Exposes inputmode attribute for input.",
1443
- "fieldName": "inputmode"
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"
1444
1460
  },
1445
- {
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"
1461
+ {
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
+ }
1453
1471
  },
1454
1472
  {
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"
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
+ }
1462
1482
  },
1463
1483
  {
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"
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
+ }
1471
1493
  },
1472
1494
  {
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"
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
+ }
1479
1513
  },
1480
1514
  {
1481
- "name": "nofilter",
1482
- "type": {
1483
- "text": "boolean"
1484
- },
1485
- "description": "If set, combobox will not filter menuoptions based on input.",
1486
- "fieldName": "noFilter"
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
+ }
1487
1547
  },
1488
1548
  {
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"
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
+ }
1495
1567
  },
1496
1568
  {
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"
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
+ }
1586
+ }
1503
1587
  },
1504
1588
  {
1505
- "name": "novalidate",
1506
- "type": {
1507
- "text": "boolean"
1508
- },
1509
- "description": "If set, disables auto-validation on blur.",
1510
- "fieldName": "noValidate"
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
+ }
1511
1598
  },
1512
1599
  {
1513
- "name": "offset",
1514
- "type": {
1515
- "text": "number"
1516
- },
1517
- "description": "Gap between the trigger element and bib.",
1518
- "default": "0",
1519
- "fieldName": "offset"
1600
+ "kind": "method",
1601
+ "name": "focus",
1602
+ "description": "Focuses the combobox trigger input.",
1603
+ "return": {
1604
+ "type": {
1605
+ "text": "void"
1606
+ }
1607
+ }
1520
1608
  },
1521
1609
  {
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"
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
+ }
1532
1626
  }
1533
1627
  },
1534
1628
  {
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"
1629
+ "kind": "method",
1630
+ "name": "reset",
1631
+ "description": "Resets component to initial state.",
1632
+ "return": {
1633
+ "type": {
1634
+ "text": "void"
1635
+ }
1636
+ }
1541
1637
  },
1542
1638
  {
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"
1639
+ "kind": "method",
1640
+ "name": "clear",
1641
+ "description": "Clears the current value of the combobox.",
1642
+ "return": {
1643
+ "type": {
1644
+ "text": "void"
1645
+ }
1646
+ }
1550
1647
  },
1551
1648
  {
1552
- "name": "placeholder",
1553
- "type": {
1554
- "text": "string"
1555
- },
1556
- "description": "Define custom placeholder text, only supported by date input formats.",
1557
- "fieldName": "placeholder"
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."
1558
1663
  },
1559
1664
  {
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"
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
+ }
1566
1697
  },
1567
1698
  {
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"
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."
1574
1711
  },
1575
1712
  {
1576
- "name": "setcustomvaliditycustomerror",
1577
- "type": {
1578
- "text": "string"
1579
- },
1580
- "description": "Custom help text message to display when validity = `customError`.",
1581
- "fieldName": "setCustomValidityCustomError"
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
+ }
1582
1731
  },
1583
1732
  {
1584
- "name": "setcustomvalidityvaluemissing",
1733
+ "kind": "field",
1734
+ "name": "appearance",
1735
+ "privacy": "public",
1585
1736
  "type": {
1586
- "text": "string"
1737
+ "text": "'default' | 'inverse'"
1587
1738
  },
1588
- "description": "Custom help text message to display when validity = `valueMissing`.",
1589
- "fieldName": "setCustomValidityValueMissing"
1739
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1740
+ "default": "'default'",
1741
+ "attribute": "appearance",
1742
+ "reflects": true
1590
1743
  },
1591
1744
  {
1592
- "name": "setcustomvalidityvaluemissingfilter",
1745
+ "kind": "field",
1746
+ "name": "autocomplete",
1747
+ "privacy": "public",
1593
1748
  "type": {
1594
1749
  "text": "string"
1595
1750
  },
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"
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
1598
1754
  },
1599
1755
  {
1600
- "name": "triggericon",
1756
+ "kind": "field",
1757
+ "name": "autoPlacement",
1758
+ "privacy": "public",
1601
1759
  "type": {
1602
1760
  "text": "boolean"
1603
1761
  },
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"
1606
- },
1607
- {
1608
- "name": "type",
1609
- "type": {
1610
- "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
1611
- },
1612
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1613
- "fieldName": "type"
1614
- },
1615
- {
1616
- "name": "typedvalue",
1617
- "type": {
1618
- "text": "string"
1619
- },
1620
- "description": "Specifies the value of the input element within the combobox.",
1621
- "fieldName": "typedValue"
1762
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1763
+ "attribute": "autoplacement",
1764
+ "reflects": true
1622
1765
  },
1623
1766
  {
1624
- "name": "validity",
1767
+ "kind": "field",
1768
+ "name": "availableOptions",
1769
+ "privacy": "private",
1625
1770
  "type": {
1626
- "text": "string"
1771
+ "text": "HTMLElement[]"
1627
1772
  },
1628
- "description": "Specifies the `validityState` this element is in.",
1629
- "fieldName": "validity"
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)."
1630
1774
  },
1631
1775
  {
1632
- "name": "value",
1776
+ "kind": "field",
1777
+ "name": "behavior",
1778
+ "privacy": "public",
1633
1779
  "type": {
1634
- "text": "string"
1780
+ "text": "'filter' | 'suggestion'"
1635
1781
  },
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"
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
1638
1786
  },
1639
1787
  {
1640
- "name": "largefullscreenheadline",
1788
+ "kind": "field",
1789
+ "name": "checkmark",
1790
+ "privacy": "public",
1641
1791
  "type": {
1642
1792
  "text": "boolean"
1643
1793
  },
1644
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1645
- "fieldName": "largeFullscreenHeadline"
1794
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1795
+ "attribute": "checkmark",
1796
+ "reflects": true
1646
1797
  },
1647
1798
  {
1648
- "name": "fullscreenbreakpoint",
1799
+ "kind": "field",
1800
+ "name": "disabled",
1801
+ "privacy": "public",
1649
1802
  "type": {
1650
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1803
+ "text": "boolean"
1651
1804
  },
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": [
1739
- {
1740
- "description": "Apply css to the fieldset element in the shadow DOM",
1741
- "name": "checkbox-group"
1805
+ "description": "If set, disables the combobox.",
1806
+ "attribute": "disabled",
1807
+ "reflects": true
1742
1808
  },
1743
1809
  {
1744
- "description": "Apply css to the help text element that displays helper or error messages.",
1745
- "name": "helpText"
1746
- }
1747
- ],
1748
- "slots": [
1810
+ "kind": "field",
1811
+ "name": "dropdownId",
1812
+ "privacy": "private",
1813
+ "type": {
1814
+ "text": "string"
1815
+ },
1816
+ "description": "ID for the dropdown."
1817
+ },
1749
1818
  {
1750
- "description": "Allows for the legend to be overridden.",
1751
- "name": "legend"
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 overriding the optional display text \"(optional)\", which appears next to the label.",
1755
- "name": "optionalLabel"
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": "Allows for the helper text to be overridden.",
1759
- "name": "helpText"
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
1760
1848
  },
1761
1849
  {
1762
- "description": "The default slot for the checkbox items.",
1763
- "name": "default"
1764
- }
1765
- ],
1766
- "members": [
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
1859
+ },
1767
1860
  {
1768
- "kind": "method",
1769
- "name": "_initializeDefaults"
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
1770
1870
  },
1771
1871
  {
1772
- "kind": "method",
1773
- "name": "register",
1774
- "static": true,
1775
- "parameters": [
1776
- {
1777
- "name": "name",
1778
- "default": "\"auro-checkbox-group\"",
1779
- "description": "The name of the element that you want to register.",
1780
- "optional": true,
1781
- "type": {
1782
- "text": "string"
1783
- }
1784
- }
1785
- ],
1786
- "description": "This will register this element with the browser."
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
1787
1882
  },
1788
1883
  {
1789
- "kind": "method",
1790
- "name": "handleValueUpdate",
1791
- "parameters": [
1792
- {
1793
- "name": "value",
1794
- "description": "The value of the checkbox.",
1795
- "type": {
1796
- "text": "String"
1797
- }
1798
- },
1799
- {
1800
- "name": "selected",
1801
- "description": "The checked state of the checkbox.",
1802
- "type": {
1803
- "text": "Boolean"
1804
- }
1805
- }
1806
- ],
1807
- "description": "Helper method to handle checkbox value changing.",
1808
- "privacy": "private",
1809
- "return": {
1810
- "type": {
1811
- "text": "void"
1812
- }
1813
- }
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
1814
1894
  },
1815
1895
  {
1816
- "kind": "method",
1817
- "name": "handlePreselectedItems",
1818
- "description": "Helper method that handles the state of preselected checkboxes.",
1819
- "privacy": "private",
1820
- "return": {
1821
- "type": {
1822
- "text": "void"
1823
- }
1824
- }
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
1825
1906
  },
1826
1907
  {
1827
- "kind": "method",
1828
- "name": "handleItems",
1829
- "description": "Helper method that handles the state of checkboxes.",
1908
+ "kind": "field",
1909
+ "name": "matchWidth",
1830
1910
  "privacy": "private",
1831
- "return": {
1832
- "type": {
1833
- "text": "void"
1834
- }
1835
- }
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
1836
1917
  },
1837
1918
  {
1838
1919
  "kind": "field",
1839
- "name": "isInvalid",
1840
- "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.",
1841
- "privacy": "private",
1842
- "return": {
1843
- "type": {
1844
- "text": "boolean"
1845
- }
1920
+ "name": "noFilter",
1921
+ "privacy": "public",
1922
+ "type": {
1923
+ "text": "boolean"
1846
1924
  },
1847
- "readonly": true
1925
+ "description": "If set, combobox will not filter menuoptions based on input.",
1926
+ "attribute": "nofilter",
1927
+ "reflects": true
1848
1928
  },
1849
1929
  {
1850
- "kind": "method",
1851
- "name": "syncCheckboxValidity",
1852
- "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.",
1853
- "privacy": "private",
1854
- "return": {
1855
- "type": {
1856
- "text": "void"
1857
- }
1858
- }
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
1859
1939
  },
1860
1940
  {
1861
- "kind": "method",
1862
- "name": "reset",
1863
- "description": "Resets component to initial state.",
1864
- "return": {
1865
- "type": {
1866
- "text": "void"
1867
- }
1868
- }
1941
+ "kind": "field",
1942
+ "name": "shift",
1943
+ "privacy": "public",
1944
+ "type": {
1945
+ "text": "boolean"
1946
+ },
1947
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1948
+ "attribute": "shift",
1949
+ "reflects": true
1869
1950
  },
1870
1951
  {
1871
- "kind": "method",
1872
- "name": "validate",
1873
- "parameters": [
1874
- {
1875
- "name": "force",
1876
- "default": "false",
1877
- "description": "Whether to force validation.",
1878
- "optional": true,
1879
- "type": {
1880
- "text": "boolean"
1881
- }
1882
- }
1883
- ],
1884
- "description": "Validates value."
1952
+ "kind": "field",
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
1885
1961
  },
1886
1962
  {
1887
1963
  "kind": "field",
1888
- "name": "appearance",
1964
+ "name": "offset",
1889
1965
  "privacy": "public",
1890
1966
  "type": {
1891
- "text": "'default' | 'inverse'"
1967
+ "text": "number"
1892
1968
  },
1893
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1894
- "default": "'default'",
1895
- "attribute": "appearance",
1969
+ "description": "Gap between the trigger element and bib.",
1970
+ "default": "0",
1971
+ "attribute": "offset",
1896
1972
  "reflects": true
1897
1973
  },
1898
1974
  {
1899
1975
  "kind": "field",
1900
- "name": "disabled",
1976
+ "name": "onDark",
1901
1977
  "privacy": "public",
1902
1978
  "type": {
1903
1979
  "text": "boolean"
1904
1980
  },
1905
- "description": "If set, disables the checkbox group.",
1906
- "attribute": "disabled",
1907
- "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
+ }
1908
1989
  },
1909
1990
  {
1910
1991
  "kind": "field",
1911
- "name": "error",
1992
+ "name": "optionSelected",
1912
1993
  "privacy": "public",
1913
1994
  "type": {
1914
- "text": "string"
1995
+ "text": "HTMLElement"
1915
1996
  },
1916
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1917
- "attribute": "error",
1918
- "reflects": true
1997
+ "description": "Specifies the current selected option."
1919
1998
  },
1920
1999
  {
1921
2000
  "kind": "field",
1922
- "name": "horizontal",
2001
+ "name": "persistInput",
1923
2002
  "privacy": "public",
1924
2003
  "type": {
1925
2004
  "text": "boolean"
1926
2005
  },
1927
- "description": "If set, checkboxes will be aligned horizontally.",
1928
- "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",
1929
2008
  "reflects": true
1930
2009
  },
1931
2010
  {
1932
2011
  "kind": "field",
1933
- "name": "noValidate",
2012
+ "name": "placement",
1934
2013
  "privacy": "public",
1935
2014
  "type": {
1936
- "text": "boolean"
2015
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1937
2016
  },
1938
- "description": "If set, disables auto-validation on blur.",
1939
- "attribute": "novalidate",
2017
+ "description": "Position where the bib should appear relative to the trigger.",
2018
+ "default": "'bottom-start'",
2019
+ "attribute": "placement",
1940
2020
  "reflects": true
1941
2021
  },
1942
2022
  {
1943
2023
  "kind": "field",
1944
- "name": "onDark",
2024
+ "name": "placeholder",
1945
2025
  "privacy": "public",
1946
2026
  "type": {
1947
- "text": "boolean"
2027
+ "text": "string"
1948
2028
  },
1949
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1950
- "deprecated": "Use `appearance=\"inverse\"` instead.",
1951
- "attribute": "ondark",
2029
+ "description": "Define custom placeholder text, only supported by date input formats.",
2030
+ "attribute": "placeholder",
1952
2031
  "reflects": true
1953
2032
  },
1954
2033
  {
@@ -1958,7 +2037,7 @@
1958
2037
  "type": {
1959
2038
  "text": "boolean"
1960
2039
  },
1961
- "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.",
1962
2041
  "attribute": "required",
1963
2042
  "reflects": true
1964
2043
  },
@@ -1994,624 +2073,545 @@
1994
2073
  },
1995
2074
  {
1996
2075
  "kind": "field",
1997
- "name": "validity",
2076
+ "name": "setCustomValidityValueMissingFilter",
1998
2077
  "privacy": "public",
1999
2078
  "type": {
2000
2079
  "text": "string"
2001
2080
  },
2002
- "description": "Specifies the `validityState` this element is in.",
2003
- "attribute": "validity",
2004
- "reflects": true
2005
- }
2006
- ],
2007
- "events": [
2008
- {
2009
- "name": "input",
2010
- "type": {
2011
- "text": "CustomEvent"
2012
- },
2013
- "description": "Notifies when the group's value changes due to a checkbox selection being added or removed."
2014
- },
2015
- {
2016
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
2017
- "name": "auroFormElement-validated"
2018
- }
2019
- ],
2020
- "attributes": [
2021
- {
2022
- "name": "appearance",
2023
- "type": {
2024
- "text": "'default' | 'inverse'"
2025
- },
2026
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2027
- "default": "'default'",
2028
- "fieldName": "appearance"
2029
- },
2030
- {
2031
- "name": "disabled",
2032
- "type": {
2033
- "text": "boolean"
2034
- },
2035
- "description": "If set, disables the checkbox group.",
2036
- "fieldName": "disabled"
2037
- },
2038
- {
2039
- "name": "error",
2040
- "type": {
2041
- "text": "string"
2042
- },
2043
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2044
- "fieldName": "error"
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"
2045
2083
  },
2046
2084
  {
2047
- "name": "horizontal",
2085
+ "kind": "field",
2086
+ "name": "touched",
2087
+ "privacy": "private",
2048
2088
  "type": {
2049
2089
  "text": "boolean"
2050
2090
  },
2051
- "description": "If set, checkboxes will be aligned horizontally.",
2052
- "fieldName": "horizontal"
2091
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
2053
2092
  },
2054
2093
  {
2055
- "name": "novalidate",
2094
+ "kind": "field",
2095
+ "name": "triggerIcon",
2096
+ "privacy": "public",
2056
2097
  "type": {
2057
2098
  "text": "boolean"
2058
2099
  },
2059
- "description": "If set, disables auto-validation on blur.",
2060
- "fieldName": "noValidate"
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
2061
2103
  },
2062
2104
  {
2063
- "name": "ondark",
2105
+ "kind": "field",
2106
+ "name": "type",
2107
+ "privacy": "public",
2064
2108
  "type": {
2065
- "text": "boolean"
2109
+ "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
2066
2110
  },
2067
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2068
- "deprecated": "Use `appearance=\"inverse\"` instead.",
2069
- "fieldName": "onDark"
2111
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2112
+ "attribute": "type",
2113
+ "reflects": true
2070
2114
  },
2071
2115
  {
2072
- "name": "required",
2116
+ "kind": "field",
2117
+ "name": "typedValue",
2118
+ "privacy": "public",
2073
2119
  "type": {
2074
- "text": "boolean"
2120
+ "text": "string"
2075
2121
  },
2076
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
2077
- "fieldName": "required"
2122
+ "description": "Specifies the value of the input element within the combobox.",
2123
+ "attribute": "typedvalue",
2124
+ "reflects": true
2078
2125
  },
2079
2126
  {
2080
- "name": "setcustomvalidity",
2127
+ "kind": "field",
2128
+ "name": "validity",
2129
+ "privacy": "public",
2081
2130
  "type": {
2082
2131
  "text": "string"
2083
2132
  },
2084
- "description": "Sets a custom help text message to display for all validityStates.",
2085
- "fieldName": "setCustomValidity"
2133
+ "description": "Specifies the `validityState` this element is in.",
2134
+ "attribute": "validity",
2135
+ "reflects": true
2086
2136
  },
2087
2137
  {
2088
- "name": "setcustomvaliditycustomerror",
2138
+ "kind": "field",
2139
+ "name": "value",
2140
+ "privacy": "public",
2089
2141
  "type": {
2090
2142
  "text": "string"
2091
2143
  },
2092
- "description": "Custom help text message to display when validity = `customError`.",
2093
- "fieldName": "setCustomValidityCustomError"
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"
2094
2146
  },
2095
2147
  {
2096
- "name": "setcustomvalidityvaluemissing",
2148
+ "kind": "field",
2149
+ "name": "largeFullscreenHeadline",
2150
+ "privacy": "public",
2097
2151
  "type": {
2098
- "text": "string"
2152
+ "text": "boolean"
2099
2153
  },
2100
- "description": "Custom help text message to display when validity = `valueMissing`.",
2101
- "fieldName": "setCustomValidityValueMissing"
2154
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2155
+ "attribute": "largefullscreenheadline",
2156
+ "reflects": true
2102
2157
  },
2103
2158
  {
2104
- "name": "validity",
2159
+ "kind": "field",
2160
+ "name": "fullscreenBreakpoint",
2161
+ "privacy": "public",
2105
2162
  "type": {
2106
- "text": "string"
2163
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2107
2164
  },
2108
- "description": "Specifies the `validityState` this element is in.",
2109
- "fieldName": "validity"
2110
- }
2111
- ],
2112
- "superclass": {
2113
- "name": "LitElement",
2114
- "package": "lit"
2115
- },
2116
- "tagName": "auro-checkbox-group",
2117
- "customElement": true
2118
- }
2119
- ],
2120
- "exports": [
2121
- {
2122
- "kind": "js",
2123
- "name": "AuroCheckboxGroup",
2124
- "declaration": {
2125
- "name": "AuroCheckboxGroup",
2126
- "module": "components/checkbox/src/auro-checkbox-group.js"
2127
- }
2128
- }
2129
- ]
2130
- },
2131
- {
2132
- "kind": "javascript-module",
2133
- "path": "components/checkbox/src/auro-checkbox.js",
2134
- "declarations": [
2135
- {
2136
- "kind": "class",
2137
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2138
- "name": "AuroCheckbox",
2139
- "cssParts": [
2140
- {
2141
- "description": "apply css to a specific checkbox.",
2142
- "name": "checkbox"
2143
- },
2144
- {
2145
- "description": "apply css to a specific checkbox's input.",
2146
- "name": "checkbox-input"
2147
- },
2148
- {
2149
- "description": "apply css to a specific checkbox's label.",
2150
- "name": "checkbox-label"
2151
- }
2152
- ],
2153
- "slots": [
2154
- {
2155
- "description": "The default slot for the checkbox label.",
2156
- "name": "default"
2157
- }
2158
- ],
2159
- "members": [
2160
- {
2161
- "kind": "method",
2162
- "name": "_initializeDefaults"
2163
- },
2164
- {
2165
- "kind": "method",
2166
- "name": "register",
2167
- "static": true,
2168
- "parameters": [
2169
- {
2170
- "name": "name",
2171
- "default": "\"auro-checkbox\"",
2172
- "description": "The name of element that you want to register to.",
2173
- "optional": true,
2174
- "type": {
2175
- "text": "string"
2176
- }
2177
- }
2178
- ],
2179
- "description": "This will register this element with the browser."
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
2180
2169
  },
2181
2170
  {
2182
- "kind": "method",
2183
- "name": "handleChange",
2184
- "parameters": [
2185
- {
2186
- "name": "event",
2187
- "description": "The change event from the checkbox input.",
2188
- "type": {
2189
- "text": "Event"
2190
- }
2191
- }
2192
- ],
2193
- "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.",
2171
+ "kind": "field",
2172
+ "name": "optionActive",
2194
2173
  "privacy": "private",
2195
- "return": {
2196
- "type": {
2197
- "text": "void"
2198
- }
2199
- }
2174
+ "type": {
2175
+ "text": "HTMLElement"
2176
+ },
2177
+ "description": "Specifies the currently active option."
2200
2178
  },
2201
2179
  {
2202
- "kind": "method",
2203
- "name": "handleInput",
2204
- "parameters": [
2205
- {
2206
- "name": "event",
2207
- "description": "The input event from the checkbox input.",
2208
- "type": {
2209
- "text": "Event"
2210
- }
2211
- }
2212
- ],
2213
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2180
+ "kind": "field",
2181
+ "name": "componentHasFocus",
2182
+ "description": "Returns true if the element has focus.",
2214
2183
  "privacy": "private",
2215
2184
  "return": {
2216
2185
  "type": {
2217
- "text": "void"
2186
+ "text": "boolean"
2218
2187
  }
2188
+ },
2189
+ "readonly": true,
2190
+ "inheritedFrom": {
2191
+ "name": "AuroElement",
2192
+ "module": "components/layoutElement/src/auroElement.js"
2219
2193
  }
2220
2194
  },
2221
2195
  {
2222
2196
  "kind": "method",
2223
- "name": "handleFocusin",
2224
- "description": "Function to support",
2225
- "privacy": "private",
2226
- "return": {
2227
- "type": {
2228
- "text": "void"
2229
- }
2197
+ "name": "resetShapeClasses",
2198
+ "inheritedFrom": {
2199
+ "name": "AuroElement",
2200
+ "module": "components/layoutElement/src/auroElement.js"
2230
2201
  }
2231
2202
  },
2232
2203
  {
2233
2204
  "kind": "method",
2234
- "name": "generateIconHtml",
2235
- "description": "Function to generate checkmark svg.",
2236
- "privacy": "private",
2237
- "return": {
2238
- "type": {
2239
- "text": "HTMLElement"
2240
- }
2205
+ "name": "resetLayoutClasses",
2206
+ "inheritedFrom": {
2207
+ "name": "AuroElement",
2208
+ "module": "components/layoutElement/src/auroElement.js"
2241
2209
  }
2242
2210
  },
2243
2211
  {
2244
2212
  "kind": "method",
2245
- "name": "reset",
2246
- "description": "Resets component to initial state.",
2247
- "return": {
2248
- "type": {
2249
- "text": "void"
2250
- }
2213
+ "name": "updateComponentArchitecture",
2214
+ "inheritedFrom": {
2215
+ "name": "AuroElement",
2216
+ "module": "components/layoutElement/src/auroElement.js"
2251
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."
2252
2227
  },
2253
2228
  {
2254
- "kind": "method",
2255
- "name": "updateAriaLabel",
2256
- "description": "Updates the aria-label based on slot content.",
2257
- "privacy": "private",
2258
- "return": {
2259
- "type": {
2260
- "text": "void"
2261
- }
2262
- }
2229
+ "name": "input",
2230
+ "type": {
2231
+ "text": "CustomEvent"
2232
+ },
2233
+ "description": "Notifies that the component has a new value set."
2263
2234
  },
2264
2235
  {
2265
- "kind": "method",
2266
- "name": "handleKeyDown",
2267
- "parameters": [
2268
- {
2269
- "name": "event",
2270
- "description": "The keydown event from the checkbox input.",
2271
- "type": {
2272
- "text": "KeyboardEvent"
2273
- }
2274
- }
2275
- ],
2276
- "description": "Handles keydown event to toggle the checkbox with Space key.",
2277
- "privacy": "private",
2278
- "return": {
2279
- "type": {
2280
- "text": "void"
2281
- }
2282
- }
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."
2283
2242
  },
2284
2243
  {
2285
- "kind": "field",
2244
+ "description": "Notifies that the component value(s) have been validated.",
2245
+ "name": "auroFormElement-validated"
2246
+ }
2247
+ ],
2248
+ "attributes": [
2249
+ {
2286
2250
  "name": "appearance",
2287
- "privacy": "public",
2288
2251
  "type": {
2289
2252
  "text": "'default' | 'inverse'"
2290
2253
  },
2291
2254
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
2292
2255
  "default": "'default'",
2293
- "attribute": "appearance",
2294
- "reflects": true
2256
+ "fieldName": "appearance"
2295
2257
  },
2296
2258
  {
2297
- "kind": "field",
2298
- "name": "checked",
2299
- "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",
2300
2268
  "type": {
2301
2269
  "text": "boolean"
2302
2270
  },
2303
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2304
- "attribute": "checked",
2305
- "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"
2306
2290
  },
2307
2291
  {
2308
- "kind": "field",
2309
2292
  "name": "disabled",
2310
- "privacy": "public",
2311
2293
  "type": {
2312
2294
  "text": "boolean"
2313
2295
  },
2314
- "description": "If set to true, the checkbox will not be clickable.",
2315
- "attribute": "disabled",
2316
- "reflects": true
2296
+ "description": "If set, disables the combobox.",
2297
+ "fieldName": "disabled"
2317
2298
  },
2318
2299
  {
2319
- "kind": "field",
2320
- "name": "error",
2321
- "privacy": "public",
2300
+ "name": "dvinputonly",
2322
2301
  "type": {
2323
2302
  "text": "boolean"
2324
2303
  },
2325
- "description": "If set to true, the checkbox will be displayed with an error state.",
2326
- "attribute": "error",
2327
- "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"
2328
2306
  },
2329
2307
  {
2330
- "kind": "field",
2331
- "name": "id",
2332
- "privacy": "public",
2308
+ "name": "error",
2333
2309
  "type": {
2334
2310
  "text": "string"
2335
2311
  },
2336
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2337
- "attribute": "id",
2338
- "reflects": true
2312
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2313
+ "fieldName": "error"
2339
2314
  },
2340
2315
  {
2341
- "kind": "field",
2342
- "name": "inputId",
2343
- "privacy": "private",
2316
+ "name": "format",
2344
2317
  "type": {
2345
2318
  "text": "string"
2346
2319
  },
2347
- "description": "The id for input node."
2320
+ "description": "Specifies the input mask format.",
2321
+ "fieldName": "format"
2348
2322
  },
2349
2323
  {
2350
- "kind": "field",
2351
- "name": "name",
2352
- "privacy": "public",
2324
+ "name": "inputmode",
2353
2325
  "type": {
2354
2326
  "text": "string"
2355
2327
  },
2356
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2357
- "attribute": "name"
2328
+ "description": "Exposes inputmode attribute for input.",
2329
+ "fieldName": "inputmode"
2358
2330
  },
2359
2331
  {
2360
- "kind": "field",
2361
- "name": "onDark",
2362
- "privacy": "public",
2332
+ "name": "layout",
2363
2333
  "type": {
2364
- "text": "boolean"
2334
+ "text": "'classic' | 'emphasized' | 'snowflake'"
2365
2335
  },
2366
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2367
- "deprecated": "Use `appearance=\"inverse\"` instead.",
2368
- "attribute": "ondark",
2369
- "reflects": true
2336
+ "description": "Sets the layout of the combobox.",
2337
+ "default": "'classic'",
2338
+ "fieldName": "layout"
2370
2339
  },
2371
2340
  {
2372
- "kind": "field",
2373
- "name": "touched",
2374
- "privacy": "private",
2341
+ "name": "shape",
2375
2342
  "type": {
2376
- "text": "boolean"
2343
+ "text": "'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'"
2377
2344
  },
2378
- "description": "Indicates whether the checkbox has been interacted with."
2345
+ "description": "Sets the shape of the combobox.",
2346
+ "default": "'classic'",
2347
+ "fieldName": "shape"
2379
2348
  },
2380
2349
  {
2381
- "kind": "field",
2382
- "name": "value",
2383
- "privacy": "public",
2350
+ "name": "size",
2384
2351
  "type": {
2385
- "text": "string"
2352
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
2386
2353
  },
2387
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2388
- "attribute": "value"
2354
+ "description": "Sets the size of the combobox.",
2355
+ "default": "'xl'",
2356
+ "fieldName": "size"
2389
2357
  },
2390
2358
  {
2391
- "kind": "field",
2392
- "name": "tabIndex",
2393
- "privacy": "private",
2359
+ "name": "matchwidth",
2394
2360
  "type": {
2395
- "text": "number"
2361
+ "text": "boolean"
2396
2362
  },
2397
- "description": "The tabindex attribute for the checkbox.",
2398
- "attribute": "tabindex",
2399
- "reflects": true
2363
+ "description": "If declared, the popover and trigger will be set to the same width.",
2364
+ "fieldName": "matchWidth"
2400
2365
  },
2401
2366
  {
2402
- "kind": "field",
2403
- "name": "ariaChecked",
2404
- "privacy": "private",
2367
+ "name": "nofilter",
2405
2368
  "type": {
2406
- "text": "string"
2369
+ "text": "boolean"
2407
2370
  },
2408
- "description": "The aria-checked attribute for the checkbox.",
2409
- "attribute": "aria-checked",
2410
- "reflects": true
2371
+ "description": "If set, combobox will not filter menuoptions based on input.",
2372
+ "fieldName": "noFilter"
2411
2373
  },
2412
2374
  {
2413
- "kind": "field",
2414
- "name": "ariaDisabled",
2415
- "privacy": "private",
2375
+ "name": "noflip",
2376
+ "type": {
2377
+ "text": "boolean"
2378
+ },
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"
2381
+ },
2382
+ {
2383
+ "name": "shift",
2416
2384
  "type": {
2417
- "text": "string"
2385
+ "text": "boolean"
2418
2386
  },
2419
- "description": "The aria-disabled attribute for the checkbox.",
2420
- "attribute": "aria-disabled",
2421
- "reflects": true
2387
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2388
+ "fieldName": "shift"
2422
2389
  },
2423
2390
  {
2424
- "kind": "field",
2425
- "name": "role",
2426
- "privacy": "private",
2391
+ "name": "novalidate",
2427
2392
  "type": {
2428
- "text": "string"
2393
+ "text": "boolean"
2429
2394
  },
2430
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2431
- "attribute": "role",
2432
- "reflects": true
2433
- }
2434
- ],
2435
- "events": [
2395
+ "description": "If set, disables auto-validation on blur.",
2396
+ "fieldName": "noValidate"
2397
+ },
2436
2398
  {
2437
- "name": "auroCheckbox-input",
2399
+ "name": "offset",
2438
2400
  "type": {
2439
- "text": "CustomEvent"
2401
+ "text": "number"
2440
2402
  },
2441
- "description": "Notifies when the checked value is changed by user interaction. **DEPRECATED** - Use the `input` event instead.",
2442
- "deprecated": "Use the `input` event instead."
2403
+ "description": "Gap between the trigger element and bib.",
2404
+ "default": "0",
2405
+ "fieldName": "offset"
2443
2406
  },
2444
2407
  {
2445
- "name": "auroCheckbox-focusin",
2408
+ "name": "ondark",
2446
2409
  "type": {
2447
- "text": "CustomEvent"
2410
+ "text": "boolean"
2448
2411
  },
2449
- "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
+ }
2450
2419
  },
2451
2420
  {
2452
- "name": "auroCheckbox-focusout",
2421
+ "name": "persistinput",
2453
2422
  "type": {
2454
- "text": "CustomEvent"
2423
+ "text": "boolean"
2455
2424
  },
2456
- "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"
2457
2427
  },
2458
2428
  {
2459
- "description": "Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.",
2460
- "name": "change",
2461
- "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"
2462
2436
  },
2463
2437
  {
2464
- "description": "Notifies when checked value is changed by user's interface.",
2465
- "name": "input"
2466
- }
2467
- ],
2468
- "attributes": [
2469
- {
2470
- "name": "appearance",
2438
+ "name": "placeholder",
2471
2439
  "type": {
2472
- "text": "'default' | 'inverse'"
2440
+ "text": "string"
2473
2441
  },
2474
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2475
- "default": "'default'",
2476
- "fieldName": "appearance"
2442
+ "description": "Define custom placeholder text, only supported by date input formats.",
2443
+ "fieldName": "placeholder"
2477
2444
  },
2478
2445
  {
2479
- "name": "checked",
2446
+ "name": "required",
2480
2447
  "type": {
2481
2448
  "text": "boolean"
2482
2449
  },
2483
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2484
- "fieldName": "checked"
2450
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2451
+ "fieldName": "required"
2485
2452
  },
2486
2453
  {
2487
- "name": "disabled",
2454
+ "name": "setcustomvalidity",
2488
2455
  "type": {
2489
- "text": "boolean"
2456
+ "text": "string"
2490
2457
  },
2491
- "description": "If set to true, the checkbox will not be clickable.",
2492
- "fieldName": "disabled"
2458
+ "description": "Sets a custom help text message to display for all validityStates.",
2459
+ "fieldName": "setCustomValidity"
2493
2460
  },
2494
2461
  {
2495
- "name": "error",
2462
+ "name": "setcustomvaliditycustomerror",
2496
2463
  "type": {
2497
- "text": "boolean"
2464
+ "text": "string"
2498
2465
  },
2499
- "description": "If set to true, the checkbox will be displayed with an error state.",
2500
- "fieldName": "error"
2466
+ "description": "Custom help text message to display when validity = `customError`.",
2467
+ "fieldName": "setCustomValidityCustomError"
2501
2468
  },
2502
2469
  {
2503
- "name": "id",
2470
+ "name": "setcustomvalidityvaluemissing",
2504
2471
  "type": {
2505
2472
  "text": "string"
2506
2473
  },
2507
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2508
- "fieldName": "id"
2474
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2475
+ "fieldName": "setCustomValidityValueMissing"
2509
2476
  },
2510
2477
  {
2511
- "name": "name",
2478
+ "name": "setcustomvalidityvaluemissingfilter",
2512
2479
  "type": {
2513
2480
  "text": "string"
2514
2481
  },
2515
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2516
- "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"
2517
2484
  },
2518
2485
  {
2519
- "name": "ondark",
2486
+ "name": "triggericon",
2520
2487
  "type": {
2521
2488
  "text": "boolean"
2522
2489
  },
2523
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2524
- "deprecated": "Use `appearance=\"inverse\"` instead.",
2525
- "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"
2526
2492
  },
2527
2493
  {
2528
- "name": "value",
2494
+ "name": "type",
2529
2495
  "type": {
2530
- "text": "string"
2496
+ "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
2531
2497
  },
2532
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2533
- "fieldName": "value"
2498
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2499
+ "fieldName": "type"
2534
2500
  },
2535
2501
  {
2536
- "name": "tabindex",
2502
+ "name": "typedvalue",
2537
2503
  "type": {
2538
- "text": "number"
2504
+ "text": "string"
2539
2505
  },
2540
- "description": "The tabindex attribute for the checkbox.",
2541
- "fieldName": "tabIndex"
2506
+ "description": "Specifies the value of the input element within the combobox.",
2507
+ "fieldName": "typedValue"
2542
2508
  },
2543
2509
  {
2544
- "name": "aria-checked",
2510
+ "name": "validity",
2545
2511
  "type": {
2546
2512
  "text": "string"
2547
2513
  },
2548
- "description": "The aria-checked attribute for the checkbox.",
2549
- "fieldName": "ariaChecked"
2514
+ "description": "Specifies the `validityState` this element is in.",
2515
+ "fieldName": "validity"
2550
2516
  },
2551
2517
  {
2552
- "name": "aria-disabled",
2518
+ "name": "value",
2553
2519
  "type": {
2554
2520
  "text": "string"
2555
2521
  },
2556
- "description": "The aria-disabled attribute for the checkbox.",
2557
- "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"
2558
2524
  },
2559
2525
  {
2560
- "name": "role",
2526
+ "name": "largefullscreenheadline",
2561
2527
  "type": {
2562
- "text": "string"
2528
+ "text": "boolean"
2563
2529
  },
2564
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2565
- "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"
2566
2541
  }
2567
2542
  ],
2568
2543
  "superclass": {
2569
- "name": "LitElement",
2570
- "package": "lit"
2544
+ "name": "AuroElement",
2545
+ "module": "/components/layoutElement/src/auroElement.js"
2571
2546
  },
2572
- "tagName": "auro-checkbox",
2547
+ "tagName": "auro-combobox",
2573
2548
  "customElement": true
2574
2549
  }
2575
2550
  ],
2576
2551
  "exports": [
2577
2552
  {
2578
2553
  "kind": "js",
2579
- "name": "AuroCheckbox",
2554
+ "name": "AuroCombobox",
2580
2555
  "declaration": {
2581
- "name": "AuroCheckbox",
2582
- "module": "components/checkbox/src/auro-checkbox.js"
2556
+ "name": "AuroCombobox",
2557
+ "module": "components/combobox/src/auro-combobox.js"
2583
2558
  }
2584
2559
  }
2585
2560
  ]
2586
2561
  },
2587
2562
  {
2588
2563
  "kind": "javascript-module",
2589
- "path": "components/checkbox/src/index.js",
2590
- "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
+ ],
2591
2575
  "exports": [
2592
2576
  {
2593
2577
  "kind": "js",
2594
- "name": "AuroCheckbox",
2578
+ "name": "comboboxKeyboardStrategy",
2595
2579
  "declaration": {
2596
- "name": "AuroCheckbox",
2597
- "module": "components/checkbox/src/index.js"
2580
+ "name": "comboboxKeyboardStrategy",
2581
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2598
2582
  }
2599
- },
2583
+ }
2584
+ ]
2585
+ },
2586
+ {
2587
+ "kind": "javascript-module",
2588
+ "path": "components/combobox/src/index.js",
2589
+ "declarations": [],
2590
+ "exports": [
2600
2591
  {
2601
2592
  "kind": "js",
2602
- "name": "AuroCheckboxGroup",
2593
+ "name": "AuroCombobox",
2603
2594
  "declaration": {
2604
- "name": "AuroCheckboxGroup",
2605
- "module": "components/checkbox/src/index.js"
2595
+ "name": "AuroCombobox",
2596
+ "module": "components/combobox/src/index.js"
2606
2597
  }
2607
2598
  }
2608
2599
  ]
2609
2600
  },
2610
2601
  {
2611
2602
  "kind": "javascript-module",
2612
- "path": "components/checkbox/src/registered.js",
2603
+ "path": "components/combobox/src/registered.js",
2613
2604
  "declarations": [],
2614
- "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
+ ]
2615
2615
  },
2616
2616
  {
2617
2617
  "kind": "javascript-module",
@@ -3310,16 +3310,6 @@
3310
3310
  "name": "iconTag",
3311
3311
  "privacy": "private"
3312
3312
  },
3313
- {
3314
- "kind": "field",
3315
- "name": "error",
3316
- "privacy": "public",
3317
- "type": {
3318
- "text": "string"
3319
- },
3320
- "description": "The current error message to display when the component is invalid.",
3321
- "attribute": "error"
3322
- },
3323
3313
  {
3324
3314
  "kind": "field",
3325
3315
  "name": "errorMessage",
@@ -3462,14 +3452,6 @@
3462
3452
  "default": "false",
3463
3453
  "fieldName": "autoPlacement"
3464
3454
  },
3465
- {
3466
- "name": "error",
3467
- "type": {
3468
- "text": "string"
3469
- },
3470
- "description": "The current error message to display when the component is invalid.",
3471
- "fieldName": "error"
3472
- },
3473
3455
  {
3474
3456
  "name": "fullscreenbreakpoint",
3475
3457
  "type": {
@@ -11886,6 +11868,30 @@
11886
11868
  }
11887
11869
  ],
11888
11870
  "members": [
11871
+ {
11872
+ "kind": "field",
11873
+ "name": "isClearable",
11874
+ "description": "Whether the input has a value that the user can clear.",
11875
+ "privacy": "private",
11876
+ "return": {
11877
+ "type": {
11878
+ "text": "boolean"
11879
+ }
11880
+ },
11881
+ "readonly": true
11882
+ },
11883
+ {
11884
+ "kind": "field",
11885
+ "name": "clearWrapperClassMap",
11886
+ "description": "Returns classmap configuration for the clear button wrapper visibility.\nThe wrapper is hidden on the same condition as the button so an empty wrapper\nnever takes up space in the accents row on hover or focus.",
11887
+ "privacy": "private",
11888
+ "return": {
11889
+ "type": {
11890
+ "text": "Record<string, boolean>"
11891
+ }
11892
+ },
11893
+ "readonly": true
11894
+ },
11889
11895
  {
11890
11896
  "kind": "field",
11891
11897
  "name": "clearBtnClassMap",