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