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

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