@viasat/beam-web-components 2.58.1 → 2.59.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viasat/beam-web-components",
-  "version": "2.58.1",
+  "version": "2.59.0",
   "description": "Framework-agnostic web components for the Beam Design System built with Lit, compatible with Angular, Vue, Svelte, and vanilla JavaScript",
   "license": "MIT",
   "author": "Viasat",
@@ -64,11 +64,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@viasat/beam-fonts": "2.58.1",
-    "@viasat/beam-shared": "2.58.1",
-    "@viasat/beam-styles": "2.58.1",
-    "@viasat/beam-tokens": "2.58.1",
-    "@viasat/beam-icons": "2.58.1",
+    "@viasat/beam-fonts": "2.59.0",
+    "@viasat/beam-shared": "2.59.0",
+    "@viasat/beam-styles": "2.59.0",
+    "@viasat/beam-tokens": "2.59.0",
+    "@viasat/beam-icons": "2.59.0",
     "clsx": "^1.2.1",
     "lit": "^3.1.0",
     "@lit/context": "^1.1.1",

package/vscode.html-custom-data.json

@@ -61,79 +61,6 @@
         }
       ]
     },
-    {
-      "name": "bm-alert",
-      "description": "`bm-alert`\n\n### Attributes:\n- **heading**  - Specify the heading text for Alert\n- **body**  - Specify the body text for Alert\n- **size**  - Specify the size of the Alert\n- **fullWidth**  - Specify if the Alert has no border radius\n- **theme**  - Specify the theme of the Alert. By default it inherits the theme from the parent\n- **appearance**  - Specify the appearance of the Alert\n- **hidden**  - Specify if the Alert is hidden\n- **hideIcon**  - Specify if the icon displays on the Alert\n- **dismissible**  - Specify if the Alert can be dismissed\n- **disableAutoFocus**  - Prevent autofocus on show\n- **disableCloseOnEscape**  - Prevent Escape from closing\n---\n\n\n### **Events:**\n - **bm-dismiss** - Dispatched when the Alert has been dismissed\n\n### **Slots:**\n - **icon** - Specify a different icon for the Alert\n- **heading** - Specify the heading text for Alert or pass the `heading` attribute to set the heading\n- **body** - Specify the body text for Alert or pass the `body` attribute to set the body\n- **actions** - Specify if actions display on the Alert",
-      "attributes": [
-        {
-          "name": "heading",
-          "description": "Specify the heading text for Alert",
-          "values": []
-        },
-        {
-          "name": "body",
-          "description": "Specify the body text for Alert",
-          "values": []
-        },
-        {
-          "name": "size",
-          "description": "Specify the size of the Alert",
-          "values": [{ "name": "sm" }, { "name": "md" }]
-        },
-        {
-          "name": "fullWidth",
-          "description": "Specify if the Alert has no border radius",
-          "values": []
-        },
-        {
-          "name": "theme",
-          "description": "Specify the theme of the Alert. By default it inherits the theme from the parent",
-          "values": [{ "name": "light" }, { "name": "dark" }]
-        },
-        {
-          "name": "appearance",
-          "description": "Specify the appearance of the Alert",
-          "values": [
-            { "name": "infoPrimary" },
-            { "name": "infoSecondary" },
-            { "name": "positive" },
-            { "name": "warning" },
-            { "name": "negative" }
-          ]
-        },
-        {
-          "name": "hidden",
-          "description": "Specify if the Alert is hidden",
-          "values": []
-        },
-        {
-          "name": "hideIcon",
-          "description": "Specify if the icon displays on the Alert",
-          "values": []
-        },
-        {
-          "name": "dismissible",
-          "description": "Specify if the Alert can be dismissed",
-          "values": []
-        },
-        {
-          "name": "disableAutoFocus",
-          "description": "Prevent autofocus on show",
-          "values": []
-        },
-        {
-          "name": "disableCloseOnEscape",
-          "description": "Prevent Escape from closing",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Storybook",
-          "url": "https://web-components.beam.viasat.com/?path=/docs/components-alert"
-        }
-      ]
-    },
     {
       "name": "bm-badge",
       "description": "`bm-badge`\n\n### Attributes:\n- **appearance**  - Specify the appearance of the Badge\n- **theme**  - Theme of the Badge\n- **size**  - Specify the size of the Badge\n- **emphasis**  - Specify the emphasis of the Badge\n- **hideIcon**  - Hides Badge icon\n---\n\n\n### **Slots:**\n - **default** - Provide text for the Badge\n- **icon** - Specify a different icon for the Badge",
@@ -177,104 +104,6 @@
         }
       ]
     },
-    {
-      "name": "bm-avatar",
-      "description": "`bm-avatar`\n\n### Attributes:\n- **appearance**  - Specify the appearance of the Avatar\n- **name**  - Specify a name to display initials in the Avatar\n- **src**  - Pass an image to the Avatar\n- **alt**  - Specify alt for image\n- **size**  - Specify the size of the Avatar\n- **disabled**  - Specify if the Avatar is disabled\n- **shape**  - Specify the shape of the Avatar\n- **isInteractive**  - If Avatar is interactive, use `isInteractive` to make the Avatar focusable and show state layer\n- **isFocusable**  - If Avatar is not interactive and Tooltip is provided, use `isFocusable` to make the Avatar focusable\n- **withBorder** \n---\n\n\n### **Slots:**\n - **icon** - Customize the default icon",
-      "attributes": [
-        {
-          "name": "appearance",
-          "description": "Specify the appearance of the Avatar",
-          "values": [{ "name": "accent" }, { "name": "neutral" }]
-        },
-        {
-          "name": "name",
-          "description": "Specify a name to display initials in the Avatar",
-          "values": []
-        },
-        {
-          "name": "src",
-          "description": "Pass an image to the Avatar",
-          "values": []
-        },
-        { "name": "alt", "description": "Specify alt for image", "values": [] },
-        {
-          "name": "size",
-          "description": "Specify the size of the Avatar",
-          "values": [
-            { "name": "xs" },
-            { "name": "sm" },
-            { "name": "md" },
-            { "name": "lg" },
-            { "name": "xl" }
-          ]
-        },
-        {
-          "name": "disabled",
-          "description": "Specify if the Avatar is disabled",
-          "values": []
-        },
-        {
-          "name": "shape",
-          "description": "Specify the shape of the Avatar",
-          "values": [{ "name": "circle" }, { "name": "square" }]
-        },
-        {
-          "name": "isInteractive",
-          "description": "If Avatar is interactive, use `isInteractive` to make the Avatar focusable and show state layer",
-          "values": []
-        },
-        {
-          "name": "isFocusable",
-          "description": "If Avatar is not interactive and Tooltip is provided, use `isFocusable` to make the Avatar focusable",
-          "values": []
-        },
-        { "name": "withBorder", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Storybook",
-          "url": "https://web-components.beam.viasat.com/?path=/docs/components-avatar"
-        }
-      ]
-    },
-    {
-      "name": "bm-avatar-group",
-      "description": "`bm-avatar-group`\n\n### Attributes:\n- **wrapping**  - Specify if the AvatarGroup wraps\n- **maxCount**  - Specify the max number of avatars displayed in the group.\n- **size**  - Specify the size of all Avatars\n- **layout**  - Specify the kind of the group.\n---\n\n\n### **Slots:**\n - **default** - Add Avatars to create a group",
-      "attributes": [
-        {
-          "name": "wrapping",
-          "description": "Specify if the AvatarGroup wraps",
-          "values": []
-        },
-        {
-          "name": "maxCount",
-          "description": "Specify the max number of avatars displayed in the group.",
-          "values": []
-        },
-        {
-          "name": "size",
-          "description": "Specify the size of all Avatars",
-          "values": [
-            { "name": "xs" },
-            { "name": "sm" },
-            { "name": "md" },
-            { "name": "lg" },
-            { "name": "xl" }
-          ]
-        },
-        {
-          "name": "layout",
-          "description": "Specify the kind of the group.",
-          "values": [{ "name": "stacked" }, { "name": "spaced" }]
-        }
-      ],
-      "references": [
-        {
-          "name": "Storybook",
-          "url": "https://web-components.beam.viasat.com/?path=/docs/components-avatar"
-        }
-      ]
-    },
     {
       "name": "bm-badge-dot",
       "description": "`bm-badge-dot`\n\n### Attributes:\n- **theme**  - Specify the theme of the BadgeDot. By default it inherits the theme from the parent\n- **appearance**  - Specify the appearance of the BadgeDot\n- **emphasis**  - Specify the emphasis of the BadgeDot\n- **overrideDotColor**  - Overrides default dot color\n---\n\n\n### **Slots:**\n - **default** - Provide text for the BadgeDot",
@@ -759,21 +588,192 @@
           "values": []
         },
         {
-          "name": "truncationWidth",
-          "description": "Specify truncation width of the items. Sets max-width for all items but the last.",
+          "name": "truncationWidth",
+          "description": "Specify truncation width of the items. Sets max-width for all items but the last.",
+          "values": []
+        },
+        {
+          "name": "isCurrent",
+          "description": "Specify explicitly if the item is the last one",
+          "values": []
+        },
+        { "name": "isCollapsed", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Storybook",
+          "url": "https://web-components.beam.viasat.com/?path=/docs/components-breadcrumb"
+        }
+      ]
+    },
+    {
+      "name": "bm-alert",
+      "description": "`bm-alert`\n\n### Attributes:\n- **heading**  - Specify the heading text for Alert\n- **body**  - Specify the body text for Alert\n- **size**  - Specify the size of the Alert\n- **fullWidth**  - Specify if the Alert has no border radius\n- **theme**  - Specify the theme of the Alert. By default it inherits the theme from the parent\n- **appearance**  - Specify the appearance of the Alert\n- **hidden**  - Specify if the Alert is hidden\n- **hideIcon**  - Specify if the icon displays on the Alert\n- **dismissible**  - Specify if the Alert can be dismissed\n- **disableAutoFocus**  - Prevent autofocus on show\n- **disableCloseOnEscape**  - Prevent Escape from closing\n---\n\n\n### **Events:**\n - **bm-dismiss** - Dispatched when the Alert has been dismissed\n\n### **Slots:**\n - **icon** - Specify a different icon for the Alert\n- **heading** - Specify the heading text for Alert or pass the `heading` attribute to set the heading\n- **body** - Specify the body text for Alert or pass the `body` attribute to set the body\n- **actions** - Specify if actions display on the Alert",
+      "attributes": [
+        {
+          "name": "heading",
+          "description": "Specify the heading text for Alert",
+          "values": []
+        },
+        {
+          "name": "body",
+          "description": "Specify the body text for Alert",
+          "values": []
+        },
+        {
+          "name": "size",
+          "description": "Specify the size of the Alert",
+          "values": [{ "name": "sm" }, { "name": "md" }]
+        },
+        {
+          "name": "fullWidth",
+          "description": "Specify if the Alert has no border radius",
+          "values": []
+        },
+        {
+          "name": "theme",
+          "description": "Specify the theme of the Alert. By default it inherits the theme from the parent",
+          "values": [{ "name": "light" }, { "name": "dark" }]
+        },
+        {
+          "name": "appearance",
+          "description": "Specify the appearance of the Alert",
+          "values": [
+            { "name": "infoPrimary" },
+            { "name": "infoSecondary" },
+            { "name": "positive" },
+            { "name": "warning" },
+            { "name": "negative" }
+          ]
+        },
+        {
+          "name": "hidden",
+          "description": "Specify if the Alert is hidden",
+          "values": []
+        },
+        {
+          "name": "hideIcon",
+          "description": "Specify if the icon displays on the Alert",
+          "values": []
+        },
+        {
+          "name": "dismissible",
+          "description": "Specify if the Alert can be dismissed",
+          "values": []
+        },
+        {
+          "name": "disableAutoFocus",
+          "description": "Prevent autofocus on show",
+          "values": []
+        },
+        {
+          "name": "disableCloseOnEscape",
+          "description": "Prevent Escape from closing",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Storybook",
+          "url": "https://web-components.beam.viasat.com/?path=/docs/components-alert"
+        }
+      ]
+    },
+    {
+      "name": "bm-avatar",
+      "description": "`bm-avatar`\n\n### Attributes:\n- **appearance**  - Specify the appearance of the Avatar\n- **name**  - Specify a name to display initials in the Avatar\n- **src**  - Pass an image to the Avatar\n- **alt**  - Specify alt for image\n- **size**  - Specify the size of the Avatar\n- **disabled**  - Specify if the Avatar is disabled\n- **shape**  - Specify the shape of the Avatar\n- **isInteractive**  - If Avatar is interactive, use `isInteractive` to make the Avatar focusable and show state layer\n- **isFocusable**  - If Avatar is not interactive and Tooltip is provided, use `isFocusable` to make the Avatar focusable\n- **withBorder** \n---\n\n\n### **Slots:**\n - **icon** - Customize the default icon",
+      "attributes": [
+        {
+          "name": "appearance",
+          "description": "Specify the appearance of the Avatar",
+          "values": [{ "name": "accent" }, { "name": "neutral" }]
+        },
+        {
+          "name": "name",
+          "description": "Specify a name to display initials in the Avatar",
+          "values": []
+        },
+        {
+          "name": "src",
+          "description": "Pass an image to the Avatar",
+          "values": []
+        },
+        { "name": "alt", "description": "Specify alt for image", "values": [] },
+        {
+          "name": "size",
+          "description": "Specify the size of the Avatar",
+          "values": [
+            { "name": "xs" },
+            { "name": "sm" },
+            { "name": "md" },
+            { "name": "lg" },
+            { "name": "xl" }
+          ]
+        },
+        {
+          "name": "disabled",
+          "description": "Specify if the Avatar is disabled",
+          "values": []
+        },
+        {
+          "name": "shape",
+          "description": "Specify the shape of the Avatar",
+          "values": [{ "name": "circle" }, { "name": "square" }]
+        },
+        {
+          "name": "isInteractive",
+          "description": "If Avatar is interactive, use `isInteractive` to make the Avatar focusable and show state layer",
+          "values": []
+        },
+        {
+          "name": "isFocusable",
+          "description": "If Avatar is not interactive and Tooltip is provided, use `isFocusable` to make the Avatar focusable",
+          "values": []
+        },
+        { "name": "withBorder", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Storybook",
+          "url": "https://web-components.beam.viasat.com/?path=/docs/components-avatar"
+        }
+      ]
+    },
+    {
+      "name": "bm-avatar-group",
+      "description": "`bm-avatar-group`\n\n### Attributes:\n- **wrapping**  - Specify if the AvatarGroup wraps\n- **maxCount**  - Specify the max number of avatars displayed in the group.\n- **size**  - Specify the size of all Avatars\n- **layout**  - Specify the kind of the group.\n---\n\n\n### **Slots:**\n - **default** - Add Avatars to create a group",
+      "attributes": [
+        {
+          "name": "wrapping",
+          "description": "Specify if the AvatarGroup wraps",
+          "values": []
+        },
+        {
+          "name": "maxCount",
+          "description": "Specify the max number of avatars displayed in the group.",
           "values": []
         },
         {
-          "name": "isCurrent",
-          "description": "Specify explicitly if the item is the last one",
-          "values": []
+          "name": "size",
+          "description": "Specify the size of all Avatars",
+          "values": [
+            { "name": "xs" },
+            { "name": "sm" },
+            { "name": "md" },
+            { "name": "lg" },
+            { "name": "xl" }
+          ]
         },
-        { "name": "isCollapsed", "values": [] }
+        {
+          "name": "layout",
+          "description": "Specify the kind of the group.",
+          "values": [{ "name": "stacked" }, { "name": "spaced" }]
+        }
       ],
       "references": [
         {
           "name": "Storybook",
-          "url": "https://web-components.beam.viasat.com/?path=/docs/components-breadcrumb"
+          "url": "https://web-components.beam.viasat.com/?path=/docs/components-avatar"
         }
       ]
     },
@@ -1909,6 +1909,121 @@
         }
       ]
     },
+    {
+      "name": "bm-form",
+      "description": "`bm-form`\n---\n\n\n### **Events:**\n - **submit** - Validates the inputs and submits the form\n\n### **Slots:**\n - **slot** - Add controls to the Form",
+      "attributes": [
+        {
+          "name": "validationMode",
+          "description": "Specify if validation runs on change or when loosing focus",
+          "values": [
+            { "name": "onChange" },
+            { "name": "onBlur" },
+            { "name": "onSubmit" }
+          ]
+        },
+        {
+          "name": "initialValues",
+          "description": "Specify initial values on Form controls based on their names",
+          "values": [{ "name": "Record<string" }, { "name": "FormValue>" }]
+        },
+        {
+          "name": "required",
+          "description": "Specify if input is a required",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Specify if input is a disabled",
+          "values": []
+        },
+        {
+          "name": "readOnly",
+          "description": "Specify if input is a read only",
+          "values": []
+        },
+        { "name": "action", "values": [] },
+        { "name": "method", "values": [] },
+        { "name": "target", "values": [] },
+        { "name": "enctype", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Storybook",
+          "url": "https://web-components.beam.viasat.com/?path=/docs/forms-form"
+        }
+      ]
+    },
+    {
+      "name": "bm-native-select",
+      "description": "`bm-native-select`\n---\n\n\n### **Slots:**\n - **slot** - Specify Options for NativeSelect\n- **label** - Specify Label for NativeSelect\n- **helper-text** - Specify HelperText for NativeSelect",
+      "attributes": [
+        {
+          "name": "required",
+          "description": "Specify if NativeSelect is a required input",
+          "values": []
+        },
+        {
+          "name": "readOnly",
+          "description": "Specify if NativeSelect displays in a read-only state",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Specify if NativeSelect displays in a disabled state",
+          "values": []
+        },
+        {
+          "name": "error",
+          "description": "Specify error text and display error state of a NativeSelect",
+          "values": []
+        },
+        {
+          "name": "fluid",
+          "description": "Specify if NativeSelect is fluid",
+          "values": []
+        },
+        {
+          "name": "size",
+          "description": "Specify the size of NativeSelect",
+          "values": [{ "name": "sm" }, { "name": "md" }, { "name": "lg" }]
+        },
+        {
+          "name": "width",
+          "description": "Specify the width of NativeSelect",
+          "values": []
+        },
+        {
+          "name": "ellipse",
+          "description": "Specify if overflow displays ellipsis",
+          "values": []
+        },
+        {
+          "name": "hideRequiredMarker",
+          "description": "Specify if the NativeSelect displays with an asterisk",
+          "values": []
+        },
+        {
+          "name": "theme",
+          "description": "Specify the theme of the NativeSelect. By default it inherits the theme from the parent",
+          "values": [{ "name": "light" }, { "name": "dark" }]
+        },
+        { "name": "id", "values": [] },
+        { "name": "name", "values": [] },
+        { "name": "value", "values": [] },
+        {
+          "name": "validationRules",
+          "values": [{ "name": "Array<FormValidator>" }]
+        },
+        { "name": "input-aria-label", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Storybook",
+          "url": "https://web-components.beam.viasat.com/?path=/docs/forms-nativeselect"
+        }
+      ]
+    },
     {
       "name": "bm-file-upload-button",
       "description": "`bm-file-upload-button`\n\n### Attributes:\n- **error**  - Specify if FileUpload is in error state\n- **accept**  - Specify the accepted file types\n- **multiple**  - Specify if multiple files can be uploaded\n---\n\n\n### **Slots:**\n - **default** - Specify text for the Button\n- **iconBefore** - Specify if the Button displays icon before the text\n- **iconAfter** - Specify if the Button displays icon after the text",
@@ -2216,121 +2331,6 @@
         }
       ]
     },
-    {
-      "name": "bm-form",
-      "description": "`bm-form`\n---\n\n\n### **Events:**\n - **submit** - Validates the inputs and submits the form\n\n### **Slots:**\n - **slot** - Add controls to the Form",
-      "attributes": [
-        {
-          "name": "validationMode",
-          "description": "Specify if validation runs on change or when loosing focus",
-          "values": [
-            { "name": "onChange" },
-            { "name": "onBlur" },
-            { "name": "onSubmit" }
-          ]
-        },
-        {
-          "name": "initialValues",
-          "description": "Specify initial values on Form controls based on their names",
-          "values": [{ "name": "Record<string" }, { "name": "FormValue>" }]
-        },
-        {
-          "name": "required",
-          "description": "Specify if input is a required",
-          "values": []
-        },
-        {
-          "name": "disabled",
-          "description": "Specify if input is a disabled",
-          "values": []
-        },
-        {
-          "name": "readOnly",
-          "description": "Specify if input is a read only",
-          "values": []
-        },
-        { "name": "action", "values": [] },
-        { "name": "method", "values": [] },
-        { "name": "target", "values": [] },
-        { "name": "enctype", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Storybook",
-          "url": "https://web-components.beam.viasat.com/?path=/docs/forms-form"
-        }
-      ]
-    },
-    {
-      "name": "bm-native-select",
-      "description": "`bm-native-select`\n---\n\n\n### **Slots:**\n - **slot** - Specify Options for NativeSelect\n- **label** - Specify Label for NativeSelect\n- **helper-text** - Specify HelperText for NativeSelect",
-      "attributes": [
-        {
-          "name": "required",
-          "description": "Specify if NativeSelect is a required input",
-          "values": []
-        },
-        {
-          "name": "readOnly",
-          "description": "Specify if NativeSelect displays in a read-only state",
-          "values": []
-        },
-        {
-          "name": "disabled",
-          "description": "Specify if NativeSelect displays in a disabled state",
-          "values": []
-        },
-        {
-          "name": "error",
-          "description": "Specify error text and display error state of a NativeSelect",
-          "values": []
-        },
-        {
-          "name": "fluid",
-          "description": "Specify if NativeSelect is fluid",
-          "values": []
-        },
-        {
-          "name": "size",
-          "description": "Specify the size of NativeSelect",
-          "values": [{ "name": "sm" }, { "name": "md" }, { "name": "lg" }]
-        },
-        {
-          "name": "width",
-          "description": "Specify the width of NativeSelect",
-          "values": []
-        },
-        {
-          "name": "ellipse",
-          "description": "Specify if overflow displays ellipsis",
-          "values": []
-        },
-        {
-          "name": "hideRequiredMarker",
-          "description": "Specify if the NativeSelect displays with an asterisk",
-          "values": []
-        },
-        {
-          "name": "theme",
-          "description": "Specify the theme of the NativeSelect. By default it inherits the theme from the parent",
-          "values": [{ "name": "light" }, { "name": "dark" }]
-        },
-        { "name": "id", "values": [] },
-        { "name": "name", "values": [] },
-        { "name": "value", "values": [] },
-        {
-          "name": "validationRules",
-          "values": [{ "name": "Array<FormValidator>" }]
-        },
-        { "name": "input-aria-label", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Storybook",
-          "url": "https://web-components.beam.viasat.com/?path=/docs/forms-nativeselect"
-        }
-      ]
-    },
     {
       "name": "bm-radio-button",
       "description": "`bm-radio-button`\n\n### Attributes:\n- **label**  - Specify the text for the label\n- **error**  - Specify error text and display error state of a RadioButton\n- **readOnly**  - Specify if RadioButton displays in a read-only state\n- **disabled**  - Specify if RadioButton displays in a disabled state\n- **theme**  - Specify the theme of the RadioButton. By default it inherits the theme from the parent\n- **value**  - The value attribute for the input element\n- **checked**  - The checked attribute for the input element\n- **onKeyDown**  - A user-defined function to handle keydown events\n---\n",