@aurodesignsystem-dev/auro-formkit 0.0.0-pr1509.1 → 0.0.0-pr1510.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. package/components/checkbox/demo/customize.min.js +1 -1
  2. package/components/checkbox/demo/getting-started.min.js +1 -1
  3. package/components/checkbox/demo/index.min.js +1 -1
  4. package/components/checkbox/dist/index.js +1 -1
  5. package/components/checkbox/dist/registered.js +1 -1
  6. package/components/combobox/demo/customize.min.js +3 -3
  7. package/components/combobox/demo/getting-started.min.js +3 -3
  8. package/components/combobox/demo/index.min.js +3 -3
  9. package/components/combobox/dist/index.js +3 -3
  10. package/components/combobox/dist/registered.js +3 -3
  11. package/components/counter/demo/customize.min.js +2 -2
  12. package/components/counter/demo/index.min.js +2 -2
  13. package/components/counter/dist/index.js +2 -2
  14. package/components/counter/dist/registered.js +2 -2
  15. package/components/datepicker/demo/accessibility.md +2 -1
  16. package/components/datepicker/demo/api.md +63 -62
  17. package/components/datepicker/demo/customize.md +12 -1
  18. package/components/datepicker/demo/customize.min.js +579 -202
  19. package/components/datepicker/demo/index.min.js +579 -202
  20. package/components/datepicker/dist/{src/auro-calendar-cell.d.ts → auro-calendar-cell.d.ts} +14 -3
  21. package/components/datepicker/dist/{src/auro-calendar.d.ts → auro-calendar.d.ts} +90 -6
  22. package/components/datepicker/dist/{src/auro-datepicker.d.ts → auro-datepicker.d.ts} +78 -5
  23. package/components/datepicker/dist/blackoutUtils.d.ts +43 -0
  24. package/components/datepicker/dist/index.js +579 -202
  25. package/components/datepicker/dist/registered.js +579 -202
  26. package/components/dropdown/demo/customize.min.js +1 -1
  27. package/components/dropdown/demo/getting-started.min.js +1 -1
  28. package/components/dropdown/demo/index.min.js +1 -1
  29. package/components/dropdown/dist/index.js +1 -1
  30. package/components/dropdown/dist/registered.js +1 -1
  31. package/components/form/demo/customize.min.js +595 -218
  32. package/components/form/demo/getting-started.min.js +595 -218
  33. package/components/form/demo/index.min.js +595 -218
  34. package/components/form/demo/registerDemoDeps.min.js +595 -218
  35. package/components/input/demo/customize.min.js +1 -1
  36. package/components/input/demo/getting-started.min.js +1 -1
  37. package/components/input/demo/index.min.js +1 -1
  38. package/components/input/dist/index.js +1 -1
  39. package/components/input/dist/registered.js +1 -1
  40. package/components/radio/demo/customize.min.js +1 -1
  41. package/components/radio/demo/getting-started.min.js +1 -1
  42. package/components/radio/demo/index.min.js +1 -1
  43. package/components/radio/dist/index.js +1 -1
  44. package/components/radio/dist/registered.js +1 -1
  45. package/components/select/demo/customize.min.js +2 -2
  46. package/components/select/demo/getting-started.min.js +2 -2
  47. package/components/select/demo/index.min.js +2 -2
  48. package/components/select/dist/index.js +2 -2
  49. package/components/select/dist/registered.js +2 -2
  50. package/custom-elements.json +1696 -1414
  51. package/package.json +6 -2
  52. package/components/checkbox/demo/customize.js +0 -22
  53. package/components/checkbox/demo/demo-support.js +0 -1
  54. package/components/checkbox/demo/getting-started.js +0 -22
  55. package/components/checkbox/demo/index.js +0 -8
  56. package/components/checkbox/demo/styles.scss +0 -1
  57. package/components/combobox/demo/customize.js +0 -24
  58. package/components/combobox/demo/demo-support.js +0 -1
  59. package/components/combobox/demo/getting-started.js +0 -21
  60. package/components/combobox/demo/index.js +0 -23
  61. package/components/combobox/demo/styles.scss +0 -1
  62. package/components/counter/demo/customize.js +0 -21
  63. package/components/counter/demo/demo-support.js +0 -1
  64. package/components/counter/demo/index.js +0 -21
  65. package/components/counter/demo/styles.scss +0 -1
  66. package/components/datepicker/demo/customize.js +0 -17
  67. package/components/datepicker/demo/demo-support.js +0 -1
  68. package/components/datepicker/demo/index.js +0 -23
  69. package/components/datepicker/demo/styles.scss +0 -1
  70. package/components/dropdown/demo/customize.js +0 -9
  71. package/components/dropdown/demo/demo-support.js +0 -1
  72. package/components/dropdown/demo/getting-started.js +0 -9
  73. package/components/dropdown/demo/index.js +0 -16
  74. package/components/dropdown/demo/styles.scss +0 -1
  75. package/components/form/demo/customize.js +0 -28
  76. package/components/form/demo/demo-support.js +0 -1
  77. package/components/form/demo/getting-started.js +0 -9
  78. package/components/form/demo/index.js +0 -5
  79. package/components/form/demo/registerDemoDeps.js +0 -23
  80. package/components/form/demo/styles.scss +0 -1
  81. package/components/input/demo/customize.js +0 -25
  82. package/components/input/demo/demo-support.js +0 -1
  83. package/components/input/demo/getting-started.js +0 -8
  84. package/components/input/demo/index.js +0 -8
  85. package/components/input/demo/styles.css +0 -974
  86. package/components/input/demo/styles.scss +0 -1
  87. package/components/menu/demo/demo-support.js +0 -1
  88. package/components/menu/demo/index.js +0 -25
  89. package/components/menu/demo/styles.scss +0 -1
  90. package/components/radio/demo/customize.js +0 -22
  91. package/components/radio/demo/demo-support.js +0 -1
  92. package/components/radio/demo/getting-started.js +0 -24
  93. package/components/radio/demo/index.js +0 -8
  94. package/components/radio/demo/styles.scss +0 -1
  95. package/components/select/demo/customize.js +0 -11
  96. package/components/select/demo/demo-support.js +0 -1
  97. package/components/select/demo/getting-started.js +0 -26
  98. package/components/select/demo/index.js +0 -11
  99. package/components/select/demo/styles.scss +0 -1
  100. /package/components/datepicker/dist/{src/auro-calendar-month.d.ts → auro-calendar-month.d.ts} +0 -0
  101. /package/components/datepicker/dist/{src/buttonVersion.d.ts → buttonVersion.d.ts} +0 -0
  102. /package/components/datepicker/dist/{src/datepickerKeyboardStrategy.d.ts → datepickerKeyboardStrategy.d.ts} +0 -0
  103. /package/components/datepicker/dist/{src/iconVersion.d.ts → iconVersion.d.ts} +0 -0
  104. /package/components/datepicker/dist/{src/index.d.ts → index.d.ts} +0 -0
  105. /package/components/datepicker/dist/{src/popoverVersion.d.ts → popoverVersion.d.ts} +0 -0
  106. /package/components/datepicker/dist/{src/styles → styles}/classic/color-css.d.ts +0 -0
  107. /package/components/datepicker/dist/{src/styles → styles}/classic/style-css.d.ts +0 -0
  108. /package/components/datepicker/dist/{src/styles → styles}/color-calendar-css.d.ts +0 -0
  109. /package/components/datepicker/dist/{src/styles → styles}/color-cell-css.d.ts +0 -0
  110. /package/components/datepicker/dist/{src/styles → styles}/color-css.d.ts +0 -0
  111. /package/components/datepicker/dist/{src/styles → styles}/color-month-css.d.ts +0 -0
  112. /package/components/datepicker/dist/{src/styles → styles}/shapeSize-css.d.ts +0 -0
  113. /package/components/datepicker/dist/{src/styles → styles}/snowflake/color-css.d.ts +0 -0
  114. /package/components/datepicker/dist/{src/styles → styles}/snowflake/style-css.d.ts +0 -0
  115. /package/components/datepicker/dist/{src/styles → styles}/style-auro-calendar-cell-css.d.ts +0 -0
  116. /package/components/datepicker/dist/{src/styles → styles}/style-auro-calendar-css.d.ts +0 -0
  117. /package/components/datepicker/dist/{src/styles → styles}/style-auro-calendar-month-css.d.ts +0 -0
  118. /package/components/datepicker/dist/{src/styles → styles}/style-css.d.ts +0 -0
  119. /package/components/datepicker/dist/{src/styles → styles}/tokens-css.d.ts +0 -0
  120. /package/components/datepicker/dist/{src/utilities.d.ts → utilities.d.ts} +0 -0
  121. /package/components/datepicker/dist/{src/utilitiesCalendar.d.ts → utilitiesCalendar.d.ts} +0 -0
  122. /package/components/datepicker/dist/{src/utilitiesCalendarRender.d.ts → utilitiesCalendarRender.d.ts} +0 -0
  123. /package/components/datepicker/dist/{src/vendor → vendor}/wc-range-datepicker/day.d.ts +0 -0
  124. /package/components/datepicker/dist/{src/vendor → vendor}/wc-range-datepicker/range-datepicker-calendar.d.ts +0 -0
  125. /package/components/datepicker/dist/{src/vendor → vendor}/wc-range-datepicker/range-datepicker-cell.d.ts +0 -0
  126. /package/components/datepicker/dist/{src/vendor → vendor}/wc-range-datepicker/range-datepicker.d.ts +0 -0
@@ -267,80 +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": "field",
326
- "name": "inputValue",
327
- "description": "Returns the current value of the input element within the combobox.",
328
- "return": {
329
- "type": {
330
- "text": "string|undefined"
331
- }
332
- },
333
- "readonly": true
334
- },
335
- {
336
- "kind": "method",
337
- "name": "isValid",
338
- "description": "Checks if the element is valid.",
339
- "return": {
340
- "type": {
341
- "text": "boolean"
342
- }
343
- }
297
+ "name": "_initializeDefaults"
344
298
  },
345
299
  {
346
300
  "kind": "method",
@@ -349,7 +303,7 @@
349
303
  "parameters": [
350
304
  {
351
305
  "name": "name",
352
- "default": "'auro-combobox'",
306
+ "default": "\"auro-checkbox-group\"",
353
307
  "description": "The name of the element that you want to register.",
354
308
  "optional": true,
355
309
  "type": {
@@ -361,62 +315,24 @@
361
315
  },
362
316
  {
363
317
  "kind": "method",
364
- "name": "activateFirstEnabledAvailableOption",
365
- "description": "Mark the first available (non-hidden), enabled option as `active`.",
366
- "privacy": "private",
367
- "return": {
368
- "type": {
369
- "text": "void"
370
- }
371
- }
372
- },
373
- {
374
- "kind": "method",
375
- "name": "activateLastEnabledAvailableOption",
376
- "description": "Mark the last available (non-hidden), enabled option as `active`.",
377
- "privacy": "private",
378
- "return": {
379
- "type": {
380
- "text": "void"
381
- }
382
- }
383
- },
384
- {
385
- "kind": "method",
386
- "name": "updateFilter",
387
- "description": "Updates the filter for the available options based on the input value.",
388
- "privacy": "private"
389
- },
390
- {
391
- "kind": "method",
392
- "name": "syncValuesAndStates",
393
- "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
394
- "privacy": "private",
395
- "return": {
396
- "type": {
397
- "text": "void"
398
- }
399
- }
400
- },
401
- {
402
- "kind": "method",
403
- "name": "updateTriggerTextDisplay",
318
+ "name": "handleValueUpdate",
404
319
  "parameters": [
405
320
  {
406
- "name": "label",
407
- "description": "The label of the selected option.",
321
+ "name": "value",
322
+ "description": "The value of the checkbox.",
408
323
  "type": {
409
- "text": "string"
324
+ "text": "String"
325
+ }
326
+ },
327
+ {
328
+ "name": "selected",
329
+ "description": "The checked state of the checkbox.",
330
+ "type": {
331
+ "text": "Boolean"
410
332
  }
411
333
  }
412
334
  ],
413
- "description": "Update displayValue or input.value, it's called when making a selection.",
414
- "privacy": "private"
415
- },
416
- {
417
- "kind": "method",
418
- "name": "handleMenuOptions",
419
- "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.",
420
336
  "privacy": "private",
421
337
  "return": {
422
338
  "type": {
@@ -426,8 +342,8 @@
426
342
  },
427
343
  {
428
344
  "kind": "method",
429
- "name": "generateOptionsArray",
430
- "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.",
431
347
  "privacy": "private",
432
348
  "return": {
433
349
  "type": {
@@ -437,8 +353,9 @@
437
353
  },
438
354
  {
439
355
  "kind": "method",
440
- "name": "hideBib",
441
- "description": "Hides the dropdown bib if its open.",
356
+ "name": "handleItems",
357
+ "description": "Helper method that handles the state of checkboxes.",
358
+ "privacy": "private",
442
359
  "return": {
443
360
  "type": {
444
361
  "text": "void"
@@ -447,8 +364,8 @@
447
364
  },
448
365
  {
449
366
  "kind": "method",
450
- "name": "showBib",
451
- "description": "Shows the dropdown bib if there are options to show.",
367
+ "name": "reset",
368
+ "description": "Resets component to initial state.",
452
369
  "return": {
453
370
  "type": {
454
371
  "text": "void"
@@ -457,102 +374,325 @@
457
374
  },
458
375
  {
459
376
  "kind": "method",
460
- "name": "configureDropdown",
461
- "description": "Binds all behavior needed to the dropdown after rendering.",
462
- "privacy": "private",
463
- "return": {
464
- "type": {
465
- "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
+ }
466
387
  }
467
- }
468
- },
469
- {
470
- "kind": "method",
471
- "name": "setClearBtnFocus",
472
- "privacy": "private"
388
+ ],
389
+ "description": "Validates value."
473
390
  },
474
391
  {
475
- "kind": "method",
476
- "name": "setTriggerInputFocus",
477
- "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
478
402
  },
479
403
  {
480
- "kind": "method",
481
- "name": "setInputFocus",
482
- "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
483
413
  },
484
414
  {
485
- "kind": "method",
486
- "name": "updateBibDialogRole",
487
- "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.",
488
- "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
489
424
  },
490
425
  {
491
- "kind": "method",
492
- "name": "updateMenuShapeSize",
493
- "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
494
- "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
495
435
  },
496
436
  {
497
- "kind": "method",
498
- "name": "_getAnnouncementRoot",
499
- "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.",
500
- "privacy": "private",
501
- "return": {
502
- "type": {
503
- "text": "ShadowRoot"
504
- }
505
- }
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
506
446
  },
507
447
  {
508
- "kind": "method",
509
- "name": "configureMenu",
510
- "description": "Binds all behavior needed to the menu after rendering.",
511
- "privacy": "private",
512
- "return": {
513
- "type": {
514
- "text": "void"
515
- }
516
- }
448
+ "kind": "field",
449
+ "name": "onDark",
450
+ "privacy": "public",
451
+ "type": {
452
+ "text": "boolean"
453
+ },
454
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
455
+ "attribute": "onDark",
456
+ "reflects": true
517
457
  },
518
458
  {
519
- "kind": "method",
520
- "name": "configureInput",
521
- "description": "Binds all behavior needed to the input after rendering.",
522
- "privacy": "private",
523
- "return": {
524
- "type": {
525
- "text": "void"
526
- }
459
+ "kind": "field",
460
+ "name": "required",
461
+ "privacy": "public",
462
+ "type": {
463
+ "text": "boolean"
464
+ },
465
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
466
+ "attribute": "required",
467
+ "reflects": true
468
+ },
469
+ {
470
+ "kind": "field",
471
+ "name": "setCustomValidity",
472
+ "privacy": "public",
473
+ "type": {
474
+ "text": "string"
475
+ },
476
+ "description": "Sets a custom help text message to display for all validityStates.",
477
+ "attribute": "setCustomValidity"
478
+ },
479
+ {
480
+ "kind": "field",
481
+ "name": "setCustomValidityCustomError",
482
+ "privacy": "public",
483
+ "type": {
484
+ "text": "string"
485
+ },
486
+ "description": "Custom help text message to display when validity = `customError`.",
487
+ "attribute": "setCustomValidityCustomError"
488
+ },
489
+ {
490
+ "kind": "field",
491
+ "name": "setCustomValidityValueMissing",
492
+ "privacy": "public",
493
+ "type": {
494
+ "text": "string"
495
+ },
496
+ "description": "Custom help text message to display when validity = `valueMissing`.",
497
+ "attribute": "setCustomValidityValueMissing"
498
+ },
499
+ {
500
+ "kind": "field",
501
+ "name": "validity",
502
+ "privacy": "public",
503
+ "type": {
504
+ "text": "string"
505
+ },
506
+ "description": "Specifies the `validityState` this element is in.",
507
+ "attribute": "validity",
508
+ "reflects": true
509
+ }
510
+ ],
511
+ "events": [
512
+ {
513
+ "name": "input",
514
+ "type": {
515
+ "text": "CustomEvent"
527
516
  }
528
517
  },
518
+ {
519
+ "description": "Notifies that the `validity` and `errorMessage` values have changed.",
520
+ "name": "auroFormElement-validated"
521
+ }
522
+ ],
523
+ "attributes": [
524
+ {
525
+ "name": "appearance",
526
+ "type": {
527
+ "text": "'default' | 'inverse'"
528
+ },
529
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
530
+ "default": "'default'",
531
+ "fieldName": "appearance"
532
+ },
533
+ {
534
+ "name": "disabled",
535
+ "type": {
536
+ "text": "boolean"
537
+ },
538
+ "description": "If set, disables the checkbox group.",
539
+ "fieldName": "disabled"
540
+ },
541
+ {
542
+ "name": "error",
543
+ "type": {
544
+ "text": "string"
545
+ },
546
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
547
+ "fieldName": "error"
548
+ },
549
+ {
550
+ "name": "horizontal",
551
+ "type": {
552
+ "text": "boolean"
553
+ },
554
+ "description": "If set, checkboxes will be aligned horizontally.",
555
+ "fieldName": "horizontal"
556
+ },
557
+ {
558
+ "name": "noValidate",
559
+ "type": {
560
+ "text": "boolean"
561
+ },
562
+ "description": "If set, disables auto-validation on blur.",
563
+ "fieldName": "noValidate"
564
+ },
565
+ {
566
+ "name": "onDark",
567
+ "type": {
568
+ "text": "boolean"
569
+ },
570
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
571
+ "fieldName": "onDark"
572
+ },
573
+ {
574
+ "name": "required",
575
+ "type": {
576
+ "text": "boolean"
577
+ },
578
+ "description": "Populates the `required` attribute on the element. Used for client-side validation.",
579
+ "fieldName": "required"
580
+ },
581
+ {
582
+ "name": "setCustomValidity",
583
+ "type": {
584
+ "text": "string"
585
+ },
586
+ "description": "Sets a custom help text message to display for all validityStates.",
587
+ "fieldName": "setCustomValidity"
588
+ },
589
+ {
590
+ "name": "setCustomValidityCustomError",
591
+ "type": {
592
+ "text": "string"
593
+ },
594
+ "description": "Custom help text message to display when validity = `customError`.",
595
+ "fieldName": "setCustomValidityCustomError"
596
+ },
597
+ {
598
+ "name": "setCustomValidityValueMissing",
599
+ "type": {
600
+ "text": "string"
601
+ },
602
+ "description": "Custom help text message to display when validity = `valueMissing`.",
603
+ "fieldName": "setCustomValidityValueMissing"
604
+ },
605
+ {
606
+ "name": "validity",
607
+ "type": {
608
+ "text": "string"
609
+ },
610
+ "description": "Specifies the `validityState` this element is in.",
611
+ "fieldName": "validity"
612
+ }
613
+ ],
614
+ "superclass": {
615
+ "name": "LitElement",
616
+ "package": "lit"
617
+ },
618
+ "tagName": "auro-checkbox-group",
619
+ "customElement": true
620
+ }
621
+ ],
622
+ "exports": [
623
+ {
624
+ "kind": "js",
625
+ "name": "AuroCheckboxGroup",
626
+ "declaration": {
627
+ "name": "AuroCheckboxGroup",
628
+ "module": "components/checkbox/src/auro-checkbox-group.js"
629
+ }
630
+ }
631
+ ]
632
+ },
633
+ {
634
+ "kind": "javascript-module",
635
+ "path": "components/checkbox/src/auro-checkbox.js",
636
+ "declarations": [
637
+ {
638
+ "kind": "class",
639
+ "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
640
+ "name": "AuroCheckbox",
641
+ "cssParts": [
642
+ {
643
+ "description": "apply css to a specific checkbox.",
644
+ "name": "checkbox"
645
+ },
646
+ {
647
+ "description": "apply css to a specific checkbox's input.",
648
+ "name": "checkbox-input"
649
+ },
650
+ {
651
+ "description": "apply css to a specific checkbox's label.",
652
+ "name": "checkbox-label"
653
+ }
654
+ ],
655
+ "slots": [
656
+ {
657
+ "description": "The default slot for the checkbox label.",
658
+ "name": "default"
659
+ }
660
+ ],
661
+ "members": [
529
662
  {
530
663
  "kind": "method",
531
- "name": "handleMenuLoadingChange",
664
+ "name": "_initializeDefaults"
665
+ },
666
+ {
667
+ "kind": "method",
668
+ "name": "register",
669
+ "static": true,
532
670
  "parameters": [
533
671
  {
534
- "name": "event",
535
- "description": "The event object containing details about the loading state change.",
536
- "type": {
537
- "text": "CustomEvent"
538
- }
539
- },
540
- {
541
- "description": "Indicates whether the menu is currently loading.",
542
- "name": "event.detail.loading",
672
+ "name": "name",
673
+ "default": "\"auro-checkbox\"",
674
+ "description": "The name of element that you want to register to.",
675
+ "optional": true,
543
676
  "type": {
544
- "text": "boolean"
677
+ "text": "string"
545
678
  }
546
- },
679
+ }
680
+ ],
681
+ "description": "This will register this element with the browser."
682
+ },
683
+ {
684
+ "kind": "method",
685
+ "name": "handleChange",
686
+ "parameters": [
547
687
  {
548
- "description": "Indicates if there are loading placeholders present.",
549
- "name": "event.detail.hasLoadingPlaceholder",
688
+ "name": "event",
689
+ "description": "The change event from the checkbox input.",
550
690
  "type": {
551
- "text": "boolean"
691
+ "text": "Event"
552
692
  }
553
693
  }
554
694
  ],
555
- "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.",
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.",
556
696
  "privacy": "private",
557
697
  "return": {
558
698
  "type": {
@@ -562,17 +702,17 @@
562
702
  },
563
703
  {
564
704
  "kind": "method",
565
- "name": "handleInputValueChange",
705
+ "name": "handleInput",
566
706
  "parameters": [
567
707
  {
568
708
  "name": "event",
569
- "description": "The input event triggered by the input element.",
709
+ "description": "The input event from the checkbox input.",
570
710
  "type": {
571
711
  "text": "Event"
572
712
  }
573
713
  }
574
714
  ],
575
- "description": "Handle changes to the input value and trigger changes that should result.",
715
+ "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
576
716
  "privacy": "private",
577
717
  "return": {
578
718
  "type": {
@@ -582,8 +722,8 @@
582
722
  },
583
723
  {
584
724
  "kind": "method",
585
- "name": "configureCombobox",
586
- "description": "Binds all behavior needed to the combobox after rendering.",
725
+ "name": "handleFocusin",
726
+ "description": "Function to support",
587
727
  "privacy": "private",
588
728
  "return": {
589
729
  "type": {
@@ -593,30 +733,12 @@
593
733
  },
594
734
  {
595
735
  "kind": "method",
596
- "name": "focus",
597
- "description": "Focuses the combobox trigger input.",
598
- "return": {
599
- "type": {
600
- "text": "void"
601
- }
602
- }
603
- },
604
- {
605
- "kind": "method",
606
- "name": "setMenuValue",
607
- "parameters": [
608
- {
609
- "name": "value",
610
- "description": "The value to set on the menu.",
611
- "type": {
612
- "text": "string"
613
- }
614
- }
615
- ],
616
- "description": "Sets the menu value if menu is available.",
736
+ "name": "generateIconHtml",
737
+ "description": "Function to generate checkmark svg.",
738
+ "privacy": "private",
617
739
  "return": {
618
740
  "type": {
619
- "text": "void"
741
+ "text": "HTMLElement"
620
742
  }
621
743
  }
622
744
  },
@@ -632,57 +754,8 @@
632
754
  },
633
755
  {
634
756
  "kind": "method",
635
- "name": "clear",
636
- "description": "Clears the current value of the combobox.",
637
- "return": {
638
- "type": {
639
- "text": "void"
640
- }
641
- }
642
- },
643
- {
644
- "kind": "method",
645
- "name": "validate",
646
- "parameters": [
647
- {
648
- "name": "force",
649
- "default": "false",
650
- "description": "Whether to force validation.",
651
- "optional": true,
652
- "type": {
653
- "text": "boolean"
654
- }
655
- }
656
- ],
657
- "description": "Validates value."
658
- },
659
- {
660
- "kind": "method",
661
- "name": "transportAssignedNodes",
662
- "parameters": [
663
- {
664
- "name": "slot",
665
- "description": "The slot element containing the nodes to apply.",
666
- "type": {
667
- "text": "HTMLSlotElement"
668
- }
669
- },
670
- {
671
- "name": "target",
672
- "description": "The target element to apply the nodes to.",
673
- "type": {
674
- "text": "HTMLElement"
675
- }
676
- },
677
- {
678
- "name": "newSlotName",
679
- "description": "The new slot name for the applied nodes.",
680
- "type": {
681
- "text": "string"
682
- }
683
- }
684
- ],
685
- "description": "Applies slotted nodes to a target element with a new slot name.",
757
+ "name": "updateAriaLabel",
758
+ "description": "Updates the aria-label based on slot content.",
686
759
  "privacy": "private",
687
760
  "return": {
688
761
  "type": {
@@ -692,31 +765,17 @@
692
765
  },
693
766
  {
694
767
  "kind": "method",
695
- "name": "updateActiveOption",
696
- "parameters": [
697
- {
698
- "name": "index",
699
- "description": "Index of the option to make active.",
700
- "type": {
701
- "text": "number"
702
- }
703
- }
704
- ],
705
- "description": "Updates the active option in the menu."
706
- },
707
- {
708
- "kind": "method",
709
- "name": "handleSlotChange",
768
+ "name": "handleKeyDown",
710
769
  "parameters": [
711
770
  {
712
771
  "name": "event",
713
- "description": "`slotchange` event.",
772
+ "description": "The keydown event from the checkbox input.",
714
773
  "type": {
715
- "text": "Event"
774
+ "text": "KeyboardEvent"
716
775
  }
717
776
  }
718
777
  ],
719
- "description": "Watch for slot changes and recalculate the menuoptions.",
778
+ "description": "Handles keydown event to toggle the checkbox with Space key.",
720
779
  "privacy": "private",
721
780
  "return": {
722
781
  "type": {
@@ -729,7 +788,7 @@
729
788
  "name": "appearance",
730
789
  "privacy": "public",
731
790
  "type": {
732
- "text": "string"
791
+ "text": "'default' | 'inverse'"
733
792
  },
734
793
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
735
794
  "default": "'default'",
@@ -738,1175 +797,1306 @@
738
797
  },
739
798
  {
740
799
  "kind": "field",
741
- "name": "autocomplete",
742
- "privacy": "public",
743
- "type": {
744
- "text": "string"
745
- },
746
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
747
- "attribute": "autocomplete",
748
- "reflects": true
749
- },
750
- {
751
- "kind": "field",
752
- "name": "autoPlacement",
800
+ "name": "checked",
753
801
  "privacy": "public",
754
802
  "type": {
755
803
  "text": "boolean"
756
804
  },
757
- "description": "If declared, bib's position will be automatically calculated where to appear.",
758
- "attribute": "autoPlacement",
805
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
806
+ "attribute": "checked",
759
807
  "reflects": true
760
808
  },
761
809
  {
762
810
  "kind": "field",
763
- "name": "availableOptions",
764
- "privacy": "private",
765
- "type": {
766
- "text": "array"
767
- },
768
- "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).",
769
- "attribute": "availableOptions"
770
- },
771
- {
772
- "kind": "field",
773
- "name": "behavior",
811
+ "name": "disabled",
774
812
  "privacy": "public",
775
813
  "type": {
776
- "text": "'filter' | 'suggestion'"
814
+ "text": "boolean"
777
815
  },
778
- "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.",
779
- "default": "'suggestion'",
780
- "attribute": "behavior",
816
+ "description": "If set to true, the checkbox will not be clickable.",
817
+ "attribute": "disabled",
781
818
  "reflects": true
782
819
  },
783
820
  {
784
821
  "kind": "field",
785
- "name": "checkmark",
822
+ "name": "error",
786
823
  "privacy": "public",
787
824
  "type": {
788
825
  "text": "boolean"
789
826
  },
790
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
791
- "attribute": "checkmark",
827
+ "description": "If set to true, the checkbox will be displayed with an error state.",
828
+ "attribute": "error",
792
829
  "reflects": true
793
830
  },
794
831
  {
795
832
  "kind": "field",
796
- "name": "disabled",
833
+ "name": "id",
797
834
  "privacy": "public",
798
835
  "type": {
799
- "text": "boolean"
836
+ "text": "string"
800
837
  },
801
- "description": "If set, disables the combobox.",
802
- "attribute": "disabled",
838
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
839
+ "attribute": "id",
803
840
  "reflects": true
804
841
  },
805
842
  {
806
843
  "kind": "field",
807
- "name": "dropdownId",
844
+ "name": "inputId",
808
845
  "privacy": "private",
809
846
  "type": {
810
847
  "text": "string"
811
848
  },
812
- "description": "ID for the dropdown."
849
+ "description": "The id for input node."
813
850
  },
814
851
  {
815
852
  "kind": "field",
816
- "name": "dropdownOpen",
817
- "privacy": "private",
853
+ "name": "name",
854
+ "privacy": "public",
818
855
  "type": {
819
- "text": "boolean"
856
+ "text": "string"
820
857
  },
821
- "description": "Whether or not the dropdown is open."
858
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
859
+ "attribute": "name"
822
860
  },
823
861
  {
824
862
  "kind": "field",
825
- "name": "dvInputOnly",
863
+ "name": "onDark",
826
864
  "privacy": "public",
827
865
  "type": {
828
866
  "text": "boolean"
829
867
  },
830
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
831
- "attribute": "dvInputOnly",
868
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
869
+ "attribute": "onDark",
832
870
  "reflects": true
833
871
  },
834
872
  {
835
873
  "kind": "field",
836
- "name": "error",
837
- "privacy": "public",
874
+ "name": "touched",
875
+ "privacy": "private",
838
876
  "type": {
839
- "text": "string"
877
+ "text": "boolean"
840
878
  },
841
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
842
- "attribute": "error",
843
- "reflects": true
879
+ "description": "Indicates whether the checkbox has been interacted with."
844
880
  },
845
881
  {
846
882
  "kind": "field",
847
- "name": "format",
883
+ "name": "value",
848
884
  "privacy": "public",
849
885
  "type": {
850
886
  "text": "string"
851
887
  },
852
- "description": "Specifies the input mask format.",
853
- "attribute": "format",
854
- "reflects": true
888
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
889
+ "attribute": "value"
855
890
  },
856
891
  {
857
892
  "kind": "field",
858
- "name": "inputmode",
859
- "privacy": "public",
893
+ "name": "tabIndex",
894
+ "privacy": "private",
860
895
  "type": {
861
- "text": "string"
896
+ "text": "number"
862
897
  },
863
- "description": "Exposes inputmode attribute for input.",
864
- "attribute": "inputmode",
898
+ "description": "The tabindex attribute for the checkbox.",
899
+ "attribute": "tabindex",
865
900
  "reflects": true
866
901
  },
867
902
  {
868
903
  "kind": "field",
869
- "name": "layout",
870
- "privacy": "public",
904
+ "name": "ariaChecked",
905
+ "privacy": "private",
871
906
  "type": {
872
907
  "text": "string"
873
908
  },
874
- "description": "Sets the layout of the combobox.",
875
- "default": "'classic'",
876
- "attribute": "layout",
877
- "reflects": true,
878
- "inheritedFrom": {
879
- "name": "AuroElement",
880
- "module": "components/layoutElement/src/auroElement.js"
881
- }
909
+ "description": "The aria-checked attribute for the checkbox.",
910
+ "attribute": "aria-checked",
911
+ "reflects": true
882
912
  },
883
913
  {
884
914
  "kind": "field",
885
- "name": "matchWidth",
915
+ "name": "ariaDisabled",
886
916
  "privacy": "private",
887
917
  "type": {
888
- "text": "boolean"
918
+ "text": "string"
889
919
  },
890
- "description": "If declared, the popover and trigger will be set to the same width.",
891
- "attribute": "matchWidth",
920
+ "description": "The aria-disabled attribute for the checkbox.",
921
+ "attribute": "aria-disabled",
892
922
  "reflects": true
893
923
  },
894
924
  {
895
925
  "kind": "field",
896
- "name": "noFilter",
897
- "privacy": "public",
926
+ "name": "role",
927
+ "privacy": "private",
898
928
  "type": {
899
- "text": "boolean"
929
+ "text": "string"
900
930
  },
901
- "description": "If set, combobox will not filter menuoptions based on input.",
902
- "attribute": "noFilter",
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",
903
933
  "reflects": true
904
- },
934
+ }
935
+ ],
936
+ "events": [
905
937
  {
906
- "kind": "field",
907
- "name": "noFlip",
908
- "privacy": "public",
938
+ "name": "auroCheckbox-input",
909
939
  "type": {
910
- "text": "boolean"
911
- },
912
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
913
- "attribute": "noFlip",
914
- "reflects": true
940
+ "text": "CustomEvent"
941
+ }
915
942
  },
916
943
  {
917
- "kind": "field",
918
- "name": "shift",
919
- "privacy": "public",
944
+ "name": "auroCheckbox-focusin",
920
945
  "type": {
921
- "text": "boolean"
922
- },
923
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
924
- "attribute": "shift",
925
- "reflects": true
946
+ "text": "CustomEvent"
947
+ }
926
948
  },
927
949
  {
928
- "kind": "field",
929
- "name": "noValidate",
930
- "privacy": "public",
950
+ "name": "auroCheckbox-focusout",
931
951
  "type": {
932
- "text": "boolean"
933
- },
934
- "description": "If set, disables auto-validation on blur.",
935
- "attribute": "noValidate",
936
- "reflects": true
952
+ "text": "CustomEvent"
953
+ }
937
954
  },
938
955
  {
939
- "kind": "field",
940
- "name": "offset",
941
- "privacy": "public",
956
+ "description": "(Deprecated) Notifies when checked value is changed.",
957
+ "name": "change"
958
+ },
959
+ {
960
+ "description": "Notifies when when checked value is changed by user's interface.",
961
+ "name": "input"
962
+ }
963
+ ],
964
+ "attributes": [
965
+ {
966
+ "name": "appearance",
942
967
  "type": {
943
- "text": "number"
968
+ "text": "'default' | 'inverse'"
944
969
  },
945
- "description": "Gap between the trigger element and bib.",
946
- "default": "0",
947
- "attribute": "offset",
948
- "reflects": true
970
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
971
+ "default": "'default'",
972
+ "fieldName": "appearance"
949
973
  },
950
974
  {
951
- "kind": "field",
952
- "name": "onDark",
953
- "privacy": "public",
975
+ "name": "checked",
954
976
  "type": {
955
977
  "text": "boolean"
956
978
  },
957
- "attribute": "onDark",
958
- "reflects": true,
959
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
960
- "inheritedFrom": {
961
- "name": "AuroElement",
962
- "module": "components/layoutElement/src/auroElement.js"
963
- }
979
+ "description": "If set to true, the checkbox will be filled with a checkmark.",
980
+ "fieldName": "checked"
964
981
  },
965
982
  {
966
- "kind": "field",
967
- "name": "optionSelected",
968
- "privacy": "public",
983
+ "name": "disabled",
969
984
  "type": {
970
- "text": "HTMLElement"
985
+ "text": "boolean"
971
986
  },
972
- "description": "Specifies the current selected option.",
973
- "attribute": "optionSelected"
987
+ "description": "If set to true, the checkbox will not be clickable.",
988
+ "fieldName": "disabled"
974
989
  },
975
990
  {
976
- "kind": "field",
977
- "name": "persistInput",
978
- "privacy": "public",
991
+ "name": "error",
979
992
  "type": {
980
993
  "text": "boolean"
981
994
  },
982
- "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.",
983
- "attribute": "persistInput",
984
- "reflects": true
995
+ "description": "If set to true, the checkbox will be displayed with an error state.",
996
+ "fieldName": "error"
985
997
  },
986
998
  {
987
- "kind": "field",
988
- "name": "placement",
989
- "privacy": "public",
999
+ "name": "id",
990
1000
  "type": {
991
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1001
+ "text": "string"
992
1002
  },
993
- "description": "Position where the bib should appear relative to the trigger.",
994
- "default": "'bottom-start'",
995
- "attribute": "placement",
996
- "reflects": true
1003
+ "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
1004
+ "fieldName": "id"
997
1005
  },
998
1006
  {
999
- "kind": "field",
1000
- "name": "placeholder",
1001
- "privacy": "public",
1007
+ "name": "name",
1002
1008
  "type": {
1003
1009
  "text": "string"
1004
1010
  },
1005
- "description": "Define custom placeholder text, only supported by date input formats.",
1006
- "attribute": "placeholder",
1007
- "reflects": true
1011
+ "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
1012
+ "fieldName": "name"
1008
1013
  },
1009
1014
  {
1010
- "kind": "field",
1011
- "name": "required",
1012
- "privacy": "public",
1015
+ "name": "onDark",
1013
1016
  "type": {
1014
1017
  "text": "boolean"
1015
1018
  },
1016
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1017
- "attribute": "required",
1018
- "reflects": true
1019
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1020
+ "fieldName": "onDark"
1019
1021
  },
1020
1022
  {
1021
- "kind": "field",
1022
- "name": "setCustomValidity",
1023
- "privacy": "public",
1023
+ "name": "value",
1024
1024
  "type": {
1025
1025
  "text": "string"
1026
1026
  },
1027
- "description": "Sets a custom help text message to display for all validityStates.",
1028
- "attribute": "setCustomValidity"
1027
+ "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
1028
+ "fieldName": "value"
1029
1029
  },
1030
1030
  {
1031
- "kind": "field",
1032
- "name": "setCustomValidityCustomError",
1033
- "privacy": "public",
1031
+ "name": "tabindex",
1034
1032
  "type": {
1035
- "text": "string"
1033
+ "text": "number"
1036
1034
  },
1037
- "description": "Custom help text message to display when validity = `customError`.",
1038
- "attribute": "setCustomValidityCustomError"
1035
+ "description": "The tabindex attribute for the checkbox.",
1036
+ "fieldName": "tabIndex"
1039
1037
  },
1040
1038
  {
1041
- "kind": "field",
1042
- "name": "setCustomValidityValueMissing",
1043
- "privacy": "public",
1039
+ "name": "aria-checked",
1044
1040
  "type": {
1045
1041
  "text": "string"
1046
1042
  },
1047
- "description": "Custom help text message to display when validity = `valueMissing`.",
1048
- "attribute": "setCustomValidityValueMissing"
1043
+ "description": "The aria-checked attribute for the checkbox.",
1044
+ "fieldName": "ariaChecked"
1049
1045
  },
1050
1046
  {
1051
- "kind": "field",
1052
- "name": "setCustomValidityValueMissingFilter",
1053
- "privacy": "public",
1047
+ "name": "aria-disabled",
1054
1048
  "type": {
1055
1049
  "text": "string"
1056
1050
  },
1057
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1058
- "attribute": "setCustomValidityValueMissingFilter"
1051
+ "description": "The aria-disabled attribute for the checkbox.",
1052
+ "fieldName": "ariaDisabled"
1059
1053
  },
1060
1054
  {
1061
- "kind": "field",
1062
- "name": "touched",
1063
- "privacy": "private",
1055
+ "name": "role",
1064
1056
  "type": {
1065
- "text": "boolean"
1057
+ "text": "string"
1066
1058
  },
1067
- "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
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": ""
1068
1123
  },
1069
1124
  {
1070
- "kind": "field",
1071
- "name": "triggerIcon",
1072
- "privacy": "public",
1073
1125
  "type": {
1074
- "text": "boolean"
1126
+ "text": "HTMLSlotElement"
1075
1127
  },
1076
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1077
- "attribute": "triggerIcon",
1078
- "reflects": true
1128
+ "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1129
+ "name": "optionalLabel"
1079
1130
  },
1080
1131
  {
1081
- "kind": "field",
1082
- "name": "type",
1083
- "privacy": "public",
1084
- "type": {
1085
- "text": "string"
1086
- },
1087
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1088
- "attribute": "type",
1089
- "reflects": true
1132
+ "description": "Sets aria-label on clear button",
1133
+ "name": "ariaLabel.input.clear"
1090
1134
  },
1091
1135
  {
1092
- "kind": "field",
1093
- "name": "typedValue",
1094
- "privacy": "public",
1095
- "type": {
1096
- "text": "string"
1097
- },
1098
- "description": "Specifies the value of the input element within the combobox.",
1099
- "attribute": "typedValue",
1100
- "reflects": true
1136
+ "description": "Sets aria-label on close button in fullscreen bib",
1137
+ "name": "ariaLabel.bib.close"
1101
1138
  },
1102
1139
  {
1103
- "kind": "field",
1104
- "name": "validity",
1105
- "privacy": "public",
1106
- "type": {
1107
- "text": "string"
1108
- },
1109
- "description": "Specifies the `validityState` this element is in.",
1110
- "attribute": "validity",
1111
- "reflects": true
1140
+ "description": "Defines the headline to display above menu-options",
1141
+ "name": "bib.fullscreen.headline"
1112
1142
  },
1113
1143
  {
1114
- "kind": "field",
1115
- "name": "value",
1116
- "privacy": "public",
1117
- "type": {
1118
- "text": "string"
1119
- },
1120
- "description": "Value selected for the dropdown menu.",
1121
- "attribute": "value"
1144
+ "description": "Defines the content of the label.",
1145
+ "name": "label"
1122
1146
  },
1123
1147
  {
1124
- "kind": "field",
1125
- "name": "largeFullscreenHeadline",
1126
- "privacy": "public",
1127
- "type": {
1128
- "text": "boolean"
1129
- },
1130
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1131
- "attribute": "largeFullscreenHeadline",
1132
- "reflects": true
1148
+ "description": "Defines the content of the helpText.",
1149
+ "name": "helpText"
1133
1150
  },
1134
1151
  {
1135
- "kind": "field",
1136
- "name": "fullscreenBreakpoint",
1137
- "privacy": "public",
1138
- "type": {
1139
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1140
- },
1141
- "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.",
1142
- "default": "'sm'",
1143
- "attribute": "fullscreenBreakpoint",
1144
- "reflects": true
1145
- },
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": [
1146
1157
  {
1147
- "kind": "field",
1148
- "name": "optionActive",
1158
+ "kind": "method",
1159
+ "name": "_initializeDefaults",
1149
1160
  "privacy": "private",
1150
- "type": {
1151
- "text": "object"
1152
- },
1153
- "description": "Specifies the currently active option."
1161
+ "return": {
1162
+ "type": {
1163
+ "text": "void"
1164
+ }
1165
+ }
1154
1166
  },
1155
1167
  {
1156
1168
  "kind": "field",
1157
- "name": "triggerExpandedState",
1158
- "privacy": "private",
1159
- "type": {
1160
- "text": "boolean"
1169
+ "name": "inputValue",
1170
+ "description": "Returns the current value of the input element within the combobox.",
1171
+ "return": {
1172
+ "type": {
1173
+ "text": "string|undefined"
1174
+ }
1161
1175
  },
1162
- "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1176
+ "readonly": true
1163
1177
  },
1164
1178
  {
1165
- "kind": "field",
1166
- "name": "componentHasFocus",
1167
- "description": "Returns true if the element has focus.",
1168
- "privacy": "private",
1179
+ "kind": "method",
1180
+ "name": "isValid",
1181
+ "description": "Checks if the element is valid.",
1169
1182
  "return": {
1170
1183
  "type": {
1171
1184
  "text": "boolean"
1172
1185
  }
1173
- },
1174
- "readonly": true,
1175
- "inheritedFrom": {
1176
- "name": "AuroElement",
1177
- "module": "components/layoutElement/src/auroElement.js"
1178
1186
  }
1179
1187
  },
1180
1188
  {
1181
1189
  "kind": "method",
1182
- "name": "resetShapeClasses",
1183
- "inheritedFrom": {
1184
- "name": "AuroElement",
1185
- "module": "components/layoutElement/src/auroElement.js"
1186
- }
1190
+ "name": "register",
1191
+ "static": true,
1192
+ "parameters": [
1193
+ {
1194
+ "name": "name",
1195
+ "default": "'auro-combobox'",
1196
+ "description": "The name of the element that you want to register.",
1197
+ "optional": true,
1198
+ "type": {
1199
+ "text": "string"
1200
+ }
1201
+ }
1202
+ ],
1203
+ "description": "This will register this element with the browser."
1187
1204
  },
1188
1205
  {
1189
1206
  "kind": "method",
1190
- "name": "resetLayoutClasses",
1191
- "inheritedFrom": {
1192
- "name": "AuroElement",
1193
- "module": "components/layoutElement/src/auroElement.js"
1207
+ "name": "activateFirstEnabledAvailableOption",
1208
+ "description": "Mark the first available (non-hidden), enabled option as `active`.",
1209
+ "privacy": "private",
1210
+ "return": {
1211
+ "type": {
1212
+ "text": "void"
1213
+ }
1194
1214
  }
1195
1215
  },
1196
1216
  {
1197
1217
  "kind": "method",
1198
- "name": "updateComponentArchitecture",
1199
- "inheritedFrom": {
1200
- "name": "AuroElement",
1201
- "module": "components/layoutElement/src/auroElement.js"
1218
+ "name": "activateLastEnabledAvailableOption",
1219
+ "description": "Mark the last available (non-hidden), enabled option as `active`.",
1220
+ "privacy": "private",
1221
+ "return": {
1222
+ "type": {
1223
+ "text": "void"
1224
+ }
1202
1225
  }
1203
1226
  },
1204
1227
  {
1205
- "kind": "field",
1206
- "name": "shape",
1207
- "privacy": "public",
1208
- "type": {
1209
- "text": "string"
1210
- },
1211
- "attribute": "shape",
1212
- "reflects": true,
1213
- "inheritedFrom": {
1214
- "name": "AuroElement",
1215
- "module": "components/layoutElement/src/auroElement.js"
1216
- }
1228
+ "kind": "method",
1229
+ "name": "updateFilter",
1230
+ "description": "Updates the filter for the available options based on the input value.",
1231
+ "privacy": "private"
1217
1232
  },
1218
1233
  {
1219
- "kind": "field",
1220
- "name": "size",
1221
- "privacy": "public",
1222
- "type": {
1223
- "text": "string"
1224
- },
1225
- "attribute": "size",
1226
- "reflects": true,
1227
- "inheritedFrom": {
1228
- "name": "AuroElement",
1229
- "module": "components/layoutElement/src/auroElement.js"
1234
+ "kind": "method",
1235
+ "name": "syncValuesAndStates",
1236
+ "description": "Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.",
1237
+ "privacy": "private",
1238
+ "return": {
1239
+ "type": {
1240
+ "text": "void"
1241
+ }
1230
1242
  }
1231
- }
1232
- ],
1233
- "events": [
1234
- {
1235
- "name": "inputValue",
1236
- "type": {
1237
- "text": "CustomEvent"
1238
- },
1239
- "description": "Notifies that the components internal HTML5 input value has changed."
1240
1243
  },
1241
1244
  {
1242
- "name": "input",
1243
- "type": {
1244
- "text": "CustomEvent"
1245
- },
1246
- "description": "Notifies that the component has a new value set."
1245
+ "kind": "method",
1246
+ "name": "updateTriggerTextDisplay",
1247
+ "parameters": [
1248
+ {
1249
+ "name": "label",
1250
+ "description": "The label of the selected option.",
1251
+ "type": {
1252
+ "text": "string"
1253
+ }
1254
+ }
1255
+ ],
1256
+ "description": "Update displayValue or input.value, it's called when making a selection.",
1257
+ "privacy": "private"
1247
1258
  },
1248
1259
  {
1249
- "name": "auroCombobox-valueSet",
1250
- "type": {
1251
- "text": "CustomEvent"
1252
- },
1253
- "description": "(Deprecated) Notifies that the component has a new value set."
1260
+ "kind": "method",
1261
+ "name": "handleMenuOptions",
1262
+ "description": "Processes hidden state of all menu options and determines if there are any available options not hidden.",
1263
+ "privacy": "private",
1264
+ "return": {
1265
+ "type": {
1266
+ "text": "void"
1267
+ }
1268
+ }
1254
1269
  },
1255
1270
  {
1256
- "description": "Notifies that the component value(s) have been validated.",
1257
- "name": "auroFormElement-validated"
1258
- }
1259
- ],
1260
- "attributes": [
1261
- {
1262
- "name": "appearance",
1263
- "type": {
1264
- "text": "string"
1265
- },
1266
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1267
- "default": "'default'",
1268
- "fieldName": "appearance"
1271
+ "kind": "method",
1272
+ "name": "generateOptionsArray",
1273
+ "description": "Determines the element error state based on the `required` attribute and input value.",
1274
+ "privacy": "private",
1275
+ "return": {
1276
+ "type": {
1277
+ "text": "void"
1278
+ }
1279
+ }
1269
1280
  },
1270
1281
  {
1271
- "name": "autocomplete",
1272
- "type": {
1273
- "text": "string"
1274
- },
1275
- "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1276
- "fieldName": "autocomplete"
1282
+ "kind": "method",
1283
+ "name": "hideBib",
1284
+ "description": "Hides the dropdown bib if its open.",
1285
+ "return": {
1286
+ "type": {
1287
+ "text": "void"
1288
+ }
1289
+ }
1277
1290
  },
1278
1291
  {
1279
- "name": "autoPlacement",
1280
- "type": {
1281
- "text": "boolean"
1282
- },
1283
- "description": "If declared, bib's position will be automatically calculated where to appear.",
1284
- "fieldName": "autoPlacement"
1292
+ "kind": "method",
1293
+ "name": "showBib",
1294
+ "description": "Shows the dropdown bib if there are options to show.",
1295
+ "return": {
1296
+ "type": {
1297
+ "text": "void"
1298
+ }
1299
+ }
1285
1300
  },
1286
1301
  {
1287
- "name": "availableOptions",
1288
- "type": {
1289
- "text": "array"
1290
- },
1291
- "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).",
1292
- "fieldName": "availableOptions"
1302
+ "kind": "method",
1303
+ "name": "configureDropdown",
1304
+ "description": "Binds all behavior needed to the dropdown after rendering.",
1305
+ "privacy": "private",
1306
+ "return": {
1307
+ "type": {
1308
+ "text": "void"
1309
+ }
1310
+ }
1293
1311
  },
1294
1312
  {
1295
- "name": "behavior",
1296
- "type": {
1297
- "text": "'filter' | 'suggestion'"
1298
- },
1299
- "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.",
1300
- "default": "'suggestion'",
1301
- "fieldName": "behavior"
1313
+ "kind": "method",
1314
+ "name": "setClearBtnFocus",
1315
+ "privacy": "private"
1302
1316
  },
1303
1317
  {
1304
- "name": "checkmark",
1305
- "type": {
1306
- "text": "boolean"
1307
- },
1308
- "description": "When attribute is present auro-menu will apply check marks to selected options.",
1309
- "fieldName": "checkmark"
1318
+ "kind": "method",
1319
+ "name": "setTriggerInputFocus",
1320
+ "privacy": "private"
1310
1321
  },
1311
1322
  {
1312
- "name": "disabled",
1313
- "type": {
1314
- "text": "boolean"
1315
- },
1316
- "description": "If set, disables the combobox.",
1317
- "fieldName": "disabled"
1323
+ "kind": "method",
1324
+ "name": "setInputFocus",
1325
+ "privacy": "private"
1318
1326
  },
1319
1327
  {
1320
- "name": "dvInputOnly",
1321
- "type": {
1322
- "text": "boolean"
1323
- },
1324
- "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1325
- "fieldName": "dvInputOnly"
1328
+ "kind": "method",
1329
+ "name": "updateBibDialogRole",
1330
+ "description": "Suppresses or restores dialog semantics on the bib's dialog element.\nOn desktop (non-fullscreen), VoiceOver verbosely announces \"listbox inside\nof a dialog\" which disrupts combobox usage. Setting role=\"presentation\"\nsuppresses this. In fullscreen mode, dialog semantics are restored.",
1331
+ "privacy": "private"
1326
1332
  },
1327
1333
  {
1328
- "name": "error",
1329
- "type": {
1330
- "text": "string"
1331
- },
1332
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1333
- "fieldName": "error"
1334
+ "kind": "method",
1335
+ "name": "updateMenuShapeSize",
1336
+ "description": "Update menu to default for fullscreen bib, otherwise to this.size and this.shape.",
1337
+ "privacy": "private"
1334
1338
  },
1335
1339
  {
1336
- "name": "format",
1337
- "type": {
1338
- "text": "string"
1339
- },
1340
- "description": "Specifies the input mask format.",
1341
- "fieldName": "format"
1340
+ "kind": "method",
1341
+ "name": "_getAnnouncementRoot",
1342
+ "description": "Returns the shadow root containing the live region for screen reader announcements.\nWhen the bib is open in fullscreen modal mode, everything outside the <dialog>\nis inert, so we target the bib's own shadow root instead of the host's.",
1343
+ "privacy": "private",
1344
+ "return": {
1345
+ "type": {
1346
+ "text": "ShadowRoot"
1347
+ }
1348
+ }
1342
1349
  },
1343
1350
  {
1344
- "name": "inputmode",
1345
- "type": {
1346
- "text": "string"
1347
- },
1348
- "description": "Exposes inputmode attribute for input.",
1349
- "fieldName": "inputmode"
1351
+ "kind": "method",
1352
+ "name": "configureMenu",
1353
+ "description": "Binds all behavior needed to the menu after rendering.",
1354
+ "privacy": "private",
1355
+ "return": {
1356
+ "type": {
1357
+ "text": "void"
1358
+ }
1359
+ }
1350
1360
  },
1351
1361
  {
1352
- "name": "layout",
1353
- "type": {
1354
- "text": "string"
1355
- },
1356
- "description": "Sets the layout of the combobox.",
1357
- "default": "'classic'",
1358
- "fieldName": "layout",
1359
- "inheritedFrom": {
1360
- "name": "AuroElement",
1361
- "module": "components/layoutElement/src/auroElement.js"
1362
+ "kind": "method",
1363
+ "name": "configureInput",
1364
+ "description": "Binds all behavior needed to the input after rendering.",
1365
+ "privacy": "private",
1366
+ "return": {
1367
+ "type": {
1368
+ "text": "void"
1369
+ }
1362
1370
  }
1363
1371
  },
1364
1372
  {
1365
- "name": "matchWidth",
1366
- "type": {
1367
- "text": "boolean"
1368
- },
1369
- "description": "If declared, the popover and trigger will be set to the same width.",
1370
- "fieldName": "matchWidth"
1373
+ "kind": "method",
1374
+ "name": "handleMenuLoadingChange",
1375
+ "parameters": [
1376
+ {
1377
+ "name": "event",
1378
+ "description": "The event object containing details about the loading state change.",
1379
+ "type": {
1380
+ "text": "CustomEvent"
1381
+ }
1382
+ },
1383
+ {
1384
+ "description": "Indicates whether the menu is currently loading.",
1385
+ "name": "event.detail.loading",
1386
+ "type": {
1387
+ "text": "boolean"
1388
+ }
1389
+ },
1390
+ {
1391
+ "description": "Indicates if there are loading placeholders present.",
1392
+ "name": "event.detail.hasLoadingPlaceholder",
1393
+ "type": {
1394
+ "text": "boolean"
1395
+ }
1396
+ }
1397
+ ],
1398
+ "description": "Manages the visibility of the dropdown based on loading state changes.\n\nThis method listens for loading state changes and adjusts the visibility of the dropdown accordingly.\nIf the dropdown is visible and loading is true without any loading placeholders, it hides the dropdown\nand sets a flag to indicate it is hidden while loading. If loading is false and the dropdown was previously\nhidden, it checks if the active element is within the dropdown and shows it again if true.",
1399
+ "privacy": "private",
1400
+ "return": {
1401
+ "type": {
1402
+ "text": "void"
1403
+ }
1404
+ }
1371
1405
  },
1372
1406
  {
1373
- "name": "noFilter",
1374
- "type": {
1375
- "text": "boolean"
1376
- },
1377
- "description": "If set, combobox will not filter menuoptions based on input.",
1378
- "fieldName": "noFilter"
1407
+ "kind": "method",
1408
+ "name": "handleInputValueChange",
1409
+ "parameters": [
1410
+ {
1411
+ "name": "event",
1412
+ "description": "The input event triggered by the input element.",
1413
+ "type": {
1414
+ "text": "Event"
1415
+ }
1416
+ }
1417
+ ],
1418
+ "description": "Handle changes to the input value and trigger changes that should result.",
1419
+ "privacy": "private",
1420
+ "return": {
1421
+ "type": {
1422
+ "text": "void"
1423
+ }
1424
+ }
1379
1425
  },
1380
1426
  {
1381
- "name": "noFlip",
1382
- "type": {
1383
- "text": "boolean"
1384
- },
1385
- "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1386
- "fieldName": "noFlip"
1427
+ "kind": "method",
1428
+ "name": "configureCombobox",
1429
+ "description": "Binds all behavior needed to the combobox after rendering.",
1430
+ "privacy": "private",
1431
+ "return": {
1432
+ "type": {
1433
+ "text": "void"
1434
+ }
1435
+ }
1387
1436
  },
1388
1437
  {
1389
- "name": "shift",
1438
+ "kind": "method",
1439
+ "name": "focus",
1440
+ "description": "Focuses the combobox trigger input.",
1441
+ "return": {
1442
+ "type": {
1443
+ "text": "void"
1444
+ }
1445
+ }
1446
+ },
1447
+ {
1448
+ "kind": "method",
1449
+ "name": "setMenuValue",
1450
+ "parameters": [
1451
+ {
1452
+ "name": "value",
1453
+ "description": "The value to set on the menu.",
1454
+ "type": {
1455
+ "text": "string"
1456
+ }
1457
+ }
1458
+ ],
1459
+ "description": "Sets the menu value if menu is available.",
1460
+ "return": {
1461
+ "type": {
1462
+ "text": "void"
1463
+ }
1464
+ }
1465
+ },
1466
+ {
1467
+ "kind": "method",
1468
+ "name": "reset",
1469
+ "description": "Resets component to initial state.",
1470
+ "return": {
1471
+ "type": {
1472
+ "text": "void"
1473
+ }
1474
+ }
1475
+ },
1476
+ {
1477
+ "kind": "method",
1478
+ "name": "clear",
1479
+ "description": "Clears the current value of the combobox.",
1480
+ "return": {
1481
+ "type": {
1482
+ "text": "void"
1483
+ }
1484
+ }
1485
+ },
1486
+ {
1487
+ "kind": "method",
1488
+ "name": "validate",
1489
+ "parameters": [
1490
+ {
1491
+ "name": "force",
1492
+ "default": "false",
1493
+ "description": "Whether to force validation.",
1494
+ "optional": true,
1495
+ "type": {
1496
+ "text": "boolean"
1497
+ }
1498
+ }
1499
+ ],
1500
+ "description": "Validates value."
1501
+ },
1502
+ {
1503
+ "kind": "method",
1504
+ "name": "transportAssignedNodes",
1505
+ "parameters": [
1506
+ {
1507
+ "name": "slot",
1508
+ "description": "The slot element containing the nodes to apply.",
1509
+ "type": {
1510
+ "text": "HTMLSlotElement"
1511
+ }
1512
+ },
1513
+ {
1514
+ "name": "target",
1515
+ "description": "The target element to apply the nodes to.",
1516
+ "type": {
1517
+ "text": "HTMLElement"
1518
+ }
1519
+ },
1520
+ {
1521
+ "name": "newSlotName",
1522
+ "description": "The new slot name for the applied nodes.",
1523
+ "type": {
1524
+ "text": "string"
1525
+ }
1526
+ }
1527
+ ],
1528
+ "description": "Applies slotted nodes to a target element with a new slot name.",
1529
+ "privacy": "private",
1530
+ "return": {
1531
+ "type": {
1532
+ "text": "void"
1533
+ }
1534
+ }
1535
+ },
1536
+ {
1537
+ "kind": "method",
1538
+ "name": "updateActiveOption",
1539
+ "parameters": [
1540
+ {
1541
+ "name": "index",
1542
+ "description": "Index of the option to make active.",
1543
+ "type": {
1544
+ "text": "number"
1545
+ }
1546
+ }
1547
+ ],
1548
+ "description": "Updates the active option in the menu."
1549
+ },
1550
+ {
1551
+ "kind": "method",
1552
+ "name": "handleSlotChange",
1553
+ "parameters": [
1554
+ {
1555
+ "name": "event",
1556
+ "description": "`slotchange` event.",
1557
+ "type": {
1558
+ "text": "Event"
1559
+ }
1560
+ }
1561
+ ],
1562
+ "description": "Watch for slot changes and recalculate the menuoptions.",
1563
+ "privacy": "private",
1564
+ "return": {
1565
+ "type": {
1566
+ "text": "void"
1567
+ }
1568
+ }
1569
+ },
1570
+ {
1571
+ "kind": "field",
1572
+ "name": "appearance",
1573
+ "privacy": "public",
1390
1574
  "type": {
1391
- "text": "boolean"
1575
+ "text": "string"
1392
1576
  },
1393
- "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1394
- "fieldName": "shift"
1577
+ "description": "Defines whether the component will be on lighter or darker backgrounds.",
1578
+ "default": "'default'",
1579
+ "attribute": "appearance",
1580
+ "reflects": true
1395
1581
  },
1396
1582
  {
1397
- "name": "noValidate",
1583
+ "kind": "field",
1584
+ "name": "autocomplete",
1585
+ "privacy": "public",
1398
1586
  "type": {
1399
- "text": "boolean"
1587
+ "text": "string"
1400
1588
  },
1401
- "description": "If set, disables auto-validation on blur.",
1402
- "fieldName": "noValidate"
1589
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
1590
+ "attribute": "autocomplete",
1591
+ "reflects": true
1403
1592
  },
1404
1593
  {
1405
- "name": "offset",
1594
+ "kind": "field",
1595
+ "name": "autoPlacement",
1596
+ "privacy": "public",
1406
1597
  "type": {
1407
- "text": "number"
1598
+ "text": "boolean"
1408
1599
  },
1409
- "description": "Gap between the trigger element and bib.",
1410
- "default": "0",
1411
- "fieldName": "offset"
1600
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
1601
+ "attribute": "autoPlacement",
1602
+ "reflects": true
1412
1603
  },
1413
1604
  {
1414
- "name": "onDark",
1605
+ "kind": "field",
1606
+ "name": "availableOptions",
1607
+ "privacy": "private",
1415
1608
  "type": {
1416
- "text": "boolean"
1609
+ "text": "array"
1417
1610
  },
1418
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1419
- "fieldName": "onDark"
1611
+ "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
1612
+ "attribute": "availableOptions"
1420
1613
  },
1421
1614
  {
1422
- "name": "optionSelected",
1615
+ "kind": "field",
1616
+ "name": "behavior",
1617
+ "privacy": "public",
1423
1618
  "type": {
1424
- "text": "HTMLElement"
1619
+ "text": "'filter' | 'suggestion'"
1425
1620
  },
1426
- "description": "Specifies the current selected option.",
1427
- "fieldName": "optionSelected"
1621
+ "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
1622
+ "default": "'suggestion'",
1623
+ "attribute": "behavior",
1624
+ "reflects": true
1428
1625
  },
1429
1626
  {
1430
- "name": "persistInput",
1627
+ "kind": "field",
1628
+ "name": "checkmark",
1629
+ "privacy": "public",
1431
1630
  "type": {
1432
1631
  "text": "boolean"
1433
1632
  },
1434
- "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.",
1435
- "fieldName": "persistInput"
1633
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
1634
+ "attribute": "checkmark",
1635
+ "reflects": true
1436
1636
  },
1437
1637
  {
1438
- "name": "placement",
1638
+ "kind": "field",
1639
+ "name": "disabled",
1640
+ "privacy": "public",
1439
1641
  "type": {
1440
- "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1642
+ "text": "boolean"
1441
1643
  },
1442
- "description": "Position where the bib should appear relative to the trigger.",
1443
- "default": "'bottom-start'",
1444
- "fieldName": "placement"
1644
+ "description": "If set, disables the combobox.",
1645
+ "attribute": "disabled",
1646
+ "reflects": true
1445
1647
  },
1446
1648
  {
1447
- "name": "placeholder",
1649
+ "kind": "field",
1650
+ "name": "dropdownId",
1651
+ "privacy": "private",
1448
1652
  "type": {
1449
1653
  "text": "string"
1450
1654
  },
1451
- "description": "Define custom placeholder text, only supported by date input formats.",
1452
- "fieldName": "placeholder"
1655
+ "description": "ID for the dropdown."
1453
1656
  },
1454
1657
  {
1455
- "name": "required",
1658
+ "kind": "field",
1659
+ "name": "dropdownOpen",
1660
+ "privacy": "private",
1456
1661
  "type": {
1457
1662
  "text": "boolean"
1458
1663
  },
1459
- "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1460
- "fieldName": "required"
1664
+ "description": "Whether or not the dropdown is open."
1461
1665
  },
1462
1666
  {
1463
- "name": "setCustomValidity",
1667
+ "kind": "field",
1668
+ "name": "dvInputOnly",
1669
+ "privacy": "public",
1464
1670
  "type": {
1465
- "text": "string"
1671
+ "text": "boolean"
1466
1672
  },
1467
- "description": "Sets a custom help text message to display for all validityStates.",
1468
- "fieldName": "setCustomValidity"
1673
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
1674
+ "attribute": "dvInputOnly",
1675
+ "reflects": true
1469
1676
  },
1470
1677
  {
1471
- "name": "setCustomValidityCustomError",
1678
+ "kind": "field",
1679
+ "name": "error",
1680
+ "privacy": "public",
1472
1681
  "type": {
1473
1682
  "text": "string"
1474
1683
  },
1475
- "description": "Custom help text message to display when validity = `customError`.",
1476
- "fieldName": "setCustomValidityCustomError"
1684
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1685
+ "attribute": "error",
1686
+ "reflects": true
1477
1687
  },
1478
1688
  {
1479
- "name": "setCustomValidityValueMissing",
1689
+ "kind": "field",
1690
+ "name": "format",
1691
+ "privacy": "public",
1480
1692
  "type": {
1481
1693
  "text": "string"
1482
1694
  },
1483
- "description": "Custom help text message to display when validity = `valueMissing`.",
1484
- "fieldName": "setCustomValidityValueMissing"
1695
+ "description": "Specifies the input mask format.",
1696
+ "attribute": "format",
1697
+ "reflects": true
1485
1698
  },
1486
1699
  {
1487
- "name": "setCustomValidityValueMissingFilter",
1700
+ "kind": "field",
1701
+ "name": "inputmode",
1702
+ "privacy": "public",
1488
1703
  "type": {
1489
1704
  "text": "string"
1490
1705
  },
1491
- "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1492
- "fieldName": "setCustomValidityValueMissingFilter"
1706
+ "description": "Exposes inputmode attribute for input.",
1707
+ "attribute": "inputmode",
1708
+ "reflects": true
1493
1709
  },
1494
1710
  {
1495
- "name": "triggerIcon",
1711
+ "kind": "field",
1712
+ "name": "layout",
1713
+ "privacy": "public",
1496
1714
  "type": {
1497
- "text": "boolean"
1715
+ "text": "string"
1498
1716
  },
1499
- "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1500
- "fieldName": "triggerIcon"
1717
+ "description": "Sets the layout of the combobox.",
1718
+ "default": "'classic'",
1719
+ "attribute": "layout",
1720
+ "reflects": true,
1721
+ "inheritedFrom": {
1722
+ "name": "AuroElement",
1723
+ "module": "components/layoutElement/src/auroElement.js"
1724
+ }
1501
1725
  },
1502
1726
  {
1503
- "name": "type",
1727
+ "kind": "field",
1728
+ "name": "matchWidth",
1729
+ "privacy": "private",
1504
1730
  "type": {
1505
- "text": "string"
1731
+ "text": "boolean"
1506
1732
  },
1507
- "description": "Applies the defined value as the type attribute on `auro-input`.",
1508
- "fieldName": "type"
1733
+ "description": "If declared, the popover and trigger will be set to the same width.",
1734
+ "attribute": "matchWidth",
1735
+ "reflects": true
1509
1736
  },
1510
1737
  {
1511
- "name": "typedValue",
1738
+ "kind": "field",
1739
+ "name": "noFilter",
1740
+ "privacy": "public",
1512
1741
  "type": {
1513
- "text": "string"
1742
+ "text": "boolean"
1514
1743
  },
1515
- "description": "Specifies the value of the input element within the combobox.",
1516
- "fieldName": "typedValue"
1744
+ "description": "If set, combobox will not filter menuoptions based on input.",
1745
+ "attribute": "noFilter",
1746
+ "reflects": true
1517
1747
  },
1518
1748
  {
1519
- "name": "validity",
1749
+ "kind": "field",
1750
+ "name": "noFlip",
1751
+ "privacy": "public",
1520
1752
  "type": {
1521
- "text": "string"
1753
+ "text": "boolean"
1522
1754
  },
1523
- "description": "Specifies the `validityState` this element is in.",
1524
- "fieldName": "validity"
1755
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
1756
+ "attribute": "noFlip",
1757
+ "reflects": true
1525
1758
  },
1526
1759
  {
1527
- "name": "value",
1760
+ "kind": "field",
1761
+ "name": "shift",
1762
+ "privacy": "public",
1528
1763
  "type": {
1529
- "text": "string"
1764
+ "text": "boolean"
1530
1765
  },
1531
- "description": "Value selected for the dropdown menu.",
1532
- "fieldName": "value"
1766
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
1767
+ "attribute": "shift",
1768
+ "reflects": true
1533
1769
  },
1534
1770
  {
1535
- "name": "largeFullscreenHeadline",
1771
+ "kind": "field",
1772
+ "name": "noValidate",
1773
+ "privacy": "public",
1536
1774
  "type": {
1537
1775
  "text": "boolean"
1538
1776
  },
1539
- "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1540
- "fieldName": "largeFullscreenHeadline"
1777
+ "description": "If set, disables auto-validation on blur.",
1778
+ "attribute": "noValidate",
1779
+ "reflects": true
1541
1780
  },
1542
1781
  {
1543
- "name": "fullscreenBreakpoint",
1782
+ "kind": "field",
1783
+ "name": "offset",
1784
+ "privacy": "public",
1544
1785
  "type": {
1545
- "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1786
+ "text": "number"
1546
1787
  },
1547
- "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.",
1548
- "default": "'sm'",
1549
- "fieldName": "fullscreenBreakpoint"
1788
+ "description": "Gap between the trigger element and bib.",
1789
+ "default": "0",
1790
+ "attribute": "offset",
1791
+ "reflects": true
1550
1792
  },
1551
1793
  {
1552
- "name": "shape",
1794
+ "kind": "field",
1795
+ "name": "onDark",
1796
+ "privacy": "public",
1553
1797
  "type": {
1554
- "text": "string"
1798
+ "text": "boolean"
1555
1799
  },
1556
- "fieldName": "shape",
1800
+ "attribute": "onDark",
1801
+ "reflects": true,
1802
+ "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1557
1803
  "inheritedFrom": {
1558
1804
  "name": "AuroElement",
1559
1805
  "module": "components/layoutElement/src/auroElement.js"
1560
1806
  }
1561
1807
  },
1562
1808
  {
1563
- "name": "size",
1809
+ "kind": "field",
1810
+ "name": "optionSelected",
1811
+ "privacy": "public",
1564
1812
  "type": {
1565
- "text": "string"
1813
+ "text": "HTMLElement"
1566
1814
  },
1567
- "fieldName": "size",
1568
- "inheritedFrom": {
1569
- "name": "AuroElement",
1570
- "module": "components/layoutElement/src/auroElement.js"
1571
- }
1815
+ "description": "Specifies the current selected option.",
1816
+ "attribute": "optionSelected"
1572
1817
  },
1573
1818
  {
1574
- "name": "ondark",
1819
+ "kind": "field",
1820
+ "name": "persistInput",
1821
+ "privacy": "public",
1575
1822
  "type": {
1576
1823
  "text": "boolean"
1577
1824
  },
1578
- "fieldName": "onDark",
1579
- "inheritedFrom": {
1580
- "name": "AuroElement",
1581
- "module": "components/layoutElement/src/auroElement.js"
1582
- }
1583
- }
1584
- ],
1585
- "superclass": {
1586
- "name": "AuroElement",
1587
- "module": "/components/layoutElement/src/auroElement.js"
1588
- },
1589
- "tagName": "auro-combobox",
1590
- "customElement": true
1591
- }
1592
- ],
1593
- "exports": [
1594
- {
1595
- "kind": "js",
1596
- "name": "AuroCombobox",
1597
- "declaration": {
1598
- "name": "AuroCombobox",
1599
- "module": "components/combobox/src/auro-combobox.js"
1600
- }
1601
- }
1602
- ]
1603
- },
1604
- {
1605
- "kind": "javascript-module",
1606
- "path": "components/combobox/src/comboboxKeyboardStrategy.js",
1607
- "declarations": [
1608
- {
1609
- "kind": "variable",
1610
- "name": "comboboxKeyboardStrategy",
1611
- "type": {
1612
- "text": "object"
1613
- },
1614
- "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { navigateArrow(component, 'down'); } } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
1615
- }
1616
- ],
1617
- "exports": [
1618
- {
1619
- "kind": "js",
1620
- "name": "comboboxKeyboardStrategy",
1621
- "declaration": {
1622
- "name": "comboboxKeyboardStrategy",
1623
- "module": "components/combobox/src/comboboxKeyboardStrategy.js"
1624
- }
1625
- }
1626
- ]
1627
- },
1628
- {
1629
- "kind": "javascript-module",
1630
- "path": "components/combobox/src/index.js",
1631
- "declarations": [],
1632
- "exports": [
1633
- {
1634
- "kind": "js",
1635
- "name": "AuroCombobox",
1636
- "declaration": {
1637
- "name": "AuroCombobox",
1638
- "module": "components/combobox/src/index.js"
1639
- }
1640
- }
1641
- ]
1642
- },
1643
- {
1644
- "kind": "javascript-module",
1645
- "path": "components/combobox/src/registered.js",
1646
- "declarations": [],
1647
- "exports": [
1648
- {
1649
- "kind": "js",
1650
- "name": "AuroCombobox",
1651
- "declaration": {
1652
- "name": "AuroCombobox",
1653
- "module": "components/combobox/src/registered.js"
1654
- }
1655
- }
1656
- ]
1657
- },
1658
- {
1659
- "kind": "javascript-module",
1660
- "path": "components/checkbox/src/auro-checkbox-group.js",
1661
- "declarations": [
1662
- {
1663
- "kind": "class",
1664
- "description": "The `auro-checkbox-group` element is a wrapper for `auro-checkbox` elements.",
1665
- "name": "AuroCheckboxGroup",
1666
- "slots": [
1667
- {
1668
- "description": "Allows for the legend to be overridden.",
1669
- "name": "legend"
1670
- },
1671
- {
1672
- "description": "Allows overriding the optional display text \"(optional)\", which appears next to the label.",
1673
- "name": "optionalLabel"
1825
+ "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
1826
+ "attribute": "persistInput",
1827
+ "reflects": true
1674
1828
  },
1675
1829
  {
1676
- "description": "Allows for the helper text to be overridden.",
1677
- "name": "helpText"
1830
+ "kind": "field",
1831
+ "name": "placement",
1832
+ "privacy": "public",
1833
+ "type": {
1834
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
1835
+ },
1836
+ "description": "Position where the bib should appear relative to the trigger.",
1837
+ "default": "'bottom-start'",
1838
+ "attribute": "placement",
1839
+ "reflects": true
1678
1840
  },
1679
1841
  {
1680
- "description": "The default slot for the checkbox items.",
1681
- "name": "default"
1682
- }
1683
- ],
1684
- "members": [
1685
- {
1686
- "kind": "method",
1687
- "name": "_initializeDefaults"
1842
+ "kind": "field",
1843
+ "name": "placeholder",
1844
+ "privacy": "public",
1845
+ "type": {
1846
+ "text": "string"
1847
+ },
1848
+ "description": "Define custom placeholder text, only supported by date input formats.",
1849
+ "attribute": "placeholder",
1850
+ "reflects": true
1688
1851
  },
1689
1852
  {
1690
- "kind": "method",
1691
- "name": "register",
1692
- "static": true,
1693
- "parameters": [
1694
- {
1695
- "name": "name",
1696
- "default": "\"auro-checkbox-group\"",
1697
- "description": "The name of the element that you want to register.",
1698
- "optional": true,
1699
- "type": {
1700
- "text": "string"
1701
- }
1702
- }
1703
- ],
1704
- "description": "This will register this element with the browser."
1853
+ "kind": "field",
1854
+ "name": "required",
1855
+ "privacy": "public",
1856
+ "type": {
1857
+ "text": "boolean"
1858
+ },
1859
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
1860
+ "attribute": "required",
1861
+ "reflects": true
1705
1862
  },
1706
1863
  {
1707
- "kind": "method",
1708
- "name": "handleValueUpdate",
1709
- "parameters": [
1710
- {
1711
- "name": "value",
1712
- "description": "The value of the checkbox.",
1713
- "type": {
1714
- "text": "String"
1715
- }
1716
- },
1717
- {
1718
- "name": "selected",
1719
- "description": "The checked state of the checkbox.",
1720
- "type": {
1721
- "text": "Boolean"
1722
- }
1723
- }
1724
- ],
1725
- "description": "Helper method to handle checkbox value changing.",
1726
- "privacy": "private",
1727
- "return": {
1728
- "type": {
1729
- "text": "void"
1730
- }
1731
- }
1864
+ "kind": "field",
1865
+ "name": "setCustomValidity",
1866
+ "privacy": "public",
1867
+ "type": {
1868
+ "text": "string"
1869
+ },
1870
+ "description": "Sets a custom help text message to display for all validityStates.",
1871
+ "attribute": "setCustomValidity"
1732
1872
  },
1733
1873
  {
1734
- "kind": "method",
1735
- "name": "handlePreselectedItems",
1736
- "description": "Helper method that handles the state of preselected checkboxes.",
1737
- "privacy": "private",
1738
- "return": {
1739
- "type": {
1740
- "text": "void"
1741
- }
1742
- }
1874
+ "kind": "field",
1875
+ "name": "setCustomValidityCustomError",
1876
+ "privacy": "public",
1877
+ "type": {
1878
+ "text": "string"
1879
+ },
1880
+ "description": "Custom help text message to display when validity = `customError`.",
1881
+ "attribute": "setCustomValidityCustomError"
1743
1882
  },
1744
1883
  {
1745
- "kind": "method",
1746
- "name": "handleItems",
1747
- "description": "Helper method that handles the state of checkboxes.",
1748
- "privacy": "private",
1749
- "return": {
1750
- "type": {
1751
- "text": "void"
1752
- }
1753
- }
1884
+ "kind": "field",
1885
+ "name": "setCustomValidityValueMissing",
1886
+ "privacy": "public",
1887
+ "type": {
1888
+ "text": "string"
1889
+ },
1890
+ "description": "Custom help text message to display when validity = `valueMissing`.",
1891
+ "attribute": "setCustomValidityValueMissing"
1754
1892
  },
1755
1893
  {
1756
- "kind": "method",
1757
- "name": "reset",
1758
- "description": "Resets component to initial state.",
1759
- "return": {
1760
- "type": {
1761
- "text": "void"
1762
- }
1763
- }
1894
+ "kind": "field",
1895
+ "name": "setCustomValidityValueMissingFilter",
1896
+ "privacy": "public",
1897
+ "type": {
1898
+ "text": "string"
1899
+ },
1900
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
1901
+ "attribute": "setCustomValidityValueMissingFilter"
1764
1902
  },
1765
1903
  {
1766
- "kind": "method",
1767
- "name": "validate",
1768
- "parameters": [
1769
- {
1770
- "name": "force",
1771
- "default": "false",
1772
- "description": "Whether to force validation.",
1773
- "optional": true,
1774
- "type": {
1775
- "text": "boolean"
1776
- }
1777
- }
1778
- ],
1779
- "description": "Validates value."
1904
+ "kind": "field",
1905
+ "name": "touched",
1906
+ "privacy": "private",
1907
+ "type": {
1908
+ "text": "boolean"
1909
+ },
1910
+ "description": "Indicates whether the combobox is in a dirty state (has been interacted with)."
1780
1911
  },
1781
1912
  {
1782
1913
  "kind": "field",
1783
- "name": "appearance",
1914
+ "name": "triggerIcon",
1784
1915
  "privacy": "public",
1785
1916
  "type": {
1786
- "text": "'default' | 'inverse'"
1917
+ "text": "boolean"
1787
1918
  },
1788
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
1789
- "default": "'default'",
1790
- "attribute": "appearance",
1919
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
1920
+ "attribute": "triggerIcon",
1791
1921
  "reflects": true
1792
1922
  },
1793
1923
  {
1794
1924
  "kind": "field",
1795
- "name": "disabled",
1925
+ "name": "type",
1796
1926
  "privacy": "public",
1797
1927
  "type": {
1798
- "text": "boolean"
1928
+ "text": "string"
1799
1929
  },
1800
- "description": "If set, disables the checkbox group.",
1801
- "attribute": "disabled",
1930
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
1931
+ "attribute": "type",
1802
1932
  "reflects": true
1803
1933
  },
1804
1934
  {
1805
1935
  "kind": "field",
1806
- "name": "error",
1936
+ "name": "typedValue",
1807
1937
  "privacy": "public",
1808
1938
  "type": {
1809
1939
  "text": "string"
1810
1940
  },
1811
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1812
- "attribute": "error",
1941
+ "description": "Specifies the value of the input element within the combobox.",
1942
+ "attribute": "typedValue",
1813
1943
  "reflects": true
1814
1944
  },
1815
1945
  {
1816
1946
  "kind": "field",
1817
- "name": "horizontal",
1947
+ "name": "validity",
1818
1948
  "privacy": "public",
1819
1949
  "type": {
1820
- "text": "boolean"
1950
+ "text": "string"
1821
1951
  },
1822
- "description": "If set, checkboxes will be aligned horizontally.",
1823
- "attribute": "horizontal",
1952
+ "description": "Specifies the `validityState` this element is in.",
1953
+ "attribute": "validity",
1824
1954
  "reflects": true
1825
1955
  },
1826
1956
  {
1827
1957
  "kind": "field",
1828
- "name": "noValidate",
1958
+ "name": "value",
1829
1959
  "privacy": "public",
1830
1960
  "type": {
1831
- "text": "boolean"
1961
+ "text": "string"
1832
1962
  },
1833
- "description": "If set, disables auto-validation on blur.",
1834
- "attribute": "noValidate",
1835
- "reflects": true
1963
+ "description": "Value selected for the dropdown menu.",
1964
+ "attribute": "value"
1836
1965
  },
1837
1966
  {
1838
1967
  "kind": "field",
1839
- "name": "onDark",
1968
+ "name": "largeFullscreenHeadline",
1840
1969
  "privacy": "public",
1841
1970
  "type": {
1842
1971
  "text": "boolean"
1843
1972
  },
1844
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1845
- "attribute": "onDark",
1973
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
1974
+ "attribute": "largeFullscreenHeadline",
1846
1975
  "reflects": true
1847
1976
  },
1848
1977
  {
1849
1978
  "kind": "field",
1850
- "name": "required",
1979
+ "name": "fullscreenBreakpoint",
1851
1980
  "privacy": "public",
1852
1981
  "type": {
1853
- "text": "boolean"
1982
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
1854
1983
  },
1855
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1856
- "attribute": "required",
1984
+ "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
1985
+ "default": "'sm'",
1986
+ "attribute": "fullscreenBreakpoint",
1857
1987
  "reflects": true
1858
1988
  },
1859
1989
  {
1860
1990
  "kind": "field",
1861
- "name": "setCustomValidity",
1862
- "privacy": "public",
1991
+ "name": "optionActive",
1992
+ "privacy": "private",
1863
1993
  "type": {
1864
- "text": "string"
1994
+ "text": "object"
1865
1995
  },
1866
- "description": "Sets a custom help text message to display for all validityStates.",
1867
- "attribute": "setCustomValidity"
1996
+ "description": "Specifies the currently active option."
1868
1997
  },
1869
1998
  {
1870
1999
  "kind": "field",
1871
- "name": "setCustomValidityCustomError",
1872
- "privacy": "public",
2000
+ "name": "triggerExpandedState",
2001
+ "privacy": "private",
1873
2002
  "type": {
1874
- "text": "string"
2003
+ "text": "boolean"
1875
2004
  },
1876
- "description": "Custom help text message to display when validity = `customError`.",
1877
- "attribute": "setCustomValidityCustomError"
2005
+ "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
1878
2006
  },
1879
2007
  {
1880
2008
  "kind": "field",
1881
- "name": "setCustomValidityValueMissing",
2009
+ "name": "componentHasFocus",
2010
+ "description": "Returns true if the element has focus.",
2011
+ "privacy": "private",
2012
+ "return": {
2013
+ "type": {
2014
+ "text": "boolean"
2015
+ }
2016
+ },
2017
+ "readonly": true,
2018
+ "inheritedFrom": {
2019
+ "name": "AuroElement",
2020
+ "module": "components/layoutElement/src/auroElement.js"
2021
+ }
2022
+ },
2023
+ {
2024
+ "kind": "method",
2025
+ "name": "resetShapeClasses",
2026
+ "inheritedFrom": {
2027
+ "name": "AuroElement",
2028
+ "module": "components/layoutElement/src/auroElement.js"
2029
+ }
2030
+ },
2031
+ {
2032
+ "kind": "method",
2033
+ "name": "resetLayoutClasses",
2034
+ "inheritedFrom": {
2035
+ "name": "AuroElement",
2036
+ "module": "components/layoutElement/src/auroElement.js"
2037
+ }
2038
+ },
2039
+ {
2040
+ "kind": "method",
2041
+ "name": "updateComponentArchitecture",
2042
+ "inheritedFrom": {
2043
+ "name": "AuroElement",
2044
+ "module": "components/layoutElement/src/auroElement.js"
2045
+ }
2046
+ },
2047
+ {
2048
+ "kind": "field",
2049
+ "name": "shape",
1882
2050
  "privacy": "public",
1883
2051
  "type": {
1884
2052
  "text": "string"
1885
2053
  },
1886
- "description": "Custom help text message to display when validity = `valueMissing`.",
1887
- "attribute": "setCustomValidityValueMissing"
2054
+ "attribute": "shape",
2055
+ "reflects": true,
2056
+ "inheritedFrom": {
2057
+ "name": "AuroElement",
2058
+ "module": "components/layoutElement/src/auroElement.js"
2059
+ }
1888
2060
  },
1889
2061
  {
1890
2062
  "kind": "field",
1891
- "name": "validity",
2063
+ "name": "size",
1892
2064
  "privacy": "public",
1893
2065
  "type": {
1894
2066
  "text": "string"
1895
2067
  },
1896
- "description": "Specifies the `validityState` this element is in.",
1897
- "attribute": "validity",
1898
- "reflects": true
2068
+ "attribute": "size",
2069
+ "reflects": true,
2070
+ "inheritedFrom": {
2071
+ "name": "AuroElement",
2072
+ "module": "components/layoutElement/src/auroElement.js"
2073
+ }
1899
2074
  }
1900
2075
  ],
1901
2076
  "events": [
2077
+ {
2078
+ "name": "inputValue",
2079
+ "type": {
2080
+ "text": "CustomEvent"
2081
+ },
2082
+ "description": "Notifies that the components internal HTML5 input value has changed."
2083
+ },
1902
2084
  {
1903
2085
  "name": "input",
1904
2086
  "type": {
1905
2087
  "text": "CustomEvent"
1906
- }
2088
+ },
2089
+ "description": "Notifies that the component has a new value set."
1907
2090
  },
1908
2091
  {
1909
- "description": "Notifies that the `validity` and `errorMessage` values have changed.",
2092
+ "name": "auroCombobox-valueSet",
2093
+ "type": {
2094
+ "text": "CustomEvent"
2095
+ },
2096
+ "description": "(Deprecated) Notifies that the component has a new value set."
2097
+ },
2098
+ {
2099
+ "description": "Notifies that the component value(s) have been validated.",
1910
2100
  "name": "auroFormElement-validated"
1911
2101
  }
1912
2102
  ],
@@ -1914,589 +2104,399 @@
1914
2104
  {
1915
2105
  "name": "appearance",
1916
2106
  "type": {
1917
- "text": "'default' | 'inverse'"
2107
+ "text": "string"
1918
2108
  },
1919
2109
  "description": "Defines whether the component will be on lighter or darker backgrounds.",
1920
2110
  "default": "'default'",
1921
2111
  "fieldName": "appearance"
1922
2112
  },
1923
2113
  {
1924
- "name": "disabled",
2114
+ "name": "autocomplete",
2115
+ "type": {
2116
+ "text": "string"
2117
+ },
2118
+ "description": "An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete=\"off\"` is supported.",
2119
+ "fieldName": "autocomplete"
2120
+ },
2121
+ {
2122
+ "name": "autoPlacement",
1925
2123
  "type": {
1926
2124
  "text": "boolean"
1927
2125
  },
1928
- "description": "If set, disables the checkbox group.",
1929
- "fieldName": "disabled"
2126
+ "description": "If declared, bib's position will be automatically calculated where to appear.",
2127
+ "fieldName": "autoPlacement"
1930
2128
  },
1931
2129
  {
1932
- "name": "error",
2130
+ "name": "availableOptions",
1933
2131
  "type": {
1934
- "text": "string"
2132
+ "text": "array"
1935
2133
  },
1936
- "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
1937
- "fieldName": "error"
2134
+ "description": "Array of available options to display in the dropdown.\nThis array contains all non-hidden options (e.g., hidden by filtering on input value).",
2135
+ "fieldName": "availableOptions"
1938
2136
  },
1939
2137
  {
1940
- "name": "horizontal",
2138
+ "name": "behavior",
1941
2139
  "type": {
1942
- "text": "boolean"
2140
+ "text": "'filter' | 'suggestion'"
1943
2141
  },
1944
- "description": "If set, checkboxes will be aligned horizontally.",
1945
- "fieldName": "horizontal"
2142
+ "description": "Sets the behavior of the combobox, \"filter\" or \"suggestion\".\n\"filter\" requires the user to select an option from the menu.\n\"suggestion\" allows the user to enter a value not present in the menu options.",
2143
+ "default": "'suggestion'",
2144
+ "fieldName": "behavior"
1946
2145
  },
1947
2146
  {
1948
- "name": "noValidate",
2147
+ "name": "checkmark",
1949
2148
  "type": {
1950
2149
  "text": "boolean"
1951
2150
  },
1952
- "description": "If set, disables auto-validation on blur.",
1953
- "fieldName": "noValidate"
2151
+ "description": "When attribute is present auro-menu will apply check marks to selected options.",
2152
+ "fieldName": "checkmark"
1954
2153
  },
1955
2154
  {
1956
- "name": "onDark",
2155
+ "name": "disabled",
1957
2156
  "type": {
1958
2157
  "text": "boolean"
1959
2158
  },
1960
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
1961
- "fieldName": "onDark"
2159
+ "description": "If set, disables the combobox.",
2160
+ "fieldName": "disabled"
1962
2161
  },
1963
2162
  {
1964
- "name": "required",
2163
+ "name": "dvInputOnly",
1965
2164
  "type": {
1966
2165
  "text": "boolean"
1967
2166
  },
1968
- "description": "Populates the `required` attribute on the element. Used for client-side validation.",
1969
- "fieldName": "required"
2167
+ "description": "If defined, the display value slot content will only mask the HTML5 input element. The inputs label will not be masked.",
2168
+ "fieldName": "dvInputOnly"
1970
2169
  },
1971
2170
  {
1972
- "name": "setCustomValidity",
2171
+ "name": "error",
1973
2172
  "type": {
1974
2173
  "text": "string"
1975
2174
  },
1976
- "description": "Sets a custom help text message to display for all validityStates.",
1977
- "fieldName": "setCustomValidity"
2175
+ "description": "When defined, sets persistent validity to `customError` and sets the validation message to the attribute value.",
2176
+ "fieldName": "error"
1978
2177
  },
1979
2178
  {
1980
- "name": "setCustomValidityCustomError",
2179
+ "name": "format",
1981
2180
  "type": {
1982
2181
  "text": "string"
1983
2182
  },
1984
- "description": "Custom help text message to display when validity = `customError`.",
1985
- "fieldName": "setCustomValidityCustomError"
2183
+ "description": "Specifies the input mask format.",
2184
+ "fieldName": "format"
1986
2185
  },
1987
2186
  {
1988
- "name": "setCustomValidityValueMissing",
2187
+ "name": "inputmode",
1989
2188
  "type": {
1990
2189
  "text": "string"
1991
2190
  },
1992
- "description": "Custom help text message to display when validity = `valueMissing`.",
1993
- "fieldName": "setCustomValidityValueMissing"
2191
+ "description": "Exposes inputmode attribute for input.",
2192
+ "fieldName": "inputmode"
1994
2193
  },
1995
2194
  {
1996
- "name": "validity",
2195
+ "name": "layout",
1997
2196
  "type": {
1998
2197
  "text": "string"
1999
2198
  },
2000
- "description": "Specifies the `validityState` this element is in.",
2001
- "fieldName": "validity"
2002
- }
2003
- ],
2004
- "superclass": {
2005
- "name": "LitElement",
2006
- "package": "lit"
2007
- },
2008
- "tagName": "auro-checkbox-group",
2009
- "customElement": true
2010
- }
2011
- ],
2012
- "exports": [
2013
- {
2014
- "kind": "js",
2015
- "name": "AuroCheckboxGroup",
2016
- "declaration": {
2017
- "name": "AuroCheckboxGroup",
2018
- "module": "components/checkbox/src/auro-checkbox-group.js"
2019
- }
2020
- }
2021
- ]
2022
- },
2023
- {
2024
- "kind": "javascript-module",
2025
- "path": "components/checkbox/src/auro-checkbox.js",
2026
- "declarations": [
2027
- {
2028
- "kind": "class",
2029
- "description": "The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.",
2030
- "name": "AuroCheckbox",
2031
- "cssParts": [
2032
- {
2033
- "description": "apply css to a specific checkbox.",
2034
- "name": "checkbox"
2035
- },
2036
- {
2037
- "description": "apply css to a specific checkbox's input.",
2038
- "name": "checkbox-input"
2039
- },
2040
- {
2041
- "description": "apply css to a specific checkbox's label.",
2042
- "name": "checkbox-label"
2043
- }
2044
- ],
2045
- "slots": [
2046
- {
2047
- "description": "The default slot for the checkbox label.",
2048
- "name": "default"
2049
- }
2050
- ],
2051
- "members": [
2052
- {
2053
- "kind": "method",
2054
- "name": "_initializeDefaults"
2055
- },
2056
- {
2057
- "kind": "method",
2058
- "name": "register",
2059
- "static": true,
2060
- "parameters": [
2061
- {
2062
- "name": "name",
2063
- "default": "\"auro-checkbox\"",
2064
- "description": "The name of element that you want to register to.",
2065
- "optional": true,
2066
- "type": {
2067
- "text": "string"
2068
- }
2069
- }
2070
- ],
2071
- "description": "This will register this element with the browser."
2072
- },
2073
- {
2074
- "kind": "method",
2075
- "name": "handleChange",
2076
- "parameters": [
2077
- {
2078
- "name": "event",
2079
- "description": "The change event from the checkbox input.",
2080
- "type": {
2081
- "text": "Event"
2082
- }
2083
- }
2084
- ],
2085
- "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.",
2086
- "privacy": "private",
2087
- "return": {
2088
- "type": {
2089
- "text": "void"
2090
- }
2091
- }
2092
- },
2093
- {
2094
- "kind": "method",
2095
- "name": "handleInput",
2096
- "parameters": [
2097
- {
2098
- "name": "event",
2099
- "description": "The input event from the checkbox input.",
2100
- "type": {
2101
- "text": "Event"
2102
- }
2103
- }
2104
- ],
2105
- "description": "Handles the input event for the checkbox input.\nUpdates the checked state and dispatches a custom 'auroCheckbox-input' event.",
2106
- "privacy": "private",
2107
- "return": {
2108
- "type": {
2109
- "text": "void"
2110
- }
2111
- }
2112
- },
2113
- {
2114
- "kind": "method",
2115
- "name": "handleFocusin",
2116
- "description": "Function to support",
2117
- "privacy": "private",
2118
- "return": {
2119
- "type": {
2120
- "text": "void"
2121
- }
2122
- }
2123
- },
2124
- {
2125
- "kind": "method",
2126
- "name": "generateIconHtml",
2127
- "description": "Function to generate checkmark svg.",
2128
- "privacy": "private",
2129
- "return": {
2130
- "type": {
2131
- "text": "HTMLElement"
2132
- }
2133
- }
2134
- },
2135
- {
2136
- "kind": "method",
2137
- "name": "reset",
2138
- "description": "Resets component to initial state.",
2139
- "return": {
2140
- "type": {
2141
- "text": "void"
2142
- }
2143
- }
2144
- },
2145
- {
2146
- "kind": "method",
2147
- "name": "updateAriaLabel",
2148
- "description": "Updates the aria-label based on slot content.",
2149
- "privacy": "private",
2150
- "return": {
2151
- "type": {
2152
- "text": "void"
2153
- }
2154
- }
2155
- },
2156
- {
2157
- "kind": "method",
2158
- "name": "handleKeyDown",
2159
- "parameters": [
2160
- {
2161
- "name": "event",
2162
- "description": "The keydown event from the checkbox input.",
2163
- "type": {
2164
- "text": "KeyboardEvent"
2165
- }
2166
- }
2167
- ],
2168
- "description": "Handles keydown event to toggle the checkbox with Space key.",
2169
- "privacy": "private",
2170
- "return": {
2171
- "type": {
2172
- "text": "void"
2173
- }
2199
+ "description": "Sets the layout of the combobox.",
2200
+ "default": "'classic'",
2201
+ "fieldName": "layout",
2202
+ "inheritedFrom": {
2203
+ "name": "AuroElement",
2204
+ "module": "components/layoutElement/src/auroElement.js"
2174
2205
  }
2175
2206
  },
2176
2207
  {
2177
- "kind": "field",
2178
- "name": "appearance",
2179
- "privacy": "public",
2180
- "type": {
2181
- "text": "'default' | 'inverse'"
2182
- },
2183
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2184
- "default": "'default'",
2185
- "attribute": "appearance",
2186
- "reflects": true
2187
- },
2188
- {
2189
- "kind": "field",
2190
- "name": "checked",
2191
- "privacy": "public",
2208
+ "name": "matchWidth",
2192
2209
  "type": {
2193
2210
  "text": "boolean"
2194
2211
  },
2195
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2196
- "attribute": "checked",
2197
- "reflects": true
2212
+ "description": "If declared, the popover and trigger will be set to the same width.",
2213
+ "fieldName": "matchWidth"
2198
2214
  },
2199
2215
  {
2200
- "kind": "field",
2201
- "name": "disabled",
2202
- "privacy": "public",
2216
+ "name": "noFilter",
2203
2217
  "type": {
2204
2218
  "text": "boolean"
2205
2219
  },
2206
- "description": "If set to true, the checkbox will not be clickable.",
2207
- "attribute": "disabled",
2208
- "reflects": true
2220
+ "description": "If set, combobox will not filter menuoptions based on input.",
2221
+ "fieldName": "noFilter"
2209
2222
  },
2210
2223
  {
2211
- "kind": "field",
2212
- "name": "error",
2213
- "privacy": "public",
2224
+ "name": "noFlip",
2214
2225
  "type": {
2215
2226
  "text": "boolean"
2216
2227
  },
2217
- "description": "If set to true, the checkbox will be displayed with an error state.",
2218
- "attribute": "error",
2219
- "reflects": true
2228
+ "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
2229
+ "fieldName": "noFlip"
2220
2230
  },
2221
2231
  {
2222
- "kind": "field",
2223
- "name": "id",
2224
- "privacy": "public",
2232
+ "name": "shift",
2225
2233
  "type": {
2226
- "text": "string"
2234
+ "text": "boolean"
2227
2235
  },
2228
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2229
- "attribute": "id",
2230
- "reflects": true
2236
+ "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
2237
+ "fieldName": "shift"
2231
2238
  },
2232
2239
  {
2233
- "kind": "field",
2234
- "name": "inputId",
2235
- "privacy": "private",
2240
+ "name": "noValidate",
2236
2241
  "type": {
2237
- "text": "string"
2242
+ "text": "boolean"
2238
2243
  },
2239
- "description": "The id for input node."
2244
+ "description": "If set, disables auto-validation on blur.",
2245
+ "fieldName": "noValidate"
2240
2246
  },
2241
2247
  {
2242
- "kind": "field",
2243
- "name": "name",
2244
- "privacy": "public",
2248
+ "name": "offset",
2245
2249
  "type": {
2246
- "text": "string"
2250
+ "text": "number"
2247
2251
  },
2248
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2249
- "attribute": "name"
2252
+ "description": "Gap between the trigger element and bib.",
2253
+ "default": "0",
2254
+ "fieldName": "offset"
2250
2255
  },
2251
2256
  {
2252
- "kind": "field",
2253
2257
  "name": "onDark",
2254
- "privacy": "public",
2255
2258
  "type": {
2256
2259
  "text": "boolean"
2257
2260
  },
2258
2261
  "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2259
- "attribute": "onDark",
2260
- "reflects": true
2262
+ "fieldName": "onDark"
2261
2263
  },
2262
2264
  {
2263
- "kind": "field",
2264
- "name": "touched",
2265
- "privacy": "private",
2265
+ "name": "optionSelected",
2266
2266
  "type": {
2267
- "text": "boolean"
2267
+ "text": "HTMLElement"
2268
2268
  },
2269
- "description": "Indicates whether the checkbox has been interacted with."
2269
+ "description": "Specifies the current selected option.",
2270
+ "fieldName": "optionSelected"
2270
2271
  },
2271
2272
  {
2272
- "kind": "field",
2273
- "name": "value",
2274
- "privacy": "public",
2273
+ "name": "persistInput",
2275
2274
  "type": {
2276
- "text": "string"
2275
+ "text": "boolean"
2277
2276
  },
2278
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2279
- "attribute": "value"
2277
+ "description": "If declared, selecting a menu option will not change the input value. By doing so,\nthe current menu filter will be preserved and the user can continue from their last\nfilter state. It is recommended to use this in combination with the `displayValue` slot.",
2278
+ "fieldName": "persistInput"
2280
2279
  },
2281
2280
  {
2282
- "kind": "field",
2283
- "name": "tabIndex",
2284
- "privacy": "private",
2281
+ "name": "placement",
2285
2282
  "type": {
2286
- "text": "number"
2283
+ "text": "'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'"
2287
2284
  },
2288
- "description": "The tabindex attribute for the checkbox.",
2289
- "attribute": "tabindex",
2290
- "reflects": true
2285
+ "description": "Position where the bib should appear relative to the trigger.",
2286
+ "default": "'bottom-start'",
2287
+ "fieldName": "placement"
2291
2288
  },
2292
2289
  {
2293
- "kind": "field",
2294
- "name": "ariaChecked",
2295
- "privacy": "private",
2290
+ "name": "placeholder",
2296
2291
  "type": {
2297
2292
  "text": "string"
2298
2293
  },
2299
- "description": "The aria-checked attribute for the checkbox.",
2300
- "attribute": "aria-checked",
2301
- "reflects": true
2294
+ "description": "Define custom placeholder text, only supported by date input formats.",
2295
+ "fieldName": "placeholder"
2302
2296
  },
2303
2297
  {
2304
- "kind": "field",
2305
- "name": "ariaDisabled",
2306
- "privacy": "private",
2298
+ "name": "required",
2307
2299
  "type": {
2308
- "text": "string"
2300
+ "text": "boolean"
2309
2301
  },
2310
- "description": "The aria-disabled attribute for the checkbox.",
2311
- "attribute": "aria-disabled",
2312
- "reflects": true
2302
+ "description": "Populates the `required` attribute on the input. Used for client-side validation.",
2303
+ "fieldName": "required"
2313
2304
  },
2314
2305
  {
2315
- "kind": "field",
2316
- "name": "role",
2317
- "privacy": "private",
2306
+ "name": "setCustomValidity",
2318
2307
  "type": {
2319
2308
  "text": "string"
2320
2309
  },
2321
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2322
- "attribute": "role",
2323
- "reflects": true
2324
- }
2325
- ],
2326
- "events": [
2327
- {
2328
- "name": "auroCheckbox-input",
2329
- "type": {
2330
- "text": "CustomEvent"
2331
- }
2332
- },
2333
- {
2334
- "name": "auroCheckbox-focusin",
2335
- "type": {
2336
- "text": "CustomEvent"
2337
- }
2338
- },
2339
- {
2340
- "name": "auroCheckbox-focusout",
2341
- "type": {
2342
- "text": "CustomEvent"
2343
- }
2344
- },
2345
- {
2346
- "description": "(Deprecated) Notifies when checked value is changed.",
2347
- "name": "change"
2310
+ "description": "Sets a custom help text message to display for all validityStates.",
2311
+ "fieldName": "setCustomValidity"
2348
2312
  },
2349
2313
  {
2350
- "description": "Notifies when when checked value is changed by user's interface.",
2351
- "name": "input"
2352
- }
2353
- ],
2354
- "attributes": [
2355
- {
2356
- "name": "appearance",
2314
+ "name": "setCustomValidityCustomError",
2357
2315
  "type": {
2358
- "text": "'default' | 'inverse'"
2316
+ "text": "string"
2359
2317
  },
2360
- "description": "Defines whether the component will be on lighter or darker backgrounds.",
2361
- "default": "'default'",
2362
- "fieldName": "appearance"
2318
+ "description": "Custom help text message to display when validity = `customError`.",
2319
+ "fieldName": "setCustomValidityCustomError"
2363
2320
  },
2364
2321
  {
2365
- "name": "checked",
2322
+ "name": "setCustomValidityValueMissing",
2366
2323
  "type": {
2367
- "text": "boolean"
2324
+ "text": "string"
2368
2325
  },
2369
- "description": "If set to true, the checkbox will be filled with a checkmark.",
2370
- "fieldName": "checked"
2326
+ "description": "Custom help text message to display when validity = `valueMissing`.",
2327
+ "fieldName": "setCustomValidityValueMissing"
2371
2328
  },
2372
2329
  {
2373
- "name": "disabled",
2330
+ "name": "setCustomValidityValueMissingFilter",
2374
2331
  "type": {
2375
- "text": "boolean"
2332
+ "text": "string"
2376
2333
  },
2377
- "description": "If set to true, the checkbox will not be clickable.",
2378
- "fieldName": "disabled"
2334
+ "description": "Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = \"filter\".",
2335
+ "fieldName": "setCustomValidityValueMissingFilter"
2379
2336
  },
2380
2337
  {
2381
- "name": "error",
2338
+ "name": "triggerIcon",
2382
2339
  "type": {
2383
2340
  "text": "boolean"
2384
2341
  },
2385
- "description": "If set to true, the checkbox will be displayed with an error state.",
2386
- "fieldName": "error"
2342
+ "description": "If set, the `icon` attribute will be applied to the trigger `auro-input` element.",
2343
+ "fieldName": "triggerIcon"
2387
2344
  },
2388
2345
  {
2389
- "name": "id",
2346
+ "name": "type",
2390
2347
  "type": {
2391
2348
  "text": "string"
2392
2349
  },
2393
- "description": "The id global attribute defines an identifier (ID) which must be unique in the whole document.",
2394
- "fieldName": "id"
2350
+ "description": "Applies the defined value as the type attribute on `auro-input`.",
2351
+ "fieldName": "type"
2395
2352
  },
2396
2353
  {
2397
- "name": "name",
2354
+ "name": "typedValue",
2398
2355
  "type": {
2399
2356
  "text": "string"
2400
2357
  },
2401
- "description": "Accepts any string and is used to identify related checkboxes when submitting form data.",
2402
- "fieldName": "name"
2358
+ "description": "Specifies the value of the input element within the combobox.",
2359
+ "fieldName": "typedValue"
2403
2360
  },
2404
2361
  {
2405
- "name": "onDark",
2362
+ "name": "validity",
2406
2363
  "type": {
2407
- "text": "boolean"
2364
+ "text": "string"
2408
2365
  },
2409
- "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
2410
- "fieldName": "onDark"
2366
+ "description": "Specifies the `validityState` this element is in.",
2367
+ "fieldName": "validity"
2411
2368
  },
2412
2369
  {
2413
2370
  "name": "value",
2414
2371
  "type": {
2415
2372
  "text": "string"
2416
2373
  },
2417
- "description": "Sets the element's input value. Must be unique within an auro-checkbox-group element.",
2374
+ "description": "Value selected for the dropdown menu.",
2418
2375
  "fieldName": "value"
2419
2376
  },
2420
2377
  {
2421
- "name": "tabindex",
2378
+ "name": "largeFullscreenHeadline",
2422
2379
  "type": {
2423
- "text": "number"
2380
+ "text": "boolean"
2424
2381
  },
2425
- "description": "The tabindex attribute for the checkbox.",
2426
- "fieldName": "tabIndex"
2382
+ "description": "If declared, make bib.fullscreen.headline in HeadingDisplay.\nOtherwise, Heading 600",
2383
+ "fieldName": "largeFullscreenHeadline"
2427
2384
  },
2428
2385
  {
2429
- "name": "aria-checked",
2386
+ "name": "fullscreenBreakpoint",
2430
2387
  "type": {
2431
- "text": "string"
2388
+ "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'"
2432
2389
  },
2433
- "description": "The aria-checked attribute for the checkbox.",
2434
- "fieldName": "ariaChecked"
2390
+ "description": "Defines the screen size breakpointat which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
2391
+ "default": "'sm'",
2392
+ "fieldName": "fullscreenBreakpoint"
2435
2393
  },
2436
2394
  {
2437
- "name": "aria-disabled",
2395
+ "name": "shape",
2438
2396
  "type": {
2439
2397
  "text": "string"
2440
2398
  },
2441
- "description": "The aria-disabled attribute for the checkbox.",
2442
- "fieldName": "ariaDisabled"
2399
+ "fieldName": "shape",
2400
+ "inheritedFrom": {
2401
+ "name": "AuroElement",
2402
+ "module": "components/layoutElement/src/auroElement.js"
2403
+ }
2443
2404
  },
2444
2405
  {
2445
- "name": "role",
2406
+ "name": "size",
2446
2407
  "type": {
2447
2408
  "text": "string"
2448
2409
  },
2449
- "description": "The ARIA role for the element. Must remain 'checkbox' for screen readers\nto correctly identify this as a checkbox control.",
2450
- "fieldName": "role"
2410
+ "fieldName": "size",
2411
+ "inheritedFrom": {
2412
+ "name": "AuroElement",
2413
+ "module": "components/layoutElement/src/auroElement.js"
2414
+ }
2415
+ },
2416
+ {
2417
+ "name": "ondark",
2418
+ "type": {
2419
+ "text": "boolean"
2420
+ },
2421
+ "fieldName": "onDark",
2422
+ "inheritedFrom": {
2423
+ "name": "AuroElement",
2424
+ "module": "components/layoutElement/src/auroElement.js"
2425
+ }
2451
2426
  }
2452
2427
  ],
2453
2428
  "superclass": {
2454
- "name": "LitElement",
2455
- "package": "lit"
2429
+ "name": "AuroElement",
2430
+ "module": "/components/layoutElement/src/auroElement.js"
2431
+ },
2432
+ "tagName": "auro-combobox",
2433
+ "customElement": true
2434
+ }
2435
+ ],
2436
+ "exports": [
2437
+ {
2438
+ "kind": "js",
2439
+ "name": "AuroCombobox",
2440
+ "declaration": {
2441
+ "name": "AuroCombobox",
2442
+ "module": "components/combobox/src/auro-combobox.js"
2443
+ }
2444
+ }
2445
+ ]
2446
+ },
2447
+ {
2448
+ "kind": "javascript-module",
2449
+ "path": "components/combobox/src/comboboxKeyboardStrategy.js",
2450
+ "declarations": [
2451
+ {
2452
+ "kind": "variable",
2453
+ "name": "comboboxKeyboardStrategy",
2454
+ "type": {
2455
+ "text": "object"
2456
2456
  },
2457
- "tagName": "auro-checkbox",
2458
- "customElement": true
2457
+ "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { navigateArrow(component, 'down'); } } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
2459
2458
  }
2460
2459
  ],
2461
2460
  "exports": [
2462
2461
  {
2463
2462
  "kind": "js",
2464
- "name": "AuroCheckbox",
2463
+ "name": "comboboxKeyboardStrategy",
2465
2464
  "declaration": {
2466
- "name": "AuroCheckbox",
2467
- "module": "components/checkbox/src/auro-checkbox.js"
2465
+ "name": "comboboxKeyboardStrategy",
2466
+ "module": "components/combobox/src/comboboxKeyboardStrategy.js"
2468
2467
  }
2469
2468
  }
2470
2469
  ]
2471
2470
  },
2472
2471
  {
2473
2472
  "kind": "javascript-module",
2474
- "path": "components/checkbox/src/index.js",
2473
+ "path": "components/combobox/src/index.js",
2475
2474
  "declarations": [],
2476
2475
  "exports": [
2477
2476
  {
2478
2477
  "kind": "js",
2479
- "name": "AuroCheckbox",
2480
- "declaration": {
2481
- "name": "AuroCheckbox",
2482
- "module": "components/checkbox/src/index.js"
2483
- }
2484
- },
2485
- {
2486
- "kind": "js",
2487
- "name": "AuroCheckboxGroup",
2478
+ "name": "AuroCombobox",
2488
2479
  "declaration": {
2489
- "name": "AuroCheckboxGroup",
2490
- "module": "components/checkbox/src/index.js"
2480
+ "name": "AuroCombobox",
2481
+ "module": "components/combobox/src/index.js"
2491
2482
  }
2492
2483
  }
2493
2484
  ]
2494
2485
  },
2495
2486
  {
2496
2487
  "kind": "javascript-module",
2497
- "path": "components/checkbox/src/registered.js",
2488
+ "path": "components/combobox/src/registered.js",
2498
2489
  "declarations": [],
2499
- "exports": []
2490
+ "exports": [
2491
+ {
2492
+ "kind": "js",
2493
+ "name": "AuroCombobox",
2494
+ "declaration": {
2495
+ "name": "AuroCombobox",
2496
+ "module": "components/combobox/src/registered.js"
2497
+ }
2498
+ }
2499
+ ]
2500
2500
  },
2501
2501
  {
2502
2502
  "kind": "javascript-module",
@@ -4577,7 +4577,7 @@
4577
4577
  {
4578
4578
  "kind": "method",
4579
4579
  "name": "updateHostAria",
4580
- "description": "Updates ARIA attributes on the host element so that\nariaActiveDescendantElement can expose cell info to the SR.",
4580
+ "description": "Sets host-level ARIA so each cell exposes its date, selection state,\nand blackout status to assistive tech browsing the month grid.",
4581
4581
  "privacy": "private",
4582
4582
  "return": {
4583
4583
  "type": {
@@ -4598,7 +4598,7 @@
4598
4598
  {
4599
4599
  "kind": "method",
4600
4600
  "name": "setActive",
4601
- "description": "Imperatively marks this cell as active without triggering a Lit re-render.\nNote: buttons stay tabindex=\"-1\" because the grid uses aria-activedescendant.",
4601
+ "description": "Imperatively marks this cell as active without triggering a Lit re-render.\nButtons stay tabindex=\"-1\" because DOM focus stays on the grid wrapper —\narrow keys move the active cell imperatively and the live region carries\nthe SR announcement.",
4602
4602
  "return": {
4603
4603
  "type": {
4604
4604
  "text": "void"
@@ -4743,6 +4743,7 @@
4743
4743
  "type": {
4744
4744
  "text": "array"
4745
4745
  },
4746
+ "deprecated": "Propagated from the legacy `auro-calendar.disabledDays`\nUnix-timestamp array. The cell honors it for backward compatibility\n(see the divergence-check fallback inside `isBlackout`), but\nconsumers should migrate to `auro-datepicker.blackoutDates`\n(YYYY-MM-DD ISO strings). The calendar emits a one-time\ndeprecation warning the first time a non-empty value is observed.",
4746
4747
  "default": "[]",
4747
4748
  "attribute": "disabledDays"
4748
4749
  },
@@ -4902,6 +4903,7 @@
4902
4903
  "type": {
4903
4904
  "text": "array"
4904
4905
  },
4906
+ "deprecated": "Propagated from the legacy `auro-calendar.disabledDays`\nUnix-timestamp array. The cell honors it for backward compatibility\n(see the divergence-check fallback inside `isBlackout`), but\nconsumers should migrate to `auro-datepicker.blackoutDates`\n(YYYY-MM-DD ISO strings). The calendar emits a one-time\ndeprecation warning the first time a non-empty value is observed.",
4905
4907
  "default": "[]",
4906
4908
  "fieldName": "disabledDays"
4907
4909
  },
@@ -5306,6 +5308,26 @@
5306
5308
  }
5307
5309
  }
5308
5310
  },
5311
+ {
5312
+ "kind": "method",
5313
+ "name": "_afterMonthRender",
5314
+ "parameters": [
5315
+ {
5316
+ "name": "callback",
5317
+ "description": "Runs once after the month re-render and\nthe cells' button caches have refreshed.",
5318
+ "type": {
5319
+ "text": "() => void"
5320
+ }
5321
+ }
5322
+ ],
5323
+ "description": "Schedules `callback` two animation frames out, giving the child\n`auro-formkit-calendar-month` and `auro-formkit-calendar-cell` elements\na full render-and-paint cycle to settle before the callback reads or\nmutates DOM.\n\nWhy two frames, not one:\n1. Lit batches property updates and renders in a microtask, so frame N\n schedules the render but the new DOM may not be painted yet.\n2. Cells re-cache `_cachedButton` inside their own `updateComplete.then`,\n which also lands a tick later. Reading buttons from frame N+1\n (after both renders + cache refresh have flushed) reliably hits the\n new month's cells.\n\nUsed by every code path that calls `handleNextMonth`/`handlePrevMonth`\nand then needs to inspect the freshly-rendered cells (cross-month\nkeyboard nav, boundary events, `updateActiveCellForVisibleMonth`).\nDo NOT collapse to a single rAF — it intermittently lands before\n`_cachedButton` is refreshed, which silently breaks focus restoration\nand `setActiveCell` lookups.",
5324
+ "privacy": "private",
5325
+ "return": {
5326
+ "type": {
5327
+ "text": "void"
5328
+ }
5329
+ }
5330
+ },
5309
5331
  {
5310
5332
  "kind": "method",
5311
5333
  "name": "renderAllCalendars",
@@ -5357,6 +5379,40 @@
5357
5379
  }
5358
5380
  }
5359
5381
  },
5382
+ {
5383
+ "kind": "method",
5384
+ "name": "pickNearestCell",
5385
+ "parameters": [
5386
+ {
5387
+ "name": "cells",
5388
+ "description": "Focusable cells from getAllFocusableCells.",
5389
+ "type": {
5390
+ "text": "Array"
5391
+ }
5392
+ },
5393
+ {
5394
+ "name": "targetTs",
5395
+ "description": "Desired Unix timestamp (seconds).",
5396
+ "type": {
5397
+ "text": "Number"
5398
+ }
5399
+ },
5400
+ {
5401
+ "name": "direction",
5402
+ "description": "Navigation direction.",
5403
+ "type": {
5404
+ "text": "'next'|'prev'"
5405
+ }
5406
+ }
5407
+ ],
5408
+ "description": "Picks the focusable cell whose date is closest to targetTs. Used as a\nfallback after a month-boundary nav when the exact target date isn't\nfocusable — typically because the month re-render lagged or the date\nwas filtered out by isOutOfRange. When two cells are equidistant, the\nnavigation direction breaks the tie so the user moves the way they\npressed (forward → later cell, backward → earlier cell).",
5409
+ "privacy": "private",
5410
+ "return": {
5411
+ "type": {
5412
+ "text": "Object|null"
5413
+ }
5414
+ }
5415
+ },
5360
5416
  {
5361
5417
  "kind": "method",
5362
5418
  "name": "getAllFocusableCells",
@@ -5380,7 +5436,7 @@
5380
5436
  }
5381
5437
  }
5382
5438
  ],
5383
- "description": "Sets the active cell across all months. Only one cell has tabindex=\"0\" at a time.\nUses imperative DOM manipulation — no Lit re-render triggered.\nAlso updates ariaActiveDescendantElement on the grid wrapper so\nscreen readers announce the active cell without moving DOM focus.",
5439
+ "description": "Sets the active cell across all months. Only one cell has tabindex=\"0\" at a time.\nUses imperative DOM manipulation — no Lit re-render triggered. DOM focus\nstays on the grid wrapper; the live region (see getOrCreateLiveRegion)\nis what announces the active cell to assistive tech.",
5384
5440
  "return": {
5385
5441
  "type": {
5386
5442
  "text": "void"
@@ -5419,6 +5475,39 @@
5419
5475
  }
5420
5476
  }
5421
5477
  },
5478
+ {
5479
+ "kind": "method",
5480
+ "name": "_getBlackoutSet",
5481
+ "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.",
5482
+ "privacy": "private",
5483
+ "return": {
5484
+ "type": {
5485
+ "text": "Set<Number>"
5486
+ }
5487
+ }
5488
+ },
5489
+ {
5490
+ "kind": "field",
5491
+ "name": "_warnedDisabledDaysDeprecation",
5492
+ "type": {
5493
+ "text": "boolean"
5494
+ },
5495
+ "static": true,
5496
+ "default": "false",
5497
+ "description": "Per-class flag that gates the `disabledDays` deprecation warning so it\nfires exactly once per page no matter how many calendars or rebuild\ncycles encounter the legacy array.",
5498
+ "privacy": "private"
5499
+ },
5500
+ {
5501
+ "kind": "method",
5502
+ "name": "_warnDisabledDaysDeprecated",
5503
+ "description": "One-time `console.debug` directing consumers from the legacy\n`disabledDays` Unix-timestamp API to the ISO `blackoutDates` API. Fires\nthe first time `_getBlackoutSet` rebuilds from a non-empty\n`disabledDays`; subsequent calls (on this or any other AuroCalendar\ninstance on the page) are silent.",
5504
+ "privacy": "private",
5505
+ "return": {
5506
+ "type": {
5507
+ "text": "void"
5508
+ }
5509
+ }
5510
+ },
5422
5511
  {
5423
5512
  "kind": "method",
5424
5513
  "name": "computeActiveDate",
@@ -5473,7 +5562,7 @@
5473
5562
  }
5474
5563
  }
5475
5564
  ],
5476
- "description": "Handles arrow key navigation on the calendar grid wrapper.\nFocus stays on the grid wrapper; only ariaActiveDescendantElement\nand the visual active-cell indicator change.",
5565
+ "description": "Handles arrow key navigation on the calendar grid wrapper.\nFocus stays on the grid wrapper; only the visual active-cell indicator\nchanges. The live region announces the new active cell.",
5477
5566
  "privacy": "private",
5478
5567
  "return": {
5479
5568
  "type": {
@@ -5593,7 +5682,7 @@
5593
5682
  }
5594
5683
  }
5595
5684
  ],
5596
- "description": "Checks whether a given date is a blackout date.",
5685
+ "description": "Checks whether a given date is a blackout date. Delegates to the\nmemoized `_getBlackoutSet` so the YYYY-MM-DD parsing and the\nlegacy/ISO merge rules live in exactly one place (see `blackoutUtils.js`).",
5597
5686
  "privacy": "private",
5598
5687
  "return": {
5599
5688
  "type": {
@@ -5704,6 +5793,33 @@
5704
5793
  }
5705
5794
  }
5706
5795
  },
5796
+ {
5797
+ "kind": "method",
5798
+ "name": "_deliverAnnouncement",
5799
+ "parameters": [
5800
+ {
5801
+ "name": "dateStr",
5802
+ "description": "The localized date string to announce.",
5803
+ "type": {
5804
+ "text": "String"
5805
+ }
5806
+ },
5807
+ {
5808
+ "name": "attempts",
5809
+ "description": "Number of prior retry attempts.",
5810
+ "type": {
5811
+ "text": "Number"
5812
+ }
5813
+ }
5814
+ ],
5815
+ "description": "Writes `dateStr` to the live region. If the dropdown's dialog hasn't\nmounted yet (so getOrCreateLiveRegion can't attach), retries on the\nnext animation frame up to MAX_LIVE_REGION_RETRIES instead of silently\ndropping the announcement. The retry uses the same `_announceRafId`\nthe double-rAF below uses, so a newer announceSelection call (or\ndisconnectedCallback) cancels any in-flight retry.",
5816
+ "privacy": "private",
5817
+ "return": {
5818
+ "type": {
5819
+ "text": "void"
5820
+ }
5821
+ }
5822
+ },
5707
5823
  {
5708
5824
  "kind": "method",
5709
5825
  "name": "announceFocusDebounced",
@@ -5888,7 +6004,7 @@
5888
6004
  "type": {
5889
6005
  "text": "array"
5890
6006
  },
5891
- "description": "Legacy array of disabled-date timestamps.",
6007
+ "deprecated": "Use `auro-datepicker.blackoutDates` (an array of\n`YYYY-MM-DD` ISO strings) instead. This legacy array of Unix\ntimestamps is still honored for backward compatibility but emits a\none-time `console.debug` the first time a non-empty value is observed.\nSupport will be removed in a future major release.",
5892
6008
  "privacy": "private",
5893
6009
  "default": "[]"
5894
6010
  },
@@ -6590,13 +6706,13 @@
6590
6706
  "parameters": [
6591
6707
  {
6592
6708
  "name": "time",
6593
- "description": "Unix timestamp in seconds.",
6709
+ "description": "Unix timestamp (seconds), local midnight of the day.",
6594
6710
  "type": {
6595
6711
  "text": "number"
6596
6712
  }
6597
6713
  }
6598
6714
  ],
6599
- "description": "Converts a Unix timestamp (seconds) from the vendor calendar to an ISO date string.",
6715
+ "description": "Converts a Unix timestamp (seconds) from the vendored range-datepicker\n(`src/vendor/wc-range-datepicker/day.js`) to an ISO date string.\n\nTimezone contract:\n- INPUT: `time` is assumed to be the seconds-since-epoch of **local\n midnight** for the intended calendar day. The vendor's Day constructor\n builds it via `date-fns format(date, 't')` from a locally-constructed\n Date, so this assumption currently holds end-to-end.\n- OUTPUT: `dateFormatter.toISOFormatString` reads the Date's local\n getFullYear/getMonth/getDate components, so the returned YYYY-MM-DD\n string matches the local calendar day.\n\nIf the vendor ever switches to emitting UTC-midnight timestamps, this\nconversion will silently shift the returned date by one day in zones\nwest of UTC. Any vendor swap should re-verify this contract; the TZ\nregression suite (`npm run test:hst`, UTC-10) will catch the symptom.",
6600
6716
  "privacy": "private",
6601
6717
  "return": {
6602
6718
  "type": {
@@ -6872,6 +6988,34 @@
6872
6988
  },
6873
6989
  "readonly": true
6874
6990
  },
6991
+ {
6992
+ "kind": "field",
6993
+ "name": "_warnedInvalidLocales",
6994
+ "static": true,
6995
+ "default": "new Set()",
6996
+ "description": "Per-class dedup set used by `_warnInvalidLocale`. Static so the dedup\nspans every datepicker instance on the page; lives on the class (not\nat module scope) so it stays an encapsulated implementation detail of\nthis component and does not interfere with WCA's class-JSDoc\nattachment.",
6997
+ "privacy": "private"
6998
+ },
6999
+ {
7000
+ "kind": "method",
7001
+ "name": "_warnInvalidLocale",
7002
+ "parameters": [
7003
+ {
7004
+ "name": "badLocale",
7005
+ "description": "The locale value that failed.",
7006
+ "type": {
7007
+ "text": "string|undefined"
7008
+ }
7009
+ }
7010
+ ],
7011
+ "description": "Logs a one-time `console.debug` when an unsupported locale falls back to\nen-US. Deduped by the offending tag so noisy re-renders that resurface\nthe same bad value stay quiet, but each new bad value still signals so\nconsumers can spot the typo or missing tag.",
7012
+ "privacy": "private",
7013
+ "return": {
7014
+ "type": {
7015
+ "text": "void"
7016
+ }
7017
+ }
7018
+ },
6875
7019
  {
6876
7020
  "kind": "method",
6877
7021
  "name": "handleSlotToSlot",
@@ -7236,11 +7380,23 @@
7236
7380
  "type": {
7237
7381
  "text": "string"
7238
7382
  },
7239
- "description": "Label announced for cells after the range (or after start when no end is selected).",
7383
+ "description": "Label announced for cells after a fully selected range (both\n`dateFrom` and `dateTo` are set). While a range is still being\npicked (`dateFrom` set, `dateTo` unset), focused cells past the\nstart use `rangeLabelEndPreview` instead.",
7240
7384
  "default": "'after range'",
7241
7385
  "attribute": "rangeLabelAfterRange",
7242
7386
  "reflects": true
7243
7387
  },
7388
+ {
7389
+ "kind": "field",
7390
+ "name": "rangeLabelEndPreview",
7391
+ "privacy": "public",
7392
+ "type": {
7393
+ "text": "string"
7394
+ },
7395
+ "description": "Label announced for the focused cell while previewing a range end\n(dateFrom set, dateTo not yet selected). Tells AT users that\npressing Enter would commit this cell as the range end.",
7396
+ "default": "'previewing range end'",
7397
+ "attribute": "rangeLabelEndPreview",
7398
+ "reflects": true
7399
+ },
7244
7400
  {
7245
7401
  "kind": "field",
7246
7402
  "name": "blackoutDates",
@@ -7580,6 +7736,13 @@
7580
7736
  "name": "helpTextTag",
7581
7737
  "privacy": "private"
7582
7738
  },
7739
+ {
7740
+ "kind": "field",
7741
+ "name": "_listenerAbortController",
7742
+ "description": "Single AbortController shared by every listener registered in the\nconfigure* methods. Lets disconnectedCallback tear all of them down\nwith one abort() call.\n\nThe genuine leak risk is the listeners attached to children that can\noutlive the host if they get reparented — `this.dropdown`,\n`this.calendar`, and the inputs inside the dropdown's slot.\nListeners attached to `this` (e.g. focusin/focusout on the host)\nform a self-contained reference graph that the GC can collect with\nthe host anyway, but they share the same signal so the cleanup\npattern stays uniform across all configure* sites.",
7743
+ "privacy": "private",
7744
+ "default": "new AbortController()"
7745
+ },
7583
7746
  {
7584
7747
  "kind": "field",
7585
7748
  "name": "layout",
@@ -7750,7 +7913,7 @@
7750
7913
  "type": {
7751
7914
  "text": "array"
7752
7915
  },
7753
- "description": "Dates that the user should have for reference as part of their decision making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
7916
+ "description": "Dates that the user should have for reference as part of their decision-making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
7754
7917
  "attribute": "referenceDates",
7755
7918
  "reflects": true
7756
7919
  },
@@ -8190,7 +8353,7 @@
8190
8353
  "type": {
8191
8354
  "text": "string"
8192
8355
  },
8193
- "description": "Label announced for cells after the range (or after start when no end is selected).",
8356
+ "description": "Label announced for cells after a fully selected range (both\n`dateFrom` and `dateTo` are set). While a range is still being\npicked (`dateFrom` set, `dateTo` unset), focused cells past the\nstart use `rangeLabelEndPreview` instead.",
8194
8357
  "default": "'after range'",
8195
8358
  "fieldName": "rangeLabelAfterRange"
8196
8359
  },
@@ -8212,6 +8375,15 @@
8212
8375
  "default": "'range end'",
8213
8376
  "fieldName": "rangeLabelEnd"
8214
8377
  },
8378
+ {
8379
+ "name": "rangeLabelEndPreview",
8380
+ "type": {
8381
+ "text": "string"
8382
+ },
8383
+ "description": "Label announced for the focused cell while previewing a range end\n(dateFrom set, dateTo not yet selected). Tells AT users that\npressing Enter would commit this cell as the range end.",
8384
+ "default": "'previewing range end'",
8385
+ "fieldName": "rangeLabelEndPreview"
8386
+ },
8215
8387
  {
8216
8388
  "name": "rangeLabelInRange",
8217
8389
  "type": {
@@ -8235,7 +8407,7 @@
8235
8407
  "type": {
8236
8408
  "text": "array"
8237
8409
  },
8238
- "description": "Dates that the user should have for reference as part of their decision making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
8410
+ "description": "Dates that the user should have for reference as part of their decision-making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
8239
8411
  "fieldName": "referenceDates"
8240
8412
  },
8241
8413
  {
@@ -8385,6 +8557,116 @@
8385
8557
  }
8386
8558
  ]
8387
8559
  },
8560
+ {
8561
+ "kind": "javascript-module",
8562
+ "path": "components/datepicker/src/blackoutUtils.js",
8563
+ "declarations": [
8564
+ {
8565
+ "kind": "function",
8566
+ "name": "parseIsoToTimestamp",
8567
+ "parameters": [
8568
+ {
8569
+ "name": "isoStr",
8570
+ "description": "Date string in `YYYY-MM-DD` format.",
8571
+ "type": {
8572
+ "text": "string"
8573
+ }
8574
+ }
8575
+ ],
8576
+ "description": "Converts a `YYYY-MM-DD` ISO date string to a Unix timestamp (seconds)\nrepresenting local midnight on that calendar day. Returns `null` for\ninputs that don't parse to a finite timestamp.\n\nUses the `new Date(year, monthIndex, day)` constructor (NOT\n`new Date(isoStr)`) so the result is local-midnight rather than UTC\nmidnight — required to keep the calendar grid aligned with the user's\nlocal calendar day in negative-offset timezones.",
8577
+ "return": {
8578
+ "type": {
8579
+ "text": "number|null"
8580
+ }
8581
+ }
8582
+ },
8583
+ {
8584
+ "kind": "function",
8585
+ "name": "buildBlackoutSet",
8586
+ "parameters": [
8587
+ {
8588
+ "name": "disabledDays",
8589
+ "description": "Legacy timestamp array.",
8590
+ "type": {
8591
+ "text": "Array<string|number>|undefined"
8592
+ }
8593
+ },
8594
+ {
8595
+ "name": "blackoutDates",
8596
+ "description": "ISO `YYYY-MM-DD` array.",
8597
+ "type": {
8598
+ "text": "Array<string>|undefined"
8599
+ }
8600
+ }
8601
+ ],
8602
+ "description": "Builds a `Set<number>` of seconds-since-epoch timestamps covering both the\nlegacy `disabledDays` (already-numeric) array and the ISO `blackoutDates`\narray. Use this for O(1) membership checks in hot paths.",
8603
+ "return": {
8604
+ "type": {
8605
+ "text": "Set<number>"
8606
+ }
8607
+ }
8608
+ },
8609
+ {
8610
+ "kind": "function",
8611
+ "name": "isBlackoutTimestamp",
8612
+ "parameters": [
8613
+ {
8614
+ "name": "dateTs",
8615
+ "description": "Unix timestamp (seconds) to test.",
8616
+ "type": {
8617
+ "text": "number"
8618
+ }
8619
+ },
8620
+ {
8621
+ "name": "disabledDays",
8622
+ "description": "Legacy timestamp array.",
8623
+ "type": {
8624
+ "text": "Array<string|number>|undefined"
8625
+ }
8626
+ },
8627
+ {
8628
+ "name": "blackoutDates",
8629
+ "description": "ISO `YYYY-MM-DD` array.",
8630
+ "type": {
8631
+ "text": "Array<string>|undefined"
8632
+ }
8633
+ }
8634
+ ],
8635
+ "description": "One-shot membership test for a single timestamp against both blackout\nsources. Allocates a Set on each call; only use this in cold paths\n(e.g. the pre-`firstUpdated` cell fallback). Hot paths should hold the\nSet returned from `buildBlackoutSet` and `.has(ts)` directly.",
8636
+ "return": {
8637
+ "type": {
8638
+ "text": "boolean"
8639
+ }
8640
+ }
8641
+ }
8642
+ ],
8643
+ "exports": [
8644
+ {
8645
+ "kind": "js",
8646
+ "name": "parseIsoToTimestamp",
8647
+ "declaration": {
8648
+ "name": "parseIsoToTimestamp",
8649
+ "module": "components/datepicker/src/blackoutUtils.js"
8650
+ }
8651
+ },
8652
+ {
8653
+ "kind": "js",
8654
+ "name": "buildBlackoutSet",
8655
+ "declaration": {
8656
+ "name": "buildBlackoutSet",
8657
+ "module": "components/datepicker/src/blackoutUtils.js"
8658
+ }
8659
+ },
8660
+ {
8661
+ "kind": "js",
8662
+ "name": "isBlackoutTimestamp",
8663
+ "declaration": {
8664
+ "name": "isBlackoutTimestamp",
8665
+ "module": "components/datepicker/src/blackoutUtils.js"
8666
+ }
8667
+ }
8668
+ ]
8669
+ },
8388
8670
  {
8389
8671
  "kind": "javascript-module",
8390
8672
  "path": "components/datepicker/src/buttonVersion.js",