@statistikzh/leu 0.5.1 → 0.7.0

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@statistikzh/leu",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -14,22 +14,22 @@
             {
               "name": "heading-level",
               "description": "The heading level of the accordion title. Must be between 1 and 6.",
-              "value": { "type": "Number", "default": "2" }
+              "value": { "type": "number", "default": "2" }
             },
             {
               "name": "label-prefix",
               "description": "The prefix of the accordion label. e.g. \"01\"",
-              "value": { "type": "String" }
+              "value": { "type": "string", "default": "\"\"" }
             },
             {
               "name": "open",
               "description": "The expanded state of the accordion.",
-              "value": { "type": "Boolean", "default": "false" }
+              "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "label",
               "description": "The label (title) of the accordion.",
-              "value": { "type": "String", "default": "\"\"" }
+              "value": { "type": "string", "default": "\"\"" }
             }
           ],
           "slots": [
@@ -44,22 +44,22 @@
               {
                 "name": "heading-level",
                 "description": "The heading level of the accordion title. Must be between 1 and 6.",
-                "value": { "type": "Number" }
+                "value": { "type": "number" }
               },
               {
                 "name": "label-prefix",
                 "description": "The prefix of the accordion label. e.g. \"01\"",
-                "value": { "type": "String" }
+                "value": { "type": "string" }
               },
               {
                 "name": "open",
                 "description": "The expanded state of the accordion.",
-                "value": { "type": "Boolean" }
+                "value": { "type": "boolean" }
               },
               {
                 "name": "label",
                 "description": "The label (title) of the accordion.",
-                "value": { "type": "String" }
+                "value": { "type": "string" }
               }
             ],
             "events": []
@@ -78,7 +78,7 @@
             {
               "name": "inverted",
               "description": "invert color on dark background",
-              "value": { "type": "Boolean", "default": "false" }
+              "value": { "type": "boolean", "default": "false" }
             },
             { "name": "_hiddenItems", "value": { "type": "string" } },
             { "name": "_showBackOnly", "value": { "type": "string" } },
@@ -96,7 +96,7 @@
               {
                 "name": "inverted",
                 "description": "invert color on dark background",
-                "value": { "type": "Boolean" }
+                "value": { "type": "boolean" }
               },
               { "name": "_hiddenItems", "value": {} },
               { "name": "_showBackOnly", "value": {} },
@@ -108,25 +108,13 @@
         },
         {
           "name": "leu-button",
-          "description": "\n---\n",
+          "description": "\n---\n\n\n### **Slots:**\n - **before** - The icon to display before the label\n- **after** - The icon to display after the label\n- _default_ - The label of the button or the icon if no label is set",
           "doc-url": "",
           "attributes": [
             {
               "name": "label",
               "value": { "type": "string", "default": "null" }
             },
-            {
-              "name": "icon",
-              "value": { "type": "string", "default": "null" }
-            },
-            {
-              "name": "iconPosition",
-              "description": "Only taken into account if Label and no Icon is set",
-              "value": {
-                "type": "(\"before\" | \"after\")",
-                "default": "\"before\""
-              }
-            },
             {
               "name": "size",
               "value": { "type": "string", "default": "\"regular\"" }
@@ -142,7 +130,10 @@
                 "default": "\"button\""
               }
             },
-            { "name": "componentRole", "value": { "type": "string" } },
+            {
+              "name": "componentRole",
+              "value": { "type": "string", "default": "undefined" }
+            },
             {
               "name": "disabled",
               "value": { "type": "boolean", "default": "false" }
@@ -175,16 +166,24 @@
               "value": { "type": "boolean", "default": "false" }
             }
           ],
+          "slots": [
+            {
+              "name": "before",
+              "description": "The icon to display before the label"
+            },
+            {
+              "name": "after",
+              "description": "The icon to display after the label"
+            },
+            {
+              "name": "",
+              "description": "The label of the button or the icon if no label is set"
+            }
+          ],
           "events": [],
           "js": {
             "properties": [
               { "name": "label", "value": { "type": "string" } },
-              { "name": "icon", "value": { "type": "string" } },
-              {
-                "name": "iconPosition",
-                "description": "Only taken into account if Label and no Icon is set",
-                "value": { "type": "(\"before\" | \"after\")" }
-              },
               { "name": "size", "value": { "type": "string" } },
               { "name": "variant", "value": { "type": "string" } },
               {
@@ -263,20 +262,19 @@
               "name": "disabled",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "identifier", "value": { "type": "string" } },
-            { "name": "value", "value": { "type": "string" } },
-            { "name": "name", "value": { "type": "string" } },
-            { "name": "label", "value": { "type": "string" } }
+            {
+              "name": "value",
+              "value": { "type": "string", "default": "\"\"" }
+            },
+            { "name": "name", "value": { "type": "string", "default": "\"\"" } }
           ],
           "events": [],
           "js": {
             "properties": [
               { "name": "checked", "value": { "type": "boolean" } },
               { "name": "disabled", "value": { "type": "boolean" } },
-              { "name": "identifier", "value": { "type": "string" } },
               { "name": "value", "value": { "type": "string" } },
-              { "name": "name", "value": { "type": "string" } },
-              { "name": "label", "value": { "type": "string" } }
+              { "name": "name", "value": { "type": "string" } }
             ],
             "events": []
           }
@@ -310,7 +308,10 @@
               "name": "inverted",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "selection-mode", "value": { "type": "string" } },
+            {
+              "name": "selection-mode",
+              "value": { "type": "\"single\" | \"multiple\" | \"none\"" }
+            },
             {
               "name": "heading-level",
               "value": { "type": "number", "default": "2" }
@@ -330,7 +331,10 @@
           "js": {
             "properties": [
               { "name": "inverted", "value": { "type": "boolean" } },
-              { "name": "selection-mode", "value": { "type": "string" } },
+              {
+                "name": "selection-mode",
+                "value": { "type": "\"single\" | \"multiple\" | \"none\"" }
+              },
               { "name": "heading-level", "value": { "type": "number" } },
               { "name": "label", "value": { "type": "string" } }
             ],
@@ -355,8 +359,7 @@
             {
               "name": "inverted",
               "value": { "type": "boolean", "default": "false" }
-            },
-            { "name": "label", "value": { "type": "string" } }
+            }
           ],
           "slots": [{ "name": "", "description": "The content of the chip" }],
           "events": [],
@@ -369,8 +372,7 @@
                 "value": { "type": "keyof typeof SIZES" }
               },
               { "name": "href", "value": { "type": "string" } },
-              { "name": "inverted", "value": { "type": "boolean" } },
-              { "name": "label", "value": { "type": "string" } }
+              { "name": "inverted", "value": { "type": "boolean" } }
             ],
             "events": []
           }
@@ -384,8 +386,7 @@
             {
               "name": "inverted",
               "value": { "type": "boolean", "default": "false" }
-            },
-            { "name": "label", "value": { "type": "string" } }
+            }
           ],
           "slots": [{ "name": "", "description": "The content of the chip" }],
           "events": [
@@ -397,8 +398,7 @@
           "js": {
             "properties": [
               { "name": "", "value": {} },
-              { "name": "inverted", "value": { "type": "boolean" } },
-              { "name": "label", "value": { "type": "string" } }
+              { "name": "inverted", "value": { "type": "boolean" } }
             ],
             "events": [
               {
@@ -417,29 +417,30 @@
             {
               "name": "size",
               "description": "The size of the chip. Not supported for radio variant.",
-              "value": {
-                "type": "keyof typeof SIZES",
-                "default": "\"regular\""
-              }
+              "value": { "type": "keyof typeof SIZES" }
             },
             {
               "name": "variant",
-              "description": "The variant of the chip. Has an effect not only on the visual appearance but also on the behavior.\n- `toggle`: The chip behaves like a toggle button.\n- `radio`: The chip behaves like a radio button.",
+              "description": "`toggle` or `radio`. Determines if only one or multiple chips can be selected.",
               "value": {
                 "type": "keyof typeof VARIANTS",
                 "default": "\"toggle\""
               }
             },
             {
-              "name": "selected",
+              "name": "checked",
+              "description": "Whether the chip is selected.",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "value", "value": { "type": "string" } },
+            {
+              "name": "value",
+              "description": "The value of the chip.",
+              "value": { "type": "string" }
+            },
             {
               "name": "inverted",
               "value": { "type": "boolean", "default": "false" }
-            },
-            { "name": "label", "value": { "type": "string" } }
+            }
           ],
           "slots": [{ "name": "", "description": "The content of the chip" }],
           "events": [{ "name": "input" }],
@@ -453,13 +454,20 @@
               },
               {
                 "name": "variant",
-                "description": "The variant of the chip. Has an effect not only on the visual appearance but also on the behavior.\n- `toggle`: The chip behaves like a toggle button.\n- `radio`: The chip behaves like a radio button.",
+                "description": "`toggle` or `radio`. Determines if only one or multiple chips can be selected.",
                 "value": { "type": "keyof typeof VARIANTS" }
               },
-              { "name": "selected", "value": { "type": "boolean" } },
-              { "name": "value", "value": { "type": "string" } },
-              { "name": "inverted", "value": { "type": "boolean" } },
-              { "name": "label", "value": { "type": "string" } }
+              {
+                "name": "checked",
+                "description": "Whether the chip is selected.",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "value",
+                "description": "The value of the chip.",
+                "value": { "type": "string" }
+              },
+              { "name": "inverted", "value": { "type": "boolean" } }
             ],
             "events": [{ "name": "input" }]
           }
@@ -487,9 +495,32 @@
             "events": []
           }
         },
+        {
+          "name": "leu-icon",
+          "description": "A component to render all defined zhWeb icons.\nThe `fill` of the icon is set to `currentColor` and\ncan be overriden by setting the css `color` property.\nIf the icon name is not found, a placeholder will be displayed.\n---\n\n\n### **CSS Properties:**\n - **--leu-icon-size** - The size of the icon. _(default: undefined)_",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "name",
+              "description": "The name of the icon to display.",
+              "value": { "type": "IconPathName", "default": "\"\"" }
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "name",
+                "description": "The name of the icon to display.",
+                "value": { "type": "IconPathName" }
+              }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "leu-input",
-          "description": "A text input element.\n---\n\n\n### **Events:**\n - **input** - Dispatched when the value of the input element changes.\n- **change** - Dispatched when the value of the input element changes and the input element loses focus.\n\n### **Methods:**\n - **getValidationMessages(): _Object_** - Merge custom and default validation messages.\nA validation message can be a function or a string.\nIf it s a function, the function is called with the corresponding\nattribute value as argument.\ne.g.\n`tooLong(this.maxlength)`\nThis way the framework user can create reasonable validation messages\n- **renderErrorMessages(validityState: _ValidityState_, validationMessages: _Object_, idRef: _String_): __** - Creates an error list with an item for the given validity state.",
+          "description": "A text input element.\n---\n\n\n### **Events:**\n - **input** - Dispatched when the value of the input element changes.\n- **change** - Dispatched when the value of the input element changes and the input element loses focus.\n\n### **Methods:**\n - **getValidationMessages(): _Object_** - Merge custom and default validation messages.\nA validation message can be a function or a string.\nIf it s a function, the function is called with the corresponding\nattribute value as argument.\ne.g.\n`tooLong(this.maxlength)`\nThis way the framework user can create reasonable validation messages\n- **renderErrorMessages(): _TemplateResult | nothing_** - Creates an error list with an item for the given validity state.",
           "doc-url": "",
           "attributes": [
             {
@@ -510,7 +541,7 @@
             {
               "name": "value",
               "description": "The value of the input element.",
-              "value": { "type": "string" }
+              "value": { "type": "string", "default": "\"\"" }
             },
             {
               "name": "name",
@@ -727,40 +758,60 @@
           "name": "leu-menu",
           "description": "\n---\n",
           "doc-url": "",
-          "attributes": [],
+          "attributes": [
+            {
+              "name": "selects",
+              "description": "This has only an effect when the role is 'menu'. It defines which role the menu items will get. Default is 'none'.",
+              "value": { "type": "SelectsType", "default": "\"none\"" }
+            }
+          ],
           "events": [],
-          "js": { "properties": [], "events": [] }
+          "js": {
+            "properties": [
+              {
+                "name": "selects",
+                "description": "This has only an effect when the role is 'menu'. It defines which role the menu items will get. Default is 'none'.",
+                "value": { "type": "SelectsType" }
+              }
+            ],
+            "events": []
+          }
         },
         {
           "name": "leu-menu-item",
-          "description": "\n---\n\n\n### **Slots:**\n - _default_ - The label of the menu item",
+          "description": "\n---\n\n\n### **Methods:**\n - **getValue(): _string_** - Returns the value of the item. If `value` is not set, it will return the inner text\n\n### **Slots:**\n - _default_ - The label of the menu item",
           "doc-url": "",
           "attributes": [
             {
-              "name": "before",
-              "description": "Can be either an icon name or a text\nIf no icon with this value is found, it will be displayed as text.\nIf the value is \"EMPTY\", an empty placeholder with the size of an icon will be displayed.",
-              "value": { "type": "string" }
+              "name": "active",
+              "description": "Defines if the item is selected or checked",
+              "value": { "type": "boolean", "default": "false" }
             },
             {
-              "name": "after",
-              "description": "Can be either an icon name or a text\nIf no icon with this value is found, it will be displayed as text\nIf the value is \"EMPTY\", an empty placeholder with the size of an icon will be displayed.",
-              "value": { "type": "string" }
+              "name": "disabled",
+              "description": "Disables the underlying button or link",
+              "value": { "type": "boolean", "default": "false" }
             },
             {
-              "name": "active",
-              "value": { "type": "boolean", "default": "false" }
+              "name": "tabbable",
+              "description": "If the item should be focusable. Will be reflected as `tabindex` to the underlying button or link",
+              "value": { "type": "boolean", "default": "undefined" }
             },
             {
-              "name": "highlighted",
-              "description": "A programmatic way to highlight the menu item like it is hovered.\nThis is just a visual effect and does not change the active state.",
-              "value": { "type": "boolean", "default": "false" }
+              "name": "href",
+              "description": "The href of the underlying link",
+              "value": { "type": "string", "default": "undefined" }
             },
             {
-              "name": "disabled",
-              "value": { "type": "boolean", "default": "false" }
+              "name": "value",
+              "description": "The value of the item. It must not contain commas. See `getValue()`",
+              "value": { "type": "string", "default": "undefined" }
             },
-            { "name": "label", "value": { "type": "string" } },
-            { "name": "href", "value": { "type": "string" } }
+            {
+              "name": "componentRole",
+              "description": "The role of the item. This will be reflected as `role` to the underlying button or link. Default is `'menuitem'.`",
+              "value": { "type": "MenuItemRole", "default": "\"menuitem\"" }
+            }
           ],
           "slots": [
             { "name": "", "description": "The label of the menu item" }
@@ -769,24 +820,35 @@
           "js": {
             "properties": [
               {
-                "name": "before",
-                "description": "Can be either an icon name or a text\nIf no icon with this value is found, it will be displayed as text.\nIf the value is \"EMPTY\", an empty placeholder with the size of an icon will be displayed.",
-                "value": { "type": "string" }
+                "name": "active",
+                "description": "Defines if the item is selected or checked",
+                "value": { "type": "boolean" }
               },
               {
-                "name": "after",
-                "description": "Can be either an icon name or a text\nIf no icon with this value is found, it will be displayed as text\nIf the value is \"EMPTY\", an empty placeholder with the size of an icon will be displayed.",
-                "value": { "type": "string" }
+                "name": "disabled",
+                "description": "Disables the underlying button or link",
+                "value": { "type": "boolean" }
               },
-              { "name": "active", "value": { "type": "boolean" } },
               {
-                "name": "highlighted",
-                "description": "A programmatic way to highlight the menu item like it is hovered.\nThis is just a visual effect and does not change the active state.",
+                "name": "tabbable",
+                "description": "If the item should be focusable. Will be reflected as `tabindex` to the underlying button or link",
                 "value": { "type": "boolean" }
               },
-              { "name": "disabled", "value": { "type": "boolean" } },
-              { "name": "label", "value": { "type": "string" } },
-              { "name": "href", "value": { "type": "string" } }
+              {
+                "name": "href",
+                "description": "The href of the underlying link",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "value",
+                "description": "The value of the item. It must not contain commas. See `getValue()`",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "componentRole",
+                "description": "The role of the item. This will be reflected as `role` to the underlying button or link. Default is `'menuitem'.`",
+                "value": { "type": "MenuItemRole" }
+              }
             ],
             "events": []
           }
@@ -805,11 +867,7 @@
               "name": "numOfItems",
               "value": { "type": "Number", "default": "1" }
             },
-            {
-              "name": "_page",
-              "description": "Internal page state that contains an\nalready clamped page number. Should only\nbe accessed through the `page` getter and\nsetter.",
-              "value": { "type": "Number", "default": "1" }
-            }
+            { "name": "_page", "value": { "type": "string" } }
           ],
           "events": [{ "name": "leu:pagechange" }],
           "js": {
@@ -817,11 +875,7 @@
               { "name": "defaultPage", "value": { "type": "number" } },
               { "name": "itemsPerPage", "value": { "type": "Number" } },
               { "name": "numOfItems", "value": { "type": "Number" } },
-              {
-                "name": "_page",
-                "description": "Internal page state that contains an\nalready clamped page number. Should only\nbe accessed through the `page` getter and\nsetter.",
-                "value": { "type": "Number" }
-              }
+              { "name": "_page", "value": {} }
             ],
             "events": [{ "name": "leu:pagechange" }]
           }
@@ -831,14 +885,21 @@
           "description": "\n---\n",
           "doc-url": "",
           "attributes": [
-            { "name": "anchor", "value": { "type": "string" } },
-            { "name": "active", "value": { "type": "boolean" } },
             {
-              "name": "placement",
+              "name": "anchor",
               "value": {
-                "type": "\"top\"|\"top-start\"|\"top-end\"|\"bottom\"|\"bottom-start\"|\"bottom-end\"|\"left\"|\"left-start\"|\"left-end\"|\"right\"|\"right-start\"|\"right-end\""
+                "type": "string | HTMLElement",
+                "default": "undefined"
               }
             },
+            {
+              "name": "active",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "placement",
+              "value": { "type": "Placement", "default": "undefined" }
+            },
             {
               "name": "flip",
               "value": { "type": "boolean", "default": "false" }
@@ -847,28 +908,35 @@
               "name": "shift",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "shiftPadding", "value": { "type": "number" } },
+            {
+              "name": "shiftPadding",
+              "value": { "type": "number", "default": "0" }
+            },
             {
               "name": "matchSize",
-              "value": { "type": "\"width\" | \"height\" | \"both\"" }
+              "value": {
+                "type": "\"width\" | \"height\" | \"both\"",
+                "default": "undefined"
+              }
             },
             {
               "name": "autoSize",
-              "value": { "type": "\"width\" | \"height\" | \"both\"" }
+              "value": {
+                "type": "\"width\" | \"height\" | \"both\"",
+                "default": "undefined"
+              }
             },
-            { "name": "autoSizePadding", "value": { "type": "number" } }
+            {
+              "name": "autoSizePadding",
+              "value": { "type": "number", "default": "0" }
+            }
           ],
           "events": [],
           "js": {
             "properties": [
-              { "name": "anchor", "value": {} },
+              { "name": "anchor", "value": { "type": "string | HTMLElement" } },
               { "name": "active", "value": { "type": "boolean" } },
-              {
-                "name": "placement",
-                "value": {
-                  "type": "\"top\"|\"top-start\"|\"top-end\"|\"bottom\"|\"bottom-start\"|\"bottom-end\"|\"left\"|\"left-start\"|\"left-end\"|\"right\"|\"right-start\"|\"right-end\""
-                }
-              },
+              { "name": "placement", "value": { "type": "Placement" } },
               { "name": "flip", "value": { "type": "boolean" } },
               { "name": "shift", "value": { "type": "boolean" } },
               { "name": "shiftPadding", "value": { "type": "number" } },
@@ -898,20 +966,19 @@
               "name": "disabled",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "identifier", "value": { "type": "string" } },
-            { "name": "value", "value": { "type": "string" } },
-            { "name": "name", "value": { "type": "string" } },
-            { "name": "label", "value": { "type": "string" } }
+            {
+              "name": "value",
+              "value": { "type": "string", "default": "\"\"" }
+            },
+            { "name": "name", "value": { "type": "string", "default": "\"\"" } }
           ],
           "events": [],
           "js": {
             "properties": [
               { "name": "checked", "value": { "type": "boolean" } },
               { "name": "disabled", "value": { "type": "boolean" } },
-              { "name": "identifier", "value": { "type": "string" } },
               { "name": "value", "value": { "type": "string" } },
-              { "name": "name", "value": { "type": "string" } },
-              { "name": "label", "value": { "type": "string" } }
+              { "name": "name", "value": { "type": "string" } }
             ],
             "events": []
           }
@@ -951,39 +1018,52 @@
         },
         {
           "name": "leu-select",
-          "description": "\n---\n\n\n### **Methods:**\n - **selectOption(option: _*_)** - Adds or replaces the given option in the options array.\n\n### **Slots:**\n - **before** - Optional content the appears before the option list\n- **after** - Optional content the appears after the option list",
+          "description": "\n---\n\n\n### **Methods:**\n - **_updateMenuItems(changed)** - Apply the current state to the menu items.\n- Set the active property when the value property has changed.\n- Hide menu items that do not match the filter.\n- **_getDisplayValue(): _String | nothing_** - Determines the value or label that should be displayed inside the toggle button.\n- **_isSelected(menuItemValue: _String_): _Boolean_** - Checks if the given value is selected.\n- **_handlePopupFocusOut(event)** - Close the dropdown if the focus moves outside the component.\n\n### **Slots:**\n - **before** - Optional content the appears before the option list\n- **after** - Optional content the appears after the option list",
           "doc-url": "",
           "attributes": [
+            {
+              "name": "value",
+              "description": "List of selected values. If they're set from outside the component, the select element tries to find all the options with the given values and selects them.",
+              "value": { "type": "array", "default": "[]" }
+            },
+            {
+              "name": "name",
+              "description": "Reflects to the name attribute of the hidden input field that would be used in a form",
+              "value": { "type": "string", "default": "\"\"" }
+            },
             {
               "name": "open",
+              "description": "The expanded state of the popup",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "label",
+              "description": "The label of the select",
               "value": { "type": "string", "default": "\"\"" }
             },
-            {
-              "name": "options",
-              "value": { "type": "array", "default": "[]" }
-            },
-            { "name": "value", "value": { "type": "array", "default": "[]" } },
             {
               "name": "clearable",
+              "description": "Show a clearable button to reset the value",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "disabled",
+              "description": "If the select should be disabled",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "filterable",
+              "description": "Show an input field to filter the options inside the popup",
               "value": { "type": "boolean", "default": "false" }
             },
             {
               "name": "multiple",
+              "description": "Allow multiple selections",
               "value": { "type": "boolean", "default": "false" }
             },
-            { "name": "optionFilter", "value": { "type": "string" } }
+            { "name": "_optionFilter", "value": { "type": "string" } },
+            { "name": "_hasFilterResults", "value": { "type": "string" } },
+            { "name": "_displayValue", "value": { "type": "string" } }
           ],
           "slots": [
             {
@@ -998,15 +1078,49 @@
           "events": [],
           "js": {
             "properties": [
-              { "name": "open", "value": { "type": "boolean" } },
-              { "name": "label", "value": { "type": "string" } },
-              { "name": "options", "value": { "type": "array" } },
-              { "name": "value", "value": { "type": "array" } },
-              { "name": "clearable", "value": { "type": "boolean" } },
-              { "name": "disabled", "value": { "type": "boolean" } },
-              { "name": "filterable", "value": { "type": "boolean" } },
-              { "name": "multiple", "value": { "type": "boolean" } },
-              { "name": "optionFilter", "value": {} }
+              {
+                "name": "value",
+                "description": "List of selected values. If they're set from outside the component, the select element tries to find all the options with the given values and selects them.",
+                "value": { "type": "array" }
+              },
+              {
+                "name": "name",
+                "description": "Reflects to the name attribute of the hidden input field that would be used in a form",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "open",
+                "description": "The expanded state of the popup",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "label",
+                "description": "The label of the select",
+                "value": { "type": "string" }
+              },
+              {
+                "name": "clearable",
+                "description": "Show a clearable button to reset the value",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "disabled",
+                "description": "If the select should be disabled",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "filterable",
+                "description": "Show an input field to filter the options inside the popup",
+                "value": { "type": "boolean" }
+              },
+              {
+                "name": "multiple",
+                "description": "Allow multiple selections",
+                "value": { "type": "boolean" }
+              },
+              { "name": "_optionFilter", "value": {} },
+              { "name": "_hasFilterResults", "value": {} },
+              { "name": "_displayValue", "value": {} }
             ],
             "events": []
           }