@aurodesignsystem-dev/auro-formkit 0.0.0-pr1532.0 → 0.0.0-pr1533.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 (54) hide show
  1. package/components/checkbox/demo/customize.min.js +1 -1
  2. package/components/checkbox/demo/getting-started.min.js +1 -1
  3. package/components/checkbox/demo/index.min.js +1 -1
  4. package/components/checkbox/dist/index.js +1 -1
  5. package/components/checkbox/dist/registered.js +1 -1
  6. package/components/combobox/demo/customize.min.js +118 -50
  7. package/components/combobox/demo/getting-started.min.js +118 -50
  8. package/components/combobox/demo/index.min.js +118 -50
  9. package/components/combobox/dist/auro-combobox.d.ts +10 -0
  10. package/components/combobox/dist/index.js +118 -50
  11. package/components/combobox/dist/registered.js +118 -50
  12. package/components/counter/demo/customize.min.js +2 -2
  13. package/components/counter/demo/index.min.js +2 -2
  14. package/components/counter/dist/index.js +2 -2
  15. package/components/counter/dist/registered.js +2 -2
  16. package/components/datepicker/demo/accessibility.md +17 -8
  17. package/components/datepicker/demo/api.md +1 -1
  18. package/components/datepicker/demo/customize.min.js +229 -72
  19. package/components/datepicker/demo/index.min.js +229 -72
  20. package/components/datepicker/demo/keyboard-behavior.md +3 -3
  21. package/components/datepicker/demo/voiceover.md +4 -4
  22. package/components/datepicker/demo/why-datepicker.md +2 -2
  23. package/components/datepicker/dist/auro-calendar-cell.d.ts +11 -0
  24. package/components/datepicker/dist/auro-calendar.d.ts +26 -2
  25. package/components/datepicker/dist/auro-datepicker.d.ts +9 -1
  26. package/components/datepicker/dist/index.js +229 -72
  27. package/components/datepicker/dist/registered.js +229 -72
  28. package/components/dropdown/demo/customize.min.js +1 -1
  29. package/components/dropdown/demo/getting-started.min.js +1 -1
  30. package/components/dropdown/demo/index.min.js +1 -1
  31. package/components/dropdown/dist/index.js +1 -1
  32. package/components/dropdown/dist/registered.js +1 -1
  33. package/components/form/demo/customize.min.js +408 -172
  34. package/components/form/demo/getting-started.min.js +408 -172
  35. package/components/form/demo/index.min.js +408 -172
  36. package/components/form/demo/registerDemoDeps.min.js +408 -172
  37. package/components/input/demo/customize.min.js +56 -45
  38. package/components/input/demo/getting-started.min.js +56 -45
  39. package/components/input/demo/index.min.js +56 -45
  40. package/components/input/dist/base-input.d.ts +20 -4
  41. package/components/input/dist/index.js +56 -45
  42. package/components/input/dist/registered.js +56 -45
  43. package/components/radio/demo/customize.min.js +1 -1
  44. package/components/radio/demo/getting-started.min.js +1 -1
  45. package/components/radio/demo/index.min.js +1 -1
  46. package/components/radio/dist/index.js +1 -1
  47. package/components/radio/dist/registered.js +1 -1
  48. package/components/select/demo/customize.min.js +2 -2
  49. package/components/select/demo/getting-started.min.js +2 -2
  50. package/components/select/demo/index.min.js +2 -2
  51. package/components/select/dist/index.js +2 -2
  52. package/components/select/dist/registered.js +2 -2
  53. package/custom-elements.json +1664 -1566
  54. package/package.json +1 -1
@@ -267,107 +267,34 @@
267
267
  },
268
268
  {
269
269
  "kind": "javascript-module",
270
- "path": "components/combobox/src/auro-combobox.js",
270
+ "path": "components/checkbox/src/auro-checkbox-group.js",
271
271
  "declarations": [
272
272
  {
273
273
  "kind": "class",
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",
274
+ "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
275
+ "name": "AuroCheckboxGroup",
276
276
  "slots": [
277
277
  {
278
- "description": "Default slot for the menu content.",
279
- "name": ""
278
+ "description": "Allows for the legend to be overridden.",
279
+ "name": "legend"
280
280
  },
281
281
  {
282
- "type": {
283
- "text": "HTMLSlotElement"
284
- },
285
282
  "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
286
283
  "name": "optionalLabel"
287
284
  },
288
285
  {
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.",
286
+ "description": "Allows for the helper text to be overridden.",
306
287
  "name": "helpText"
307
288
  },
308
289
  {
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"
290
+ "description": "The default slot for the checkbox items.",
291
+ "name": "default"
311
292
  }
312
293
  ],
313
294
  "members": [
314
295
  {
315
296
  "kind": "method",
316
- "name": "_initializeDefaults",
317
- "privacy": "private",
318
- "return": {
319
- "type": {
320
- "text": "void"
321
- }
322
- }
323
- },
324
- {
325
- "kind": "method",
326
- "name": "_scheduleTimer",
327
- "parameters": [
328
- {
329
- "name": "fn",
330
- "description": "Callback to run.",
331
- "type": {
332
- "text": "Function"
333
- }
334
- },
335
- {
336
- "name": "ms",
337
- "description": "Delay in milliseconds.",
338
- "type": {
339
- "text": "number"
340
- }
341
- }
342
- ],
343
- "description": "Wraps setTimeout and records the timer id so disconnectedCallback\ncan cancel any outstanding callbacks. The id is removed from the set\nonce the callback fires so the set doesn't grow unbounded.",
344
- "return": {
345
- "type": {
346
- "text": "number"
347
- }
348
- },
349
- "privacy": "private"
350
- },
351
- {
352
- "kind": "field",
353
- "name": "inputValue",
354
- "description": "Returns the current value of the input element within the combobox.",
355
- "return": {
356
- "type": {
357
- "text": "string|undefined"
358
- }
359
- },
360
- "readonly": true
361
- },
362
- {
363
- "kind": "method",
364
- "name": "isValid",
365
- "description": "Checks if the element is valid.",
366
- "return": {
367
- "type": {
368
- "text": "boolean"
369
- }
370
- }
297
+ "name": "_initializeDefaults"
371
298
  },
372
299
  {
373
300
  "kind": "method",
@@ -376,7 +303,7 @@
376
303
  "parameters": [
377
304
  {
378
305
  "name": "name",
379
- "default": "'auro-combobox'",
306
+ "default": "\"auro-checkbox-group\"",
380
307
  "description": "The name of the element that you want to register.",
381
308
  "optional": true,
382
309
  "type": {
@@ -388,82 +315,24 @@
388
315
  },
389
316
  {
390
317
  "kind": "method",
391
- "name": "activateFirstEnabledAvailableOption",
392
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
393
- "privacy": "private",
394
- "return": {
395
- "type": {
396
- "text": "void"
397
- }
398
- }
399
- },
400
- {
401
- "kind": "method",
402
- "name": "activateLastEnabledAvailableOption",
403
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
404
- "privacy": "private",
405
- "return": {
406
- "type": {
407
- "text": "void"
408
- }
409
- }
410
- },
411
- {
412
- "kind": "method",
413
- "name": "updateFilter",
414
- "description": "Updates the filter for the available options based on the input value.",
415
- "privacy": "private"
416
- },
417
- {
418
- "kind": "method",
419
- "name": "syncValuesAndStates",
420
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
421
- "privacy": "private",
422
- "return": {
423
- "type": {
424
- "text": "void"
425
- }
426
- }
427
- },
428
- {
429
- "kind": "method",
430
- "name": "updateTriggerTextDisplay",
318
+ "name": "handleValueUpdate",
431
319
  "parameters": [
432
320
  {
433
- "name": "label",
434
- "description": "The label of the selected option.",
321
+ "name": "value",
322
+ "description": "The value of the checkbox.",
435
323
  "type": {
436
- "text": "string"
324
+ "text": "String"
437
325
  }
438
- }
439
- ],
440
- "description": "Update displayValue or input.value, it's called when making a selection.",
441
- "privacy": "private"
442
- },
443
- {
444
- "kind": "method",
445
- "name": "syncInputValuesAcrossTriggerAndBib",
446
- "parameters": [
326
+ },
447
327
  {
448
- "name": "nextValue",
449
- "description": "The value to write to both inputs.",
328
+ "name": "selected",
329
+ "description": "The checked state of the checkbox.",
450
330
  "type": {
451
- "text": "string"
331
+ "text": "Boolean"
452
332
  }
453
333
  }
454
334
  ],
455
- "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.",
456
- "return": {
457
- "type": {
458
- "text": "Promise<void>"
459
- }
460
- },
461
- "privacy": "private"
462
- },
463
- {
464
- "kind": "method",
465
- "name": "handleMenuOptions",
466
- "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
335
+ "description": "Helper method to handle checkbox value changing.",
467
336
  "privacy": "private",
468
337
  "return": {
469
338
  "type": {
@@ -473,8 +342,8 @@
473
342
  },
474
343
  {
475
344
  "kind": "method",
476
- "name": "generateOptionsArray",
477
- "description": "Determines the element error state based on the `required` attribute and input value.",
345
+ "name": "handlePreselectedItems",
346
+ "description": "Helper method that handles the state of preselected checkboxes.",
478
347
  "privacy": "private",
479
348
  "return": {
480
349
  "type": {
@@ -484,8 +353,9 @@
484
353
  },
485
354
  {
486
355
  "kind": "method",
487
- "name": "hideBib",
488
- "description": "Hides the dropdown bib if its open.",
356
+ "name": "handleItems",
357
+ "description": "Helper method that handles the state of checkboxes.",
358
+ "privacy": "private",
489
359
  "return": {
490
360
  "type": {
491
361
  "text": "void"
@@ -494,8 +364,8 @@
494
364
  },
495
365
  {
496
366
  "kind": "method",
497
- "name": "showBib",
498
- "description": "Shows the dropdown bib if there are options to show.",
367
+ "name": "reset",
368
+ "description": "Resets component to initial state.",
499
369
  "return": {
500
370
  "type": {
501
371
  "text": "void"
@@ -504,252 +374,325 @@
504
374
  },
505
375
  {
506
376
  "kind": "method",
507
- "name": "configureDropdown",
508
- "description": "Binds all behavior needed to the dropdown after rendering.",
509
- "privacy": "private",
510
- "return": {
511
- "type": {
512
- "text": "void"
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
+ }
513
387
  }
514
- }
388
+ ],
389
+ "description": "Validates value."
515
390
  },
516
391
  {
517
- "kind": "method",
518
- "name": "setClearBtnFocus",
519
- "privacy": "private"
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
520
402
  },
521
403
  {
522
- "kind": "method",
523
- "name": "setTriggerInputFocus",
524
- "privacy": "private"
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
525
413
  },
526
414
  {
527
- "kind": "method",
528
- "name": "setInputFocus",
529
- "privacy": "private"
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
530
424
  },
531
425
  {
532
- "kind": "method",
533
- "name": "updateBibDialogRole",
534
- "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.",
535
- "privacy": "private"
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
536
435
  },
537
436
  {
538
- "kind": "method",
539
- "name": "updateMenuShapeSize",
540
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
541
- "privacy": "private"
542
- },
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
446
+ },
543
447
  {
544
- "kind": "method",
545
- "name": "_getAnnouncementRoot",
546
- "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.",
547
- "privacy": "private",
548
- "return": {
549
- "type": {
550
- "text": "ShadowRoot"
551
- }
552
- }
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
553
457
  },
554
458
  {
555
- "kind": "method",
556
- "name": "configureMenu",
557
- "description": "Binds all behavior needed to the menu after rendering.",
558
- "privacy": "private",
559
- "return": {
560
- "type": {
561
- "text": "void"
562
- }
563
- }
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
564
468
  },
565
469
  {
566
- "kind": "method",
567
- "name": "configureInput",
568
- "description": "Binds all behavior needed to the input after rendering.",
569
- "privacy": "private",
570
- "return": {
571
- "type": {
572
- "text": "void"
573
- }
574
- }
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"
575
478
  },
576
479
  {
577
- "kind": "method",
578
- "name": "handleMenuLoadingChange",
579
- "parameters": [
580
- {
581
- "name": "event",
582
- "description": "The event object containing details about the loading state change.",
583
- "type": {
584
- "text": "CustomEvent"
585
- }
586
- },
587
- {
588
- "description": "Indicates whether the menu is currently loading.",
589
- "name": "event.detail.loading",
590
- "type": {
591
- "text": "boolean"
592
- }
593
- },
594
- {
595
- "description": "Indicates if there are loading placeholders present.",
596
- "name": "event.detail.hasLoadingPlaceholder",
597
- "type": {
598
- "text": "boolean"
599
- }
600
- }
601
- ],
602
- "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.",
603
- "privacy": "private",
604
- "return": {
605
- "type": {
606
- "text": "void"
607
- }
608
- }
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"
609
488
  },
610
489
  {
611
- "kind": "method",
612
- "name": "handleInputValueChange",
613
- "parameters": [
614
- {
615
- "name": "event",
616
- "description": "The input event triggered by the input element.",
617
- "type": {
618
- "text": "Event"
619
- }
620
- }
621
- ],
622
- "description": "Handle changes to the input value and trigger changes that should result.",
623
- "privacy": "private",
624
- "return": {
625
- "type": {
626
- "text": "void"
627
- }
628
- }
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"
629
498
  },
630
499
  {
631
- "kind": "method",
632
- "name": "handleTriggerInputValueChange",
633
- "parameters": [
634
- {
635
- "name": "event",
636
- "description": "The input event from the trigger input element.",
637
- "type": {
638
- "text": "Event"
639
- }
640
- }
641
- ],
642
- "description": "Handles input value changes originating from the trigger input.\nRefreshes menu options and filtering, delegates to handleInputValueChange\nfor value synchronization, and manages fullscreen bib focus.",
643
- "privacy": "private",
644
- "return": {
645
- "type": {
646
- "text": "void"
647
- }
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"
648
516
  }
649
517
  },
650
518
  {
651
- "kind": "method",
652
- "name": "configureCombobox",
653
- "description": "Binds all behavior needed to the combobox after rendering.",
654
- "privacy": "private",
655
- "return": {
656
- "type": {
657
- "text": "void"
658
- }
659
- }
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"
660
532
  },
661
533
  {
662
- "kind": "method",
663
- "name": "focus",
664
- "description": "Focuses the combobox trigger input.",
665
- "return": {
666
- "type": {
667
- "text": "void"
668
- }
669
- }
534
+ "name": "disabled",
535
+ "type": {
536
+ "text": "boolean"
537
+ },
538
+ "description": "If set, disables the checkbox group.",
539
+ "fieldName": "disabled"
670
540
  },
671
541
  {
672
- "kind": "method",
673
- "name": "setMenuValue",
674
- "parameters": [
675
- {
676
- "name": "value",
677
- "description": "The value to set on the menu.",
678
- "type": {
679
- "text": "string"
680
- }
681
- }
682
- ],
683
- "description": "Sets the menu value if menu is available.",
684
- "return": {
685
- "type": {
686
- "text": "void"
687
- }
688
- }
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"
689
548
  },
690
549
  {
691
- "kind": "method",
692
- "name": "reset",
693
- "description": "Resets component to initial state.",
694
- "return": {
695
- "type": {
696
- "text": "void"
697
- }
698
- }
550
+ "name": "horizontal",
551
+ "type": {
552
+ "text": "boolean"
553
+ },
554
+ "description": "If set, checkboxes will be aligned horizontally.",
555
+ "fieldName": "horizontal"
699
556
  },
700
557
  {
701
- "kind": "method",
702
- "name": "clear",
703
- "description": "Clears the current value of the combobox.",
704
- "return": {
705
- "type": {
706
- "text": "void"
707
- }
708
- }
558
+ "name": "noValidate",
559
+ "type": {
560
+ "text": "boolean"
561
+ },
562
+ "description": "If set, disables auto-validation on blur.",
563
+ "fieldName": "noValidate"
709
564
  },
710
565
  {
711
- "kind": "method",
712
- "name": "validate",
713
- "parameters": [
714
- {
715
- "name": "force",
716
- "default": "false",
717
- "description": "Whether to force validation.",
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
+ {
663
+ "kind": "method",
664
+ "name": "_initializeDefaults"
665
+ },
666
+ {
667
+ "kind": "method",
668
+ "name": "register",
669
+ "static": true,
670
+ "parameters": [
671
+ {
672
+ "name": "name",
673
+ "default": "\"auro-checkbox\"",
674
+ "description": "The name of element that you want to register to.",
718
675
  "optional": true,
719
676
  "type": {
720
- "text": "boolean"
677
+ "text": "string"
721
678
  }
722
679
  }
723
680
  ],
724
- "description": "Validates value."
681
+ "description": "This will register this element with the browser."
725
682
  },
726
683
  {
727
684
  "kind": "method",
728
- "name": "transportAssignedNodes",
685
+ "name": "handleChange",
729
686
  "parameters": [
730
687
  {
731
- "name": "slot",
732
- "description": "The slot element containing the nodes to apply.",
733
- "type": {
734
- "text": "HTMLSlotElement"
735
- }
736
- },
737
- {
738
- "name": "target",
739
- "description": "The target element to apply the nodes to.",
740
- "type": {
741
- "text": "HTMLElement"
742
- }
743
- },
744
- {
745
- "name": "newSlotName",
746
- "description": "The new slot name for the applied nodes.",
688
+ "name": "event",
689
+ "description": "The change event from the checkbox input.",
747
690
  "type": {
748
- "text": "string"
691
+ "text": "Event"
749
692
  }
750
693
  }
751
694
  ],
752
- "description": "Applies slotted nodes to a target element with a new slot name.",
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.",
753
696
  "privacy": "private",
754
697
  "return": {
755
698
  "type": {
@@ -759,31 +702,80 @@
759
702
  },
760
703
  {
761
704
  "kind": "method",
762
- "name": "updateActiveOption",
705
+ "name": "handleInput",
763
706
  "parameters": [
764
707
  {
765
- "name": "index",
766
- "description": "Index of the option to make active.",
708
+ "name": "event",
709
+ "description": "The input event from the checkbox input.",
767
710
  "type": {
768
- "text": "number"
711
+ "text": "Event"
769
712
  }
770
713
  }
771
714
  ],
772
- "description": "Updates the active option in the menu."
715
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
716
+ "privacy": "private",
717
+ "return": {
718
+ "type": {
719
+ "text": "void"
720
+ }
721
+ }
773
722
  },
774
723
  {
775
724
  "kind": "method",
776
- "name": "handleSlotChange",
725
+ "name": "handleFocusin",
726
+ "description": "Function to support",
727
+ "privacy": "private",
728
+ "return": {
729
+ "type": {
730
+ "text": "void"
731
+ }
732
+ }
733
+ },
734
+ {
735
+ "kind": "method",
736
+ "name": "generateIconHtml",
737
+ "description": "Function to generate checkmark svg.",
738
+ "privacy": "private",
739
+ "return": {
740
+ "type": {
741
+ "text": "HTMLElement"
742
+ }
743
+ }
744
+ },
745
+ {
746
+ "kind": "method",
747
+ "name": "reset",
748
+ "description": "Resets component to initial state.",
749
+ "return": {
750
+ "type": {
751
+ "text": "void"
752
+ }
753
+ }
754
+ },
755
+ {
756
+ "kind": "method",
757
+ "name": "updateAriaLabel",
758
+ "description": "Updates the aria-label based on slot content.",
759
+ "privacy": "private",
760
+ "return": {
761
+ "type": {
762
+ "text": "void"
763
+ }
764
+ }
765
+ },
766
+ {
767
+ "kind": "method",
768
+ "name": "handleKeyDown",
777
769
  "parameters": [
778
770
  {
779
771
  "name": "event",
780
- "description": "`slotchange` event.",
772
+ "description": "The keydown event from the checkbox input.",
781
773
  "type": {
782
- "text": "Event"
774
+ "text": "KeyboardEvent"
783
775
  }
784
776
  }
785
777
  ],
786
- "description": "Watch for slot changes and recalculate the menuoptions.",
778
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
787
779
  "privacy": "private",
788
780
  "return": {
789
781
  "type": {
@@ -796,7 +788,7 @@
796
788
  "name": "appearance",
797
789
  "privacy": "public",
798
790
  "type": {
799
- "text": "string"
791
+ "text": "'default' | 'inverse'"
800
792
  },
801
793
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
802
794
  "default": "'default'",
@@ -805,982 +797,816 @@
805
797
  },
806
798
  {
807
799
  "kind": "field",
808
- "name": "autocomplete",
800
+ "name": "checked",
809
801
  "privacy": "public",
810
802
  "type": {
811
- "text": "string"
803
+ "text": "boolean"
812
804
  },
813
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
814
- "attribute": "autocomplete",
805
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
806
+ "attribute": "checked",
815
807
  "reflects": true
816
808
  },
817
809
  {
818
810
  "kind": "field",
819
- "name": "autoPlacement",
811
+ "name": "disabled",
820
812
  "privacy": "public",
821
813
  "type": {
822
814
  "text": "boolean"
823
815
  },
824
- "description": "If declared, bib's position will be automatically calculated where to appear.",
825
- "attribute": "autoPlacement",
816
+ "description": "If set to true, the checkbox will not be clickable.",
817
+ "attribute": "disabled",
826
818
  "reflects": true
827
819
  },
828
820
  {
829
821
  "kind": "field",
830
- "name": "availableOptions",
831
- "privacy": "private",
822
+ "name": "error",
823
+ "privacy": "public",
832
824
  "type": {
833
- "text": "array"
825
+ "text": "boolean"
834
826
  },
835
- "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).",
836
- "attribute": "availableOptions"
827
+ "description": "If set to true, the checkbox will be displayed with an error state.",
828
+ "attribute": "error",
829
+ "reflects": true
837
830
  },
838
831
  {
839
832
  "kind": "field",
840
- "name": "behavior",
833
+ "name": "id",
841
834
  "privacy": "public",
842
835
  "type": {
843
- "text": "'filter' | 'suggestion'"
836
+ "text": "string"
844
837
  },
845
- "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.",
846
- "default": "'suggestion'",
847
- "attribute": "behavior",
838
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
839
+ "attribute": "id",
848
840
  "reflects": true
849
841
  },
850
842
  {
851
843
  "kind": "field",
852
- "name": "checkmark",
853
- "privacy": "public",
844
+ "name": "inputId",
845
+ "privacy": "private",
854
846
  "type": {
855
- "text": "boolean"
847
+ "text": "string"
856
848
  },
857
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
858
- "attribute": "checkmark",
859
- "reflects": true
849
+ "description": "The id for input node."
860
850
  },
861
851
  {
862
852
  "kind": "field",
863
- "name": "disabled",
853
+ "name": "name",
864
854
  "privacy": "public",
865
855
  "type": {
866
- "text": "boolean"
856
+ "text": "string"
867
857
  },
868
- "description": "If set, disables the combobox.",
869
- "attribute": "disabled",
870
- "reflects": true
871
- },
872
- {
873
- "kind": "field",
874
- "name": "dropdownId",
875
- "privacy": "private",
876
- "type": {
877
- "text": "string"
878
- },
879
- "description": "ID for the dropdown."
858
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
859
+ "attribute": "name"
880
860
  },
881
861
  {
882
862
  "kind": "field",
883
- "name": "dropdownOpen",
884
- "privacy": "private",
863
+ "name": "onDark",
864
+ "privacy": "public",
885
865
  "type": {
886
866
  "text": "boolean"
887
867
  },
888
- "description": "Whether or not the dropdown is open."
868
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
869
+ "attribute": "onDark",
870
+ "reflects": true
889
871
  },
890
872
  {
891
873
  "kind": "field",
892
- "name": "dvInputOnly",
893
- "privacy": "public",
874
+ "name": "touched",
875
+ "privacy": "private",
894
876
  "type": {
895
877
  "text": "boolean"
896
878
  },
897
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
898
- "attribute": "dvInputOnly",
899
- "reflects": true
879
+ "description": "Indicates whether the checkbox has been interacted with."
900
880
  },
901
881
  {
902
882
  "kind": "field",
903
- "name": "error",
883
+ "name": "value",
904
884
  "privacy": "public",
905
885
  "type": {
906
886
  "text": "string"
907
887
  },
908
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
909
- "attribute": "error",
910
- "reflects": true
888
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
889
+ "attribute": "value"
911
890
  },
912
891
  {
913
892
  "kind": "field",
914
- "name": "format",
915
- "privacy": "public",
893
+ "name": "tabIndex",
894
+ "privacy": "private",
916
895
  "type": {
917
- "text": "string"
896
+ "text": "number"
918
897
  },
919
- "description": "Specifies the input mask format.",
920
- "attribute": "format",
898
+ "description": "The tabindex attribute for the checkbox.",
899
+ "attribute": "tabindex",
921
900
  "reflects": true
922
901
  },
923
902
  {
924
903
  "kind": "field",
925
- "name": "inputmode",
926
- "privacy": "public",
904
+ "name": "ariaChecked",
905
+ "privacy": "private",
927
906
  "type": {
928
907
  "text": "string"
929
908
  },
930
- "description": "Exposes inputmode attribute for input.",
931
- "attribute": "inputmode",
909
+ "description": "The aria-checked attribute for the checkbox.",
910
+ "attribute": "aria-checked",
932
911
  "reflects": true
933
912
  },
934
913
  {
935
914
  "kind": "field",
936
- "name": "layout",
937
- "privacy": "public",
915
+ "name": "ariaDisabled",
916
+ "privacy": "private",
938
917
  "type": {
939
918
  "text": "string"
940
919
  },
941
- "description": "Sets the layout of the combobox.",
942
- "default": "'classic'",
943
- "attribute": "layout",
944
- "reflects": true,
945
- "inheritedFrom": {
946
- "name": "AuroElement",
947
- "module": "components/layoutElement/src/auroElement.js"
948
- }
920
+ "description": "The aria-disabled attribute for the checkbox.",
921
+ "attribute": "aria-disabled",
922
+ "reflects": true
949
923
  },
950
924
  {
951
925
  "kind": "field",
952
- "name": "matchWidth",
926
+ "name": "role",
953
927
  "privacy": "private",
954
928
  "type": {
955
- "text": "boolean"
929
+ "text": "string"
956
930
  },
957
- "description": "If declared, the popover and trigger will be set to the same width.",
958
- "attribute": "matchWidth",
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",
959
933
  "reflects": true
960
- },
934
+ }
935
+ ],
936
+ "events": [
961
937
  {
962
- "kind": "field",
963
- "name": "noFilter",
964
- "privacy": "public",
938
+ "name": "auroCheckbox-input",
965
939
  "type": {
966
- "text": "boolean"
967
- },
968
- "description": "If set, combobox will not filter menuoptions based on input.",
969
- "attribute": "noFilter",
970
- "reflects": true
940
+ "text": "CustomEvent"
941
+ }
971
942
  },
972
943
  {
973
- "kind": "field",
974
- "name": "noFlip",
975
- "privacy": "public",
944
+ "name": "auroCheckbox-focusin",
976
945
  "type": {
977
- "text": "boolean"
978
- },
979
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
980
- "attribute": "noFlip",
981
- "reflects": true
946
+ "text": "CustomEvent"
947
+ }
982
948
  },
983
949
  {
984
- "kind": "field",
985
- "name": "shift",
986
- "privacy": "public",
950
+ "name": "auroCheckbox-focusout",
987
951
  "type": {
988
- "text": "boolean"
989
- },
990
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
991
- "attribute": "shift",
992
- "reflects": true
952
+ "text": "CustomEvent"
953
+ }
993
954
  },
994
955
  {
995
- "kind": "field",
996
- "name": "noValidate",
997
- "privacy": "public",
998
- "type": {
999
- "text": "boolean"
1000
- },
1001
- "description": "If set, disables auto-validation on blur.",
1002
- "attribute": "noValidate",
1003
- "reflects": true
956
+ "description": "(Deprecated) Notifies when checked value is changed.",
957
+ "name": "change"
1004
958
  },
1005
959
  {
1006
- "kind": "field",
1007
- "name": "offset",
1008
- "privacy": "public",
960
+ "description": "Notifies when when checked value is changed by user's interface.",
961
+ "name": "input"
962
+ }
963
+ ],
964
+ "attributes": [
965
+ {
966
+ "name": "appearance",
1009
967
  "type": {
1010
- "text": "number"
968
+ "text": "'default' | 'inverse'"
1011
969
  },
1012
- "description": "Gap between the trigger element and bib.",
1013
- "default": "0",
1014
- "attribute": "offset",
1015
- "reflects": true
970
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
971
+ "default": "'default'",
972
+ "fieldName": "appearance"
1016
973
  },
1017
974
  {
1018
- "kind": "field",
1019
- "name": "onDark",
1020
- "privacy": "public",
975
+ "name": "checked",
1021
976
  "type": {
1022
977
  "text": "boolean"
1023
978
  },
1024
- "attribute": "onDark",
1025
- "reflects": true,
1026
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1027
- "inheritedFrom": {
1028
- "name": "AuroElement",
1029
- "module": "components/layoutElement/src/auroElement.js"
1030
- }
979
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
980
+ "fieldName": "checked"
1031
981
  },
1032
982
  {
1033
- "kind": "field",
1034
- "name": "optionSelected",
1035
- "privacy": "public",
983
+ "name": "disabled",
1036
984
  "type": {
1037
- "text": "HTMLElement"
985
+ "text": "boolean"
1038
986
  },
1039
- "description": "Specifies the current selected option.",
1040
- "attribute": "optionSelected"
987
+ "description": "If set to true, the checkbox will not be clickable.",
988
+ "fieldName": "disabled"
1041
989
  },
1042
990
  {
1043
- "kind": "field",
1044
- "name": "persistInput",
1045
- "privacy": "public",
991
+ "name": "error",
1046
992
  "type": {
1047
993
  "text": "boolean"
1048
994
  },
1049
- "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.",
1050
- "attribute": "persistInput",
1051
- "reflects": true
995
+ "description": "If set to true, the checkbox will be displayed with an error state.",
996
+ "fieldName": "error"
1052
997
  },
1053
998
  {
1054
- "kind": "field",
1055
- "name": "placement",
1056
- "privacy": "public",
999
+ "name": "id",
1057
1000
  "type": {
1058
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1001
+ "text": "string"
1059
1002
  },
1060
- "description": "Position where the bib should appear relative to the trigger.",
1061
- "default": "'bottom-start'",
1062
- "attribute": "placement",
1063
- "reflects": true
1003
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
1004
+ "fieldName": "id"
1064
1005
  },
1065
1006
  {
1066
- "kind": "field",
1067
- "name": "placeholder",
1068
- "privacy": "public",
1007
+ "name": "name",
1069
1008
  "type": {
1070
1009
  "text": "string"
1071
1010
  },
1072
- "description": "Define custom placeholder text, only supported by date input formats.",
1073
- "attribute": "placeholder",
1074
- "reflects": true
1011
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
1012
+ "fieldName": "name"
1075
1013
  },
1076
1014
  {
1077
- "kind": "field",
1078
- "name": "required",
1079
- "privacy": "public",
1015
+ "name": "onDark",
1080
1016
  "type": {
1081
1017
  "text": "boolean"
1082
1018
  },
1083
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1084
- "attribute": "required",
1085
- "reflects": true
1019
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1020
+ "fieldName": "onDark"
1086
1021
  },
1087
1022
  {
1088
- "kind": "field",
1089
- "name": "setCustomValidity",
1090
- "privacy": "public",
1023
+ "name": "value",
1091
1024
  "type": {
1092
1025
  "text": "string"
1093
1026
  },
1094
- "description": "Sets a custom help text message to display for all validityStates.",
1095
- "attribute": "setCustomValidity"
1027
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1028
+ "fieldName": "value"
1096
1029
  },
1097
1030
  {
1098
- "kind": "field",
1099
- "name": "setCustomValidityCustomError",
1100
- "privacy": "public",
1031
+ "name": "tabindex",
1101
1032
  "type": {
1102
- "text": "string"
1033
+ "text": "number"
1103
1034
  },
1104
- "description": "Custom help text message to display when validity = `customError`.",
1105
- "attribute": "setCustomValidityCustomError"
1035
+ "description": "The tabindex attribute for the checkbox.",
1036
+ "fieldName": "tabIndex"
1106
1037
  },
1107
1038
  {
1108
- "kind": "field",
1109
- "name": "setCustomValidityValueMissing",
1110
- "privacy": "public",
1039
+ "name": "aria-checked",
1111
1040
  "type": {
1112
1041
  "text": "string"
1113
1042
  },
1114
- "description": "Custom help text message to display when validity = `valueMissing`.",
1115
- "attribute": "setCustomValidityValueMissing"
1043
+ "description": "The aria-checked attribute for the checkbox.",
1044
+ "fieldName": "ariaChecked"
1116
1045
  },
1117
1046
  {
1118
- "kind": "field",
1119
- "name": "setCustomValidityValueMissingFilter",
1120
- "privacy": "public",
1047
+ "name": "aria-disabled",
1121
1048
  "type": {
1122
1049
  "text": "string"
1123
1050
  },
1124
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1125
- "attribute": "setCustomValidityValueMissingFilter"
1126
- },
1127
- {
1128
- "kind": "field",
1129
- "name": "touched",
1130
- "privacy": "private",
1131
- "type": {
1132
- "text": "boolean"
1133
- },
1134
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1051
+ "description": "The aria-disabled attribute for the checkbox.",
1052
+ "fieldName": "ariaDisabled"
1135
1053
  },
1136
1054
  {
1137
- "kind": "field",
1138
- "name": "triggerIcon",
1139
- "privacy": "public",
1055
+ "name": "role",
1140
1056
  "type": {
1141
- "text": "boolean"
1057
+ "text": "string"
1142
1058
  },
1143
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1144
- "attribute": "triggerIcon",
1145
- "reflects": true
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": ""
1146
1123
  },
1147
1124
  {
1148
- "kind": "field",
1149
- "name": "type",
1150
- "privacy": "public",
1151
1125
  "type": {
1152
- "text": "string"
1126
+ "text": "HTMLSlotElement"
1153
1127
  },
1154
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1155
- "attribute": "type",
1156
- "reflects": true
1128
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1129
+ "name": "optionalLabel"
1157
1130
  },
1158
1131
  {
1159
- "kind": "field",
1160
- "name": "typedValue",
1161
- "privacy": "public",
1162
- "type": {
1163
- "text": "string"
1164
- },
1165
- "description": "Specifies the value of the input element within the combobox.",
1166
- "attribute": "typedValue",
1167
- "reflects": true
1132
+ "description": "Sets aria-label on clear button",
1133
+ "name": "ariaLabel.input.clear"
1168
1134
  },
1169
1135
  {
1170
- "kind": "field",
1171
- "name": "validity",
1172
- "privacy": "public",
1173
- "type": {
1174
- "text": "string"
1175
- },
1176
- "description": "Specifies the `validityState` this element is in.",
1177
- "attribute": "validity",
1178
- "reflects": true
1136
+ "description": "Sets aria-label on close button in fullscreen bib",
1137
+ "name": "ariaLabel.bib.close"
1179
1138
  },
1180
1139
  {
1181
- "kind": "field",
1182
- "name": "value",
1183
- "privacy": "public",
1184
- "type": {
1185
- "text": "string"
1186
- },
1187
- "description": "Value selected for the dropdown menu.",
1188
- "attribute": "value"
1140
+ "description": "Defines the headline to display above menu-options",
1141
+ "name": "bib.fullscreen.headline"
1189
1142
  },
1190
1143
  {
1191
- "kind": "field",
1192
- "name": "largeFullscreenHeadline",
1193
- "privacy": "public",
1194
- "type": {
1195
- "text": "boolean"
1196
- },
1197
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1198
- "attribute": "largeFullscreenHeadline",
1199
- "reflects": true
1144
+ "description": "Defines the content of the label.",
1145
+ "name": "label"
1200
1146
  },
1201
1147
  {
1202
- "kind": "field",
1203
- "name": "fullscreenBreakpoint",
1204
- "privacy": "public",
1205
- "type": {
1206
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1207
- },
1208
- "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.",
1209
- "default": "'sm'",
1210
- "attribute": "fullscreenBreakpoint",
1211
- "reflects": true
1148
+ "description": "Defines the content of the helpText.",
1149
+ "name": "helpText"
1212
1150
  },
1213
1151
  {
1214
- "kind": "field",
1215
- "name": "optionActive",
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",
1216
1160
  "privacy": "private",
1217
- "type": {
1218
- "text": "object"
1161
+ "return": {
1162
+ "type": {
1163
+ "text": "void"
1164
+ }
1165
+ }
1166
+ },
1167
+ {
1168
+ "kind": "method",
1169
+ "name": "_scheduleTimer",
1170
+ "parameters": [
1171
+ {
1172
+ "name": "fn",
1173
+ "description": "Callback to run.",
1174
+ "type": {
1175
+ "text": "Function"
1176
+ }
1177
+ },
1178
+ {
1179
+ "name": "ms",
1180
+ "description": "Delay in milliseconds.",
1181
+ "type": {
1182
+ "text": "number"
1183
+ }
1184
+ }
1185
+ ],
1186
+ "description": "Wraps setTimeout and records the timer id so disconnectedCallback\ncan cancel any outstanding callbacks. The id is removed from the set\nonce the callback fires so the set doesn't grow unbounded.",
1187
+ "return": {
1188
+ "type": {
1189
+ "text": "number"
1190
+ }
1219
1191
  },
1220
- "description": "Specifies the currently active option."
1192
+ "privacy": "private"
1221
1193
  },
1222
1194
  {
1223
1195
  "kind": "field",
1224
- "name": "componentHasFocus",
1225
- "description": "Returns true if the element has focus.",
1226
- "privacy": "private",
1196
+ "name": "inputValue",
1197
+ "description": "Returns the current value of the input element within the combobox.",
1227
1198
  "return": {
1228
1199
  "type": {
1229
- "text": "boolean"
1200
+ "text": "string|undefined"
1230
1201
  }
1231
1202
  },
1232
- "readonly": true,
1233
- "inheritedFrom": {
1234
- "name": "AuroElement",
1235
- "module": "components/layoutElement/src/auroElement.js"
1236
- }
1203
+ "readonly": true
1237
1204
  },
1238
1205
  {
1239
1206
  "kind": "method",
1240
- "name": "resetShapeClasses",
1241
- "inheritedFrom": {
1242
- "name": "AuroElement",
1243
- "module": "components/layoutElement/src/auroElement.js"
1207
+ "name": "isValid",
1208
+ "description": "Checks if the element is valid.",
1209
+ "return": {
1210
+ "type": {
1211
+ "text": "boolean"
1212
+ }
1244
1213
  }
1245
1214
  },
1246
1215
  {
1247
1216
  "kind": "method",
1248
- "name": "resetLayoutClasses",
1249
- "inheritedFrom": {
1250
- "name": "AuroElement",
1251
- "module": "components/layoutElement/src/auroElement.js"
1252
- }
1217
+ "name": "register",
1218
+ "static": true,
1219
+ "parameters": [
1220
+ {
1221
+ "name": "name",
1222
+ "default": "'auro-combobox'",
1223
+ "description": "The name of the element that you want to register.",
1224
+ "optional": true,
1225
+ "type": {
1226
+ "text": "string"
1227
+ }
1228
+ }
1229
+ ],
1230
+ "description": "This will register this element with the browser."
1253
1231
  },
1254
1232
  {
1255
1233
  "kind": "method",
1256
- "name": "updateComponentArchitecture",
1257
- "inheritedFrom": {
1258
- "name": "AuroElement",
1259
- "module": "components/layoutElement/src/auroElement.js"
1234
+ "name": "activateFirstEnabledAvailableOption",
1235
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
1236
+ "privacy": "private",
1237
+ "return": {
1238
+ "type": {
1239
+ "text": "void"
1240
+ }
1260
1241
  }
1261
1242
  },
1262
1243
  {
1263
- "kind": "field",
1264
- "name": "shape",
1265
- "privacy": "public",
1266
- "type": {
1267
- "text": "string"
1268
- },
1269
- "attribute": "shape",
1270
- "reflects": true,
1271
- "inheritedFrom": {
1272
- "name": "AuroElement",
1273
- "module": "components/layoutElement/src/auroElement.js"
1244
+ "kind": "method",
1245
+ "name": "activateLastEnabledAvailableOption",
1246
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
1247
+ "privacy": "private",
1248
+ "return": {
1249
+ "type": {
1250
+ "text": "void"
1251
+ }
1274
1252
  }
1275
1253
  },
1276
1254
  {
1277
- "kind": "field",
1278
- "name": "size",
1279
- "privacy": "public",
1280
- "type": {
1281
- "text": "string"
1282
- },
1283
- "attribute": "size",
1284
- "reflects": true,
1285
- "inheritedFrom": {
1286
- "name": "AuroElement",
1287
- "module": "components/layoutElement/src/auroElement.js"
1288
- }
1289
- }
1290
- ],
1291
- "events": [
1292
- {
1293
- "name": "inputValue",
1294
- "type": {
1295
- "text": "CustomEvent"
1296
- },
1297
- "description": "Notifies that the components internal HTML5 input value has changed."
1255
+ "kind": "method",
1256
+ "name": "updateFilter",
1257
+ "description": "Updates the filter for the available options based on the input value.",
1258
+ "privacy": "private"
1298
1259
  },
1299
1260
  {
1300
- "name": "input",
1301
- "type": {
1302
- "text": "CustomEvent"
1303
- },
1304
- "description": "Notifies that the component has a new value set."
1261
+ "kind": "method",
1262
+ "name": "syncValuesAndStates",
1263
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1264
+ "privacy": "private",
1265
+ "return": {
1266
+ "type": {
1267
+ "text": "void"
1268
+ }
1269
+ }
1305
1270
  },
1306
1271
  {
1307
- "name": "auroCombobox-valueSet",
1308
- "type": {
1309
- "text": "CustomEvent"
1310
- },
1311
- "description": "(Deprecated) Notifies that the component has a new value set."
1272
+ "kind": "method",
1273
+ "name": "updateTriggerTextDisplay",
1274
+ "parameters": [
1275
+ {
1276
+ "name": "label",
1277
+ "description": "The label of the selected option.",
1278
+ "type": {
1279
+ "text": "string"
1280
+ }
1281
+ }
1282
+ ],
1283
+ "description": "Update displayValue or input.value, it's called when making a selection.",
1284
+ "privacy": "private"
1312
1285
  },
1313
1286
  {
1314
- "description": "Notifies that the component value(s) have been validated.",
1315
- "name": "auroFormElement-validated"
1316
- }
1317
- ],
1318
- "attributes": [
1319
- {
1320
- "name": "appearance",
1321
- "type": {
1322
- "text": "string"
1287
+ "kind": "method",
1288
+ "name": "syncInputValuesAcrossTriggerAndBib",
1289
+ "parameters": [
1290
+ {
1291
+ "name": "nextValue",
1292
+ "description": "The value to write to both inputs.",
1293
+ "type": {
1294
+ "text": "string"
1295
+ }
1296
+ }
1297
+ ],
1298
+ "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.",
1299
+ "return": {
1300
+ "type": {
1301
+ "text": "Promise<void>"
1302
+ }
1323
1303
  },
1324
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1325
- "default": "'default'",
1326
- "fieldName": "appearance"
1304
+ "privacy": "private"
1327
1305
  },
1328
1306
  {
1329
- "name": "autocomplete",
1330
- "type": {
1331
- "text": "string"
1332
- },
1333
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1334
- "fieldName": "autocomplete"
1307
+ "kind": "method",
1308
+ "name": "handleMenuOptions",
1309
+ "parameters": [
1310
+ {
1311
+ "name": "{ preferComboboxValue = false }",
1312
+ "default": "{}"
1313
+ },
1314
+ {
1315
+ "description": "Optional flag bag.",
1316
+ "name": "options",
1317
+ "optional": true,
1318
+ "type": {
1319
+ "text": "@param {boolean} [options.preferComboboxValue=false] - When true,\n * handleMenuOptions matches the selected option against `this.value`\n * first instead of `this.input.value`. Needed on mount and re-mount\n * because under `persistInput` the consumer's typedValue prop can drift\n * from the framework value (Svelte `{#key}` re-mount after a swap, or\n * SPA preselect after route change) and the old input-first match would\n * then pick the stale text. Only handleSlotChange passes this; typing\n * and clearing paths keep the input-first match so user clears aren't\n * undone.\n * "
1320
+ }
1321
+ }
1322
+ ],
1323
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1324
+ "privacy": "private",
1325
+ "return": {
1326
+ "type": {
1327
+ "text": "void"
1328
+ }
1329
+ }
1335
1330
  },
1336
1331
  {
1337
- "name": "autoPlacement",
1338
- "type": {
1339
- "text": "boolean"
1340
- },
1341
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1342
- "fieldName": "autoPlacement"
1332
+ "kind": "method",
1333
+ "name": "generateOptionsArray",
1334
+ "description": "Determines the element error state based on the `required` attribute and input value.",
1335
+ "privacy": "private",
1336
+ "return": {
1337
+ "type": {
1338
+ "text": "void"
1339
+ }
1340
+ }
1343
1341
  },
1344
1342
  {
1345
- "name": "availableOptions",
1346
- "type": {
1347
- "text": "array"
1348
- },
1349
- "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).",
1350
- "fieldName": "availableOptions"
1343
+ "kind": "method",
1344
+ "name": "hideBib",
1345
+ "description": "Hides the dropdown bib if its open.",
1346
+ "return": {
1347
+ "type": {
1348
+ "text": "void"
1349
+ }
1350
+ }
1351
1351
  },
1352
1352
  {
1353
- "name": "behavior",
1354
- "type": {
1355
- "text": "'filter' | 'suggestion'"
1356
- },
1357
- "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.",
1358
- "default": "'suggestion'",
1359
- "fieldName": "behavior"
1353
+ "kind": "method",
1354
+ "name": "showBib",
1355
+ "description": "Shows the dropdown bib if there are options to show.",
1356
+ "return": {
1357
+ "type": {
1358
+ "text": "void"
1359
+ }
1360
+ }
1360
1361
  },
1361
1362
  {
1362
- "name": "checkmark",
1363
- "type": {
1364
- "text": "boolean"
1365
- },
1366
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1367
- "fieldName": "checkmark"
1363
+ "kind": "method",
1364
+ "name": "configureDropdown",
1365
+ "description": "Binds all behavior needed to the dropdown after rendering.",
1366
+ "privacy": "private",
1367
+ "return": {
1368
+ "type": {
1369
+ "text": "void"
1370
+ }
1371
+ }
1368
1372
  },
1369
1373
  {
1370
- "name": "disabled",
1371
- "type": {
1372
- "text": "boolean"
1373
- },
1374
- "description": "If set, disables the combobox.",
1375
- "fieldName": "disabled"
1374
+ "kind": "method",
1375
+ "name": "setClearBtnFocus",
1376
+ "privacy": "private"
1376
1377
  },
1377
1378
  {
1378
- "name": "dvInputOnly",
1379
- "type": {
1380
- "text": "boolean"
1381
- },
1382
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1383
- "fieldName": "dvInputOnly"
1379
+ "kind": "method",
1380
+ "name": "setTriggerInputFocus",
1381
+ "privacy": "private"
1384
1382
  },
1385
1383
  {
1386
- "name": "error",
1387
- "type": {
1388
- "text": "string"
1389
- },
1390
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1391
- "fieldName": "error"
1384
+ "kind": "method",
1385
+ "name": "setInputFocus",
1386
+ "privacy": "private"
1392
1387
  },
1393
1388
  {
1394
- "name": "format",
1395
- "type": {
1396
- "text": "string"
1397
- },
1398
- "description": "Specifies the input mask format.",
1399
- "fieldName": "format"
1389
+ "kind": "method",
1390
+ "name": "updateBibDialogRole",
1391
+ "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.",
1392
+ "privacy": "private"
1400
1393
  },
1401
1394
  {
1402
- "name": "inputmode",
1403
- "type": {
1404
- "text": "string"
1405
- },
1406
- "description": "Exposes inputmode attribute for input.",
1407
- "fieldName": "inputmode"
1395
+ "kind": "method",
1396
+ "name": "updateMenuShapeSize",
1397
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1398
+ "privacy": "private"
1408
1399
  },
1409
1400
  {
1410
- "name": "layout",
1411
- "type": {
1412
- "text": "string"
1413
- },
1414
- "description": "Sets the layout of the combobox.",
1415
- "default": "'classic'",
1416
- "fieldName": "layout",
1417
- "inheritedFrom": {
1418
- "name": "AuroElement",
1419
- "module": "components/layoutElement/src/auroElement.js"
1401
+ "kind": "method",
1402
+ "name": "_getAnnouncementRoot",
1403
+ "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.",
1404
+ "privacy": "private",
1405
+ "return": {
1406
+ "type": {
1407
+ "text": "ShadowRoot"
1408
+ }
1420
1409
  }
1421
1410
  },
1422
1411
  {
1423
- "name": "matchWidth",
1424
- "type": {
1425
- "text": "boolean"
1426
- },
1427
- "description": "If declared, the popover and trigger will be set to the same width.",
1428
- "fieldName": "matchWidth"
1412
+ "kind": "method",
1413
+ "name": "configureMenu",
1414
+ "description": "Binds all behavior needed to the menu after rendering.",
1415
+ "privacy": "private",
1416
+ "return": {
1417
+ "type": {
1418
+ "text": "void"
1419
+ }
1420
+ }
1429
1421
  },
1430
1422
  {
1431
- "name": "noFilter",
1432
- "type": {
1433
- "text": "boolean"
1434
- },
1435
- "description": "If set, combobox will not filter menuoptions based on input.",
1436
- "fieldName": "noFilter"
1423
+ "kind": "method",
1424
+ "name": "configureInput",
1425
+ "description": "Binds all behavior needed to the input after rendering.",
1426
+ "privacy": "private",
1427
+ "return": {
1428
+ "type": {
1429
+ "text": "void"
1430
+ }
1431
+ }
1437
1432
  },
1438
1433
  {
1439
- "name": "noFlip",
1440
- "type": {
1441
- "text": "boolean"
1442
- },
1443
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1444
- "fieldName": "noFlip"
1445
- },
1446
- {
1447
- "name": "shift",
1448
- "type": {
1449
- "text": "boolean"
1450
- },
1451
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1452
- "fieldName": "shift"
1453
- },
1454
- {
1455
- "name": "noValidate",
1456
- "type": {
1457
- "text": "boolean"
1458
- },
1459
- "description": "If set, disables auto-validation on blur.",
1460
- "fieldName": "noValidate"
1461
- },
1462
- {
1463
- "name": "offset",
1464
- "type": {
1465
- "text": "number"
1466
- },
1467
- "description": "Gap between the trigger element and bib.",
1468
- "default": "0",
1469
- "fieldName": "offset"
1470
- },
1471
- {
1472
- "name": "onDark",
1473
- "type": {
1474
- "text": "boolean"
1475
- },
1476
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1477
- "fieldName": "onDark"
1478
- },
1479
- {
1480
- "name": "optionSelected",
1481
- "type": {
1482
- "text": "HTMLElement"
1483
- },
1484
- "description": "Specifies the current selected option.",
1485
- "fieldName": "optionSelected"
1486
- },
1487
- {
1488
- "name": "persistInput",
1489
- "type": {
1490
- "text": "boolean"
1491
- },
1492
- "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.",
1493
- "fieldName": "persistInput"
1494
- },
1495
- {
1496
- "name": "placement",
1497
- "type": {
1498
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1499
- },
1500
- "description": "Position where the bib should appear relative to the trigger.",
1501
- "default": "'bottom-start'",
1502
- "fieldName": "placement"
1503
- },
1504
- {
1505
- "name": "placeholder",
1506
- "type": {
1507
- "text": "string"
1508
- },
1509
- "description": "Define custom placeholder text, only supported by date input formats.",
1510
- "fieldName": "placeholder"
1511
- },
1512
- {
1513
- "name": "required",
1514
- "type": {
1515
- "text": "boolean"
1516
- },
1517
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1518
- "fieldName": "required"
1519
- },
1520
- {
1521
- "name": "setCustomValidity",
1522
- "type": {
1523
- "text": "string"
1524
- },
1525
- "description": "Sets a custom help text message to display for all validityStates.",
1526
- "fieldName": "setCustomValidity"
1527
- },
1528
- {
1529
- "name": "setCustomValidityCustomError",
1530
- "type": {
1531
- "text": "string"
1532
- },
1533
- "description": "Custom help text message to display when validity = `customError`.",
1534
- "fieldName": "setCustomValidityCustomError"
1535
- },
1536
- {
1537
- "name": "setCustomValidityValueMissing",
1538
- "type": {
1539
- "text": "string"
1540
- },
1541
- "description": "Custom help text message to display when validity = `valueMissing`.",
1542
- "fieldName": "setCustomValidityValueMissing"
1543
- },
1544
- {
1545
- "name": "setCustomValidityValueMissingFilter",
1546
- "type": {
1547
- "text": "string"
1548
- },
1549
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1550
- "fieldName": "setCustomValidityValueMissingFilter"
1551
- },
1552
- {
1553
- "name": "triggerIcon",
1554
- "type": {
1555
- "text": "boolean"
1556
- },
1557
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1558
- "fieldName": "triggerIcon"
1559
- },
1560
- {
1561
- "name": "type",
1562
- "type": {
1563
- "text": "string"
1564
- },
1565
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1566
- "fieldName": "type"
1567
- },
1568
- {
1569
- "name": "typedValue",
1570
- "type": {
1571
- "text": "string"
1572
- },
1573
- "description": "Specifies the value of the input element within the combobox.",
1574
- "fieldName": "typedValue"
1575
- },
1576
- {
1577
- "name": "validity",
1578
- "type": {
1579
- "text": "string"
1580
- },
1581
- "description": "Specifies the `validityState` this element is in.",
1582
- "fieldName": "validity"
1583
- },
1584
- {
1585
- "name": "value",
1586
- "type": {
1587
- "text": "string"
1588
- },
1589
- "description": "Value selected for the dropdown menu.",
1590
- "fieldName": "value"
1591
- },
1592
- {
1593
- "name": "largeFullscreenHeadline",
1594
- "type": {
1595
- "text": "boolean"
1596
- },
1597
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1598
- "fieldName": "largeFullscreenHeadline"
1599
- },
1600
- {
1601
- "name": "fullscreenBreakpoint",
1602
- "type": {
1603
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1604
- },
1605
- "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.",
1606
- "default": "'sm'",
1607
- "fieldName": "fullscreenBreakpoint"
1434
+ "kind": "method",
1435
+ "name": "handleMenuLoadingChange",
1436
+ "parameters": [
1437
+ {
1438
+ "name": "event",
1439
+ "description": "The event object containing details about the loading state change.",
1440
+ "type": {
1441
+ "text": "CustomEvent"
1442
+ }
1443
+ },
1444
+ {
1445
+ "description": "Indicates whether the menu is currently loading.",
1446
+ "name": "event.detail.loading",
1447
+ "type": {
1448
+ "text": "boolean"
1449
+ }
1450
+ },
1451
+ {
1452
+ "description": "Indicates if there are loading placeholders present.",
1453
+ "name": "event.detail.hasLoadingPlaceholder",
1454
+ "type": {
1455
+ "text": "boolean"
1456
+ }
1457
+ }
1458
+ ],
1459
+ "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.",
1460
+ "privacy": "private",
1461
+ "return": {
1462
+ "type": {
1463
+ "text": "void"
1464
+ }
1465
+ }
1608
1466
  },
1609
1467
  {
1610
- "name": "shape",
1611
- "type": {
1612
- "text": "string"
1613
- },
1614
- "fieldName": "shape",
1615
- "inheritedFrom": {
1616
- "name": "AuroElement",
1617
- "module": "components/layoutElement/src/auroElement.js"
1468
+ "kind": "method",
1469
+ "name": "handleInputValueChange",
1470
+ "parameters": [
1471
+ {
1472
+ "name": "event",
1473
+ "description": "The input event triggered by the input element.",
1474
+ "type": {
1475
+ "text": "Event"
1476
+ }
1477
+ }
1478
+ ],
1479
+ "description": "Handle changes to the input value and trigger changes that should result.",
1480
+ "privacy": "private",
1481
+ "return": {
1482
+ "type": {
1483
+ "text": "void"
1484
+ }
1618
1485
  }
1619
1486
  },
1620
1487
  {
1621
- "name": "size",
1622
- "type": {
1623
- "text": "string"
1624
- },
1625
- "fieldName": "size",
1626
- "inheritedFrom": {
1627
- "name": "AuroElement",
1628
- "module": "components/layoutElement/src/auroElement.js"
1488
+ "kind": "method",
1489
+ "name": "handleTriggerInputValueChange",
1490
+ "parameters": [
1491
+ {
1492
+ "name": "event",
1493
+ "description": "The input event from the trigger input element.",
1494
+ "type": {
1495
+ "text": "Event"
1496
+ }
1497
+ }
1498
+ ],
1499
+ "description": "Handles input value changes originating from the trigger input.\nRefreshes menu options and filtering, delegates to handleInputValueChange\nfor value synchronization, and manages fullscreen bib focus.",
1500
+ "privacy": "private",
1501
+ "return": {
1502
+ "type": {
1503
+ "text": "void"
1504
+ }
1629
1505
  }
1630
1506
  },
1631
1507
  {
1632
- "name": "ondark",
1633
- "type": {
1634
- "text": "boolean"
1635
- },
1636
- "fieldName": "onDark",
1637
- "inheritedFrom": {
1638
- "name": "AuroElement",
1639
- "module": "components/layoutElement/src/auroElement.js"
1508
+ "kind": "method",
1509
+ "name": "configureCombobox",
1510
+ "description": "Binds all behavior needed to the combobox after rendering.",
1511
+ "privacy": "private",
1512
+ "return": {
1513
+ "type": {
1514
+ "text": "void"
1515
+ }
1640
1516
  }
1641
- }
1642
- ],
1643
- "superclass": {
1644
- "name": "AuroElement",
1645
- "module": "/components/layoutElement/src/auroElement.js"
1646
- },
1647
- "tagName": "auro-combobox",
1648
- "customElement": true
1649
- }
1650
- ],
1651
- "exports": [
1652
- {
1653
- "kind": "js",
1654
- "name": "AuroCombobox",
1655
- "declaration": {
1656
- "name": "AuroCombobox",
1657
- "module": "components/combobox/src/auro-combobox.js"
1658
- }
1659
- }
1660
- ]
1661
- },
1662
- {
1663
- "kind": "javascript-module",
1664
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1665
- "declarations": [
1666
- {
1667
- "kind": "variable",
1668
- "name": "comboboxKeyboardStrategy",
1669
- "type": {
1670
- "text": "object"
1671
- },
1672
- "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'down'); } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'up'); } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { // Forms should not submit on Enter from a combobox, regardless of which // child element (input, clear button, menu) is focused. evt.stopPropagation(); if (isClearBtnFocused(ctx)) { // Let the browser dispatch Enter to the focused clear button so its // built-in activation fires and clears the selection. Do NOT call // preventDefault — that would block the activation. return; } if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); } else { evt.preventDefault(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // 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(); } } } }"
1673
- }
1674
- ],
1675
- "exports": [
1676
- {
1677
- "kind": "js",
1678
- "name": "comboboxKeyboardStrategy",
1679
- "declaration": {
1680
- "name": "comboboxKeyboardStrategy",
1681
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1682
- }
1683
- }
1684
- ]
1685
- },
1686
- {
1687
- "kind": "javascript-module",
1688
- "path": "components/combobox/src/index.js",
1689
- "declarations": [],
1690
- "exports": [
1691
- {
1692
- "kind": "js",
1693
- "name": "AuroCombobox",
1694
- "declaration": {
1695
- "name": "AuroCombobox",
1696
- "module": "components/combobox/src/index.js"
1697
- }
1698
- }
1699
- ]
1700
- },
1701
- {
1702
- "kind": "javascript-module",
1703
- "path": "components/combobox/src/registered.js",
1704
- "declarations": [],
1705
- "exports": [
1706
- {
1707
- "kind": "js",
1708
- "name": "AuroCombobox",
1709
- "declaration": {
1710
- "name": "AuroCombobox",
1711
- "module": "components/combobox/src/registered.js"
1712
- }
1713
- }
1714
- ]
1715
- },
1716
- {
1717
- "kind": "javascript-module",
1718
- "path": "components/checkbox/src/auro-checkbox-group.js",
1719
- "declarations": [
1720
- {
1721
- "kind": "class",
1722
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1723
- "name": "AuroCheckboxGroup",
1724
- "slots": [
1725
- {
1726
- "description": "Allows for the legend to be overridden.",
1727
- "name": "legend"
1728
1517
  },
1729
1518
  {
1730
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1731
- "name": "optionalLabel"
1519
+ "kind": "method",
1520
+ "name": "focus",
1521
+ "description": "Focuses the combobox trigger input.",
1522
+ "return": {
1523
+ "type": {
1524
+ "text": "void"
1525
+ }
1526
+ }
1732
1527
  },
1733
1528
  {
1734
- "description": "Allows for the helper text to be overridden.",
1735
- "name": "helpText"
1529
+ "kind": "method",
1530
+ "name": "setMenuValue",
1531
+ "parameters": [
1532
+ {
1533
+ "name": "value",
1534
+ "description": "The value to set on the menu.",
1535
+ "type": {
1536
+ "text": "string"
1537
+ }
1538
+ }
1539
+ ],
1540
+ "description": "Sets the menu value if menu is available.",
1541
+ "return": {
1542
+ "type": {
1543
+ "text": "void"
1544
+ }
1545
+ }
1736
1546
  },
1737
1547
  {
1738
- "description": "The default slot for the checkbox items.",
1739
- "name": "default"
1740
- }
1741
- ],
1742
- "members": [
1548
+ "kind": "method",
1549
+ "name": "reset",
1550
+ "description": "Resets component to initial state.",
1551
+ "return": {
1552
+ "type": {
1553
+ "text": "void"
1554
+ }
1555
+ }
1556
+ },
1743
1557
  {
1744
1558
  "kind": "method",
1745
- "name": "_initializeDefaults"
1559
+ "name": "clear",
1560
+ "description": "Clears the current value of the combobox.",
1561
+ "return": {
1562
+ "type": {
1563
+ "text": "void"
1564
+ }
1565
+ }
1746
1566
  },
1747
1567
  {
1748
1568
  "kind": "method",
1749
- "name": "register",
1750
- "static": true,
1569
+ "name": "validate",
1751
1570
  "parameters": [
1752
1571
  {
1753
- "name": "name",
1754
- "default": "\"auro-checkbox-group\"",
1755
- "description": "The name of the element that you want to register.",
1572
+ "name": "force",
1573
+ "default": "false",
1574
+ "description": "Whether to force validation.",
1756
1575
  "optional": true,
1757
1576
  "type": {
1758
- "text": "string"
1577
+ "text": "boolean"
1759
1578
  }
1760
1579
  }
1761
1580
  ],
1762
- "description": "This will register this element with the browser."
1581
+ "description": "Validates value."
1763
1582
  },
1764
1583
  {
1765
1584
  "kind": "method",
1766
- "name": "handleValueUpdate",
1585
+ "name": "transportAssignedNodes",
1767
1586
  "parameters": [
1768
1587
  {
1769
- "name": "value",
1770
- "description": "The value of the checkbox.",
1588
+ "name": "slot",
1589
+ "description": "The slot element containing the nodes to apply.",
1771
1590
  "type": {
1772
- "text": "String"
1591
+ "text": "HTMLSlotElement"
1773
1592
  }
1774
1593
  },
1775
1594
  {
1776
- "name": "selected",
1777
- "description": "The checked state of the checkbox.",
1595
+ "name": "target",
1596
+ "description": "The target element to apply the nodes to.",
1778
1597
  "type": {
1779
- "text": "Boolean"
1598
+ "text": "HTMLElement"
1599
+ }
1600
+ },
1601
+ {
1602
+ "name": "newSlotName",
1603
+ "description": "The new slot name for the applied nodes.",
1604
+ "type": {
1605
+ "text": "string"
1780
1606
  }
1781
1607
  }
1782
1608
  ],
1783
- "description": "Helper method to handle checkbox value changing.",
1609
+ "description": "Applies slotted nodes to a target element with a new slot name.",
1784
1610
  "privacy": "private",
1785
1611
  "return": {
1786
1612
  "type": {
@@ -1790,19 +1616,31 @@
1790
1616
  },
1791
1617
  {
1792
1618
  "kind": "method",
1793
- "name": "handlePreselectedItems",
1794
- "description": "Helper method that handles the state of preselected checkboxes.",
1795
- "privacy": "private",
1796
- "return": {
1797
- "type": {
1798
- "text": "void"
1619
+ "name": "updateActiveOption",
1620
+ "parameters": [
1621
+ {
1622
+ "name": "index",
1623
+ "description": "Index of the option to make active.",
1624
+ "type": {
1625
+ "text": "number"
1626
+ }
1799
1627
  }
1800
- }
1628
+ ],
1629
+ "description": "Updates the active option in the menu."
1801
1630
  },
1802
1631
  {
1803
1632
  "kind": "method",
1804
- "name": "handleItems",
1805
- "description": "Helper method that handles the state of checkboxes.",
1633
+ "name": "handleSlotChange",
1634
+ "parameters": [
1635
+ {
1636
+ "name": "event",
1637
+ "description": "`slotchange` event.",
1638
+ "type": {
1639
+ "text": "Event"
1640
+ }
1641
+ }
1642
+ ],
1643
+ "description": "Watch for slot changes and recalculate the menuoptions.",
1806
1644
  "privacy": "private",
1807
1645
  "return": {
1808
1646
  "type": {
@@ -1811,74 +1649,203 @@
1811
1649
  }
1812
1650
  },
1813
1651
  {
1814
- "kind": "method",
1815
- "name": "reset",
1816
- "description": "Resets component to initial state.",
1817
- "return": {
1818
- "type": {
1819
- "text": "void"
1820
- }
1821
- }
1652
+ "kind": "field",
1653
+ "name": "appearance",
1654
+ "privacy": "public",
1655
+ "type": {
1656
+ "text": "string"
1657
+ },
1658
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1659
+ "default": "'default'",
1660
+ "attribute": "appearance",
1661
+ "reflects": true
1822
1662
  },
1823
1663
  {
1824
- "kind": "method",
1825
- "name": "validate",
1826
- "parameters": [
1827
- {
1828
- "name": "force",
1829
- "default": "false",
1830
- "description": "Whether to force validation.",
1831
- "optional": true,
1832
- "type": {
1833
- "text": "boolean"
1834
- }
1835
- }
1836
- ],
1837
- "description": "Validates value."
1664
+ "kind": "field",
1665
+ "name": "autocomplete",
1666
+ "privacy": "public",
1667
+ "type": {
1668
+ "text": "string"
1669
+ },
1670
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1671
+ "attribute": "autocomplete",
1672
+ "reflects": true
1673
+ },
1674
+ {
1675
+ "kind": "field",
1676
+ "name": "autoPlacement",
1677
+ "privacy": "public",
1678
+ "type": {
1679
+ "text": "boolean"
1680
+ },
1681
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1682
+ "attribute": "autoPlacement",
1683
+ "reflects": true
1684
+ },
1685
+ {
1686
+ "kind": "field",
1687
+ "name": "availableOptions",
1688
+ "privacy": "private",
1689
+ "type": {
1690
+ "text": "array"
1691
+ },
1692
+ "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).",
1693
+ "attribute": "availableOptions"
1694
+ },
1695
+ {
1696
+ "kind": "field",
1697
+ "name": "behavior",
1698
+ "privacy": "public",
1699
+ "type": {
1700
+ "text": "'filter' | 'suggestion'"
1701
+ },
1702
+ "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.",
1703
+ "default": "'suggestion'",
1704
+ "attribute": "behavior",
1705
+ "reflects": true
1706
+ },
1707
+ {
1708
+ "kind": "field",
1709
+ "name": "checkmark",
1710
+ "privacy": "public",
1711
+ "type": {
1712
+ "text": "boolean"
1713
+ },
1714
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1715
+ "attribute": "checkmark",
1716
+ "reflects": true
1717
+ },
1718
+ {
1719
+ "kind": "field",
1720
+ "name": "disabled",
1721
+ "privacy": "public",
1722
+ "type": {
1723
+ "text": "boolean"
1724
+ },
1725
+ "description": "If set, disables the combobox.",
1726
+ "attribute": "disabled",
1727
+ "reflects": true
1728
+ },
1729
+ {
1730
+ "kind": "field",
1731
+ "name": "dropdownId",
1732
+ "privacy": "private",
1733
+ "type": {
1734
+ "text": "string"
1735
+ },
1736
+ "description": "ID for the dropdown."
1737
+ },
1738
+ {
1739
+ "kind": "field",
1740
+ "name": "dropdownOpen",
1741
+ "privacy": "private",
1742
+ "type": {
1743
+ "text": "boolean"
1744
+ },
1745
+ "description": "Whether or not the dropdown is open."
1746
+ },
1747
+ {
1748
+ "kind": "field",
1749
+ "name": "dvInputOnly",
1750
+ "privacy": "public",
1751
+ "type": {
1752
+ "text": "boolean"
1753
+ },
1754
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1755
+ "attribute": "dvInputOnly",
1756
+ "reflects": true
1757
+ },
1758
+ {
1759
+ "kind": "field",
1760
+ "name": "error",
1761
+ "privacy": "public",
1762
+ "type": {
1763
+ "text": "string"
1764
+ },
1765
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1766
+ "attribute": "error",
1767
+ "reflects": true
1768
+ },
1769
+ {
1770
+ "kind": "field",
1771
+ "name": "format",
1772
+ "privacy": "public",
1773
+ "type": {
1774
+ "text": "string"
1775
+ },
1776
+ "description": "Specifies the input mask format.",
1777
+ "attribute": "format",
1778
+ "reflects": true
1779
+ },
1780
+ {
1781
+ "kind": "field",
1782
+ "name": "inputmode",
1783
+ "privacy": "public",
1784
+ "type": {
1785
+ "text": "string"
1786
+ },
1787
+ "description": "Exposes inputmode attribute for input.",
1788
+ "attribute": "inputmode",
1789
+ "reflects": true
1790
+ },
1791
+ {
1792
+ "kind": "field",
1793
+ "name": "layout",
1794
+ "privacy": "public",
1795
+ "type": {
1796
+ "text": "string"
1797
+ },
1798
+ "description": "Sets the layout of the combobox.",
1799
+ "default": "'classic'",
1800
+ "attribute": "layout",
1801
+ "reflects": true,
1802
+ "inheritedFrom": {
1803
+ "name": "AuroElement",
1804
+ "module": "components/layoutElement/src/auroElement.js"
1805
+ }
1838
1806
  },
1839
1807
  {
1840
1808
  "kind": "field",
1841
- "name": "appearance",
1842
- "privacy": "public",
1809
+ "name": "matchWidth",
1810
+ "privacy": "private",
1843
1811
  "type": {
1844
- "text": "'default' | 'inverse'"
1812
+ "text": "boolean"
1845
1813
  },
1846
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1847
- "default": "'default'",
1848
- "attribute": "appearance",
1814
+ "description": "If declared, the popover and trigger will be set to the same width.",
1815
+ "attribute": "matchWidth",
1849
1816
  "reflects": true
1850
1817
  },
1851
1818
  {
1852
1819
  "kind": "field",
1853
- "name": "disabled",
1820
+ "name": "noFilter",
1854
1821
  "privacy": "public",
1855
1822
  "type": {
1856
1823
  "text": "boolean"
1857
1824
  },
1858
- "description": "If set, disables the checkbox group.",
1859
- "attribute": "disabled",
1825
+ "description": "If set, combobox will not filter menuoptions based on input.",
1826
+ "attribute": "noFilter",
1860
1827
  "reflects": true
1861
1828
  },
1862
1829
  {
1863
1830
  "kind": "field",
1864
- "name": "error",
1831
+ "name": "noFlip",
1865
1832
  "privacy": "public",
1866
1833
  "type": {
1867
- "text": "string"
1834
+ "text": "boolean"
1868
1835
  },
1869
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1870
- "attribute": "error",
1836
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1837
+ "attribute": "noFlip",
1871
1838
  "reflects": true
1872
1839
  },
1873
1840
  {
1874
1841
  "kind": "field",
1875
- "name": "horizontal",
1842
+ "name": "shift",
1876
1843
  "privacy": "public",
1877
1844
  "type": {
1878
1845
  "text": "boolean"
1879
1846
  },
1880
- "description": "If set, checkboxes will be aligned horizontally.",
1881
- "attribute": "horizontal",
1847
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1848
+ "attribute": "shift",
1882
1849
  "reflects": true
1883
1850
  },
1884
1851
  {
@@ -1892,6 +1859,18 @@
1892
1859
  "attribute": "noValidate",
1893
1860
  "reflects": true
1894
1861
  },
1862
+ {
1863
+ "kind": "field",
1864
+ "name": "offset",
1865
+ "privacy": "public",
1866
+ "type": {
1867
+ "text": "number"
1868
+ },
1869
+ "description": "Gap between the trigger element and bib.",
1870
+ "default": "0",
1871
+ "attribute": "offset",
1872
+ "reflects": true
1873
+ },
1895
1874
  {
1896
1875
  "kind": "field",
1897
1876
  "name": "onDark",
@@ -1899,8 +1878,56 @@
1899
1878
  "type": {
1900
1879
  "text": "boolean"
1901
1880
  },
1902
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1903
1881
  "attribute": "onDark",
1882
+ "reflects": true,
1883
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1884
+ "inheritedFrom": {
1885
+ "name": "AuroElement",
1886
+ "module": "components/layoutElement/src/auroElement.js"
1887
+ }
1888
+ },
1889
+ {
1890
+ "kind": "field",
1891
+ "name": "optionSelected",
1892
+ "privacy": "public",
1893
+ "type": {
1894
+ "text": "HTMLElement"
1895
+ },
1896
+ "description": "Specifies the current selected option.",
1897
+ "attribute": "optionSelected"
1898
+ },
1899
+ {
1900
+ "kind": "field",
1901
+ "name": "persistInput",
1902
+ "privacy": "public",
1903
+ "type": {
1904
+ "text": "boolean"
1905
+ },
1906
+ "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.",
1907
+ "attribute": "persistInput",
1908
+ "reflects": true
1909
+ },
1910
+ {
1911
+ "kind": "field",
1912
+ "name": "placement",
1913
+ "privacy": "public",
1914
+ "type": {
1915
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1916
+ },
1917
+ "description": "Position where the bib should appear relative to the trigger.",
1918
+ "default": "'bottom-start'",
1919
+ "attribute": "placement",
1920
+ "reflects": true
1921
+ },
1922
+ {
1923
+ "kind": "field",
1924
+ "name": "placeholder",
1925
+ "privacy": "public",
1926
+ "type": {
1927
+ "text": "string"
1928
+ },
1929
+ "description": "Define custom placeholder text, only supported by date input formats.",
1930
+ "attribute": "placeholder",
1904
1931
  "reflects": true
1905
1932
  },
1906
1933
  {
@@ -1910,7 +1937,7 @@
1910
1937
  "type": {
1911
1938
  "text": "boolean"
1912
1939
  },
1913
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1940
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1914
1941
  "attribute": "required",
1915
1942
  "reflects": true
1916
1943
  },
@@ -1944,6 +1971,58 @@
1944
1971
  "description": "Custom help text message to display when validity = `valueMissing`.",
1945
1972
  "attribute": "setCustomValidityValueMissing"
1946
1973
  },
1974
+ {
1975
+ "kind": "field",
1976
+ "name": "setCustomValidityValueMissingFilter",
1977
+ "privacy": "public",
1978
+ "type": {
1979
+ "text": "string"
1980
+ },
1981
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1982
+ "attribute": "setCustomValidityValueMissingFilter"
1983
+ },
1984
+ {
1985
+ "kind": "field",
1986
+ "name": "touched",
1987
+ "privacy": "private",
1988
+ "type": {
1989
+ "text": "boolean"
1990
+ },
1991
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1992
+ },
1993
+ {
1994
+ "kind": "field",
1995
+ "name": "triggerIcon",
1996
+ "privacy": "public",
1997
+ "type": {
1998
+ "text": "boolean"
1999
+ },
2000
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2001
+ "attribute": "triggerIcon",
2002
+ "reflects": true
2003
+ },
2004
+ {
2005
+ "kind": "field",
2006
+ "name": "type",
2007
+ "privacy": "public",
2008
+ "type": {
2009
+ "text": "string"
2010
+ },
2011
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2012
+ "attribute": "type",
2013
+ "reflects": true
2014
+ },
2015
+ {
2016
+ "kind": "field",
2017
+ "name": "typedValue",
2018
+ "privacy": "public",
2019
+ "type": {
2020
+ "text": "string"
2021
+ },
2022
+ "description": "Specifies the value of the input element within the combobox.",
2023
+ "attribute": "typedValue",
2024
+ "reflects": true
2025
+ },
1947
2026
  {
1948
2027
  "kind": "field",
1949
2028
  "name": "validity",
@@ -1954,607 +2033,542 @@
1954
2033
  "description": "Specifies the `validityState` this element is in.",
1955
2034
  "attribute": "validity",
1956
2035
  "reflects": true
1957
- }
1958
- ],
1959
- "events": [
2036
+ },
1960
2037
  {
1961
- "name": "input",
2038
+ "kind": "field",
2039
+ "name": "value",
2040
+ "privacy": "public",
1962
2041
  "type": {
1963
- "text": "CustomEvent"
1964
- }
2042
+ "text": "string"
2043
+ },
2044
+ "description": "Value selected for the dropdown menu.",
2045
+ "attribute": "value"
1965
2046
  },
1966
2047
  {
1967
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
1968
- "name": "auroFormElement-validated"
1969
- }
1970
- ],
1971
- "attributes": [
2048
+ "kind": "field",
2049
+ "name": "largeFullscreenHeadline",
2050
+ "privacy": "public",
2051
+ "type": {
2052
+ "text": "boolean"
2053
+ },
2054
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2055
+ "attribute": "largeFullscreenHeadline",
2056
+ "reflects": true
2057
+ },
1972
2058
  {
1973
- "name": "appearance",
2059
+ "kind": "field",
2060
+ "name": "fullscreenBreakpoint",
2061
+ "privacy": "public",
1974
2062
  "type": {
1975
- "text": "'default' | 'inverse'"
2063
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1976
2064
  },
1977
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1978
- "default": "'default'",
1979
- "fieldName": "appearance"
2065
+ "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.",
2066
+ "default": "'sm'",
2067
+ "attribute": "fullscreenBreakpoint",
2068
+ "reflects": true
1980
2069
  },
1981
2070
  {
1982
- "name": "disabled",
2071
+ "kind": "field",
2072
+ "name": "optionActive",
2073
+ "privacy": "private",
1983
2074
  "type": {
1984
- "text": "boolean"
2075
+ "text": "object"
1985
2076
  },
1986
- "description": "If set, disables the checkbox group.",
1987
- "fieldName": "disabled"
2077
+ "description": "Specifies the currently active option."
2078
+ },
2079
+ {
2080
+ "kind": "field",
2081
+ "name": "componentHasFocus",
2082
+ "description": "Returns true if the element has focus.",
2083
+ "privacy": "private",
2084
+ "return": {
2085
+ "type": {
2086
+ "text": "boolean"
2087
+ }
2088
+ },
2089
+ "readonly": true,
2090
+ "inheritedFrom": {
2091
+ "name": "AuroElement",
2092
+ "module": "components/layoutElement/src/auroElement.js"
2093
+ }
2094
+ },
2095
+ {
2096
+ "kind": "method",
2097
+ "name": "resetShapeClasses",
2098
+ "inheritedFrom": {
2099
+ "name": "AuroElement",
2100
+ "module": "components/layoutElement/src/auroElement.js"
2101
+ }
2102
+ },
2103
+ {
2104
+ "kind": "method",
2105
+ "name": "resetLayoutClasses",
2106
+ "inheritedFrom": {
2107
+ "name": "AuroElement",
2108
+ "module": "components/layoutElement/src/auroElement.js"
2109
+ }
2110
+ },
2111
+ {
2112
+ "kind": "method",
2113
+ "name": "updateComponentArchitecture",
2114
+ "inheritedFrom": {
2115
+ "name": "AuroElement",
2116
+ "module": "components/layoutElement/src/auroElement.js"
2117
+ }
2118
+ },
2119
+ {
2120
+ "kind": "field",
2121
+ "name": "shape",
2122
+ "privacy": "public",
2123
+ "type": {
2124
+ "text": "string"
2125
+ },
2126
+ "attribute": "shape",
2127
+ "reflects": true,
2128
+ "inheritedFrom": {
2129
+ "name": "AuroElement",
2130
+ "module": "components/layoutElement/src/auroElement.js"
2131
+ }
1988
2132
  },
1989
2133
  {
1990
- "name": "error",
2134
+ "kind": "field",
2135
+ "name": "size",
2136
+ "privacy": "public",
1991
2137
  "type": {
1992
2138
  "text": "string"
1993
2139
  },
1994
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1995
- "fieldName": "error"
1996
- },
2140
+ "attribute": "size",
2141
+ "reflects": true,
2142
+ "inheritedFrom": {
2143
+ "name": "AuroElement",
2144
+ "module": "components/layoutElement/src/auroElement.js"
2145
+ }
2146
+ }
2147
+ ],
2148
+ "events": [
1997
2149
  {
1998
- "name": "horizontal",
2150
+ "name": "inputValue",
1999
2151
  "type": {
2000
- "text": "boolean"
2152
+ "text": "CustomEvent"
2001
2153
  },
2002
- "description": "If set, checkboxes will be aligned horizontally.",
2003
- "fieldName": "horizontal"
2154
+ "description": "Notifies that the components internal HTML5 input value has changed."
2004
2155
  },
2005
2156
  {
2006
- "name": "noValidate",
2157
+ "name": "input",
2007
2158
  "type": {
2008
- "text": "boolean"
2159
+ "text": "CustomEvent"
2009
2160
  },
2010
- "description": "If set, disables auto-validation on blur.",
2011
- "fieldName": "noValidate"
2161
+ "description": "Notifies that the component has a new value set."
2012
2162
  },
2013
2163
  {
2014
- "name": "onDark",
2164
+ "name": "auroCombobox-valueSet",
2015
2165
  "type": {
2016
- "text": "boolean"
2166
+ "text": "CustomEvent"
2017
2167
  },
2018
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2019
- "fieldName": "onDark"
2168
+ "description": "(Deprecated) Notifies that the component has a new value set."
2020
2169
  },
2021
2170
  {
2022
- "name": "required",
2023
- "type": {
2024
- "text": "boolean"
2025
- },
2026
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
2027
- "fieldName": "required"
2028
- },
2171
+ "description": "Notifies that the component value(s) have been validated.",
2172
+ "name": "auroFormElement-validated"
2173
+ }
2174
+ ],
2175
+ "attributes": [
2029
2176
  {
2030
- "name": "setCustomValidity",
2177
+ "name": "appearance",
2031
2178
  "type": {
2032
2179
  "text": "string"
2033
2180
  },
2034
- "description": "Sets a custom help text message to display for all validityStates.",
2035
- "fieldName": "setCustomValidity"
2181
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
2182
+ "default": "'default'",
2183
+ "fieldName": "appearance"
2036
2184
  },
2037
2185
  {
2038
- "name": "setCustomValidityCustomError",
2186
+ "name": "autocomplete",
2039
2187
  "type": {
2040
2188
  "text": "string"
2041
2189
  },
2042
- "description": "Custom help text message to display when validity = `customError`.",
2043
- "fieldName": "setCustomValidityCustomError"
2190
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2191
+ "fieldName": "autocomplete"
2044
2192
  },
2045
2193
  {
2046
- "name": "setCustomValidityValueMissing",
2194
+ "name": "autoPlacement",
2047
2195
  "type": {
2048
- "text": "string"
2196
+ "text": "boolean"
2049
2197
  },
2050
- "description": "Custom help text message to display when validity = `valueMissing`.",
2051
- "fieldName": "setCustomValidityValueMissing"
2198
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
2199
+ "fieldName": "autoPlacement"
2052
2200
  },
2053
2201
  {
2054
- "name": "validity",
2202
+ "name": "availableOptions",
2055
2203
  "type": {
2056
- "text": "string"
2204
+ "text": "array"
2057
2205
  },
2058
- "description": "Specifies the `validityState` this element is in.",
2059
- "fieldName": "validity"
2060
- }
2061
- ],
2062
- "superclass": {
2063
- "name": "LitElement",
2064
- "package": "lit"
2065
- },
2066
- "tagName": "auro-checkbox-group",
2067
- "customElement": true
2068
- }
2069
- ],
2070
- "exports": [
2071
- {
2072
- "kind": "js",
2073
- "name": "AuroCheckboxGroup",
2074
- "declaration": {
2075
- "name": "AuroCheckboxGroup",
2076
- "module": "components/checkbox/src/auro-checkbox-group.js"
2077
- }
2078
- }
2079
- ]
2080
- },
2081
- {
2082
- "kind": "javascript-module",
2083
- "path": "components/checkbox/src/auro-checkbox.js",
2084
- "declarations": [
2085
- {
2086
- "kind": "class",
2087
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2088
- "name": "AuroCheckbox",
2089
- "cssParts": [
2090
- {
2091
- "description": "apply css to a specific checkbox.",
2092
- "name": "checkbox"
2093
- },
2094
- {
2095
- "description": "apply css to a specific checkbox's input.",
2096
- "name": "checkbox-input"
2097
- },
2098
- {
2099
- "description": "apply css to a specific checkbox's label.",
2100
- "name": "checkbox-label"
2101
- }
2102
- ],
2103
- "slots": [
2104
- {
2105
- "description": "The default slot for the checkbox label.",
2106
- "name": "default"
2107
- }
2108
- ],
2109
- "members": [
2110
- {
2111
- "kind": "method",
2112
- "name": "_initializeDefaults"
2113
- },
2114
- {
2115
- "kind": "method",
2116
- "name": "register",
2117
- "static": true,
2118
- "parameters": [
2119
- {
2120
- "name": "name",
2121
- "default": "\"auro-checkbox\"",
2122
- "description": "The name of element that you want to register to.",
2123
- "optional": true,
2124
- "type": {
2125
- "text": "string"
2126
- }
2127
- }
2128
- ],
2129
- "description": "This will register this element with the browser."
2130
- },
2131
- {
2132
- "kind": "method",
2133
- "name": "handleChange",
2134
- "parameters": [
2135
- {
2136
- "name": "event",
2137
- "description": "The change event from the checkbox input.",
2138
- "type": {
2139
- "text": "Event"
2140
- }
2141
- }
2142
- ],
2143
- "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.",
2144
- "privacy": "private",
2145
- "return": {
2146
- "type": {
2147
- "text": "void"
2148
- }
2149
- }
2150
- },
2151
- {
2152
- "kind": "method",
2153
- "name": "handleInput",
2154
- "parameters": [
2155
- {
2156
- "name": "event",
2157
- "description": "The input event from the checkbox input.",
2158
- "type": {
2159
- "text": "Event"
2160
- }
2161
- }
2162
- ],
2163
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2164
- "privacy": "private",
2165
- "return": {
2166
- "type": {
2167
- "text": "void"
2168
- }
2169
- }
2170
- },
2171
- {
2172
- "kind": "method",
2173
- "name": "handleFocusin",
2174
- "description": "Function to support",
2175
- "privacy": "private",
2176
- "return": {
2177
- "type": {
2178
- "text": "void"
2179
- }
2180
- }
2181
- },
2182
- {
2183
- "kind": "method",
2184
- "name": "generateIconHtml",
2185
- "description": "Function to generate checkmark svg.",
2186
- "privacy": "private",
2187
- "return": {
2188
- "type": {
2189
- "text": "HTMLElement"
2190
- }
2191
- }
2192
- },
2193
- {
2194
- "kind": "method",
2195
- "name": "reset",
2196
- "description": "Resets component to initial state.",
2197
- "return": {
2198
- "type": {
2199
- "text": "void"
2200
- }
2201
- }
2202
- },
2203
- {
2204
- "kind": "method",
2205
- "name": "updateAriaLabel",
2206
- "description": "Updates the aria-label based on slot content.",
2207
- "privacy": "private",
2208
- "return": {
2209
- "type": {
2210
- "text": "void"
2211
- }
2212
- }
2206
+ "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).",
2207
+ "fieldName": "availableOptions"
2213
2208
  },
2214
2209
  {
2215
- "kind": "method",
2216
- "name": "handleKeyDown",
2217
- "parameters": [
2218
- {
2219
- "name": "event",
2220
- "description": "The keydown event from the checkbox input.",
2221
- "type": {
2222
- "text": "KeyboardEvent"
2223
- }
2224
- }
2225
- ],
2226
- "description": "Handles keydown event to toggle the checkbox with Space key.",
2227
- "privacy": "private",
2228
- "return": {
2229
- "type": {
2230
- "text": "void"
2231
- }
2232
- }
2210
+ "name": "behavior",
2211
+ "type": {
2212
+ "text": "'filter' | 'suggestion'"
2213
+ },
2214
+ "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.",
2215
+ "default": "'suggestion'",
2216
+ "fieldName": "behavior"
2233
2217
  },
2234
2218
  {
2235
- "kind": "field",
2236
- "name": "appearance",
2237
- "privacy": "public",
2219
+ "name": "checkmark",
2238
2220
  "type": {
2239
- "text": "'default' | 'inverse'"
2221
+ "text": "boolean"
2240
2222
  },
2241
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2242
- "default": "'default'",
2243
- "attribute": "appearance",
2244
- "reflects": true
2223
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
2224
+ "fieldName": "checkmark"
2245
2225
  },
2246
2226
  {
2247
- "kind": "field",
2248
- "name": "checked",
2249
- "privacy": "public",
2227
+ "name": "disabled",
2250
2228
  "type": {
2251
2229
  "text": "boolean"
2252
2230
  },
2253
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2254
- "attribute": "checked",
2255
- "reflects": true
2231
+ "description": "If set, disables the combobox.",
2232
+ "fieldName": "disabled"
2256
2233
  },
2257
2234
  {
2258
- "kind": "field",
2259
- "name": "disabled",
2260
- "privacy": "public",
2235
+ "name": "dvInputOnly",
2261
2236
  "type": {
2262
2237
  "text": "boolean"
2263
2238
  },
2264
- "description": "If set to true, the checkbox will not be clickable.",
2265
- "attribute": "disabled",
2266
- "reflects": true
2239
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2240
+ "fieldName": "dvInputOnly"
2267
2241
  },
2268
2242
  {
2269
- "kind": "field",
2270
2243
  "name": "error",
2271
- "privacy": "public",
2272
2244
  "type": {
2273
- "text": "boolean"
2245
+ "text": "string"
2274
2246
  },
2275
- "description": "If set to true, the checkbox will be displayed with an error state.",
2276
- "attribute": "error",
2277
- "reflects": true
2247
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2248
+ "fieldName": "error"
2278
2249
  },
2279
2250
  {
2280
- "kind": "field",
2281
- "name": "id",
2282
- "privacy": "public",
2251
+ "name": "format",
2283
2252
  "type": {
2284
2253
  "text": "string"
2285
2254
  },
2286
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2287
- "attribute": "id",
2288
- "reflects": true
2255
+ "description": "Specifies the input mask format.",
2256
+ "fieldName": "format"
2289
2257
  },
2290
2258
  {
2291
- "kind": "field",
2292
- "name": "inputId",
2293
- "privacy": "private",
2259
+ "name": "inputmode",
2294
2260
  "type": {
2295
2261
  "text": "string"
2296
2262
  },
2297
- "description": "The id for input node."
2263
+ "description": "Exposes inputmode attribute for input.",
2264
+ "fieldName": "inputmode"
2298
2265
  },
2299
2266
  {
2300
- "kind": "field",
2301
- "name": "name",
2302
- "privacy": "public",
2267
+ "name": "layout",
2303
2268
  "type": {
2304
2269
  "text": "string"
2305
2270
  },
2306
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2307
- "attribute": "name"
2271
+ "description": "Sets the layout of the combobox.",
2272
+ "default": "'classic'",
2273
+ "fieldName": "layout",
2274
+ "inheritedFrom": {
2275
+ "name": "AuroElement",
2276
+ "module": "components/layoutElement/src/auroElement.js"
2277
+ }
2308
2278
  },
2309
2279
  {
2310
- "kind": "field",
2311
- "name": "onDark",
2312
- "privacy": "public",
2280
+ "name": "matchWidth",
2313
2281
  "type": {
2314
2282
  "text": "boolean"
2315
2283
  },
2316
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2317
- "attribute": "onDark",
2318
- "reflects": true
2284
+ "description": "If declared, the popover and trigger will be set to the same width.",
2285
+ "fieldName": "matchWidth"
2319
2286
  },
2320
2287
  {
2321
- "kind": "field",
2322
- "name": "touched",
2323
- "privacy": "private",
2288
+ "name": "noFilter",
2324
2289
  "type": {
2325
2290
  "text": "boolean"
2326
2291
  },
2327
- "description": "Indicates whether the checkbox has been interacted with."
2292
+ "description": "If set, combobox will not filter menuoptions based on input.",
2293
+ "fieldName": "noFilter"
2328
2294
  },
2329
2295
  {
2330
- "kind": "field",
2331
- "name": "value",
2332
- "privacy": "public",
2296
+ "name": "noFlip",
2333
2297
  "type": {
2334
- "text": "string"
2298
+ "text": "boolean"
2335
2299
  },
2336
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2337
- "attribute": "value"
2300
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2301
+ "fieldName": "noFlip"
2338
2302
  },
2339
2303
  {
2340
- "kind": "field",
2341
- "name": "tabIndex",
2342
- "privacy": "private",
2304
+ "name": "shift",
2305
+ "type": {
2306
+ "text": "boolean"
2307
+ },
2308
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2309
+ "fieldName": "shift"
2310
+ },
2311
+ {
2312
+ "name": "noValidate",
2313
+ "type": {
2314
+ "text": "boolean"
2315
+ },
2316
+ "description": "If set, disables auto-validation on blur.",
2317
+ "fieldName": "noValidate"
2318
+ },
2319
+ {
2320
+ "name": "offset",
2343
2321
  "type": {
2344
2322
  "text": "number"
2345
2323
  },
2346
- "description": "The tabindex attribute for the checkbox.",
2347
- "attribute": "tabindex",
2348
- "reflects": true
2324
+ "description": "Gap between the trigger element and bib.",
2325
+ "default": "0",
2326
+ "fieldName": "offset"
2349
2327
  },
2350
2328
  {
2351
- "kind": "field",
2352
- "name": "ariaChecked",
2353
- "privacy": "private",
2329
+ "name": "onDark",
2354
2330
  "type": {
2355
- "text": "string"
2331
+ "text": "boolean"
2356
2332
  },
2357
- "description": "The aria-checked attribute for the checkbox.",
2358
- "attribute": "aria-checked",
2359
- "reflects": true
2333
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2334
+ "fieldName": "onDark"
2360
2335
  },
2361
2336
  {
2362
- "kind": "field",
2363
- "name": "ariaDisabled",
2364
- "privacy": "private",
2337
+ "name": "optionSelected",
2365
2338
  "type": {
2366
- "text": "string"
2339
+ "text": "HTMLElement"
2367
2340
  },
2368
- "description": "The aria-disabled attribute for the checkbox.",
2369
- "attribute": "aria-disabled",
2370
- "reflects": true
2341
+ "description": "Specifies the current selected option.",
2342
+ "fieldName": "optionSelected"
2371
2343
  },
2372
2344
  {
2373
- "kind": "field",
2374
- "name": "role",
2375
- "privacy": "private",
2345
+ "name": "persistInput",
2376
2346
  "type": {
2377
- "text": "string"
2347
+ "text": "boolean"
2378
2348
  },
2379
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2380
- "attribute": "role",
2381
- "reflects": true
2382
- }
2383
- ],
2384
- "events": [
2349
+ "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.",
2350
+ "fieldName": "persistInput"
2351
+ },
2385
2352
  {
2386
- "name": "auroCheckbox-input",
2353
+ "name": "placement",
2387
2354
  "type": {
2388
- "text": "CustomEvent"
2389
- }
2355
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2356
+ },
2357
+ "description": "Position where the bib should appear relative to the trigger.",
2358
+ "default": "'bottom-start'",
2359
+ "fieldName": "placement"
2390
2360
  },
2391
2361
  {
2392
- "name": "auroCheckbox-focusin",
2362
+ "name": "placeholder",
2393
2363
  "type": {
2394
- "text": "CustomEvent"
2395
- }
2364
+ "text": "string"
2365
+ },
2366
+ "description": "Define custom placeholder text, only supported by date input formats.",
2367
+ "fieldName": "placeholder"
2396
2368
  },
2397
2369
  {
2398
- "name": "auroCheckbox-focusout",
2370
+ "name": "required",
2399
2371
  "type": {
2400
- "text": "CustomEvent"
2401
- }
2372
+ "text": "boolean"
2373
+ },
2374
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2375
+ "fieldName": "required"
2402
2376
  },
2403
2377
  {
2404
- "description": "(Deprecated) Notifies when checked value is changed.",
2405
- "name": "change"
2378
+ "name": "setCustomValidity",
2379
+ "type": {
2380
+ "text": "string"
2381
+ },
2382
+ "description": "Sets a custom help text message to display for all validityStates.",
2383
+ "fieldName": "setCustomValidity"
2406
2384
  },
2407
2385
  {
2408
- "description": "Notifies when when checked value is changed by user's interface.",
2409
- "name": "input"
2410
- }
2411
- ],
2412
- "attributes": [
2386
+ "name": "setCustomValidityCustomError",
2387
+ "type": {
2388
+ "text": "string"
2389
+ },
2390
+ "description": "Custom help text message to display when validity = `customError`.",
2391
+ "fieldName": "setCustomValidityCustomError"
2392
+ },
2413
2393
  {
2414
- "name": "appearance",
2394
+ "name": "setCustomValidityValueMissing",
2415
2395
  "type": {
2416
- "text": "'default' | 'inverse'"
2396
+ "text": "string"
2417
2397
  },
2418
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2419
- "default": "'default'",
2420
- "fieldName": "appearance"
2398
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2399
+ "fieldName": "setCustomValidityValueMissing"
2421
2400
  },
2422
2401
  {
2423
- "name": "checked",
2402
+ "name": "setCustomValidityValueMissingFilter",
2424
2403
  "type": {
2425
- "text": "boolean"
2404
+ "text": "string"
2426
2405
  },
2427
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2428
- "fieldName": "checked"
2406
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2407
+ "fieldName": "setCustomValidityValueMissingFilter"
2429
2408
  },
2430
2409
  {
2431
- "name": "disabled",
2410
+ "name": "triggerIcon",
2432
2411
  "type": {
2433
2412
  "text": "boolean"
2434
2413
  },
2435
- "description": "If set to true, the checkbox will not be clickable.",
2436
- "fieldName": "disabled"
2414
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2415
+ "fieldName": "triggerIcon"
2437
2416
  },
2438
2417
  {
2439
- "name": "error",
2418
+ "name": "type",
2440
2419
  "type": {
2441
- "text": "boolean"
2420
+ "text": "string"
2442
2421
  },
2443
- "description": "If set to true, the checkbox will be displayed with an error state.",
2444
- "fieldName": "error"
2422
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2423
+ "fieldName": "type"
2445
2424
  },
2446
2425
  {
2447
- "name": "id",
2426
+ "name": "typedValue",
2448
2427
  "type": {
2449
2428
  "text": "string"
2450
2429
  },
2451
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2452
- "fieldName": "id"
2430
+ "description": "Specifies the value of the input element within the combobox.",
2431
+ "fieldName": "typedValue"
2453
2432
  },
2454
2433
  {
2455
- "name": "name",
2434
+ "name": "validity",
2456
2435
  "type": {
2457
2436
  "text": "string"
2458
2437
  },
2459
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2460
- "fieldName": "name"
2438
+ "description": "Specifies the `validityState` this element is in.",
2439
+ "fieldName": "validity"
2461
2440
  },
2462
2441
  {
2463
- "name": "onDark",
2442
+ "name": "value",
2464
2443
  "type": {
2465
- "text": "boolean"
2444
+ "text": "string"
2466
2445
  },
2467
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2468
- "fieldName": "onDark"
2446
+ "description": "Value selected for the dropdown menu.",
2447
+ "fieldName": "value"
2469
2448
  },
2470
2449
  {
2471
- "name": "value",
2450
+ "name": "largeFullscreenHeadline",
2472
2451
  "type": {
2473
- "text": "string"
2452
+ "text": "boolean"
2474
2453
  },
2475
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2476
- "fieldName": "value"
2454
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2455
+ "fieldName": "largeFullscreenHeadline"
2477
2456
  },
2478
2457
  {
2479
- "name": "tabindex",
2458
+ "name": "fullscreenBreakpoint",
2480
2459
  "type": {
2481
- "text": "number"
2460
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2482
2461
  },
2483
- "description": "The tabindex attribute for the checkbox.",
2484
- "fieldName": "tabIndex"
2462
+ "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.",
2463
+ "default": "'sm'",
2464
+ "fieldName": "fullscreenBreakpoint"
2485
2465
  },
2486
2466
  {
2487
- "name": "aria-checked",
2467
+ "name": "shape",
2488
2468
  "type": {
2489
2469
  "text": "string"
2490
2470
  },
2491
- "description": "The aria-checked attribute for the checkbox.",
2492
- "fieldName": "ariaChecked"
2471
+ "fieldName": "shape",
2472
+ "inheritedFrom": {
2473
+ "name": "AuroElement",
2474
+ "module": "components/layoutElement/src/auroElement.js"
2475
+ }
2493
2476
  },
2494
2477
  {
2495
- "name": "aria-disabled",
2478
+ "name": "size",
2496
2479
  "type": {
2497
2480
  "text": "string"
2498
2481
  },
2499
- "description": "The aria-disabled attribute for the checkbox.",
2500
- "fieldName": "ariaDisabled"
2482
+ "fieldName": "size",
2483
+ "inheritedFrom": {
2484
+ "name": "AuroElement",
2485
+ "module": "components/layoutElement/src/auroElement.js"
2486
+ }
2501
2487
  },
2502
2488
  {
2503
- "name": "role",
2489
+ "name": "ondark",
2504
2490
  "type": {
2505
- "text": "string"
2491
+ "text": "boolean"
2506
2492
  },
2507
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2508
- "fieldName": "role"
2493
+ "fieldName": "onDark",
2494
+ "inheritedFrom": {
2495
+ "name": "AuroElement",
2496
+ "module": "components/layoutElement/src/auroElement.js"
2497
+ }
2509
2498
  }
2510
2499
  ],
2511
2500
  "superclass": {
2512
- "name": "LitElement",
2513
- "package": "lit"
2501
+ "name": "AuroElement",
2502
+ "module": "/components/layoutElement/src/auroElement.js"
2514
2503
  },
2515
- "tagName": "auro-checkbox",
2504
+ "tagName": "auro-combobox",
2516
2505
  "customElement": true
2517
2506
  }
2518
2507
  ],
2519
2508
  "exports": [
2520
2509
  {
2521
2510
  "kind": "js",
2522
- "name": "AuroCheckbox",
2511
+ "name": "AuroCombobox",
2523
2512
  "declaration": {
2524
- "name": "AuroCheckbox",
2525
- "module": "components/checkbox/src/auro-checkbox.js"
2513
+ "name": "AuroCombobox",
2514
+ "module": "components/combobox/src/auro-combobox.js"
2526
2515
  }
2527
2516
  }
2528
2517
  ]
2529
2518
  },
2530
2519
  {
2531
2520
  "kind": "javascript-module",
2532
- "path": "components/checkbox/src/index.js",
2533
- "declarations": [],
2521
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2522
+ "declarations": [
2523
+ {
2524
+ "kind": "variable",
2525
+ "name": "comboboxKeyboardStrategy",
2526
+ "type": {
2527
+ "text": "object"
2528
+ },
2529
+ "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'down'); } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'up'); } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { // Forms should not submit on Enter from a combobox, regardless of which // child element (input, clear button, menu) is focused. evt.stopPropagation(); if (isClearBtnFocused(ctx)) { // Let the browser dispatch Enter to the focused clear button so its // built-in activation fires and clears the selection. Do NOT call // preventDefault — that would block the activation. return; } if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); } else { evt.preventDefault(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // 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(); } } } }"
2530
+ }
2531
+ ],
2534
2532
  "exports": [
2535
2533
  {
2536
2534
  "kind": "js",
2537
- "name": "AuroCheckbox",
2535
+ "name": "comboboxKeyboardStrategy",
2538
2536
  "declaration": {
2539
- "name": "AuroCheckbox",
2540
- "module": "components/checkbox/src/index.js"
2537
+ "name": "comboboxKeyboardStrategy",
2538
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2541
2539
  }
2542
- },
2540
+ }
2541
+ ]
2542
+ },
2543
+ {
2544
+ "kind": "javascript-module",
2545
+ "path": "components/combobox/src/index.js",
2546
+ "declarations": [],
2547
+ "exports": [
2543
2548
  {
2544
2549
  "kind": "js",
2545
- "name": "AuroCheckboxGroup",
2550
+ "name": "AuroCombobox",
2546
2551
  "declaration": {
2547
- "name": "AuroCheckboxGroup",
2548
- "module": "components/checkbox/src/index.js"
2552
+ "name": "AuroCombobox",
2553
+ "module": "components/combobox/src/index.js"
2549
2554
  }
2550
2555
  }
2551
2556
  ]
2552
2557
  },
2553
2558
  {
2554
2559
  "kind": "javascript-module",
2555
- "path": "components/checkbox/src/registered.js",
2560
+ "path": "components/combobox/src/registered.js",
2556
2561
  "declarations": [],
2557
- "exports": []
2562
+ "exports": [
2563
+ {
2564
+ "kind": "js",
2565
+ "name": "AuroCombobox",
2566
+ "declaration": {
2567
+ "name": "AuroCombobox",
2568
+ "module": "components/combobox/src/registered.js"
2569
+ }
2570
+ }
2571
+ ]
2558
2572
  },
2559
2573
  {
2560
2574
  "kind": "javascript-module",
@@ -4621,6 +4635,17 @@
4621
4635
  }
4622
4636
  }
4623
4637
  },
4638
+ {
4639
+ "kind": "method",
4640
+ "name": "_initFromAncestors",
4641
+ "description": "Wires the cell to its ancestor calendar-month and calendar (and, via\nthe calendar, to the datepicker). Extracted from firstUpdated() so the\nretry loop can re-attempt without recursively invoking a Lit lifecycle\nmethod (which is outside the framework's contract).",
4642
+ "privacy": "private",
4643
+ "return": {
4644
+ "type": {
4645
+ "text": "void"
4646
+ }
4647
+ }
4648
+ },
4624
4649
  {
4625
4650
  "kind": "method",
4626
4651
  "name": "configurePopover",
@@ -5282,6 +5307,25 @@
5282
5307
  "description": "",
5283
5308
  "name": "AuroCalendar",
5284
5309
  "members": [
5310
+ {
5311
+ "kind": "field",
5312
+ "name": "disabledDays",
5313
+ "deprecated": "See constructor JSDoc — migrate to\n`auro-datepicker.blackoutDates`. The getter/setter pair exists so the\none-time deprecation warning fires as soon as a consumer assigns a\nnon-empty array (empty assignments are ignored — an empty array is\nindistinguishable from the constructor default and would produce a\nspurious warning), rather than only when `_getBlackoutSet()` happens\nto rebuild.",
5314
+ "return": {
5315
+ "type": {
5316
+ "text": "Array"
5317
+ }
5318
+ },
5319
+ "parameters": [
5320
+ {
5321
+ "description": "The legacy `disabledDays` array to set.",
5322
+ "name": "value",
5323
+ "type": {
5324
+ "text": "Array"
5325
+ }
5326
+ }
5327
+ ]
5328
+ },
5285
5329
  {
5286
5330
  "kind": "field",
5287
5331
  "name": "centralDateObject",
@@ -5556,7 +5600,7 @@
5556
5600
  {
5557
5601
  "kind": "method",
5558
5602
  "name": "_getBlackoutSet",
5559
- "description": "Returns a memoized Set of blackout timestamps (seconds) drawn from both\nthe legacy `disabledDays` array and the datepicker's ISO `blackoutDates`.\nThe cache invalidates when either source array's reference changes, which\nmatches Lit's own reactive identity semantics for array properties.",
5603
+ "description": "Returns a memoized Set of blackout timestamps (seconds) drawn from both\nthe legacy `disabledDays` array and the datepicker's ISO `blackoutDates`.\n\nThe cache invalidates on **reference identity** — only when the\nconsumer reassigns the array (`el.blackoutDates = [...]`), matching\nLit's own reactivity semantics for array properties. In-place mutations\non the existing array (`push`, `splice`, index assignment) will NOT\ninvalidate the cache and the new entries will be silently ignored.\nConsumers must reassign to update — see the JSDoc on\n`auro-datepicker.blackoutDates` for the recommended pattern.\n\nA shallow-equality tier was considered but rejected: it would run\nO(N) work on every cell render (this method is called per-cell via\n`isBlackout()`) and still wouldn't catch same-length value swaps,\noffering a false sense of safety.",
5560
5604
  "privacy": "private",
5561
5605
  "return": {
5562
5606
  "type": {
@@ -5932,7 +5976,7 @@
5932
5976
  }
5933
5977
  }
5934
5978
  ],
5935
- "description": "Debounced version of announceSelection for focus navigation.\nUses the assertive live region with a 150ms debounce so only the\nfinal cell after rapid arrow-key traversal is announced. We\noriginally tried aria-live=\"polite\" here, but VoiceOver treats\npolite as \"wait until idle\" — which never happens during active\nkeyboard navigation — so the announcements were silently dropped.",
5979
+ "description": "Debounced version of announceSelection for focus navigation.\nUses the assertive live region with a 150ms debounce so only the\nfinal cell after rapid arrow-key traversal is announced. We\noriginally tried aria-live=\"polite\" here, but VoiceOver treats\npolite as \"wait until idle\" — which never happens during active\nkeyboard navigation — so the announcements were silently dropped.\n\nThis is a documented deviation from WCAG 2.1 SC 4.1.3, which\nprefers `polite` for status messages. See the \"Documented\nDeviation\" section in components/datepicker/docs/pages/accessibility.md.",
5936
5980
  "privacy": "private",
5937
5981
  "return": {
5938
5982
  "type": {
@@ -6110,7 +6154,7 @@
6110
6154
  },
6111
6155
  {
6112
6156
  "kind": "field",
6113
- "name": "disabledDays",
6157
+ "name": "_disabledDays",
6114
6158
  "type": {
6115
6159
  "text": "array"
6116
6160
  },
@@ -7514,7 +7558,7 @@
7514
7558
  "type": {
7515
7559
  "text": "array"
7516
7560
  },
7517
- "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
7561
+ "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).\n\n**Immutable update required.** The datepicker treats this array as\nimmutable and memoizes a lookup Set keyed on the array's reference\nidentity — matching Lit's own reactivity semantics for array\nproperties. In-place mutations (`blackoutDates.push(...)`,\n`blackoutDates[i] = ...`, `blackoutDates.splice(...)`) will not\ninvalidate the cache and the new entries will be silently ignored.\nTo update, reassign the property: `el.blackoutDates = [...el.blackoutDates, '2024-12-25']`.",
7518
7562
  "default": "[]",
7519
7563
  "attribute": "blackoutDates",
7520
7564
  "reflects": true
@@ -8178,7 +8222,7 @@
8178
8222
  "type": {
8179
8223
  "text": "array"
8180
8224
  },
8181
- "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
8225
+ "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).\n\n**Immutable update required.** The datepicker treats this array as\nimmutable and memoizes a lookup Set keyed on the array's reference\nidentity — matching Lit's own reactivity semantics for array\nproperties. In-place mutations (`blackoutDates.push(...)`,\n`blackoutDates[i] = ...`, `blackoutDates.splice(...)`) will not\ninvalidate the cache and the new entries will be silently ignored.\nTo update, reassign the property: `el.blackoutDates = [...el.blackoutDates, '2024-12-25']`.",
8182
8226
  "default": "[]",
8183
8227
  "fieldName": "blackoutDates"
8184
8228
  },
@@ -8802,7 +8846,7 @@
8802
8846
  "type": {
8803
8847
  "text": "object"
8804
8848
  },
8805
- "default": "{ Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Stop propagation so parent containers (auro-dialog, auro-drawer) // don't also react to Escape. evt.stopPropagation(); evt.preventDefault(); component.hideBib(); }, Enter(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, ' '(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, }"
8849
+ "default": "{ Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Stop propagation so parent containers (auro-dialog, auro-drawer) // don't also react to Escape. evt.stopPropagation(); evt.preventDefault(); // Signal to the visibility-change handler in auro-datepicker.js that // focus should be restored to the trigger regardless of hasFocus. // hidePopover() (desktop non-modal path) does not auto-restore focus, // and hiding the grid's popover ancestor drops focus to <body>. That // synchronously fires focusout on the datepicker host — clearing // hasFocus — before updated() runs, which would otherwise skip the // input refocus. Native <dialog>.close() (modal path) restores focus // itself, but the flag is harmless there. component._restoreFocusOnClose = true; component.hideBib(); }, Enter(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, ' '(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, }"
8806
8850
  }
8807
8851
  ],
8808
8852
  "exports": [
@@ -12202,6 +12246,39 @@
12202
12246
  "module": "components/input/src/base-input.js"
12203
12247
  }
12204
12248
  },
12249
+ {
12250
+ "kind": "field",
12251
+ "name": "format",
12252
+ "privacy": "public",
12253
+ "type": {
12254
+ "text": "string"
12255
+ },
12256
+ "description": "Overrides LitElement's generated accessor so we can track whether the\nconsumer explicitly set `format`. Locale-derived updates use\n`_setFormatFromLocale` instead, which skips this flag.",
12257
+ "attribute": "format",
12258
+ "reflects": true,
12259
+ "inheritedFrom": {
12260
+ "name": "BaseInput",
12261
+ "module": "components/input/src/base-input.js"
12262
+ }
12263
+ },
12264
+ {
12265
+ "kind": "method",
12266
+ "name": "_setFormatFromLocale",
12267
+ "parameters": [
12268
+ {
12269
+ "name": "value",
12270
+ "type": {
12271
+ "text": "string"
12272
+ }
12273
+ }
12274
+ ],
12275
+ "description": "Sets format without marking it as user-set. Used by locale auto-derive\nso that a subsequent locale change can still update the format.",
12276
+ "privacy": "private",
12277
+ "inheritedFrom": {
12278
+ "name": "BaseInput",
12279
+ "module": "components/input/src/base-input.js"
12280
+ }
12281
+ },
12205
12282
  {
12206
12283
  "kind": "method",
12207
12284
  "name": "patchInputEvent",
@@ -12752,6 +12829,28 @@
12752
12829
  "module": "components/input/src/base-input.js"
12753
12830
  }
12754
12831
  },
12832
+ {
12833
+ "kind": "field",
12834
+ "name": "_format",
12835
+ "default": "undefined",
12836
+ "inheritedFrom": {
12837
+ "name": "BaseInput",
12838
+ "module": "components/input/src/base-input.js"
12839
+ }
12840
+ },
12841
+ {
12842
+ "kind": "field",
12843
+ "name": "_userSetFormat",
12844
+ "type": {
12845
+ "text": "boolean"
12846
+ },
12847
+ "privacy": "private",
12848
+ "default": "false",
12849
+ "inheritedFrom": {
12850
+ "name": "BaseInput",
12851
+ "module": "components/input/src/base-input.js"
12852
+ }
12853
+ },
12755
12854
  {
12756
12855
  "kind": "field",
12757
12856
  "name": "max",
@@ -12846,15 +12945,6 @@
12846
12945
  "module": "components/layoutElement/src/auroElement.js"
12847
12946
  }
12848
12947
  },
12849
- {
12850
- "kind": "field",
12851
- "name": "_rawMaskValue",
12852
- "default": "undefined",
12853
- "inheritedFrom": {
12854
- "name": "BaseInput",
12855
- "module": "components/input/src/base-input.js"
12856
- }
12857
- },
12858
12948
  {
12859
12949
  "kind": "field",
12860
12950
  "name": "required",
@@ -13159,21 +13249,6 @@
13159
13249
  "module": "components/input/src/base-input.js"
13160
13250
  }
13161
13251
  },
13162
- {
13163
- "kind": "field",
13164
- "name": "format",
13165
- "privacy": "public",
13166
- "type": {
13167
- "text": "string"
13168
- },
13169
- "description": "Specifies the input mask format.",
13170
- "attribute": "format",
13171
- "reflects": true,
13172
- "inheritedFrom": {
13173
- "name": "BaseInput",
13174
- "module": "components/input/src/base-input.js"
13175
- }
13176
- },
13177
13252
  {
13178
13253
  "kind": "field",
13179
13254
  "name": "hasFocus",
@@ -13746,7 +13821,7 @@
13746
13821
  "type": {
13747
13822
  "text": "string"
13748
13823
  },
13749
- "description": "Specifies the input mask format.",
13824
+ "description": "Overrides LitElement's generated accessor so we can track whether the\nconsumer explicitly set `format`. Locale-derived updates use\n`_setFormatFromLocale` instead, which skips this flag.",
13750
13825
  "fieldName": "format",
13751
13826
  "inheritedFrom": {
13752
13827
  "name": "BaseInput",
@@ -14322,6 +14397,31 @@
14322
14397
  },
14323
14398
  "readonly": true
14324
14399
  },
14400
+ {
14401
+ "kind": "field",
14402
+ "name": "format",
14403
+ "privacy": "public",
14404
+ "type": {
14405
+ "text": "string"
14406
+ },
14407
+ "description": "Overrides LitElement's generated accessor so we can track whether the\nconsumer explicitly set `format`. Locale-derived updates use\n`_setFormatFromLocale` instead, which skips this flag.",
14408
+ "attribute": "format",
14409
+ "reflects": true
14410
+ },
14411
+ {
14412
+ "kind": "method",
14413
+ "name": "_setFormatFromLocale",
14414
+ "parameters": [
14415
+ {
14416
+ "name": "value",
14417
+ "type": {
14418
+ "text": "string"
14419
+ }
14420
+ }
14421
+ ],
14422
+ "description": "Sets format without marking it as user-set. Used by locale auto-derive\nso that a subsequent locale change can still update the format.",
14423
+ "privacy": "private"
14424
+ },
14325
14425
  {
14326
14426
  "kind": "method",
14327
14427
  "name": "patchInputEvent",
@@ -14736,6 +14836,20 @@
14736
14836
  "attribute": "locale",
14737
14837
  "reflects": true
14738
14838
  },
14839
+ {
14840
+ "kind": "field",
14841
+ "name": "_format",
14842
+ "default": "undefined"
14843
+ },
14844
+ {
14845
+ "kind": "field",
14846
+ "name": "_userSetFormat",
14847
+ "type": {
14848
+ "text": "boolean"
14849
+ },
14850
+ "privacy": "private",
14851
+ "default": "false"
14852
+ },
14739
14853
  {
14740
14854
  "kind": "field",
14741
14855
  "name": "max",
@@ -14810,11 +14924,6 @@
14810
14924
  "module": "components/layoutElement/src/auroElement.js"
14811
14925
  }
14812
14926
  },
14813
- {
14814
- "kind": "field",
14815
- "name": "_rawMaskValue",
14816
- "default": "undefined"
14817
- },
14818
14927
  {
14819
14928
  "kind": "field",
14820
14929
  "name": "required",
@@ -15039,17 +15148,6 @@
15039
15148
  "description": "Contains the help text message for the current validity error.",
15040
15149
  "attribute": "errorMessage"
15041
15150
  },
15042
- {
15043
- "kind": "field",
15044
- "name": "format",
15045
- "privacy": "public",
15046
- "type": {
15047
- "text": "string"
15048
- },
15049
- "description": "Specifies the input mask format.",
15050
- "attribute": "format",
15051
- "reflects": true
15052
- },
15053
15151
  {
15054
15152
  "kind": "field",
15055
15153
  "name": "hasFocus",
@@ -15480,7 +15578,7 @@
15480
15578
  "type": {
15481
15579
  "text": "string"
15482
15580
  },
15483
- "description": "Specifies the input mask format.",
15581
+ "description": "Overrides LitElement's generated accessor so we can track whether the\nconsumer explicitly set `format`. Locale-derived updates use\n`_setFormatFromLocale` instead, which skips this flag.",
15484
15582
  "fieldName": "format"
15485
15583
  },
15486
15584
  {