@aurodesignsystem-dev/auro-formkit 0.0.0-pr1507.0 → 0.0.0-pr1508.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/components/checkbox/demo/customize.html +1 -2
  2. package/components/checkbox/demo/customize.min.js +1 -1
  3. package/components/checkbox/demo/getting-started.min.js +1 -1
  4. package/components/checkbox/demo/index.min.js +1 -1
  5. package/components/checkbox/dist/index.js +1 -1
  6. package/components/checkbox/dist/registered.js +1 -1
  7. package/components/combobox/demo/customize.html +1 -2
  8. package/components/combobox/demo/customize.md +108 -132
  9. package/components/combobox/demo/customize.min.js +150 -293
  10. package/components/combobox/demo/getting-started.min.js +150 -293
  11. package/components/combobox/demo/index.min.js +150 -293
  12. package/components/combobox/dist/auro-combobox.d.ts +9 -0
  13. package/components/combobox/dist/index.js +150 -293
  14. package/components/combobox/dist/registered.js +150 -293
  15. package/components/counter/demo/customize.min.js +10 -2
  16. package/components/counter/demo/index.min.js +10 -2
  17. package/components/counter/dist/index.js +10 -2
  18. package/components/counter/dist/registered.js +10 -2
  19. package/components/datepicker/demo/api.md +2 -0
  20. package/components/datepicker/demo/customize.js +0 -2
  21. package/components/datepicker/demo/customize.md +138 -38
  22. package/components/datepicker/demo/customize.min.js +59 -168
  23. package/components/datepicker/demo/index.min.js +59 -150
  24. package/components/datepicker/dist/index.js +59 -150
  25. package/components/datepicker/dist/registered.js +59 -150
  26. package/components/datepicker/dist/src/auro-datepicker.d.ts +2 -0
  27. package/components/dropdown/demo/customize.min.js +9 -1
  28. package/components/dropdown/demo/getting-started.min.js +9 -1
  29. package/components/dropdown/demo/index.min.js +9 -1
  30. package/components/dropdown/dist/auro-dropdown.d.ts +1 -0
  31. package/components/dropdown/dist/index.js +9 -1
  32. package/components/dropdown/dist/registered.js +9 -1
  33. package/components/form/demo/customize.html +6 -6
  34. package/components/form/demo/customize.js +19 -0
  35. package/components/form/demo/customize.md +203 -51
  36. package/components/form/demo/customize.min.js +707 -633
  37. package/components/form/demo/getting-started.min.js +635 -633
  38. package/components/form/demo/index.min.js +635 -633
  39. package/components/form/demo/registerDemoDeps.min.js +272 -596
  40. package/components/form/dist/auro-form.d.ts +122 -4
  41. package/components/form/dist/index.js +363 -37
  42. package/components/form/dist/registered.js +363 -37
  43. package/components/input/demo/customize.html +1 -2
  44. package/components/input/demo/customize.md +54 -53
  45. package/components/input/demo/customize.min.js +41 -147
  46. package/components/input/demo/getting-started.min.js +41 -147
  47. package/components/input/demo/index.min.js +41 -147
  48. package/components/input/dist/base-input.d.ts +1 -49
  49. package/components/input/dist/index.js +41 -147
  50. package/components/input/dist/registered.js +41 -147
  51. package/components/radio/demo/customize.min.js +1 -1
  52. package/components/radio/demo/getting-started.min.js +1 -1
  53. package/components/radio/demo/index.min.js +1 -1
  54. package/components/radio/dist/index.js +1 -1
  55. package/components/radio/dist/registered.js +1 -1
  56. package/components/select/demo/customize.html +1 -2
  57. package/components/select/demo/customize.min.js +10 -2
  58. package/components/select/demo/getting-started.min.js +10 -2
  59. package/components/select/demo/index.min.js +10 -2
  60. package/components/select/dist/index.js +10 -2
  61. package/components/select/dist/registered.js +10 -2
  62. package/custom-elements.json +1592 -1707
  63. package/package.json +1 -1
@@ -267,34 +267,80 @@
267
267
  },
268
268
  {
269
269
  "kind": "javascript-module",
270
- "path": "components/checkbox/src/auro-checkbox-group.js",
270
+ "path": "components/combobox/src/auro-combobox.js",
271
271
  "declarations": [
272
272
  {
273
273
  "kind": "class",
274
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
275
- "name": "AuroCheckboxGroup",
274
+ "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.",
275
+ "name": "AuroCombobox",
276
276
  "slots": [
277
277
  {
278
- "description": "Allows for the legend to be overridden.",
279
- "name": "legend"
278
+ "description": "Default slot for the menu content.",
279
+ "name": ""
280
280
  },
281
281
  {
282
+ "type": {
283
+ "text": "HTMLSlotElement"
284
+ },
282
285
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
283
286
  "name": "optionalLabel"
284
287
  },
285
288
  {
286
- "description": "Allows for the helper text to be overridden.",
289
+ "description": "Sets aria-label on clear button",
290
+ "name": "ariaLabel.input.clear"
291
+ },
292
+ {
293
+ "description": "Sets aria-label on close button in fullscreen bib",
294
+ "name": "ariaLabel.bib.close"
295
+ },
296
+ {
297
+ "description": "Defines the headline to display above menu-options",
298
+ "name": "bib.fullscreen.headline"
299
+ },
300
+ {
301
+ "description": "Defines the content of the label.",
302
+ "name": "label"
303
+ },
304
+ {
305
+ "description": "Defines the content of the helpText.",
287
306
  "name": "helpText"
288
307
  },
289
308
  {
290
- "description": "The default slot for the checkbox items.",
291
- "name": "default"
309
+ "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
310
+ "name": "displayValue"
292
311
  }
293
312
  ],
294
313
  "members": [
295
314
  {
296
315
  "kind": "method",
297
- "name": "_initializeDefaults"
316
+ "name": "_initializeDefaults",
317
+ "privacy": "private",
318
+ "return": {
319
+ "type": {
320
+ "text": "void"
321
+ }
322
+ }
323
+ },
324
+ {
325
+ "kind": "field",
326
+ "name": "inputValue",
327
+ "description": "Returns the current value of the input element within the combobox.",
328
+ "return": {
329
+ "type": {
330
+ "text": "string|undefined"
331
+ }
332
+ },
333
+ "readonly": true
334
+ },
335
+ {
336
+ "kind": "method",
337
+ "name": "isValid",
338
+ "description": "Checks if the element is valid.",
339
+ "return": {
340
+ "type": {
341
+ "text": "boolean"
342
+ }
343
+ }
298
344
  },
299
345
  {
300
346
  "kind": "method",
@@ -303,7 +349,7 @@
303
349
  "parameters": [
304
350
  {
305
351
  "name": "name",
306
- "default": "\"auro-checkbox-group\"",
352
+ "default": "'auro-combobox'",
307
353
  "description": "The name of the element that you want to register.",
308
354
  "optional": true,
309
355
  "type": {
@@ -315,24 +361,82 @@
315
361
  },
316
362
  {
317
363
  "kind": "method",
318
- "name": "handleValueUpdate",
364
+ "name": "activateFirstEnabledAvailableOption",
365
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
366
+ "privacy": "private",
367
+ "return": {
368
+ "type": {
369
+ "text": "void"
370
+ }
371
+ }
372
+ },
373
+ {
374
+ "kind": "method",
375
+ "name": "activateLastEnabledAvailableOption",
376
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
377
+ "privacy": "private",
378
+ "return": {
379
+ "type": {
380
+ "text": "void"
381
+ }
382
+ }
383
+ },
384
+ {
385
+ "kind": "method",
386
+ "name": "updateFilter",
387
+ "description": "Updates the filter for the available options based on the input value.",
388
+ "privacy": "private"
389
+ },
390
+ {
391
+ "kind": "method",
392
+ "name": "syncValuesAndStates",
393
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
394
+ "privacy": "private",
395
+ "return": {
396
+ "type": {
397
+ "text": "void"
398
+ }
399
+ }
400
+ },
401
+ {
402
+ "kind": "method",
403
+ "name": "updateTriggerTextDisplay",
319
404
  "parameters": [
320
405
  {
321
- "name": "value",
322
- "description": "The value of the checkbox.",
406
+ "name": "label",
407
+ "description": "The label of the selected option.",
323
408
  "type": {
324
- "text": "String"
409
+ "text": "string"
325
410
  }
326
- },
411
+ }
412
+ ],
413
+ "description": "Update displayValue or input.value, it's called when making a selection.",
414
+ "privacy": "private"
415
+ },
416
+ {
417
+ "kind": "method",
418
+ "name": "syncInputValuesAcrossTriggerAndBib",
419
+ "parameters": [
327
420
  {
328
- "name": "selected",
329
- "description": "The checked state of the checkbox.",
421
+ "name": "nextValue",
422
+ "description": "The value to write to both inputs.",
330
423
  "type": {
331
- "text": "Boolean"
424
+ "text": "string"
332
425
  }
333
426
  }
334
427
  ],
335
- "description": "Helper method to handle checkbox value changing.",
428
+ "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.",
429
+ "return": {
430
+ "type": {
431
+ "text": "Promise<void> | null"
432
+ }
433
+ },
434
+ "privacy": "private"
435
+ },
436
+ {
437
+ "kind": "method",
438
+ "name": "handleMenuOptions",
439
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
336
440
  "privacy": "private",
337
441
  "return": {
338
442
  "type": {
@@ -342,8 +446,8 @@
342
446
  },
343
447
  {
344
448
  "kind": "method",
345
- "name": "handlePreselectedItems",
346
- "description": "Helper method that handles the state of preselected checkboxes.",
449
+ "name": "generateOptionsArray",
450
+ "description": "Determines the element error state based on the `required` attribute and input value.",
347
451
  "privacy": "private",
348
452
  "return": {
349
453
  "type": {
@@ -353,9 +457,8 @@
353
457
  },
354
458
  {
355
459
  "kind": "method",
356
- "name": "handleItems",
357
- "description": "Helper method that handles the state of checkboxes.",
358
- "privacy": "private",
460
+ "name": "hideBib",
461
+ "description": "Hides the dropdown bib if its open.",
359
462
  "return": {
360
463
  "type": {
361
464
  "text": "void"
@@ -364,8 +467,8 @@
364
467
  },
365
468
  {
366
469
  "kind": "method",
367
- "name": "reset",
368
- "description": "Resets component to initial state.",
470
+ "name": "showBib",
471
+ "description": "Shows the dropdown bib if there are options to show.",
369
472
  "return": {
370
473
  "type": {
371
474
  "text": "void"
@@ -374,325 +477,102 @@
374
477
  },
375
478
  {
376
479
  "kind": "method",
377
- "name": "validate",
378
- "parameters": [
379
- {
380
- "name": "force",
381
- "default": "false",
382
- "description": "Whether to force validation.",
383
- "optional": true,
384
- "type": {
385
- "text": "boolean"
386
- }
480
+ "name": "configureDropdown",
481
+ "description": "Binds all behavior needed to the dropdown after rendering.",
482
+ "privacy": "private",
483
+ "return": {
484
+ "type": {
485
+ "text": "void"
387
486
  }
388
- ],
389
- "description": "Validates value."
487
+ }
390
488
  },
391
489
  {
392
- "kind": "field",
393
- "name": "appearance",
394
- "privacy": "public",
395
- "type": {
396
- "text": "'default' | 'inverse'"
397
- },
398
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
399
- "default": "'default'",
400
- "attribute": "appearance",
401
- "reflects": true
490
+ "kind": "method",
491
+ "name": "setClearBtnFocus",
492
+ "privacy": "private"
402
493
  },
403
494
  {
404
- "kind": "field",
405
- "name": "disabled",
406
- "privacy": "public",
407
- "type": {
408
- "text": "boolean"
409
- },
410
- "description": "If set, disables the checkbox group.",
411
- "attribute": "disabled",
412
- "reflects": true
495
+ "kind": "method",
496
+ "name": "setTriggerInputFocus",
497
+ "privacy": "private"
413
498
  },
414
499
  {
415
- "kind": "field",
416
- "name": "error",
417
- "privacy": "public",
418
- "type": {
419
- "text": "string"
420
- },
421
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
422
- "attribute": "error",
423
- "reflects": true
500
+ "kind": "method",
501
+ "name": "setInputFocus",
502
+ "privacy": "private"
424
503
  },
425
504
  {
426
- "kind": "field",
427
- "name": "horizontal",
428
- "privacy": "public",
429
- "type": {
430
- "text": "boolean"
431
- },
432
- "description": "If set, checkboxes will be aligned horizontally.",
433
- "attribute": "horizontal",
434
- "reflects": true
505
+ "kind": "method",
506
+ "name": "updateBibDialogRole",
507
+ "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.",
508
+ "privacy": "private"
435
509
  },
436
510
  {
437
- "kind": "field",
438
- "name": "noValidate",
439
- "privacy": "public",
440
- "type": {
441
- "text": "boolean"
442
- },
443
- "description": "If set, disables auto-validation on blur.",
444
- "attribute": "noValidate",
445
- "reflects": true
511
+ "kind": "method",
512
+ "name": "updateMenuShapeSize",
513
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
514
+ "privacy": "private"
446
515
  },
447
516
  {
448
- "kind": "field",
449
- "name": "onDark",
450
- "privacy": "public",
451
- "type": {
452
- "text": "boolean"
453
- },
454
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
455
- "attribute": "onDark",
456
- "reflects": true
517
+ "kind": "method",
518
+ "name": "_getAnnouncementRoot",
519
+ "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.",
520
+ "privacy": "private",
521
+ "return": {
522
+ "type": {
523
+ "text": "ShadowRoot"
524
+ }
525
+ }
457
526
  },
458
527
  {
459
- "kind": "field",
460
- "name": "required",
461
- "privacy": "public",
462
- "type": {
463
- "text": "boolean"
464
- },
465
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
466
- "attribute": "required",
467
- "reflects": true
468
- },
469
- {
470
- "kind": "field",
471
- "name": "setCustomValidity",
472
- "privacy": "public",
473
- "type": {
474
- "text": "string"
475
- },
476
- "description": "Sets a custom help text message to display for all validityStates.",
477
- "attribute": "setCustomValidity"
478
- },
479
- {
480
- "kind": "field",
481
- "name": "setCustomValidityCustomError",
482
- "privacy": "public",
483
- "type": {
484
- "text": "string"
485
- },
486
- "description": "Custom help text message to display when validity = `customError`.",
487
- "attribute": "setCustomValidityCustomError"
488
- },
489
- {
490
- "kind": "field",
491
- "name": "setCustomValidityValueMissing",
492
- "privacy": "public",
493
- "type": {
494
- "text": "string"
495
- },
496
- "description": "Custom help text message to display when validity = `valueMissing`.",
497
- "attribute": "setCustomValidityValueMissing"
498
- },
499
- {
500
- "kind": "field",
501
- "name": "validity",
502
- "privacy": "public",
503
- "type": {
504
- "text": "string"
505
- },
506
- "description": "Specifies the `validityState` this element is in.",
507
- "attribute": "validity",
508
- "reflects": true
509
- }
510
- ],
511
- "events": [
512
- {
513
- "name": "input",
514
- "type": {
515
- "text": "CustomEvent"
528
+ "kind": "method",
529
+ "name": "configureMenu",
530
+ "description": "Binds all behavior needed to the menu after rendering.",
531
+ "privacy": "private",
532
+ "return": {
533
+ "type": {
534
+ "text": "void"
535
+ }
516
536
  }
517
537
  },
518
- {
519
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
520
- "name": "auroFormElement-validated"
521
- }
522
- ],
523
- "attributes": [
524
- {
525
- "name": "appearance",
526
- "type": {
527
- "text": "'default' | 'inverse'"
528
- },
529
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
530
- "default": "'default'",
531
- "fieldName": "appearance"
532
- },
533
- {
534
- "name": "disabled",
535
- "type": {
536
- "text": "boolean"
537
- },
538
- "description": "If set, disables the checkbox group.",
539
- "fieldName": "disabled"
540
- },
541
- {
542
- "name": "error",
543
- "type": {
544
- "text": "string"
545
- },
546
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
547
- "fieldName": "error"
548
- },
549
- {
550
- "name": "horizontal",
551
- "type": {
552
- "text": "boolean"
553
- },
554
- "description": "If set, checkboxes will be aligned horizontally.",
555
- "fieldName": "horizontal"
556
- },
557
- {
558
- "name": "noValidate",
559
- "type": {
560
- "text": "boolean"
561
- },
562
- "description": "If set, disables auto-validation on blur.",
563
- "fieldName": "noValidate"
564
- },
565
- {
566
- "name": "onDark",
567
- "type": {
568
- "text": "boolean"
569
- },
570
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
571
- "fieldName": "onDark"
572
- },
573
- {
574
- "name": "required",
575
- "type": {
576
- "text": "boolean"
577
- },
578
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
579
- "fieldName": "required"
580
- },
581
- {
582
- "name": "setCustomValidity",
583
- "type": {
584
- "text": "string"
585
- },
586
- "description": "Sets a custom help text message to display for all validityStates.",
587
- "fieldName": "setCustomValidity"
588
- },
589
- {
590
- "name": "setCustomValidityCustomError",
591
- "type": {
592
- "text": "string"
593
- },
594
- "description": "Custom help text message to display when validity = `customError`.",
595
- "fieldName": "setCustomValidityCustomError"
596
- },
597
- {
598
- "name": "setCustomValidityValueMissing",
599
- "type": {
600
- "text": "string"
601
- },
602
- "description": "Custom help text message to display when validity = `valueMissing`.",
603
- "fieldName": "setCustomValidityValueMissing"
604
- },
605
- {
606
- "name": "validity",
607
- "type": {
608
- "text": "string"
609
- },
610
- "description": "Specifies the `validityState` this element is in.",
611
- "fieldName": "validity"
612
- }
613
- ],
614
- "superclass": {
615
- "name": "LitElement",
616
- "package": "lit"
617
- },
618
- "tagName": "auro-checkbox-group",
619
- "customElement": true
620
- }
621
- ],
622
- "exports": [
623
- {
624
- "kind": "js",
625
- "name": "AuroCheckboxGroup",
626
- "declaration": {
627
- "name": "AuroCheckboxGroup",
628
- "module": "components/checkbox/src/auro-checkbox-group.js"
629
- }
630
- }
631
- ]
632
- },
633
- {
634
- "kind": "javascript-module",
635
- "path": "components/checkbox/src/auro-checkbox.js",
636
- "declarations": [
637
- {
638
- "kind": "class",
639
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
640
- "name": "AuroCheckbox",
641
- "cssParts": [
642
- {
643
- "description": "apply css to a specific checkbox.",
644
- "name": "checkbox"
645
- },
646
- {
647
- "description": "apply css to a specific checkbox's input.",
648
- "name": "checkbox-input"
649
- },
650
- {
651
- "description": "apply css to a specific checkbox's label.",
652
- "name": "checkbox-label"
653
- }
654
- ],
655
- "slots": [
656
- {
657
- "description": "The default slot for the checkbox label.",
658
- "name": "default"
659
- }
660
- ],
661
- "members": [
662
538
  {
663
539
  "kind": "method",
664
- "name": "_initializeDefaults"
540
+ "name": "configureInput",
541
+ "description": "Binds all behavior needed to the input after rendering.",
542
+ "privacy": "private",
543
+ "return": {
544
+ "type": {
545
+ "text": "void"
546
+ }
547
+ }
665
548
  },
666
549
  {
667
550
  "kind": "method",
668
- "name": "register",
669
- "static": true,
551
+ "name": "handleMenuLoadingChange",
670
552
  "parameters": [
671
553
  {
672
- "name": "name",
673
- "default": "\"auro-checkbox\"",
674
- "description": "The name of element that you want to register to.",
675
- "optional": true,
554
+ "name": "event",
555
+ "description": "The event object containing details about the loading state change.",
676
556
  "type": {
677
- "text": "string"
557
+ "text": "CustomEvent"
678
558
  }
679
- }
680
- ],
681
- "description": "This will register this element with the browser."
682
- },
683
- {
684
- "kind": "method",
685
- "name": "handleChange",
686
- "parameters": [
559
+ },
687
560
  {
688
- "name": "event",
689
- "description": "The change event from the checkbox input.",
561
+ "description": "Indicates whether the menu is currently loading.",
562
+ "name": "event.detail.loading",
690
563
  "type": {
691
- "text": "Event"
564
+ "text": "boolean"
565
+ }
566
+ },
567
+ {
568
+ "description": "Indicates if there are loading placeholders present.",
569
+ "name": "event.detail.hasLoadingPlaceholder",
570
+ "type": {
571
+ "text": "boolean"
692
572
  }
693
573
  }
694
574
  ],
695
- "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.",
575
+ "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.",
696
576
  "privacy": "private",
697
577
  "return": {
698
578
  "type": {
@@ -702,17 +582,17 @@
702
582
  },
703
583
  {
704
584
  "kind": "method",
705
- "name": "handleInput",
585
+ "name": "handleInputValueChange",
706
586
  "parameters": [
707
587
  {
708
588
  "name": "event",
709
- "description": "The input event from the checkbox input.",
589
+ "description": "The input event triggered by the input element.",
710
590
  "type": {
711
591
  "text": "Event"
712
592
  }
713
593
  }
714
594
  ],
715
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
595
+ "description": "Handle changes to the input value and trigger changes that should result.",
716
596
  "privacy": "private",
717
597
  "return": {
718
598
  "type": {
@@ -722,9 +602,9 @@
722
602
  },
723
603
  {
724
604
  "kind": "method",
725
- "name": "handleFocusin",
726
- "description": "Function to support",
727
- "privacy": "private",
605
+ "name": "configureCombobox",
606
+ "description": "Binds all behavior needed to the combobox after rendering.",
607
+ "privacy": "private",
728
608
  "return": {
729
609
  "type": {
730
610
  "text": "void"
@@ -733,12 +613,30 @@
733
613
  },
734
614
  {
735
615
  "kind": "method",
736
- "name": "generateIconHtml",
737
- "description": "Function to generate checkmark svg.",
738
- "privacy": "private",
616
+ "name": "focus",
617
+ "description": "Focuses the combobox trigger input.",
739
618
  "return": {
740
619
  "type": {
741
- "text": "HTMLElement"
620
+ "text": "void"
621
+ }
622
+ }
623
+ },
624
+ {
625
+ "kind": "method",
626
+ "name": "setMenuValue",
627
+ "parameters": [
628
+ {
629
+ "name": "value",
630
+ "description": "The value to set on the menu.",
631
+ "type": {
632
+ "text": "string"
633
+ }
634
+ }
635
+ ],
636
+ "description": "Sets the menu value if menu is available.",
637
+ "return": {
638
+ "type": {
639
+ "text": "void"
742
640
  }
743
641
  }
744
642
  },
@@ -754,8 +652,57 @@
754
652
  },
755
653
  {
756
654
  "kind": "method",
757
- "name": "updateAriaLabel",
758
- "description": "Updates the aria-label based on slot content.",
655
+ "name": "clear",
656
+ "description": "Clears the current value of the combobox.",
657
+ "return": {
658
+ "type": {
659
+ "text": "void"
660
+ }
661
+ }
662
+ },
663
+ {
664
+ "kind": "method",
665
+ "name": "validate",
666
+ "parameters": [
667
+ {
668
+ "name": "force",
669
+ "default": "false",
670
+ "description": "Whether to force validation.",
671
+ "optional": true,
672
+ "type": {
673
+ "text": "boolean"
674
+ }
675
+ }
676
+ ],
677
+ "description": "Validates value."
678
+ },
679
+ {
680
+ "kind": "method",
681
+ "name": "transportAssignedNodes",
682
+ "parameters": [
683
+ {
684
+ "name": "slot",
685
+ "description": "The slot element containing the nodes to apply.",
686
+ "type": {
687
+ "text": "HTMLSlotElement"
688
+ }
689
+ },
690
+ {
691
+ "name": "target",
692
+ "description": "The target element to apply the nodes to.",
693
+ "type": {
694
+ "text": "HTMLElement"
695
+ }
696
+ },
697
+ {
698
+ "name": "newSlotName",
699
+ "description": "The new slot name for the applied nodes.",
700
+ "type": {
701
+ "text": "string"
702
+ }
703
+ }
704
+ ],
705
+ "description": "Applies slotted nodes to a target element with a new slot name.",
759
706
  "privacy": "private",
760
707
  "return": {
761
708
  "type": {
@@ -765,17 +712,31 @@
765
712
  },
766
713
  {
767
714
  "kind": "method",
768
- "name": "handleKeyDown",
715
+ "name": "updateActiveOption",
716
+ "parameters": [
717
+ {
718
+ "name": "index",
719
+ "description": "Index of the option to make active.",
720
+ "type": {
721
+ "text": "number"
722
+ }
723
+ }
724
+ ],
725
+ "description": "Updates the active option in the menu."
726
+ },
727
+ {
728
+ "kind": "method",
729
+ "name": "handleSlotChange",
769
730
  "parameters": [
770
731
  {
771
732
  "name": "event",
772
- "description": "The keydown event from the checkbox input.",
733
+ "description": "`slotchange` event.",
773
734
  "type": {
774
- "text": "KeyboardEvent"
735
+ "text": "Event"
775
736
  }
776
737
  }
777
738
  ],
778
- "description": "Handles keydown event to toggle the checkbox with Space key.",
739
+ "description": "Watch for slot changes and recalculate the menuoptions.",
779
740
  "privacy": "private",
780
741
  "return": {
781
742
  "type": {
@@ -788,7 +749,7 @@
788
749
  "name": "appearance",
789
750
  "privacy": "public",
790
751
  "type": {
791
- "text": "'default' | 'inverse'"
752
+ "text": "string"
792
753
  },
793
754
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
794
755
  "default": "'default'",
@@ -797,974 +758,1089 @@
797
758
  },
798
759
  {
799
760
  "kind": "field",
800
- "name": "checked",
761
+ "name": "autocomplete",
801
762
  "privacy": "public",
802
763
  "type": {
803
- "text": "boolean"
764
+ "text": "string"
804
765
  },
805
- "description": "If set to true, the checkbox will be filled with a checkmark.",
806
- "attribute": "checked",
766
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
767
+ "attribute": "autocomplete",
807
768
  "reflects": true
808
769
  },
809
770
  {
810
771
  "kind": "field",
811
- "name": "disabled",
772
+ "name": "autoPlacement",
812
773
  "privacy": "public",
813
774
  "type": {
814
775
  "text": "boolean"
815
776
  },
816
- "description": "If set to true, the checkbox will not be clickable.",
817
- "attribute": "disabled",
777
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
778
+ "attribute": "autoPlacement",
818
779
  "reflects": true
819
780
  },
820
781
  {
821
782
  "kind": "field",
822
- "name": "error",
783
+ "name": "availableOptions",
784
+ "privacy": "private",
785
+ "type": {
786
+ "text": "array"
787
+ },
788
+ "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).",
789
+ "attribute": "availableOptions"
790
+ },
791
+ {
792
+ "kind": "field",
793
+ "name": "behavior",
823
794
  "privacy": "public",
824
795
  "type": {
825
- "text": "boolean"
796
+ "text": "'filter' | 'suggestion'"
826
797
  },
827
- "description": "If set to true, the checkbox will be displayed with an error state.",
828
- "attribute": "error",
798
+ "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.",
799
+ "default": "'suggestion'",
800
+ "attribute": "behavior",
829
801
  "reflects": true
830
802
  },
831
803
  {
832
804
  "kind": "field",
833
- "name": "id",
805
+ "name": "checkmark",
834
806
  "privacy": "public",
835
807
  "type": {
836
- "text": "string"
808
+ "text": "boolean"
837
809
  },
838
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
839
- "attribute": "id",
810
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
811
+ "attribute": "checkmark",
840
812
  "reflects": true
841
813
  },
842
814
  {
843
815
  "kind": "field",
844
- "name": "inputId",
845
- "privacy": "private",
816
+ "name": "disabled",
817
+ "privacy": "public",
846
818
  "type": {
847
- "text": "string"
819
+ "text": "boolean"
848
820
  },
849
- "description": "The id for input node."
821
+ "description": "If set, disables the combobox.",
822
+ "attribute": "disabled",
823
+ "reflects": true
850
824
  },
851
825
  {
852
826
  "kind": "field",
853
- "name": "name",
854
- "privacy": "public",
827
+ "name": "dropdownId",
828
+ "privacy": "private",
855
829
  "type": {
856
830
  "text": "string"
857
831
  },
858
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
859
- "attribute": "name"
832
+ "description": "ID for the dropdown."
860
833
  },
861
834
  {
862
835
  "kind": "field",
863
- "name": "onDark",
864
- "privacy": "public",
836
+ "name": "dropdownOpen",
837
+ "privacy": "private",
865
838
  "type": {
866
839
  "text": "boolean"
867
840
  },
868
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
869
- "attribute": "onDark",
870
- "reflects": true
841
+ "description": "Whether or not the dropdown is open."
871
842
  },
872
843
  {
873
844
  "kind": "field",
874
- "name": "touched",
875
- "privacy": "private",
845
+ "name": "dvInputOnly",
846
+ "privacy": "public",
876
847
  "type": {
877
848
  "text": "boolean"
878
849
  },
879
- "description": "Indicates whether the checkbox has been interacted with."
850
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
851
+ "attribute": "dvInputOnly",
852
+ "reflects": true
880
853
  },
881
854
  {
882
855
  "kind": "field",
883
- "name": "value",
856
+ "name": "error",
884
857
  "privacy": "public",
885
858
  "type": {
886
859
  "text": "string"
887
860
  },
888
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
889
- "attribute": "value"
861
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
862
+ "attribute": "error",
863
+ "reflects": true
890
864
  },
891
865
  {
892
866
  "kind": "field",
893
- "name": "tabIndex",
894
- "privacy": "private",
867
+ "name": "format",
868
+ "privacy": "public",
895
869
  "type": {
896
- "text": "number"
870
+ "text": "string"
897
871
  },
898
- "description": "The tabindex attribute for the checkbox.",
899
- "attribute": "tabindex",
872
+ "description": "Specifies the input mask format.",
873
+ "attribute": "format",
900
874
  "reflects": true
901
875
  },
902
876
  {
903
877
  "kind": "field",
904
- "name": "ariaChecked",
905
- "privacy": "private",
878
+ "name": "inputmode",
879
+ "privacy": "public",
906
880
  "type": {
907
881
  "text": "string"
908
882
  },
909
- "description": "The aria-checked attribute for the checkbox.",
910
- "attribute": "aria-checked",
883
+ "description": "Exposes inputmode attribute for input.",
884
+ "attribute": "inputmode",
911
885
  "reflects": true
912
886
  },
913
887
  {
914
888
  "kind": "field",
915
- "name": "ariaDisabled",
916
- "privacy": "private",
889
+ "name": "layout",
890
+ "privacy": "public",
917
891
  "type": {
918
892
  "text": "string"
919
893
  },
920
- "description": "The aria-disabled attribute for the checkbox.",
921
- "attribute": "aria-disabled",
922
- "reflects": true
894
+ "description": "Sets the layout of the combobox.",
895
+ "default": "'classic'",
896
+ "attribute": "layout",
897
+ "reflects": true,
898
+ "inheritedFrom": {
899
+ "name": "AuroElement",
900
+ "module": "components/layoutElement/src/auroElement.js"
901
+ }
923
902
  },
924
903
  {
925
904
  "kind": "field",
926
- "name": "role",
905
+ "name": "matchWidth",
927
906
  "privacy": "private",
928
907
  "type": {
929
- "text": "string"
908
+ "text": "boolean"
930
909
  },
931
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
932
- "attribute": "role",
910
+ "description": "If declared, the popover and trigger will be set to the same width.",
911
+ "attribute": "matchWidth",
933
912
  "reflects": true
934
- }
935
- ],
936
- "events": [
913
+ },
937
914
  {
938
- "name": "auroCheckbox-input",
915
+ "kind": "field",
916
+ "name": "noFilter",
917
+ "privacy": "public",
939
918
  "type": {
940
- "text": "CustomEvent"
941
- }
919
+ "text": "boolean"
920
+ },
921
+ "description": "If set, combobox will not filter menuoptions based on input.",
922
+ "attribute": "noFilter",
923
+ "reflects": true
942
924
  },
943
925
  {
944
- "name": "auroCheckbox-focusin",
926
+ "kind": "field",
927
+ "name": "noFlip",
928
+ "privacy": "public",
945
929
  "type": {
946
- "text": "CustomEvent"
947
- }
930
+ "text": "boolean"
931
+ },
932
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
933
+ "attribute": "noFlip",
934
+ "reflects": true
948
935
  },
949
936
  {
950
- "name": "auroCheckbox-focusout",
951
- "type": {
952
- "text": "CustomEvent"
953
- }
937
+ "kind": "field",
938
+ "name": "shift",
939
+ "privacy": "public",
940
+ "type": {
941
+ "text": "boolean"
942
+ },
943
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
944
+ "attribute": "shift",
945
+ "reflects": true
954
946
  },
955
947
  {
956
- "description": "(Deprecated) Notifies when checked value is changed.",
957
- "name": "change"
948
+ "kind": "field",
949
+ "name": "noValidate",
950
+ "privacy": "public",
951
+ "type": {
952
+ "text": "boolean"
953
+ },
954
+ "description": "If set, disables auto-validation on blur.",
955
+ "attribute": "noValidate",
956
+ "reflects": true
958
957
  },
959
958
  {
960
- "description": "Notifies when when checked value is changed by user's interface.",
961
- "name": "input"
962
- }
963
- ],
964
- "attributes": [
965
- {
966
- "name": "appearance",
959
+ "kind": "field",
960
+ "name": "offset",
961
+ "privacy": "public",
967
962
  "type": {
968
- "text": "'default' | 'inverse'"
963
+ "text": "number"
969
964
  },
970
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
971
- "default": "'default'",
972
- "fieldName": "appearance"
965
+ "description": "Gap between the trigger element and bib.",
966
+ "default": "0",
967
+ "attribute": "offset",
968
+ "reflects": true
973
969
  },
974
970
  {
975
- "name": "checked",
971
+ "kind": "field",
972
+ "name": "onDark",
973
+ "privacy": "public",
976
974
  "type": {
977
975
  "text": "boolean"
978
976
  },
979
- "description": "If set to true, the checkbox will be filled with a checkmark.",
980
- "fieldName": "checked"
977
+ "attribute": "onDark",
978
+ "reflects": true,
979
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
980
+ "inheritedFrom": {
981
+ "name": "AuroElement",
982
+ "module": "components/layoutElement/src/auroElement.js"
983
+ }
981
984
  },
982
985
  {
983
- "name": "disabled",
986
+ "kind": "field",
987
+ "name": "optionSelected",
988
+ "privacy": "public",
984
989
  "type": {
985
- "text": "boolean"
990
+ "text": "HTMLElement"
986
991
  },
987
- "description": "If set to true, the checkbox will not be clickable.",
988
- "fieldName": "disabled"
992
+ "description": "Specifies the current selected option.",
993
+ "attribute": "optionSelected"
989
994
  },
990
995
  {
991
- "name": "error",
996
+ "kind": "field",
997
+ "name": "persistInput",
998
+ "privacy": "public",
992
999
  "type": {
993
1000
  "text": "boolean"
994
1001
  },
995
- "description": "If set to true, the checkbox will be displayed with an error state.",
996
- "fieldName": "error"
1002
+ "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.",
1003
+ "attribute": "persistInput",
1004
+ "reflects": true
997
1005
  },
998
1006
  {
999
- "name": "id",
1007
+ "kind": "field",
1008
+ "name": "placement",
1009
+ "privacy": "public",
1000
1010
  "type": {
1001
- "text": "string"
1011
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1002
1012
  },
1003
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
1004
- "fieldName": "id"
1013
+ "description": "Position where the bib should appear relative to the trigger.",
1014
+ "default": "'bottom-start'",
1015
+ "attribute": "placement",
1016
+ "reflects": true
1005
1017
  },
1006
1018
  {
1007
- "name": "name",
1019
+ "kind": "field",
1020
+ "name": "placeholder",
1021
+ "privacy": "public",
1008
1022
  "type": {
1009
1023
  "text": "string"
1010
1024
  },
1011
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
1012
- "fieldName": "name"
1025
+ "description": "Define custom placeholder text, only supported by date input formats.",
1026
+ "attribute": "placeholder",
1027
+ "reflects": true
1013
1028
  },
1014
1029
  {
1015
- "name": "onDark",
1030
+ "kind": "field",
1031
+ "name": "required",
1032
+ "privacy": "public",
1016
1033
  "type": {
1017
1034
  "text": "boolean"
1018
1035
  },
1019
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1020
- "fieldName": "onDark"
1036
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1037
+ "attribute": "required",
1038
+ "reflects": true
1021
1039
  },
1022
1040
  {
1023
- "name": "value",
1041
+ "kind": "field",
1042
+ "name": "setCustomValidity",
1043
+ "privacy": "public",
1024
1044
  "type": {
1025
1045
  "text": "string"
1026
1046
  },
1027
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1028
- "fieldName": "value"
1047
+ "description": "Sets a custom help text message to display for all validityStates.",
1048
+ "attribute": "setCustomValidity"
1029
1049
  },
1030
1050
  {
1031
- "name": "tabindex",
1051
+ "kind": "field",
1052
+ "name": "setCustomValidityCustomError",
1053
+ "privacy": "public",
1032
1054
  "type": {
1033
- "text": "number"
1055
+ "text": "string"
1034
1056
  },
1035
- "description": "The tabindex attribute for the checkbox.",
1036
- "fieldName": "tabIndex"
1057
+ "description": "Custom help text message to display when validity = `customError`.",
1058
+ "attribute": "setCustomValidityCustomError"
1037
1059
  },
1038
1060
  {
1039
- "name": "aria-checked",
1061
+ "kind": "field",
1062
+ "name": "setCustomValidityValueMissing",
1063
+ "privacy": "public",
1040
1064
  "type": {
1041
1065
  "text": "string"
1042
1066
  },
1043
- "description": "The aria-checked attribute for the checkbox.",
1044
- "fieldName": "ariaChecked"
1067
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1068
+ "attribute": "setCustomValidityValueMissing"
1045
1069
  },
1046
1070
  {
1047
- "name": "aria-disabled",
1071
+ "kind": "field",
1072
+ "name": "setCustomValidityValueMissingFilter",
1073
+ "privacy": "public",
1048
1074
  "type": {
1049
1075
  "text": "string"
1050
1076
  },
1051
- "description": "The aria-disabled attribute for the checkbox.",
1052
- "fieldName": "ariaDisabled"
1077
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1078
+ "attribute": "setCustomValidityValueMissingFilter"
1053
1079
  },
1054
1080
  {
1055
- "name": "role",
1081
+ "kind": "field",
1082
+ "name": "touched",
1083
+ "privacy": "private",
1056
1084
  "type": {
1057
- "text": "string"
1085
+ "text": "boolean"
1058
1086
  },
1059
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
1060
- "fieldName": "role"
1061
- }
1062
- ],
1063
- "superclass": {
1064
- "name": "LitElement",
1065
- "package": "lit"
1066
- },
1067
- "tagName": "auro-checkbox",
1068
- "customElement": true
1069
- }
1070
- ],
1071
- "exports": [
1072
- {
1073
- "kind": "js",
1074
- "name": "AuroCheckbox",
1075
- "declaration": {
1076
- "name": "AuroCheckbox",
1077
- "module": "components/checkbox/src/auro-checkbox.js"
1078
- }
1079
- }
1080
- ]
1081
- },
1082
- {
1083
- "kind": "javascript-module",
1084
- "path": "components/checkbox/src/index.js",
1085
- "declarations": [],
1086
- "exports": [
1087
- {
1088
- "kind": "js",
1089
- "name": "AuroCheckbox",
1090
- "declaration": {
1091
- "name": "AuroCheckbox",
1092
- "module": "components/checkbox/src/index.js"
1093
- }
1094
- },
1095
- {
1096
- "kind": "js",
1097
- "name": "AuroCheckboxGroup",
1098
- "declaration": {
1099
- "name": "AuroCheckboxGroup",
1100
- "module": "components/checkbox/src/index.js"
1101
- }
1102
- }
1103
- ]
1104
- },
1105
- {
1106
- "kind": "javascript-module",
1107
- "path": "components/checkbox/src/registered.js",
1108
- "declarations": [],
1109
- "exports": []
1110
- },
1111
- {
1112
- "kind": "javascript-module",
1113
- "path": "components/combobox/src/auro-combobox.js",
1114
- "declarations": [
1115
- {
1116
- "kind": "class",
1117
- "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.",
1118
- "name": "AuroCombobox",
1119
- "slots": [
1120
- {
1121
- "description": "Default slot for the menu content.",
1122
- "name": ""
1087
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1123
1088
  },
1124
1089
  {
1090
+ "kind": "field",
1091
+ "name": "triggerIcon",
1092
+ "privacy": "public",
1125
1093
  "type": {
1126
- "text": "HTMLSlotElement"
1094
+ "text": "boolean"
1127
1095
  },
1128
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1129
- "name": "optionalLabel"
1130
- },
1131
- {
1132
- "description": "Sets aria-label on clear button",
1133
- "name": "ariaLabel.input.clear"
1096
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1097
+ "attribute": "triggerIcon",
1098
+ "reflects": true
1134
1099
  },
1135
1100
  {
1136
- "description": "Sets aria-label on close button in fullscreen bib",
1137
- "name": "ariaLabel.bib.close"
1101
+ "kind": "field",
1102
+ "name": "type",
1103
+ "privacy": "public",
1104
+ "type": {
1105
+ "text": "string"
1106
+ },
1107
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1108
+ "attribute": "type",
1109
+ "reflects": true
1138
1110
  },
1139
1111
  {
1140
- "description": "Defines the headline to display above menu-options",
1141
- "name": "bib.fullscreen.headline"
1112
+ "kind": "field",
1113
+ "name": "typedValue",
1114
+ "privacy": "public",
1115
+ "type": {
1116
+ "text": "string"
1117
+ },
1118
+ "description": "Specifies the value of the input element within the combobox.",
1119
+ "attribute": "typedValue",
1120
+ "reflects": true
1142
1121
  },
1143
1122
  {
1144
- "description": "Defines the content of the label.",
1145
- "name": "label"
1146
- },
1147
- {
1148
- "description": "Defines the content of the helpText.",
1149
- "name": "helpText"
1150
- },
1151
- {
1152
- "description": "Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.",
1153
- "name": "displayValue"
1154
- }
1155
- ],
1156
- "members": [
1157
- {
1158
- "kind": "method",
1159
- "name": "_initializeDefaults",
1160
- "privacy": "private",
1161
- "return": {
1162
- "type": {
1163
- "text": "void"
1164
- }
1165
- }
1123
+ "kind": "field",
1124
+ "name": "validity",
1125
+ "privacy": "public",
1126
+ "type": {
1127
+ "text": "string"
1128
+ },
1129
+ "description": "Specifies the `validityState` this element is in.",
1130
+ "attribute": "validity",
1131
+ "reflects": true
1166
1132
  },
1167
1133
  {
1168
1134
  "kind": "field",
1169
- "name": "inputValue",
1170
- "description": "Returns the current value of the input element within the combobox.",
1171
- "return": {
1172
- "type": {
1173
- "text": "string|undefined"
1174
- }
1135
+ "name": "value",
1136
+ "privacy": "public",
1137
+ "type": {
1138
+ "text": "string"
1175
1139
  },
1176
- "readonly": true
1140
+ "description": "Value selected for the dropdown menu.",
1141
+ "attribute": "value"
1177
1142
  },
1178
1143
  {
1179
- "kind": "method",
1180
- "name": "isValid",
1181
- "description": "Checks if the element is valid.",
1182
- "return": {
1183
- "type": {
1184
- "text": "boolean"
1185
- }
1186
- }
1144
+ "kind": "field",
1145
+ "name": "largeFullscreenHeadline",
1146
+ "privacy": "public",
1147
+ "type": {
1148
+ "text": "boolean"
1149
+ },
1150
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1151
+ "attribute": "largeFullscreenHeadline",
1152
+ "reflects": true
1187
1153
  },
1188
1154
  {
1189
- "kind": "method",
1190
- "name": "register",
1191
- "static": true,
1192
- "parameters": [
1193
- {
1194
- "name": "name",
1195
- "default": "'auro-combobox'",
1196
- "description": "The name of the element that you want to register.",
1197
- "optional": true,
1198
- "type": {
1199
- "text": "string"
1200
- }
1201
- }
1202
- ],
1203
- "description": "This will register this element with the browser."
1155
+ "kind": "field",
1156
+ "name": "fullscreenBreakpoint",
1157
+ "privacy": "public",
1158
+ "type": {
1159
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1160
+ },
1161
+ "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.",
1162
+ "default": "'sm'",
1163
+ "attribute": "fullscreenBreakpoint",
1164
+ "reflects": true
1204
1165
  },
1205
1166
  {
1206
- "kind": "method",
1207
- "name": "activateFirstEnabledAvailableOption",
1208
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
1167
+ "kind": "field",
1168
+ "name": "optionActive",
1209
1169
  "privacy": "private",
1210
- "return": {
1211
- "type": {
1212
- "text": "void"
1213
- }
1214
- }
1170
+ "type": {
1171
+ "text": "object"
1172
+ },
1173
+ "description": "Specifies the currently active option."
1215
1174
  },
1216
1175
  {
1217
- "kind": "method",
1218
- "name": "activateLastEnabledAvailableOption",
1219
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
1176
+ "kind": "field",
1177
+ "name": "triggerExpandedState",
1220
1178
  "privacy": "private",
1221
- "return": {
1222
- "type": {
1223
- "text": "void"
1224
- }
1225
- }
1226
- },
1227
- {
1228
- "kind": "method",
1229
- "name": "updateFilter",
1230
- "description": "Updates the filter for the available options based on the input value.",
1231
- "privacy": "private"
1179
+ "type": {
1180
+ "text": "boolean"
1181
+ },
1182
+ "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1232
1183
  },
1233
1184
  {
1234
- "kind": "method",
1235
- "name": "syncValuesAndStates",
1236
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1185
+ "kind": "field",
1186
+ "name": "componentHasFocus",
1187
+ "description": "Returns true if the element has focus.",
1237
1188
  "privacy": "private",
1238
1189
  "return": {
1239
1190
  "type": {
1240
- "text": "void"
1191
+ "text": "boolean"
1241
1192
  }
1193
+ },
1194
+ "readonly": true,
1195
+ "inheritedFrom": {
1196
+ "name": "AuroElement",
1197
+ "module": "components/layoutElement/src/auroElement.js"
1242
1198
  }
1243
1199
  },
1244
1200
  {
1245
1201
  "kind": "method",
1246
- "name": "updateTriggerTextDisplay",
1247
- "parameters": [
1248
- {
1249
- "name": "label",
1250
- "description": "The label of the selected option.",
1251
- "type": {
1252
- "text": "string"
1253
- }
1254
- }
1255
- ],
1256
- "description": "Update displayValue or input.value, it's called when making a selection.",
1257
- "privacy": "private"
1258
- },
1259
- {
1260
- "kind": "method",
1261
- "name": "handleMenuOptions",
1262
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1263
- "privacy": "private",
1264
- "return": {
1265
- "type": {
1266
- "text": "void"
1267
- }
1202
+ "name": "resetShapeClasses",
1203
+ "inheritedFrom": {
1204
+ "name": "AuroElement",
1205
+ "module": "components/layoutElement/src/auroElement.js"
1268
1206
  }
1269
1207
  },
1270
1208
  {
1271
1209
  "kind": "method",
1272
- "name": "generateOptionsArray",
1273
- "description": "Determines the element error state based on the `required` attribute and input value.",
1274
- "privacy": "private",
1275
- "return": {
1276
- "type": {
1277
- "text": "void"
1278
- }
1210
+ "name": "resetLayoutClasses",
1211
+ "inheritedFrom": {
1212
+ "name": "AuroElement",
1213
+ "module": "components/layoutElement/src/auroElement.js"
1279
1214
  }
1280
1215
  },
1281
1216
  {
1282
1217
  "kind": "method",
1283
- "name": "hideBib",
1284
- "description": "Hides the dropdown bib if its open.",
1285
- "return": {
1286
- "type": {
1287
- "text": "void"
1288
- }
1218
+ "name": "updateComponentArchitecture",
1219
+ "inheritedFrom": {
1220
+ "name": "AuroElement",
1221
+ "module": "components/layoutElement/src/auroElement.js"
1289
1222
  }
1290
1223
  },
1291
1224
  {
1292
- "kind": "method",
1293
- "name": "showBib",
1294
- "description": "Shows the dropdown bib if there are options to show.",
1295
- "return": {
1296
- "type": {
1297
- "text": "void"
1298
- }
1225
+ "kind": "field",
1226
+ "name": "shape",
1227
+ "privacy": "public",
1228
+ "type": {
1229
+ "text": "string"
1230
+ },
1231
+ "attribute": "shape",
1232
+ "reflects": true,
1233
+ "inheritedFrom": {
1234
+ "name": "AuroElement",
1235
+ "module": "components/layoutElement/src/auroElement.js"
1299
1236
  }
1300
1237
  },
1301
1238
  {
1302
- "kind": "method",
1303
- "name": "configureDropdown",
1304
- "description": "Binds all behavior needed to the dropdown after rendering.",
1305
- "privacy": "private",
1306
- "return": {
1307
- "type": {
1308
- "text": "void"
1309
- }
1239
+ "kind": "field",
1240
+ "name": "size",
1241
+ "privacy": "public",
1242
+ "type": {
1243
+ "text": "string"
1244
+ },
1245
+ "attribute": "size",
1246
+ "reflects": true,
1247
+ "inheritedFrom": {
1248
+ "name": "AuroElement",
1249
+ "module": "components/layoutElement/src/auroElement.js"
1310
1250
  }
1311
- },
1251
+ }
1252
+ ],
1253
+ "events": [
1312
1254
  {
1313
- "kind": "method",
1314
- "name": "setClearBtnFocus",
1315
- "privacy": "private"
1255
+ "name": "inputValue",
1256
+ "type": {
1257
+ "text": "CustomEvent"
1258
+ },
1259
+ "description": "Notifies that the components internal HTML5 input value has changed."
1316
1260
  },
1317
1261
  {
1318
- "kind": "method",
1319
- "name": "setTriggerInputFocus",
1320
- "privacy": "private"
1262
+ "name": "input",
1263
+ "type": {
1264
+ "text": "CustomEvent"
1265
+ },
1266
+ "description": "Notifies that the component has a new value set."
1321
1267
  },
1322
1268
  {
1323
- "kind": "method",
1324
- "name": "setInputFocus",
1325
- "privacy": "private"
1269
+ "name": "auroCombobox-valueSet",
1270
+ "type": {
1271
+ "text": "CustomEvent"
1272
+ },
1273
+ "description": "(Deprecated) Notifies that the component has a new value set."
1326
1274
  },
1327
1275
  {
1328
- "kind": "method",
1329
- "name": "updateBibDialogRole",
1330
- "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.",
1331
- "privacy": "private"
1332
- },
1276
+ "description": "Notifies that the component value(s) have been validated.",
1277
+ "name": "auroFormElement-validated"
1278
+ }
1279
+ ],
1280
+ "attributes": [
1333
1281
  {
1334
- "kind": "method",
1335
- "name": "updateMenuShapeSize",
1336
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1337
- "privacy": "private"
1282
+ "name": "appearance",
1283
+ "type": {
1284
+ "text": "string"
1285
+ },
1286
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1287
+ "default": "'default'",
1288
+ "fieldName": "appearance"
1338
1289
  },
1339
1290
  {
1340
- "kind": "method",
1341
- "name": "_getAnnouncementRoot",
1342
- "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.",
1343
- "privacy": "private",
1344
- "return": {
1345
- "type": {
1346
- "text": "ShadowRoot"
1347
- }
1348
- }
1291
+ "name": "autocomplete",
1292
+ "type": {
1293
+ "text": "string"
1294
+ },
1295
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1296
+ "fieldName": "autocomplete"
1349
1297
  },
1350
1298
  {
1351
- "kind": "method",
1352
- "name": "configureMenu",
1353
- "description": "Binds all behavior needed to the menu after rendering.",
1354
- "privacy": "private",
1355
- "return": {
1356
- "type": {
1357
- "text": "void"
1358
- }
1359
- }
1299
+ "name": "autoPlacement",
1300
+ "type": {
1301
+ "text": "boolean"
1302
+ },
1303
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1304
+ "fieldName": "autoPlacement"
1360
1305
  },
1361
1306
  {
1362
- "kind": "method",
1363
- "name": "configureInput",
1364
- "description": "Binds all behavior needed to the input after rendering.",
1365
- "privacy": "private",
1366
- "return": {
1367
- "type": {
1368
- "text": "void"
1369
- }
1370
- }
1307
+ "name": "availableOptions",
1308
+ "type": {
1309
+ "text": "array"
1310
+ },
1311
+ "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).",
1312
+ "fieldName": "availableOptions"
1371
1313
  },
1372
1314
  {
1373
- "kind": "method",
1374
- "name": "handleMenuLoadingChange",
1375
- "parameters": [
1376
- {
1377
- "name": "event",
1378
- "description": "The event object containing details about the loading state change.",
1379
- "type": {
1380
- "text": "CustomEvent"
1381
- }
1382
- },
1383
- {
1384
- "description": "Indicates whether the menu is currently loading.",
1385
- "name": "event.detail.loading",
1386
- "type": {
1387
- "text": "boolean"
1388
- }
1389
- },
1390
- {
1391
- "description": "Indicates if there are loading placeholders present.",
1392
- "name": "event.detail.hasLoadingPlaceholder",
1393
- "type": {
1394
- "text": "boolean"
1395
- }
1396
- }
1397
- ],
1398
- "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.",
1399
- "privacy": "private",
1400
- "return": {
1401
- "type": {
1402
- "text": "void"
1403
- }
1404
- }
1315
+ "name": "behavior",
1316
+ "type": {
1317
+ "text": "'filter' | 'suggestion'"
1318
+ },
1319
+ "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.",
1320
+ "default": "'suggestion'",
1321
+ "fieldName": "behavior"
1405
1322
  },
1406
1323
  {
1407
- "kind": "method",
1408
- "name": "handleInputValueChange",
1409
- "parameters": [
1410
- {
1411
- "name": "event",
1412
- "description": "The input event triggered by the input element.",
1413
- "type": {
1414
- "text": "Event"
1415
- }
1416
- }
1417
- ],
1418
- "description": "Handle changes to the input value and trigger changes that should result.",
1419
- "privacy": "private",
1420
- "return": {
1421
- "type": {
1422
- "text": "void"
1423
- }
1424
- }
1324
+ "name": "checkmark",
1325
+ "type": {
1326
+ "text": "boolean"
1327
+ },
1328
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1329
+ "fieldName": "checkmark"
1425
1330
  },
1426
1331
  {
1427
- "kind": "method",
1428
- "name": "configureCombobox",
1429
- "description": "Binds all behavior needed to the combobox after rendering.",
1430
- "privacy": "private",
1431
- "return": {
1432
- "type": {
1433
- "text": "void"
1434
- }
1435
- }
1332
+ "name": "disabled",
1333
+ "type": {
1334
+ "text": "boolean"
1335
+ },
1336
+ "description": "If set, disables the combobox.",
1337
+ "fieldName": "disabled"
1436
1338
  },
1437
1339
  {
1438
- "kind": "method",
1439
- "name": "focus",
1440
- "description": "Focuses the combobox trigger input.",
1441
- "return": {
1442
- "type": {
1443
- "text": "void"
1444
- }
1445
- }
1340
+ "name": "dvInputOnly",
1341
+ "type": {
1342
+ "text": "boolean"
1343
+ },
1344
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1345
+ "fieldName": "dvInputOnly"
1446
1346
  },
1447
1347
  {
1448
- "kind": "method",
1449
- "name": "setMenuValue",
1450
- "parameters": [
1451
- {
1452
- "name": "value",
1453
- "description": "The value to set on the menu.",
1454
- "type": {
1455
- "text": "string"
1456
- }
1457
- }
1458
- ],
1459
- "description": "Sets the menu value if menu is available.",
1460
- "return": {
1461
- "type": {
1462
- "text": "void"
1463
- }
1464
- }
1348
+ "name": "error",
1349
+ "type": {
1350
+ "text": "string"
1351
+ },
1352
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1353
+ "fieldName": "error"
1465
1354
  },
1466
1355
  {
1467
- "kind": "method",
1468
- "name": "reset",
1469
- "description": "Resets component to initial state.",
1470
- "return": {
1471
- "type": {
1472
- "text": "void"
1473
- }
1474
- }
1356
+ "name": "format",
1357
+ "type": {
1358
+ "text": "string"
1359
+ },
1360
+ "description": "Specifies the input mask format.",
1361
+ "fieldName": "format"
1475
1362
  },
1476
1363
  {
1477
- "kind": "method",
1478
- "name": "clear",
1479
- "description": "Clears the current value of the combobox.",
1480
- "return": {
1481
- "type": {
1482
- "text": "void"
1483
- }
1364
+ "name": "inputmode",
1365
+ "type": {
1366
+ "text": "string"
1367
+ },
1368
+ "description": "Exposes inputmode attribute for input.",
1369
+ "fieldName": "inputmode"
1370
+ },
1371
+ {
1372
+ "name": "layout",
1373
+ "type": {
1374
+ "text": "string"
1375
+ },
1376
+ "description": "Sets the layout of the combobox.",
1377
+ "default": "'classic'",
1378
+ "fieldName": "layout",
1379
+ "inheritedFrom": {
1380
+ "name": "AuroElement",
1381
+ "module": "components/layoutElement/src/auroElement.js"
1484
1382
  }
1485
1383
  },
1486
1384
  {
1487
- "kind": "method",
1488
- "name": "validate",
1489
- "parameters": [
1490
- {
1491
- "name": "force",
1492
- "default": "false",
1493
- "description": "Whether to force validation.",
1494
- "optional": true,
1495
- "type": {
1496
- "text": "boolean"
1497
- }
1498
- }
1499
- ],
1500
- "description": "Validates value."
1385
+ "name": "matchWidth",
1386
+ "type": {
1387
+ "text": "boolean"
1388
+ },
1389
+ "description": "If declared, the popover and trigger will be set to the same width.",
1390
+ "fieldName": "matchWidth"
1501
1391
  },
1502
1392
  {
1503
- "kind": "method",
1504
- "name": "transportAssignedNodes",
1505
- "parameters": [
1506
- {
1507
- "name": "slot",
1508
- "description": "The slot element containing the nodes to apply.",
1509
- "type": {
1510
- "text": "HTMLSlotElement"
1511
- }
1512
- },
1513
- {
1514
- "name": "target",
1515
- "description": "The target element to apply the nodes to.",
1516
- "type": {
1517
- "text": "HTMLElement"
1518
- }
1519
- },
1520
- {
1521
- "name": "newSlotName",
1522
- "description": "The new slot name for the applied nodes.",
1523
- "type": {
1524
- "text": "string"
1525
- }
1526
- }
1527
- ],
1528
- "description": "Applies slotted nodes to a target element with a new slot name.",
1529
- "privacy": "private",
1530
- "return": {
1531
- "type": {
1532
- "text": "void"
1533
- }
1534
- }
1393
+ "name": "noFilter",
1394
+ "type": {
1395
+ "text": "boolean"
1396
+ },
1397
+ "description": "If set, combobox will not filter menuoptions based on input.",
1398
+ "fieldName": "noFilter"
1535
1399
  },
1536
1400
  {
1537
- "kind": "method",
1538
- "name": "updateActiveOption",
1539
- "parameters": [
1540
- {
1541
- "name": "index",
1542
- "description": "Index of the option to make active.",
1543
- "type": {
1544
- "text": "number"
1545
- }
1546
- }
1547
- ],
1548
- "description": "Updates the active option in the menu."
1401
+ "name": "noFlip",
1402
+ "type": {
1403
+ "text": "boolean"
1404
+ },
1405
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1406
+ "fieldName": "noFlip"
1407
+ },
1408
+ {
1409
+ "name": "shift",
1410
+ "type": {
1411
+ "text": "boolean"
1412
+ },
1413
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1414
+ "fieldName": "shift"
1415
+ },
1416
+ {
1417
+ "name": "noValidate",
1418
+ "type": {
1419
+ "text": "boolean"
1420
+ },
1421
+ "description": "If set, disables auto-validation on blur.",
1422
+ "fieldName": "noValidate"
1423
+ },
1424
+ {
1425
+ "name": "offset",
1426
+ "type": {
1427
+ "text": "number"
1428
+ },
1429
+ "description": "Gap between the trigger element and bib.",
1430
+ "default": "0",
1431
+ "fieldName": "offset"
1432
+ },
1433
+ {
1434
+ "name": "onDark",
1435
+ "type": {
1436
+ "text": "boolean"
1437
+ },
1438
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1439
+ "fieldName": "onDark"
1440
+ },
1441
+ {
1442
+ "name": "optionSelected",
1443
+ "type": {
1444
+ "text": "HTMLElement"
1445
+ },
1446
+ "description": "Specifies the current selected option.",
1447
+ "fieldName": "optionSelected"
1448
+ },
1449
+ {
1450
+ "name": "persistInput",
1451
+ "type": {
1452
+ "text": "boolean"
1453
+ },
1454
+ "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.",
1455
+ "fieldName": "persistInput"
1456
+ },
1457
+ {
1458
+ "name": "placement",
1459
+ "type": {
1460
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1461
+ },
1462
+ "description": "Position where the bib should appear relative to the trigger.",
1463
+ "default": "'bottom-start'",
1464
+ "fieldName": "placement"
1465
+ },
1466
+ {
1467
+ "name": "placeholder",
1468
+ "type": {
1469
+ "text": "string"
1470
+ },
1471
+ "description": "Define custom placeholder text, only supported by date input formats.",
1472
+ "fieldName": "placeholder"
1473
+ },
1474
+ {
1475
+ "name": "required",
1476
+ "type": {
1477
+ "text": "boolean"
1478
+ },
1479
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1480
+ "fieldName": "required"
1481
+ },
1482
+ {
1483
+ "name": "setCustomValidity",
1484
+ "type": {
1485
+ "text": "string"
1486
+ },
1487
+ "description": "Sets a custom help text message to display for all validityStates.",
1488
+ "fieldName": "setCustomValidity"
1489
+ },
1490
+ {
1491
+ "name": "setCustomValidityCustomError",
1492
+ "type": {
1493
+ "text": "string"
1494
+ },
1495
+ "description": "Custom help text message to display when validity = `customError`.",
1496
+ "fieldName": "setCustomValidityCustomError"
1497
+ },
1498
+ {
1499
+ "name": "setCustomValidityValueMissing",
1500
+ "type": {
1501
+ "text": "string"
1502
+ },
1503
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1504
+ "fieldName": "setCustomValidityValueMissing"
1505
+ },
1506
+ {
1507
+ "name": "setCustomValidityValueMissingFilter",
1508
+ "type": {
1509
+ "text": "string"
1510
+ },
1511
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1512
+ "fieldName": "setCustomValidityValueMissingFilter"
1513
+ },
1514
+ {
1515
+ "name": "triggerIcon",
1516
+ "type": {
1517
+ "text": "boolean"
1518
+ },
1519
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1520
+ "fieldName": "triggerIcon"
1521
+ },
1522
+ {
1523
+ "name": "type",
1524
+ "type": {
1525
+ "text": "string"
1526
+ },
1527
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1528
+ "fieldName": "type"
1549
1529
  },
1550
1530
  {
1551
- "kind": "method",
1552
- "name": "handleSlotChange",
1553
- "parameters": [
1554
- {
1555
- "name": "event",
1556
- "description": "`slotchange` event.",
1557
- "type": {
1558
- "text": "Event"
1559
- }
1560
- }
1561
- ],
1562
- "description": "Watch for slot changes and recalculate the menuoptions.",
1563
- "privacy": "private",
1564
- "return": {
1565
- "type": {
1566
- "text": "void"
1567
- }
1568
- }
1531
+ "name": "typedValue",
1532
+ "type": {
1533
+ "text": "string"
1534
+ },
1535
+ "description": "Specifies the value of the input element within the combobox.",
1536
+ "fieldName": "typedValue"
1569
1537
  },
1570
1538
  {
1571
- "kind": "field",
1572
- "name": "appearance",
1573
- "privacy": "public",
1539
+ "name": "validity",
1574
1540
  "type": {
1575
1541
  "text": "string"
1576
1542
  },
1577
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1578
- "default": "'default'",
1579
- "attribute": "appearance",
1580
- "reflects": true
1543
+ "description": "Specifies the `validityState` this element is in.",
1544
+ "fieldName": "validity"
1581
1545
  },
1582
1546
  {
1583
- "kind": "field",
1584
- "name": "autocomplete",
1585
- "privacy": "public",
1547
+ "name": "value",
1586
1548
  "type": {
1587
1549
  "text": "string"
1588
1550
  },
1589
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1590
- "attribute": "autocomplete",
1591
- "reflects": true
1551
+ "description": "Value selected for the dropdown menu.",
1552
+ "fieldName": "value"
1592
1553
  },
1593
1554
  {
1594
- "kind": "field",
1595
- "name": "autoPlacement",
1596
- "privacy": "public",
1555
+ "name": "largeFullscreenHeadline",
1597
1556
  "type": {
1598
1557
  "text": "boolean"
1599
1558
  },
1600
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1601
- "attribute": "autoPlacement",
1602
- "reflects": true
1559
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1560
+ "fieldName": "largeFullscreenHeadline"
1603
1561
  },
1604
1562
  {
1605
- "kind": "field",
1606
- "name": "availableOptions",
1607
- "privacy": "private",
1563
+ "name": "fullscreenBreakpoint",
1608
1564
  "type": {
1609
- "text": "array"
1565
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1610
1566
  },
1611
- "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).",
1612
- "attribute": "availableOptions"
1567
+ "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.",
1568
+ "default": "'sm'",
1569
+ "fieldName": "fullscreenBreakpoint"
1613
1570
  },
1614
1571
  {
1615
- "kind": "field",
1616
- "name": "behavior",
1617
- "privacy": "public",
1572
+ "name": "shape",
1618
1573
  "type": {
1619
- "text": "'filter' | 'suggestion'"
1574
+ "text": "string"
1620
1575
  },
1621
- "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.",
1622
- "default": "'suggestion'",
1623
- "attribute": "behavior",
1624
- "reflects": true
1576
+ "fieldName": "shape",
1577
+ "inheritedFrom": {
1578
+ "name": "AuroElement",
1579
+ "module": "components/layoutElement/src/auroElement.js"
1580
+ }
1625
1581
  },
1626
1582
  {
1627
- "kind": "field",
1628
- "name": "checkmark",
1629
- "privacy": "public",
1583
+ "name": "size",
1630
1584
  "type": {
1631
- "text": "boolean"
1585
+ "text": "string"
1632
1586
  },
1633
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1634
- "attribute": "checkmark",
1635
- "reflects": true
1587
+ "fieldName": "size",
1588
+ "inheritedFrom": {
1589
+ "name": "AuroElement",
1590
+ "module": "components/layoutElement/src/auroElement.js"
1591
+ }
1636
1592
  },
1637
1593
  {
1638
- "kind": "field",
1639
- "name": "disabled",
1640
- "privacy": "public",
1594
+ "name": "ondark",
1641
1595
  "type": {
1642
1596
  "text": "boolean"
1643
1597
  },
1644
- "description": "If set, disables the combobox.",
1645
- "attribute": "disabled",
1646
- "reflects": true
1598
+ "fieldName": "onDark",
1599
+ "inheritedFrom": {
1600
+ "name": "AuroElement",
1601
+ "module": "components/layoutElement/src/auroElement.js"
1602
+ }
1603
+ }
1604
+ ],
1605
+ "superclass": {
1606
+ "name": "AuroElement",
1607
+ "module": "/components/layoutElement/src/auroElement.js"
1608
+ },
1609
+ "tagName": "auro-combobox",
1610
+ "customElement": true
1611
+ }
1612
+ ],
1613
+ "exports": [
1614
+ {
1615
+ "kind": "js",
1616
+ "name": "AuroCombobox",
1617
+ "declaration": {
1618
+ "name": "AuroCombobox",
1619
+ "module": "components/combobox/src/auro-combobox.js"
1620
+ }
1621
+ }
1622
+ ]
1623
+ },
1624
+ {
1625
+ "kind": "javascript-module",
1626
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1627
+ "declarations": [
1628
+ {
1629
+ "kind": "variable",
1630
+ "name": "comboboxKeyboardStrategy",
1631
+ "type": {
1632
+ "text": "object"
1633
+ },
1634
+ "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) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { 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) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); 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)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
1635
+ }
1636
+ ],
1637
+ "exports": [
1638
+ {
1639
+ "kind": "js",
1640
+ "name": "comboboxKeyboardStrategy",
1641
+ "declaration": {
1642
+ "name": "comboboxKeyboardStrategy",
1643
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1644
+ }
1645
+ }
1646
+ ]
1647
+ },
1648
+ {
1649
+ "kind": "javascript-module",
1650
+ "path": "components/combobox/src/index.js",
1651
+ "declarations": [],
1652
+ "exports": [
1653
+ {
1654
+ "kind": "js",
1655
+ "name": "AuroCombobox",
1656
+ "declaration": {
1657
+ "name": "AuroCombobox",
1658
+ "module": "components/combobox/src/index.js"
1659
+ }
1660
+ }
1661
+ ]
1662
+ },
1663
+ {
1664
+ "kind": "javascript-module",
1665
+ "path": "components/combobox/src/registered.js",
1666
+ "declarations": [],
1667
+ "exports": [
1668
+ {
1669
+ "kind": "js",
1670
+ "name": "AuroCombobox",
1671
+ "declaration": {
1672
+ "name": "AuroCombobox",
1673
+ "module": "components/combobox/src/registered.js"
1674
+ }
1675
+ }
1676
+ ]
1677
+ },
1678
+ {
1679
+ "kind": "javascript-module",
1680
+ "path": "components/checkbox/src/auro-checkbox-group.js",
1681
+ "declarations": [
1682
+ {
1683
+ "kind": "class",
1684
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1685
+ "name": "AuroCheckboxGroup",
1686
+ "slots": [
1687
+ {
1688
+ "description": "Allows for the legend to be overridden.",
1689
+ "name": "legend"
1647
1690
  },
1648
1691
  {
1649
- "kind": "field",
1650
- "name": "dropdownId",
1692
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1693
+ "name": "optionalLabel"
1694
+ },
1695
+ {
1696
+ "description": "Allows for the helper text to be overridden.",
1697
+ "name": "helpText"
1698
+ },
1699
+ {
1700
+ "description": "The default slot for the checkbox items.",
1701
+ "name": "default"
1702
+ }
1703
+ ],
1704
+ "members": [
1705
+ {
1706
+ "kind": "method",
1707
+ "name": "_initializeDefaults"
1708
+ },
1709
+ {
1710
+ "kind": "method",
1711
+ "name": "register",
1712
+ "static": true,
1713
+ "parameters": [
1714
+ {
1715
+ "name": "name",
1716
+ "default": "\"auro-checkbox-group\"",
1717
+ "description": "The name of the element that you want to register.",
1718
+ "optional": true,
1719
+ "type": {
1720
+ "text": "string"
1721
+ }
1722
+ }
1723
+ ],
1724
+ "description": "This will register this element with the browser."
1725
+ },
1726
+ {
1727
+ "kind": "method",
1728
+ "name": "handleValueUpdate",
1729
+ "parameters": [
1730
+ {
1731
+ "name": "value",
1732
+ "description": "The value of the checkbox.",
1733
+ "type": {
1734
+ "text": "String"
1735
+ }
1736
+ },
1737
+ {
1738
+ "name": "selected",
1739
+ "description": "The checked state of the checkbox.",
1740
+ "type": {
1741
+ "text": "Boolean"
1742
+ }
1743
+ }
1744
+ ],
1745
+ "description": "Helper method to handle checkbox value changing.",
1651
1746
  "privacy": "private",
1652
- "type": {
1653
- "text": "string"
1654
- },
1655
- "description": "ID for the dropdown."
1747
+ "return": {
1748
+ "type": {
1749
+ "text": "void"
1750
+ }
1751
+ }
1656
1752
  },
1657
1753
  {
1658
- "kind": "field",
1659
- "name": "dropdownOpen",
1754
+ "kind": "method",
1755
+ "name": "handlePreselectedItems",
1756
+ "description": "Helper method that handles the state of preselected checkboxes.",
1660
1757
  "privacy": "private",
1661
- "type": {
1662
- "text": "boolean"
1663
- },
1664
- "description": "Whether or not the dropdown is open."
1665
- },
1666
- {
1667
- "kind": "field",
1668
- "name": "dvInputOnly",
1669
- "privacy": "public",
1670
- "type": {
1671
- "text": "boolean"
1672
- },
1673
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1674
- "attribute": "dvInputOnly",
1675
- "reflects": true
1758
+ "return": {
1759
+ "type": {
1760
+ "text": "void"
1761
+ }
1762
+ }
1676
1763
  },
1677
1764
  {
1678
- "kind": "field",
1679
- "name": "error",
1680
- "privacy": "public",
1681
- "type": {
1682
- "text": "string"
1683
- },
1684
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1685
- "attribute": "error",
1686
- "reflects": true
1765
+ "kind": "method",
1766
+ "name": "handleItems",
1767
+ "description": "Helper method that handles the state of checkboxes.",
1768
+ "privacy": "private",
1769
+ "return": {
1770
+ "type": {
1771
+ "text": "void"
1772
+ }
1773
+ }
1687
1774
  },
1688
1775
  {
1689
- "kind": "field",
1690
- "name": "format",
1691
- "privacy": "public",
1692
- "type": {
1693
- "text": "string"
1694
- },
1695
- "description": "Specifies the input mask format.",
1696
- "attribute": "format",
1697
- "reflects": true
1776
+ "kind": "method",
1777
+ "name": "reset",
1778
+ "description": "Resets component to initial state.",
1779
+ "return": {
1780
+ "type": {
1781
+ "text": "void"
1782
+ }
1783
+ }
1698
1784
  },
1699
1785
  {
1700
- "kind": "field",
1701
- "name": "inputmode",
1702
- "privacy": "public",
1703
- "type": {
1704
- "text": "string"
1705
- },
1706
- "description": "Exposes inputmode attribute for input.",
1707
- "attribute": "inputmode",
1708
- "reflects": true
1786
+ "kind": "method",
1787
+ "name": "validate",
1788
+ "parameters": [
1789
+ {
1790
+ "name": "force",
1791
+ "default": "false",
1792
+ "description": "Whether to force validation.",
1793
+ "optional": true,
1794
+ "type": {
1795
+ "text": "boolean"
1796
+ }
1797
+ }
1798
+ ],
1799
+ "description": "Validates value."
1709
1800
  },
1710
1801
  {
1711
1802
  "kind": "field",
1712
- "name": "layout",
1803
+ "name": "appearance",
1713
1804
  "privacy": "public",
1714
1805
  "type": {
1715
- "text": "string"
1716
- },
1717
- "description": "Sets the layout of the combobox.",
1718
- "default": "'classic'",
1719
- "attribute": "layout",
1720
- "reflects": true,
1721
- "inheritedFrom": {
1722
- "name": "AuroElement",
1723
- "module": "components/layoutElement/src/auroElement.js"
1724
- }
1725
- },
1726
- {
1727
- "kind": "field",
1728
- "name": "matchWidth",
1729
- "privacy": "private",
1730
- "type": {
1731
- "text": "boolean"
1806
+ "text": "'default' | 'inverse'"
1732
1807
  },
1733
- "description": "If declared, the popover and trigger will be set to the same width.",
1734
- "attribute": "matchWidth",
1808
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1809
+ "default": "'default'",
1810
+ "attribute": "appearance",
1735
1811
  "reflects": true
1736
1812
  },
1737
1813
  {
1738
1814
  "kind": "field",
1739
- "name": "noFilter",
1815
+ "name": "disabled",
1740
1816
  "privacy": "public",
1741
1817
  "type": {
1742
1818
  "text": "boolean"
1743
1819
  },
1744
- "description": "If set, combobox will not filter menuoptions based on input.",
1745
- "attribute": "noFilter",
1820
+ "description": "If set, disables the checkbox group.",
1821
+ "attribute": "disabled",
1746
1822
  "reflects": true
1747
1823
  },
1748
1824
  {
1749
1825
  "kind": "field",
1750
- "name": "noFlip",
1826
+ "name": "error",
1751
1827
  "privacy": "public",
1752
1828
  "type": {
1753
- "text": "boolean"
1829
+ "text": "string"
1754
1830
  },
1755
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1756
- "attribute": "noFlip",
1831
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1832
+ "attribute": "error",
1757
1833
  "reflects": true
1758
1834
  },
1759
1835
  {
1760
1836
  "kind": "field",
1761
- "name": "shift",
1837
+ "name": "horizontal",
1762
1838
  "privacy": "public",
1763
1839
  "type": {
1764
1840
  "text": "boolean"
1765
1841
  },
1766
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1767
- "attribute": "shift",
1842
+ "description": "If set, checkboxes will be aligned horizontally.",
1843
+ "attribute": "horizontal",
1768
1844
  "reflects": true
1769
1845
  },
1770
1846
  {
@@ -1778,18 +1854,6 @@
1778
1854
  "attribute": "noValidate",
1779
1855
  "reflects": true
1780
1856
  },
1781
- {
1782
- "kind": "field",
1783
- "name": "offset",
1784
- "privacy": "public",
1785
- "type": {
1786
- "text": "number"
1787
- },
1788
- "description": "Gap between the trigger element and bib.",
1789
- "default": "0",
1790
- "attribute": "offset",
1791
- "reflects": true
1792
- },
1793
1857
  {
1794
1858
  "kind": "field",
1795
1859
  "name": "onDark",
@@ -1797,56 +1861,8 @@
1797
1861
  "type": {
1798
1862
  "text": "boolean"
1799
1863
  },
1800
- "attribute": "onDark",
1801
- "reflects": true,
1802
1864
  "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1803
- "inheritedFrom": {
1804
- "name": "AuroElement",
1805
- "module": "components/layoutElement/src/auroElement.js"
1806
- }
1807
- },
1808
- {
1809
- "kind": "field",
1810
- "name": "optionSelected",
1811
- "privacy": "public",
1812
- "type": {
1813
- "text": "HTMLElement"
1814
- },
1815
- "description": "Specifies the current selected option.",
1816
- "attribute": "optionSelected"
1817
- },
1818
- {
1819
- "kind": "field",
1820
- "name": "persistInput",
1821
- "privacy": "public",
1822
- "type": {
1823
- "text": "boolean"
1824
- },
1825
- "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.",
1826
- "attribute": "persistInput",
1827
- "reflects": true
1828
- },
1829
- {
1830
- "kind": "field",
1831
- "name": "placement",
1832
- "privacy": "public",
1833
- "type": {
1834
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1835
- },
1836
- "description": "Position where the bib should appear relative to the trigger.",
1837
- "default": "'bottom-start'",
1838
- "attribute": "placement",
1839
- "reflects": true
1840
- },
1841
- {
1842
- "kind": "field",
1843
- "name": "placeholder",
1844
- "privacy": "public",
1845
- "type": {
1846
- "text": "string"
1847
- },
1848
- "description": "Define custom placeholder text, only supported by date input formats.",
1849
- "attribute": "placeholder",
1865
+ "attribute": "onDark",
1850
1866
  "reflects": true
1851
1867
  },
1852
1868
  {
@@ -1856,7 +1872,7 @@
1856
1872
  "type": {
1857
1873
  "text": "boolean"
1858
1874
  },
1859
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1875
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1860
1876
  "attribute": "required",
1861
1877
  "reflects": true
1862
1878
  },
@@ -1892,611 +1908,615 @@
1892
1908
  },
1893
1909
  {
1894
1910
  "kind": "field",
1895
- "name": "setCustomValidityValueMissingFilter",
1911
+ "name": "validity",
1896
1912
  "privacy": "public",
1897
1913
  "type": {
1898
1914
  "text": "string"
1899
1915
  },
1900
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1901
- "attribute": "setCustomValidityValueMissingFilter"
1902
- },
1903
- {
1904
- "kind": "field",
1905
- "name": "touched",
1906
- "privacy": "private",
1907
- "type": {
1908
- "text": "boolean"
1909
- },
1910
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1911
- },
1912
- {
1913
- "kind": "field",
1914
- "name": "triggerIcon",
1915
- "privacy": "public",
1916
- "type": {
1917
- "text": "boolean"
1918
- },
1919
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1920
- "attribute": "triggerIcon",
1916
+ "description": "Specifies the `validityState` this element is in.",
1917
+ "attribute": "validity",
1921
1918
  "reflects": true
1922
- },
1919
+ }
1920
+ ],
1921
+ "events": [
1923
1922
  {
1924
- "kind": "field",
1925
- "name": "type",
1926
- "privacy": "public",
1923
+ "name": "input",
1927
1924
  "type": {
1928
- "text": "string"
1929
- },
1930
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1931
- "attribute": "type",
1932
- "reflects": true
1925
+ "text": "CustomEvent"
1926
+ }
1933
1927
  },
1934
1928
  {
1935
- "kind": "field",
1936
- "name": "typedValue",
1937
- "privacy": "public",
1929
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1930
+ "name": "auroFormElement-validated"
1931
+ }
1932
+ ],
1933
+ "attributes": [
1934
+ {
1935
+ "name": "appearance",
1938
1936
  "type": {
1939
- "text": "string"
1937
+ "text": "'default' | 'inverse'"
1940
1938
  },
1941
- "description": "Specifies the value of the input element within the combobox.",
1942
- "attribute": "typedValue",
1943
- "reflects": true
1944
- },
1945
- {
1946
- "kind": "field",
1947
- "name": "validity",
1948
- "privacy": "public",
1939
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1940
+ "default": "'default'",
1941
+ "fieldName": "appearance"
1942
+ },
1943
+ {
1944
+ "name": "disabled",
1949
1945
  "type": {
1950
- "text": "string"
1946
+ "text": "boolean"
1951
1947
  },
1952
- "description": "Specifies the `validityState` this element is in.",
1953
- "attribute": "validity",
1954
- "reflects": true
1948
+ "description": "If set, disables the checkbox group.",
1949
+ "fieldName": "disabled"
1955
1950
  },
1956
1951
  {
1957
- "kind": "field",
1958
- "name": "value",
1959
- "privacy": "public",
1952
+ "name": "error",
1960
1953
  "type": {
1961
1954
  "text": "string"
1962
1955
  },
1963
- "description": "Value selected for the dropdown menu.",
1964
- "attribute": "value"
1956
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1957
+ "fieldName": "error"
1965
1958
  },
1966
1959
  {
1967
- "kind": "field",
1968
- "name": "largeFullscreenHeadline",
1969
- "privacy": "public",
1960
+ "name": "horizontal",
1970
1961
  "type": {
1971
1962
  "text": "boolean"
1972
1963
  },
1973
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1974
- "attribute": "largeFullscreenHeadline",
1975
- "reflects": true
1964
+ "description": "If set, checkboxes will be aligned horizontally.",
1965
+ "fieldName": "horizontal"
1976
1966
  },
1977
1967
  {
1978
- "kind": "field",
1979
- "name": "fullscreenBreakpoint",
1980
- "privacy": "public",
1968
+ "name": "noValidate",
1981
1969
  "type": {
1982
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1970
+ "text": "boolean"
1983
1971
  },
1984
- "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.",
1985
- "default": "'sm'",
1986
- "attribute": "fullscreenBreakpoint",
1987
- "reflects": true
1972
+ "description": "If set, disables auto-validation on blur.",
1973
+ "fieldName": "noValidate"
1988
1974
  },
1989
1975
  {
1990
- "kind": "field",
1991
- "name": "optionActive",
1992
- "privacy": "private",
1976
+ "name": "onDark",
1993
1977
  "type": {
1994
- "text": "object"
1978
+ "text": "boolean"
1995
1979
  },
1996
- "description": "Specifies the currently active option."
1980
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1981
+ "fieldName": "onDark"
1997
1982
  },
1998
1983
  {
1999
- "kind": "field",
2000
- "name": "triggerExpandedState",
2001
- "privacy": "private",
1984
+ "name": "required",
2002
1985
  "type": {
2003
1986
  "text": "boolean"
2004
1987
  },
2005
- "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1988
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1989
+ "fieldName": "required"
2006
1990
  },
2007
1991
  {
2008
- "kind": "field",
2009
- "name": "componentHasFocus",
2010
- "description": "Returns true if the element has focus.",
2011
- "privacy": "private",
2012
- "return": {
2013
- "type": {
2014
- "text": "boolean"
2015
- }
1992
+ "name": "setCustomValidity",
1993
+ "type": {
1994
+ "text": "string"
2016
1995
  },
2017
- "readonly": true,
2018
- "inheritedFrom": {
2019
- "name": "AuroElement",
2020
- "module": "components/layoutElement/src/auroElement.js"
2021
- }
2022
- },
2023
- {
2024
- "kind": "method",
2025
- "name": "resetShapeClasses",
2026
- "inheritedFrom": {
2027
- "name": "AuroElement",
2028
- "module": "components/layoutElement/src/auroElement.js"
2029
- }
2030
- },
2031
- {
2032
- "kind": "method",
2033
- "name": "resetLayoutClasses",
2034
- "inheritedFrom": {
2035
- "name": "AuroElement",
2036
- "module": "components/layoutElement/src/auroElement.js"
2037
- }
1996
+ "description": "Sets a custom help text message to display for all validityStates.",
1997
+ "fieldName": "setCustomValidity"
2038
1998
  },
2039
1999
  {
2040
- "kind": "method",
2041
- "name": "updateComponentArchitecture",
2042
- "inheritedFrom": {
2043
- "name": "AuroElement",
2044
- "module": "components/layoutElement/src/auroElement.js"
2045
- }
2000
+ "name": "setCustomValidityCustomError",
2001
+ "type": {
2002
+ "text": "string"
2003
+ },
2004
+ "description": "Custom help text message to display when validity = `customError`.",
2005
+ "fieldName": "setCustomValidityCustomError"
2046
2006
  },
2047
2007
  {
2048
- "kind": "field",
2049
- "name": "shape",
2050
- "privacy": "public",
2008
+ "name": "setCustomValidityValueMissing",
2051
2009
  "type": {
2052
2010
  "text": "string"
2053
2011
  },
2054
- "attribute": "shape",
2055
- "reflects": true,
2056
- "inheritedFrom": {
2057
- "name": "AuroElement",
2058
- "module": "components/layoutElement/src/auroElement.js"
2059
- }
2012
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2013
+ "fieldName": "setCustomValidityValueMissing"
2060
2014
  },
2061
2015
  {
2062
- "kind": "field",
2063
- "name": "size",
2064
- "privacy": "public",
2016
+ "name": "validity",
2065
2017
  "type": {
2066
2018
  "text": "string"
2067
2019
  },
2068
- "attribute": "size",
2069
- "reflects": true,
2070
- "inheritedFrom": {
2071
- "name": "AuroElement",
2072
- "module": "components/layoutElement/src/auroElement.js"
2073
- }
2020
+ "description": "Specifies the `validityState` this element is in.",
2021
+ "fieldName": "validity"
2074
2022
  }
2075
2023
  ],
2076
- "events": [
2024
+ "superclass": {
2025
+ "name": "LitElement",
2026
+ "package": "lit"
2027
+ },
2028
+ "tagName": "auro-checkbox-group",
2029
+ "customElement": true
2030
+ }
2031
+ ],
2032
+ "exports": [
2033
+ {
2034
+ "kind": "js",
2035
+ "name": "AuroCheckboxGroup",
2036
+ "declaration": {
2037
+ "name": "AuroCheckboxGroup",
2038
+ "module": "components/checkbox/src/auro-checkbox-group.js"
2039
+ }
2040
+ }
2041
+ ]
2042
+ },
2043
+ {
2044
+ "kind": "javascript-module",
2045
+ "path": "components/checkbox/src/auro-checkbox.js",
2046
+ "declarations": [
2047
+ {
2048
+ "kind": "class",
2049
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2050
+ "name": "AuroCheckbox",
2051
+ "cssParts": [
2077
2052
  {
2078
- "name": "inputValue",
2079
- "type": {
2080
- "text": "CustomEvent"
2081
- },
2082
- "description": "Notifies that the components internal HTML5 input value has changed."
2053
+ "description": "apply css to a specific checkbox.",
2054
+ "name": "checkbox"
2083
2055
  },
2084
2056
  {
2085
- "name": "input",
2086
- "type": {
2087
- "text": "CustomEvent"
2088
- },
2089
- "description": "Notifies that the component has a new value set."
2057
+ "description": "apply css to a specific checkbox's input.",
2058
+ "name": "checkbox-input"
2090
2059
  },
2091
2060
  {
2092
- "name": "auroCombobox-valueSet",
2093
- "type": {
2094
- "text": "CustomEvent"
2095
- },
2096
- "description": "(Deprecated) Notifies that the component has a new value set."
2097
- },
2061
+ "description": "apply css to a specific checkbox's label.",
2062
+ "name": "checkbox-label"
2063
+ }
2064
+ ],
2065
+ "slots": [
2098
2066
  {
2099
- "description": "Notifies that the component value(s) have been validated.",
2100
- "name": "auroFormElement-validated"
2067
+ "description": "The default slot for the checkbox label.",
2068
+ "name": "default"
2101
2069
  }
2102
2070
  ],
2103
- "attributes": [
2071
+ "members": [
2104
2072
  {
2105
- "name": "appearance",
2106
- "type": {
2107
- "text": "string"
2108
- },
2109
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2110
- "default": "'default'",
2111
- "fieldName": "appearance"
2073
+ "kind": "method",
2074
+ "name": "_initializeDefaults"
2075
+ },
2076
+ {
2077
+ "kind": "method",
2078
+ "name": "register",
2079
+ "static": true,
2080
+ "parameters": [
2081
+ {
2082
+ "name": "name",
2083
+ "default": "\"auro-checkbox\"",
2084
+ "description": "The name of element that you want to register to.",
2085
+ "optional": true,
2086
+ "type": {
2087
+ "text": "string"
2088
+ }
2089
+ }
2090
+ ],
2091
+ "description": "This will register this element with the browser."
2092
+ },
2093
+ {
2094
+ "kind": "method",
2095
+ "name": "handleChange",
2096
+ "parameters": [
2097
+ {
2098
+ "name": "event",
2099
+ "description": "The change event from the checkbox input.",
2100
+ "type": {
2101
+ "text": "Event"
2102
+ }
2103
+ }
2104
+ ],
2105
+ "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.",
2106
+ "privacy": "private",
2107
+ "return": {
2108
+ "type": {
2109
+ "text": "void"
2110
+ }
2111
+ }
2112
+ },
2113
+ {
2114
+ "kind": "method",
2115
+ "name": "handleInput",
2116
+ "parameters": [
2117
+ {
2118
+ "name": "event",
2119
+ "description": "The input event from the checkbox input.",
2120
+ "type": {
2121
+ "text": "Event"
2122
+ }
2123
+ }
2124
+ ],
2125
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2126
+ "privacy": "private",
2127
+ "return": {
2128
+ "type": {
2129
+ "text": "void"
2130
+ }
2131
+ }
2132
+ },
2133
+ {
2134
+ "kind": "method",
2135
+ "name": "handleFocusin",
2136
+ "description": "Function to support",
2137
+ "privacy": "private",
2138
+ "return": {
2139
+ "type": {
2140
+ "text": "void"
2141
+ }
2142
+ }
2112
2143
  },
2113
2144
  {
2114
- "name": "autocomplete",
2115
- "type": {
2116
- "text": "string"
2117
- },
2118
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2119
- "fieldName": "autocomplete"
2145
+ "kind": "method",
2146
+ "name": "generateIconHtml",
2147
+ "description": "Function to generate checkmark svg.",
2148
+ "privacy": "private",
2149
+ "return": {
2150
+ "type": {
2151
+ "text": "HTMLElement"
2152
+ }
2153
+ }
2120
2154
  },
2121
2155
  {
2122
- "name": "autoPlacement",
2123
- "type": {
2124
- "text": "boolean"
2125
- },
2126
- "description": "If declared, bib's position will be automatically calculated where to appear.",
2127
- "fieldName": "autoPlacement"
2156
+ "kind": "method",
2157
+ "name": "reset",
2158
+ "description": "Resets component to initial state.",
2159
+ "return": {
2160
+ "type": {
2161
+ "text": "void"
2162
+ }
2163
+ }
2128
2164
  },
2129
2165
  {
2130
- "name": "availableOptions",
2131
- "type": {
2132
- "text": "array"
2133
- },
2134
- "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).",
2135
- "fieldName": "availableOptions"
2166
+ "kind": "method",
2167
+ "name": "updateAriaLabel",
2168
+ "description": "Updates the aria-label based on slot content.",
2169
+ "privacy": "private",
2170
+ "return": {
2171
+ "type": {
2172
+ "text": "void"
2173
+ }
2174
+ }
2136
2175
  },
2137
2176
  {
2138
- "name": "behavior",
2139
- "type": {
2140
- "text": "'filter' | 'suggestion'"
2141
- },
2142
- "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.",
2143
- "default": "'suggestion'",
2144
- "fieldName": "behavior"
2177
+ "kind": "method",
2178
+ "name": "handleKeyDown",
2179
+ "parameters": [
2180
+ {
2181
+ "name": "event",
2182
+ "description": "The keydown event from the checkbox input.",
2183
+ "type": {
2184
+ "text": "KeyboardEvent"
2185
+ }
2186
+ }
2187
+ ],
2188
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
2189
+ "privacy": "private",
2190
+ "return": {
2191
+ "type": {
2192
+ "text": "void"
2193
+ }
2194
+ }
2145
2195
  },
2146
2196
  {
2147
- "name": "checkmark",
2197
+ "kind": "field",
2198
+ "name": "appearance",
2199
+ "privacy": "public",
2148
2200
  "type": {
2149
- "text": "boolean"
2201
+ "text": "'default' | 'inverse'"
2150
2202
  },
2151
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
2152
- "fieldName": "checkmark"
2203
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2204
+ "default": "'default'",
2205
+ "attribute": "appearance",
2206
+ "reflects": true
2153
2207
  },
2154
2208
  {
2155
- "name": "disabled",
2209
+ "kind": "field",
2210
+ "name": "checked",
2211
+ "privacy": "public",
2156
2212
  "type": {
2157
2213
  "text": "boolean"
2158
2214
  },
2159
- "description": "If set, disables the combobox.",
2160
- "fieldName": "disabled"
2215
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2216
+ "attribute": "checked",
2217
+ "reflects": true
2161
2218
  },
2162
2219
  {
2163
- "name": "dvInputOnly",
2220
+ "kind": "field",
2221
+ "name": "disabled",
2222
+ "privacy": "public",
2164
2223
  "type": {
2165
2224
  "text": "boolean"
2166
2225
  },
2167
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2168
- "fieldName": "dvInputOnly"
2226
+ "description": "If set to true, the checkbox will not be clickable.",
2227
+ "attribute": "disabled",
2228
+ "reflects": true
2169
2229
  },
2170
2230
  {
2231
+ "kind": "field",
2171
2232
  "name": "error",
2233
+ "privacy": "public",
2172
2234
  "type": {
2173
- "text": "string"
2235
+ "text": "boolean"
2174
2236
  },
2175
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2176
- "fieldName": "error"
2237
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2238
+ "attribute": "error",
2239
+ "reflects": true
2177
2240
  },
2178
2241
  {
2179
- "name": "format",
2242
+ "kind": "field",
2243
+ "name": "id",
2244
+ "privacy": "public",
2180
2245
  "type": {
2181
2246
  "text": "string"
2182
2247
  },
2183
- "description": "Specifies the input mask format.",
2184
- "fieldName": "format"
2248
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2249
+ "attribute": "id",
2250
+ "reflects": true
2185
2251
  },
2186
2252
  {
2187
- "name": "inputmode",
2253
+ "kind": "field",
2254
+ "name": "inputId",
2255
+ "privacy": "private",
2188
2256
  "type": {
2189
2257
  "text": "string"
2190
2258
  },
2191
- "description": "Exposes inputmode attribute for input.",
2192
- "fieldName": "inputmode"
2259
+ "description": "The id for input node."
2193
2260
  },
2194
2261
  {
2195
- "name": "layout",
2262
+ "kind": "field",
2263
+ "name": "name",
2264
+ "privacy": "public",
2196
2265
  "type": {
2197
2266
  "text": "string"
2198
2267
  },
2199
- "description": "Sets the layout of the combobox.",
2200
- "default": "'classic'",
2201
- "fieldName": "layout",
2202
- "inheritedFrom": {
2203
- "name": "AuroElement",
2204
- "module": "components/layoutElement/src/auroElement.js"
2205
- }
2206
- },
2207
- {
2208
- "name": "matchWidth",
2209
- "type": {
2210
- "text": "boolean"
2211
- },
2212
- "description": "If declared, the popover and trigger will be set to the same width.",
2213
- "fieldName": "matchWidth"
2214
- },
2215
- {
2216
- "name": "noFilter",
2217
- "type": {
2218
- "text": "boolean"
2219
- },
2220
- "description": "If set, combobox will not filter menuoptions based on input.",
2221
- "fieldName": "noFilter"
2268
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2269
+ "attribute": "name"
2222
2270
  },
2223
2271
  {
2224
- "name": "noFlip",
2272
+ "kind": "field",
2273
+ "name": "onDark",
2274
+ "privacy": "public",
2225
2275
  "type": {
2226
2276
  "text": "boolean"
2227
2277
  },
2228
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2229
- "fieldName": "noFlip"
2278
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2279
+ "attribute": "onDark",
2280
+ "reflects": true
2230
2281
  },
2231
2282
  {
2232
- "name": "shift",
2283
+ "kind": "field",
2284
+ "name": "touched",
2285
+ "privacy": "private",
2233
2286
  "type": {
2234
2287
  "text": "boolean"
2235
2288
  },
2236
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2237
- "fieldName": "shift"
2289
+ "description": "Indicates whether the checkbox has been interacted with."
2238
2290
  },
2239
2291
  {
2240
- "name": "noValidate",
2292
+ "kind": "field",
2293
+ "name": "value",
2294
+ "privacy": "public",
2241
2295
  "type": {
2242
- "text": "boolean"
2296
+ "text": "string"
2243
2297
  },
2244
- "description": "If set, disables auto-validation on blur.",
2245
- "fieldName": "noValidate"
2298
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2299
+ "attribute": "value"
2246
2300
  },
2247
2301
  {
2248
- "name": "offset",
2302
+ "kind": "field",
2303
+ "name": "tabIndex",
2304
+ "privacy": "private",
2249
2305
  "type": {
2250
2306
  "text": "number"
2251
2307
  },
2252
- "description": "Gap between the trigger element and bib.",
2253
- "default": "0",
2254
- "fieldName": "offset"
2255
- },
2256
- {
2257
- "name": "onDark",
2258
- "type": {
2259
- "text": "boolean"
2260
- },
2261
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2262
- "fieldName": "onDark"
2308
+ "description": "The tabindex attribute for the checkbox.",
2309
+ "attribute": "tabindex",
2310
+ "reflects": true
2263
2311
  },
2264
2312
  {
2265
- "name": "optionSelected",
2313
+ "kind": "field",
2314
+ "name": "ariaChecked",
2315
+ "privacy": "private",
2266
2316
  "type": {
2267
- "text": "HTMLElement"
2317
+ "text": "string"
2268
2318
  },
2269
- "description": "Specifies the current selected option.",
2270
- "fieldName": "optionSelected"
2319
+ "description": "The aria-checked attribute for the checkbox.",
2320
+ "attribute": "aria-checked",
2321
+ "reflects": true
2271
2322
  },
2272
2323
  {
2273
- "name": "persistInput",
2324
+ "kind": "field",
2325
+ "name": "ariaDisabled",
2326
+ "privacy": "private",
2274
2327
  "type": {
2275
- "text": "boolean"
2328
+ "text": "string"
2276
2329
  },
2277
- "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.",
2278
- "fieldName": "persistInput"
2330
+ "description": "The aria-disabled attribute for the checkbox.",
2331
+ "attribute": "aria-disabled",
2332
+ "reflects": true
2279
2333
  },
2280
2334
  {
2281
- "name": "placement",
2335
+ "kind": "field",
2336
+ "name": "role",
2337
+ "privacy": "private",
2282
2338
  "type": {
2283
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2339
+ "text": "string"
2284
2340
  },
2285
- "description": "Position where the bib should appear relative to the trigger.",
2286
- "default": "'bottom-start'",
2287
- "fieldName": "placement"
2288
- },
2341
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2342
+ "attribute": "role",
2343
+ "reflects": true
2344
+ }
2345
+ ],
2346
+ "events": [
2289
2347
  {
2290
- "name": "placeholder",
2348
+ "name": "auroCheckbox-input",
2291
2349
  "type": {
2292
- "text": "string"
2293
- },
2294
- "description": "Define custom placeholder text, only supported by date input formats.",
2295
- "fieldName": "placeholder"
2350
+ "text": "CustomEvent"
2351
+ }
2296
2352
  },
2297
2353
  {
2298
- "name": "required",
2354
+ "name": "auroCheckbox-focusin",
2299
2355
  "type": {
2300
- "text": "boolean"
2301
- },
2302
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2303
- "fieldName": "required"
2356
+ "text": "CustomEvent"
2357
+ }
2304
2358
  },
2305
2359
  {
2306
- "name": "setCustomValidity",
2360
+ "name": "auroCheckbox-focusout",
2307
2361
  "type": {
2308
- "text": "string"
2309
- },
2310
- "description": "Sets a custom help text message to display for all validityStates.",
2311
- "fieldName": "setCustomValidity"
2362
+ "text": "CustomEvent"
2363
+ }
2312
2364
  },
2313
2365
  {
2314
- "name": "setCustomValidityCustomError",
2366
+ "description": "(Deprecated) Notifies when checked value is changed.",
2367
+ "name": "change"
2368
+ },
2369
+ {
2370
+ "description": "Notifies when when checked value is changed by user's interface.",
2371
+ "name": "input"
2372
+ }
2373
+ ],
2374
+ "attributes": [
2375
+ {
2376
+ "name": "appearance",
2315
2377
  "type": {
2316
- "text": "string"
2378
+ "text": "'default' | 'inverse'"
2317
2379
  },
2318
- "description": "Custom help text message to display when validity = `customError`.",
2319
- "fieldName": "setCustomValidityCustomError"
2380
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2381
+ "default": "'default'",
2382
+ "fieldName": "appearance"
2320
2383
  },
2321
2384
  {
2322
- "name": "setCustomValidityValueMissing",
2385
+ "name": "checked",
2323
2386
  "type": {
2324
- "text": "string"
2387
+ "text": "boolean"
2325
2388
  },
2326
- "description": "Custom help text message to display when validity = `valueMissing`.",
2327
- "fieldName": "setCustomValidityValueMissing"
2389
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
2390
+ "fieldName": "checked"
2328
2391
  },
2329
2392
  {
2330
- "name": "setCustomValidityValueMissingFilter",
2393
+ "name": "disabled",
2331
2394
  "type": {
2332
- "text": "string"
2395
+ "text": "boolean"
2333
2396
  },
2334
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2335
- "fieldName": "setCustomValidityValueMissingFilter"
2397
+ "description": "If set to true, the checkbox will not be clickable.",
2398
+ "fieldName": "disabled"
2336
2399
  },
2337
2400
  {
2338
- "name": "triggerIcon",
2401
+ "name": "error",
2339
2402
  "type": {
2340
2403
  "text": "boolean"
2341
2404
  },
2342
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2343
- "fieldName": "triggerIcon"
2405
+ "description": "If set to true, the checkbox will be displayed with an error state.",
2406
+ "fieldName": "error"
2344
2407
  },
2345
2408
  {
2346
- "name": "type",
2409
+ "name": "id",
2347
2410
  "type": {
2348
2411
  "text": "string"
2349
2412
  },
2350
- "description": "Applies the defined value as the type attribute on `auro-input`.",
2351
- "fieldName": "type"
2413
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2414
+ "fieldName": "id"
2352
2415
  },
2353
2416
  {
2354
- "name": "typedValue",
2417
+ "name": "name",
2355
2418
  "type": {
2356
2419
  "text": "string"
2357
2420
  },
2358
- "description": "Specifies the value of the input element within the combobox.",
2359
- "fieldName": "typedValue"
2421
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2422
+ "fieldName": "name"
2360
2423
  },
2361
2424
  {
2362
- "name": "validity",
2425
+ "name": "onDark",
2363
2426
  "type": {
2364
- "text": "string"
2427
+ "text": "boolean"
2365
2428
  },
2366
- "description": "Specifies the `validityState` this element is in.",
2367
- "fieldName": "validity"
2429
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2430
+ "fieldName": "onDark"
2368
2431
  },
2369
2432
  {
2370
2433
  "name": "value",
2371
2434
  "type": {
2372
2435
  "text": "string"
2373
2436
  },
2374
- "description": "Value selected for the dropdown menu.",
2437
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2375
2438
  "fieldName": "value"
2376
2439
  },
2377
2440
  {
2378
- "name": "largeFullscreenHeadline",
2379
- "type": {
2380
- "text": "boolean"
2381
- },
2382
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2383
- "fieldName": "largeFullscreenHeadline"
2384
- },
2385
- {
2386
- "name": "fullscreenBreakpoint",
2441
+ "name": "tabindex",
2387
2442
  "type": {
2388
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2443
+ "text": "number"
2389
2444
  },
2390
- "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.",
2391
- "default": "'sm'",
2392
- "fieldName": "fullscreenBreakpoint"
2445
+ "description": "The tabindex attribute for the checkbox.",
2446
+ "fieldName": "tabIndex"
2393
2447
  },
2394
2448
  {
2395
- "name": "shape",
2449
+ "name": "aria-checked",
2396
2450
  "type": {
2397
2451
  "text": "string"
2398
2452
  },
2399
- "fieldName": "shape",
2400
- "inheritedFrom": {
2401
- "name": "AuroElement",
2402
- "module": "components/layoutElement/src/auroElement.js"
2403
- }
2453
+ "description": "The aria-checked attribute for the checkbox.",
2454
+ "fieldName": "ariaChecked"
2404
2455
  },
2405
2456
  {
2406
- "name": "size",
2457
+ "name": "aria-disabled",
2407
2458
  "type": {
2408
2459
  "text": "string"
2409
2460
  },
2410
- "fieldName": "size",
2411
- "inheritedFrom": {
2412
- "name": "AuroElement",
2413
- "module": "components/layoutElement/src/auroElement.js"
2414
- }
2461
+ "description": "The aria-disabled attribute for the checkbox.",
2462
+ "fieldName": "ariaDisabled"
2415
2463
  },
2416
2464
  {
2417
- "name": "ondark",
2465
+ "name": "role",
2418
2466
  "type": {
2419
- "text": "boolean"
2467
+ "text": "string"
2420
2468
  },
2421
- "fieldName": "onDark",
2422
- "inheritedFrom": {
2423
- "name": "AuroElement",
2424
- "module": "components/layoutElement/src/auroElement.js"
2425
- }
2469
+ "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2470
+ "fieldName": "role"
2426
2471
  }
2427
2472
  ],
2428
2473
  "superclass": {
2429
- "name": "AuroElement",
2430
- "module": "/components/layoutElement/src/auroElement.js"
2474
+ "name": "LitElement",
2475
+ "package": "lit"
2431
2476
  },
2432
- "tagName": "auro-combobox",
2477
+ "tagName": "auro-checkbox",
2433
2478
  "customElement": true
2434
2479
  }
2435
2480
  ],
2436
2481
  "exports": [
2437
2482
  {
2438
2483
  "kind": "js",
2439
- "name": "AuroCombobox",
2484
+ "name": "AuroCheckbox",
2440
2485
  "declaration": {
2441
- "name": "AuroCombobox",
2442
- "module": "components/combobox/src/auro-combobox.js"
2486
+ "name": "AuroCheckbox",
2487
+ "module": "components/checkbox/src/auro-checkbox.js"
2443
2488
  }
2444
2489
  }
2445
2490
  ]
2446
2491
  },
2447
2492
  {
2448
2493
  "kind": "javascript-module",
2449
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2450
- "declarations": [
2451
- {
2452
- "kind": "variable",
2453
- "name": "comboboxKeyboardStrategy",
2454
- "type": {
2455
- "text": "object"
2456
- },
2457
- "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) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { 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) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); 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)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
2458
- }
2459
- ],
2494
+ "path": "components/checkbox/src/index.js",
2495
+ "declarations": [],
2460
2496
  "exports": [
2461
2497
  {
2462
2498
  "kind": "js",
2463
- "name": "comboboxKeyboardStrategy",
2499
+ "name": "AuroCheckbox",
2464
2500
  "declaration": {
2465
- "name": "comboboxKeyboardStrategy",
2466
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2501
+ "name": "AuroCheckbox",
2502
+ "module": "components/checkbox/src/index.js"
2467
2503
  }
2468
- }
2469
- ]
2470
- },
2471
- {
2472
- "kind": "javascript-module",
2473
- "path": "components/combobox/src/index.js",
2474
- "declarations": [],
2475
- "exports": [
2504
+ },
2476
2505
  {
2477
2506
  "kind": "js",
2478
- "name": "AuroCombobox",
2507
+ "name": "AuroCheckboxGroup",
2479
2508
  "declaration": {
2480
- "name": "AuroCombobox",
2481
- "module": "components/combobox/src/index.js"
2509
+ "name": "AuroCheckboxGroup",
2510
+ "module": "components/checkbox/src/index.js"
2482
2511
  }
2483
2512
  }
2484
2513
  ]
2485
2514
  },
2486
2515
  {
2487
2516
  "kind": "javascript-module",
2488
- "path": "components/combobox/src/registered.js",
2517
+ "path": "components/checkbox/src/registered.js",
2489
2518
  "declarations": [],
2490
- "exports": [
2491
- {
2492
- "kind": "js",
2493
- "name": "AuroCombobox",
2494
- "declaration": {
2495
- "name": "AuroCombobox",
2496
- "module": "components/combobox/src/registered.js"
2497
- }
2498
- }
2499
- ]
2519
+ "exports": []
2500
2520
  },
2501
2521
  {
2502
2522
  "kind": "javascript-module",
@@ -6305,6 +6325,14 @@
6305
6325
  "description": "Defines the label content for the first input.",
6306
6326
  "name": "fromLabel"
6307
6327
  },
6328
+ {
6329
+ "description": "Overrides the \"(optional)\" text rendered next to the first input's label when the datepicker is not `required`.",
6330
+ "name": "optionalFromLabel"
6331
+ },
6332
+ {
6333
+ "description": "Overrides the \"(optional)\" text rendered next to the second input's label when `range` is set and the datepicker is not `required`.",
6334
+ "name": "optionalToLabel"
6335
+ },
6308
6336
  {
6309
6337
  "description": "Defines the content to display in the auro-calendar-cell for the specified date. The content text is colored using the success state token when the `highlight` attribute is applied to the slot.",
6310
6338
  "name": "date_YYYY_MM_DD"
@@ -10493,6 +10521,46 @@
10493
10521
  },
10494
10522
  "privacy": "private"
10495
10523
  },
10524
+ {
10525
+ "kind": "method",
10526
+ "name": "_isDisabled",
10527
+ "parameters": [
10528
+ {
10529
+ "name": "element",
10530
+ "description": "The element to check.",
10531
+ "type": {
10532
+ "text": "HTMLElement | undefined | null"
10533
+ }
10534
+ }
10535
+ ],
10536
+ "description": "Whether a given element is currently disabled. Disabled controls are excluded\nfrom submission, validity, and initial-state checks per the HTML spec\n(section 4.10.19.2 \"Enabling and disabling form controls\":\nhttps://www.w3.org/TR/2011/WD-html5-20110113/association-of-controls-and-forms.html).\n\nImplementation note: we deliberately read only the attribute. Every Auro\nform element in `formElementTags` declares `disabled` with `reflect: true`,\nso the attribute and property stay in sync. Reading the attribute also\nlets the MutationObserver in `connectedCallback` (which is filtered to\n`['disabled', 'name']`) be the single source of truth for re-renders.\nIf a future form-element type ships without attribute reflection, expand\nthis helper to also read `element.disabled`.",
10537
+ "return": {
10538
+ "type": {
10539
+ "text": "boolean"
10540
+ }
10541
+ },
10542
+ "privacy": "private"
10543
+ },
10544
+ {
10545
+ "kind": "method",
10546
+ "name": "_isNameDisabled",
10547
+ "parameters": [
10548
+ {
10549
+ "name": "name",
10550
+ "description": "The `name` attribute used to register the element.",
10551
+ "type": {
10552
+ "text": "string"
10553
+ }
10554
+ }
10555
+ ],
10556
+ "description": "Whether the tracked form element registered under `name` is currently disabled.\nSee `_isDisabled` for the HTML-spec rationale behind excluding disabled\ncontrols from form state.\n\nReads a cached flag on `formState[name]` populated by `_addElementToState`\nat registration and refreshed by `_handleAttributeMutations` whenever the\nelement's `disabled` attribute toggles. The cache is fed by the same\n`hasAttribute('disabled')` read as `_isDisabled`, so the \"future form-element\ntype without attribute reflection\" caveat documented there applies here too.",
10557
+ "return": {
10558
+ "type": {
10559
+ "text": "boolean"
10560
+ }
10561
+ },
10562
+ "privacy": "private"
10563
+ },
10496
10564
  {
10497
10565
  "kind": "method",
10498
10566
  "name": "_eventIsValidFormEvent",
@@ -10558,26 +10626,68 @@
10558
10626
  "type": {
10559
10627
  "text": "HTMLButtonElement[]"
10560
10628
  }
10561
- },
10562
- "privacy": "private",
10563
- "readonly": true
10564
- },
10565
- {
10566
- "kind": "field",
10567
- "name": "resetElements",
10568
- "description": "Returns a collection of elements that will reset the form.",
10629
+ },
10630
+ "privacy": "private",
10631
+ "readonly": true
10632
+ },
10633
+ {
10634
+ "kind": "field",
10635
+ "name": "resetElements",
10636
+ "description": "Returns a collection of elements that will reset the form.",
10637
+ "return": {
10638
+ "type": {
10639
+ "text": "HTMLButtonElement[]"
10640
+ }
10641
+ },
10642
+ "privacy": "private",
10643
+ "readonly": true
10644
+ },
10645
+ {
10646
+ "kind": "method",
10647
+ "name": "_isFormValid",
10648
+ "description": "Raw constraint-validation check. Returns `true` when no enabled field\nhas a validity error. Unlike the public `validity` getter, this does\nNOT gate on `isInitialState` — callers that need to make a decision\nbased on the actual constraint state (submit-button enablement, the\ninternal `submit()` gate) read this so a pre-filled valid form is\ncorrectly recognized as submittable at first render.",
10649
+ "return": {
10650
+ "type": {
10651
+ "text": "boolean"
10652
+ }
10653
+ },
10654
+ "privacy": "private"
10655
+ },
10656
+ {
10657
+ "kind": "method",
10658
+ "name": "_hasResetableState",
10659
+ "description": "Whether the reset button should be enabled. True when the form has\ndiverged from its initial state (so the user can always return to\ndefaults — even if the dirty value lives behind a now-disabled field),\nOR when any non-disabled field has a current value or captured initial\nvalue (covers pre-filled forms and user-cleared-back-to-empty cases).",
10660
+ "return": {
10661
+ "type": {
10662
+ "text": "boolean"
10663
+ }
10664
+ },
10665
+ "privacy": "private"
10666
+ },
10667
+ {
10668
+ "kind": "method",
10669
+ "name": "_normalizeEmpty",
10670
+ "parameters": [
10671
+ {
10672
+ "name": "value",
10673
+ "description": "Value to normalize.",
10674
+ "type": {
10675
+ "text": "*"
10676
+ }
10677
+ }
10678
+ ],
10679
+ "description": "Collapse empty representations to a single canonical `null`.\n\n`_addElementToState` captures `null` for a field that mounts without a\n`value` attribute (`element.value || element.getAttribute('value')` is\nfalsy → resolves to `null`), but `sharedInputListener` later stores the\nraw `event.target.value` — which is `''` for a user-cleared text input.\nWithout this normalization, backspacing back to empty would taint the\nform forever (`'' !== null`) and Reset would stay enabled with nothing\nto actually reset.\n\n`''`, `undefined`, and `[]` all collapse to `null`. The empty-array case\ncovers checkbox-group, radio-group, and multiselect, where `[]` means\n\"no selection\" — semantically the same as `null`/`''`. Genuine values\n— including `0`, `false`, non-empty strings, and non-empty arrays —\npass through unchanged so number, boolean, and populated multi-value\nfields still compare correctly.",
10569
10680
  "return": {
10570
10681
  "type": {
10571
- "text": "HTMLButtonElement[]"
10682
+ "text": "*"
10572
10683
  }
10573
10684
  },
10574
- "privacy": "private",
10575
- "readonly": true
10685
+ "privacy": "private"
10576
10686
  },
10577
10687
  {
10578
10688
  "kind": "method",
10579
10689
  "name": "_calculateValidity",
10580
- "description": "Infer validity status based on current formState.",
10690
+ "description": "Infer validity status based on current formState.\n\nValidity stays `null` while the form is in its initial state — this is\nthe \"stay quiet until the user interacts\" UX contract that consumers\ndepend on to delay error indicators. Code that needs the raw\nconstraint-validation result regardless of interaction (e.g.,\nsubmit-button enablement) should call `_isFormValid()` directly.",
10581
10691
  "privacy": "private"
10582
10692
  },
10583
10693
  {
@@ -10594,7 +10704,7 @@
10594
10704
  {
10595
10705
  "kind": "method",
10596
10706
  "name": "_setInitialState",
10597
- "description": "Determines whether the form is in its initial (untouched) state and updates `_isInitialState` accordingly.",
10707
+ "description": "Determines whether the form is in its initial (untouched) state.\n\nA field is tainted if either:\n - its value differs from the value captured on first render, OR\n - its validity is failing (anything other than `null` or `'valid'`).\n\nValidity acts as a backup signal: it catches users who interact with a\nfield without changing its value (e.g., focusing and blurring a required\nfield). We skip `null` (not yet validated) and `'valid'` (the default\nafter Auro's auto-validation on mount) because neither proves the user\ntouched anything.",
10598
10708
  "return": {
10599
10709
  "type": {
10600
10710
  "text": "void"
@@ -10754,6 +10864,26 @@
10754
10864
  },
10755
10865
  "privacy": "private"
10756
10866
  },
10867
+ {
10868
+ "kind": "method",
10869
+ "name": "_handleAttributeMutations",
10870
+ "parameters": [
10871
+ {
10872
+ "name": "mutations",
10873
+ "description": "The batched mutation records.",
10874
+ "type": {
10875
+ "text": "MutationRecord[]"
10876
+ }
10877
+ }
10878
+ ],
10879
+ "description": "Handle batched MutationObserver records for `disabled` and `name`\nattribute changes on tracked form elements. A `name` change invalidates\nthe formState keying — we resolve it by re-initializing state. A `disabled`\nchange simply needs a re-render (so `value` / `validity` getters re-evaluate)\nand a refresh of the submit/reset button enablement.",
10880
+ "return": {
10881
+ "type": {
10882
+ "text": "void"
10883
+ }
10884
+ },
10885
+ "privacy": "private"
10886
+ },
10757
10887
  {
10758
10888
  "kind": "method",
10759
10889
  "name": "mutationEventListener",
@@ -10847,6 +10977,25 @@
10847
10977
  },
10848
10978
  "privacy": "private",
10849
10979
  "default": "[]"
10980
+ },
10981
+ {
10982
+ "kind": "field",
10983
+ "name": "_initialValues",
10984
+ "type": {
10985
+ "text": "Record<string, string | number | boolean | string[] | null | undefined>"
10986
+ },
10987
+ "description": "Captured initial (default) value per field `name`. Populated on first\nsight of each name in `_addElementToState` and preserved across\nsubsequent `initializeState` cycles (slot change, rename, reset) so\n`_setInitialState` can detect user edits as `current !== initial`,\nmatching HTML's `dirtyValueFlag` semantics.",
10988
+ "privacy": "private",
10989
+ "default": "{}"
10990
+ },
10991
+ {
10992
+ "kind": "field",
10993
+ "name": "_attributeObserver",
10994
+ "type": {
10995
+ "text": "MutationObserver | null"
10996
+ },
10997
+ "privacy": "private",
10998
+ "default": "null"
10850
10999
  }
10851
11000
  ],
10852
11001
  "events": [
@@ -11696,61 +11845,6 @@
11696
11845
  "module": "components/input/src/base-input.js"
11697
11846
  }
11698
11847
  },
11699
- {
11700
- "kind": "method",
11701
- "name": "_computeDateObjectFallback",
11702
- "parameters": [
11703
- {
11704
- "name": "dateStr",
11705
- "description": "ISO date string from `value`/`min`/`max`.",
11706
- "type": {
11707
- "text": "string|undefined"
11708
- }
11709
- }
11710
- ],
11711
- "description": "Parses a date string into a Date object when the corresponding `_*Object`\nfield hasn't been synced yet by `updated()`. Returns undefined when the\ninput type/format isn't a full date or the string is not a valid date.\n\nWhy this exists: a parent (datepicker) can call `inputN.validate()` from\ninside its own `updated()` before this input's `updated()` has run\n`syncDateValues()` — so `_valueObject`/`_maxObject` are still `undefined`\nand range checks would otherwise silently no-op (flipping the result to\n`valid` or `patternMismatch`).",
11712
- "privacy": "private",
11713
- "return": {
11714
- "type": {
11715
- "text": "Date|undefined"
11716
- }
11717
- },
11718
- "inheritedFrom": {
11719
- "name": "BaseInput",
11720
- "module": "components/input/src/base-input.js"
11721
- }
11722
- },
11723
- {
11724
- "kind": "method",
11725
- "name": "setDateObjectProperty",
11726
- "parameters": [
11727
- {
11728
- "name": "propertyName",
11729
- "description": "Public object property name.",
11730
- "type": {
11731
- "text": "'valueObject'|'minObject'|'maxObject'"
11732
- }
11733
- },
11734
- {
11735
- "name": "propertyValue",
11736
- "description": "Value to assign.",
11737
- "type": {
11738
- "text": "Date|undefined"
11739
- }
11740
- }
11741
- ],
11742
- "description": "Internal setter for readonly date object properties.",
11743
- "privacy": "private",
11744
- "return": {
11745
- "type": {
11746
- "text": "void"
11747
- }
11748
- },
11749
- "inheritedFrom": {
11750
- "name": "BaseInput",
11751
- "module": "components/input/src/base-input.js"
11752
- }
11753
- },
11754
11848
  {
11755
11849
  "kind": "method",
11756
11850
  "name": "patchInputEvent",
@@ -11804,70 +11898,6 @@
11804
11898
  "module": "components/input/src/base-input.js"
11805
11899
  }
11806
11900
  },
11807
- {
11808
- "kind": "method",
11809
- "name": "syncDateValues",
11810
- "parameters": [
11811
- {
11812
- "name": "changedProperties",
11813
- "default": "undefined",
11814
- "description": "Optional map of changed properties used to limit which values are synchronized.",
11815
- "optional": true,
11816
- "type": {
11817
- "text": "Map<string, unknown>|undefined"
11818
- }
11819
- }
11820
- ],
11821
- "description": "Synchronizes the ISO string values and Date object representations for date-related properties.\nThis keeps the model and display values aligned when either side changes.\n\nWhen a full date format is in use, this method updates `value`, `min`, and `max` from their corresponding\nDate objects or vice versa, based on which properties have changed. It only runs when the current configuration\nrepresents a full year/month/day date format.",
11822
- "return": {
11823
- "type": {
11824
- "text": "void"
11825
- }
11826
- },
11827
- "privacy": "private",
11828
- "inheritedFrom": {
11829
- "name": "BaseInput",
11830
- "module": "components/input/src/base-input.js"
11831
- }
11832
- },
11833
- {
11834
- "kind": "method",
11835
- "name": "syncSingleDateValue",
11836
- "parameters": [
11837
- {
11838
- "name": "changedProperties",
11839
- "description": "Map of changed properties from Lit.",
11840
- "type": {
11841
- "text": "Map<string, unknown>|undefined"
11842
- }
11843
- },
11844
- {
11845
- "name": "objectProperty",
11846
- "description": "Date object property name.",
11847
- "type": {
11848
- "text": "string"
11849
- }
11850
- },
11851
- {
11852
- "name": "valueProperty",
11853
- "description": "ISO string property name.",
11854
- "type": {
11855
- "text": "string"
11856
- }
11857
- }
11858
- ],
11859
- "description": "Synchronizes one date object/string property pair.",
11860
- "privacy": "private",
11861
- "return": {
11862
- "type": {
11863
- "text": "void"
11864
- }
11865
- },
11866
- "inheritedFrom": {
11867
- "name": "BaseInput",
11868
- "module": "components/input/src/base-input.js"
11869
- }
11870
- },
11871
11901
  {
11872
11902
  "kind": "method",
11873
11903
  "name": "configureAutoFormatting",
@@ -12243,15 +12273,6 @@
12243
12273
  "module": "components/input/src/base-input.js"
12244
12274
  }
12245
12275
  },
12246
- {
12247
- "kind": "field",
12248
- "name": "_maxObject",
12249
- "default": "undefined",
12250
- "inheritedFrom": {
12251
- "name": "BaseInput",
12252
- "module": "components/input/src/base-input.js"
12253
- }
12254
- },
12255
12276
  {
12256
12277
  "kind": "field",
12257
12278
  "name": "maxLength",
@@ -12283,15 +12304,6 @@
12283
12304
  "module": "components/input/src/base-input.js"
12284
12305
  }
12285
12306
  },
12286
- {
12287
- "kind": "field",
12288
- "name": "_minObject",
12289
- "default": "undefined",
12290
- "inheritedFrom": {
12291
- "name": "BaseInput",
12292
- "module": "components/input/src/base-input.js"
12293
- }
12294
- },
12295
12307
  {
12296
12308
  "kind": "field",
12297
12309
  "name": "minLength",
@@ -12400,15 +12412,6 @@
12400
12412
  "module": "components/input/src/base-input.js"
12401
12413
  }
12402
12414
  },
12403
- {
12404
- "kind": "field",
12405
- "name": "_valueObject",
12406
- "default": "undefined",
12407
- "inheritedFrom": {
12408
- "name": "BaseInput",
12409
- "module": "components/input/src/base-input.js"
12410
- }
12411
- },
12412
12415
  {
12413
12416
  "kind": "field",
12414
12417
  "name": "a11yRole",
@@ -13807,53 +13810,6 @@
13807
13810
  },
13808
13811
  "readonly": true
13809
13812
  },
13810
- {
13811
- "kind": "method",
13812
- "name": "_computeDateObjectFallback",
13813
- "parameters": [
13814
- {
13815
- "name": "dateStr",
13816
- "description": "ISO date string from `value`/`min`/`max`.",
13817
- "type": {
13818
- "text": "string|undefined"
13819
- }
13820
- }
13821
- ],
13822
- "description": "Parses a date string into a Date object when the corresponding `_*Object`\nfield hasn't been synced yet by `updated()`. Returns undefined when the\ninput type/format isn't a full date or the string is not a valid date.\n\nWhy this exists: a parent (datepicker) can call `inputN.validate()` from\ninside its own `updated()` before this input's `updated()` has run\n`syncDateValues()` — so `_valueObject`/`_maxObject` are still `undefined`\nand range checks would otherwise silently no-op (flipping the result to\n`valid` or `patternMismatch`).",
13823
- "privacy": "private",
13824
- "return": {
13825
- "type": {
13826
- "text": "Date|undefined"
13827
- }
13828
- }
13829
- },
13830
- {
13831
- "kind": "method",
13832
- "name": "setDateObjectProperty",
13833
- "parameters": [
13834
- {
13835
- "name": "propertyName",
13836
- "description": "Public object property name.",
13837
- "type": {
13838
- "text": "'valueObject'|'minObject'|'maxObject'"
13839
- }
13840
- },
13841
- {
13842
- "name": "propertyValue",
13843
- "description": "Value to assign.",
13844
- "type": {
13845
- "text": "Date|undefined"
13846
- }
13847
- }
13848
- ],
13849
- "description": "Internal setter for readonly date object properties.",
13850
- "privacy": "private",
13851
- "return": {
13852
- "type": {
13853
- "text": "void"
13854
- }
13855
- }
13856
- },
13857
13813
  {
13858
13814
  "kind": "method",
13859
13815
  "name": "patchInputEvent",
@@ -13895,62 +13851,6 @@
13895
13851
  }
13896
13852
  }
13897
13853
  },
13898
- {
13899
- "kind": "method",
13900
- "name": "syncDateValues",
13901
- "parameters": [
13902
- {
13903
- "name": "changedProperties",
13904
- "default": "undefined",
13905
- "description": "Optional map of changed properties used to limit which values are synchronized.",
13906
- "optional": true,
13907
- "type": {
13908
- "text": "Map<string, unknown>|undefined"
13909
- }
13910
- }
13911
- ],
13912
- "description": "Synchronizes the ISO string values and Date object representations for date-related properties.\nThis keeps the model and display values aligned when either side changes.\n\nWhen a full date format is in use, this method updates `value`, `min`, and `max` from their corresponding\nDate objects or vice versa, based on which properties have changed. It only runs when the current configuration\nrepresents a full year/month/day date format.",
13913
- "return": {
13914
- "type": {
13915
- "text": "void"
13916
- }
13917
- },
13918
- "privacy": "private"
13919
- },
13920
- {
13921
- "kind": "method",
13922
- "name": "syncSingleDateValue",
13923
- "parameters": [
13924
- {
13925
- "name": "changedProperties",
13926
- "description": "Map of changed properties from Lit.",
13927
- "type": {
13928
- "text": "Map<string, unknown>|undefined"
13929
- }
13930
- },
13931
- {
13932
- "name": "objectProperty",
13933
- "description": "Date object property name.",
13934
- "type": {
13935
- "text": "string"
13936
- }
13937
- },
13938
- {
13939
- "name": "valueProperty",
13940
- "description": "ISO string property name.",
13941
- "type": {
13942
- "text": "string"
13943
- }
13944
- }
13945
- ],
13946
- "description": "Synchronizes one date object/string property pair.",
13947
- "privacy": "private",
13948
- "return": {
13949
- "type": {
13950
- "text": "void"
13951
- }
13952
- }
13953
- },
13954
13854
  {
13955
13855
  "kind": "method",
13956
13856
  "name": "configureAutoFormatting",
@@ -14238,11 +14138,6 @@
14238
14138
  "default": "undefined",
14239
14139
  "attribute": "max"
14240
14140
  },
14241
- {
14242
- "kind": "field",
14243
- "name": "_maxObject",
14244
- "default": "undefined"
14245
- },
14246
14141
  {
14247
14142
  "kind": "field",
14248
14143
  "name": "maxLength",
@@ -14266,11 +14161,6 @@
14266
14161
  "default": "undefined",
14267
14162
  "attribute": "min"
14268
14163
  },
14269
- {
14270
- "kind": "field",
14271
- "name": "_minObject",
14272
- "default": "undefined"
14273
- },
14274
14164
  {
14275
14165
  "kind": "field",
14276
14166
  "name": "minLength",
@@ -14363,11 +14253,6 @@
14363
14253
  "default": "undefined",
14364
14254
  "attribute": "value"
14365
14255
  },
14366
- {
14367
- "kind": "field",
14368
- "name": "_valueObject",
14369
- "default": "undefined"
14370
- },
14371
14256
  {
14372
14257
  "kind": "field",
14373
14258
  "name": "a11yRole",