@synergy-design-system/components 1.4.1 → 1.5.1

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@synergy-design-system/components",
-  "version": "1.4.1",
+  "version": "1.5.1",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -255,6 +255,35 @@
             ]
           }
         },
+        {
+          "name": "syn-button-group",
+          "description": "Button groups can be used to group related buttons into sections.\n---\n\n\n### **Slots:**\n - _default_ - One or more `<syn-button>` elements to display in the button group.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "label",
+              "description": "A label to use for the button group. This won't be displayed on the screen, but it will be announced by assistive\ndevices when interacting with the control and is strongly recommended.",
+              "value": { "type": "string", "default": "''" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "One or more `<syn-button>` elements to display in the button group."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "label",
+                "description": "A label to use for the button group. This won't be displayed on the screen, but it will be announced by assistive\ndevices when interacting with the control and is strongly recommended.",
+                "value": { "type": "string" }
+              }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "syn-checkbox",
           "description": "Checkboxes allow the user to toggle an option on or off.\n---\n\n\n### **Events:**\n - **syn-blur** - Emitted when the checkbox loses focus.\n- **syn-change** - Emitted when the checked state changes.\n- **syn-focus** - Emitted when the checkbox gains focus.\n- **syn-input** - Emitted when the checkbox receives input.\n- **syn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the checkbox.\n- **focus(options: _FocusOptions_)** - Sets focus on the checkbox.\n- **blur()** - Removes focus from the checkbox.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. The value provided will be shown to the user when the form is submitted. To clear\nthe custom validation message, call this method with an empty string.\n\n### **Slots:**\n - _default_ - The checkbox's label.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The square container that wraps the checkbox's checked state.\n- **control--checked** - Matches the control part when the checkbox is checked.\n- **control--indeterminate** - Matches the control part when the checkbox is indeterminate.\n- **checked-icon** - The checked icon, an `<syn-icon>` element.\n- **indeterminate-icon** - The indeterminate icon, an `<syn-icon>` element.\n- **label** - The container that wraps the checkbox's label.",
@@ -396,35 +425,6 @@
             ]
           }
         },
-        {
-          "name": "syn-button-group",
-          "description": "Button groups can be used to group related buttons into sections.\n---\n\n\n### **Slots:**\n - _default_ - One or more `<syn-button>` elements to display in the button group.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-          "doc-url": "",
-          "attributes": [
-            {
-              "name": "label",
-              "description": "A label to use for the button group. This won't be displayed on the screen, but it will be announced by assistive\ndevices when interacting with the control and is strongly recommended.",
-              "value": { "type": "string", "default": "''" }
-            }
-          ],
-          "slots": [
-            {
-              "name": "",
-              "description": "One or more `<syn-button>` elements to display in the button group."
-            }
-          ],
-          "events": [],
-          "js": {
-            "properties": [
-              {
-                "name": "label",
-                "description": "A label to use for the button group. This won't be displayed on the screen, but it will be announced by assistive\ndevices when interacting with the control and is strongly recommended.",
-                "value": { "type": "string" }
-              }
-            ],
-            "events": []
-          }
-        },
         {
           "name": "syn-divider",
           "description": "Dividers are used to visually separate or group elements.\n---\n\n\n### **CSS Properties:**\n - **--color** - The color of the divider. _(default: undefined)_\n- **--width** - The width of the divider. _(default: undefined)_\n- **--spacing** - The spacing of the divider. _(default: undefined)_",
@@ -1055,6 +1055,352 @@
             ]
           }
         },
+        {
+          "name": "syn-optgroup",
+          "description": "The <syn-optgroup> element creates a grouping for <syn-option>s within a <syn-select>.\n---\n\n\n### **Slots:**\n - _default_ - The given options. Must be `<syn-option>` elements.\n- **prefix** - A presentational prefix icon or similar element.\n- **label** - The label for the optgroup\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Properties:**\n - **--display-divider** - Display property of the divider. Defaults to \"block\" _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **label-container** - The container that wraps prefix, label and base\n- **divider** - The divider that is displayed above the content\n- **prefix** - The container that wraps the prefix.\n- **suffix** - The container that wraps the suffix.\n- **options** - The container that wraps the <syn-option> elements.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "disabled",
+              "description": "Disables all options in the optgroup.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "label",
+              "description": "The optgroups label. If you need to display HTML, use the `label` slot instead.",
+              "value": { "type": "string", "default": "''" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The given options. Must be `<syn-option>` elements."
+            },
+            {
+              "name": "prefix",
+              "description": "A presentational prefix icon or similar element."
+            },
+            { "name": "label", "description": "The label for the optgroup" },
+            {
+              "name": "suffix",
+              "description": "A presentational suffix icon or similar element."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "disabled",
+                "description": "Disables all options in the optgroup.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "label",
+                "description": "The optgroups label. If you need to display HTML, use the `label` slot instead.",
+                "value": { "type": "string" }
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "syn-option",
+          "description": "Options define the selectable items within various form controls such as [select](/components/select).\n---\n\n\n### **Methods:**\n - **getTextLabel()** - Returns a plain text label based on the option's content.\n\n### **Slots:**\n - _default_ - The option's label.\n- **prefix** - Used to prepend an icon or similar element to the menu item.\n- **suffix** - Used to append an icon or similar element to the menu item.\n\n### **CSS Parts:**\n - **checked-icon** - The checked icon, an `<syn-icon>` element.\n- **base** - The component's base wrapper.\n- **label** - The option's label.\n- **prefix** - The container that wraps the prefix.\n- **suffix** - The container that wraps the suffix.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "value",
+              "description": "The option's value. When selected, the containing form control will receive this value. The value must be unique\nfrom other options in the same group. Values may not contain spaces, as spaces are used as delimiters when listing\nmultiple values.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "disabled",
+              "description": "Draws the option in a disabled state, preventing selection.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "The option's label." },
+            {
+              "name": "prefix",
+              "description": "Used to prepend an icon or similar element to the menu item."
+            },
+            {
+              "name": "suffix",
+              "description": "Used to append an icon or similar element to the menu item."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "value",
+                "description": "The option's value. When selected, the containing form control will receive this value. The value must be unique\nfrom other options in the same group. Values may not contain spaces, as spaces are used as delimiters when listing\nmultiple values.",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "disabled",
+                "description": "Draws the option in a disabled state, preventing selection.",
+                "value": { "type": "boolean" }
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "syn-popup",
+          "description": "Popup is a utility that lets you declaratively anchor \"popup\" containers to another element.\n---\n\n\n### **Events:**\n - **syn-reposition** - Emitted when the popup is repositioned. This event can fire a lot, so avoid putting expensive operations in your listener or consider debouncing it.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and reposition itself.\n\n### **Slots:**\n - _default_ - The popup's content.\n- **anchor** - The element the popup will be anchored to. If the anchor lives outside of the popup, you can use the `anchor` attribute or property instead.\n\n### **CSS Properties:**\n - **--arrow-size** - The size of the arrow. Note that an arrow won't be shown unless the `arrow` attribute is used. _(default: 6px)_\n- **--arrow-color** - The color of the arrow. _(default: var(--syn-color-neutral-0))_\n- **--auto-size-available-width** - A read-only custom property that determines the amount of width the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n- **--auto-size-available-height** - A read-only custom property that determines the amount of height the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n\n### **CSS Parts:**\n - **arrow** - The arrow's container. Avoid setting `top|bottom|left|right` properties, as these values are assigned dynamically as the popup moves. This is most useful for applying a background color to match the popup, and maybe a border or box shadow.\n- **popup** - The popup's container. Useful for setting a background color, box shadow, etc.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "anchor",
+              "description": "The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide the anchor\nelement `id`, a DOM element reference, or a `VirtualElement`. If the anchor lives inside the popup, use the\n`anchor` slot instead.",
+              "value": { "type": "Element | string | VirtualElement" }
+            },
+            {
+              "name": "active",
+              "description": "Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "placement",
+              "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
+              "value": {
+                "type": "| 'top'\n    | 'top-start'\n    | 'top-end'\n    | 'bottom'\n    | 'bottom-start'\n    | 'bottom-end'\n    | 'right'\n    | 'right-start'\n    | 'right-end'\n    | 'left'\n    | 'left-start'\n    | 'left-end'",
+                "default": "'top'"
+              }
+            },
+            {
+              "name": "strategy",
+              "description": "Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if overflow is\nclipped, using a `fixed` position strategy can often workaround it.",
+              "value": {
+                "type": "'absolute' | 'fixed'",
+                "default": "'absolute'"
+              }
+            },
+            {
+              "name": "distance",
+              "description": "The distance in pixels from which to offset the panel away from its anchor.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "skidding",
+              "description": "The distance in pixels from which to offset the panel along its anchor.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "arrow",
+              "description": "Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "arrow-placement",
+              "description": "The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.",
+              "value": {
+                "type": "'start' | 'end' | 'center' | 'anchor'",
+                "default": "'anchor'"
+              }
+            },
+            {
+              "name": "arrow-padding",
+              "description": "The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.",
+              "value": { "type": "number", "default": "10" }
+            },
+            {
+              "name": "flip",
+              "description": "When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "flip-fallback-placements",
+              "description": "If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "flip-fallback-strategy",
+              "description": "When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.",
+              "value": {
+                "type": "'best-fit' | 'initial'",
+                "default": "'best-fit'"
+              }
+            },
+            {
+              "name": "flipBoundary",
+              "description": "The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+              "value": { "type": "Element | Element[]" }
+            },
+            {
+              "name": "flip-padding",
+              "description": "The amount of padding, in pixels, to exceed before the flip behavior will occur.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "shift",
+              "description": "Moves the popup along the axis to keep it in view when clipped.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "shiftBoundary",
+              "description": "The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+              "value": { "type": "Element | Element[]" }
+            },
+            {
+              "name": "shift-padding",
+              "description": "The amount of padding, in pixels, to exceed before the shift behavior will occur.",
+              "value": { "type": "number", "default": "0" }
+            },
+            {
+              "name": "auto-size",
+              "description": "When set, this will cause the popup to automatically resize itself to prevent it from overflowing.",
+              "value": { "type": "'horizontal' | 'vertical' | 'both'" }
+            },
+            {
+              "name": "sync",
+              "description": "Syncs the popup's width or height to that of the anchor element.",
+              "value": { "type": "'width' | 'height' | 'both'" }
+            },
+            {
+              "name": "autoSizeBoundary",
+              "description": "The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+              "value": { "type": "Element | Element[]" }
+            },
+            {
+              "name": "auto-size-padding",
+              "description": "The amount of padding, in pixels, to exceed before the auto-size behavior will occur.",
+              "value": { "type": "number", "default": "0" }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "The popup's content." },
+            {
+              "name": "anchor",
+              "description": "The element the popup will be anchored to. If the anchor lives outside of the popup, you can use the `anchor` attribute or property instead."
+            }
+          ],
+          "events": [
+            {
+              "name": "syn-reposition",
+              "description": "Emitted when the popup is repositioned. This event can fire a lot, so avoid putting expensive operations in your listener or consider debouncing it."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "anchor",
+                "description": "The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide the anchor\nelement `id`, a DOM element reference, or a `VirtualElement`. If the anchor lives inside the popup, use the\n`anchor` slot instead.",
+                "value": { "type": "Element | string | VirtualElement" }
+              },
+              {
+                "name": "active",
+                "description": "Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "placement",
+                "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
+                "value": {
+                  "type": "| 'top'\n    | 'top-start'\n    | 'top-end'\n    | 'bottom'\n    | 'bottom-start'\n    | 'bottom-end'\n    | 'right'\n    | 'right-start'\n    | 'right-end'\n    | 'left'\n    | 'left-start'\n    | 'left-end'"
+                }
+              },
+              {
+                "name": "strategy",
+                "description": "Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if overflow is\nclipped, using a `fixed` position strategy can often workaround it.",
+                "value": { "type": "'absolute' | 'fixed'" }
+              },
+              {
+                "name": "distance",
+                "description": "The distance in pixels from which to offset the panel away from its anchor.",
+                "value": { "type": "number" }
+              },
+              {
+                "name": "skidding",
+                "description": "The distance in pixels from which to offset the panel along its anchor.",
+                "value": { "type": "number" }
+              },
+              {
+                "name": "arrow",
+                "description": "Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "arrow-placement",
+                "description": "The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.",
+                "value": { "type": "'start' | 'end' | 'center' | 'anchor'" }
+              },
+              {
+                "name": "arrow-padding",
+                "description": "The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.",
+                "value": { "type": "number" }
+              },
+              {
+                "name": "flip",
+                "description": "When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "flip-fallback-placements",
+                "description": "If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "flip-fallback-strategy",
+                "description": "When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.",
+                "value": { "type": "'best-fit' | 'initial'" }
+              },
+              {
+                "name": "flipBoundary",
+                "description": "The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+                "value": { "type": "Element | Element[]" }
+              },
+              {
+                "name": "flip-padding",
+                "description": "The amount of padding, in pixels, to exceed before the flip behavior will occur.",
+                "value": { "type": "number" }
+              },
+              {
+                "name": "shift",
+                "description": "Moves the popup along the axis to keep it in view when clipped.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "shiftBoundary",
+                "description": "The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+                "value": { "type": "Element | Element[]" }
+              },
+              {
+                "name": "shift-padding",
+                "description": "The amount of padding, in pixels, to exceed before the shift behavior will occur.",
+                "value": { "type": "number" }
+              },
+              {
+                "name": "auto-size",
+                "description": "When set, this will cause the popup to automatically resize itself to prevent it from overflowing.",
+                "value": { "type": "'horizontal' | 'vertical' | 'both'" }
+              },
+              {
+                "name": "sync",
+                "description": "Syncs the popup's width or height to that of the anchor element.",
+                "value": { "type": "'width' | 'height' | 'both'" }
+              },
+              {
+                "name": "autoSizeBoundary",
+                "description": "The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
+                "value": { "type": "Element | Element[]" }
+              },
+              {
+                "name": "auto-size-padding",
+                "description": "The amount of padding, in pixels, to exceed before the auto-size behavior will occur.",
+                "value": { "type": "number" }
+              }
+            ],
+            "events": [
+              {
+                "name": "syn-reposition",
+                "description": "Emitted when the popup is repositioned. This event can fire a lot, so avoid putting expensive operations in your listener or consider debouncing it."
+              }
+            ]
+          }
+        },
         {
           "name": "syn-radio",
           "description": "Radios allow the user to select a single option from a group.\n---\n\n\n### **Events:**\n - **syn-blur** - Emitted when the control loses focus.\n- **syn-focus** - Emitted when the control gains focus.\n\n### **Slots:**\n - _default_ - The radio's label.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The circular container that wraps the radio's checked state.\n- **control--checked** - The radio control when the radio is checked.\n- **checked-icon** - The checked icon, an `<syn-icon>` element.\n- **label** - The container that wraps the radio's label.",
@@ -1317,6 +1663,294 @@
             ]
           }
         },
+        {
+          "name": "syn-select",
+          "description": "Selects allow you to choose items from a menu of predefined options.\n---\n\n\n### **Events:**\n - **syn-change** - Emitted when the control's value changes.\n- **syn-clear** - Emitted when the control's value is cleared.\n- **syn-input** - Emitted when the control receives input.\n- **syn-focus** - Emitted when the control gains focus.\n- **syn-blur** - Emitted when the control loses focus.\n- **syn-show** - Emitted when the select's menu opens.\n- **syn-after-show** - Emitted after the select's menu opens and all animations are complete.\n- **syn-hide** - Emitted when the select's menu closes.\n- **syn-after-hide** - Emitted after the select's menu closes and all animations are complete.\n- **syn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **show()** - Shows the listbox.\n- **hide()** - Hides the listbox.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the control.\n- **blur()** - Removes focus from the control.\n\n### **Slots:**\n - _default_ - The listbox options. Must be `<syn-option>` elements. You can use `<syn-divider>` to group items visually.\n- **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the combobox.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **expand-icon** - The icon to show when the control is expanded and collapsed. Rotates on open and close.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The select's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **combobox** - The container the wraps the prefix, combobox, clear icon, and expand button.\n- **prefix** - The container that wraps the prefix slot.\n- **display-input** - The element that displays the selected option's label, an `<input>` element.\n- **listbox** - The listbox container where options are slotted.\n- **tags** - The container that houses option tags when `multiselect` is used.\n- **tag** - The individual tags that represent each multiselect option.\n- **tag__base** - The tag's base part.\n- **tag__content** - The tag's content part.\n- **tag__remove-button** - The tag's remove button.\n- **tag__remove-button__base** - The tag's remove button base part.\n- **clear-button** - The clear button.\n- **expand-icon** - The container that wraps the expand icon.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "name",
+              "description": "The name of the select, submitted as a name/value pair with form data.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "value",
+              "description": "The current value of the select, submitted as a name/value pair with form data. When `multiple` is enabled, the\nvalue attribute will be a space-delimited list of values based on the options selected, and the value property will\nbe an array. **For this reason, values must not contain spaces.**",
+              "value": { "type": "string | string[]", "default": "''" }
+            },
+            {
+              "name": "size",
+              "description": "The select's size.",
+              "value": {
+                "type": "'small' | 'medium' | 'large'",
+                "default": "'medium'"
+              }
+            },
+            {
+              "name": "placeholder",
+              "description": "Placeholder text to show as a hint when the select is empty.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "multiple",
+              "description": "Allows more than one option to be selected.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "max-options-visible",
+              "description": "The maximum number of selected options to show when `multiple` is true. After the maximum, \"+n\" will be shown to\nindicate the number of additional items that are selected. Set to 0 to remove the limit.",
+              "value": { "type": "number", "default": "3" }
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the select control.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "clearable",
+              "description": "Adds a clear button when the select is not empty.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "open",
+              "description": "Indicates whether or not the select is open. You can toggle this attribute to show and hide the menu, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the select's open state.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "hoist",
+              "description": "Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "label",
+              "description": "The select's label. If you need to display HTML, use the `label` slot instead.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "placement",
+              "description": "The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.",
+              "value": { "type": "'top' | 'bottom'", "default": "'bottom'" }
+            },
+            {
+              "name": "help-text",
+              "description": "The select's help text. If you need to display HTML, use the `help-text` slot instead.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "form",
+              "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "required",
+              "description": "The select's required attribute.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "getTag",
+              "description": "A function that customizes the tags to be rendered when multiple=true. The first argument is the option, the second\nis the current tag's index.  The function should return either a Lit TemplateResult or a string containing trusted HTML of the symbol to render at\nthe specified value.",
+              "value": {
+                "type": "(option: SynOption, index: number) => TemplateResult | string | HTMLElement"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The listbox options. Must be `<syn-option>` elements. You can use `<syn-divider>` to group items visually."
+            },
+            {
+              "name": "label",
+              "description": "The input's label. Alternatively, you can use the `label` attribute."
+            },
+            {
+              "name": "prefix",
+              "description": "Used to prepend a presentational icon or similar element to the combobox."
+            },
+            {
+              "name": "clear-icon",
+              "description": "An icon to use in lieu of the default clear icon."
+            },
+            {
+              "name": "expand-icon",
+              "description": "The icon to show when the control is expanded and collapsed. Rotates on open and close."
+            },
+            {
+              "name": "help-text",
+              "description": "Text that describes how to use the input. Alternatively, you can use the `help-text` attribute."
+            }
+          ],
+          "events": [
+            {
+              "name": "syn-change",
+              "description": "Emitted when the control's value changes."
+            },
+            {
+              "name": "syn-clear",
+              "description": "Emitted when the control's value is cleared."
+            },
+            {
+              "name": "syn-input",
+              "description": "Emitted when the control receives input."
+            },
+            {
+              "name": "syn-focus",
+              "description": "Emitted when the control gains focus."
+            },
+            {
+              "name": "syn-blur",
+              "description": "Emitted when the control loses focus."
+            },
+            {
+              "name": "syn-show",
+              "description": "Emitted when the select's menu opens."
+            },
+            {
+              "name": "syn-after-show",
+              "description": "Emitted after the select's menu opens and all animations are complete."
+            },
+            {
+              "name": "syn-hide",
+              "description": "Emitted when the select's menu closes."
+            },
+            {
+              "name": "syn-after-hide",
+              "description": "Emitted after the select's menu closes and all animations are complete."
+            },
+            {
+              "name": "syn-invalid",
+              "description": "Emitted when the form control has been checked for validity and its constraints aren't satisfied."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "name",
+                "description": "The name of the select, submitted as a name/value pair with form data.",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "value",
+                "description": "The current value of the select, submitted as a name/value pair with form data. When `multiple` is enabled, the\nvalue attribute will be a space-delimited list of values based on the options selected, and the value property will\nbe an array. **For this reason, values must not contain spaces.**",
+                "value": { "type": "string | string[]" }
+              },
+              {
+                "name": "size",
+                "description": "The select's size.",
+                "value": { "type": "'small' | 'medium' | 'large'" }
+              },
+              {
+                "name": "placeholder",
+                "description": "Placeholder text to show as a hint when the select is empty.",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "multiple",
+                "description": "Allows more than one option to be selected.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "max-options-visible",
+                "description": "The maximum number of selected options to show when `multiple` is true. After the maximum, \"+n\" will be shown to\nindicate the number of additional items that are selected. Set to 0 to remove the limit.",
+                "value": { "type": "number" }
+              },
+              {
+                "name": "disabled",
+                "description": "Disables the select control.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "clearable",
+                "description": "Adds a clear button when the select is not empty.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "open",
+                "description": "Indicates whether or not the select is open. You can toggle this attribute to show and hide the menu, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the select's open state.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "hoist",
+                "description": "Enable this option to prevent the listbox from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "label",
+                "description": "The select's label. If you need to display HTML, use the `label` slot instead.",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "placement",
+                "description": "The preferred placement of the select's menu. Note that the actual placement may vary as needed to keep the listbox\ninside of the viewport.",
+                "value": { "type": "'top' | 'bottom'" }
+              },
+              {
+                "name": "help-text",
+                "description": "The select's help text. If you need to display HTML, use the `help-text` slot instead.",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "form",
+                "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "required",
+                "description": "The select's required attribute.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "getTag",
+                "description": "A function that customizes the tags to be rendered when multiple=true. The first argument is the option, the second\nis the current tag's index.  The function should return either a Lit TemplateResult or a string containing trusted HTML of the symbol to render at\nthe specified value.",
+                "value": {
+                  "type": "(option: SynOption, index: number) => TemplateResult | string | HTMLElement"
+                }
+              }
+            ],
+            "events": [
+              {
+                "name": "syn-change",
+                "description": "Emitted when the control's value changes."
+              },
+              {
+                "name": "syn-clear",
+                "description": "Emitted when the control's value is cleared."
+              },
+              {
+                "name": "syn-input",
+                "description": "Emitted when the control receives input."
+              },
+              {
+                "name": "syn-focus",
+                "description": "Emitted when the control gains focus."
+              },
+              {
+                "name": "syn-blur",
+                "description": "Emitted when the control loses focus."
+              },
+              {
+                "name": "syn-show",
+                "description": "Emitted when the select's menu opens."
+              },
+              {
+                "name": "syn-after-show",
+                "description": "Emitted after the select's menu opens and all animations are complete."
+              },
+              {
+                "name": "syn-hide",
+                "description": "Emitted when the select's menu closes."
+              },
+              {
+                "name": "syn-after-hide",
+                "description": "Emitted after the select's menu closes and all animations are complete."
+              },
+              {
+                "name": "syn-invalid",
+                "description": "Emitted when the form control has been checked for validity and its constraints aren't satisfied."
+              }
+            ]
+          }
+        },
         {
           "name": "syn-spinner",
           "description": "Spinners are used to show the progress of an indeterminate operation.\n---\n\n\n### **CSS Properties:**\n - **--track-width** - The width of the track. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the spinner's indicator. _(default: undefined)_\n- **--speed** - The time it takes for the spinner to complete one animation cycle. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",