@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
@@ -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
  /**
@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { BreakpointCustomizable, RadioGroupDirection, RadioGroupChangeEventDetail, RadioGroupState } from '../types';
3
3
  export type PRadioGroupProps = BaseProps & {
4
4
  /**
5
- * A boolean value that, if present, renders the radio group as a compact version.
5
+ * Displays the radio group in compact mode.
6
6
  */
7
7
  compact?: boolean;
8
8
  /**
@@ -10,11 +10,11 @@ export type PRadioGroupProps = BaseProps & {
10
10
  */
11
11
  description?: string;
12
12
  /**
13
- * Defines the direction of the main and cross axis. The default is 'column' showing options vertically stacked. You always need to provide a base value when using breakpoints.
13
+ * Defines the direction of the main and cross-axis. The default is `column`, which stacks the options vertically. You always need to provide a base value when using breakpoints.
14
14
  */
15
15
  direction?: BreakpointCustomizable<RadioGroupDirection>;
16
16
  /**
17
- * A boolean value that, if present, makes the radio group unusable and unclickable. The value will not be submitted with the form.
17
+ * Disables the radio group. The value will not be submitted with the form.
18
18
  */
19
19
  disabled?: boolean;
20
20
  /**
@@ -22,7 +22,7 @@ export type PRadioGroupProps = 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
  /**
@@ -64,7 +64,7 @@ export type PRadioGroupProps = BaseProps & {
64
64
  };
65
65
  export declare const PRadioGroup: 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
- * A boolean value that, if present, renders the radio group as a compact version.
67
+ * Displays the radio group in compact mode.
68
68
  */
69
69
  compact?: boolean;
70
70
  /**
@@ -72,11 +72,11 @@ export declare const PRadioGroup: import("react").ForwardRefExoticComponent<Omit
72
72
  */
73
73
  description?: string;
74
74
  /**
75
- * Defines the direction of the main and cross axis. The default is 'column' showing options vertically stacked. You always need to provide a base value when using breakpoints.
75
+ * Defines the direction of the main and cross-axis. The default is `column`, which stacks the options vertically. You always need to provide a base value when using breakpoints.
76
76
  */
77
77
  direction?: BreakpointCustomizable<RadioGroupDirection>;
78
78
  /**
79
- * A boolean value that, if present, makes the radio group unusable and unclickable. The value will not be submitted with the form.
79
+ * Disables the radio group. The value will not be submitted with the form.
80
80
  */
81
81
  disabled?: boolean;
82
82
  /**
@@ -84,7 +84,7 @@ export declare const PRadioGroup: import("react").ForwardRefExoticComponent<Omit
84
84
  */
85
85
  form?: string;
86
86
  /**
87
- * Controls the visibility of 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
  /**
@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { SelectedAriaAttributes, SegmentedControlItemAriaAttribute, SegmentedControlItemIcon } from '../types';
3
3
  export type PSegmentedControlItemProps = BaseProps & {
4
4
  /**
5
- * Add ARIA attributes.
5
+ * Sets ARIA attributes.
6
6
  */
7
7
  aria?: SelectedAriaAttributes<SegmentedControlItemAriaAttribute>;
8
8
  /**
@@ -18,7 +18,7 @@ export type PSegmentedControlItemProps = BaseProps & {
18
18
  */
19
19
  iconSource?: string;
20
20
  /**
21
- * The label text.
21
+ * Text content for a user-facing label.
22
22
  */
23
23
  label?: string;
24
24
  /**
@@ -28,7 +28,7 @@ export type PSegmentedControlItemProps = BaseProps & {
28
28
  };
29
29
  export declare const PSegmentedControlItem: 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"> & {
30
30
  /**
31
- * Add ARIA attributes.
31
+ * Sets ARIA attributes.
32
32
  */
33
33
  aria?: SelectedAriaAttributes<SegmentedControlItemAriaAttribute>;
34
34
  /**
@@ -44,7 +44,7 @@ export declare const PSegmentedControlItem: import("react").ForwardRefExoticComp
44
44
  */
45
45
  iconSource?: string;
46
46
  /**
47
- * The label text.
47
+ * Text content for a user-facing label.
48
48
  */
49
49
  label?: string;
50
50
  /**
@@ -6,7 +6,7 @@ export type PSegmentedControlProps = BaseProps & {
6
6
  */
7
7
  columns?: BreakpointCustomizable<SegmentedControlColumns>;
8
8
  /**
9
- * A boolean value that, if present, renders the segmented-control as a compact version.
9
+ * Displays the segmented control in compact mode.
10
10
  */
11
11
  compact?: boolean;
12
12
  /**
@@ -22,7 +22,7 @@ export type PSegmentedControlProps = 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
  /**
@@ -64,7 +64,7 @@ export declare const PSegmentedControl: import("react").ForwardRefExoticComponen
64
64
  */
65
65
  columns?: BreakpointCustomizable<SegmentedControlColumns>;
66
66
  /**
67
- * A boolean value that, if present, renders the segmented-control as a compact version.
67
+ * Displays the segmented control in compact mode.
68
68
  */
69
69
  compact?: boolean;
70
70
  /**
@@ -80,7 +80,7 @@ export declare const PSegmentedControl: import("react").ForwardRefExoticComponen
80
80
  */
81
81
  form?: string;
82
82
  /**
83
- * Controls the visibility of the label.
83
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
84
84
  */
85
85
  hideLabel?: BreakpointCustomizable<boolean>;
86
86
  /**
@@ -2,11 +2,11 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { SelectDropdownDirection, BreakpointCustomizable, SelectChangeEventDetail, SelectToggleEventDetail, SelectState } from '../types';
3
3
  export type PSelectProps = BaseProps & {
4
4
  /**
5
- * Displays as compact version.
5
+ * Displays the 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 select.
10
10
  */
11
11
  description?: string;
12
12
  /**
@@ -26,11 +26,11 @@ export type PSelectProps = BaseProps & {
26
26
  */
27
27
  form?: string;
28
28
  /**
29
- * Show or hide label. For better accessibility it is recommended to show the label.
29
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
30
30
  */
31
31
  hideLabel?: BreakpointCustomizable<boolean>;
32
32
  /**
33
- * The label text.
33
+ * Text content for a user-facing label.
34
34
  */
35
35
  label?: string;
36
36
  /**
@@ -54,7 +54,7 @@ export type PSelectProps = BaseProps & {
54
54
  */
55
55
  onToggle?: (event: CustomEvent<SelectToggleEventDetail>) => void;
56
56
  /**
57
- * A Boolean attribute indicating that an option with a non-empty string value must be selected.
57
+ * Requires an option with a non-empty string value to be selected.
58
58
  */
59
59
  required?: boolean;
60
60
  /**
@@ -68,11 +68,11 @@ export type PSelectProps = BaseProps & {
68
68
  };
69
69
  export declare const PSelect: 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
- * Displays as compact version.
71
+ * Displays the select 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 select.
76
76
  */
77
77
  description?: string;
78
78
  /**
@@ -92,11 +92,11 @@ export declare const PSelect: import("react").ForwardRefExoticComponent<Omit<imp
92
92
  */
93
93
  form?: string;
94
94
  /**
95
- * Show or hide label. For better accessibility it is recommended to show the label.
95
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
96
96
  */
97
97
  hideLabel?: BreakpointCustomizable<boolean>;
98
98
  /**
99
- * The label text.
99
+ * Text content for a user-facing label.
100
100
  */
101
101
  label?: string;
102
102
  /**
@@ -120,7 +120,7 @@ export declare const PSelect: import("react").ForwardRefExoticComponent<Omit<imp
120
120
  */
121
121
  onToggle?: (event: CustomEvent<SelectToggleEventDetail>) => void;
122
122
  /**
123
- * A Boolean attribute indicating that an option with a non-empty string value must be selected.
123
+ * Requires an option with a non-empty string value to be selected.
124
124
  */
125
125
  required?: boolean;
126
126
  /**
@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { SelectedAriaAttributes, SheetAriaAttribute, SheetBackground, SheetMotionHiddenEndEventDetail, SheetMotionVisibleEndEventDetail } from '../types';
3
3
  export type PSheetProps = BaseProps & {
4
4
  /**
5
- * Add ARIA attributes.
5
+ * Sets ARIA attributes.
6
6
  */
7
7
  aria?: SelectedAriaAttributes<SheetAriaAttribute>;
8
8
  /**
@@ -36,7 +36,7 @@ export type PSheetProps = BaseProps & {
36
36
  };
37
37
  export declare const PSheet: 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"> & {
38
38
  /**
39
- * Add ARIA attributes.
39
+ * Sets ARIA attributes.
40
40
  */
41
41
  aria?: SelectedAriaAttributes<SheetAriaAttribute>;
42
42
  /**
@@ -1,22 +1,30 @@
1
1
  import type { BaseProps } from '../../BaseProps';
2
- import type { SelectedAriaAttributes, SpinnerAriaAttribute, BreakpointCustomizable, SpinnerSize } from '../types';
2
+ import type { SelectedAriaAttributes, SpinnerAriaAttribute, SpinnerColor, BreakpointCustomizable, SpinnerSize } from '../types';
3
3
  export type PSpinnerProps = BaseProps & {
4
4
  /**
5
- * Add ARIA attributes.
5
+ * Sets ARIA attributes.
6
6
  */
7
7
  aria?: SelectedAriaAttributes<SpinnerAriaAttribute>;
8
8
  /**
9
- * Size of the spinner.
9
+ * Basic color variations.
10
+ */
11
+ color?: SpinnerColor;
12
+ /**
13
+ * Defines the size of the spinner, aligned with the typographic scale used by components such as p-icon, p-flag, p-text, and p-heading. When set to `inherit`, the size is derived from a custom font-size defined on a parent element, calculated against the global line-height (based on `ex`-unit) to remain visually consistent with other typographic-scale-based components.
10
14
  */
11
15
  size?: BreakpointCustomizable<SpinnerSize>;
12
16
  };
13
17
  export declare const PSpinner: 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"> & {
14
18
  /**
15
- * Add ARIA attributes.
19
+ * Sets ARIA attributes.
16
20
  */
17
21
  aria?: SelectedAriaAttributes<SpinnerAriaAttribute>;
18
22
  /**
19
- * Size of the spinner.
23
+ * Basic color variations.
24
+ */
25
+ color?: SpinnerColor;
26
+ /**
27
+ * Defines the size of the spinner, aligned with the typographic scale used by components such as p-icon, p-flag, p-text, and p-heading. When set to `inherit`, the size is derived from a custom font-size defined on a parent element, calculated against the global line-height (based on `ex`-unit) to remain visually consistent with other typographic-scale-based components.
20
28
  */
21
29
  size?: BreakpointCustomizable<SpinnerSize>;
22
30
  } & import("react").RefAttributes<HTMLElement>>;
@@ -4,13 +4,13 @@ import { forwardRef, useRef } from 'react';
4
4
  import { usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
5
5
  import { syncRef } from '../../utils.mjs';
6
6
 
7
- const PSpinner = /*#__PURE__*/ forwardRef(({ aria, size = 'small', className, ...rest }, ref) => {
7
+ const PSpinner = /*#__PURE__*/ forwardRef(({ aria, color = 'primary', size = 'sm', className, ...rest }, ref) => {
8
8
  const elementRef = useRef(undefined);
9
9
  const WebComponentTag = usePrefix('p-spinner');
10
- const propsToSync = [aria, size];
10
+ const propsToSync = [aria, color, size];
11
11
  useBrowserLayoutEffect(() => {
12
12
  const { current } = elementRef;
13
- ['aria', 'size'].forEach((propName, i) => (current[propName] = propsToSync[i]));
13
+ ['aria', 'color', 'size'].forEach((propName, i) => (current[propName] = propsToSync[i]));
14
14
  }, propsToSync);
15
15
  const props = {
16
16
  ...rest,
@@ -10,7 +10,7 @@ export type PSwitchProps = BaseProps & {
10
10
  */
11
11
  checked?: boolean;
12
12
  /**
13
- * Displays as compact version.
13
+ * Displays the switch in compact mode.
14
14
  */
15
15
  compact?: boolean;
16
16
  /**
@@ -18,7 +18,7 @@ export type PSwitchProps = BaseProps & {
18
18
  */
19
19
  disabled?: boolean;
20
20
  /**
21
- * Show or hide label. For better accessibility it's recommended to show the label.
21
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
22
22
  */
23
23
  hideLabel?: BreakpointCustomizable<boolean>;
24
24
  /**
@@ -26,7 +26,7 @@ export type PSwitchProps = BaseProps & {
26
26
  */
27
27
  loading?: boolean;
28
28
  /**
29
- * Emitted when checked status is changed.
29
+ * Emitted when the checked state changes.
30
30
  */
31
31
  onUpdate?: (event: CustomEvent<SwitchUpdateEventDetail>) => void;
32
32
  /**
@@ -44,7 +44,7 @@ export declare const PSwitch: import("react").ForwardRefExoticComponent<Omit<imp
44
44
  */
45
45
  checked?: boolean;
46
46
  /**
47
- * Displays as compact version.
47
+ * Displays the switch in compact mode.
48
48
  */
49
49
  compact?: boolean;
50
50
  /**
@@ -52,7 +52,7 @@ export declare const PSwitch: import("react").ForwardRefExoticComponent<Omit<imp
52
52
  */
53
53
  disabled?: boolean;
54
54
  /**
55
- * Show or hide label. For better accessibility it's recommended to show the label.
55
+ * Shows or hides the label. For better accessibility, it is recommended to show the label.
56
56
  */
57
57
  hideLabel?: BreakpointCustomizable<boolean>;
58
58
  /**
@@ -60,7 +60,7 @@ export declare const PSwitch: import("react").ForwardRefExoticComponent<Omit<imp
60
60
  */
61
61
  loading?: boolean;
62
62
  /**
63
- * Emitted when checked status is changed.
63
+ * Emitted when the checked state changes.
64
64
  */
65
65
  onUpdate?: (event: CustomEvent<SwitchUpdateEventDetail>) => void;
66
66
  /**
@@ -1,13 +1,13 @@
1
1
  import type { BaseProps } from '../../BaseProps';
2
2
  export type PTableCellProps = BaseProps & {
3
3
  /**
4
- * Displays slotted text multiline or forced into a single line.
4
+ * Allows slotted text to wrap onto multiple lines instead of being forced onto a single line.
5
5
  */
6
6
  multiline?: boolean;
7
7
  };
8
8
  export declare const PTableCell: 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"> & {
9
9
  /**
10
- * Displays slotted text multiline or forced into a single line.
10
+ * Allows slotted text to wrap onto multiple lines instead of being forced onto a single line.
11
11
  */
12
12
  multiline?: boolean;
13
13
  } & {
@@ -2,11 +2,11 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { TableHeadCellSort } from '../types';
3
3
  export type PTableHeadCellProps = BaseProps & {
4
4
  /**
5
- * Hides the label but stays accessible for screen readers. This property only takes effect when sort property is not defined.
5
+ * Hides the label but keeps it accessible for screen readers. This property only takes effect when the `sort` prop is not set.
6
6
  */
7
7
  hideLabel?: boolean;
8
8
  /**
9
- * Displays slotted text multiline or forced into a single line.
9
+ * Allows slotted text to wrap onto multiple lines instead of being forced onto a single line.
10
10
  */
11
11
  multiline?: boolean;
12
12
  /**
@@ -16,11 +16,11 @@ export type PTableHeadCellProps = BaseProps & {
16
16
  };
17
17
  export declare const PTableHeadCell: 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
- * Hides the label but stays accessible for screen readers. This property only takes effect when sort property is not defined.
19
+ * Hides the label but keeps it accessible for screen readers. This property only takes effect when the `sort` prop is not set.
20
20
  */
21
21
  hideLabel?: boolean;
22
22
  /**
23
- * Displays slotted text multiline or forced into a single line.
23
+ * Allows slotted text to wrap onto multiple lines instead of being forced onto a single line.
24
24
  */
25
25
  multiline?: boolean;
26
26
  /**
@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { TabsBarBackground, TabsBarUpdateEventDetail, BreakpointCustomizable, TabsBarSize, TabsBarWeight } from '../types';
3
3
  export type PTabsBarProps = BaseProps & {
4
4
  /**
5
- * Defines which tab to be visualized as selected (zero-based numbering), undefined if none should be selected.
5
+ * Defines which tab is shown as selected (zero-based numbering), or `undefined` if none should be selected.
6
6
  */
7
7
  activeTabIndex?: number | undefined;
8
8
  /**
@@ -28,7 +28,7 @@ export type PTabsBarProps = BaseProps & {
28
28
  };
29
29
  export declare const PTabsBar: 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"> & {
30
30
  /**
31
- * Defines which tab to be visualized as selected (zero-based numbering), undefined if none should be selected.
31
+ * Defines which tab is shown as selected (zero-based numbering), or `undefined` if none should be selected.
32
32
  */
33
33
  activeTabIndex?: number | undefined;
34
34
  /**
@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
2
2
  import type { TabsBackground, TabsUpdateEventDetail, BreakpointCustomizable, TabsSize, TabsWeight } from '../types';
3
3
  export type PTabsProps = BaseProps & {
4
4
  /**
5
- * Defines which tab to be visualized as selected (zero-based numbering).
5
+ * Defines which tab is shown as selected (zero-based numbering).
6
6
  */
7
7
  activeTabIndex?: number;
8
8
  /**
@@ -28,7 +28,7 @@ export type PTabsProps = BaseProps & {
28
28
  };
29
29
  export declare const PTabs: 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"> & {
30
30
  /**
31
- * Defines which tab to be visualized as selected (zero-based numbering).
31
+ * Defines which tab is shown as selected (zero-based numbering).
32
32
  */
33
33
  activeTabIndex?: number;
34
34
  /**