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

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

@@ -3,14 +3,17 @@ import type { BreakpointCustomizable, PinCodeLength, PinCodeChangeEventDetail, P
 export type PPinCodeProps = BaseProps & {
     /**
      * Displays the pin code in compact mode.
+     * @default false
      */
     compact?: boolean;
     /**
      * Supplementary text providing more context or explanation for the pin code.
+     * @default ''
      */
     description?: string;
     /**
      * Disables the Pin Code. No events will be triggered while disabled state is active.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -19,22 +22,27 @@ export type PPinCodeProps = BaseProps & {
     form?: string;
     /**
      * Shows or hides the label and description. For better accessibility, it is recommended to show the label.
+     * @default false
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
      * Text content for a user-facing label.
+     * @default ''
      */
     label?: string;
     /**
      * Number of characters of the Pin Code.
+     * @default 4
      */
     length?: PinCodeLength;
     /**
      * Disables the Pin Code and shows a loading indicator. No events will be triggered while loading state is active.
+     * @default false
      */
     loading?: boolean;
     /**
      * The message styled depending on validation state.
+     * @default ''
      */
     message?: string;
     /**
@@ -51,32 +59,39 @@ export type PPinCodeProps = BaseProps & {
     onChange?: (event: CustomEvent<PinCodeChangeEventDetail>) => void;
     /**
      * Marks the Pin Code as required.
+     * @default false
      */
     required?: boolean;
     /**
      * The validation state.
+     * @default 'none'
      */
     state?: PinCodeState;
     /**
      * Pin Code type.
+     * @default 'number'
      */
     type?: PinCodeType;
     /**
      * Sets the initial value of the Pin Code.
+     * @default ''
      */
     value?: string;
 };
 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"> & {
     /**
      * Displays the pin code in compact mode.
+     * @default false
      */
     compact?: boolean;
     /**
      * Supplementary text providing more context or explanation for the pin code.
+     * @default ''
      */
     description?: string;
     /**
      * Disables the Pin Code. No events will be triggered while disabled state is active.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -85,22 +100,27 @@ export declare const PPinCode: import("react").ForwardRefExoticComponent<Omit<im
     form?: string;
     /**
      * Shows or hides the label and description. For better accessibility, it is recommended to show the label.
+     * @default false
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
      * Text content for a user-facing label.
+     * @default ''
      */
     label?: string;
     /**
      * Number of characters of the Pin Code.
+     * @default 4
      */
     length?: PinCodeLength;
     /**
      * Disables the Pin Code and shows a loading indicator. No events will be triggered while loading state is active.
+     * @default false
      */
     loading?: boolean;
     /**
      * The message styled depending on validation state.
+     * @default ''
      */
     message?: string;
     /**
@@ -117,18 +137,22 @@ export declare const PPinCode: import("react").ForwardRefExoticComponent<Omit<im
     onChange?: (event: CustomEvent<PinCodeChangeEventDetail>) => void;
     /**
      * Marks the Pin Code as required.
+     * @default false
      */
     required?: boolean;
     /**
      * The validation state.
+     * @default 'none'
      */
     state?: PinCodeState;
     /**
      * Pin Code type.
+     * @default 'number'
      */
     type?: PinCodeType;
     /**
      * Sets the initial value of the Pin Code.
+     * @default ''
      */
     value?: string;
 } & {

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

@@ -11,6 +11,7 @@ export type PPopoverProps = BaseProps & {
     description?: string;
     /**
      * 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.
+     * @default 'bottom'
      */
     direction?: PopoverDirection;
 };
@@ -25,6 +26,7 @@ export declare const PPopover: import("react").ForwardRefExoticComponent<Omit<im
     description?: string;
     /**
      * 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.
+     * @default 'bottom'
      */
     direction?: PopoverDirection;
 } & {

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

@@ -2,6 +2,7 @@ import type { BaseProps } from '../../BaseProps';
 export type PRadioGroupOptionProps = BaseProps & {
     /**
      * Disables the radio group option. The value will not be submitted with the form.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -10,6 +11,7 @@ export type PRadioGroupOptionProps = BaseProps & {
     label?: string;
     /**
      * @experimental Shows a loading indicator.
+     * @default false
      */
     loading?: boolean;
     /**
@@ -20,6 +22,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"> & {
     /**
      * Disables the radio group option. The value will not be submitted with the form.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -28,6 +31,7 @@ export declare const PRadioGroupOption: import("react").ForwardRefExoticComponen
     label?: string;
     /**
      * @experimental Shows a loading indicator.
+     * @default false
      */
     loading?: boolean;
     /**

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

@@ -3,18 +3,22 @@ import type { BreakpointCustomizable, RadioGroupDirection, RadioGroupChangeEvent
 export type PRadioGroupProps = BaseProps & {
     /**
      * Displays the radio group in compact mode.
+     * @default false
      */
     compact?: boolean;
     /**
      * Supplementary text providing more context or explanation for the radio group.
+     * @default ''
      */
     description?: string;
     /**
      * 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.
+     * @default 'column'
      */
     direction?: BreakpointCustomizable<RadioGroupDirection>;
     /**
      * Disables the radio group. The value will not be submitted with the form.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -23,18 +27,22 @@ export type PRadioGroupProps = BaseProps & {
     form?: string;
     /**
      * Shows or hides the label. For better accessibility, it is recommended to show the label.
+     * @default false
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
      * Text content for a user-facing label.
+     * @default ''
      */
     label?: string;
     /**
      * @experimental Shows a loading indicator.
+     * @default false
      */
     loading?: boolean;
     /**
      * Dynamic feedback text for validation or status.
+     * @default ''
      */
     message?: string;
     /**
@@ -51,32 +59,39 @@ export type PRadioGroupProps = BaseProps & {
     onChange?: (event: CustomEvent<RadioGroupChangeEventDetail>) => void;
     /**
      * A boolean value that specifies a selection must be made from the group before the form can be submitted.
+     * @default false
      */
     required?: boolean;
     /**
      * Indicates the validation or overall status of the radio group component.
+     * @default 'none'
      */
     state?: RadioGroupState;
     /**
      * The default value for the radio-group.
+     * @default ''
      */
     value?: string;
 };
 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"> & {
     /**
      * Displays the radio group in compact mode.
+     * @default false
      */
     compact?: boolean;
     /**
      * Supplementary text providing more context or explanation for the radio group.
+     * @default ''
      */
     description?: string;
     /**
      * 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.
+     * @default 'column'
      */
     direction?: BreakpointCustomizable<RadioGroupDirection>;
     /**
      * Disables the radio group. The value will not be submitted with the form.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -85,18 +100,22 @@ export declare const PRadioGroup: import("react").ForwardRefExoticComponent<Omit
     form?: string;
     /**
      * Shows or hides the label. For better accessibility, it is recommended to show the label.
+     * @default false
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
      * Text content for a user-facing label.
+     * @default ''
      */
     label?: string;
     /**
      * @experimental Shows a loading indicator.
+     * @default false
      */
     loading?: boolean;
     /**
      * Dynamic feedback text for validation or status.
+     * @default ''
      */
     message?: string;
     /**
@@ -113,14 +132,17 @@ export declare const PRadioGroup: import("react").ForwardRefExoticComponent<Omit
     onChange?: (event: CustomEvent<RadioGroupChangeEventDetail>) => void;
     /**
      * A boolean value that specifies a selection must be made from the group before the form can be submitted.
+     * @default false
      */
     required?: boolean;
     /**
      * Indicates the validation or overall status of the radio group component.
+     * @default 'none'
      */
     state?: RadioGroupState;
     /**
      * The default value for the radio-group.
+     * @default ''
      */
     value?: string;
 } & {

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

@@ -3,6 +3,7 @@ import type { ScrollerAlignScrollIndicator, SelectedAriaAttributes, ScrollerAria
 export type PScrollerProps = BaseProps & {
     /**
      * @deprecated since v4.0.0, will be removed with next major release, has no effect anymore.
+     * @default 'center'
      */
     alignScrollIndicator?: ScrollerAlignScrollIndicator;
     /**
@@ -19,16 +20,19 @@ export type PScrollerProps = BaseProps & {
     scrollToPosition?: ScrollerScrollToPosition;
     /**
      * Specifies if scrollbar should be shown.
+     * @default false
      */
     scrollbar?: boolean;
     /**
      * @experimental Makes the indicator sticky at the top or bottom while scrolling depending on the scroll direction.
+     * @default false
      */
     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"> & {
     /**
      * @deprecated since v4.0.0, will be removed with next major release, has no effect anymore.
+     * @default 'center'
      */
     alignScrollIndicator?: ScrollerAlignScrollIndicator;
     /**
@@ -45,10 +49,12 @@ export declare const PScroller: import("react").ForwardRefExoticComponent<Omit<i
     scrollToPosition?: ScrollerScrollToPosition;
     /**
      * Specifies if scrollbar should be shown.
+     * @default false
      */
     scrollbar?: boolean;
     /**
      * @experimental Makes the indicator sticky at the top or bottom while scrolling depending on the scroll direction.
+     * @default false
      */
     sticky?: boolean;
 } & {

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

@@ -7,6 +7,7 @@ export type PSegmentedControlItemProps = BaseProps & {
     aria?: SelectedAriaAttributes<SegmentedControlItemAriaAttribute>;
     /**
      * Disables the button. No events will be triggered while disabled state is active.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -33,6 +34,7 @@ export declare const PSegmentedControlItem: import("react").ForwardRefExoticComp
     aria?: SelectedAriaAttributes<SegmentedControlItemAriaAttribute>;
     /**
      * Disables the button. No events will be triggered while disabled state is active.
+     * @default false
      */
     disabled?: boolean;
     /**

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

@@ -3,18 +3,22 @@ import type { BreakpointCustomizable, SegmentedControlColumns, SegmentedControlC
 export type PSegmentedControlProps = BaseProps & {
     /**
      * Sets the amount of columns.
+     * @default 'auto'
      */
     columns?: BreakpointCustomizable<SegmentedControlColumns>;
     /**
      * Displays the segmented control in compact mode.
+     * @default false
      */
     compact?: boolean;
     /**
      * Supplementary text providing more context or explanation for the segmented-control.
+     * @default ''
      */
     description?: string;
     /**
      * Disables the segmented-control.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -23,14 +27,17 @@ export type PSegmentedControlProps = BaseProps & {
     form?: string;
     /**
      * Shows or hides the label. For better accessibility, it is recommended to show the label.
+     * @default false
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
      * Text content for a user-facing label.
+     * @default ''
      */
     label?: string;
     /**
      * Dynamic feedback text for validation or status.
+     * @default ''
      */
     message?: string;
     /**
@@ -47,10 +54,12 @@ export type PSegmentedControlProps = BaseProps & {
     onChange?: (event: CustomEvent<SegmentedControlChangeEventDetail>) => void;
     /**
      * A boolean value that specifies a selection must be made from the group before the form can be submitted.
+     * @default false
      */
     required?: boolean;
     /**
      * Indicates the validation or overall status of the component.
+     * @default 'none'
      */
     state?: SegmentedControlState;
     /**
@@ -61,18 +70,22 @@ export type PSegmentedControlProps = BaseProps & {
 export declare const PSegmentedControl: 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 amount of columns.
+     * @default 'auto'
      */
     columns?: BreakpointCustomizable<SegmentedControlColumns>;
     /**
      * Displays the segmented control in compact mode.
+     * @default false
      */
     compact?: boolean;
     /**
      * Supplementary text providing more context or explanation for the segmented-control.
+     * @default ''
      */
     description?: string;
     /**
      * Disables the segmented-control.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -81,14 +94,17 @@ export declare const PSegmentedControl: import("react").ForwardRefExoticComponen
     form?: string;
     /**
      * Shows or hides the label. For better accessibility, it is recommended to show the label.
+     * @default false
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
      * Text content for a user-facing label.
+     * @default ''
      */
     label?: string;
     /**
      * Dynamic feedback text for validation or status.
+     * @default ''
      */
     message?: string;
     /**
@@ -105,10 +121,12 @@ export declare const PSegmentedControl: import("react").ForwardRefExoticComponen
     onChange?: (event: CustomEvent<SegmentedControlChangeEventDetail>) => void;
     /**
      * A boolean value that specifies a selection must be made from the group before the form can be submitted.
+     * @default false
      */
     required?: boolean;
     /**
      * Indicates the validation or overall status of the component.
+     * @default 'none'
      */
     state?: SegmentedControlState;
     /**

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

@@ -2,6 +2,7 @@ import type { BaseProps } from '../../BaseProps';
 export type PSelectOptionProps = BaseProps & {
     /**
      * Disables the option.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -12,6 +13,7 @@ export type PSelectOptionProps = BaseProps & {
 export declare const PSelectOption: 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"> & {
     /**
      * Disables the option.
+     * @default false
      */
     disabled?: boolean;
     /**

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

@@ -3,22 +3,27 @@ import type { SelectDropdownDirection, BreakpointCustomizable, SelectChangeEvent
 export type PSelectProps = BaseProps & {
     /**
      * Displays the select in compact mode.
+     * @default false
      */
     compact?: boolean;
     /**
      * Supplementary text providing more context or explanation for the select.
+     * @default ''
      */
     description?: string;
     /**
      * Disables the select.
+     * @default false
      */
     disabled?: boolean;
     /**
      * Changes the direction to which the dropdown list appears.
+     * @default 'auto'
      */
     dropdownDirection?: SelectDropdownDirection;
     /**
      * Shows an input in the dropdown allowing options to be filtered. Will be ignored if the `filter` slot is used.
+     * @default false
      */
     filter?: boolean;
     /**
@@ -27,14 +32,17 @@ export type PSelectProps = BaseProps & {
     form?: string;
     /**
      * Shows or hides the label. For better accessibility, it is recommended to show the label.
+     * @default false
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
      * Text content for a user-facing label.
+     * @default ''
      */
     label?: string;
     /**
      * The message styled depending on validation state.
+     * @default ''
      */
     message?: string;
     /**
@@ -55,10 +63,12 @@ export type PSelectProps = BaseProps & {
     onToggle?: (event: CustomEvent<SelectToggleEventDetail>) => void;
     /**
      * Requires an option with a non-empty string value to be selected.
+     * @default false
      */
     required?: boolean;
     /**
      * The validation state.
+     * @default 'none'
      */
     state?: SelectState;
     /**
@@ -69,22 +79,27 @@ 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 the select in compact mode.
+     * @default false
      */
     compact?: boolean;
     /**
      * Supplementary text providing more context or explanation for the select.
+     * @default ''
      */
     description?: string;
     /**
      * Disables the select.
+     * @default false
      */
     disabled?: boolean;
     /**
      * Changes the direction to which the dropdown list appears.
+     * @default 'auto'
      */
     dropdownDirection?: SelectDropdownDirection;
     /**
      * Shows an input in the dropdown allowing options to be filtered. Will be ignored if the `filter` slot is used.
+     * @default false
      */
     filter?: boolean;
     /**
@@ -93,14 +108,17 @@ export declare const PSelect: import("react").ForwardRefExoticComponent<Omit<imp
     form?: string;
     /**
      * Shows or hides the label. For better accessibility, it is recommended to show the label.
+     * @default false
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
      * Text content for a user-facing label.
+     * @default ''
      */
     label?: string;
     /**
      * The message styled depending on validation state.
+     * @default ''
      */
     message?: string;
     /**
@@ -121,10 +139,12 @@ export declare const PSelect: import("react").ForwardRefExoticComponent<Omit<imp
     onToggle?: (event: CustomEvent<SelectToggleEventDetail>) => void;
     /**
      * Requires an option with a non-empty string value to be selected.
+     * @default false
      */
     required?: boolean;
     /**
      * The validation state.
+     * @default 'none'
      */
     state?: SelectState;
     /**

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

@@ -7,14 +7,17 @@ export type PSheetProps = BaseProps & {
     aria?: SelectedAriaAttributes<SheetAriaAttribute>;
     /**
      * Defines the background color
+     * @default 'canvas'
      */
     background?: SheetBackground;
     /**
      * If true, the sheet will not be closable via backdrop click.
+     * @default false
      */
     disableBackdropClick?: boolean;
     /**
      * If false, the sheet will not have a dismiss button.
+     * @default true
      */
     dismissButton?: boolean;
     /**
@@ -31,6 +34,7 @@ export type PSheetProps = BaseProps & {
     onMotionVisibleEnd?: (event: CustomEvent<SheetMotionVisibleEndEventDetail>) => void;
     /**
      * If true, the sheet is open.
+     * @default false
      */
     open: boolean;
 };
@@ -41,14 +45,17 @@ export declare const PSheet: import("react").ForwardRefExoticComponent<Omit<impo
     aria?: SelectedAriaAttributes<SheetAriaAttribute>;
     /**
      * Defines the background color
+     * @default 'canvas'
      */
     background?: SheetBackground;
     /**
      * If true, the sheet will not be closable via backdrop click.
+     * @default false
      */
     disableBackdropClick?: boolean;
     /**
      * If false, the sheet will not have a dismiss button.
+     * @default true
      */
     dismissButton?: boolean;
     /**
@@ -65,6 +72,7 @@ export declare const PSheet: import("react").ForwardRefExoticComponent<Omit<impo
     onMotionVisibleEnd?: (event: CustomEvent<SheetMotionVisibleEndEventDetail>) => void;
     /**
      * If true, the sheet is open.
+     * @default false
      */
     open: boolean;
 } & {

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

@@ -7,10 +7,12 @@ export type PSpinnerProps = BaseProps & {
     aria?: SelectedAriaAttributes<SpinnerAriaAttribute>;
     /**
      * Basic color variations.
+     * @default 'primary'
      */
     color?: SpinnerColor;
     /**
      * 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.
+     * @default 'sm'
      */
     size?: BreakpointCustomizable<SpinnerSize>;
 };
@@ -21,10 +23,12 @@ export declare const PSpinner: import("react").ForwardRefExoticComponent<Omit<im
     aria?: SelectedAriaAttributes<SpinnerAriaAttribute>;
     /**
      * Basic color variations.
+     * @default 'primary'
      */
     color?: SpinnerColor;
     /**
      * 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.
+     * @default 'sm'
      */
     size?: BreakpointCustomizable<SpinnerSize>;
 } & import("react").RefAttributes<HTMLElement>>;