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

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