@ukic/web-components 2.1.0-beta.1 → 2.1.0-beta.3

package/dist/types/components.d.ts

@@ -9,6 +9,7 @@ import { IcAlertVariants } from "./components/ic-alert/ic-alert.types";
 import { IcButtonSizes, IcButtonTooltipPlacement, IcButtonTypes, IcButtonVariants } from "./components/ic-button/ic-button.types";
 import { IcActivationTypes, IcAdditionalFieldTypes, IcAlignment, IcAutocompleteTypes, IcAutocorrectStates, IcInformationStatusOrEmpty, IcMenuOption, IcSearchMatchPositions, IcTheme, IcThemeForeground, IcThemeForegroundNoDefault, IcTypographyVariants } from "./utils/types";
 import { IcChangeEventDetail } from "./components/ic-checkbox-group/ic-checkbox-group.types";
+import { IcChipAppearance, IcChipSizes } from "./components/ic-chip/ic-chip.types";
 import { IcProtectiveMarkings } from "./components/ic-classification-banner/ic-classification-banner.types";
 import { IcFooterBreakpoints } from "./components/ic-footer/ic-footer.types";
 import { IcHeroContentAlignments } from "./components/ic-hero/ic-hero.types";
@@ -19,7 +20,7 @@ import { IcAutocompleteTypes as IcAutocompleteTypes1, IcAutocorrectStates as IcA
 import { IcSearchBarBlurEventDetail } from "./components/ic-search-bar/ic-search-bar.types";
 import { IcSkeletonVariants } from "./components/ic-skeleton/ic-skeleton.types";
 import { IcStatusTagAppearance, IcStatusTagStatuses } from "./components/ic-status-tag/ic-status-tag.types";
-import { IcStepTypes } from "./components/ic-step/ic-step.types";
+import { IcStepStatuses, IcStepTypes, IcStepVariants } from "./components/ic-step/ic-step.types";
 import { IcStepperAlignment } from "./components/ic-stepper/ic-stepper.types";
 import { IcSwitchChangeEventDetail } from "./components/ic-switch/ic-switch.types";
 import { IcTabClickEventDetail, IcTabSelectEventDetail } from "./components/ic-tab/ic-tab.types";
@@ -28,27 +29,27 @@ import { IcTooltipPlacements } from "./components/ic-tooltip/ic-tooltip.types";
 export namespace Components {
     interface IcAlert {
         /**
-          * Set whether the alert has the 'alert' aria role and will be announced to screen readers
+          * If `true`, the alert will have the 'alert' ARIA role and will be announced to screen readers.
          */
         "announced"?: boolean;
         /**
-          * Set whether the alert has a close icon at the end to dismiss it
+          * If `true`, the alert will have a close icon at the end to dismiss it.
          */
         "dismissible"?: boolean;
         /**
-          * Optional title to display at the start of the alert
+          * The optional title to display at the start of the alert.
          */
         "heading"?: string;
         /**
-          * Main body message of the alert
+          * The main body message of the alert.
          */
         "message"?: string;
         /**
-          * Set whether the title and message appear inline or above and below
+          * If `true`, the title and message will appear inline instead of above and below.
          */
         "titleAbove"?: boolean;
         /**
-          * Set which variant of the alert will be rendered
+          * The variant of the alert which will be rendered.
          */
         "variant"?: IcAlertVariants;
     }
@@ -60,48 +61,48 @@ export namespace Components {
     }
     interface IcBreadcrumb {
         /**
-          * If true, aria-current will be set on the breadcrumb
+          * If `true`, aria-current will be set on the breadcrumb.
          */
         "current"?: boolean;
         /**
-          * Set breadcrumb location
+          * The URL that the breadcrumb link points to.
          */
         "href"?: string;
         /**
-          * Set breadcrumb title
+          * The title of the breadcrumb.
          */
         "pageTitle": string;
         "showBackIcon": boolean;
     }
     interface IcBreadcrumbGroup {
         /**
-          * If true, display the parent page and back icon as breadcrumb
+          * If `true`, display only a single breadcrumb for the parent page with a back icon.
          */
         "backBreadcrumbOnly": boolean;
         /**
-          * If true, all breadcrumbs between the first and last breadcrumb will be collapsed
+          * If `true`, all breadcrumbs between the first and last breadcrumb will be collapsed.
          */
         "collapsed": boolean;
     }
     interface IcButton {
         /**
-          * Determines the whether the appearance of the button is dark, light, or the default.
+          * The appearance of the button, e.g. dark, light, or the default.
          */
         "appearance"?: IcThemeForeground;
         /**
-          * Disable ic-tooltip which is shown for icon variant. Title or aria-label must be set if this prop is not applied.
+          * If `true`, the ic-tooltip which is shown for icon variant will be disabled. Title or aria-label must be set if this prop is not applied.
          */
         "disableTooltip"?: boolean;
         /**
-          * Determines whether the button should be in disabled state.
+          * If `true`, the button will be in disabled state.
          */
         "disabled"?: boolean;
         /**
-          * Prompts the user to save the linked URL instead of navigating to it.
+          * If `true`, the user can save the linked URL instead of navigating to it.
          */
         "download"?: string | boolean;
         /**
-          * Fill the width of the container if true.
+          * If `true`, the button will fill the width of the container.
          */
         "fullWidth"?: boolean;
         /**
@@ -109,11 +110,11 @@ export namespace Components {
          */
         "href"?: string;
         /**
-          * Hints at the human language of the linked URL.
+          * The human language of the linked URL.
          */
         "hreflang"?: string;
         /**
-          * Determines whether the button should be in loading state.
+          * If `true`, the button will be in loading state.
          */
         "loading"?: boolean;
         /**
@@ -133,7 +134,7 @@ export namespace Components {
          */
         "size"?: IcButtonSizes;
         /**
-          * Where to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
+          * The place to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
          */
         "target"?: string;
         /**
@@ -146,37 +147,37 @@ export namespace Components {
         "type"?: IcButtonTypes;
         "updateAriaLabel": (newValue: string) => Promise<void>;
         /**
-          * The button variant to be displayed.
+          * The variant of the button to be displayed.
          */
         "variant"?: IcButtonVariants;
     }
     interface IcCard {
         /**
-          * Set the variant to static or clickable
+          * If `true`, the card will be a clickable variant, instead of static.
          */
         "clickable"?: boolean;
         /**
-          * Whether the card is disabled if it is clickable
+          * If `true`, the card will be disabled if it is clickable.
          */
         "disabled"?: boolean;
         /**
-          * If true then fill width of container
+          * If `true`, the card will fill the width of the container.
          */
         "fullWidth": boolean;
         /**
-          * Title for the card
+          * The title for the card.
          */
         "heading": string;
         /**
-          * URL for clickable cards
+          * The URL that the clickable card link points to.
          */
         "href"?: string | undefined;
         /**
-          * Human readable explanation of the URL
+          * The human language of the linked URL.
          */
         "hreflang"?: string;
         /**
-          * Main body message of the card
+          * The main body message of the card.
          */
         "message"?: string;
         /**
@@ -188,129 +189,151 @@ export namespace Components {
          */
         "rel"?: string;
         /**
-          * Where to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
+          * The place to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
          */
         "target"?: string;
     }
     interface IcCheckbox {
         /**
-          * Set which style of additionalField will be displayed if used
+          * The style of additionalField that will be displayed if used.
          */
         "additionalFieldDisplay": IcAdditionalFieldTypes;
         /**
-          * Set the checkbox to the checked state
+          * If `true`, the checkbox will be set to the checked state.
          */
         "checked"?: boolean;
         /**
-          * Set the checkbox to the disabled state
+          * If `true`, the checkbox will be set to the disabled state.
          */
         "disabled"?: boolean;
         /**
-          * Provide a text prop for the dynamic text
+          * The text to be displayed when dynamic.
          */
         "dynamicText": string;
         /**
-          * Provide a group label for the input
+          * The group label for the checkbox.
          */
         "groupLabel": string;
         /**
-          * Display the indeterminate state when checked
+          * If `true`, the indeterminate state will be displayed when checked.
          */
         "indeterminate": boolean;
         /**
-          * Provide a label for the input
+          * The label for the checkbox.
          */
         "label": string;
         /**
-          * Provide a name for the input. If not set when used in a checkbox group, the name will be based on the group name.
+          * The name for the checkbox. If not set when used in a checkbox group, the name will be based on the group name.
          */
         "name": string;
         /**
-          * Provide a value for the input
+          * The value for the checkbox.
          */
         "value": string;
     }
     interface IcCheckboxGroup {
         /**
-          * Specify whether the input is disabled.
+          * If `true`, the checkbox group will be set to the disabled state.
          */
         "disabled": boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText": string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel": boolean;
         /**
-          * Provide a label for the input.
+          * The label for the checkbox group to be displayed.
          */
         "label": string;
         /**
-          * Provide a name for the input.
+          * The name for the checkbox group to differentiate from other groups.
          */
         "name": string;
         /**
-          * Specify if the input requires a value.
+          * If `true`, the checkbox group will require a value.
          */
         "required": boolean;
         /**
-          * Specify whether small styling to be applied to element.
+          * If `true`, the small styling will be applied to the checkbox group.
          */
         "small": boolean;
         /**
-          * Provide validation status - 'error'
+          * The validation status - e.g. 'error' | 'warning' | 'success'.
          */
         "validationStatus": IcInformationStatusOrEmpty;
         /**
-          * Provide validation text - 'error'
+          * The validation text - e.g. 'error' | 'warning' | 'success'.
          */
         "validationText": string;
     }
+    interface IcChip {
+        /**
+          * The emphasis of the chip.
+         */
+        "appearance"?: IcChipAppearance;
+        /**
+          * If `true`, the chip will appear disabled.
+         */
+        "disabled"?: boolean;
+        /**
+          * If `true`, the chip will have a close button at the end to dismiss it.
+         */
+        "dismissible"?: boolean;
+        /**
+          * The text rendered within the chip.
+         */
+        "label": string;
+        /**
+          * The size of the chip.
+         */
+        "size"?: IcChipSizes;
+    }
     interface IcClassificationBanner {
         /**
-          * Additional information to display after the classification
+          * The additional information that will be displayed after the classification.
          */
         "additionalSelectors"?: string;
         /**
-          * The classification level to be displayed also determines the banner and text colour
+          * The classification level to be displayed - also determines the banner and text colour.
          */
         "classification"?: IcProtectiveMarkings;
         /**
-          * Optional text displayed before classification to specify relevant country/countries
+          * The optional text that will be displayed before classification to specify relevant country/countries.
          */
         "country"?: string;
         /**
-          * Determines whether the banner appears inline with the page or sticks to the bottom of the page
+          * If `true`, the banner will appear inline with the page, instead of sticking to the bottom of the page.
          */
         "inline"?: boolean;
         /**
-          * Optionally display "Up to" before classification and country if set
+          * If `true`, "Up to" will be displayed before the classification and country.
          */
         "upTo"?: boolean;
     }
     interface IcDataEntity {
         /**
-          * Title for the data entity
+          * The title for the data entity.
          */
         "heading": string;
         /**
-          * Set the data heading and all child data rows to small styling
+          * If `true`, the small styling will be applied to the data heading and all child data rows.
          */
         "small": boolean;
     }
     interface IcDataRow {
         /**
-          * Set the label in the leftmost cell of the row
+          * The label in the leftmost cell of the row.
          */
         "label": string;
         /**
-          * Set the row to small styling, this is automatically applied if small is set on the parent data heading
+          * If `true`, the small styling will be applied to the row. This is automatically applied if small is set on the parent data heading.
          */
         "small": boolean;
         /**
-          * Set the value of the middle (right if no addition supplied) cell of the row
+          * The value of the middle (right if no end-component supplied) cell of the row.
          */
         "value": string;
     }
@@ -318,27 +341,27 @@ export namespace Components {
     }
     interface IcFooter {
         /**
-          * Sets the aligned parameter for the section containers used within the footer
+          * The alignment of the section containers used within the footer.
          */
         "aligned"?: IcAlignment;
         /**
-          * Sets the screen size breakpoint at which to switch to the small layout
+          * The screen size breakpoint at which to switch to the small layout.
          */
         "breakpoint"?: IcFooterBreakpoints;
         /**
-          * The caption displayed at the bottom of the footer
+          * The caption displayed at the bottom of the footer.
          */
         "caption": string;
         /**
-          * Whether the footer displays the crown copyright at the bottom
+          * If `true`, the footer will display the crown copyright at the bottom.
          */
         "copyright": boolean;
         /**
-          * The description displayed at the top of the footer
+          * The description displayed at the top of the footer.
          */
         "description": string;
         /**
-          * Sets the footer up to handle link groups instead of standalone links
+          * If `true`, the footer will be set up to handle link groups instead of standalone links.
          */
         "groupLinks"?: boolean;
     }
@@ -350,155 +373,155 @@ export namespace Components {
     }
     interface IcFooterLinkGroup {
         /**
-          * Sets the title of the link group for display
+          * The title of the link group to be displayed.
          */
         "groupTitle": string;
     }
     interface IcHero {
         /**
-          * The alignment of the hero content
+          * The alignment of the hero.
          */
         "aligned": IcAlignment;
         /**
-          * Optional background image
+          * The optional background image.
          */
         "backgroundImage"?: string;
         /**
-          * The alignment of the hero content
+          * The alignment of the hero content.
          */
         "contentAligned": IcHeroContentAlignments;
         /**
-          * Whether the background image (if set) scrolls using a parallax effect.
+          * If `true`, the background image (if set) will not scroll using a parallax effect.
          */
         "disableBackgroundParallax"?: boolean;
         /**
-          * The heading of the hero
+          * The heading of the hero.
          */
         "heading": string;
         /**
-          * Optional secondary heading, replaced by slotted right content
+          * The optional secondary heading, replaced by slotted right content.
          */
         "secondaryHeading"?: string;
         /**
-          * Optional secondary subheading, replaced by slotted right content
+          * The optional secondary subheading, replaced by slotted right content.
          */
         "secondarySubheading"?: string;
         /**
-          * Alter styling for use with small content/pages
+          * If `true`, the small styling will be applied to the hero.
          */
         "small": boolean;
         /**
-          * Description for the hero
+          * The description for the hero.
          */
         "subheading"?: string;
     }
     interface IcInputComponentContainer {
         /**
-          * Determines whether the dark variant of the input-component-container focus indicator should be displayed.
+          * If `true`, the dark variant of the input component container will be displayed.
          */
         "dark"?: boolean;
         /**
-          * disabled
+          * If `true`, the disabled state will be set.
          */
         "disabled": boolean;
         /**
-          * If true then fill width of container
+          * If `true`, the input component container will fill the width of the container it is in.
          */
         "fullWidth": boolean;
         /**
-          * multiLine
+          * If `true`, the input component container will allow for multiple lines.
          */
         "multiLine": boolean;
         /**
-          * readonly
+          * If `true`, the readonly state will be set.
          */
         "readonly": boolean;
         /**
-          * small
+          * If `true`, the small styling will be applied to the input component container.
          */
         "small": boolean;
         /**
-          * validationInline
+          * If `true`, the validation will display inline.
          */
         "validationInline": boolean;
         /**
-          * validationStatus
+          * The validation status of the input component container - e.g. 'error' | 'warning' | 'success'.
          */
         "validationStatus": IcInformationStatusOrEmpty;
     }
     interface IcInputContainer {
         /**
-          * disabled
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * readonly
+          * If `true`, the readonly state will be set.
          */
         "readonly"?: boolean;
     }
     interface IcInputLabel {
         /**
-          * dark
+          * If `true`, the dark variant of the input label will be displayed.
          */
         "dark"?: boolean;
         /**
-          * disabled
+          * If `true`, the disabled state will be set.
          */
         "disabled": boolean;
         /**
-          * error
+          * If `true`, the input label will display with error styling.
          */
         "error"?: boolean;
         /**
-          * for
+          * The ID of the form element the label is bound to.
          */
         "for": string;
         /**
-          * helperText
+          * The helper text that will be displayed.
          */
         "helperText": string;
         /**
-          * label
+          * The text content of the label.
          */
         "label": string;
         /**
-          * readonly
+          * If `true`, the readonly state will be set.
          */
         "readonly": boolean;
         /**
-          * required
+          * If `true`, the input label will require a value.
          */
         "required": boolean;
     }
     interface IcInputValidation {
         /**
-          * aria live mode to apply to message
+          * The ARIA live mode to apply to the message.
          */
         "ariaLiveMode": IcAriaLiveModeVariants;
         /**
-          * The id of the input field the message relates to
+          * The ID of the form element the validation is bound to.
          */
         "for": string;
         /**
-          * If true then fill width of container
+          * If `true`, the input validation will fill the width of the container.
          */
         "fullWidth": boolean;
         /**
-          * The validation message to display
+          * The validation message to display.
          */
         "message": string;
         /**
-          * The status
+          * The status of the validation - e.g. 'error' | 'warning' | 'success'.
          */
         "status": IcInformationStatusOrEmpty;
     }
     interface IcLink {
         /**
-          * Determines the whether the appearance is dark, light, or the default.
+          * The appearance of the link, e.g. dark, light, or default.
          */
         "appearance"?: IcThemeForeground;
         /**
-          * Prompts the user to save the linked URL instead of navigating to it.
+          * If `true`, the user can save the linked URL instead of navigating to it.
          */
         "download"?: string | boolean;
         /**
@@ -506,7 +529,7 @@ export namespace Components {
          */
         "href"?: string;
         /**
-          * Hints at the human language of the linked URL.
+          * The human language of the linked URL.
          */
         "hreflang"?: string;
         /**
@@ -518,27 +541,28 @@ export namespace Components {
          */
         "rel"?: string;
         /**
-          * Determines whether the 'open in new tab/window' icon is to be displayed.
+          * If `true`, the 'open in new tab/window' icon will be displayed.
          */
         "showIcon"?: boolean;
         /**
-          * Where to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
+          * The place to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
          */
         "target"?: string;
     }
     interface IcLoadingIndicator {
         /**
-          * Determines whether the dark or light loading indicator should be displayed.
+          * The appearance of the loading indicator, e.g. dark or light.
          */
         "appearance"?: IcThemeForegroundNoDefault;
         /**
-          * Provide a description to be set as the aria-label of the loading indicator when not using a visible label.
+          * The description that will be set as the aria-label of the loading indicator when not using a visible label.
          */
         "description"?: string;
         /**
-          * When linear, determines whether the full-width version (i.e. without a border radius) should be displayed.
+          * If `true`, when linear, the full-width variant (i.e. without a border radius) will be displayed.
          */
         "fullWidth"?: boolean;
+        "innerLabel"?: number;
         /**
           * The label to be displayed beneath the loading indicator. Display a changing label by separating multiple messages with forward slashes.
          */
@@ -574,16 +598,16 @@ export namespace Components {
          */
         "activationType"?: IcActivationTypes;
         /**
-          * Reference to an anchor element the menu will position itself from when rendered.
+          * The reference to an anchor element the menu will position itself from when rendered.
          */
         "anchorEl": HTMLElement;
         "autoFocusOnSelected": boolean;
         /**
-          * If true then fill width of container
+          * If `true`, the menu will fill the width of the container.
          */
         "fullWidth": boolean;
         /**
-          * If menu is opened with the mouse, emit menuChange custom event.
+          * If menu is opened with the mouse, emit icMenuStateChange custom event.
          */
         "handleClickOpen": () => Promise<void>;
         /**
@@ -593,28 +617,28 @@ export namespace Components {
         "handleKeyboardOpen": (event: KeyboardEvent) => Promise<void>;
         "handleSetFirstOption": () => Promise<void>;
         /**
-          * Reference to the input element.
+          * The reference to the input element.
          */
         "inputEl": HTMLElement;
         /**
-          * Label for the input element.
+          * The label for the input element.
          */
         "inputLabel": string;
         /**
-          * Id of the menu.
+          * The ID of the menu.
          */
         "menuId": string;
         /**
-          * Specify whether the menu is open.
+          * If `true`, the menu will be displayed open.
          */
         "open": boolean;
         /**
-          * Provide the possible selection options.
+          * The possible menu selection options.
          */
         "options": IcMenuOption[];
         "parentEl"?: HTMLElement;
         /**
-          * Specify whether small styling is to be applied to the element.
+          * If `true`, the small styling will be applied to the menu.
          */
         "small"?: boolean;
         /**
@@ -624,7 +648,7 @@ export namespace Components {
     }
     interface IcNavigationButton {
         /**
-          * Prompts the user to save the linked URL instead of navigating to it.
+          * If `true`, the user can save the linked URL instead of navigating to it.
          */
         "download"?: string | boolean;
         /**
@@ -632,11 +656,11 @@ export namespace Components {
          */
         "href"?: string;
         /**
-          * Hints at the human language of the linked URL.
+          * The human language of the linked URL.
          */
         "hreflang"?: string;
         /**
-          * label info to display
+          * The label info to display.
          */
         "label": string;
         /**
@@ -652,17 +676,17 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * Where to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
+          * The place to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
          */
         "target"?: string;
     }
     interface IcNavigationGroup {
         /**
-          * whether the group should be expandable/collapsible in the side menu
+          * If `true`, the group will be expandable in the side menu.
          */
         "expandable": boolean;
         /**
-          * label to display on the group
+          * The label to display on the group.
          */
         "label": string;
         /**
@@ -675,15 +699,15 @@ export namespace Components {
         "displayNavigationTooltip": boolean;
         "expandable": boolean;
         /**
-          * Destination of the navigation item
+          * The destination of the navigation item.
          */
         "href": string;
         /**
-          * Label of the navigation item
+          * The label of the navigation item.
          */
         "label": string;
         /**
-          * If true, sets the navigation item in a selected state
+          * If `true`, the navigation item will be set in a selected state.
          */
         "selected": boolean;
         /**
@@ -693,179 +717,179 @@ export namespace Components {
     }
     interface IcNavigationMenu {
         /**
-          * Status info to display
+          * The status info to display.
          */
         "status": string;
         /**
-          * Version info to display
+          * The version info to display.
          */
         "version": string;
     }
     interface IcPageHeader {
         /**
-          * How the component should be aligned.
+          * The alignment of the page header.
          */
         "aligned"?: IcAlignment;
         /**
-          * Set whether the bottom border is used
+          * If `true`, a border will be displayed along the bottom of the page header.
          */
         "border"?: boolean;
         /**
-          * The title to render on the component.
+          * The title to render on the page header.
          */
         "heading"?: string;
         /**
-          * Set whether the reading pattern and tab order change in the action area for viewport widths of above 576px and when actions have not wrapped
+          * If `true`, the reading pattern and tab order will change in the action area for viewport widths of above 576px and when actions have not wrapped.
          */
         "reverseOrder"?: boolean;
         /**
-          * Whether the component uses small styling.
+          * If `true`, the small styling will be applied to the page header.
          */
         "small"?: boolean;
         /**
-          * Set whether the header is sticky at all breakpoints
+          * If `true`, the page header will be sticky at all breakpoints.
          */
         "sticky"?: boolean;
         /**
-          * Set whether the header is only sticky for viewport widths of 992px and above
+          * If `true`, the page header will only be sticky for viewport widths of 992px and above.
          */
         "stickyDesktopOnly"?: boolean;
         /**
-          * The subtitle to render on the component.
+          * The subtitle to render on the page header.
          */
         "subheading"?: string;
     }
     interface IcRadioGroup {
         /**
-          * Specify whether the input is disabled.
+          * If `true`, the disabled state will be set.
          */
         "disabled": boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText": string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel": boolean;
         /**
-          * Provide a label for the input.
+          * The label for the radio group to be displayed.
          */
         "label": string;
         /**
-          * Provide a name for the input.
+          * The name for the radio group to differentiate from other groups.
          */
         "name": string;
         /**
-          * Specify if the input requires a value.
+          * If `true`, the radio group will require a value.
          */
         "required": boolean;
         /**
-          * Specify whether small styling is to be applied to the element.
+          * If `true`, the small styling will be applied to the radio group.
          */
         "small": boolean;
         /**
-          * Provide validation status - 'error'
+          * The validation status - e.g. 'error' | 'warning' | 'success'.
          */
         "validationStatus": IcInformationStatusOrEmpty;
         /**
-          * Provide validation text - 'error'
+          * The validation text - e.g. 'error' | 'warning' | 'success'.
          */
         "validationText": string;
     }
     interface IcRadioOption {
         /**
-          * Determines type of additional text field in relation to radio option
+          * The style of additionalField that will be displayed if used.
          */
         "additionalFieldDisplay": IcAdditionalFieldTypes;
         /**
-          * Determines whether the radio should be in disabled state.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * Provide a text prop for the dynamic text.
+          * The text to be displayed when dynamic.
          */
         "dynamicText": string;
         /**
-          * Provide a group label for the input.
+          * The group label for the radio option.
          */
         "groupLabel": string;
         /**
-          * Provide a label for the input.
+          * The label for the radio option.
          */
         "label"?: string;
         /**
-          * Provide a name for the input.
+          * The name for the radio option.
          */
         "name": string;
         /**
-          * Determines whether the radio should be in selected state.
+          * If `true`, the radio option will be displayed in a selected state.
          */
         "selected"?: boolean;
         /**
-          * Provide a value for the input.
+          * The value for the radio option.
          */
         "value": string;
     }
     interface IcSearchBar {
         /**
-          * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user. Available options: "off", "none", "on", "sentences", "words", "characters".
+          * The automatic capitalisation of the text value as it is entered/edited by the user. Available options: "off", "none", "on", "sentences", "words", "characters".
          */
         "autocapitalize": string;
         /**
-          * Indicates whether the value of the control can be automatically completed by the browser.
+          * The state of autocompletion the browser can apply on the text value.
          */
         "autocomplete"?: IcAutocompleteTypes;
         /**
-          * Whether auto correction should be enabled when the user is entering/editing the text value.
+          * The state of autocorrection the browser can apply when the user is entering/editing the text value.
          */
         "autocorrect"?: IcAutocorrectStates;
         /**
-          * This Boolean attribute lets you specify that a form control should have input focus when the page loads.
+          * If `true`, the form control will have input focus when the page loads.
          */
         "autofocus": boolean;
         /**
-          * Number of characters until suggestions appear
+          * The number of characters until suggestions appear.
          */
         "charactersUntilSuggestion": number;
         /**
-          * Set the amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke.
+          * The amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke.
          */
         "debounce"?: number;
         /**
-          * Specify whether to disable the built in filtering. For example, if options will already be filtered from external source. If true, all options provided will be displayed.
+          * Specify whether to disable the built in filtering. For example, if options will already be filtered from external source. If `true`, all options provided will be displayed.
          */
         "disableFilter"?: boolean;
         /**
-          * Specify whether the input is disabled.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * Provide text for empty results list
+          * The text displayed when there are no options in the option list.
          */
         "emptyOptionListText": string;
         /**
-          * Specify whether the input should be focussed when component loaded.
+          * If `true`, the search bar will be focused when component loaded.
          */
         "focusOnLoad"?: boolean;
         /**
-          * Specify whether the component fills the full width of the container. If true, this overrides the --input-width css prop.
+          * Specify whether the search bar fills the full width of the container. If `true`, this overrides the --input-width CSS variable.
          */
         "fullWidth"?: boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText"?: string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel"?: boolean;
         /**
-          * Provide hint text for hidden assistive description element.
+          * The hint text for the hidden assistive description element.
          */
         "hintText"?: string;
         /**
-          * Provide a label for the input.
+          * The label for the search bar.
          */
         "label": string;
         /**
@@ -873,19 +897,19 @@ export namespace Components {
          */
         "name": string;
         /**
-          * Provide the suggested search options
+          * The suggested search options.
          */
         "options"?: IcMenuOption[];
         /**
-          * Provide a placeholder value to display.
+          * The placeholder value to display.
          */
         "placeholder"?: string;
         /**
-          * Specify whether the input is read only.
+          * If `true`, the readonly state will be set.
          */
         "readonly"?: boolean;
         /**
-          * Specify if the input requires a value.
+          * If `true`, the search bar will require a value.
          */
         "required"?: boolean;
         /**
@@ -893,63 +917,63 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * Specify whether small styling is to be applied to the element.
+          * If `true`, the small styling will be applied to the search bar.
          */
         "small"?: boolean;
         /**
-          * If `true`, the element will have its spelling and grammar checked.
+          * If `true`, the value of the search will have its spelling and grammar checked.
          */
         "spellcheck": boolean;
         /**
-          * Value of Search input.
+          * The value of the search input.
          */
         "value": string;
     }
     interface IcSectionContainer {
         /**
-          * How the container should be aligned.
+          * The alignment of the container.
          */
         "aligned"?: IcAlignment;
         /**
-          * Removes the standard vertical padding from the container.
+          * If `true`, the standard vertical padding from the container will be removed.
          */
         "fullHeight"?: boolean;
     }
     interface IcSelect {
         /**
-          * Number of characters until suggestions appear for a searchable select.
+          * The number of characters until suggestions appear for a searchable select.
          */
         "charactersUntilSuggestions"?: number;
         /**
-          * Specify whether the input is disabled.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * Provide text for empty results list
+          * The text displayed when there are no options in the option list.
          */
         "emptyOptionListText": string;
         /**
-          * If true, then fill width of container.
+          * If `true`, the select element will fill the width of the container.
          */
         "fullWidth": boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText"?: string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel"?: boolean;
         /**
-          * If true, descriptions of options are included when filtering options in a searchable select.
+          * If `true`, descriptions of options will be included when filtering options in a searchable select.
          */
         "includeDescriptionsInSearch"?: boolean;
         /**
-          * If true, group titles of grouped options are included when filtering options in a searchable select.
+          * If `true`, group titles of grouped options will be included when filtering options in a searchable select.
          */
         "includeGroupTitlesInSearch"?: boolean;
         /**
-          * Provide a label for the input.
+          * The label for the select.
          */
         "label": string;
         /**
@@ -957,19 +981,19 @@ export namespace Components {
          */
         "name"?: string;
         /**
-          * Provide the possible selection options.
+          * The possible selection options.
          */
         "options"?: IcMenuOption[];
         /**
-          * Provide a placeholder value to display.
+          * The placeholder value to be displayed.
          */
         "placeholder"?: string;
         /**
-          * Specify whether the input is read only.
+          * If `true`, the readonly state will be set.
          */
         "readonly"?: boolean;
         /**
-          * Specify if the input requires a value.
+          * If `true`, the select will require a value.
          */
         "required"?: boolean;
         /**
@@ -977,7 +1001,7 @@ export namespace Components {
          */
         "searchMatchPosition"?: IcSearchMatchPositions;
         /**
-          * If true, the select can be typed in to filter options.
+          * If `true`, a searchable variant of the select will be displayed which can be typed in to filter options.
          */
         "searchable"?: boolean;
         /**
@@ -985,19 +1009,19 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * Display a button which clears the input when clicked. The button will always appear on the searchable select.
+          * If `true`, a button which clears the select input when clicked will be displayed. The button will always appear on the searchable select.
          */
         "showClearButton"?: boolean;
         /**
-          * Specify whether small styling is to be applied to the element.
+          * If `true`, the small styling will be applied to the select.
          */
         "small"?: boolean;
         /**
-          * Provide a validation status.
+          * The validation status - e.g. 'error' | 'warning' | 'success'.
          */
         "validationStatus"?: IcInformationStatusOrEmpty;
         /**
-          * Provide the text to display as the validation message.
+          * The text to display as the validation message.
          */
         "validationText"?: string;
         /**
@@ -1007,49 +1031,46 @@ export namespace Components {
     }
     interface IcSideNavigation {
         /**
-          * Title to display.
+          * The title of the app to be displayed.
          */
         "appTitle": string;
         /**
-          * If true, the icon and label will appear when side navigation is collapsed
+          * If `true`, the icon and label will appear when side navigation is collapsed.
          */
         "collapsedIconLabels": boolean;
         /**
-          * If true, disable automatic parent wrapper styling
+          * If `true`, automatic parent wrapper styling will be disabled.
          */
         "disableAutoParentStyling": boolean;
         /**
-          * If true, the ic-side-navigation will load in an expanded state
+          * If `true`, the side navigation will load in an expanded state.
          */
         "expanded": boolean;
         /**
-          * Set application title link
+          * The URL that the app title link points to.
          */
         "href": string;
-        /**
-          * If true, side navigation will be contained by parent element
-         */
         "inline": boolean;
         /**
-          * If true, the menu expand button is removed (PLEASE NOTE: This takes effect on screen sizes 992px and above)
+          * If `true`, the menu expand button will be removed (PLEASE NOTE: This takes effect on screen sizes 992px and above).
          */
         "static": boolean;
         /**
-          * Status of application
+          * The status of the app to be displayed.
          */
         "status": string;
         /**
-          * Version of application
+          * The version of the app to be displayed.
          */
         "version": string;
     }
     interface IcSkeleton {
         /**
-          * Set the skeleton to the light variant
+          * If `true`, the skeleton will be set to the light variant.
          */
         "light"?: boolean;
         /**
-          * The variant of the skeleton that will be displayed
+          * The variant of the skeleton that will be displayed.
          */
         "variant"?: IcSkeletonVariants;
     }
@@ -1063,7 +1084,7 @@ export namespace Components {
          */
         "label": string;
         /**
-          * The size of the status tag.
+          * If `true`, the small styling will be applied to the status tag.
          */
         "small"?: boolean;
         /**
@@ -1072,50 +1093,68 @@ export namespace Components {
         "status"?: IcStatusTagStatuses;
     }
     interface IcStep {
-        "lastStep"?: boolean;
+        "compactStepStyling"?: IcStepTypes;
+        "current"?: boolean;
+        "lastStep": boolean;
+        "lastStepNum"?: number;
+        "nextStepTitle"?: string;
+        "progress"?: number;
         "stepNum"?: number;
         /**
-          * Additional information about step
+          * The status of the step. Use this prop to display a status message on the step if it is required or optional.
+         */
+        "stepStatus"?: IcStepStatuses;
+        /**
+          * Additional information about the step. Use this prop to override the default step status messaging displayed when selecting a step type or step status.
          */
         "stepSubtitle"?: string;
         /**
-          * Name of step
+          * The title of the step within the stepper.
          */
         "stepTitle"?: string;
         /**
-          * State of step
+          * The state of the step within the stepper.
          */
         "stepType"?: IcStepTypes;
+        "variant": IcStepVariants;
     }
     interface IcStepper {
         /**
-          * How the stepper should be aligned in its container.
+          * The alignment of the default stepper within its container.
          */
         "aligned"?: IcStepperAlignment;
         /**
           * The length of the connnector between each step in pixels. Minimum length is 100px.
          */
         "connectorWidth"?: number;
+        /**
+          * If `true`, the information about each step, i.e. step title, step subtitle and step status, will be hidden on all default steps. The information about each step will still be visible in the compact variant of the stepper.
+         */
+        "hideStepInfo"?: boolean;
+        /**
+          * The variant of the stepper.
+         */
+        "variant"?: IcStepVariants;
     }
     interface IcSwitch {
         /**
-          * If true, the component is checked.
+          * If `true`, the switch will display as checked.
          */
         "checked"?: boolean;
         /**
-          * If true, the component is not interactive.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText"?: string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel"?: boolean;
         /**
-          * Applies an aria-label to the component, for when no visual 'name' is provided.
+          * The aria-label applied to the switch when no visual 'name' is provided.
          */
         "label": string;
         /**
@@ -1123,11 +1162,11 @@ export namespace Components {
          */
         "name"?: string;
         /**
-          * If true, the component will render the On/Off state text.
+          * If `true`, the switch will render the On/Off state text.
          */
         "showState"?: boolean;
         /**
-          * If true, the component reduces in size to the small state.
+          * If `true`, the small styling will be applied to the switch.
          */
         "small"?: boolean;
         /**
@@ -1139,7 +1178,7 @@ export namespace Components {
         "appearance"?: IcThemeForegroundNoDefault;
         "contextId"?: string;
         /**
-          * Disables the tab.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         "selected"?: boolean;
@@ -1152,30 +1191,30 @@ export namespace Components {
          */
         "activationType"?: IcActivationTypes;
         /**
-          * Determines whether the light or dark variant of the tabs should be displayed.
+          * The appearance of the tab context, e.g dark, or light.
          */
         "appearance"?: IcThemeForegroundNoDefault;
         /**
-          * Provide a unique context if using multiple tabs inside one another i.e. rendering another set of tabs inside a tab panel.
+          * The unique context needed if using multiple tabs inside one another i.e. rendering another set of tabs inside a tab panel.
          */
         "contextId"?: string;
         /**
-          * Allows the user to control the selected tab. Must be used alongside the tabSelect event to manage tab selection.
+          * The selected tab to be controlled by the user. Must be used alongside the icTabSelect event to manage tab selection.
          */
         "selectedTabIndex"?: number;
     }
     interface IcTabGroup {
         "appearance"?: IcThemeForegroundNoDefault;
         /**
-          * Provide a unique context if using multiple tabs inside one another i.e. rendering another set of tabs inside a tab panel.
+          * The unique context needed if using multiple tabs inside one another i.e. rendering another set of tabs inside a tab panel.
          */
         "contextId"?: string;
         /**
-          * Use when tabs and tab panels are to be positioned separately.
+          * If `true`, the tabs and tab panels will be positioned separately.
          */
         "inline"?: boolean;
         /**
-          * Provide a label to describe the purpose of the set of tabs to screen reader users.
+          * The label to describe the purpose of the set of tabs to screen reader users.
          */
         "label": string;
         "scrollTabIntoView": (tabNumber: number) => Promise<void>;
@@ -1183,7 +1222,7 @@ export namespace Components {
     interface IcTabPanel {
         "appearance"?: IcThemeForegroundNoDefault;
         /**
-          * Provide a unique context if using multiple tabs inside one another i.e. rendering another tabs inside a tab panel.
+          * The unique context needed if using multiple tabs inside one another i.e. rendering another tabs inside a tab panel.
          */
         "contextId"?: string;
         "panelId"?: string;
@@ -1196,44 +1235,44 @@ export namespace Components {
         "ariaExpanded": string;
         "ariaOwns": string;
         /**
-          * This Boolean attribute lets you specify that a form control should have input focus when the page loads.
+          * If `true`, the form control will have input focus when the page loads.
          */
         "autoFocus": boolean;
         /**
-          * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user. Available options: "off", "none", "on", "sentences", "words", "characters".
+          * The automatic capitalisation of the text value as it is entered/edited by the user. Available options: "off", "none", "on", "sentences", "words", "characters".
          */
         "autocapitalize": string;
         /**
-          * Indicates whether the value of the control can be automatically completed by the browser.
+          * The state of autocompletion the browser can apply on the text value.
          */
         "autocomplete": IcAutocompleteTypes1;
         /**
-          * Whether auto correction should be enabled when the user is entering/editing the text value.
+          * The state of autocorrection the browser can apply when the user is entering/editing the text value.
          */
         "autocorrect": IcAutocorrectStates1;
         /**
-          * Set the amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke.
+          * The amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke.
          */
         "debounce": number;
         /**
-          * Specify whether the input is disabled.
+          * If `true`, the disabled state will be set.
          */
         "disabled": boolean;
         /**
-          * Specify whether the component fills the full width of the container. If true, this overrides the --input-width css prop.
+          * Specify whether the text field fills the full width of the container. If `true`, this overrides the --input-width CSS variable.
          */
         "fullWidth": boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText": string;
         "hiddenInput": boolean;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel": boolean;
         /**
-          * Provide an id for the input
+          * The ID for the input.
          */
         "inputId"?: string;
         /**
@@ -1241,11 +1280,11 @@ export namespace Components {
          */
         "inputmode": IcTextFieldInputModes;
         /**
-          * Provide a label for the input.
+          * The label for the input.
          */
         "label": string;
         /**
-          * Maximum number of characters that can be entered in the field.
+          * The maximum number of characters that can be entered in the field.
          */
         "maxLength": number;
         /**
@@ -1253,24 +1292,24 @@ export namespace Components {
          */
         "name": string;
         /**
-          * Provide a placeholder value to display.
+          * The placeholder value to be displayed.
          */
         "placeholder": string;
         /**
-          * Specify whether the input is read only.
+          * If `true`, the read only state will be set.
          */
         "readonly": boolean;
         /**
-          * Specify if the input requires a value.
+          * If `true`, the input will require a value.
          */
         "required": boolean;
         /**
-          * Allow resizing of a multiline text area
+          * If `true`, the multiline text area will be resizeable.
          */
         "resize": boolean;
         "role": string;
         /**
-          * Specify the number of rows to transform the text field into a text area with a specific height.
+          * The number of rows to transform the text field into a text area with a specific height.
          */
         "rows": number;
         /**
@@ -1278,11 +1317,11 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * Specify whether small styling is to be applied to the element.
+          * If `true`, the small styling will be applied to the text field.
          */
         "small": boolean;
         /**
-          * If `true`, the element will have its spelling and grammar checked.
+          * If `true`, the value of the text field will have its spelling and grammar checked.
          */
         "spellcheck": boolean;
         "truncateValue"?: boolean;
@@ -1291,29 +1330,33 @@ export namespace Components {
          */
         "type": IcTextFieldTypes;
         /**
-          * Show icon in input control - only applies when validationStatus ='success'
+          * If `true`, the icon in input control will be displayed - only applies when validationStatus ='success'.
          */
         "validationInline": boolean;
         /**
-          * Provide validation state - 'error' | 'warning' | 'success'
+          * The validation state - e.g. 'error' | 'warning' | 'success'.
          */
         "validationStatus": IcInformationStatusOrEmpty1;
         /**
-          * Provide validation state - 'error' | 'warning' | 'success'
+          * The validation state - e.g. 'error' | 'warning' | 'success'.
          */
         "validationText": string;
         /**
-          * Value of TextField.
+          * The value of the text field.
          */
         "value": string;
     }
     interface IcTheme {
         /**
-          * The theme colour. Can be a hex value eg "#ff0000" or RGB eg "rgb(255, 0, 0)"
+          * The theme colour. Can be a hex value e.g. "#ff0000", RGB e.g. "rgb(255, 0, 0)", or RGBA e.g. "rgba(255, 0, 0, 1)".
          */
         "color"?: string;
     }
     interface IcTooltip {
+        /**
+          * If `true`, the tooltip will not be displayed on hover, it will require a click.
+         */
+        "disableHover"?: boolean;
         /**
           * The text to display on the tooltip.
          */
@@ -1329,33 +1372,33 @@ export namespace Components {
     }
     interface IcTopNavigation {
         /**
-          * Title to display
+          * The app title to be displayed.
          */
         "appTitle": string;
         /**
-          * The alignment of the top nav content
+          * The alignment of the top navigation content.
          */
         "contentAligned": IcAlignment;
         /**
-          * The url to navigate to when title is clicked
+          * The URL to navigate to when the app title is clicked.
          */
         "href": string;
         /**
-          * If true, the flyout navigation menu on small devices will be contained by the parent element
+          * If `true`, the flyout navigation menu on small devices will be contained by the parent element.
          */
         "inline": boolean;
         /**
-          * Status info to display
+          * The status info to be displayed.
          */
         "status": string;
         /**
-          * Version info to display
+          * The version info to be displayed.
          */
         "version": string;
     }
     interface IcTypography {
         /**
-          * Adds appropriate margins to the top and bottom of the typography.
+          * If `true`, appropriate top and bottom margins will be applied to the typography.
          */
         "applyVerticalMargins"?: boolean;
         /**
@@ -1380,6 +1423,10 @@ export interface IcCheckboxGroupCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLIcCheckboxGroupElement;
 }
+export interface IcChipCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLIcChipElement;
+}
 export interface IcFooterCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLIcFooterElement;
@@ -1485,6 +1532,12 @@ declare global {
         prototype: HTMLIcCheckboxGroupElement;
         new (): HTMLIcCheckboxGroupElement;
     };
+    interface HTMLIcChipElement extends Components.IcChip, HTMLStencilElement {
+    }
+    var HTMLIcChipElement: {
+        prototype: HTMLIcChipElement;
+        new (): HTMLIcChipElement;
+    };
     interface HTMLIcClassificationBannerElement extends Components.IcClassificationBanner, HTMLStencilElement {
     }
     var HTMLIcClassificationBannerElement: {
@@ -1734,6 +1787,7 @@ declare global {
         "ic-card": HTMLIcCardElement;
         "ic-checkbox": HTMLIcCheckboxElement;
         "ic-checkbox-group": HTMLIcCheckboxGroupElement;
+        "ic-chip": HTMLIcChipElement;
         "ic-classification-banner": HTMLIcClassificationBannerElement;
         "ic-data-entity": HTMLIcDataEntityElement;
         "ic-data-row": HTMLIcDataRowElement;
@@ -1779,31 +1833,35 @@ declare global {
 declare namespace LocalJSX {
     interface IcAlert {
         /**
-          * Set whether the alert has the 'alert' aria role and will be announced to screen readers
+          * If `true`, the alert will have the 'alert' ARIA role and will be announced to screen readers.
          */
         "announced"?: boolean;
         /**
-          * Set whether the alert has a close icon at the end to dismiss it
+          * If `true`, the alert will have a close icon at the end to dismiss it.
          */
         "dismissible"?: boolean;
         /**
-          * Optional title to display at the start of the alert
+          * The optional title to display at the start of the alert.
          */
         "heading"?: string;
         /**
-          * Main body message of the alert
+          * The main body message of the alert.
          */
         "message"?: string;
         /**
-          * Is emitted when the user dismisses the alert.
+          * @deprecated This event should not be used anymore. Use icDismiss instead.
          */
         "onDismiss"?: (event: IcAlertCustomEvent<void>) => void;
         /**
-          * Set whether the title and message appear inline or above and below
+          * Is emitted when the user dismisses the alert.
+         */
+        "onIcDismiss"?: (event: IcAlertCustomEvent<void>) => void;
+        /**
+          * If `true`, the title and message will appear inline instead of above and below.
          */
         "titleAbove"?: boolean;
         /**
-          * Set which variant of the alert will be rendered
+          * The variant of the alert which will be rendered.
          */
         "variant"?: IcAlertVariants;
     }
@@ -1815,47 +1873,47 @@ declare namespace LocalJSX {
     }
     interface IcBreadcrumb {
         /**
-          * If true, aria-current will be set on the breadcrumb
+          * If `true`, aria-current will be set on the breadcrumb.
          */
         "current"?: boolean;
         /**
-          * Set breadcrumb location
+          * The URL that the breadcrumb link points to.
          */
         "href"?: string;
         /**
-          * Set breadcrumb title
+          * The title of the breadcrumb.
          */
         "pageTitle": string;
     }
     interface IcBreadcrumbGroup {
         /**
-          * If true, display the parent page and back icon as breadcrumb
+          * If `true`, display only a single breadcrumb for the parent page with a back icon.
          */
         "backBreadcrumbOnly"?: boolean;
         /**
-          * If true, all breadcrumbs between the first and last breadcrumb will be collapsed
+          * If `true`, all breadcrumbs between the first and last breadcrumb will be collapsed.
          */
         "collapsed"?: boolean;
     }
     interface IcButton {
         /**
-          * Determines the whether the appearance of the button is dark, light, or the default.
+          * The appearance of the button, e.g. dark, light, or the default.
          */
         "appearance"?: IcThemeForeground;
         /**
-          * Disable ic-tooltip which is shown for icon variant. Title or aria-label must be set if this prop is not applied.
+          * If `true`, the ic-tooltip which is shown for icon variant will be disabled. Title or aria-label must be set if this prop is not applied.
          */
         "disableTooltip"?: boolean;
         /**
-          * Determines whether the button should be in disabled state.
+          * If `true`, the button will be in disabled state.
          */
         "disabled"?: boolean;
         /**
-          * Prompts the user to save the linked URL instead of navigating to it.
+          * If `true`, the user can save the linked URL instead of navigating to it.
          */
         "download"?: string | boolean;
         /**
-          * Fill the width of the container if true.
+          * If `true`, the button will fill the width of the container.
          */
         "fullWidth"?: boolean;
         /**
@@ -1863,11 +1921,11 @@ declare namespace LocalJSX {
          */
         "href"?: string;
         /**
-          * Hints at the human language of the linked URL.
+          * The human language of the linked URL.
          */
         "hreflang"?: string;
         /**
-          * Determines whether the button should be in loading state.
+          * If `true`, the button will be in loading state.
          */
         "loading"?: boolean;
         /**
@@ -1891,7 +1949,7 @@ declare namespace LocalJSX {
          */
         "size"?: IcButtonSizes;
         /**
-          * Where to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
+          * The place to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
          */
         "target"?: string;
         /**
@@ -1903,37 +1961,37 @@ declare namespace LocalJSX {
          */
         "type"?: IcButtonTypes;
         /**
-          * The button variant to be displayed.
+          * The variant of the button to be displayed.
          */
         "variant"?: IcButtonVariants;
     }
     interface IcCard {
         /**
-          * Set the variant to static or clickable
+          * If `true`, the card will be a clickable variant, instead of static.
          */
         "clickable"?: boolean;
         /**
-          * Whether the card is disabled if it is clickable
+          * If `true`, the card will be disabled if it is clickable.
          */
         "disabled"?: boolean;
         /**
-          * If true then fill width of container
+          * If `true`, the card will fill the width of the container.
          */
         "fullWidth"?: boolean;
         /**
-          * Title for the card
+          * The title for the card.
          */
         "heading": string;
         /**
-          * URL for clickable cards
+          * The URL that the clickable card link points to.
          */
         "href"?: string | undefined;
         /**
-          * Human readable explanation of the URL
+          * The human language of the linked URL.
          */
         "hreflang"?: string;
         /**
-          * Main body message of the card
+          * The main body message of the card.
          */
         "message"?: string;
         /**
@@ -1945,71 +2003,75 @@ declare namespace LocalJSX {
          */
         "rel"?: string;
         /**
-          * Where to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
+          * The place to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
          */
         "target"?: string;
     }
     interface IcCheckbox {
         /**
-          * Set which style of additionalField will be displayed if used
+          * The style of additionalField that will be displayed if used.
          */
         "additionalFieldDisplay"?: IcAdditionalFieldTypes;
         /**
-          * Set the checkbox to the checked state
+          * If `true`, the checkbox will be set to the checked state.
          */
         "checked"?: boolean;
         /**
-          * Set the checkbox to the disabled state
+          * If `true`, the checkbox will be set to the disabled state.
          */
         "disabled"?: boolean;
         /**
-          * Provide a text prop for the dynamic text
+          * The text to be displayed when dynamic.
          */
         "dynamicText"?: string;
         /**
-          * Provide a group label for the input
+          * The group label for the checkbox.
          */
         "groupLabel"?: string;
         /**
-          * Display the indeterminate state when checked
+          * If `true`, the indeterminate state will be displayed when checked.
          */
         "indeterminate"?: boolean;
         /**
-          * Provide a label for the input
+          * The label for the checkbox.
          */
         "label": string;
         /**
-          * Provide a name for the input. If not set when used in a checkbox group, the name will be based on the group name.
+          * The name for the checkbox. If not set when used in a checkbox group, the name will be based on the group name.
          */
         "name"?: string;
         /**
-          * Emitted when a checkbox has been checked
+          * @deprecated This event should not be used anymore. Use icCheck instead.
          */
         "onCheckboxChecked"?: (event: IcCheckboxCustomEvent<void>) => void;
         /**
-          * Provide a value for the input
+          * Emitted when a checkbox has been checked.
+         */
+        "onIcCheck"?: (event: IcCheckboxCustomEvent<void>) => void;
+        /**
+          * The value for the checkbox.
          */
         "value": string;
     }
     interface IcCheckboxGroup {
         /**
-          * Specify whether the input is disabled.
+          * If `true`, the checkbox group will be set to the disabled state.
          */
         "disabled"?: boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText"?: string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel"?: boolean;
         /**
-          * Provide a label for the input.
+          * The label for the checkbox group to be displayed.
          */
         "label": string;
         /**
-          * Provide a name for the input.
+          * The name for the checkbox group to differentiate from other groups.
          */
         "name": string;
         /**
@@ -2017,65 +2079,91 @@ declare namespace LocalJSX {
          */
         "onIcChange"?: (event: IcCheckboxGroupCustomEvent<IcChangeEventDetail>) => void;
         /**
-          * Specify if the input requires a value.
+          * If `true`, the checkbox group will require a value.
          */
         "required"?: boolean;
         /**
-          * Specify whether small styling to be applied to element.
+          * If `true`, the small styling will be applied to the checkbox group.
          */
         "small"?: boolean;
         /**
-          * Provide validation status - 'error'
+          * The validation status - e.g. 'error' | 'warning' | 'success'.
          */
         "validationStatus"?: IcInformationStatusOrEmpty;
         /**
-          * Provide validation text - 'error'
+          * The validation text - e.g. 'error' | 'warning' | 'success'.
          */
         "validationText"?: string;
     }
+    interface IcChip {
+        /**
+          * The emphasis of the chip.
+         */
+        "appearance"?: IcChipAppearance;
+        /**
+          * If `true`, the chip will appear disabled.
+         */
+        "disabled"?: boolean;
+        /**
+          * If `true`, the chip will have a close button at the end to dismiss it.
+         */
+        "dismissible"?: boolean;
+        /**
+          * The text rendered within the chip.
+         */
+        "label": string;
+        /**
+          * Is emitted when the user dismisses the chip.
+         */
+        "onDismiss"?: (event: IcChipCustomEvent<void>) => void;
+        /**
+          * The size of the chip.
+         */
+        "size"?: IcChipSizes;
+    }
     interface IcClassificationBanner {
         /**
-          * Additional information to display after the classification
+          * The additional information that will be displayed after the classification.
          */
         "additionalSelectors"?: string;
         /**
-          * The classification level to be displayed also determines the banner and text colour
+          * The classification level to be displayed - also determines the banner and text colour.
          */
         "classification"?: IcProtectiveMarkings;
         /**
-          * Optional text displayed before classification to specify relevant country/countries
+          * The optional text that will be displayed before classification to specify relevant country/countries.
          */
         "country"?: string;
         /**
-          * Determines whether the banner appears inline with the page or sticks to the bottom of the page
+          * If `true`, the banner will appear inline with the page, instead of sticking to the bottom of the page.
          */
         "inline"?: boolean;
         /**
-          * Optionally display "Up to" before classification and country if set
+          * If `true`, "Up to" will be displayed before the classification and country.
          */
         "upTo"?: boolean;
     }
     interface IcDataEntity {
         /**
-          * Title for the data entity
+          * The title for the data entity.
          */
         "heading"?: string;
         /**
-          * Set the data heading and all child data rows to small styling
+          * If `true`, the small styling will be applied to the data heading and all child data rows.
          */
         "small"?: boolean;
     }
     interface IcDataRow {
         /**
-          * Set the label in the leftmost cell of the row
+          * The label in the leftmost cell of the row.
          */
         "label"?: string;
         /**
-          * Set the row to small styling, this is automatically applied if small is set on the parent data heading
+          * If `true`, the small styling will be applied to the row. This is automatically applied if small is set on the parent data heading.
          */
         "small"?: boolean;
         /**
-          * Set the value of the middle (right if no addition supplied) cell of the row
+          * The value of the middle (right if no end-component supplied) cell of the row.
          */
         "value"?: string;
     }
@@ -2083,33 +2171,29 @@ declare namespace LocalJSX {
     }
     interface IcFooter {
         /**
-          * Sets the aligned parameter for the section containers used within the footer
+          * The alignment of the section containers used within the footer.
          */
         "aligned"?: IcAlignment;
         /**
-          * Sets the screen size breakpoint at which to switch to the small layout
+          * The screen size breakpoint at which to switch to the small layout.
          */
         "breakpoint"?: IcFooterBreakpoints;
         /**
-          * The caption displayed at the bottom of the footer
+          * The caption displayed at the bottom of the footer.
          */
         "caption"?: string;
         /**
-          * Whether the footer displays the crown copyright at the bottom
+          * If `true`, the footer will display the crown copyright at the bottom.
          */
         "copyright"?: boolean;
         /**
-          * The description displayed at the top of the footer
+          * The description displayed at the top of the footer.
          */
         "description"?: string;
         /**
-          * Sets the footer up to handle link groups instead of standalone links
+          * If `true`, the footer will be set up to handle link groups instead of standalone links.
          */
         "groupLinks"?: boolean;
-        /**
-          * Triggers on page resize and triggers style changes in footer links and link groups
-         */
-        "onIcFooterResized"?: (event: IcFooterCustomEvent<void>) => void;
     }
     interface IcFooterLink {
         /**
@@ -2119,155 +2203,155 @@ declare namespace LocalJSX {
     }
     interface IcFooterLinkGroup {
         /**
-          * Sets the title of the link group for display
+          * The title of the link group to be displayed.
          */
         "groupTitle": string;
     }
     interface IcHero {
         /**
-          * The alignment of the hero content
+          * The alignment of the hero.
          */
         "aligned"?: IcAlignment;
         /**
-          * Optional background image
+          * The optional background image.
          */
         "backgroundImage"?: string;
         /**
-          * The alignment of the hero content
+          * The alignment of the hero content.
          */
         "contentAligned"?: IcHeroContentAlignments;
         /**
-          * Whether the background image (if set) scrolls using a parallax effect.
+          * If `true`, the background image (if set) will not scroll using a parallax effect.
          */
         "disableBackgroundParallax"?: boolean;
         /**
-          * The heading of the hero
+          * The heading of the hero.
          */
         "heading": string;
         /**
-          * Optional secondary heading, replaced by slotted right content
+          * The optional secondary heading, replaced by slotted right content.
          */
         "secondaryHeading"?: string;
         /**
-          * Optional secondary subheading, replaced by slotted right content
+          * The optional secondary subheading, replaced by slotted right content.
          */
         "secondarySubheading"?: string;
         /**
-          * Alter styling for use with small content/pages
+          * If `true`, the small styling will be applied to the hero.
          */
         "small"?: boolean;
         /**
-          * Description for the hero
+          * The description for the hero.
          */
         "subheading"?: string;
     }
     interface IcInputComponentContainer {
         /**
-          * Determines whether the dark variant of the input-component-container focus indicator should be displayed.
+          * If `true`, the dark variant of the input component container will be displayed.
          */
         "dark"?: boolean;
         /**
-          * disabled
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * If true then fill width of container
+          * If `true`, the input component container will fill the width of the container it is in.
          */
         "fullWidth"?: boolean;
         /**
-          * multiLine
+          * If `true`, the input component container will allow for multiple lines.
          */
         "multiLine"?: boolean;
         /**
-          * readonly
+          * If `true`, the readonly state will be set.
          */
         "readonly"?: boolean;
         /**
-          * small
+          * If `true`, the small styling will be applied to the input component container.
          */
         "small"?: boolean;
         /**
-          * validationInline
+          * If `true`, the validation will display inline.
          */
         "validationInline"?: boolean;
         /**
-          * validationStatus
+          * The validation status of the input component container - e.g. 'error' | 'warning' | 'success'.
          */
         "validationStatus"?: IcInformationStatusOrEmpty;
     }
     interface IcInputContainer {
         /**
-          * disabled
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * readonly
+          * If `true`, the readonly state will be set.
          */
         "readonly"?: boolean;
     }
     interface IcInputLabel {
         /**
-          * dark
+          * If `true`, the dark variant of the input label will be displayed.
          */
         "dark"?: boolean;
         /**
-          * disabled
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * error
+          * If `true`, the input label will display with error styling.
          */
         "error"?: boolean;
         /**
-          * for
+          * The ID of the form element the label is bound to.
          */
         "for"?: string;
         /**
-          * helperText
+          * The helper text that will be displayed.
          */
         "helperText"?: string;
         /**
-          * label
+          * The text content of the label.
          */
         "label": string;
         /**
-          * readonly
+          * If `true`, the readonly state will be set.
          */
         "readonly"?: boolean;
         /**
-          * required
+          * If `true`, the input label will require a value.
          */
         "required"?: boolean;
     }
     interface IcInputValidation {
         /**
-          * aria live mode to apply to message
+          * The ARIA live mode to apply to the message.
          */
         "ariaLiveMode"?: IcAriaLiveModeVariants;
         /**
-          * The id of the input field the message relates to
+          * The ID of the form element the validation is bound to.
          */
         "for"?: string;
         /**
-          * If true then fill width of container
+          * If `true`, the input validation will fill the width of the container.
          */
         "fullWidth"?: boolean;
         /**
-          * The validation message to display
+          * The validation message to display.
          */
         "message": string;
         /**
-          * The status
+          * The status of the validation - e.g. 'error' | 'warning' | 'success'.
          */
         "status"?: IcInformationStatusOrEmpty;
     }
     interface IcLink {
         /**
-          * Determines the whether the appearance is dark, light, or the default.
+          * The appearance of the link, e.g. dark, light, or default.
          */
         "appearance"?: IcThemeForeground;
         /**
-          * Prompts the user to save the linked URL instead of navigating to it.
+          * If `true`, the user can save the linked URL instead of navigating to it.
          */
         "download"?: string | boolean;
         /**
@@ -2275,7 +2359,7 @@ declare namespace LocalJSX {
          */
         "href"?: string;
         /**
-          * Hints at the human language of the linked URL.
+          * The human language of the linked URL.
          */
         "hreflang"?: string;
         /**
@@ -2287,25 +2371,25 @@ declare namespace LocalJSX {
          */
         "rel"?: string;
         /**
-          * Determines whether the 'open in new tab/window' icon is to be displayed.
+          * If `true`, the 'open in new tab/window' icon will be displayed.
          */
         "showIcon"?: boolean;
         /**
-          * Where to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
+          * The place to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
          */
         "target"?: string;
     }
     interface IcLoadingIndicator {
         /**
-          * Determines whether the dark or light loading indicator should be displayed.
+          * The appearance of the loading indicator, e.g. dark or light.
          */
         "appearance"?: IcThemeForegroundNoDefault;
         /**
-          * Provide a description to be set as the aria-label of the loading indicator when not using a visible label.
+          * The description that will be set as the aria-label of the loading indicator when not using a visible label.
          */
         "description"?: string;
         /**
-          * When linear, determines whether the full-width version (i.e. without a border radius) should be displayed.
+          * If `true`, when linear, the full-width variant (i.e. without a border radius) will be displayed.
          */
         "fullWidth"?: boolean;
         /**
@@ -2343,47 +2427,43 @@ declare namespace LocalJSX {
          */
         "activationType"?: IcActivationTypes;
         /**
-          * Reference to an anchor element the menu will position itself from when rendered.
+          * The reference to an anchor element the menu will position itself from when rendered.
          */
         "anchorEl": HTMLElement;
         /**
-          * If true then fill width of container
+          * If `true`, the menu will fill the width of the container.
          */
         "fullWidth"?: boolean;
         /**
-          * Reference to the input element.
+          * The reference to the input element.
          */
         "inputEl": HTMLElement;
         /**
-          * Label for the input element.
+          * The label for the input element.
          */
         "inputLabel": string;
         /**
-          * Id of the menu.
+          * The ID of the menu.
          */
         "menuId": string;
         /**
           * Emitted when state of menu changes (i.e. open or close).
          */
-        "onMenuChange"?: (event: IcMenuCustomEvent<IcMenuChangeEventDetail>) => void;
-        /**
-          * Emitted when an option has been highlighted
-         */
-        "onMenuOptionId"?: (event: IcMenuCustomEvent<IcMenuOptionIdEventDetail>) => void;
+        "onIcMenuStateChange"?: (event: IcMenuCustomEvent<IcMenuChangeEventDetail>) => void;
         /**
           * Emitted when an option is selected.
          */
-        "onOptionSelect"?: (event: IcMenuCustomEvent<IcOptionSelectEventDetail>) => void;
+        "onIcOptionSelect"?: (event: IcMenuCustomEvent<IcOptionSelectEventDetail>) => void;
         /**
-          * Specify whether the menu is open.
+          * If `true`, the menu will be displayed open.
          */
         "open": boolean;
         /**
-          * Provide the possible selection options.
+          * The possible menu selection options.
          */
         "options": IcMenuOption[];
         /**
-          * Specify whether small styling is to be applied to the element.
+          * If `true`, the small styling will be applied to the menu.
          */
         "small"?: boolean;
         /**
@@ -2393,7 +2473,7 @@ declare namespace LocalJSX {
     }
     interface IcNavigationButton {
         /**
-          * Prompts the user to save the linked URL instead of navigating to it.
+          * If `true`, the user can save the linked URL instead of navigating to it.
          */
         "download"?: string | boolean;
         /**
@@ -2401,11 +2481,11 @@ declare namespace LocalJSX {
          */
         "href"?: string;
         /**
-          * Hints at the human language of the linked URL.
+          * The human language of the linked URL.
          */
         "hreflang"?: string;
         /**
-          * label info to display
+          * The label info to display.
          */
         "label": string;
         /**
@@ -2417,97 +2497,97 @@ declare namespace LocalJSX {
          */
         "rel"?: string;
         /**
-          * Where to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
+          * The place to display the linked URL, as the name for a browsing context (a tab, window, or iframe).
          */
         "target"?: string;
     }
     interface IcNavigationGroup {
         /**
-          * whether the group should be expandable/collapsible in the side menu
+          * If `true`, the group will be expandable in the side menu.
          */
         "expandable"?: boolean;
         /**
-          * label to display on the group
+          * The label to display on the group.
          */
         "label"?: string;
     }
     interface IcNavigationItem {
         /**
-          * Destination of the navigation item
+          * The destination of the navigation item.
          */
         "href"?: string;
         /**
-          * Label of the navigation item
+          * The label of the navigation item.
          */
         "label"?: string;
         /**
-          * If true, sets the navigation item in a selected state
+          * If `true`, the navigation item will be set in a selected state.
          */
         "selected"?: boolean;
     }
     interface IcNavigationMenu {
         /**
-          * Status info to display
+          * The status info to display.
          */
         "status"?: string;
         /**
-          * Version info to display
+          * The version info to display.
          */
         "version"?: string;
     }
     interface IcPageHeader {
         /**
-          * How the component should be aligned.
+          * The alignment of the page header.
          */
         "aligned"?: IcAlignment;
         /**
-          * Set whether the bottom border is used
+          * If `true`, a border will be displayed along the bottom of the page header.
          */
         "border"?: boolean;
         /**
-          * The title to render on the component.
+          * The title to render on the page header.
          */
         "heading"?: string;
         /**
-          * Set whether the reading pattern and tab order change in the action area for viewport widths of above 576px and when actions have not wrapped
+          * If `true`, the reading pattern and tab order will change in the action area for viewport widths of above 576px and when actions have not wrapped.
          */
         "reverseOrder"?: boolean;
         /**
-          * Whether the component uses small styling.
+          * If `true`, the small styling will be applied to the page header.
          */
         "small"?: boolean;
         /**
-          * Set whether the header is sticky at all breakpoints
+          * If `true`, the page header will be sticky at all breakpoints.
          */
         "sticky"?: boolean;
         /**
-          * Set whether the header is only sticky for viewport widths of 992px and above
+          * If `true`, the page header will only be sticky for viewport widths of 992px and above.
          */
         "stickyDesktopOnly"?: boolean;
         /**
-          * The subtitle to render on the component.
+          * The subtitle to render on the page header.
          */
         "subheading"?: string;
     }
     interface IcRadioGroup {
         /**
-          * Specify whether the input is disabled.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText"?: string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel"?: boolean;
         /**
-          * Provide a label for the input.
+          * The label for the radio group to be displayed.
          */
         "label": string;
         /**
-          * Provide a name for the input.
+          * The name for the radio group to differentiate from other groups.
          */
         "name": string;
         /**
@@ -2515,123 +2595,123 @@ declare namespace LocalJSX {
          */
         "onIcChange"?: (event: IcRadioGroupCustomEvent<IcValueEventDetail>) => void;
         /**
-          * Specify if the input requires a value.
+          * If `true`, the radio group will require a value.
          */
         "required"?: boolean;
         /**
-          * Specify whether small styling is to be applied to the element.
+          * If `true`, the small styling will be applied to the radio group.
          */
         "small"?: boolean;
         /**
-          * Provide validation status - 'error'
+          * The validation status - e.g. 'error' | 'warning' | 'success'.
          */
         "validationStatus"?: IcInformationStatusOrEmpty;
         /**
-          * Provide validation text - 'error'
+          * The validation text - e.g. 'error' | 'warning' | 'success'.
          */
         "validationText"?: string;
     }
     interface IcRadioOption {
         /**
-          * Determines type of additional text field in relation to radio option
+          * The style of additionalField that will be displayed if used.
          */
         "additionalFieldDisplay"?: IcAdditionalFieldTypes;
         /**
-          * Determines whether the radio should be in disabled state.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * Provide a text prop for the dynamic text.
+          * The text to be displayed when dynamic.
          */
         "dynamicText"?: string;
         /**
-          * Provide a group label for the input.
+          * The group label for the radio option.
          */
         "groupLabel"?: string;
         /**
-          * Provide a label for the input.
+          * The label for the radio option.
          */
         "label"?: string;
         /**
-          * Provide a name for the input.
+          * The name for the radio option.
          */
         "name"?: string;
         /**
-          * Emitted when radio is checked
+          * Emitted when a radio is selected.
          */
-        "onIcCheck"?: (event: IcRadioOptionCustomEvent<void>) => void;
+        "onIcCheck"?: (event: IcRadioOptionCustomEvent<IcValueEventDetail>) => void;
         /**
-          * Emitted when a radio is selected.
+          * @deprecated This event should not be used anymore. Use icCheck instead.
          */
         "onRadioOptionSelect"?: (event: IcRadioOptionCustomEvent<IcValueEventDetail>) => void;
         /**
-          * Determines whether the radio should be in selected state.
+          * If `true`, the radio option will be displayed in a selected state.
          */
         "selected"?: boolean;
         /**
-          * Provide a value for the input.
+          * The value for the radio option.
          */
         "value": string;
     }
     interface IcSearchBar {
         /**
-          * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user. Available options: "off", "none", "on", "sentences", "words", "characters".
+          * The automatic capitalisation of the text value as it is entered/edited by the user. Available options: "off", "none", "on", "sentences", "words", "characters".
          */
         "autocapitalize"?: string;
         /**
-          * Indicates whether the value of the control can be automatically completed by the browser.
+          * The state of autocompletion the browser can apply on the text value.
          */
         "autocomplete"?: IcAutocompleteTypes;
         /**
-          * Whether auto correction should be enabled when the user is entering/editing the text value.
+          * The state of autocorrection the browser can apply when the user is entering/editing the text value.
          */
         "autocorrect"?: IcAutocorrectStates;
         /**
-          * This Boolean attribute lets you specify that a form control should have input focus when the page loads.
+          * If `true`, the form control will have input focus when the page loads.
          */
         "autofocus"?: boolean;
         /**
-          * Number of characters until suggestions appear
+          * The number of characters until suggestions appear.
          */
         "charactersUntilSuggestion"?: number;
         /**
-          * Set the amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke.
+          * The amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke.
          */
         "debounce"?: number;
         /**
-          * Specify whether to disable the built in filtering. For example, if options will already be filtered from external source. If true, all options provided will be displayed.
+          * Specify whether to disable the built in filtering. For example, if options will already be filtered from external source. If `true`, all options provided will be displayed.
          */
         "disableFilter"?: boolean;
         /**
-          * Specify whether the input is disabled.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * Provide text for empty results list
+          * The text displayed when there are no options in the option list.
          */
         "emptyOptionListText"?: string;
         /**
-          * Specify whether the input should be focussed when component loaded.
+          * If `true`, the search bar will be focused when component loaded.
          */
         "focusOnLoad"?: boolean;
         /**
-          * Specify whether the component fills the full width of the container. If true, this overrides the --input-width css prop.
+          * Specify whether the search bar fills the full width of the container. If `true`, this overrides the --input-width CSS variable.
          */
         "fullWidth"?: boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText"?: string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel"?: boolean;
         /**
-          * Provide hint text for hidden assistive description element.
+          * The hint text for the hidden assistive description element.
          */
         "hintText"?: string;
         /**
-          * Provide a label for the input.
+          * The label for the search bar.
          */
         "label": string;
         /**
@@ -2651,11 +2731,11 @@ declare namespace LocalJSX {
          */
         "onIcInput"?: (event: IcSearchBarCustomEvent<IcValueEventDetail>) => void;
         /**
-          * Emitted when input loses focus.
+          * @deprecated This event should not be used anymore. Use icSearchBarBlur instead.
          */
         "onIcInputBlur"?: (event: IcSearchBarCustomEvent<IcSearchBarBlurEventDetail>) => void;
         /**
-          * Emitted when input gains focus.
+          * @deprecated This event should not be used anymore. Use icSearchBarFocus instead.
          */
         "onIcInputFocus"?: (event: IcSearchBarCustomEvent<IcValueEventDetail>) => void;
         /**
@@ -2679,79 +2759,79 @@ declare namespace LocalJSX {
          */
         "onIcSubmitSearch"?: (event: IcSearchBarCustomEvent<IcValueEventDetail>) => void;
         /**
-          * Provide the suggested search options
+          * The suggested search options.
          */
         "options"?: IcMenuOption[];
         /**
-          * Provide a placeholder value to display.
+          * The placeholder value to display.
          */
         "placeholder"?: string;
         /**
-          * Specify whether the input is read only.
+          * If `true`, the readonly state will be set.
          */
         "readonly"?: boolean;
         /**
-          * Specify if the input requires a value.
+          * If `true`, the search bar will require a value.
          */
         "required"?: boolean;
         /**
-          * Specify whether small styling is to be applied to the element.
+          * If `true`, the small styling will be applied to the search bar.
          */
         "small"?: boolean;
         /**
-          * If `true`, the element will have its spelling and grammar checked.
+          * If `true`, the value of the search will have its spelling and grammar checked.
          */
         "spellcheck"?: boolean;
         /**
-          * Value of Search input.
+          * The value of the search input.
          */
         "value"?: string;
     }
     interface IcSectionContainer {
         /**
-          * How the container should be aligned.
+          * The alignment of the container.
          */
         "aligned"?: IcAlignment;
         /**
-          * Removes the standard vertical padding from the container.
+          * If `true`, the standard vertical padding from the container will be removed.
          */
         "fullHeight"?: boolean;
     }
     interface IcSelect {
         /**
-          * Number of characters until suggestions appear for a searchable select.
+          * The number of characters until suggestions appear for a searchable select.
          */
         "charactersUntilSuggestions"?: number;
         /**
-          * Specify whether the input is disabled.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * Provide text for empty results list
+          * The text displayed when there are no options in the option list.
          */
         "emptyOptionListText"?: string;
         /**
-          * If true, then fill width of container.
+          * If `true`, the select element will fill the width of the container.
          */
         "fullWidth"?: boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText"?: string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel"?: boolean;
         /**
-          * If true, descriptions of options are included when filtering options in a searchable select.
+          * If `true`, descriptions of options will be included when filtering options in a searchable select.
          */
         "includeDescriptionsInSearch"?: boolean;
         /**
-          * If true, group titles of grouped options are included when filtering options in a searchable select.
+          * If `true`, group titles of grouped options will be included when filtering options in a searchable select.
          */
         "includeGroupTitlesInSearch"?: boolean;
         /**
-          * Provide a label for the input.
+          * The label for the select.
          */
         "label": string;
         /**
@@ -2771,19 +2851,19 @@ declare namespace LocalJSX {
          */
         "onIcFocus"?: (event: IcSelectCustomEvent<void>) => void;
         /**
-          * Provide the possible selection options.
+          * The possible selection options.
          */
         "options"?: IcMenuOption[];
         /**
-          * Provide a placeholder value to display.
+          * The placeholder value to be displayed.
          */
         "placeholder"?: string;
         /**
-          * Specify whether the input is read only.
+          * If `true`, the readonly state will be set.
          */
         "readonly"?: boolean;
         /**
-          * Specify if the input requires a value.
+          * If `true`, the select will require a value.
          */
         "required"?: boolean;
         /**
@@ -2791,23 +2871,23 @@ declare namespace LocalJSX {
          */
         "searchMatchPosition"?: IcSearchMatchPositions;
         /**
-          * If true, the select can be typed in to filter options.
+          * If `true`, a searchable variant of the select will be displayed which can be typed in to filter options.
          */
         "searchable"?: boolean;
         /**
-          * Display a button which clears the input when clicked. The button will always appear on the searchable select.
+          * If `true`, a button which clears the select input when clicked will be displayed. The button will always appear on the searchable select.
          */
         "showClearButton"?: boolean;
         /**
-          * Specify whether small styling is to be applied to the element.
+          * If `true`, the small styling will be applied to the select.
          */
         "small"?: boolean;
         /**
-          * Provide a validation status.
+          * The validation status - e.g. 'error' | 'warning' | 'success'.
          */
         "validationStatus"?: IcInformationStatusOrEmpty;
         /**
-          * Provide the text to display as the validation message.
+          * The text to display as the validation message.
          */
         "validationText"?: string;
         /**
@@ -2817,49 +2897,45 @@ declare namespace LocalJSX {
     }
     interface IcSideNavigation {
         /**
-          * Title to display.
+          * The title of the app to be displayed.
          */
         "appTitle": string;
         /**
-          * If true, the icon and label will appear when side navigation is collapsed
+          * If `true`, the icon and label will appear when side navigation is collapsed.
          */
         "collapsedIconLabels"?: boolean;
         /**
-          * If true, disable automatic parent wrapper styling
+          * If `true`, automatic parent wrapper styling will be disabled.
          */
         "disableAutoParentStyling"?: boolean;
         /**
-          * If true, the ic-side-navigation will load in an expanded state
+          * If `true`, the side navigation will load in an expanded state.
          */
         "expanded"?: boolean;
         /**
-          * Set application title link
+          * The URL that the app title link points to.
          */
         "href"?: string;
         /**
-          * If true, side navigation will be contained by parent element
-         */
-        "inline"?: boolean;
-        /**
-          * If true, the menu expand button is removed (PLEASE NOTE: This takes effect on screen sizes 992px and above)
+          * If `true`, the menu expand button will be removed (PLEASE NOTE: This takes effect on screen sizes 992px and above).
          */
         "static"?: boolean;
         /**
-          * Status of application
+          * The status of the app to be displayed.
          */
         "status"?: string;
         /**
-          * Version of application
+          * The version of the app to be displayed.
          */
         "version"?: string;
     }
     interface IcSkeleton {
         /**
-          * Set the skeleton to the light variant
+          * If `true`, the skeleton will be set to the light variant.
          */
         "light"?: boolean;
         /**
-          * The variant of the skeleton that will be displayed
+          * The variant of the skeleton that will be displayed.
          */
         "variant"?: IcSkeletonVariants;
     }
@@ -2873,7 +2949,7 @@ declare namespace LocalJSX {
          */
         "label": string;
         /**
-          * The size of the status tag.
+          * If `true`, the small styling will be applied to the status tag.
          */
         "small"?: boolean;
         /**
@@ -2883,47 +2959,59 @@ declare namespace LocalJSX {
     }
     interface IcStep {
         /**
-          * Additional information about step
+          * The status of the step. Use this prop to display a status message on the step if it is required or optional.
+         */
+        "stepStatus"?: IcStepStatuses;
+        /**
+          * Additional information about the step. Use this prop to override the default step status messaging displayed when selecting a step type or step status.
          */
         "stepSubtitle"?: string;
         /**
-          * Name of step
+          * The title of the step within the stepper.
          */
         "stepTitle"?: string;
         /**
-          * State of step
+          * The state of the step within the stepper.
          */
         "stepType"?: IcStepTypes;
     }
     interface IcStepper {
         /**
-          * How the stepper should be aligned in its container.
+          * The alignment of the default stepper within its container.
          */
         "aligned"?: IcStepperAlignment;
         /**
           * The length of the connnector between each step in pixels. Minimum length is 100px.
          */
         "connectorWidth"?: number;
+        /**
+          * If `true`, the information about each step, i.e. step title, step subtitle and step status, will be hidden on all default steps. The information about each step will still be visible in the compact variant of the stepper.
+         */
+        "hideStepInfo"?: boolean;
+        /**
+          * The variant of the stepper.
+         */
+        "variant"?: IcStepVariants;
     }
     interface IcSwitch {
         /**
-          * If true, the component is checked.
+          * If `true`, the switch will display as checked.
          */
         "checked"?: boolean;
         /**
-          * If true, the component is not interactive.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText"?: string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel"?: boolean;
         /**
-          * Applies an aria-label to the component, for when no visual 'name' is provided.
+          * The aria-label applied to the switch when no visual 'name' is provided.
          */
         "label": string;
         /**
@@ -2943,11 +3031,11 @@ declare namespace LocalJSX {
          */
         "onIcFocus"?: (event: IcSwitchCustomEvent<void>) => void;
         /**
-          * If true, the component will render the On/Off state text.
+          * If `true`, the switch will render the On/Off state text.
          */
         "showState"?: boolean;
         /**
-          * If true, the component reduces in size to the small state.
+          * If `true`, the small styling will be applied to the switch.
          */
         "small"?: boolean;
         /**
@@ -2957,13 +3045,9 @@ declare namespace LocalJSX {
     }
     interface IcTab {
         /**
-          * Disables the tab.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
-        /**
-          * Called when a tab is selected.
-         */
-        "onTabClick"?: (event: IcTabCustomEvent<IcTabClickEventDetail>) => void;
     }
     interface IcTabContext {
         /**
@@ -2971,81 +3055,85 @@ declare namespace LocalJSX {
          */
         "activationType"?: IcActivationTypes;
         /**
-          * Determines whether the light or dark variant of the tabs should be displayed.
+          * The appearance of the tab context, e.g dark, or light.
          */
         "appearance"?: IcThemeForegroundNoDefault;
         /**
-          * Provide a unique context if using multiple tabs inside one another i.e. rendering another set of tabs inside a tab panel.
+          * The unique context needed if using multiple tabs inside one another i.e. rendering another set of tabs inside a tab panel.
          */
         "contextId"?: string;
         /**
           * Emitted when a user selects a tab.
          */
+        "onIcTabSelect"?: (event: IcTabContextCustomEvent<IcTabSelectEventDetail>) => void;
+        /**
+          * @deprecated This event should not be used anymore. Use icTabSelect instead.
+         */
         "onTabSelect"?: (event: IcTabContextCustomEvent<IcTabSelectEventDetail>) => void;
         /**
-          * Allows the user to control the selected tab. Must be used alongside the tabSelect event to manage tab selection.
+          * The selected tab to be controlled by the user. Must be used alongside the icTabSelect event to manage tab selection.
          */
         "selectedTabIndex"?: number;
     }
     interface IcTabGroup {
         /**
-          * Provide a unique context if using multiple tabs inside one another i.e. rendering another set of tabs inside a tab panel.
+          * The unique context needed if using multiple tabs inside one another i.e. rendering another set of tabs inside a tab panel.
          */
         "contextId"?: string;
         /**
-          * Use when tabs and tab panels are to be positioned separately.
+          * If `true`, the tabs and tab panels will be positioned separately.
          */
         "inline"?: boolean;
         /**
-          * Provide a label to describe the purpose of the set of tabs to screen reader users.
+          * The label to describe the purpose of the set of tabs to screen reader users.
          */
         "label": string;
     }
     interface IcTabPanel {
         /**
-          * Provide a unique context if using multiple tabs inside one another i.e. rendering another tabs inside a tab panel.
+          * The unique context needed if using multiple tabs inside one another i.e. rendering another tabs inside a tab panel.
          */
         "contextId"?: string;
     }
     interface IcTextField {
         /**
-          * This Boolean attribute lets you specify that a form control should have input focus when the page loads.
+          * If `true`, the form control will have input focus when the page loads.
          */
         "autoFocus"?: boolean;
         /**
-          * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user. Available options: "off", "none", "on", "sentences", "words", "characters".
+          * The automatic capitalisation of the text value as it is entered/edited by the user. Available options: "off", "none", "on", "sentences", "words", "characters".
          */
         "autocapitalize"?: string;
         /**
-          * Indicates whether the value of the control can be automatically completed by the browser.
+          * The state of autocompletion the browser can apply on the text value.
          */
         "autocomplete"?: IcAutocompleteTypes1;
         /**
-          * Whether auto correction should be enabled when the user is entering/editing the text value.
+          * The state of autocorrection the browser can apply when the user is entering/editing the text value.
          */
         "autocorrect"?: IcAutocorrectStates1;
         /**
-          * Set the amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke.
+          * The amount of time, in milliseconds, to wait to trigger the `icChange` event after each keystroke.
          */
         "debounce"?: number;
         /**
-          * Specify whether the input is disabled.
+          * If `true`, the disabled state will be set.
          */
         "disabled"?: boolean;
         /**
-          * Specify whether the component fills the full width of the container. If true, this overrides the --input-width css prop.
+          * Specify whether the text field fills the full width of the container. If `true`, this overrides the --input-width CSS variable.
          */
         "fullWidth"?: boolean;
         /**
-          * Provide helper text to display additional field guidance.
+          * The helper text that will be displayed for additional field guidance.
          */
         "helperText"?: string;
         /**
-          * Hides the label and applies the required label value as an aria-label.
+          * If `true`, the label will be hidden and the required label value will be applied as an aria-label.
          */
         "hideLabel"?: boolean;
         /**
-          * Provide an id for the input
+          * The ID for the input.
          */
         "inputId"?: string;
         /**
@@ -3053,11 +3141,11 @@ declare namespace LocalJSX {
          */
         "inputmode"?: IcTextFieldInputModes;
         /**
-          * Provide a label for the input.
+          * The label for the input.
          */
         "label": string;
         /**
-          * Maximum number of characters that can be entered in the field.
+          * The maximum number of characters that can be entered in the field.
          */
         "maxLength"?: number;
         /**
@@ -3085,31 +3173,31 @@ declare namespace LocalJSX {
          */
         "onIcKeydown"?: (event: IcTextFieldCustomEvent<{ event: KeyboardEvent }>) => void;
         /**
-          * Provide a placeholder value to display.
+          * The placeholder value to be displayed.
          */
         "placeholder"?: string;
         /**
-          * Specify whether the input is read only.
+          * If `true`, the read only state will be set.
          */
         "readonly"?: boolean;
         /**
-          * Specify if the input requires a value.
+          * If `true`, the input will require a value.
          */
         "required"?: boolean;
         /**
-          * Allow resizing of a multiline text area
+          * If `true`, the multiline text area will be resizeable.
          */
         "resize"?: boolean;
         /**
-          * Specify the number of rows to transform the text field into a text area with a specific height.
+          * The number of rows to transform the text field into a text area with a specific height.
          */
         "rows"?: number;
         /**
-          * Specify whether small styling is to be applied to the element.
+          * If `true`, the small styling will be applied to the text field.
          */
         "small"?: boolean;
         /**
-          * If `true`, the element will have its spelling and grammar checked.
+          * If `true`, the value of the text field will have its spelling and grammar checked.
          */
         "spellcheck"?: boolean;
         /**
@@ -3117,33 +3205,33 @@ declare namespace LocalJSX {
          */
         "type"?: IcTextFieldTypes;
         /**
-          * Show icon in input control - only applies when validationStatus ='success'
+          * If `true`, the icon in input control will be displayed - only applies when validationStatus ='success'.
          */
         "validationInline"?: boolean;
         /**
-          * Provide validation state - 'error' | 'warning' | 'success'
+          * The validation state - e.g. 'error' | 'warning' | 'success'.
          */
         "validationStatus"?: IcInformationStatusOrEmpty1;
         /**
-          * Provide validation state - 'error' | 'warning' | 'success'
+          * The validation state - e.g. 'error' | 'warning' | 'success'.
          */
         "validationText"?: string;
         /**
-          * Value of TextField.
+          * The value of the text field.
          */
         "value"?: string;
     }
     interface IcTheme {
         /**
-          * The theme colour. Can be a hex value eg "#ff0000" or RGB eg "rgb(255, 0, 0)"
+          * The theme colour. Can be a hex value e.g. "#ff0000", RGB e.g. "rgb(255, 0, 0)", or RGBA e.g. "rgba(255, 0, 0, 1)".
          */
         "color"?: string;
-        /**
-          * Emitted when the theme is changed.
-         */
-        "onIcThemeChange"?: (event: IcThemeCustomEvent<IcTheme>) => void;
     }
     interface IcTooltip {
+        /**
+          * If `true`, the tooltip will not be displayed on hover, it will require a click.
+         */
+        "disableHover"?: boolean;
         /**
           * The text to display on the tooltip.
          */
@@ -3159,33 +3247,33 @@ declare namespace LocalJSX {
     }
     interface IcTopNavigation {
         /**
-          * Title to display
+          * The app title to be displayed.
          */
         "appTitle": string;
         /**
-          * The alignment of the top nav content
+          * The alignment of the top navigation content.
          */
         "contentAligned"?: IcAlignment;
         /**
-          * The url to navigate to when title is clicked
+          * The URL to navigate to when the app title is clicked.
          */
         "href"?: string;
         /**
-          * If true, the flyout navigation menu on small devices will be contained by the parent element
+          * If `true`, the flyout navigation menu on small devices will be contained by the parent element.
          */
         "inline"?: boolean;
         /**
-          * Status info to display
+          * The status info to be displayed.
          */
         "status"?: string;
         /**
-          * Version info to display
+          * The version info to be displayed.
          */
         "version"?: string;
     }
     interface IcTypography {
         /**
-          * Adds appropriate margins to the top and bottom of the typography.
+          * If `true`, appropriate top and bottom margins will be applied to the typography.
          */
         "applyVerticalMargins"?: boolean;
         /**
@@ -3202,6 +3290,7 @@ declare namespace LocalJSX {
         "ic-card": IcCard;
         "ic-checkbox": IcCheckbox;
         "ic-checkbox-group": IcCheckboxGroup;
+        "ic-chip": IcChip;
         "ic-classification-banner": IcClassificationBanner;
         "ic-data-entity": IcDataEntity;
         "ic-data-row": IcDataRow;
@@ -3256,6 +3345,7 @@ declare module "@stencil/core" {
             "ic-card": LocalJSX.IcCard & JSXBase.HTMLAttributes<HTMLIcCardElement>;
             "ic-checkbox": LocalJSX.IcCheckbox & JSXBase.HTMLAttributes<HTMLIcCheckboxElement>;
             "ic-checkbox-group": LocalJSX.IcCheckboxGroup & JSXBase.HTMLAttributes<HTMLIcCheckboxGroupElement>;
+            "ic-chip": LocalJSX.IcChip & JSXBase.HTMLAttributes<HTMLIcChipElement>;
             "ic-classification-banner": LocalJSX.IcClassificationBanner & JSXBase.HTMLAttributes<HTMLIcClassificationBannerElement>;
             "ic-data-entity": LocalJSX.IcDataEntity & JSXBase.HTMLAttributes<HTMLIcDataEntityElement>;
             "ic-data-row": LocalJSX.IcDataRow & JSXBase.HTMLAttributes<HTMLIcDataRowElement>;