@momentum-design/components 0.129.12 → 0.129.14

package/dist/components/appheader/appheader.component.d.ts

@@ -1,23 +1,27 @@
 import { CSSResult } from 'lit';
 import { Component } from '../../models';
 /**
- * The `mdc-appheader` component provides a structured and accessible app header layout.
- * It consists of three primary sections: leading, center, and trailing.
+ * The `mdc-appheader` component provides a structured and accessible app header layout with three sections: leading, center, and trailing.
  *
- * - The **leading section** typically holds a **brand logo**, **brand name** or **menu icon**.
- * - The **center section** can contain a **search bar**, **icons** or action controls.
- * - The **trailing section** generally includes a **profile avatar**, **additional icons** or **action controls**.
+ * ## Layout sections
+ * - **Leading** - Typically holds brand logo, brand name, or menu icon
+ * - **Center** - Can contain search bar, icons, navigation links, or action controls
+ * - **Trailing** - Generally includes profile avatar, icons, settings, or additional action controls
+ *
+ * Each section automatically handles flex alignment: leading aligns left, center aligns center, trailing aligns right.
  *
  * @tagname mdc-appheader
  *
- * @slot leading - Slot for the leading section (e.g., brand logo, brand name).
- * @slot center - Slot for the center section (e.g., search bar, icons).
- * @slot trailing - Slot for the trailing section (e.g., profile avatar, icons).
+ * @slot leading - Content for the leading section (left-aligned).
+ * @slot center - Content for the center section (center-aligned).
+ * @slot trailing - Content for the trailing section (right-aligned).
+ *
+ * @cssproperty --mdc-appheader-height - Height of the app header. Default is 4rem (64px).
  *
- * @csspart container - The main container for styling the header.
- * @csspart leading-section - The leading section of the header.
- * @csspart center-section - The center section of the header.
- * @csspart trailing-section - The trailing section of the header.
+ * @csspart container - The main header container.
+ * @csspart leading-section - The leading section wrapper (left side).
+ * @csspart center-section - The center section wrapper (middle).
+ * @csspart trailing-section - The trailing section wrapper (right side).
  */
 declare class Appheader extends Component {
     /**

package/dist/components/appheader/appheader.component.js

@@ -2,23 +2,27 @@ import { html } from 'lit';
 import { Component } from '../../models';
 import styles from './appheader.styles';
 /**
- * The `mdc-appheader` component provides a structured and accessible app header layout.
- * It consists of three primary sections: leading, center, and trailing.
+ * The `mdc-appheader` component provides a structured and accessible app header layout with three sections: leading, center, and trailing.
  *
- * - The **leading section** typically holds a **brand logo**, **brand name** or **menu icon**.
- * - The **center section** can contain a **search bar**, **icons** or action controls.
- * - The **trailing section** generally includes a **profile avatar**, **additional icons** or **action controls**.
+ * ## Layout sections
+ * - **Leading** - Typically holds brand logo, brand name, or menu icon
+ * - **Center** - Can contain search bar, icons, navigation links, or action controls
+ * - **Trailing** - Generally includes profile avatar, icons, settings, or additional action controls
+ *
+ * Each section automatically handles flex alignment: leading aligns left, center aligns center, trailing aligns right.
  *
  * @tagname mdc-appheader
  *
- * @slot leading - Slot for the leading section (e.g., brand logo, brand name).
- * @slot center - Slot for the center section (e.g., search bar, icons).
- * @slot trailing - Slot for the trailing section (e.g., profile avatar, icons).
+ * @slot leading - Content for the leading section (left-aligned).
+ * @slot center - Content for the center section (center-aligned).
+ * @slot trailing - Content for the trailing section (right-aligned).
+ *
+ * @cssproperty --mdc-appheader-height - Height of the app header. Default is 4rem (64px).
  *
- * @csspart container - The main container for styling the header.
- * @csspart leading-section - The leading section of the header.
- * @csspart center-section - The center section of the header.
- * @csspart trailing-section - The trailing section of the header.
+ * @csspart container - The main header container.
+ * @csspart leading-section - The leading section wrapper (left side).
+ * @csspart center-section - The center section wrapper (middle).
+ * @csspart trailing-section - The trailing section wrapper (right side).
  */
 class Appheader extends Component {
     /**

package/dist/components/avatar/avatar.component.d.ts

@@ -3,24 +3,31 @@ import { CSSResult } from 'lit';
 import { Component } from '../../models';
 declare const Avatar_base: import("../../utils/mixins/index.types").Constructor<import("../../utils/mixins/AvatarComponentMixin").AvatarComponentMixinInterface> & import("../../utils/mixins/index.types").Constructor<import("../../utils/mixins/IconNameMixin").IconNameMixinInterface> & typeof Component;
 /**
- * The `mdc-avatar` component is used to represent a person or a space.
- * An avatar can be an icon, initials, counter and photo.
+ * The `mdc-avatar` component represents a person or a space. It displays as a photo, initials, icon, or counter.
  *
- * To set the photo of an avatar,
- * you need to set "src" attribute.
+ * ## Display Priority
  *
- * While the avatar image is loading, as a placeholder,
- * we will show the initials text.
- * If the initials are not specified then,
- * we will show `user-regular` icon as a placeholder.
+ * When multiple attributes are provided, the component determines what to display based on this priority:
+ * 1. **Photo** (`src`) - Takes highest priority
+ *    - While loading: Shows `initials` as placeholder if provided (instant), otherwise shows icon (requires loading)
+ *    - After loading: Shows the photo
+ *    - On error: Placeholder remains visible (initials or icon)
+ * 2. **Icon** (`icon-name`) - Takes priority if no `src` is provided
+ *    - Shows custom icon if `icon-name` is set (requires icon library to load)
+ *    - **Note:** If both `icon-name` and `initials` are provided (without `src`), icon takes precedence and initials are ignored.
+ *      This means users may see a delay while the icon loads, even though initials render instantly.
+ *    - Defaults to `user-regular` icon if no other content is available
+ * 3. **Initials** (`initials`) - Displayed only if no `src` or `icon-name` is provided
+ *    - Shows first two characters, converted to uppercase
+ *    - Renders instantly (no loading required)
+ * 4. **Counter** (`counter`) - Displayed only if none of the above are provided
+ *    - Shows numeric value (max 99+)
+ *    - Negative values display as 0
  *
- * By default, if there are no attributes specified,
- * then the default avatar will be an icon with `user-regular` name.
- *
- * The avatar component is non clickable and non interactive/focusable component.
- * If the avatar is typing, then the loading indicator will be displayed.
- * If the counter type avatar is set to a negative number, then we will display 0.
- * The presence indicator will be hidden when the counter property is set.
+ * ## Behavior
+ * - Non-interactive and non-focusable component (use `mdc-avatarbutton` for clickable avatars)
+ * - Shows loading indicator overlay when `is-typing` is true (displays on top of existing content)
+ * - Presence indicator hidden when counter is set or when typing
  *
  * @dependency mdc-icon
  * @dependency mdc-presence

package/dist/components/avatar/avatar.component.js

@@ -17,24 +17,31 @@ import { AVATAR_TYPE, DEFAULTS, MAX_COUNTER } from './avatar.constants';
 import styles from './avatar.styles';
 import { getAvatarIconSize, getAvatarTextFontSize, getPresenceSize } from './avatar.utils';
 /**
- * The `mdc-avatar` component is used to represent a person or a space.
- * An avatar can be an icon, initials, counter and photo.
+ * The `mdc-avatar` component represents a person or a space. It displays as a photo, initials, icon, or counter.
  *
- * To set the photo of an avatar,
- * you need to set "src" attribute.
+ * ## Display Priority
  *
- * While the avatar image is loading, as a placeholder,
- * we will show the initials text.
- * If the initials are not specified then,
- * we will show `user-regular` icon as a placeholder.
+ * When multiple attributes are provided, the component determines what to display based on this priority:
+ * 1. **Photo** (`src`) - Takes highest priority
+ *    - While loading: Shows `initials` as placeholder if provided (instant), otherwise shows icon (requires loading)
+ *    - After loading: Shows the photo
+ *    - On error: Placeholder remains visible (initials or icon)
+ * 2. **Icon** (`icon-name`) - Takes priority if no `src` is provided
+ *    - Shows custom icon if `icon-name` is set (requires icon library to load)
+ *    - **Note:** If both `icon-name` and `initials` are provided (without `src`), icon takes precedence and initials are ignored.
+ *      This means users may see a delay while the icon loads, even though initials render instantly.
+ *    - Defaults to `user-regular` icon if no other content is available
+ * 3. **Initials** (`initials`) - Displayed only if no `src` or `icon-name` is provided
+ *    - Shows first two characters, converted to uppercase
+ *    - Renders instantly (no loading required)
+ * 4. **Counter** (`counter`) - Displayed only if none of the above are provided
+ *    - Shows numeric value (max 99+)
+ *    - Negative values display as 0
  *
- * By default, if there are no attributes specified,
- * then the default avatar will be an icon with `user-regular` name.
- *
- * The avatar component is non clickable and non interactive/focusable component.
- * If the avatar is typing, then the loading indicator will be displayed.
- * If the counter type avatar is set to a negative number, then we will display 0.
- * The presence indicator will be hidden when the counter property is set.
+ * ## Behavior
+ * - Non-interactive and non-focusable component (use `mdc-avatarbutton` for clickable avatars)
+ * - Shows loading indicator overlay when `is-typing` is true (displays on top of existing content)
+ * - Presence indicator hidden when counter is set or when typing
  *
  * @dependency mdc-icon
  * @dependency mdc-presence

package/dist/components/avatarbutton/avatarbutton.component.d.ts

@@ -3,25 +3,27 @@ import { CSSResult } from 'lit';
 import Buttonsimple from '../buttonsimple/buttonsimple.component';
 declare const AvatarButton_base: import("../../utils/mixins/index.types").Constructor<import("../../utils/mixins/AvatarComponentMixin").AvatarComponentMixinInterface> & import("../../utils/mixins/index.types").Constructor<import("../../utils/mixins/IconNameMixin").IconNameMixinInterface> & typeof Buttonsimple;
 /**
- * The `mdc-avatarbutton` component is an interactable version of the `mdc-avatar` component.
+ * The `mdc-avatarbutton` component is an interactive, clickable version of `mdc-avatar`.
+ * It wraps the avatar component in a button, making it focusable and actionable.
  *
- * This component is made by extending `buttonsimple` class.
- * The button component acts as a wrapper for the avatar component.
+ * This component extends `buttonsimple` and includes all avatar display features (photo, initials, icon, counter, presence).
+ * Use CSS parts to customize the avatar's appearance inside the button.
  *
- * To override styles of the avatar inside, use the specified css parts.
+ * ## Accessibility
+ * - Always provide an `aria-label` attribute to describe the button's purpose
  *
  * @dependency mdc-avatar
  *
- * @event click - (React: onClick) This event is dispatched when the avatarbutton is clicked.
- * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the avatarbutton.
- * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the avatarbutton.
- * @event focus - (React: onFocus) This event is dispatched when the avatarbutton receives focus.
+ * @event click - (React: onClick) Dispatched when the avatar button is clicked.
+ * @event keydown - (React: onKeyDown) Dispatched when a key is pressed on the avatar button.
+ * @event keyup - (React: onKeyUp) Dispatched when a key is released on the avatar button.
+ * @event focus - (React: onFocus) Dispatched when the avatar button receives focus.
  *
  * @tagname mdc-avatarbutton
  *
- * @cssproperty --mdc-avatarbutton-overlay-background-color-rest - Background color of the overlay in rest state
- * @cssproperty --mdc-avatarbutton-overlay-background-color-hover - Background color of the overlay in hover state
- * @cssproperty --mdc-avatarbutton-overlay-background-color-active - Background color of the overlay in active state
+ * @cssproperty --mdc-avatarbutton-overlay-background-color-rest - Background color of the overlay in rest state.
+ * @cssproperty --mdc-avatarbutton-overlay-background-color-hover - Background color of the overlay in hover state.
+ * @cssproperty --mdc-avatarbutton-overlay-background-color-active - Background color of the overlay in active state.
  *
  * @csspart overlay - The overlay part of the avatar button.
  * @csspart content - The main content of the avatar.

package/dist/components/avatarbutton/avatarbutton.component.js

@@ -18,25 +18,27 @@ import { DEFAULTS as BUTTON_DEFAULTS } from '../button/button.constants';
 import Buttonsimple from '../buttonsimple/buttonsimple.component';
 import styles from './avatarbutton.styles';
 /**
- * The `mdc-avatarbutton` component is an interactable version of the `mdc-avatar` component.
+ * The `mdc-avatarbutton` component is an interactive, clickable version of `mdc-avatar`.
+ * It wraps the avatar component in a button, making it focusable and actionable.
  *
- * This component is made by extending `buttonsimple` class.
- * The button component acts as a wrapper for the avatar component.
+ * This component extends `buttonsimple` and includes all avatar display features (photo, initials, icon, counter, presence).
+ * Use CSS parts to customize the avatar's appearance inside the button.
  *
- * To override styles of the avatar inside, use the specified css parts.
+ * ## Accessibility
+ * - Always provide an `aria-label` attribute to describe the button's purpose
  *
  * @dependency mdc-avatar
  *
- * @event click - (React: onClick) This event is dispatched when the avatarbutton is clicked.
- * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the avatarbutton.
- * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the avatarbutton.
- * @event focus - (React: onFocus) This event is dispatched when the avatarbutton receives focus.
+ * @event click - (React: onClick) Dispatched when the avatar button is clicked.
+ * @event keydown - (React: onKeyDown) Dispatched when a key is pressed on the avatar button.
+ * @event keyup - (React: onKeyUp) Dispatched when a key is released on the avatar button.
+ * @event focus - (React: onFocus) Dispatched when the avatar button receives focus.
  *
  * @tagname mdc-avatarbutton
  *
- * @cssproperty --mdc-avatarbutton-overlay-background-color-rest - Background color of the overlay in rest state
- * @cssproperty --mdc-avatarbutton-overlay-background-color-hover - Background color of the overlay in hover state
- * @cssproperty --mdc-avatarbutton-overlay-background-color-active - Background color of the overlay in active state
+ * @cssproperty --mdc-avatarbutton-overlay-background-color-rest - Background color of the overlay in rest state.
+ * @cssproperty --mdc-avatarbutton-overlay-background-color-hover - Background color of the overlay in hover state.
+ * @cssproperty --mdc-avatarbutton-overlay-background-color-active - Background color of the overlay in active state.
  *
  * @csspart overlay - The overlay part of the avatar button.
  * @csspart content - The main content of the avatar.

package/dist/components/buttonlink/buttonlink.component.d.ts

@@ -5,18 +5,20 @@ declare const ButtonLink_base: import("../../utils/mixins/index.types").Construc
 /**
  * `mdc-buttonlink` combines the functional behavior of `mdc-linksimple` with the visual and structural
  * features of `mdc-button`. This includes support for variants, sizing, and optional
- * prefix and postfix icons via slots.
+ * prefix and postfix icons.
  *
  * ### Features:
- * - Behaves like an link while visually resembling a button.
- * - Supports slots for `prefix-icon` and `postfix-icon`.
+ * - Behaves like a link while visually resembling a button.
  * - Customizable size, color, and variant through attributes.
+ * - Supports prefix and postfix icons.
  * - Inherits accessibility and keyboard interaction support from `mdc-linksimple`.
  *
  * @dependency mdc-icon
  *
  * @tagname mdc-buttonlink
  *
+ * @slot default - The default slot for buttonlink text content.
+ *
  * @event click - (React: onClick) Fired when the user activates the buttonLink using a mouse or assistive technology.
  * @event keydown - (React: onKeyDown) Fired when the user presses a key while the buttonLink has focus.
  * @event focus - (React: onFocus) Fired when the buttonLink receives keyboard or mouse focus.
@@ -27,20 +29,20 @@ declare const ButtonLink_base: import("../../utils/mixins/index.types").Construc
  * @csspart button-text - The slot containing the buttonlink text.
  * @csspart postfix-icon - The postfix icon element.
  *
- * @cssproperty --mdc-button-height - Height for button size
- * @cssproperty --mdc-button-background - Background color of the button
- * @cssproperty --mdc-button-border-color - Borer color of the button
- * @cssproperty --mdc-button-text-color - Text color of the button
- * @cssproperty --mdc-button-line-height - Line height of the button text
+ * @cssproperty --mdc-button-height - Height of the buttonlink
+ * @cssproperty --mdc-button-background - Background color of the buttonlink
+ * @cssproperty --mdc-button-border-color - Border color of the buttonlink
+ * @cssproperty --mdc-button-text-color - Text color of the buttonlink
+ * @cssproperty --mdc-button-line-height - Line height of the buttonlink text
  * @cssproperty --mdc-button-prefix-icon-size - Size of the prefix icon
  * @cssproperty --mdc-button-postfix-icon-size - Size of the postfix icon
  */
 declare class ButtonLink extends ButtonLink_base {
     /**
-     * ButtonLink sizing is based on the buttonlink type.
-     * - **Pill buttonlink**: 40, 32, 28, 24.
-     * - **Icon buttonlink**: 64, 52, 40, 32, 28, 24.
-     * - Tertiary icon buttonlink can also be 20.
+     * Size of the buttonlink, determined by its type.
+     * - **Pill buttonlink**: 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)
+     * - **Icon buttonlink**: 64 (4rem), 52 (3.25rem), 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)
+     * - **Tertiary icon buttonlink** can also use: 20 (1.25rem)
      * @default 32
      */
     size: PillButtonSize | IconButtonSize;

package/dist/components/buttonlink/buttonlink.component.js

@@ -17,18 +17,20 @@ import styles from './buttonlink.styles';
 /**
  * `mdc-buttonlink` combines the functional behavior of `mdc-linksimple` with the visual and structural
  * features of `mdc-button`. This includes support for variants, sizing, and optional
- * prefix and postfix icons via slots.
+ * prefix and postfix icons.
  *
  * ### Features:
- * - Behaves like an link while visually resembling a button.
- * - Supports slots for `prefix-icon` and `postfix-icon`.
+ * - Behaves like a link while visually resembling a button.
  * - Customizable size, color, and variant through attributes.
+ * - Supports prefix and postfix icons.
  * - Inherits accessibility and keyboard interaction support from `mdc-linksimple`.
  *
  * @dependency mdc-icon
  *
  * @tagname mdc-buttonlink
  *
+ * @slot default - The default slot for buttonlink text content.
+ *
  * @event click - (React: onClick) Fired when the user activates the buttonLink using a mouse or assistive technology.
  * @event keydown - (React: onKeyDown) Fired when the user presses a key while the buttonLink has focus.
  * @event focus - (React: onFocus) Fired when the buttonLink receives keyboard or mouse focus.
@@ -39,11 +41,11 @@ import styles from './buttonlink.styles';
  * @csspart button-text - The slot containing the buttonlink text.
  * @csspart postfix-icon - The postfix icon element.
  *
- * @cssproperty --mdc-button-height - Height for button size
- * @cssproperty --mdc-button-background - Background color of the button
- * @cssproperty --mdc-button-border-color - Borer color of the button
- * @cssproperty --mdc-button-text-color - Text color of the button
- * @cssproperty --mdc-button-line-height - Line height of the button text
+ * @cssproperty --mdc-button-height - Height of the buttonlink
+ * @cssproperty --mdc-button-background - Background color of the buttonlink
+ * @cssproperty --mdc-button-border-color - Border color of the buttonlink
+ * @cssproperty --mdc-button-text-color - Text color of the buttonlink
+ * @cssproperty --mdc-button-line-height - Line height of the buttonlink text
  * @cssproperty --mdc-button-prefix-icon-size - Size of the prefix icon
  * @cssproperty --mdc-button-postfix-icon-size - Size of the postfix icon
  */
@@ -51,10 +53,10 @@ class ButtonLink extends ButtonComponentMixin(Linksimple) {
     constructor() {
         super(...arguments);
         /**
-         * ButtonLink sizing is based on the buttonlink type.
-         * - **Pill buttonlink**: 40, 32, 28, 24.
-         * - **Icon buttonlink**: 64, 52, 40, 32, 28, 24.
-         * - Tertiary icon buttonlink can also be 20.
+         * Size of the buttonlink, determined by its type.
+         * - **Pill buttonlink**: 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)
+         * - **Icon buttonlink**: 64 (4rem), 52 (3.25rem), 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)
+         * - **Tertiary icon buttonlink** can also use: 20 (1.25rem)
          * @default 32
          */
         this.size = DEFAULTS.SIZE;

package/dist/components/linkbutton/linkbutton.component.d.ts

@@ -20,6 +20,7 @@ declare const LinkButton_base: import("../../utils/mixins/index.types").Construc
  * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the linkbutton.
  * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the linkbutton.
  * @event focus - (React: onFocus) This event is dispatched when the linkbutton receives focus.
+ * @event blur - (React: onBlur) This event is dispatched when the linkbutton loses focus.
  *
  * @cssproperty --mdc-link-border-radius - Border radius of the linkbutton.
  * @cssproperty --mdc-link-color-active - Color of the linkbutton’s child content in the active state.
@@ -34,21 +35,24 @@ declare const LinkButton_base: import("../../utils/mixins/index.types").Construc
  */
 declare class LinkButton extends LinkButton_base {
     /**
-     * Sets the size of the linkbutton.
-     * Acceptable values:
-     * - 12
-     * - 14
-     * - 16
+     * Size of the linkbutton text and icon.
+     * - **12**: 0.75rem font size
+     * - **14**: 0.875rem font size
+     * - **16**: 1rem font size (default)
      * @default 16
      */
     size: LinkButtonSize;
     /**
-     * The linkbutton can be inline or standalone.
+     * Display mode of the linkbutton.
+     * - `false`: Standalone display (default)
+     * - `true`: Inline display within text flow
      * @default false
      */
     inline: boolean;
     /**
-     * The linkbutton color can be inverted by setting the inverted attribute to true.
+     * Color scheme of the linkbutton.
+     * - `false`: Normal color scheme for light backgrounds (default)
+     * - `true`: Inverted color scheme for dark backgrounds
      * @default false
      */
     inverted: boolean;
@@ -58,6 +62,7 @@ declare class LinkButton extends LinkButton_base {
      * Sets the `size` attribute for the linkbutton, falling back to the default if the value is invalid.
      *
      * @param size - The desired link size.
+     * @internal
      */
     private setSize;
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/linkbutton/linkbutton.component.js

@@ -33,6 +33,7 @@ import styles from './linkbutton.styles';
  * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the linkbutton.
  * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the linkbutton.
  * @event focus - (React: onFocus) This event is dispatched when the linkbutton receives focus.
+ * @event blur - (React: onBlur) This event is dispatched when the linkbutton loses focus.
  *
  * @cssproperty --mdc-link-border-radius - Border radius of the linkbutton.
  * @cssproperty --mdc-link-color-active - Color of the linkbutton’s child content in the active state.
@@ -49,21 +50,24 @@ class LinkButton extends IconNameMixin(Buttonsimple) {
     constructor() {
         super(...arguments);
         /**
-         * Sets the size of the linkbutton.
-         * Acceptable values:
-         * - 12
-         * - 14
-         * - 16
+         * Size of the linkbutton text and icon.
+         * - **12**: 0.75rem font size
+         * - **14**: 0.875rem font size
+         * - **16**: 1rem font size (default)
          * @default 16
          */
         this.size = DEFAULTS.SIZE;
         /**
-         * The linkbutton can be inline or standalone.
+         * Display mode of the linkbutton.
+         * - `false`: Standalone display (default)
+         * - `true`: Inline display within text flow
          * @default false
          */
         this.inline = DEFAULTS.INLINE;
         /**
-         * The linkbutton color can be inverted by setting the inverted attribute to true.
+         * Color scheme of the linkbutton.
+         * - `false`: Normal color scheme for light backgrounds (default)
+         * - `true`: Inverted color scheme for dark backgrounds
          * @default false
          */
         this.inverted = DEFAULTS.INVERTED;
@@ -83,6 +87,7 @@ class LinkButton extends IconNameMixin(Buttonsimple) {
      * Sets the `size` attribute for the linkbutton, falling back to the default if the value is invalid.
      *
      * @param size - The desired link size.
+     * @internal
      */
     setSize(size) {
         this.setAttribute('size', Object.values(LINKBUTTON_SIZES).includes(size) ? `${size}` : DEFAULTS.SIZE.toString());

package/dist/components/linksimple/linksimple.component.d.ts

@@ -54,6 +54,12 @@ declare class Linksimple extends Linksimple_base {
     rel?: string;
     /**
      * Optional download attribute to instruct browsers to download the linked resource.
+     *
+     * Valid values:
+     * - empty string: browser suggests a name for the downloaded file
+     * - string: name of the downloaded file
+     *
+     * More details in the [Anchor element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download) docs.
      */
     download?: string;
     /**