@momentum-design/components 0.129.11 → 0.129.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- import type { CSSResult } from 'lit';
1
+ import type { CSSResult, TemplateResult } from 'lit';
2
2
  import { Component } from '../../models';
3
3
  import type { BannerVariant } from './banner.types';
4
4
  /**
@@ -51,7 +51,7 @@ declare class Banner extends Component {
51
51
  /**
52
52
  * Banner label text
53
53
  */
54
- label: string;
54
+ label?: string;
55
55
  /**
56
56
  * Banner secondary label text
57
57
  *
@@ -74,7 +74,7 @@ declare class Banner extends Component {
74
74
  * @returns Template result containing label and optional secondary label elements
75
75
  */
76
76
  private getTextLabel;
77
- render(): import("lit-html").TemplateResult<1>;
77
+ render(): TemplateResult<1>;
78
78
  static styles: Array<CSSResult>;
79
79
  }
80
80
  export default Banner;
@@ -63,10 +63,6 @@ class Banner extends Component {
63
63
  * @default 'custom'
64
64
  */
65
65
  this.variant = DEFAULTS.VARIANT;
66
- /**
67
- * Banner label text
68
- */
69
- this.label = '';
70
66
  }
71
67
  /**
72
68
  * @internal
@@ -79,12 +75,7 @@ class Banner extends Component {
79
75
  if (!iconName)
80
76
  return nothing;
81
77
  return html `
82
- <mdc-icon
83
- name="${iconName}"
84
- size="${DEFAULTS.PREFIX_ICON_SIZE}"
85
- part="leading-icon"
86
- length-unit="rem"
87
- ></mdc-icon>
78
+ <mdc-icon name="${iconName}" size="${DEFAULTS.PREFIX_ICON_SIZE}" part="leading-icon" length-unit="rem"></mdc-icon>
88
79
  `;
89
80
  }
90
81
  /**
@@ -115,12 +106,11 @@ class Banner extends Component {
115
106
  `;
116
107
  }
117
108
  render() {
118
- var _a;
119
109
  return html `
120
110
  <slot name="content">
121
111
  <div part="leading">
122
112
  <slot name="leading-icon">
123
- ${this.variant !== DEFAULTS.VARIANT ? this.renderIcon((_a = getIconNameForVariant(this.variant)) !== null && _a !== void 0 ? _a : '') : nothing}
113
+ ${this.variant !== DEFAULTS.VARIANT ? this.renderIcon(getIconNameForVariant(this.variant)) : nothing}
124
114
  </slot>
125
115
  <slot name="leading-text">
126
116
  <div part="leading-text">${this.getTextLabel()}</div>
@@ -1,3 +1,4 @@
1
+ import type { IconNames } from '../icon/icon.types';
1
2
  declare const TAG_NAME: "mdc-banner";
2
3
  /**
3
4
  * Banner variants
@@ -13,10 +14,10 @@ declare const BANNER_VARIANT: {
13
14
  * Icon names for variants
14
15
  */
15
16
  declare const VARIANT_ICON_NAMES: {
16
- readonly INFORMATIONAL_ICON_NAME: "info-circle-bold";
17
- readonly SUCCESS_ICON_NAME: "check-circle-bold";
18
- readonly WARNING_ICON_NAME: "warning-bold";
19
- readonly ERROR_ICON_NAME: "error-legacy-bold";
17
+ readonly INFORMATIONAL_ICON_NAME: Extract<IconNames, "info-circle-bold">;
18
+ readonly SUCCESS_ICON_NAME: Extract<IconNames, "check-circle-bold">;
19
+ readonly WARNING_ICON_NAME: Extract<IconNames, "warning-bold">;
20
+ readonly ERROR_ICON_NAME: Extract<IconNames, "error-legacy-bold">;
20
21
  };
21
22
  /**
22
23
  * Default values
@@ -25,4 +26,4 @@ declare const DEFAULTS: {
25
26
  readonly VARIANT: "custom";
26
27
  readonly PREFIX_ICON_SIZE: 1.25;
27
28
  };
28
- export { TAG_NAME, BANNER_VARIANT, DEFAULTS, VARIANT_ICON_NAMES };
29
+ export { BANNER_VARIANT, DEFAULTS, TAG_NAME, VARIANT_ICON_NAMES };
@@ -26,4 +26,4 @@ const DEFAULTS = {
26
26
  VARIANT: BANNER_VARIANT.CUSTOM,
27
27
  PREFIX_ICON_SIZE: 1.25,
28
28
  };
29
- export { TAG_NAME, BANNER_VARIANT, DEFAULTS, VARIANT_ICON_NAMES };
29
+ export { BANNER_VARIANT, DEFAULTS, TAG_NAME, VARIANT_ICON_NAMES };
@@ -1,3 +1,4 @@
1
+ import type { IconNames } from '../icon/icon.types';
1
2
  import type { BannerVariant } from './banner.types';
2
- declare const getIconNameForVariant: (variant: BannerVariant) => string | null;
3
+ declare const getIconNameForVariant: (variant: BannerVariant) => IconNames | null;
3
4
  export { getIconNameForVariant };
@@ -5,18 +5,20 @@ declare const ButtonLink_base: import("../../utils/mixins/index.types").Construc
5
5
  /**
6
6
  * `mdc-buttonlink` combines the functional behavior of `mdc-linksimple` with the visual and structural
7
7
  * features of `mdc-button`. This includes support for variants, sizing, and optional
8
- * prefix and postfix icons via slots.
8
+ * prefix and postfix icons.
9
9
  *
10
10
  * ### Features:
11
- * - Behaves like an link while visually resembling a button.
12
- * - Supports slots for `prefix-icon` and `postfix-icon`.
11
+ * - Behaves like a link while visually resembling a button.
13
12
  * - Customizable size, color, and variant through attributes.
13
+ * - Supports prefix and postfix icons.
14
14
  * - Inherits accessibility and keyboard interaction support from `mdc-linksimple`.
15
15
  *
16
16
  * @dependency mdc-icon
17
17
  *
18
18
  * @tagname mdc-buttonlink
19
19
  *
20
+ * @slot default - The default slot for buttonlink text content.
21
+ *
20
22
  * @event click - (React: onClick) Fired when the user activates the buttonLink using a mouse or assistive technology.
21
23
  * @event keydown - (React: onKeyDown) Fired when the user presses a key while the buttonLink has focus.
22
24
  * @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
27
29
  * @csspart button-text - The slot containing the buttonlink text.
28
30
  * @csspart postfix-icon - The postfix icon element.
29
31
  *
30
- * @cssproperty --mdc-button-height - Height for button size
31
- * @cssproperty --mdc-button-background - Background color of the button
32
- * @cssproperty --mdc-button-border-color - Borer color of the button
33
- * @cssproperty --mdc-button-text-color - Text color of the button
34
- * @cssproperty --mdc-button-line-height - Line height of the button text
32
+ * @cssproperty --mdc-button-height - Height of the buttonlink
33
+ * @cssproperty --mdc-button-background - Background color of the buttonlink
34
+ * @cssproperty --mdc-button-border-color - Border color of the buttonlink
35
+ * @cssproperty --mdc-button-text-color - Text color of the buttonlink
36
+ * @cssproperty --mdc-button-line-height - Line height of the buttonlink text
35
37
  * @cssproperty --mdc-button-prefix-icon-size - Size of the prefix icon
36
38
  * @cssproperty --mdc-button-postfix-icon-size - Size of the postfix icon
37
39
  */
38
40
  declare class ButtonLink extends ButtonLink_base {
39
41
  /**
40
- * ButtonLink sizing is based on the buttonlink type.
41
- * - **Pill buttonlink**: 40, 32, 28, 24.
42
- * - **Icon buttonlink**: 64, 52, 40, 32, 28, 24.
43
- * - Tertiary icon buttonlink can also be 20.
42
+ * Size of the buttonlink, determined by its type.
43
+ * - **Pill buttonlink**: 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)
44
+ * - **Icon buttonlink**: 64 (4rem), 52 (3.25rem), 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)
45
+ * - **Tertiary icon buttonlink** can also use: 20 (1.25rem)
44
46
  * @default 32
45
47
  */
46
48
  size: PillButtonSize | IconButtonSize;
@@ -17,18 +17,20 @@ import styles from './buttonlink.styles';
17
17
  /**
18
18
  * `mdc-buttonlink` combines the functional behavior of `mdc-linksimple` with the visual and structural
19
19
  * features of `mdc-button`. This includes support for variants, sizing, and optional
20
- * prefix and postfix icons via slots.
20
+ * prefix and postfix icons.
21
21
  *
22
22
  * ### Features:
23
- * - Behaves like an link while visually resembling a button.
24
- * - Supports slots for `prefix-icon` and `postfix-icon`.
23
+ * - Behaves like a link while visually resembling a button.
25
24
  * - Customizable size, color, and variant through attributes.
25
+ * - Supports prefix and postfix icons.
26
26
  * - Inherits accessibility and keyboard interaction support from `mdc-linksimple`.
27
27
  *
28
28
  * @dependency mdc-icon
29
29
  *
30
30
  * @tagname mdc-buttonlink
31
31
  *
32
+ * @slot default - The default slot for buttonlink text content.
33
+ *
32
34
  * @event click - (React: onClick) Fired when the user activates the buttonLink using a mouse or assistive technology.
33
35
  * @event keydown - (React: onKeyDown) Fired when the user presses a key while the buttonLink has focus.
34
36
  * @event focus - (React: onFocus) Fired when the buttonLink receives keyboard or mouse focus.
@@ -39,11 +41,11 @@ import styles from './buttonlink.styles';
39
41
  * @csspart button-text - The slot containing the buttonlink text.
40
42
  * @csspart postfix-icon - The postfix icon element.
41
43
  *
42
- * @cssproperty --mdc-button-height - Height for button size
43
- * @cssproperty --mdc-button-background - Background color of the button
44
- * @cssproperty --mdc-button-border-color - Borer color of the button
45
- * @cssproperty --mdc-button-text-color - Text color of the button
46
- * @cssproperty --mdc-button-line-height - Line height of the button text
44
+ * @cssproperty --mdc-button-height - Height of the buttonlink
45
+ * @cssproperty --mdc-button-background - Background color of the buttonlink
46
+ * @cssproperty --mdc-button-border-color - Border color of the buttonlink
47
+ * @cssproperty --mdc-button-text-color - Text color of the buttonlink
48
+ * @cssproperty --mdc-button-line-height - Line height of the buttonlink text
47
49
  * @cssproperty --mdc-button-prefix-icon-size - Size of the prefix icon
48
50
  * @cssproperty --mdc-button-postfix-icon-size - Size of the postfix icon
49
51
  */
@@ -51,10 +53,10 @@ class ButtonLink extends ButtonComponentMixin(Linksimple) {
51
53
  constructor() {
52
54
  super(...arguments);
53
55
  /**
54
- * ButtonLink sizing is based on the buttonlink type.
55
- * - **Pill buttonlink**: 40, 32, 28, 24.
56
- * - **Icon buttonlink**: 64, 52, 40, 32, 28, 24.
57
- * - Tertiary icon buttonlink can also be 20.
56
+ * Size of the buttonlink, determined by its type.
57
+ * - **Pill buttonlink**: 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)
58
+ * - **Icon buttonlink**: 64 (4rem), 52 (3.25rem), 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)
59
+ * - **Tertiary icon buttonlink** can also use: 20 (1.25rem)
58
60
  * @default 32
59
61
  */
60
62
  this.size = DEFAULTS.SIZE;
@@ -20,6 +20,7 @@ declare const LinkButton_base: import("../../utils/mixins/index.types").Construc
20
20
  * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the linkbutton.
21
21
  * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the linkbutton.
22
22
  * @event focus - (React: onFocus) This event is dispatched when the linkbutton receives focus.
23
+ * @event blur - (React: onBlur) This event is dispatched when the linkbutton loses focus.
23
24
  *
24
25
  * @cssproperty --mdc-link-border-radius - Border radius of the linkbutton.
25
26
  * @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
34
35
  */
35
36
  declare class LinkButton extends LinkButton_base {
36
37
  /**
37
- * Sets the size of the linkbutton.
38
- * Acceptable values:
39
- * - 12
40
- * - 14
41
- * - 16
38
+ * Size of the linkbutton text and icon.
39
+ * - **12**: 0.75rem font size
40
+ * - **14**: 0.875rem font size
41
+ * - **16**: 1rem font size (default)
42
42
  * @default 16
43
43
  */
44
44
  size: LinkButtonSize;
45
45
  /**
46
- * The linkbutton can be inline or standalone.
46
+ * Display mode of the linkbutton.
47
+ * - `false`: Standalone display (default)
48
+ * - `true`: Inline display within text flow
47
49
  * @default false
48
50
  */
49
51
  inline: boolean;
50
52
  /**
51
- * The linkbutton color can be inverted by setting the inverted attribute to true.
53
+ * Color scheme of the linkbutton.
54
+ * - `false`: Normal color scheme for light backgrounds (default)
55
+ * - `true`: Inverted color scheme for dark backgrounds
52
56
  * @default false
53
57
  */
54
58
  inverted: boolean;
@@ -58,6 +62,7 @@ declare class LinkButton extends LinkButton_base {
58
62
  * Sets the `size` attribute for the linkbutton, falling back to the default if the value is invalid.
59
63
  *
60
64
  * @param size - The desired link size.
65
+ * @internal
61
66
  */
62
67
  private setSize;
63
68
  render(): import("lit-html").TemplateResult<1>;
@@ -33,6 +33,7 @@ import styles from './linkbutton.styles';
33
33
  * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the linkbutton.
34
34
  * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the linkbutton.
35
35
  * @event focus - (React: onFocus) This event is dispatched when the linkbutton receives focus.
36
+ * @event blur - (React: onBlur) This event is dispatched when the linkbutton loses focus.
36
37
  *
37
38
  * @cssproperty --mdc-link-border-radius - Border radius of the linkbutton.
38
39
  * @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) {
49
50
  constructor() {
50
51
  super(...arguments);
51
52
  /**
52
- * Sets the size of the linkbutton.
53
- * Acceptable values:
54
- * - 12
55
- * - 14
56
- * - 16
53
+ * Size of the linkbutton text and icon.
54
+ * - **12**: 0.75rem font size
55
+ * - **14**: 0.875rem font size
56
+ * - **16**: 1rem font size (default)
57
57
  * @default 16
58
58
  */
59
59
  this.size = DEFAULTS.SIZE;
60
60
  /**
61
- * The linkbutton can be inline or standalone.
61
+ * Display mode of the linkbutton.
62
+ * - `false`: Standalone display (default)
63
+ * - `true`: Inline display within text flow
62
64
  * @default false
63
65
  */
64
66
  this.inline = DEFAULTS.INLINE;
65
67
  /**
66
- * The linkbutton color can be inverted by setting the inverted attribute to true.
68
+ * Color scheme of the linkbutton.
69
+ * - `false`: Normal color scheme for light backgrounds (default)
70
+ * - `true`: Inverted color scheme for dark backgrounds
67
71
  * @default false
68
72
  */
69
73
  this.inverted = DEFAULTS.INVERTED;
@@ -83,6 +87,7 @@ class LinkButton extends IconNameMixin(Buttonsimple) {
83
87
  * Sets the `size` attribute for the linkbutton, falling back to the default if the value is invalid.
84
88
  *
85
89
  * @param size - The desired link size.
90
+ * @internal
86
91
  */
87
92
  setSize(size) {
88
93
  this.setAttribute('size', Object.values(LINKBUTTON_SIZES).includes(size) ? `${size}` : DEFAULTS.SIZE.toString());
@@ -54,6 +54,12 @@ declare class Linksimple extends Linksimple_base {
54
54
  rel?: string;
55
55
  /**
56
56
  * Optional download attribute to instruct browsers to download the linked resource.
57
+ *
58
+ * Valid values:
59
+ * - empty string: browser suggests a name for the downloaded file
60
+ * - string: name of the downloaded file
61
+ *
62
+ * More details in the [Anchor element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download) docs.
57
63
  */
58
64
  download?: string;
59
65
  /**
@@ -4797,9 +4797,8 @@
4797
4797
  "kind": "field",
4798
4798
  "name": "label",
4799
4799
  "type": {
4800
- "text": "string"
4800
+ "text": "string | undefined"
4801
4801
  },
4802
- "default": "''",
4803
4802
  "description": "Banner label text",
4804
4803
  "attribute": "label",
4805
4804
  "reflects": true
@@ -4839,9 +4838,8 @@
4839
4838
  {
4840
4839
  "name": "label",
4841
4840
  "type": {
4842
- "text": "string"
4841
+ "text": "string | undefined"
4843
4842
  },
4844
- "default": "''",
4845
4843
  "description": "Banner label text",
4846
4844
  "fieldName": "label"
4847
4845
  },
@@ -6080,27 +6078,27 @@
6080
6078
  "declarations": [
6081
6079
  {
6082
6080
  "kind": "class",
6083
- "description": "`mdc-buttonlink` combines the functional behavior of `mdc-linksimple` with the visual and structural\nfeatures of `mdc-button`. This includes support for variants, sizing, and optional\nprefix and postfix icons via slots.\n\n### Features:\n- Behaves like an link while visually resembling a button.\n- Supports slots for `prefix-icon` and `postfix-icon`.\n- Customizable size, color, and variant through attributes.\n- Inherits accessibility and keyboard interaction support from `mdc-linksimple`.",
6081
+ "description": "`mdc-buttonlink` combines the functional behavior of `mdc-linksimple` with the visual and structural\nfeatures of `mdc-button`. This includes support for variants, sizing, and optional\nprefix and postfix icons.\n\n### Features:\n- Behaves like a link while visually resembling a button.\n- Customizable size, color, and variant through attributes.\n- Supports prefix and postfix icons.\n- Inherits accessibility and keyboard interaction support from `mdc-linksimple`.",
6084
6082
  "name": "ButtonLink",
6085
6083
  "cssProperties": [
6086
6084
  {
6087
- "description": "Height for button size",
6085
+ "description": "Height of the buttonlink",
6088
6086
  "name": "--mdc-button-height"
6089
6087
  },
6090
6088
  {
6091
- "description": "Background color of the button",
6089
+ "description": "Background color of the buttonlink",
6092
6090
  "name": "--mdc-button-background"
6093
6091
  },
6094
6092
  {
6095
- "description": "Borer color of the button",
6093
+ "description": "Border color of the buttonlink",
6096
6094
  "name": "--mdc-button-border-color"
6097
6095
  },
6098
6096
  {
6099
- "description": "Text color of the button",
6097
+ "description": "Text color of the buttonlink",
6100
6098
  "name": "--mdc-button-text-color"
6101
6099
  },
6102
6100
  {
6103
- "description": "Line height of the button text",
6101
+ "description": "Line height of the buttonlink text",
6104
6102
  "name": "--mdc-button-line-height"
6105
6103
  },
6106
6104
  {
@@ -6206,6 +6204,12 @@
6206
6204
  "name": "postfix-icon"
6207
6205
  }
6208
6206
  ],
6207
+ "slots": [
6208
+ {
6209
+ "description": "The default slot for buttonlink text content.",
6210
+ "name": "default"
6211
+ }
6212
+ ],
6209
6213
  "members": [
6210
6214
  {
6211
6215
  "kind": "field",
@@ -6257,7 +6261,7 @@
6257
6261
  "type": {
6258
6262
  "text": "string | undefined"
6259
6263
  },
6260
- "description": "Optional download attribute to instruct browsers to download the linked resource.",
6264
+ "description": "Optional download attribute to instruct browsers to download the linked resource.\n\nValid values:\n- empty string: browser suggests a name for the downloaded file\n- string: name of the downloaded file\n\nMore details in the [Anchor element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download) docs.",
6261
6265
  "attribute": "download",
6262
6266
  "reflects": true,
6263
6267
  "inheritedFrom": {
@@ -6541,7 +6545,7 @@
6541
6545
  "type": {
6542
6546
  "text": "PillButtonSize | IconButtonSize"
6543
6547
  },
6544
- "description": "ButtonLink sizing is based on the buttonlink type.\n- **Pill buttonlink**: 40, 32, 28, 24.\n- **Icon buttonlink**: 64, 52, 40, 32, 28, 24.\n- Tertiary icon buttonlink can also be 20.",
6548
+ "description": "Size of the buttonlink, determined by its type.\n- **Pill buttonlink**: 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)\n- **Icon buttonlink**: 64 (4rem), 52 (3.25rem), 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)\n- **Tertiary icon buttonlink** can also use: 20 (1.25rem)",
6545
6549
  "default": "32",
6546
6550
  "attribute": "size",
6547
6551
  "reflects": true
@@ -6645,7 +6649,7 @@
6645
6649
  "type": {
6646
6650
  "text": "PillButtonSize | IconButtonSize"
6647
6651
  },
6648
- "description": "ButtonLink sizing is based on the buttonlink type.\n- **Pill buttonlink**: 40, 32, 28, 24.\n- **Icon buttonlink**: 64, 52, 40, 32, 28, 24.\n- Tertiary icon buttonlink can also be 20.",
6652
+ "description": "Size of the buttonlink, determined by its type.\n- **Pill buttonlink**: 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)\n- **Icon buttonlink**: 64 (4rem), 52 (3.25rem), 40 (2.5rem), 32 (2rem), 28 (1.75rem), 24 (1.5rem)\n- **Tertiary icon buttonlink** can also use: 20 (1.25rem)",
6649
6653
  "default": "32",
6650
6654
  "fieldName": "size"
6651
6655
  },
@@ -6802,7 +6806,7 @@
6802
6806
  "type": {
6803
6807
  "text": "string | undefined"
6804
6808
  },
6805
- "description": "Optional download attribute to instruct browsers to download the linked resource.",
6809
+ "description": "Optional download attribute to instruct browsers to download the linked resource.\n\nValid values:\n- empty string: browser suggests a name for the downloaded file\n- string: name of the downloaded file\n\nMore details in the [Anchor element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download) docs.",
6806
6810
  "fieldName": "download",
6807
6811
  "inheritedFrom": {
6808
6812
  "name": "Linksimple",
@@ -6869,7 +6873,7 @@
6869
6873
  "module": "/src/components/linksimple/linksimple.component"
6870
6874
  },
6871
6875
  "tagName": "mdc-buttonlink",
6872
- "jsDoc": "/**\n * `mdc-buttonlink` combines the functional behavior of `mdc-linksimple` with the visual and structural\n * features of `mdc-button`. This includes support for variants, sizing, and optional\n * prefix and postfix icons via slots.\n *\n * ### Features:\n * - Behaves like an link while visually resembling a button.\n * - Supports slots for `prefix-icon` and `postfix-icon`.\n * - Customizable size, color, and variant through attributes.\n * - Inherits accessibility and keyboard interaction support from `mdc-linksimple`.\n *\n * @dependency mdc-icon\n *\n * @tagname mdc-buttonlink\n *\n * @event click - (React: onClick) Fired when the user activates the buttonLink using a mouse or assistive technology.\n * @event keydown - (React: onKeyDown) Fired when the user presses a key while the buttonLink has focus.\n * @event focus - (React: onFocus) Fired when the buttonLink receives keyboard or mouse focus.\n * @event blur - (React: onBlur) Fired when the buttonLink loses keyboard or mouse focus.\n *\n * @csspart anchor - The anchor element that wraps the buttonlink content.\n * @csspart prefix-icon - The prefix icon element.\n * @csspart button-text - The slot containing the buttonlink text.\n * @csspart postfix-icon - The postfix icon element.\n *\n * @cssproperty --mdc-button-height - Height for button size\n * @cssproperty --mdc-button-background - Background color of the button\n * @cssproperty --mdc-button-border-color - Borer color of the button\n * @cssproperty --mdc-button-text-color - Text color of the button\n * @cssproperty --mdc-button-line-height - Line height of the button text\n * @cssproperty --mdc-button-prefix-icon-size - Size of the prefix icon\n * @cssproperty --mdc-button-postfix-icon-size - Size of the postfix icon\n */",
6876
+ "jsDoc": "/**\n * `mdc-buttonlink` combines the functional behavior of `mdc-linksimple` with the visual and structural\n * features of `mdc-button`. This includes support for variants, sizing, and optional\n * prefix and postfix icons.\n *\n * ### Features:\n * - Behaves like a link while visually resembling a button.\n * - Customizable size, color, and variant through attributes.\n * - Supports prefix and postfix icons.\n * - Inherits accessibility and keyboard interaction support from `mdc-linksimple`.\n *\n * @dependency mdc-icon\n *\n * @tagname mdc-buttonlink\n *\n * @slot default - The default slot for buttonlink text content.\n *\n * @event click - (React: onClick) Fired when the user activates the buttonLink using a mouse or assistive technology.\n * @event keydown - (React: onKeyDown) Fired when the user presses a key while the buttonLink has focus.\n * @event focus - (React: onFocus) Fired when the buttonLink receives keyboard or mouse focus.\n * @event blur - (React: onBlur) Fired when the buttonLink loses keyboard or mouse focus.\n *\n * @csspart anchor - The anchor element that wraps the buttonlink content.\n * @csspart prefix-icon - The prefix icon element.\n * @csspart button-text - The slot containing the buttonlink text.\n * @csspart postfix-icon - The postfix icon element.\n *\n * @cssproperty --mdc-button-height - Height of the buttonlink\n * @cssproperty --mdc-button-background - Background color of the buttonlink\n * @cssproperty --mdc-button-border-color - Border color of the buttonlink\n * @cssproperty --mdc-button-text-color - Text color of the buttonlink\n * @cssproperty --mdc-button-line-height - Line height of the buttonlink text\n * @cssproperty --mdc-button-prefix-icon-size - Size of the prefix icon\n * @cssproperty --mdc-button-postfix-icon-size - Size of the postfix icon\n */",
6873
6877
  "customElement": true
6874
6878
  }
6875
6879
  ],
@@ -20624,7 +20628,7 @@
20624
20628
  "type": {
20625
20629
  "text": "string | undefined"
20626
20630
  },
20627
- "description": "Optional download attribute to instruct browsers to download the linked resource.",
20631
+ "description": "Optional download attribute to instruct browsers to download the linked resource.\n\nValid values:\n- empty string: browser suggests a name for the downloaded file\n- string: name of the downloaded file\n\nMore details in the [Anchor element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download) docs.",
20628
20632
  "attribute": "download",
20629
20633
  "reflects": true,
20630
20634
  "inheritedFrom": {
@@ -20997,7 +21001,7 @@
20997
21001
  "type": {
20998
21002
  "text": "string | undefined"
20999
21003
  },
21000
- "description": "Optional download attribute to instruct browsers to download the linked resource.",
21004
+ "description": "Optional download attribute to instruct browsers to download the linked resource.\n\nValid values:\n- empty string: browser suggests a name for the downloaded file\n- string: name of the downloaded file\n\nMore details in the [Anchor element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download) docs.",
21001
21005
  "fieldName": "download",
21002
21006
  "inheritedFrom": {
21003
21007
  "name": "Linksimple",
@@ -21374,7 +21378,7 @@
21374
21378
  "type": {
21375
21379
  "text": "boolean"
21376
21380
  },
21377
- "description": "The linkbutton can be inline or standalone.",
21381
+ "description": "Display mode of the linkbutton.\n- `false`: Standalone display (default)\n- `true`: Inline display within text flow",
21378
21382
  "default": "false",
21379
21383
  "attribute": "inline",
21380
21384
  "reflects": true
@@ -21385,7 +21389,7 @@
21385
21389
  "type": {
21386
21390
  "text": "boolean"
21387
21391
  },
21388
- "description": "The linkbutton color can be inverted by setting the inverted attribute to true.",
21392
+ "description": "Color scheme of the linkbutton.\n- `false`: Normal color scheme for light backgrounds (default)\n- `true`: Inverted color scheme for dark backgrounds",
21389
21393
  "default": "false",
21390
21394
  "attribute": "inverted",
21391
21395
  "reflects": true
@@ -21472,21 +21476,6 @@
21472
21476
  "module": "components/buttonsimple/buttonsimple.component.js"
21473
21477
  }
21474
21478
  },
21475
- {
21476
- "kind": "method",
21477
- "name": "setSize",
21478
- "privacy": "private",
21479
- "parameters": [
21480
- {
21481
- "name": "size",
21482
- "type": {
21483
- "text": "LinkButtonSize"
21484
- },
21485
- "description": "The desired link size."
21486
- }
21487
- ],
21488
- "description": "Sets the `size` attribute for the linkbutton, falling back to the default if the value is invalid."
21489
- },
21490
21479
  {
21491
21480
  "kind": "method",
21492
21481
  "name": "setSoftDisabled",
@@ -21520,7 +21509,7 @@
21520
21509
  "type": {
21521
21510
  "text": "ButtonSize"
21522
21511
  },
21523
- "description": "Sets the size of the linkbutton.\nAcceptable values:\n- 12\n- 14\n- 16",
21512
+ "description": "Size of the linkbutton text and icon.\n- **12**: 0.75rem font size\n- **14**: 0.875rem font size\n- **16**: 1rem font size (default)",
21524
21513
  "default": "16",
21525
21514
  "attribute": "size",
21526
21515
  "reflects": true,
@@ -21634,6 +21623,11 @@
21634
21623
  "name": "Buttonsimple",
21635
21624
  "module": "src/components/buttonsimple/buttonsimple.component.ts"
21636
21625
  }
21626
+ },
21627
+ {
21628
+ "description": "(React: onBlur) This event is dispatched when the linkbutton loses focus.",
21629
+ "name": "blur",
21630
+ "reactName": "onBlur"
21637
21631
  }
21638
21632
  ],
21639
21633
  "attributes": [
@@ -21642,7 +21636,7 @@
21642
21636
  "type": {
21643
21637
  "text": "ButtonSize"
21644
21638
  },
21645
- "description": "Sets the size of the linkbutton.\nAcceptable values:\n- 12\n- 14\n- 16",
21639
+ "description": "Size of the linkbutton text and icon.\n- **12**: 0.75rem font size\n- **14**: 0.875rem font size\n- **16**: 1rem font size (default)",
21646
21640
  "default": "16",
21647
21641
  "fieldName": "size",
21648
21642
  "inheritedFrom": {
@@ -21655,7 +21649,7 @@
21655
21649
  "type": {
21656
21650
  "text": "boolean"
21657
21651
  },
21658
- "description": "The linkbutton can be inline or standalone.",
21652
+ "description": "Display mode of the linkbutton.\n- `false`: Standalone display (default)\n- `true`: Inline display within text flow",
21659
21653
  "default": "false",
21660
21654
  "fieldName": "inline"
21661
21655
  },
@@ -21664,7 +21658,7 @@
21664
21658
  "type": {
21665
21659
  "text": "boolean"
21666
21660
  },
21667
- "description": "The linkbutton color can be inverted by setting the inverted attribute to true.",
21661
+ "description": "Color scheme of the linkbutton.\n- `false`: Normal color scheme for light backgrounds (default)\n- `true`: Inverted color scheme for dark backgrounds",
21668
21662
  "default": "false",
21669
21663
  "fieldName": "inverted"
21670
21664
  },
@@ -21820,7 +21814,7 @@
21820
21814
  "module": "/src/components/buttonsimple/buttonsimple.component"
21821
21815
  },
21822
21816
  "tagName": "mdc-linkbutton",
21823
- "jsDoc": "/**\n * `mdc-linkbutton` visually mimics a hyperlink while functioning as a button. It blends the appearance of `mdc-link` with the accessibility and interaction capabilities of `mdc-button`.\n *\n * ### Features:\n * - Looks like a link, behaves like a button.\n * - Supports slots for a text label and an optional trailing icon.\n * - Inherits accessibility and keyboard interaction behavior from `mdc-buttonsimple`.\n *\n * @dependency mdc-icon\n *\n * @tagname mdc-linkbutton\n *\n * @slot - Text label of the linkbutton.\n *\n * @event click - (React: onClick) This event is dispatched when the linkbutton is clicked.\n * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the linkbutton.\n * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the linkbutton.\n * @event focus - (React: onFocus) This event is dispatched when the linkbutton receives focus.\n *\n * @cssproperty --mdc-link-border-radius - Border radius of the linkbutton.\n * @cssproperty --mdc-link-color-active - Color of the linkbutton’s child content in the active state.\n * @cssproperty --mdc-link-color-disabled - Color of the linkbutton’s child content in the disabled state.\n * @cssproperty --mdc-link-color-hover - Color of the linkbutton’s child content in the hover state.\n * @cssproperty --mdc-link-color-normal - Color of the linkbutton’s child content in the normal state.\n * @cssproperty --mdc-link-inverted-color-active - Color of the inverted linkbutton’s child content in the active state.\n * @cssproperty --mdc-link-inverted-color-disabled - Color of the inverted linkbutton’s child content in the disabled state.\n * @cssproperty --mdc-link-inverted-color-hover - Color of the inverted linkbutton’s child content in the hover state.\n * @cssproperty --mdc-link-inverted-color-normal - Color of the inverted linkbutton’s child content in the normal state.\n * @cssproperty --mdc-button-height - Height for button size\n */",
21817
+ "jsDoc": "/**\n * `mdc-linkbutton` visually mimics a hyperlink while functioning as a button. It blends the appearance of `mdc-link` with the accessibility and interaction capabilities of `mdc-button`.\n *\n * ### Features:\n * - Looks like a link, behaves like a button.\n * - Supports slots for a text label and an optional trailing icon.\n * - Inherits accessibility and keyboard interaction behavior from `mdc-buttonsimple`.\n *\n * @dependency mdc-icon\n *\n * @tagname mdc-linkbutton\n *\n * @slot - Text label of the linkbutton.\n *\n * @event click - (React: onClick) This event is dispatched when the linkbutton is clicked.\n * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the linkbutton.\n * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the linkbutton.\n * @event focus - (React: onFocus) This event is dispatched when the linkbutton receives focus.\n * @event blur - (React: onBlur) This event is dispatched when the linkbutton loses focus.\n *\n * @cssproperty --mdc-link-border-radius - Border radius of the linkbutton.\n * @cssproperty --mdc-link-color-active - Color of the linkbutton’s child content in the active state.\n * @cssproperty --mdc-link-color-disabled - Color of the linkbutton’s child content in the disabled state.\n * @cssproperty --mdc-link-color-hover - Color of the linkbutton’s child content in the hover state.\n * @cssproperty --mdc-link-color-normal - Color of the linkbutton’s child content in the normal state.\n * @cssproperty --mdc-link-inverted-color-active - Color of the inverted linkbutton’s child content in the active state.\n * @cssproperty --mdc-link-inverted-color-disabled - Color of the inverted linkbutton’s child content in the disabled state.\n * @cssproperty --mdc-link-inverted-color-hover - Color of the inverted linkbutton’s child content in the hover state.\n * @cssproperty --mdc-link-inverted-color-normal - Color of the inverted linkbutton’s child content in the normal state.\n * @cssproperty --mdc-button-height - Height for button size\n */",
21824
21818
  "customElement": true
21825
21819
  }
21826
21820
  ],
@@ -21924,7 +21918,7 @@
21924
21918
  "type": {
21925
21919
  "text": "string | undefined"
21926
21920
  },
21927
- "description": "Optional download attribute to instruct browsers to download the linked resource.",
21921
+ "description": "Optional download attribute to instruct browsers to download the linked resource.\n\nValid values:\n- empty string: browser suggests a name for the downloaded file\n- string: name of the downloaded file\n\nMore details in the [Anchor element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download) docs.",
21928
21922
  "attribute": "download",
21929
21923
  "reflects": true
21930
21924
  },
@@ -22126,7 +22120,7 @@
22126
22120
  "type": {
22127
22121
  "text": "string | undefined"
22128
22122
  },
22129
- "description": "Optional download attribute to instruct browsers to download the linked resource.",
22123
+ "description": "Optional download attribute to instruct browsers to download the linked resource.\n\nValid values:\n- empty string: browser suggests a name for the downloaded file\n- string: name of the downloaded file\n\nMore details in the [Anchor element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#download) docs.",
22130
22124
  "fieldName": "download"
22131
22125
  },
22132
22126
  {
@@ -4,18 +4,20 @@ import type { Events as EventsInherited } from '../../components/linksimple/link
4
4
  /**
5
5
  * `mdc-buttonlink` combines the functional behavior of `mdc-linksimple` with the visual and structural
6
6
  * features of `mdc-button`. This includes support for variants, sizing, and optional
7
- * prefix and postfix icons via slots.
7
+ * prefix and postfix icons.
8
8
  *
9
9
  * ### Features:
10
- * - Behaves like an link while visually resembling a button.
11
- * - Supports slots for `prefix-icon` and `postfix-icon`.
10
+ * - Behaves like a link while visually resembling a button.
12
11
  * - Customizable size, color, and variant through attributes.
12
+ * - Supports prefix and postfix icons.
13
13
  * - Inherits accessibility and keyboard interaction support from `mdc-linksimple`.
14
14
  *
15
15
  * @dependency mdc-icon
16
16
  *
17
17
  * @tagname mdc-buttonlink
18
18
  *
19
+ * @slot default - The default slot for buttonlink text content.
20
+ *
19
21
  * @event click - (React: onClick) Fired when the user activates the buttonLink using a mouse or assistive technology.
20
22
  * @event keydown - (React: onKeyDown) Fired when the user presses a key while the buttonLink has focus.
21
23
  * @event focus - (React: onFocus) Fired when the buttonLink receives keyboard or mouse focus.
@@ -26,11 +28,11 @@ import type { Events as EventsInherited } from '../../components/linksimple/link
26
28
  * @csspart button-text - The slot containing the buttonlink text.
27
29
  * @csspart postfix-icon - The postfix icon element.
28
30
  *
29
- * @cssproperty --mdc-button-height - Height for button size
30
- * @cssproperty --mdc-button-background - Background color of the button
31
- * @cssproperty --mdc-button-border-color - Borer color of the button
32
- * @cssproperty --mdc-button-text-color - Text color of the button
33
- * @cssproperty --mdc-button-line-height - Line height of the button text
31
+ * @cssproperty --mdc-button-height - Height of the buttonlink
32
+ * @cssproperty --mdc-button-background - Background color of the buttonlink
33
+ * @cssproperty --mdc-button-border-color - Border color of the buttonlink
34
+ * @cssproperty --mdc-button-text-color - Text color of the buttonlink
35
+ * @cssproperty --mdc-button-line-height - Line height of the buttonlink text
34
36
  * @cssproperty --mdc-button-prefix-icon-size - Size of the prefix icon
35
37
  * @cssproperty --mdc-button-postfix-icon-size - Size of the postfix icon
36
38
  */