@porsche-design-system/components-react 4.0.0-beta.2 → 4.0.0-beta.3

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.
Files changed (178) hide show
  1. package/CHANGELOG.md +293 -1
  2. package/cjs/lib/components/button-pure.wrapper.cjs +3 -3
  3. package/cjs/lib/components/display.wrapper.cjs +1 -0
  4. package/cjs/lib/components/flag.wrapper.cjs +1 -1
  5. package/cjs/lib/components/heading.wrapper.cjs +3 -3
  6. package/cjs/lib/components/icon.wrapper.cjs +1 -1
  7. package/cjs/lib/components/link-pure.wrapper.cjs +3 -3
  8. package/cjs/lib/components/spinner.wrapper.cjs +3 -3
  9. package/cjs/lib/components/text.wrapper.cjs +1 -1
  10. package/esm/lib/components/accordion.wrapper.d.ts +8 -8
  11. package/esm/lib/components/button-pure.wrapper.d.ts +15 -7
  12. package/esm/lib/components/button-pure.wrapper.mjs +3 -3
  13. package/esm/lib/components/button-tile.wrapper.d.ts +2 -2
  14. package/esm/lib/components/button.wrapper.d.ts +6 -6
  15. package/esm/lib/components/carousel.wrapper.d.ts +10 -10
  16. package/esm/lib/components/checkbox.wrapper.d.ts +6 -6
  17. package/esm/lib/components/crest.wrapper.d.ts +6 -6
  18. package/esm/lib/components/display.wrapper.d.ts +1 -0
  19. package/esm/lib/components/display.wrapper.mjs +1 -0
  20. package/esm/lib/components/drilldown-link.wrapper.d.ts +8 -8
  21. package/esm/lib/components/drilldown.wrapper.d.ts +8 -8
  22. package/esm/lib/components/fieldset.wrapper.d.ts +6 -6
  23. package/esm/lib/components/flag.wrapper.d.ts +5 -5
  24. package/esm/lib/components/flag.wrapper.mjs +1 -1
  25. package/esm/lib/components/flyout.wrapper.d.ts +2 -2
  26. package/esm/lib/components/heading.wrapper.d.ts +19 -11
  27. package/esm/lib/components/heading.wrapper.mjs +3 -3
  28. package/esm/lib/components/icon.wrapper.d.ts +7 -7
  29. package/esm/lib/components/icon.wrapper.mjs +1 -1
  30. package/esm/lib/components/input-date.wrapper.d.ts +12 -12
  31. package/esm/lib/components/input-email.wrapper.d.ts +8 -8
  32. package/esm/lib/components/input-month.wrapper.d.ts +12 -12
  33. package/esm/lib/components/input-number.wrapper.d.ts +8 -8
  34. package/esm/lib/components/input-password.wrapper.d.ts +6 -6
  35. package/esm/lib/components/input-search.wrapper.d.ts +6 -6
  36. package/esm/lib/components/input-tel.wrapper.d.ts +6 -6
  37. package/esm/lib/components/input-text.wrapper.d.ts +6 -6
  38. package/esm/lib/components/input-time.wrapper.d.ts +14 -14
  39. package/esm/lib/components/input-url.wrapper.d.ts +16 -16
  40. package/esm/lib/components/input-week.wrapper.d.ts +14 -14
  41. package/esm/lib/components/link-pure.wrapper.d.ts +23 -15
  42. package/esm/lib/components/link-pure.wrapper.mjs +3 -3
  43. package/esm/lib/components/link-tile-product.wrapper.d.ts +8 -8
  44. package/esm/lib/components/link-tile.wrapper.d.ts +8 -8
  45. package/esm/lib/components/link.wrapper.d.ts +14 -14
  46. package/esm/lib/components/modal.wrapper.d.ts +2 -2
  47. package/esm/lib/components/model-signature.wrapper.d.ts +2 -2
  48. package/esm/lib/components/multi-select.wrapper.d.ts +10 -10
  49. package/esm/lib/components/pin-code.wrapper.d.ts +8 -8
  50. package/esm/lib/components/popover.wrapper.d.ts +6 -6
  51. package/esm/lib/components/radio-group-option.wrapper.d.ts +2 -2
  52. package/esm/lib/components/radio-group.wrapper.d.ts +8 -8
  53. package/esm/lib/components/segmented-control-item.wrapper.d.ts +4 -4
  54. package/esm/lib/components/segmented-control.wrapper.d.ts +4 -4
  55. package/esm/lib/components/select.wrapper.d.ts +10 -10
  56. package/esm/lib/components/sheet.wrapper.d.ts +2 -2
  57. package/esm/lib/components/spinner.wrapper.d.ts +13 -5
  58. package/esm/lib/components/spinner.wrapper.mjs +3 -3
  59. package/esm/lib/components/switch.wrapper.d.ts +6 -6
  60. package/esm/lib/components/table-cell.wrapper.d.ts +2 -2
  61. package/esm/lib/components/table-head-cell.wrapper.d.ts +4 -4
  62. package/esm/lib/components/tabs-bar.wrapper.d.ts +2 -2
  63. package/esm/lib/components/tabs.wrapper.d.ts +2 -2
  64. package/esm/lib/components/tag-dismissible.wrapper.d.ts +6 -6
  65. package/esm/lib/components/tag.wrapper.d.ts +2 -2
  66. package/esm/lib/components/text.wrapper.d.ts +12 -12
  67. package/esm/lib/components/text.wrapper.mjs +1 -1
  68. package/esm/lib/components/textarea.wrapper.d.ts +6 -6
  69. package/esm/lib/components/wordmark.wrapper.d.ts +8 -8
  70. package/esm/lib/types.d.ts +322 -141
  71. package/global-styles/cn/index.css +3 -7
  72. package/global-styles/index.css +3 -7
  73. package/global-styles/variables.css +3 -7
  74. package/package.json +6 -2
  75. package/ssr/cjs/components/dist/styles/esm/styles-entry.cjs +341 -319
  76. package/ssr/cjs/components/dist/utils/esm/utils-entry.cjs +18 -8
  77. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/components/button-pure.wrapper.cjs +4 -4
  78. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/components/display.wrapper.cjs +1 -0
  79. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/components/flag.wrapper.cjs +1 -1
  80. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/components/heading.wrapper.cjs +4 -4
  81. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/components/icon.wrapper.cjs +1 -1
  82. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/components/link-pure.wrapper.cjs +4 -4
  83. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/components/spinner.wrapper.cjs +4 -4
  84. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/components/text.wrapper.cjs +1 -1
  85. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/button-pure.cjs +3 -2
  86. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/carousel.cjs +2 -2
  87. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/checkbox.cjs +1 -1
  88. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/display.cjs +2 -0
  89. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/drilldown-item.cjs +2 -2
  90. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/flyout.cjs +1 -1
  91. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/heading.cjs +1 -1
  92. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/input-base.cjs +1 -1
  93. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/link-pure.cjs +1 -1
  94. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/radio-group-option.cjs +1 -1
  95. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/radio-group.cjs +1 -1
  96. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/spinner.cjs +2 -2
  97. package/ssr/cjs/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/switch.cjs +1 -1
  98. package/ssr/esm/components/dist/styles/esm/styles-entry.mjs +341 -319
  99. package/ssr/esm/components/dist/utils/esm/utils-entry.mjs +18 -8
  100. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/components/button-pure.wrapper.mjs +4 -4
  101. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/components/display.wrapper.mjs +1 -0
  102. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/components/flag.wrapper.mjs +1 -1
  103. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/components/heading.wrapper.mjs +4 -4
  104. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/components/icon.wrapper.mjs +1 -1
  105. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/components/link-pure.wrapper.mjs +4 -4
  106. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/components/spinner.wrapper.mjs +4 -4
  107. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/components/text.wrapper.mjs +1 -1
  108. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/button-pure.mjs +3 -2
  109. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/carousel.mjs +2 -2
  110. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/checkbox.mjs +1 -1
  111. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/display.mjs +2 -0
  112. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/drilldown-item.mjs +2 -2
  113. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/flyout.mjs +1 -1
  114. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/heading.mjs +1 -1
  115. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/input-base.mjs +1 -1
  116. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/link-pure.mjs +1 -1
  117. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/radio-group-option.mjs +1 -1
  118. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/radio-group.mjs +1 -1
  119. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/spinner.mjs +2 -2
  120. package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/switch.mjs +1 -1
  121. package/ssr/esm/lib/components/accordion.wrapper.d.ts +8 -8
  122. package/ssr/esm/lib/components/button-pure.wrapper.d.ts +15 -7
  123. package/ssr/esm/lib/components/button-tile.wrapper.d.ts +2 -2
  124. package/ssr/esm/lib/components/button.wrapper.d.ts +6 -6
  125. package/ssr/esm/lib/components/carousel.wrapper.d.ts +10 -10
  126. package/ssr/esm/lib/components/checkbox.wrapper.d.ts +6 -6
  127. package/ssr/esm/lib/components/crest.wrapper.d.ts +6 -6
  128. package/ssr/esm/lib/components/display.wrapper.d.ts +1 -0
  129. package/ssr/esm/lib/components/drilldown-link.wrapper.d.ts +8 -8
  130. package/ssr/esm/lib/components/drilldown.wrapper.d.ts +8 -8
  131. package/ssr/esm/lib/components/fieldset.wrapper.d.ts +6 -6
  132. package/ssr/esm/lib/components/flag.wrapper.d.ts +5 -5
  133. package/ssr/esm/lib/components/flyout.wrapper.d.ts +2 -2
  134. package/ssr/esm/lib/components/heading.wrapper.d.ts +19 -11
  135. package/ssr/esm/lib/components/icon.wrapper.d.ts +7 -7
  136. package/ssr/esm/lib/components/input-date.wrapper.d.ts +12 -12
  137. package/ssr/esm/lib/components/input-email.wrapper.d.ts +8 -8
  138. package/ssr/esm/lib/components/input-month.wrapper.d.ts +12 -12
  139. package/ssr/esm/lib/components/input-number.wrapper.d.ts +8 -8
  140. package/ssr/esm/lib/components/input-password.wrapper.d.ts +6 -6
  141. package/ssr/esm/lib/components/input-search.wrapper.d.ts +6 -6
  142. package/ssr/esm/lib/components/input-tel.wrapper.d.ts +6 -6
  143. package/ssr/esm/lib/components/input-text.wrapper.d.ts +6 -6
  144. package/ssr/esm/lib/components/input-time.wrapper.d.ts +14 -14
  145. package/ssr/esm/lib/components/input-url.wrapper.d.ts +16 -16
  146. package/ssr/esm/lib/components/input-week.wrapper.d.ts +14 -14
  147. package/ssr/esm/lib/components/link-pure.wrapper.d.ts +23 -15
  148. package/ssr/esm/lib/components/link-tile-product.wrapper.d.ts +8 -8
  149. package/ssr/esm/lib/components/link-tile.wrapper.d.ts +8 -8
  150. package/ssr/esm/lib/components/link.wrapper.d.ts +14 -14
  151. package/ssr/esm/lib/components/modal.wrapper.d.ts +2 -2
  152. package/ssr/esm/lib/components/model-signature.wrapper.d.ts +2 -2
  153. package/ssr/esm/lib/components/multi-select.wrapper.d.ts +10 -10
  154. package/ssr/esm/lib/components/pin-code.wrapper.d.ts +8 -8
  155. package/ssr/esm/lib/components/popover.wrapper.d.ts +6 -6
  156. package/ssr/esm/lib/components/radio-group-option.wrapper.d.ts +2 -2
  157. package/ssr/esm/lib/components/radio-group.wrapper.d.ts +8 -8
  158. package/ssr/esm/lib/components/segmented-control-item.wrapper.d.ts +4 -4
  159. package/ssr/esm/lib/components/segmented-control.wrapper.d.ts +4 -4
  160. package/ssr/esm/lib/components/select.wrapper.d.ts +10 -10
  161. package/ssr/esm/lib/components/sheet.wrapper.d.ts +2 -2
  162. package/ssr/esm/lib/components/spinner.wrapper.d.ts +13 -5
  163. package/ssr/esm/lib/components/switch.wrapper.d.ts +6 -6
  164. package/ssr/esm/lib/components/table-cell.wrapper.d.ts +2 -2
  165. package/ssr/esm/lib/components/table-head-cell.wrapper.d.ts +4 -4
  166. package/ssr/esm/lib/components/tabs-bar.wrapper.d.ts +2 -2
  167. package/ssr/esm/lib/components/tabs.wrapper.d.ts +2 -2
  168. package/ssr/esm/lib/components/tag-dismissible.wrapper.d.ts +6 -6
  169. package/ssr/esm/lib/components/tag.wrapper.d.ts +2 -2
  170. package/ssr/esm/lib/components/text.wrapper.d.ts +12 -12
  171. package/ssr/esm/lib/components/textarea.wrapper.d.ts +6 -6
  172. package/ssr/esm/lib/components/wordmark.wrapper.d.ts +8 -8
  173. package/ssr/esm/lib/dsr-components/carousel.d.ts +2 -2
  174. package/ssr/esm/lib/dsr-components/display.d.ts +2 -0
  175. package/ssr/esm/lib/dsr-components/drilldown-item.d.ts +2 -2
  176. package/ssr/esm/lib/dsr-components/flyout.d.ts +1 -1
  177. package/ssr/esm/lib/types.d.ts +322 -141
  178. package/tailwindcss/index.css +19 -4
@@ -6,7 +6,7 @@ export type PInputWeekProps = BaseProps & {
6
6
  */
7
7
  autoComplete?: string;
8
8
  /**
9
- * A boolean value that, if present, renders the input field as a compact version.
9
+ * Displays the input field in compact mode.
10
10
  */
11
11
  compact?: boolean;
12
12
  /**
@@ -14,7 +14,7 @@ export type PInputWeekProps = BaseProps & {
14
14
  */
15
15
  description?: string;
16
16
  /**
17
- * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
17
+ * Disables the input field. The value will not be submitted with the form.
18
18
  */
19
19
  disabled?: boolean;
20
20
  /**
@@ -22,7 +22,7 @@ export type PInputWeekProps = BaseProps & {
22
22
  */
23
23
  form?: string;
24
24
  /**
25
- * Controls the visibility of the label.
25
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
26
26
  */
27
27
  hideLabel?: BreakpointCustomizable<boolean>;
28
28
  /**
@@ -50,11 +50,11 @@ export type PInputWeekProps = BaseProps & {
50
50
  */
51
51
  name: string;
52
52
  /**
53
- * Emitted when the number input has lost focus.
53
+ * Emitted when the week input has lost focus.
54
54
  */
55
55
  onBlur?: (event: CustomEvent<InputWeekBlurEventDetail>) => void;
56
56
  /**
57
- * Emitted when the number input loses focus after its value was changed.
57
+ * Emitted when the week input loses focus after its value was changed.
58
58
  */
59
59
  onChange?: (event: CustomEvent<InputWeekChangeEventDetail>) => void;
60
60
  /**
@@ -74,11 +74,11 @@ export type PInputWeekProps = BaseProps & {
74
74
  */
75
75
  state?: InputWeekState;
76
76
  /**
77
- * Defines the stepping interval in weeks. For example, step="1" increments by 1 week. The default is 1 month.
77
+ * Defines the stepping interval in weeks. For example, step="1" increments by 1 week. The default is 1 week.
78
78
  */
79
79
  step?: number;
80
80
  /**
81
- * The default week value for the input, in YYYY-Www format (e.g., value='2025-W27')
81
+ * The default week value for the input, in YYYY-Www format (e.g., value='2025-W27').
82
82
  */
83
83
  value?: string;
84
84
  };
@@ -88,7 +88,7 @@ export declare const PInputWeek: import("react").ForwardRefExoticComponent<Omit<
88
88
  */
89
89
  autoComplete?: string;
90
90
  /**
91
- * A boolean value that, if present, renders the input field as a compact version.
91
+ * Displays the input field in compact mode.
92
92
  */
93
93
  compact?: boolean;
94
94
  /**
@@ -96,7 +96,7 @@ export declare const PInputWeek: import("react").ForwardRefExoticComponent<Omit<
96
96
  */
97
97
  description?: string;
98
98
  /**
99
- * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
99
+ * Disables the input field. The value will not be submitted with the form.
100
100
  */
101
101
  disabled?: boolean;
102
102
  /**
@@ -104,7 +104,7 @@ export declare const PInputWeek: import("react").ForwardRefExoticComponent<Omit<
104
104
  */
105
105
  form?: string;
106
106
  /**
107
- * Controls the visibility of the label.
107
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
108
108
  */
109
109
  hideLabel?: BreakpointCustomizable<boolean>;
110
110
  /**
@@ -132,11 +132,11 @@ export declare const PInputWeek: import("react").ForwardRefExoticComponent<Omit<
132
132
  */
133
133
  name: string;
134
134
  /**
135
- * Emitted when the number input has lost focus.
135
+ * Emitted when the week input has lost focus.
136
136
  */
137
137
  onBlur?: (event: CustomEvent<InputWeekBlurEventDetail>) => void;
138
138
  /**
139
- * Emitted when the number input loses focus after its value was changed.
139
+ * Emitted when the week input loses focus after its value was changed.
140
140
  */
141
141
  onChange?: (event: CustomEvent<InputWeekChangeEventDetail>) => void;
142
142
  /**
@@ -156,11 +156,11 @@ export declare const PInputWeek: import("react").ForwardRefExoticComponent<Omit<
156
156
  */
157
157
  state?: InputWeekState;
158
158
  /**
159
- * Defines the stepping interval in weeks. For example, step="1" increments by 1 week. The default is 1 month.
159
+ * Defines the stepping interval in weeks. For example, step="1" increments by 1 week. The default is 1 week.
160
160
  */
161
161
  step?: number;
162
162
  /**
163
- * The default week value for the input, in YYYY-Www format (e.g., value='2025-W27')
163
+ * The default week value for the input, in YYYY-Www format (e.g., value='2025-W27').
164
164
  */
165
165
  value?: string;
166
166
  } & {
@@ -1,8 +1,8 @@
1
1
  import type { BaseProps } from '../../BaseProps';
2
- import type { BreakpointCustomizable, LinkPureAlignLabel, SelectedAriaAttributes, LinkPureAriaAttribute, LinkPureIcon, LinkPureSize, LinkPureTarget } from '../types';
2
+ import type { BreakpointCustomizable, LinkPureAlignLabel, SelectedAriaAttributes, LinkPureAriaAttribute, LinkPureColor, LinkPureIcon, LinkPureSize, LinkPureTarget } from '../types';
3
3
  export type PLinkPureProps = BaseProps & {
4
4
  /**
5
- * Display link in active state.
5
+ * Displays the link in its active state.
6
6
  */
7
7
  active?: boolean;
8
8
  /**
@@ -10,19 +10,23 @@ export type PLinkPureProps = BaseProps & {
10
10
  */
11
11
  alignLabel?: BreakpointCustomizable<LinkPureAlignLabel>;
12
12
  /**
13
- * Add ARIA attributes.
13
+ * Sets ARIA attributes.
14
14
  */
15
15
  aria?: SelectedAriaAttributes<LinkPureAriaAttribute>;
16
16
  /**
17
- * Special download attribute to open native browser download dialog if target url points to a downloadable file.
17
+ * The color.
18
+ */
19
+ color?: LinkPureColor;
20
+ /**
21
+ * Sets the native `download` attribute when the target URL points to a downloadable file.
18
22
  */
19
23
  download?: string;
20
24
  /**
21
- * Show or hide label. For better accessibility it is recommended to show the label.
25
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
22
26
  */
23
27
  hideLabel?: BreakpointCustomizable<boolean>;
24
28
  /**
25
- * When providing an url then the component will be rendered as `<a>`.
29
+ * When `href` is provided, the component renders as an `<a>` element.
26
30
  */
27
31
  href?: string;
28
32
  /**
@@ -34,7 +38,7 @@ export type PLinkPureProps = BaseProps & {
34
38
  */
35
39
  iconSource?: string;
36
40
  /**
37
- * Specifies the relationship of the target object to the link object.
41
+ * Sets the `rel` attribute on the link.
38
42
  */
39
43
  rel?: string;
40
44
  /**
@@ -46,7 +50,7 @@ export type PLinkPureProps = BaseProps & {
46
50
  */
47
51
  stretch?: BreakpointCustomizable<boolean>;
48
52
  /**
49
- * Target attribute where the link should be opened.
53
+ * Specifies where to open the linked document.
50
54
  */
51
55
  target?: LinkPureTarget;
52
56
  /**
@@ -56,7 +60,7 @@ export type PLinkPureProps = BaseProps & {
56
60
  };
57
61
  export declare const PLinkPure: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
58
62
  /**
59
- * Display link in active state.
63
+ * Displays the link in its active state.
60
64
  */
61
65
  active?: boolean;
62
66
  /**
@@ -64,19 +68,23 @@ export declare const PLinkPure: import("react").ForwardRefExoticComponent<Omit<i
64
68
  */
65
69
  alignLabel?: BreakpointCustomizable<LinkPureAlignLabel>;
66
70
  /**
67
- * Add ARIA attributes.
71
+ * Sets ARIA attributes.
68
72
  */
69
73
  aria?: SelectedAriaAttributes<LinkPureAriaAttribute>;
70
74
  /**
71
- * Special download attribute to open native browser download dialog if target url points to a downloadable file.
75
+ * The color.
76
+ */
77
+ color?: LinkPureColor;
78
+ /**
79
+ * Sets the native `download` attribute when the target URL points to a downloadable file.
72
80
  */
73
81
  download?: string;
74
82
  /**
75
- * Show or hide label. For better accessibility it is recommended to show the label.
83
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
76
84
  */
77
85
  hideLabel?: BreakpointCustomizable<boolean>;
78
86
  /**
79
- * When providing an url then the component will be rendered as `<a>`.
87
+ * When `href` is provided, the component renders as an `<a>` element.
80
88
  */
81
89
  href?: string;
82
90
  /**
@@ -88,7 +96,7 @@ export declare const PLinkPure: import("react").ForwardRefExoticComponent<Omit<i
88
96
  */
89
97
  iconSource?: string;
90
98
  /**
91
- * Specifies the relationship of the target object to the link object.
99
+ * Sets the `rel` attribute on the link.
92
100
  */
93
101
  rel?: string;
94
102
  /**
@@ -100,7 +108,7 @@ export declare const PLinkPure: import("react").ForwardRefExoticComponent<Omit<i
100
108
  */
101
109
  stretch?: BreakpointCustomizable<boolean>;
102
110
  /**
103
- * Target attribute where the link should be opened.
111
+ * Specifies where to open the linked document.
104
112
  */
105
113
  target?: LinkPureTarget;
106
114
  /**
@@ -18,11 +18,11 @@ export type PLinkTileProductProps = BaseProps & {
18
18
  */
19
19
  href?: string;
20
20
  /**
21
- * A Boolean attribute indicating that a like button should be shown.
21
+ * Shows a like button.
22
22
  */
23
23
  likeButton?: boolean;
24
24
  /**
25
- * A Boolean attribute indicating that a product is liked.
25
+ * Indicates whether the product is liked.
26
26
  */
27
27
  liked?: boolean;
28
28
  /**
@@ -38,11 +38,11 @@ export type PLinkTileProductProps = BaseProps & {
38
38
  */
39
39
  priceOriginal?: string;
40
40
  /**
41
- * Specifies the relationship of the target object to the link object.
41
+ * Sets the `rel` attribute on the link.
42
42
  */
43
43
  rel?: string;
44
44
  /**
45
- * Target attribute where the link should be opened.
45
+ * Specifies where to open the linked document.
46
46
  */
47
47
  target?: LinkTileProductTarget;
48
48
  };
@@ -64,11 +64,11 @@ export declare const PLinkTileProduct: import("react").ForwardRefExoticComponent
64
64
  */
65
65
  href?: string;
66
66
  /**
67
- * A Boolean attribute indicating that a like button should be shown.
67
+ * Shows a like button.
68
68
  */
69
69
  likeButton?: boolean;
70
70
  /**
71
- * A Boolean attribute indicating that a product is liked.
71
+ * Indicates whether the product is liked.
72
72
  */
73
73
  liked?: boolean;
74
74
  /**
@@ -84,11 +84,11 @@ export declare const PLinkTileProduct: import("react").ForwardRefExoticComponent
84
84
  */
85
85
  priceOriginal?: string;
86
86
  /**
87
- * Specifies the relationship of the target object to the link object.
87
+ * Sets the `rel` attribute on the link.
88
88
  */
89
89
  rel?: string;
90
90
  /**
91
- * Target attribute where the link should be opened.
91
+ * Specifies where to open the linked document.
92
92
  */
93
93
  target?: LinkTileProductTarget;
94
94
  } & {
@@ -6,7 +6,7 @@ export type PLinkTileProps = BaseProps & {
6
6
  */
7
7
  align?: LinkTileAlign;
8
8
  /**
9
- * Add ARIA attributes.
9
+ * Sets ARIA attributes.
10
10
  */
11
11
  aria?: SelectedAriaAttributes<LinkTileAriaAttribute>;
12
12
  /**
@@ -22,7 +22,7 @@ export type PLinkTileProps = BaseProps & {
22
22
  */
23
23
  description: string;
24
24
  /**
25
- * Special download attribute to open native browser download dialog if target url points to a downloadable file.
25
+ * Sets the native `download` attribute when the target URL points to a downloadable file.
26
26
  */
27
27
  download?: string;
28
28
  /**
@@ -38,7 +38,7 @@ export type PLinkTileProps = BaseProps & {
38
38
  */
39
39
  label: string;
40
40
  /**
41
- * Specifies the relationship of the target object to the link object.
41
+ * Sets the `rel` attribute on the link.
42
42
  */
43
43
  rel?: string;
44
44
  /**
@@ -46,7 +46,7 @@ export type PLinkTileProps = BaseProps & {
46
46
  */
47
47
  size?: BreakpointCustomizable<LinkTileSize>;
48
48
  /**
49
- * Target attribute where the link should be opened.
49
+ * Specifies where to open the linked document.
50
50
  */
51
51
  target?: LinkTileTarget;
52
52
  /**
@@ -60,7 +60,7 @@ export declare const PLinkTile: import("react").ForwardRefExoticComponent<Omit<i
60
60
  */
61
61
  align?: LinkTileAlign;
62
62
  /**
63
- * Add ARIA attributes.
63
+ * Sets ARIA attributes.
64
64
  */
65
65
  aria?: SelectedAriaAttributes<LinkTileAriaAttribute>;
66
66
  /**
@@ -76,7 +76,7 @@ export declare const PLinkTile: import("react").ForwardRefExoticComponent<Omit<i
76
76
  */
77
77
  description: string;
78
78
  /**
79
- * Special download attribute to open native browser download dialog if target url points to a downloadable file.
79
+ * Sets the native `download` attribute when the target URL points to a downloadable file.
80
80
  */
81
81
  download?: string;
82
82
  /**
@@ -92,7 +92,7 @@ export declare const PLinkTile: import("react").ForwardRefExoticComponent<Omit<i
92
92
  */
93
93
  label: string;
94
94
  /**
95
- * Specifies the relationship of the target object to the link object.
95
+ * Sets the `rel` attribute on the link.
96
96
  */
97
97
  rel?: string;
98
98
  /**
@@ -100,7 +100,7 @@ export declare const PLinkTile: import("react").ForwardRefExoticComponent<Omit<i
100
100
  */
101
101
  size?: BreakpointCustomizable<LinkTileSize>;
102
102
  /**
103
- * Target attribute where the link should be opened.
103
+ * Specifies where to open the linked document.
104
104
  */
105
105
  target?: LinkTileTarget;
106
106
  /**
@@ -2,23 +2,23 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { SelectedAriaAttributes, LinkAriaAttribute, BreakpointCustomizable, LinkIcon, LinkTarget, LinkVariant } from '../types';
3
3
  export type PLinkProps = BaseProps & {
4
4
  /**
5
- * Add ARIA attributes.
5
+ * Sets ARIA attributes.
6
6
  */
7
7
  aria?: SelectedAriaAttributes<LinkAriaAttribute>;
8
8
  /**
9
- * Displays as compact version.
9
+ * Displays the link in compact mode.
10
10
  */
11
11
  compact?: BreakpointCustomizable<boolean>;
12
12
  /**
13
- * Special download attribute to open native browser download dialog if target url points to a downloadable file.
13
+ * Sets the native `download` attribute when the target URL points to a downloadable file.
14
14
  */
15
15
  download?: string;
16
16
  /**
17
- * Show or hide label. For better accessibility it is recommended to show the label.
17
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
18
18
  */
19
19
  hideLabel?: BreakpointCustomizable<boolean>;
20
20
  /**
21
- * When providing an url then the component will be rendered as `<a>`.
21
+ * When `href` is provided, the component renders as an `<a>` element.
22
22
  */
23
23
  href?: string;
24
24
  /**
@@ -30,11 +30,11 @@ export type PLinkProps = BaseProps & {
30
30
  */
31
31
  iconSource?: string;
32
32
  /**
33
- * Specifies the relationship of the target object to the link object.
33
+ * Sets the `rel` attribute on the link.
34
34
  */
35
35
  rel?: string;
36
36
  /**
37
- * Target attribute where the link should be opened.
37
+ * Specifies where to open the linked document.
38
38
  */
39
39
  target?: LinkTarget;
40
40
  /**
@@ -44,23 +44,23 @@ export type PLinkProps = BaseProps & {
44
44
  };
45
45
  export declare const PLink: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
46
46
  /**
47
- * Add ARIA attributes.
47
+ * Sets ARIA attributes.
48
48
  */
49
49
  aria?: SelectedAriaAttributes<LinkAriaAttribute>;
50
50
  /**
51
- * Displays as compact version.
51
+ * Displays the link in compact mode.
52
52
  */
53
53
  compact?: BreakpointCustomizable<boolean>;
54
54
  /**
55
- * Special download attribute to open native browser download dialog if target url points to a downloadable file.
55
+ * Sets the native `download` attribute when the target URL points to a downloadable file.
56
56
  */
57
57
  download?: string;
58
58
  /**
59
- * Show or hide label. For better accessibility it is recommended to show the label.
59
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
60
60
  */
61
61
  hideLabel?: BreakpointCustomizable<boolean>;
62
62
  /**
63
- * When providing an url then the component will be rendered as `<a>`.
63
+ * When `href` is provided, the component renders as an `<a>` element.
64
64
  */
65
65
  href?: string;
66
66
  /**
@@ -72,11 +72,11 @@ export declare const PLink: import("react").ForwardRefExoticComponent<Omit<impor
72
72
  */
73
73
  iconSource?: string;
74
74
  /**
75
- * Specifies the relationship of the target object to the link object.
75
+ * Sets the `rel` attribute on the link.
76
76
  */
77
77
  rel?: string;
78
78
  /**
79
- * Target attribute where the link should be opened.
79
+ * Specifies where to open the linked document.
80
80
  */
81
81
  target?: LinkTarget;
82
82
  /**
@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { SelectedAriaAttributes, ModalAriaAttribute, ModalBackdrop, ModalBackground, BreakpointCustomizable, ModalMotionHiddenEndEventDetail, ModalMotionVisibleEndEventDetail } from '../types';
3
3
  export type PModalProps = BaseProps & {
4
4
  /**
5
- * Add ARIA attributes.
5
+ * Sets ARIA attributes.
6
6
  */
7
7
  aria?: SelectedAriaAttributes<ModalAriaAttribute>;
8
8
  /**
@@ -44,7 +44,7 @@ export type PModalProps = BaseProps & {
44
44
  };
45
45
  export declare const PModal: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
46
46
  /**
47
- * Add ARIA attributes.
47
+ * Sets ARIA attributes.
48
48
  */
49
49
  aria?: SelectedAriaAttributes<ModalAriaAttribute>;
50
50
  /**
@@ -6,7 +6,7 @@ export type PModelSignatureProps = BaseProps & {
6
6
  */
7
7
  color?: ModelSignatureColor;
8
8
  /**
9
- * Defines the fetch priority of the model signature. In the end it is just a recommendation to the browser, but it defines the priority on its own.
9
+ * Sets the browser's fetch priority hint for the model signature asset.
10
10
  */
11
11
  fetchPriority?: ModelSignatureFetchPriority;
12
12
  /**
@@ -32,7 +32,7 @@ export declare const PModelSignature: import("react").ForwardRefExoticComponent<
32
32
  */
33
33
  color?: ModelSignatureColor;
34
34
  /**
35
- * Defines the fetch priority of the model signature. In the end it is just a recommendation to the browser, but it defines the priority on its own.
35
+ * Sets the browser's fetch priority hint for the model signature asset.
36
36
  */
37
37
  fetchPriority?: ModelSignatureFetchPriority;
38
38
  /**
@@ -2,11 +2,11 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { MultiSelectDropdownDirection, BreakpointCustomizable, MultiSelectChangeEventDetail, MultiSelectToggleEventDetail, MultiSelectState } from '../types';
3
3
  export type PMultiSelectProps = BaseProps & {
4
4
  /**
5
- * Displays as compact version.
5
+ * Displays the multi-select in compact mode.
6
6
  */
7
7
  compact?: boolean;
8
8
  /**
9
- * The description text.
9
+ * Supplementary text providing more context or explanation for the multi-select.
10
10
  */
11
11
  description?: string;
12
12
  /**
@@ -22,11 +22,11 @@ export type PMultiSelectProps = BaseProps & {
22
22
  */
23
23
  form?: string;
24
24
  /**
25
- * Show or hide label. For better accessibility it is recommended to show the label.
25
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
26
26
  */
27
27
  hideLabel?: BreakpointCustomizable<boolean>;
28
28
  /**
29
- * The label text.
29
+ * Text content for a user-facing label.
30
30
  */
31
31
  label?: string;
32
32
  /**
@@ -50,7 +50,7 @@ export type PMultiSelectProps = BaseProps & {
50
50
  */
51
51
  onToggle?: (event: CustomEvent<MultiSelectToggleEventDetail>) => void;
52
52
  /**
53
- * A Boolean attribute indicating that an option with a non-empty string value must be selected.
53
+ * Requires an option with a non-empty string value to be selected.
54
54
  */
55
55
  required?: boolean;
56
56
  /**
@@ -64,11 +64,11 @@ export type PMultiSelectProps = BaseProps & {
64
64
  };
65
65
  export declare const PMultiSelect: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
66
66
  /**
67
- * Displays as compact version.
67
+ * Displays the multi-select in compact mode.
68
68
  */
69
69
  compact?: boolean;
70
70
  /**
71
- * The description text.
71
+ * Supplementary text providing more context or explanation for the multi-select.
72
72
  */
73
73
  description?: string;
74
74
  /**
@@ -84,11 +84,11 @@ export declare const PMultiSelect: import("react").ForwardRefExoticComponent<Omi
84
84
  */
85
85
  form?: string;
86
86
  /**
87
- * Show or hide label. For better accessibility it is recommended to show the label.
87
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
88
88
  */
89
89
  hideLabel?: BreakpointCustomizable<boolean>;
90
90
  /**
91
- * The label text.
91
+ * Text content for a user-facing label.
92
92
  */
93
93
  label?: string;
94
94
  /**
@@ -112,7 +112,7 @@ export declare const PMultiSelect: import("react").ForwardRefExoticComponent<Omi
112
112
  */
113
113
  onToggle?: (event: CustomEvent<MultiSelectToggleEventDetail>) => void;
114
114
  /**
115
- * A Boolean attribute indicating that an option with a non-empty string value must be selected.
115
+ * Requires an option with a non-empty string value to be selected.
116
116
  */
117
117
  required?: boolean;
118
118
  /**
@@ -2,11 +2,11 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { BreakpointCustomizable, PinCodeLength, PinCodeChangeEventDetail, PinCodeState, PinCodeType } from '../types';
3
3
  export type PPinCodeProps = BaseProps & {
4
4
  /**
5
- * A boolean value that, if present, renders the pin-code as a compact version.
5
+ * Displays the pin code in compact mode.
6
6
  */
7
7
  compact?: boolean;
8
8
  /**
9
- * The description text.
9
+ * Supplementary text providing more context or explanation for the pin code.
10
10
  */
11
11
  description?: string;
12
12
  /**
@@ -18,11 +18,11 @@ export type PPinCodeProps = BaseProps & {
18
18
  */
19
19
  form?: string;
20
20
  /**
21
- * Show or hide label and description text. For better accessibility it is recommended to show the label.
21
+ * Shows or hides the label and description. For better accessibility, it is recommended to show the label.
22
22
  */
23
23
  hideLabel?: BreakpointCustomizable<boolean>;
24
24
  /**
25
- * The label text.
25
+ * Text content for a user-facing label.
26
26
  */
27
27
  label?: string;
28
28
  /**
@@ -68,11 +68,11 @@ export type PPinCodeProps = BaseProps & {
68
68
  };
69
69
  export declare const PPinCode: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
70
70
  /**
71
- * A boolean value that, if present, renders the pin-code as a compact version.
71
+ * Displays the pin code in compact mode.
72
72
  */
73
73
  compact?: boolean;
74
74
  /**
75
- * The description text.
75
+ * Supplementary text providing more context or explanation for the pin code.
76
76
  */
77
77
  description?: string;
78
78
  /**
@@ -84,11 +84,11 @@ export declare const PPinCode: import("react").ForwardRefExoticComponent<Omit<im
84
84
  */
85
85
  form?: string;
86
86
  /**
87
- * Show or hide label and description text. For better accessibility it is recommended to show the label.
87
+ * Shows or hides the label and description. For better accessibility, it is recommended to show the label.
88
88
  */
89
89
  hideLabel?: BreakpointCustomizable<boolean>;
90
90
  /**
91
- * The label text.
91
+ * Text content for a user-facing label.
92
92
  */
93
93
  label?: string;
94
94
  /**
@@ -2,29 +2,29 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { SelectedAriaAttributes, PopoverAriaAttribute, PopoverDirection } from '../types';
3
3
  export type PPopoverProps = BaseProps & {
4
4
  /**
5
- * Add ARIA attributes.
5
+ * Sets ARIA attributes.
6
6
  */
7
7
  aria?: SelectedAriaAttributes<PopoverAriaAttribute>;
8
8
  /**
9
- * Descriptive text to show additional information when popover is open
9
+ * Descriptive text shown when the popover is open.
10
10
  */
11
11
  description?: string;
12
12
  /**
13
- * Preferred direction in which popover should open, given there is enough space in viewport. Otherwise, it will be opened in the direction with most available space.
13
+ * Preferred direction in which the popover should open when there is enough space in the viewport. Otherwise, it opens in the direction with the most available space.
14
14
  */
15
15
  direction?: PopoverDirection;
16
16
  };
17
17
  export declare const PPopover: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
18
18
  /**
19
- * Add ARIA attributes.
19
+ * Sets ARIA attributes.
20
20
  */
21
21
  aria?: SelectedAriaAttributes<PopoverAriaAttribute>;
22
22
  /**
23
- * Descriptive text to show additional information when popover is open
23
+ * Descriptive text shown when the popover is open.
24
24
  */
25
25
  description?: string;
26
26
  /**
27
- * Preferred direction in which popover should open, given there is enough space in viewport. Otherwise, it will be opened in the direction with most available space.
27
+ * Preferred direction in which the popover should open when there is enough space in the viewport. Otherwise, it opens in the direction with the most available space.
28
28
  */
29
29
  direction?: PopoverDirection;
30
30
  } & {
@@ -1,7 +1,7 @@
1
1
  import type { BaseProps } from '../../BaseProps';
2
2
  export type PRadioGroupOptionProps = BaseProps & {
3
3
  /**
4
- * A boolean value that, if present, makes the radio group option unusable and unclickable.
4
+ * Disables the radio group option. The value will not be submitted with the form.
5
5
  */
6
6
  disabled?: boolean;
7
7
  /**
@@ -19,7 +19,7 @@ export type PRadioGroupOptionProps = BaseProps & {
19
19
  };
20
20
  export declare const PRadioGroupOption: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
21
21
  /**
22
- * A boolean value that, if present, makes the radio group option unusable and unclickable.
22
+ * Disables the radio group option. The value will not be submitted with the form.
23
23
  */
24
24
  disabled?: boolean;
25
25
  /**