@skf-design-system/ui-components 1.0.0-alpha.34 → 1.0.0-alpha.35

package/dist/types/vue/index.d.ts

@@ -1,41 +1,81 @@
 import type { DefineComponent } from "vue";
 
+import type { SkfIcon } from "../../components/icon/icon.component.js";
+import type { SkfAccordionItem, CustomEvent } from "../../components/accordion-item/accordion-item.component.js";
 import type { SkfAccordion } from "../../components/accordion/accordion.component.js";
-import type { SkfAlert } from "../../components/alert/alert.component.js";
-import type { SkfBreadcrumb } from "../../components/breadcrumb/breadcrumb.component.js";
+import type { SkfAlert, CustomEvent } from "../../components/alert/alert.component.js";
 import type { SkfBreadcrumbItem } from "../../components/breadcrumb-item/breadcrumb-item.component.js";
-import type { SkfButton } from "../../components/button/button.component.js";
+import type { SkfBreadcrumb } from "../../components/breadcrumb/breadcrumb.component.js";
+import type { SkfLoader } from "../../components/loader/loader.component.js";
+import type { SkfButton, CustomEvent } from "../../components/button/button.component.js";
 import type { SkfCard } from "../../components/card/card.component.js";
-import type { SkfCheckbox } from "../../components/checkbox/checkbox.component.js";
-import type { SkfCollapse, CustomEvent } from "../../components/collapse/collapse.component.js";
-import type { SkfDialog } from "../../components/dialog/dialog.component.js";
-import type { SkfDivider } from "../../components/divider/divider.component.js";
+import type { SkfCheckbox, Event } from "../../components/checkbox/checkbox.component.js";
+import type { SkfDatepickerCalendar } from "../../components/datepicker-calendar/datepicker-calendar.component.js";
+import type { SkfDatepicker } from "../../components/datepicker/datepicker.component.js";
 import type { SkfHeading } from "../../components/heading/heading.component.js";
-import type { SkfIcon } from "../../components/icon/icon.component.js";
-import type { SkfInput } from "../../components/input/input.component.js";
-import type { SkfLink } from "../../components/link/link.component.js";
-import type { SkfLoader } from "../../components/loader/loader.component.js";
+import type { SkfDialog, CustomEvent } from "../../components/dialog/dialog.component.js";
+import type { SkfDivider } from "../../components/divider/divider.component.js";
+import type { SkfDrawer, CustomEvent } from "../../components/drawer/drawer.component.js";
 import type { SkfLogo } from "../../components/logo/logo.component.js";
-import type { SkfMenu } from "../../components/menu/menu.component.js";
-import type { SkfMenuItem, CustomEvent } from "../../components/menu-item/menu-item.component.js";
-import type { SkfPopover } from "../../components/popover/popover.component.js";
+import type { SkfNav } from "../../components/nav/nav.component.js";
+import type { SkfHeader } from "../../components/header/header.component.js";
+import type { SkfInput, CustomEvent } from "../../components/input/input.component.js";
+import type { SkfLink } from "../../components/link/link.component.js";
+import type { SkfMenuItem } from "../../components/menu-item/menu-item.component.js";
+import type { SkfMenu, CustomEvent } from "../../components/menu/menu.component.js";
+import type { SkfNavItem } from "../../components/nav-item/nav-item.component.js";
+import type { SkfPopover, CustomEvent } from "../../components/popover/popover.component.js";
 import type { SkfProgress } from "../../components/progress/progress.component.js";
-import type { SkfRadio } from "../../components/radio/radio.component.js";
-import type { SkfSelect } from "../../components/select/select.component.js";
-import type { SkfSelectOption } from "../../components/select-option/select-option.component.js";
+import type { SkfRadio, Event } from "../../components/radio/radio.component.js";
+import type {
+  SkfSegmentedButtonItem,
+  CustomEvent,
+} from "../../components/segmented-button-item/segmented-button-item.component.js";
+import type { SkfSegmentedButton } from "../../components/segmented-button/segmented-button.component.js";
 import type { SkfSelectOptionGroup } from "../../components/select-option-group/select-option-group.component.js";
-import type { SkfStepper } from "../../components/stepper/stepper.component.js";
+import type { SkfTag } from "../../components/tag/tag.component.js";
+import type { SkfSelect, Event, CustomEvent } from "../../components/select/select.component.js";
+import type { SkfSelectOption } from "../../components/select-option/select-option.component.js";
 import type { SkfStepperItem } from "../../components/stepper-item/stepper-item.component.js";
+import type { SkfStepper, CustomEvent } from "../../components/stepper/stepper.component.js";
 import type { SkfSwitch } from "../../components/switch/switch.component.js";
-import type { SkfTab, CustomEvent } from "../../components/tab/tab.component.js";
-import type { SkfTabGroup } from "../../components/tab-group/tab-group.component.js";
 import type { SkfTabPanel } from "../../components/tab-panel/tab-panel.component.js";
-import type { SkfTag } from "../../components/tag/tag.component.js";
+import type { SkfTabs } from "../../components/tabs/tabs.component.js";
+import type { SkfTab, CustomEvent } from "../../components/tab/tab.component.js";
 import type { SkfTextArea } from "../../components/textarea/textarea.component.js";
-import type { SkfToast } from "../../components/toast/toast.component.js";
 import type { SkfToastWrapper } from "../../components/toast-wrapper/toast-wrapper.component.js";
+import type { SkfToast } from "../../components/toast/toast.component.js";
 import type { SkfTooltip } from "../../components/tooltip/tooltip.component.js";
 
+type SkfIconProps = {
+  /** Sets the color of the icon */
+  color?: SkfIcon["color"];
+  /** If defined, adds an alternate description to use for assistive devices */
+  label?: SkfIcon["label"];
+  /** Name of the icon to display */
+  name?: SkfIcon["name"];
+  /** Size of the icon */
+  size?: SkfIcon["size"];
+};
+
+type SkfAccordionItemProps = {
+  /** If true, will animate the expand/accordion-item state */
+  animated?: SkfAccordionItem["animated"];
+  /** If true, will set the accordion-item to be expanded by default */
+  expanded?: SkfAccordionItem["expanded"];
+  /** Heading for the accordion-item */
+  heading?: SkfAccordionItem["heading"];
+  /** Defines which heading element will be rendered */
+  "heading-as"?: SkfAccordionItem["headingAs"];
+  /** If true, renders the small version */
+  small?: SkfAccordionItem["small"];
+  /** If true, will truncate the heading in accordion-item state */
+  truncate?: SkfAccordionItem["truncate"];
+
+  /** Event emitted when toggled */
+  "onskf-accordion-item-toggle"?: (e: CustomEvent<CustomEvent>) => void;
+};
+
 type SkfAccordionProps = {
   /** If true, will animate the expand/collapse state */
   animated?: SkfAccordion["animated"];
@@ -52,34 +92,43 @@ type SkfAccordionProps = {
 };
 
 type SkfAlertProps = {
-  /** If true, alert is being used as a toast (alertdialog) with an close button */
-  closeable?: SkfAlert["closeable"];
   /** Close button aria-label */
   "button-label"?: SkfAlert["buttonLabel"];
   /** If defined, displays leading icon */
   icon?: SkfAlert["icon"];
+  /** If true, renders with an close button and sets aria-role to `status` */
+  persistent?: SkfAlert["persistent"];
   /** If defined, gives the supplied appearance */
   severity?: SkfAlert["severity"];
 
   /** Fires when the close button is clicked */
-  "onskf-alert-close"?: (e: CustomEvent<never>) => void;
+  "onskf-alert-close"?: (e: CustomEvent<CustomEvent>) => void;
+};
+
+type SkfBreadcrumbItemProps = {
+  /** If defined, loads url on click */
+  href?: SkfBreadcrumbItem["href"];
+  /** If defined, custom onClick where the second return parameter enables custom routing. **Notice!** Only applicable if `href` is defined. */
+  onClick?: SkfBreadcrumbItem["onClick"];
 };
 
 type SkfBreadcrumbProps = {
   /** aria-label for the breadcrumb control */
   label?: SkfBreadcrumb["label"];
-  /** Displays an alternative size */
-  size?: SkfBreadcrumb["size"];
+  /** If true, renders a smaller version */
+  small?: SkfBreadcrumb["small"];
 
   /** Fired when the item is clicked */
   onclick?: (e: CustomEvent<never>) => void;
 };
 
-type SkfBreadcrumbItemProps = {
-  /** If defined, loads url on click */
-  href?: SkfBreadcrumbItem["href"];
-  /** If defined, custom onClick where the second return parameter enables custom routing. **Notice!** Only applicable if `href` is defined. */
-  onClick?: SkfBreadcrumbItem["onClick"];
+type SkfLoaderProps = {
+  /** Defines the aria-label */
+  "aria-label"?: SkfLoader["ariaLabel"];
+  /** If true, inverts the color (to be used on colored backgrounds) */
+  invert?: SkfLoader["invert"];
+  /** Defines the size of the loader */
+  size?: SkfLoader["size"];
 };
 
 type SkfButtonProps = {
@@ -89,9 +138,9 @@ type SkfButtonProps = {
   disabled?: SkfButton["disabled"];
   /** If provided, renders an icon before or after the text */
   icon?: SkfButton["icon"];
-  /** If true, removes border */
-  iconOnly?: SkfButton["iconOnly"];
-  /** If provided, determines the positioning of the icon in relation to the text */
+  /** If true, button will take a square shape */
+  "icon-only"?: SkfButton["iconOnly"];
+  /** Determines the positioning of the icon in relation to the text */
   "icon-position"?: SkfButton["iconPosition"];
   /** If true, hides text & icon and shows loading indicator. **Notice!** Only applicable if `variant` is `primary`. */
   loading?: SkfButton["loading"];
@@ -105,7 +154,7 @@ type SkfButtonProps = {
   variant?: SkfButton["variant"];
 
   /** Fires when the button is clicked */
-  onclick?: (e: CustomEvent<never>) => void;
+  onclick?: (e: CustomEvent<CustomEvent>) => void;
 };
 
 type SkfCardProps = {
@@ -145,26 +194,81 @@ type SkfCheckboxProps = {
   /** The current value of the input field */
   value?: SkfCheckbox["value"];
 
-  /** {object} - When the value of the input changes */
-  onchange?: (e: CustomEvent<never>) => void;
+  /** When the value of the input changes */
+  onchange?: (e: CustomEvent<Event>) => void;
 };
 
-type SkfCollapseProps = {
-  /** If true, will animate the expand/collapse state */
-  animated?: SkfCollapse["animated"];
-  /** If true, will set the collapse to be expanded by default */
-  expanded?: SkfCollapse["expanded"];
-  /** Heading for the collapse */
-  heading?: SkfCollapse["heading"];
-  /** Defines which heading element will be rendered */
-  "heading-as"?: SkfCollapse["headingAs"];
-  /** If true, renders the small version */
-  small?: SkfCollapse["small"];
-  /** If true, will truncate the heading in collapsed state */
-  truncate?: SkfCollapse["truncate"];
+type SkfDatepickerCalendarProps = {
+  /**  */
+  eventid?: SkfDatepickerCalendar["eventid"];
+  /**  */
+  firstDayOfWeek?: SkfDatepickerCalendar["firstDayOfWeek"];
+  /** A comma-separated list of dates (yyyy-mm-dd format) that are not selectable. */
+  "invalid-dates"?: SkfDatepickerCalendar["invalidDates"];
+  /**  */
+  locale?: SkfDatepickerCalendar["locale"];
+  /**  */
+  range?: SkfDatepickerCalendar["range"];
+  /** Earliest selectable date. (yyyy-mm-dd format) */
+  "selectable-from"?: SkfDatepickerCalendar["selectableFrom"];
+  /** Latest selectable date. (yyyy-mm-dd format) */
+  "selectable-to"?: SkfDatepickerCalendar["selectableTo"];
+  /**  */
+  "selected-date"?: SkfDatepickerCalendar["selectedDate"];
+  /**  */
+  selectedDateRange?: SkfDatepickerCalendar["selectedDateRange"];
+  /**  */
+  _listenToKeyboard?: SkfDatepickerCalendar["_listenToKeyboard"];
+  /**  */
+  _handleKeyDown?: SkfDatepickerCalendar["_handleKeyDown"];
+  /**  */
+  dateSelectable?: SkfDatepickerCalendar["dateSelectable"];
+};
 
-  /** Event emitted when toggled */
-  "onskf-collapse-toggle"?: (e: CustomEvent<CustomEvent>) => void;
+type SkfDatepickerProps = {
+  /** If defined, forces component to invalid state until removed. Its value is used as hint text. */
+  "custom-invalid"?: SkfDatepicker["customInvalid"];
+  /**  */
+  id?: SkfDatepicker["id"];
+  /** If defined, sets the input's label. Alternatively, you can use the `label` attribute. */
+  label?: SkfDatepicker["label"];
+  /** If true, hides the label visually */
+  "hide-label"?: SkfDatepicker["hideLabel"];
+  /** If defined, displays informational text below the field */
+  hint?: SkfDatepicker["hint"];
+  /** A comma-separated list of dates (yyyy-mm-dd format) that are not selectable. */
+  "invalid-dates"?: SkfDatepicker["invalidDates"];
+  /** If defined, adds name to the input-element */
+  name?: SkfDatepicker["name"];
+  /**  */
+  placeholder?: SkfDatepicker["placeholder"];
+  /**  */
+  range?: SkfDatepicker["range"];
+  /** If true, makes the element not mutable, meaning the user can not edit the control */
+  readonly?: SkfDatepicker["readonly"];
+  /** If defined, renders an alternative A11y text for the asterisk */
+  "required-label"?: SkfDatepicker["requiredLabel"];
+  /** Earliest selectable date. (yyyy-mm-dd format) */
+  "selectable-from"?: SkfDatepicker["selectableFrom"];
+  /** Latest selectable date. (yyyy-mm-dd format) */
+  "selectable-to"?: SkfDatepicker["selectableTo"];
+  /** If defined, displays provided severity state */
+  severity?: SkfDatepicker["severity"];
+  /** Size of the input */
+  size?: SkfDatepicker["size"];
+  /** Sets validation start */
+  "validate-on"?: SkfDatepicker["validateOn"];
+  /** The current value of the input field */
+  value?: SkfDatepicker["value"];
+  /**  */
+  focusTimeoutId?: SkfDatepicker["focusTimeoutId"];
+};
+
+type SkfHeadingProps = {
+  /** Controls which heading element will be rendered. Should not be used to affect appearance */
+  as?: SkfHeading["as"];
+  /** If defined, changes the appearance of the heading */
+  "styled-as"?: SkfHeading["styledAs"];
 };
 
 type SkfDialogProps = {
@@ -178,20 +282,15 @@ type SkfDialogProps = {
   "no-close-button"?: SkfDialog["noCloseButton"];
   /** If defined, removes the inner padding */
   "no-padding"?: SkfDialog["noPadding"];
-  /**  */
+  /** If true, indicates that the dialog is active and is available for interaction */
   open?: SkfDialog["open"];
-  /** If provided, will run function on dialog close */
-  onClose?: SkfDialog["onClose"];
-  /** Method that opens the dialog in modal state */
-  showModal?: SkfDialog["showModal"];
-  /** Method that closes the dialog */
-  close?: SkfDialog["close"];
+
   /** Fires when the dialog is opened (after transitioned in) */
-  "onskf-dialog-open"?: (e: CustomEvent<never>) => void;
-  /** Fires when the dialog is closed (before transitioned out) */
-  "onskf-dialog-close"?: (e: CustomEvent<never>) => void;
+  "onskf-dialog-opened"?: (e: CustomEvent<CustomEvent>) => void;
+  /** Fires when the dialog is closing (before transitioned out) */
+  "onskf-dialog-closing"?: (e: CustomEvent<CustomEvent>) => void;
   /** Fires when the dialog is closed (after transitioned out) */
-  onclose?: (e: CustomEvent<never>) => void;
+  "onskf-dialog-closed"?: (e: CustomEvent<CustomEvent>) => void;
 };
 
 type SkfDividerProps = {
@@ -203,22 +302,47 @@ type SkfDividerProps = {
   vertical?: SkfDivider["vertical"];
 };
 
-type SkfHeadingProps = {
-  /** Controls which heading element will be rendered. Should not be used to affect appearance */
-  as?: SkfHeading["as"];
-  /** If provided, changes the appearance of the heading */
-  "styled-as"?: SkfHeading["styledAs"];
+type SkfDrawerProps = {
+  /** If defined, sets the aria-label for the close button */
+  "close-button-aria-label"?: SkfDrawer["closeButtonAriaLabel"];
+  /** Heading for the Drawer */
+  heading?: SkfDrawer["heading"];
+  /** Sets the max-width */
+  size?: SkfDrawer["size"];
+  /** If true, Drawer is open */
+  open?: SkfDrawer["open"];
+  /** Placement of the Drawer */
+  placement?: SkfDrawer["placement"];
+
+  /** Fires when the drawer is opened (after transitioned in) */
+  "onskf-drawer-opened"?: (e: CustomEvent<CustomEvent>) => void;
+  /** Fires when the drawer is closing (before transitioned out) */
+  "onskf-drawer-closing"?: (e: CustomEvent<CustomEvent>) => void;
+  /** Fires when the drawer is closed (after transitioned out) */
+  "onskf-drawer-closed"?: (e: CustomEvent<CustomEvent>) => void;
 };
 
-type SkfIconProps = {
-  /** Sets the color of the icon */
-  color?: SkfIcon["color"];
-  /** If defined, adds an alternate description to use for assistive devices */
-  label?: SkfIcon["label"];
-  /** Name of the icon to display */
-  name?: SkfIcon["name"];
-  /** Size of the icon */
-  size?: SkfIcon["size"];
+type SkfLogoProps = {
+  /** Defines the title of the logo */
+  title?: SkfLogo["title"];
+  /** Defines the color of the logo */
+  color?: SkfLogo["color"];
+};
+
+type SkfNavProps = {
+  /**  */
+  vertical?: SkfNav["vertical"];
+};
+
+type SkfHeaderProps = {
+  /** If true, sets header to display in compact mode only (hanburger menu and drawer) */
+  compact?: SkfHeader["compact"];
+  /** If defined, sets the aria-label for the hamburger button */
+  "hamburger-aria-label"?: SkfHeader["hamburgerAriaLabel"];
+  /** If defined, sets the app or site's name */
+  "site-name"?: SkfHeader["siteName"];
+  /** If defined, sets the site's base-url for the "logo-link" */
+  "site-url"?: SkfHeader["siteUrl"];
 };
 
 type SkfInputProps = {
@@ -226,7 +350,8 @@ type SkfInputProps = {
   disabled?: SkfInput["undefined"];
   /** If true, value is required or must be checked for the form to be submittable */
   required?: SkfInput["undefined"];
-  /** -m  } */
+  /** Indicates whether the value of the control can be automatically completed by the browser. See
+[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/autocomplete) for details. */
   autocomplete?: SkfInput["autocomplete"];
   /** Custom aria-label for the clear button. **Notice!** Only applicable to type=search. */
   "button-aria-label-clear"?: SkfInput["buttonAriaLabelClear"];
@@ -242,7 +367,8 @@ type SkfInputProps = {
   "hide-label"?: SkfInput["hideLabel"];
   /** If defined, displays informational text below the field */
   hint?: SkfInput["hint"];
-  /** Tells what keyboard to use if applicable */
+  /** Provides a hint about the type of data that might be entered by the user while editing the element or its contents. See
+[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inputMode) for details. */
   inputmode?: SkfInput["inputmode"];
   /** If defined, sets the input's label. Alternatively, you can use the `label` attribute. */
   label?: SkfInput["label"];
@@ -274,7 +400,7 @@ type SkfInputProps = {
   size?: SkfInput["size"];
   /** If defined, displays a suffix/adornment after the input-element */
   trailing?: SkfInput["trailing"];
-  /** Type of input control */
+  /** Type of input */
   type?: SkfInput["type"];
   /** Sets validation start */
   "validate-on"?: SkfInput["validateOn"];
@@ -282,9 +408,9 @@ type SkfInputProps = {
   value?: SkfInput["value"];
 
   /** Fires when the value of the input changes */
-  onchange?: (e: CustomEvent<never>) => void;
+  onchange?: (e: CustomEvent<CustomEvent>) => void;
   /** Fires when the input is invalid */
-  oninvalid?: (e: CustomEvent<never>) => void;
+  oninvalid?: (e: CustomEvent<CustomEvent>) => void;
 };
 
 type SkfLinkProps = {
@@ -312,43 +438,10 @@ type SkfLinkProps = {
   target?: SkfLink["target"];
   /** Defines the type of button */
   type?: SkfLink["type"];
-  /** If provided, custom function triggered by click where the second return parameter enables custom routing. */
+  /** If defined, accepts a function that runs on click. Forwards optional route as second argument. */
   onClick?: SkfLink["onClick"];
 };
 
-type SkfLoaderProps = {
-  /** Defines the aria-label */
-  "aria-label"?: SkfLoader["ariaLabel"];
-  /** If true, inverts the color (to be used on colored backgrounds) */
-  invert?: SkfLoader["invert"];
-  /** Defines the size of the loader */
-  size?: SkfLoader["size"];
-  /**  */
-  role?: SkfLoader["role"];
-  /**  */
-  ariaLive?: SkfLoader["ariaLive"];
-};
-
-type SkfLogoProps = {
-  /** Defines the title of the logo */
-  title?: SkfLogo["title"];
-  /** Defines the color of the logo */
-  color?: SkfLogo["color"];
-};
-
-type SkfMenuProps = {
-  /** The placement of the menu */
-  placement?: SkfMenu["placement"];
-  /** Whether the menu is open */
-  isOpen?: SkfMenu["isOpen"];
-  /** The id of the element the menu will be anchored to */
-  anchor?: SkfMenu["anchor"];
-  /** Fired when the menu is opened */
-  onopen?: (e: CustomEvent<never>) => void;
-  /** Fired when the menu is closed */
-  onclose?: (e: CustomEvent<never>) => void;
-};
-
 type SkfMenuItemProps = {
   /** Defines the semantic element to render */
   as?: SkfMenuItem["as"];
@@ -374,41 +467,45 @@ type SkfMenuItemProps = {
   target?: SkfMenuItem["target"];
   /** Defines the type of button */
   type?: SkfMenuItem["type"];
-  /** If provided, custom function triggered by click where the second return parameter enables custom routing. */
+  /**  */
+  role?: SkfMenuItem["role"];
+  /** If defined, accepts a function that runs on click. Forwards optional route as second argument. */
   onClick?: SkfMenuItem["onClick"];
-  /** Fired when something happens */
-  "onmy-tag-my-event"?: (e: CustomEvent<CustomEvent>) => void;
-  /** Fired when the component is clicked */
-  onclick?: (e: CustomEvent<never>) => void;
-  /** Fired when the mouse is over the component */
-  onmouseover?: (e: CustomEvent<never>) => void;
-  /** Fired when the mouse is out of the component */
-  onmouseout?: (e: CustomEvent<never>) => void;
-  /** Fired when the component is focused */
-  onfocus?: (e: CustomEvent<never>) => void;
-  /** Fired when the component is blurred */
-  onblur?: (e: CustomEvent<never>) => void;
-  /** Fired when the component's value changes */
-  onchange?: (e: CustomEvent<never>) => void;
+};
+
+type SkfMenuProps = {
+  /** The placement of the menu */
+  placement?: SkfMenu["undefined"];
+  /** The id of the element the menu will be anchored to */
+  anchor?: SkfMenu["undefined"];
+
+  /** Fired when the menu is opened */
+  "onskf-opened"?: (e: CustomEvent<CustomEvent>) => void;
+  /** Fired when the menu is closed */
+  "onskf-closed"?: (e: CustomEvent<CustomEvent>) => void;
+};
+
+type SkfNavItemProps = {
+  /**  */
+  href?: SkfNavItem["href"];
+  /**  */
+  icon?: SkfNavItem["icon"];
 };
 
 type SkfPopoverProps = {
+  /** The placement of the popover */
+  placement?: SkfPopover["undefined"];
+  /** The id of the element the menu will be anchored to */
+  anchor?: SkfPopover["undefined"];
   /** If defined, sets a custom offset for the popover */
   offset?: SkfPopover["offset"];
   /** If true, hides the arrow */
   hideArrow?: SkfPopover["hideArrow"];
-  /**  */
-  arrow?: SkfPopover["arrow"];
-  /** The placement of the menu */
-  placement?: SkfPopover["placement"];
-  /** Whether the menu is open */
-  isOpen?: SkfPopover["isOpen"];
-  /** The id of the element the menu will be anchored to */
-  anchor?: SkfPopover["anchor"];
+
   /** Fired when the menu is opened */
-  onopen?: (e: CustomEvent<never>) => void;
+  "onskf-opened"?: (e: CustomEvent<CustomEvent>) => void;
   /** Fired when the menu is closed */
-  onclose?: (e: CustomEvent<never>) => void;
+  "onskf-closed"?: (e: CustomEvent<CustomEvent>) => void;
 };
 
 type SkfProgressProps = {
@@ -446,13 +543,52 @@ type SkfRadioProps = {
   /** The current value of the input field */
   value?: SkfRadio["value"];
 
-  /** {object} - When the value of the input changes */
-  onchange?: (e: CustomEvent<never>) => void;
+  /** When the value of the input changes */
+  onchange?: (e: CustomEvent<Event>) => void;
+};
+
+type SkfSegmentedButtonItemProps = {
+  /** If true, items is marked as disabled */
+  disabled?: SkfSegmentedButtonItem["disabled"];
+  /** If true, items is marked as selected */
+  selected?: SkfSegmentedButtonItem["selected"];
+  /** Sets the item value */
+  value?: SkfSegmentedButtonItem["value"];
+
+  /** Fired when selected */
+  "onskf-segmented-button-item-select"?: (e: CustomEvent<CustomEvent>) => void;
+};
+
+type SkfSegmentedButtonProps = {
+  /** If true, allowes multiple items to be selected */
+  multiple?: SkfSegmentedButton["multiple"];
+};
+
+type SkfSelectOptionGroupProps = {
+  /**  */
+  label?: SkfSelectOptionGroup["label"];
+};
+
+type SkfTagProps = {
+  /** Specifies Tag size */
+  size?: SkfTag["size"];
+  /** If defined, displays leading/provided icon */
+  icon?: SkfTag["icon"];
+  /** If defined, gives the supplied appearance */
+  color?: SkfTag["color"];
+  /** If true, adds trailing button to remove tag */
+  removable?: SkfTag["removable"];
+  /** If defined, accepts a function that runs on click */
+  onClick?: SkfTag["onClick"];
+  /** If defined, accepts a function that runs on click. Self removal can be overridden by using `event.stopPropagation()`. */
+  onRemove?: SkfTag["onRemove"];
 };
 
 type SkfSelectProps = {
-  /** If true, the select is disabled	`default: false` */
+  /** If true, the select is disabled */
   disabled?: SkfSelect["undefined"];
+  /** If true, the select is required */
+  required?: SkfSelect["undefined"];
   /** Sets the first visible text on the component */
   "button-label"?: SkfSelect["buttonLabel"];
   /** If defined, forces component to invalid state until removed */
@@ -490,15 +626,15 @@ type SkfSelectProps = {
   /**  */
   _selectedOptions?: SkfSelect["_selectedOptions"];
   /** Fired when the selected option(s) changes */
-  onchange?: (e: CustomEvent<never>) => void;
+  onchange?: (e: CustomEvent<Event>) => void;
   /** Fired when the select is invalid */
-  oninvalid?: (e: CustomEvent<never>) => void;
+  oninvalid?: (e: CustomEvent<Event>) => void;
   /** Fired when the form is reset */
-  onreset?: (e: CustomEvent<never>) => void;
+  onreset?: (e: CustomEvent<Event>) => void;
   /** {detail: {expanded: boolean}} Fired when the select dropdown is toggled */
-  "onskf-select:dropdown"?: (e: CustomEvent<never>) => void;
+  "onskf-select-dropdown"?: (e: CustomEvent<CustomEvent>) => void;
   /** {detail: {value: string | null, option: SkfSelectOption}} Fired when the select dropdown is toggled */
-  "onskf-select-option:select"?: (e: CustomEvent<never>) => void;
+  "onskf-select-option-select"?: (e: CustomEvent<CustomEvent>) => void;
 };
 
 type SkfSelectOptionProps = {
@@ -523,22 +659,7 @@ type SkfSelectOptionProps = {
   /**  */
   _shortcutUpdate?: SkfSelectOption["_shortcutUpdate"];
   /** {detail: { value: string | null, option: SkfSelectOption }} Fires when the option is selected/deselected. */
-  "onskf-select-option:select"?: (e: CustomEvent<never>) => void;
-};
-
-type SkfSelectOptionGroupProps = {
-  /**  */
-  label?: SkfSelectOptionGroup["label"];
-};
-
-type SkfStepperProps = {
-  /** Sets the active item */
-  activeIndex?: SkfStepper["activeIndex"];
-  /** If true, sets linear mode (user can't go back to completed steps due to dependencies) */
-  linear?: SkfStepper["linear"];
-
-  /** Dispatched when the stepper item is selected */
-  "onskf-stepper-item-select"?: (e: CustomEvent<never>) => void;
+  "onskf-select-option-select"?: (e: CustomEvent<never>) => void;
 };
 
 type SkfStepperItemProps = {
@@ -554,6 +675,16 @@ type SkfStepperItemProps = {
   "onskf-stepper-item-select"?: (e: CustomEvent<never>) => void;
 };
 
+type SkfStepperProps = {
+  /** Sets the active item */
+  "active-index"?: SkfStepper["activeIndex"];
+  /** If true, sets linear mode (user can't go back to completed steps due to dependencies) */
+  linear?: SkfStepper["linear"];
+
+  /** Dispatched when the stepper item is selected */
+  "onskf-stepper-item-select"?: (e: CustomEvent<CustomEvent>) => void;
+};
+
 type SkfSwitchProps = {
   /** If true, sets disabled state */
   disabled?: SkfSwitch["undefined"];
@@ -577,56 +708,41 @@ type SkfSwitchProps = {
   value?: SkfSwitch["value"];
 };
 
-type SkfTabProps = {
-  /** The name of the tab-panel this tab is associated with. The panel must be located in the same tab group. */
-  panel?: SkfTab["panel"];
-  /**  */
-  selected?: SkfTab["selected"];
+type SkfTabPanelProps = {
+  /** The tab panel's name. */
+  name?: SkfTabPanel["name"];
   /**  */
-  variant?: SkfTab["variant"];
+  active?: SkfTabPanel["active"];
   /**  */
-  role?: SkfTab["role"];
-  /** {detail: { selected: true, tab: SkfTab }} Fires when the tab is selected */
-  "onskf-tab-select"?: (e: CustomEvent<CustomEvent>) => void;
-  /** Fired when the component is clicked */
-  onclick?: (e: CustomEvent<never>) => void;
+  role?: SkfTabPanel["role"];
 };
 
-type SkfTabGroupProps = {
+type SkfTabsProps = {
   /** Sets the default selected tab */
-  "default-selected"?: SkfTabGroup["defaultSelected"];
+  "default-selected"?: SkfTabs["defaultSelected"];
   /** If true, removes border */
-  "no-border"?: SkfTabGroup["noBorder"];
+  "no-border"?: SkfTabs["noBorder"];
   /** If true, removes padding */
-  "no-padding"?: SkfTabGroup["noPadding"];
+  "no-padding"?: SkfTabs["noPadding"];
   /** If true, component fills the parent element height */
-  stretch?: SkfTabGroup["stretch"];
+  stretch?: SkfTabs["stretch"];
   /** Sets the appearance of the tabs */
-  variant?: SkfTabGroup["variant"];
+  variant?: SkfTabs["variant"];
 };
 
-type SkfTabPanelProps = {
-  /** The tab panel's name. */
-  name?: SkfTabPanel["name"];
+type SkfTabProps = {
+  /** The name of the tab-panel this tab is associated with. The panel must be located in the same tab group. */
+  panel?: SkfTab["panel"];
   /**  */
-  active?: SkfTabPanel["active"];
+  selected?: SkfTab["selected"];
   /**  */
-  role?: SkfTabPanel["role"];
-};
-
-type SkfTagProps = {
-  /** Specifies Tag size */
-  size?: SkfTag["size"];
-  /** If defined, displays leading/provided icon */
-  icon?: SkfTag["icon"];
-  /** If defined, gives the supplied appearance */
-  color?: SkfTag["color"];
-  /** If true, adds trailing button to remove tag */
-  removable?: SkfTag["removable"];
-  /** If defined, accepts a function that runs on click */
-  onClick?: SkfTag["onClick"];
-  /** If defined, accepts a function that runs on click. Self removal can be overridden by using `event.stopPropagation()`. */
-  onRemove?: SkfTag["onRemove"];
+  variant?: SkfTab["variant"];
+  /**  */
+  role?: SkfTab["role"];
+  /** {detail: { selected: true, tab: SkfTab }} Fires when the tab is selected */
+  "onskf-tab-select"?: (e: CustomEvent<CustomEvent>) => void;
+  /** Fired when the component is clicked */
+  onclick?: (e: CustomEvent<never>) => void;
 };
 
 type SkfTextAreaProps = {
@@ -677,12 +793,19 @@ type SkfTextAreaProps = {
   oninvalid?: (e: CustomEvent<never>) => void;
 };
 
+type SkfToastWrapperProps = {
+  /**  */
+  debug?: SkfToastWrapper["debug"];
+};
+
 type SkfToastProps = {
-  /** If provided, adds a close button to the toast and will not disapear until user actively dismisses it. */
-  closeable?: SkfToast["closeable"];
   /**  */
   debug?: SkfToast["debug"];
-  /** Severity of the toast. */
+  /** If defined, displays leading icon */
+  icon?: SkfToast["icon"];
+  /** If true, renders with an close button and sets aria-role to `status` */
+  persistent?: SkfToast["persistent"];
+  /** If defined, gives the supplied appearance */
   severity?: SkfToast["severity"];
   /** Time in seconds before the toast disappears. */
   timer?: SkfToast["timer"];
@@ -690,31 +813,54 @@ type SkfToastProps = {
   topOffset?: SkfToast["topOffset"];
 };
 
-type SkfToastWrapperProps = {
-  /**  */
-  debug?: SkfToastWrapper["debug"];
-};
-
 type SkfTooltipProps = {
+  /** The placement of the dropdown */
+  placement?: SkfTooltip["undefined"];
+  /** The id of the element the dropdown will be anchored to */
+  anchor?: SkfTooltip["undefined"];
+  /**  */
+  role?: SkfTooltip["role"];
   /**  */
   offset?: SkfTooltip["offset"];
-  /** The placement of the dropdown */
+  /**  */
   placement?: SkfTooltip["placement"];
-  /** Whether the dropdown is open */
-  isOpen?: SkfTooltip["isOpen"];
-  /** The id of the element the dropdown will be anchored to */
-  anchor?: SkfTooltip["anchor"];
+  /**  */
+  variant?: SkfTooltip["variant"];
   /** Fired when the dropdown is opened */
-  onopen?: (e: CustomEvent<never>) => void;
+  "onskf-opened"?: (e: CustomEvent<never>) => void;
   /** Fired when the dropdown is closed */
-  onclose?: (e: CustomEvent<never>) => void;
+  "onskf-closed"?: (e: CustomEvent<never>) => void;
 };
 
 export type CustomElements = {
   /**
-   * The `<skf-accordion>` component consists of multiple `<skf-collapse>`, working together.
+   * The `<skf-icon>` component is used to clarify interface elements. When used, should always be paired with (possibly invisible) text.
+   * ---
+   *
+   */
+  "skf-icon": DefineComponent<SkfIconProps>;
+
+  /**
+   * The `<skf-accordion-item>` is used in conjunction with the `<skf-accordion>` component
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **skf-accordion-item-toggle** - Event emitted when toggled
+   *
+   * ### **Methods:**
+   *  - **setClose()** - Class method as alternative to manipulate attribute
+   * - **setOpen()** - Class method as alternative to manipulate attribute
+   *
+   * ### **Slots:**
+   *  - _default_ - Main content
+   */
+  "skf-accordion-item": DefineComponent<SkfAccordionItemProps>;
+
+  /**
+   * The `<skf-accordion>` component consists of one or more `<skf-accordion-item>` item(s) working together
    *
-   * See [zeroheight](https://zeroheight.com/853e936c9/p/6590bf-accordion) for design principles.
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/6590bf-accordion) for design principles
    * ---
    *
    *
@@ -725,6 +871,8 @@ export type CustomElements = {
 
   /**
    * The `<skf-alert>` is a type of notification that appears in-line
+   *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/990ec5-alert) for design principles
    * ---
    *
    *
@@ -737,8 +885,20 @@ export type CustomElements = {
    */
   "skf-alert": DefineComponent<SkfAlertProps>;
 
+  /**
+   * The `<skf-breadcrumb-item>` is used in conjunction with the `<skf-breadcrumb>` component
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - Label of the breadcrumb item
+   */
+  "skf-breadcrumb-item": DefineComponent<SkfBreadcrumbItemProps>;
+
   /**
    * The `<skf-breadcrumb>` component consists of multiple `<skf-breadcrumb-item>`, working together.
+   *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/3338ef-breadcrumbs) for design principles.
    * ---
    *
    *
@@ -751,17 +911,16 @@ export type CustomElements = {
   "skf-breadcrumb": DefineComponent<SkfBreadcrumbProps>;
 
   /**
-   * The `<skf-breadcrumb-item>` is used in conjunction with the `<skf-breadcrumb>` component
+   * The `<skf-loader>` component is a progress indicator that uses circular indicators for short, indeterminate activities
    * ---
    *
-   *
-   * ### **Slots:**
-   *  - _default_ - Label of the breadcrumb item
    */
-  "skf-breadcrumb-item": DefineComponent<SkfBreadcrumbItemProps>;
+  "skf-loader": DefineComponent<SkfLoaderProps>;
 
   /**
    * Component to be used in forms or for interactivity
+   *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/02493d-buttons) for design principles
    * ---
    *
    *
@@ -778,6 +937,8 @@ export type CustomElements = {
 
   /**
    * The `<skf-card>` can be used to group related subjects in a container
+   *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/021eed-card) for design principles
    * ---
    *
    *
@@ -792,7 +953,7 @@ export type CustomElements = {
    *
    *
    * ### **Events:**
-   *  - **change** - {object} - When the value of the input changes
+   *  - **change** - When the value of the input changes
    *
    * ### **Slots:**
    *  - _default_ - The Radios label. Alternatively, you can use the `label` attribute.
@@ -800,33 +961,46 @@ export type CustomElements = {
   "skf-checkbox": DefineComponent<SkfCheckboxProps>;
 
   /**
-   * The `<skf-collapse>` component is a general purpose container for content that can be collapsed / expanded.
    *
-   * See [zeroheight](https://zeroheight.com/853e936c9/p/6590bf-accordion) for design principles.
    * ---
    *
+   */
+  "skf-datepicker-calendar": DefineComponent<SkfDatepickerCalendarProps>;
+
+  /**
+   *
+   * ---
    *
-   * ### **Events:**
-   *  - **skf-collapse-toggle** - Event emitted when toggled
    *
    * ### **Methods:**
-   *  - **setClose()** - Class method as alternative to manipulate attribute
-   * - **setOpen()** - Class method as alternative to manipulate attribute
+   *  - **clear()** - Clears the input field
+   */
+  "skf-datepicker": DefineComponent<SkfDatepickerProps>;
+
+  /**
+   * The `<Heading>` component is to deliniate content on a page. When using, take note not to skip heading levels.<br>
+   * It extends the interface of native html `<h1>` to `<h4>` elements.
+   * ---
+   *
    *
    * ### **Slots:**
-   *  - _default_ - Main content
+   *  - _default_ - The headings content
    */
-  "skf-collapse": DefineComponent<SkfCollapseProps>;
+  "skf-heading": DefineComponent<SkfHeadingProps>;
 
   /**
-   * The `<skf-dialog>` is a component that open up a dialog with the content provided
+   * The `<skf-dialog>` is a component that open up a dialog of type modal with the content provided. (MDN refrains from opening the dialog using the `open` attribute, however skf-dialog does not have that limitation)
    * ---
    *
    *
    * ### **Events:**
-   *  - **skf-dialog-open** - Fires when the dialog is opened (after transitioned in)
-   * - **skf-dialog-close** - Fires when the dialog is closed (before transitioned out)
-   * - **close** - Fires when the dialog is closed (after transitioned out)
+   *  - **skf-dialog-opened** - Fires when the dialog is opened (after transitioned in)
+   * - **skf-dialog-closing** - Fires when the dialog is closing (before transitioned out)
+   * - **skf-dialog-closed** - Fires when the dialog is closed (after transitioned out)
+   *
+   * ### **Methods:**
+   *  - **showModal()** - Method that opens the dialog in modal state
+   * - **close()** - Method that closes the dialog
    *
    * ### **Slots:**
    *  - _default_ - The dialog component's content
@@ -850,25 +1024,54 @@ export type CustomElements = {
   "skf-divider": DefineComponent<SkfDividerProps>;
 
   /**
-   * The `<Heading>` component is to deliniate content on a page. When using, take note not to skip heading levels.<br>
-   * It extends the interface of native html `<h1>` to `<h4>` elements.
+   * The `<skf-drawer>` is a modal component that displays content and toggle by sliding from left/right viewport edge
    * ---
    *
    *
+   * ### **Events:**
+   *  - **skf-drawer-opened** - Fires when the drawer is opened (after transitioned in)
+   * - **skf-drawer-closing** - Fires when the drawer is closing (before transitioned out)
+   * - **skf-drawer-closed** - Fires when the drawer is closed (after transitioned out)
+   *
    * ### **Slots:**
-   *  - _default_ - The headings content
+   *  - _default_ - The Drawer's main content
    */
-  "skf-heading": DefineComponent<SkfHeadingProps>;
+  "skf-drawer": DefineComponent<SkfDrawerProps>;
 
   /**
-   * The `<skf-icon>` component is used to clarify interface elements. When used, should always be paired with (possibly invisible) text
+   * The `<skf-logo>` component is used to display the SKF logo.
    * ---
    *
+   *
+   * ### **CSS Properties:**
+   *  - **--mod-logo-height** - The height of the logo _(default: undefined)_
    */
-  "skf-icon": DefineComponent<SkfIconProps>;
+  "skf-logo": DefineComponent<SkfLogoProps>;
+
+  /**
+   * The `<skf-nav>` is a component that displays a list of <nav-items>.
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - The component's main content
+   */
+  "skf-nav": DefineComponent<SkfNavProps>;
+
+  /**
+   * The `<skf-header>` component is to be used as the site-header in the app. The navigation will be collapsed to mobile-view if the menu items exceed the available width.
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - Navigation items
+   */
+  "skf-header": DefineComponent<SkfHeaderProps>;
 
   /**
-   * The skf-text-field is used to create a text input field. It can be used inside a form element or standalone.
+   * The skf-text-field is used to create a text input field. It can be used inside a form element or standalone
+   *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/9481fa-input-field) for design principles
    * ---
    *
    *
@@ -892,30 +1095,25 @@ export type CustomElements = {
   "skf-link": DefineComponent<SkfLinkProps>;
 
   /**
-   * The `<skf-loader>` component is a progress indicator that uses circular indicators for short, indeterminate activities
-   * ---
-   *
-   */
-  "skf-loader": DefineComponent<SkfLoaderProps>;
-
-  /**
-   * The `<skf-logo>` component is used to display the SKF logo.
+   * The `<skf-menu-item>` is used in conjunction with the `<skf-menu>` component
    * ---
    *
    *
-   * ### **CSS Properties:**
-   *  - **--skf-logo-height** - The height of the logo _(default: undefined)_
+   * ### **Slots:**
+   *  - _default_ - The component's main content
    */
-  "skf-logo": DefineComponent<SkfLogoProps>;
+  "skf-menu-item": DefineComponent<SkfMenuItemProps>;
 
   /**
-   * The `<skf-menu>` is a component that displays a list of actions or options.
+   * The `<skf-menu>` is a component that displays a list of actions or options
+   *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/983e5d-popover) for design principles
    * ---
    *
    *
    * ### **Events:**
-   *  - **open** - Fired when the menu is opened
-   * - **close** - Fired when the menu is closed
+   *  - **skf-opened** - Fired when the menu is opened
+   * - **skf-closed** - Fired when the menu is closed
    *
    * ### **Slots:**
    *  - _default_ - The menu popover content
@@ -923,33 +1121,25 @@ export type CustomElements = {
   "skf-menu": DefineComponent<SkfMenuProps>;
 
   /**
-   * The `<skf-menu-item>` is a component that displays a list of actions or options.
+   * The `<skf-nav>` is a component that displays a list of <nav-items>.
    * ---
    *
    *
-   * ### **Events:**
-   *  - **my-tag-my-event** - Fired when something happens
-   * - **click** - Fired when the component is clicked
-   * - **mouseover** - Fired when the mouse is over the component
-   * - **mouseout** - Fired when the mouse is out of the component
-   * - **focus** - Fired when the component is focused
-   * - **blur** - Fired when the component is blurred
-   * - **change** - Fired when the component's value changes
-   *
    * ### **Slots:**
    *  - _default_ - The component's main content
-   * - **my-named-slot** - A named slot of the component
    */
-  "skf-menu-item": DefineComponent<SkfMenuItemProps>;
+  "skf-nav-item": DefineComponent<SkfNavItemProps>;
 
   /**
-   * The `<skf-popover>` is a general purpose component that displays the slot content.
+   * The `<skf-popover>` is a general purpose component that displays the slot content in a popover.
+   *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/983e5d-popover) for design principles
    * ---
    *
    *
    * ### **Events:**
-   *  - **open** - Fired when the menu is opened
-   * - **close** - Fired when the menu is closed
+   *  - **skf-opened** - Fired when the menu is opened
+   * - **skf-closed** - Fired when the menu is closed
    *
    * ### **Slots:**
    *  - _default_ - The popover content
@@ -965,11 +1155,13 @@ export type CustomElements = {
 
   /**
    * The `<skf-radio>` component is used to create a radio input
+   *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/78d5dd-radio-button) for design principles
    * ---
    *
    *
    * ### **Events:**
-   *  - **change** - {object} - When the value of the input changes
+   *  - **change** - When the value of the input changes
    *
    * ### **Slots:**
    *  - _default_ - The radios label. Alternatively, you can use the `label` attribute.
@@ -977,35 +1169,29 @@ export type CustomElements = {
   "skf-radio": DefineComponent<SkfRadioProps>;
 
   /**
-   * The `<skf-select>` is a component that displays a list of actions or options. A click in the options list toggle the selected state of the option. Use it together with the ´skf-select-option` tag.
+   * The `<skf-segmented-button-item>` is used in conjunction with the `<skf-segmented-button>` component
    * ---
    *
    *
    * ### **Events:**
-   *  - **change** - Fired when the selected option(s) changes
-   * - **invalid** - Fired when the select is invalid
-   * - **reset** - Fired when the form is reset
-   * - **skf-select:dropdown** - {detail: {expanded: boolean}} Fired when the select dropdown is toggled
-   * - **skf-select-option:select** - {detail: {value: string | null, option: SkfSelectOption}} Fired when the select dropdown is toggled
+   *  - **skf-segmented-button-item-select** - Fired when selected
    *
    * ### **Slots:**
-   *  - _default_ - The select's placeholder content
+   *  - _default_ - Label for the button
    */
-  "skf-select": DefineComponent<SkfSelectProps>;
+  "skf-segmented-button-item": DefineComponent<SkfSegmentedButtonItemProps>;
 
   /**
-   * The `<skf-select-option>` is a component is used nested in a skf-select or skf-select-option-group.
-   * ---
+   * The `<skf-segmented-button>` component consists of multiple `<skf-segmented-button-item>`, working together.
    *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/68ff54-segmented-buttons) for design principles
+   * ---
    *
-   * ### **Events:**
-   *  - **skf-select-option:select** - {detail: { value: string | null, option: SkfSelectOption }} Fires when the option is selected/deselected.
    *
    * ### **Slots:**
-   *  - _default_ - The option's text content
-   * - **icon** - The option's slot for icon or custom meta information (svg).
+   *  - _default_ - One or more `<skf-segmented-button-item>`
    */
-  "skf-select-option": DefineComponent<SkfSelectOptionProps>;
+  "skf-segmented-button": DefineComponent<SkfSegmentedButtonProps>;
 
   /**
    * The `<skf-select-option-group>` is a component that groups select-options
@@ -1018,65 +1204,85 @@ export type CustomElements = {
   "skf-select-option-group": DefineComponent<SkfSelectOptionGroupProps>;
 
   /**
-   * The `<skf-stepper>` is a component that displays a list of actions or options.
+   * The `<skf-tag>` is a component that displays a list of actions or options
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - The component's placeholder content
+   */
+  "skf-tag": DefineComponent<SkfTagProps>;
+
+  /**
+   * The `<skf-select>` is a component that displays a list of actions or options. A click in the options list toggle the selected state of the option. Use it together with the ´skf-select-option` tag.
+   *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/91c9f0-select-and-combobox) for design principles
    * ---
    *
    *
    * ### **Events:**
-   *  - **skf-stepper-item-select** - Dispatched when the stepper item is selected
+   *  - **change** - Fired when the selected option(s) changes
+   * - **invalid** - Fired when the select is invalid
+   * - **reset** - Fired when the form is reset
+   * - **skf-select-dropdown** - {detail: {expanded: boolean}} Fired when the select dropdown is toggled
+   * - **skf-select-option-select** - {detail: {value: string | null, option: SkfSelectOption}} Fired when the select dropdown is toggled
    *
    * ### **Slots:**
-   *  - _default_ - One or more `<skf-stepper-item>`
+   *  - _default_ - The select's placeholder content
    */
-  "skf-stepper": DefineComponent<SkfStepperProps>;
+  "skf-select": DefineComponent<SkfSelectProps>;
 
   /**
-   * The `<skf-stepper-item>` is used in conjunction with the `<skf-stepper>` component
+   * The `<skf-select-option>` is a component is used nested in a skf-select or skf-select-option-group.
    * ---
    *
    *
    * ### **Events:**
-   *  - **skf-stepper-item-select** - Dispatched when the stepper item is selected
+   *  - **skf-select-option-select** - {detail: { value: string | null, option: SkfSelectOption }} Fires when the option is selected/deselected.
    *
    * ### **Slots:**
-   *  - _default_ - Label of the stepper item
+   *  - _default_ - The option's text content
+   * - **icon** - The option's slot for icon or custom meta information (svg).
    */
-  "skf-stepper-item": DefineComponent<SkfStepperItemProps>;
+  "skf-select-option": DefineComponent<SkfSelectOptionProps>;
 
   /**
-   * The `<skf-switch>` is a component that displays a list of actions or options
+   * The `<skf-stepper-item>` is used in conjunction with the `<skf-stepper>` component
    * ---
    *
    *
+   * ### **Events:**
+   *  - **skf-stepper-item-select** - Dispatched when the stepper item is selected
+   *
    * ### **Slots:**
-   *  - _default_ - The Switchs label. Alternatively, you can use the `label` attribute.
+   *  - _default_ - Label of the stepper item
    */
-  "skf-switch": DefineComponent<SkfSwitchProps>;
+  "skf-stepper-item": DefineComponent<SkfStepperItemProps>;
 
   /**
-   * The `<skf-tab>` is a component that displays a list of actions or options
+   * The `<skf-stepper>` is a component that displays a list of actions or options.
    * ---
    *
    *
    * ### **Events:**
-   *  - **skf-tab-select** - {detail: { selected: true, tab: SkfTab }} Fires when the tab is selected
-   * - **click** - Fired when the component is clicked
+   *  - **skf-stepper-item-select** - Dispatched when the stepper item is selected
    *
    * ### **Slots:**
-   *  - _default_ - The tab's label
+   *  - _default_ - One or more `<skf-stepper-item>`
    */
-  "skf-tab": DefineComponent<SkfTabProps>;
+  "skf-stepper": DefineComponent<SkfStepperProps>;
 
   /**
-   * The `<skf-tab-group>` is a component that displays a list of actions or options.
+   * The `<skf-switch>` is a component that displays a list of actions or options
+   *
+   * See [zeroheight](https://zeroheight.com/853e936c9/p/7282a2-switch) for design principle
    * ---
    *
    *
    * ### **Slots:**
-   *  - _default_ - Used for grouping tab panels in the tab group. Must be <skf-tab-panel> elements
-   * - **tabs** - Used for grouping tabs in the tab group. Must be <skf-tab> elements
+   *  - _default_ - The Switchs label. Alternatively, you can use the `label` attribute.
    */
-  "skf-tab-group": DefineComponent<SkfTabGroupProps>;
+  "skf-switch": DefineComponent<SkfSwitchProps>;
 
   /**
    * The `<skf-tab-panel>` is a component that displays a list of actions or options.
@@ -1089,14 +1295,29 @@ export type CustomElements = {
   "skf-tab-panel": DefineComponent<SkfTabPanelProps>;
 
   /**
-   * The `<skf-tag>` is a component that displays a list of actions or options
+   * The `<skf-tabs>` is a component that displays a list of actions or options
    * ---
    *
    *
    * ### **Slots:**
-   *  - _default_ - The component's placeholder content
+   *  - _default_ - Used for grouping tab panels in the tab group. Must be <skf-tab-panel> elements
+   * - **tabs** - Used for grouping tabs in the tab group. Must be <skf-tab> elements
    */
-  "skf-tag": DefineComponent<SkfTagProps>;
+  "skf-tabs": DefineComponent<SkfTabsProps>;
+
+  /**
+   * The `<skf-tab>` is a component that displays a list of actions or options
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **skf-tab-select** - {detail: { selected: true, tab: SkfTab }} Fires when the tab is selected
+   * - **click** - Fired when the component is clicked
+   *
+   * ### **Slots:**
+   *  - _default_ - The tab's label
+   */
+  "skf-tab": DefineComponent<SkfTabProps>;
 
   /**
    * The skf-textarea is used to create a textarea. Use it inside a form element or wherever you like.
@@ -1113,33 +1334,33 @@ export type CustomElements = {
   "skf-textarea": DefineComponent<SkfTextAreaProps>;
 
   /**
-   * A simple toast component that displays a message to the user. Use by appending a &lt;skf-toast&gt; tag to the DOM. Position in DOM is irrelevant.
+   * The `<skf-toast-wrapper>` is a component without UI that positions where the toast shows up on the screen. The toast-wrapper is used internally by the toast component.
    * ---
    *
    *
    * ### **Slots:**
-   *  - _default_ - The component's placeholder content
+   *  - _default_ - The alert components that the toast creates will render here.
    */
-  "skf-toast": DefineComponent<SkfToastProps>;
+  "skf-toast-wrapper": DefineComponent<SkfToastWrapperProps>;
 
   /**
-   * The `<skf-toast-wrapper>` is a component without UI that positions where the toast shows up on the screen. The toast-wrapper is used internally by the toast component.
+   * A simple toast component that displays a message to the user. Invoke a toast message by appending a &lt;skf-toast&gt; tag to the DOM. Position in DOM is irrelevant. A transient toast will disappear after a set amount of time. Once toast is dismissed it will be removed from the DOM.
    * ---
    *
    *
    * ### **Slots:**
-   *  - _default_ - The alert components that the toast creates will render here.
+   *  - _default_ - The component's placeholder content
    */
-  "skf-toast-wrapper": DefineComponent<SkfToastWrapperProps>;
+  "skf-toast": DefineComponent<SkfToastProps>;
 
   /**
-   * The `<skf-tooltip>` is a component that displays a list of actions or options.
+   * The `<skf-tooltip>` is a component that displays a tooltip.
    * ---
    *
    *
    * ### **Events:**
-   *  - **open** - Fired when the dropdown is opened
-   * - **close** - Fired when the dropdown is closed
+   *  - **skf-opened** - Fired when the dropdown is opened
+   * - **skf-closed** - Fired when the dropdown is closed
    *
    * ### **Slots:**
    *  - _default_ - The tooltip popover content