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

package/esm/lib/components/link.wrapper.d.ts

@@ -2,23 +2,23 @@ import type { BaseProps } from '../../BaseProps';
 import type { SelectedAriaAttributes, LinkAriaAttribute, BreakpointCustomizable, LinkIcon, LinkTarget, LinkVariant } from '../types';
 export type PLinkProps = BaseProps & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<LinkAriaAttribute>;
     /**
-     * Displays as compact version.
+     * Displays the link in compact mode.
      */
     compact?: BreakpointCustomizable<boolean>;
     /**
-     * Special download attribute to open native browser download dialog if target url points to a downloadable file.
+     * Sets the native `download` attribute when the target URL points to a downloadable file.
      */
     download?: string;
     /**
-     * Show or hide label. For better accessibility it is recommended to show the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * When providing an url then the component will be rendered as `<a>`.
+     * When `href` is provided, the component renders as an `<a>` element.
      */
     href?: string;
     /**
@@ -30,11 +30,11 @@ export type PLinkProps = BaseProps & {
      */
     iconSource?: string;
     /**
-     * Specifies the relationship of the target object to the link object.
+     * Sets the `rel` attribute on the link.
      */
     rel?: string;
     /**
-     * Target attribute where the link should be opened.
+     * Specifies where to open the linked document.
      */
     target?: LinkTarget;
     /**
@@ -44,23 +44,23 @@ export type PLinkProps = BaseProps & {
 };
 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"> & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<LinkAriaAttribute>;
     /**
-     * Displays as compact version.
+     * Displays the link in compact mode.
      */
     compact?: BreakpointCustomizable<boolean>;
     /**
-     * Special download attribute to open native browser download dialog if target url points to a downloadable file.
+     * Sets the native `download` attribute when the target URL points to a downloadable file.
      */
     download?: string;
     /**
-     * Show or hide label. For better accessibility it is recommended to show the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * When providing an url then the component will be rendered as `<a>`.
+     * When `href` is provided, the component renders as an `<a>` element.
      */
     href?: string;
     /**
@@ -72,11 +72,11 @@ export declare const PLink: import("react").ForwardRefExoticComponent<Omit<impor
      */
     iconSource?: string;
     /**
-     * Specifies the relationship of the target object to the link object.
+     * Sets the `rel` attribute on the link.
      */
     rel?: string;
     /**
-     * Target attribute where the link should be opened.
+     * Specifies where to open the linked document.
      */
     target?: LinkTarget;
     /**

package/esm/lib/components/modal.wrapper.d.ts

@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
 import type { SelectedAriaAttributes, ModalAriaAttribute, ModalBackdrop, ModalBackground, BreakpointCustomizable, ModalMotionHiddenEndEventDetail, ModalMotionVisibleEndEventDetail } from '../types';
 export type PModalProps = BaseProps & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<ModalAriaAttribute>;
     /**
@@ -44,7 +44,7 @@ export type PModalProps = BaseProps & {
 };
 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"> & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<ModalAriaAttribute>;
     /**

package/esm/lib/components/model-signature.wrapper.d.ts

@@ -6,7 +6,7 @@ export type PModelSignatureProps = BaseProps & {
      */
     color?: ModelSignatureColor;
     /**
-     * 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.
+     * Sets the browser's fetch priority hint for the model signature asset.
      */
     fetchPriority?: ModelSignatureFetchPriority;
     /**
@@ -32,7 +32,7 @@ export declare const PModelSignature: import("react").ForwardRefExoticComponent<
      */
     color?: ModelSignatureColor;
     /**
-     * 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.
+     * Sets the browser's fetch priority hint for the model signature asset.
      */
     fetchPriority?: ModelSignatureFetchPriority;
     /**

package/esm/lib/components/multi-select.wrapper.d.ts

@@ -2,11 +2,11 @@ import type { BaseProps } from '../../BaseProps';
 import type { MultiSelectDropdownDirection, BreakpointCustomizable, MultiSelectChangeEventDetail, MultiSelectToggleEventDetail, MultiSelectState } from '../types';
 export type PMultiSelectProps = BaseProps & {
     /**
-     * Displays as compact version.
+     * Displays the multi-select in compact mode.
      */
     compact?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the multi-select.
      */
     description?: string;
     /**
@@ -22,11 +22,11 @@ export type PMultiSelectProps = BaseProps & {
      */
     form?: string;
     /**
-     * Show or hide label. For better accessibility it is recommended to show the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -50,7 +50,7 @@ export type PMultiSelectProps = BaseProps & {
      */
     onToggle?: (event: CustomEvent<MultiSelectToggleEventDetail>) => void;
     /**
-     * A Boolean attribute indicating that an option with a non-empty string value must be selected.
+     * Requires an option with a non-empty string value to be selected.
      */
     required?: boolean;
     /**
@@ -64,11 +64,11 @@ export type PMultiSelectProps = BaseProps & {
 };
 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"> & {
     /**
-     * Displays as compact version.
+     * Displays the multi-select in compact mode.
      */
     compact?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the multi-select.
      */
     description?: string;
     /**
@@ -84,11 +84,11 @@ export declare const PMultiSelect: import("react").ForwardRefExoticComponent<Omi
      */
     form?: string;
     /**
-     * Show or hide label. For better accessibility it is recommended to show the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -112,7 +112,7 @@ export declare const PMultiSelect: import("react").ForwardRefExoticComponent<Omi
      */
     onToggle?: (event: CustomEvent<MultiSelectToggleEventDetail>) => void;
     /**
-     * A Boolean attribute indicating that an option with a non-empty string value must be selected.
+     * Requires an option with a non-empty string value to be selected.
      */
     required?: boolean;
     /**

package/esm/lib/components/pin-code.wrapper.d.ts

@@ -2,11 +2,11 @@ import type { BaseProps } from '../../BaseProps';
 import type { BreakpointCustomizable, PinCodeLength, PinCodeChangeEventDetail, PinCodeState, PinCodeType } from '../types';
 export type PPinCodeProps = BaseProps & {
     /**
-     * A boolean value that, if present, renders the pin-code as a compact version.
+     * Displays the pin code in compact mode.
      */
     compact?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the pin code.
      */
     description?: string;
     /**
@@ -18,11 +18,11 @@ export type PPinCodeProps = BaseProps & {
      */
     form?: string;
     /**
-     * Show or hide label and description text. For better accessibility it is recommended to show the label.
+     * Shows or hides the label and description. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -68,11 +68,11 @@ export type PPinCodeProps = BaseProps & {
 };
 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"> & {
     /**
-     * A boolean value that, if present, renders the pin-code as a compact version.
+     * Displays the pin code in compact mode.
      */
     compact?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the pin code.
      */
     description?: string;
     /**
@@ -84,11 +84,11 @@ export declare const PPinCode: import("react").ForwardRefExoticComponent<Omit<im
      */
     form?: string;
     /**
-     * Show or hide label and description text. For better accessibility it is recommended to show the label.
+     * Shows or hides the label and description. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**

package/esm/lib/components/popover.wrapper.d.ts

@@ -2,29 +2,29 @@ import type { BaseProps } from '../../BaseProps';
 import type { SelectedAriaAttributes, PopoverAriaAttribute, PopoverDirection } from '../types';
 export type PPopoverProps = BaseProps & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<PopoverAriaAttribute>;
     /**
-     * Descriptive text to show additional information when popover is open
+     * Descriptive text shown when the popover is open.
      */
     description?: string;
     /**
-     * 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.
+     * 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.
      */
     direction?: PopoverDirection;
 };
 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"> & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<PopoverAriaAttribute>;
     /**
-     * Descriptive text to show additional information when popover is open
+     * Descriptive text shown when the popover is open.
      */
     description?: string;
     /**
-     * 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.
+     * 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.
      */
     direction?: PopoverDirection;
 } & {

package/esm/lib/components/radio-group-option.wrapper.d.ts

@@ -1,7 +1,7 @@
 import type { BaseProps } from '../../BaseProps';
 export type PRadioGroupOptionProps = BaseProps & {
     /**
-     * A boolean value that, if present, makes the radio group option unusable and unclickable.
+     * Disables the radio group option. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -19,7 +19,7 @@ export type PRadioGroupOptionProps = BaseProps & {
 };
 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"> & {
     /**
-     * A boolean value that, if present, makes the radio group option unusable and unclickable.
+     * Disables the radio group option. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**

package/esm/lib/components/radio-group.wrapper.d.ts

@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
 import type { BreakpointCustomizable, RadioGroupDirection, RadioGroupChangeEventDetail, RadioGroupState } from '../types';
 export type PRadioGroupProps = BaseProps & {
     /**
-     * A boolean value that, if present, renders the radio group as a compact version.
+     * Displays the radio group in compact mode.
      */
     compact?: boolean;
     /**
@@ -10,11 +10,11 @@ export type PRadioGroupProps = BaseProps & {
      */
     description?: string;
     /**
-     * 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.
+     * 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.
      */
     direction?: BreakpointCustomizable<RadioGroupDirection>;
     /**
-     * A boolean value that, if present, makes the radio group unusable and unclickable. The value will not be submitted with the form.
+     * Disables the radio group. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -22,7 +22,7 @@ export type PRadioGroupProps = BaseProps & {
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -64,7 +64,7 @@ export type PRadioGroupProps = BaseProps & {
 };
 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"> & {
     /**
-     * A boolean value that, if present, renders the radio group as a compact version.
+     * Displays the radio group in compact mode.
      */
     compact?: boolean;
     /**
@@ -72,11 +72,11 @@ export declare const PRadioGroup: import("react").ForwardRefExoticComponent<Omit
      */
     description?: string;
     /**
-     * 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.
+     * 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.
      */
     direction?: BreakpointCustomizable<RadioGroupDirection>;
     /**
-     * A boolean value that, if present, makes the radio group unusable and unclickable. The value will not be submitted with the form.
+     * Disables the radio group. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -84,7 +84,7 @@ export declare const PRadioGroup: import("react").ForwardRefExoticComponent<Omit
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**

package/esm/lib/components/scroller.wrapper.d.ts

@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
 import type { ScrollerAlignScrollIndicator, SelectedAriaAttributes, ScrollerAriaAttribute, ScrollerScrollToPosition } from '../types';
 export type PScrollerProps = BaseProps & {
     /**
-     * Sets the vertical position of scroll indicator.
+     * @deprecated since v4.0.0, will be removed with next major release, has no effect anymore.
      */
     alignScrollIndicator?: ScrollerAlignScrollIndicator;
     /**
@@ -10,17 +10,25 @@ export type PScrollerProps = BaseProps & {
      */
     aria?: SelectedAriaAttributes<ScrollerAriaAttribute>;
     /**
-     * Scrolls the scroll area to the left either smooth or immediately.
+     * Displays with reduced spacing and smaller padding for a more condensed layout.
+     */
+    compact?: boolean;
+    /**
+     * @deprecated since v4.0.0, use native `scrollIntoView()` on the slotted element itself.
      */
     scrollToPosition?: ScrollerScrollToPosition;
     /**
      * Specifies if scrollbar should be shown.
      */
     scrollbar?: boolean;
+    /**
+     * @experimental Makes the indicator sticky at the top or bottom while scrolling depending on the scroll direction.
+     */
+    sticky?: boolean;
 };
 export declare const PScroller: 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"> & {
     /**
-     * Sets the vertical position of scroll indicator.
+     * @deprecated since v4.0.0, will be removed with next major release, has no effect anymore.
      */
     alignScrollIndicator?: ScrollerAlignScrollIndicator;
     /**
@@ -28,13 +36,21 @@ export declare const PScroller: import("react").ForwardRefExoticComponent<Omit<i
      */
     aria?: SelectedAriaAttributes<ScrollerAriaAttribute>;
     /**
-     * Scrolls the scroll area to the left either smooth or immediately.
+     * Displays with reduced spacing and smaller padding for a more condensed layout.
+     */
+    compact?: boolean;
+    /**
+     * @deprecated since v4.0.0, use native `scrollIntoView()` on the slotted element itself.
      */
     scrollToPosition?: ScrollerScrollToPosition;
     /**
      * Specifies if scrollbar should be shown.
      */
     scrollbar?: boolean;
+    /**
+     * @experimental Makes the indicator sticky at the top or bottom while scrolling depending on the scroll direction.
+     */
+    sticky?: boolean;
 } & {
     children?: import("react").ReactNode | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/scroller.wrapper.mjs

@@ -4,13 +4,13 @@ import { forwardRef, useRef } from 'react';
 import { usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
 import { syncRef } from '../../utils.mjs';
 
-const PScroller = /*#__PURE__*/ forwardRef(({ alignScrollIndicator = 'center', aria, scrollToPosition, scrollbar = false, className, ...rest }, ref) => {
+const PScroller = /*#__PURE__*/ forwardRef(({ alignScrollIndicator = 'center', aria, compact, scrollToPosition, scrollbar = false, sticky = false, className, ...rest }, ref) => {
     const elementRef = useRef(undefined);
     const WebComponentTag = usePrefix('p-scroller');
-    const propsToSync = [alignScrollIndicator, aria, scrollToPosition, scrollbar];
+    const propsToSync = [alignScrollIndicator, aria, compact, scrollToPosition, scrollbar, sticky];
     useBrowserLayoutEffect(() => {
         const { current } = elementRef;
-        ['alignScrollIndicator', 'aria', 'scrollToPosition', 'scrollbar'].forEach((propName, i) => (current[propName] = propsToSync[i]));
+        ['alignScrollIndicator', 'aria', 'compact', 'scrollToPosition', 'scrollbar', 'sticky'].forEach((propName, i) => (current[propName] = propsToSync[i]));
     }, propsToSync);
     const props = {
         ...rest,

package/esm/lib/components/segmented-control-item.wrapper.d.ts

@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
 import type { SelectedAriaAttributes, SegmentedControlItemAriaAttribute, SegmentedControlItemIcon } from '../types';
 export type PSegmentedControlItemProps = BaseProps & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<SegmentedControlItemAriaAttribute>;
     /**
@@ -18,7 +18,7 @@ export type PSegmentedControlItemProps = BaseProps & {
      */
     iconSource?: string;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -28,7 +28,7 @@ export type PSegmentedControlItemProps = BaseProps & {
 };
 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"> & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<SegmentedControlItemAriaAttribute>;
     /**
@@ -44,7 +44,7 @@ export declare const PSegmentedControlItem: import("react").ForwardRefExoticComp
      */
     iconSource?: string;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**

package/esm/lib/components/segmented-control.wrapper.d.ts

@@ -6,7 +6,7 @@ export type PSegmentedControlProps = BaseProps & {
      */
     columns?: BreakpointCustomizable<SegmentedControlColumns>;
     /**
-     * A boolean value that, if present, renders the segmented-control as a compact version.
+     * Displays the segmented control in compact mode.
      */
     compact?: boolean;
     /**
@@ -22,7 +22,7 @@ export type PSegmentedControlProps = BaseProps & {
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -64,7 +64,7 @@ export declare const PSegmentedControl: import("react").ForwardRefExoticComponen
      */
     columns?: BreakpointCustomizable<SegmentedControlColumns>;
     /**
-     * A boolean value that, if present, renders the segmented-control as a compact version.
+     * Displays the segmented control in compact mode.
      */
     compact?: boolean;
     /**
@@ -80,7 +80,7 @@ export declare const PSegmentedControl: import("react").ForwardRefExoticComponen
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**

package/esm/lib/components/select.wrapper.d.ts

@@ -2,11 +2,11 @@ import type { BaseProps } from '../../BaseProps';
 import type { SelectDropdownDirection, BreakpointCustomizable, SelectChangeEventDetail, SelectToggleEventDetail, SelectState } from '../types';
 export type PSelectProps = BaseProps & {
     /**
-     * Displays as compact version.
+     * Displays the select in compact mode.
      */
     compact?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the select.
      */
     description?: string;
     /**
@@ -26,11 +26,11 @@ export type PSelectProps = BaseProps & {
      */
     form?: string;
     /**
-     * Show or hide label. For better accessibility it is recommended to show the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -54,7 +54,7 @@ export type PSelectProps = BaseProps & {
      */
     onToggle?: (event: CustomEvent<SelectToggleEventDetail>) => void;
     /**
-     * A Boolean attribute indicating that an option with a non-empty string value must be selected.
+     * Requires an option with a non-empty string value to be selected.
      */
     required?: boolean;
     /**
@@ -68,11 +68,11 @@ export type PSelectProps = BaseProps & {
 };
 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"> & {
     /**
-     * Displays as compact version.
+     * Displays the select in compact mode.
      */
     compact?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the select.
      */
     description?: string;
     /**
@@ -92,11 +92,11 @@ export declare const PSelect: import("react").ForwardRefExoticComponent<Omit<imp
      */
     form?: string;
     /**
-     * Show or hide label. For better accessibility it is recommended to show the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -120,7 +120,7 @@ export declare const PSelect: import("react").ForwardRefExoticComponent<Omit<imp
      */
     onToggle?: (event: CustomEvent<SelectToggleEventDetail>) => void;
     /**
-     * A Boolean attribute indicating that an option with a non-empty string value must be selected.
+     * Requires an option with a non-empty string value to be selected.
      */
     required?: boolean;
     /**

package/esm/lib/components/sheet.wrapper.d.ts

@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
 import type { SelectedAriaAttributes, SheetAriaAttribute, SheetBackground, SheetMotionHiddenEndEventDetail, SheetMotionVisibleEndEventDetail } from '../types';
 export type PSheetProps = BaseProps & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<SheetAriaAttribute>;
     /**
@@ -36,7 +36,7 @@ export type PSheetProps = BaseProps & {
 };
 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"> & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<SheetAriaAttribute>;
     /**