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

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