@porsche-design-system/components-react 3.29.0-rc.2 → 3.29.0-rc.3

package/esm/lib/components/input-password.wrapper.d.ts

@@ -1,32 +1,32 @@
 import type { BaseProps } from '../../BaseProps';
-import type { InputPasswordAutoComplete, BreakpointCustomizable, InputPasswordBlurEventDetail, InputPasswordChangeEventDetail, InputPasswordInputEventDetail, InputPasswordState, Theme } from '../types';
+import type { BreakpointCustomizable, InputPasswordBlurEventDetail, InputPasswordChangeEventDetail, InputPasswordInputEventDetail, InputPasswordState, Theme } from '../types';
 export type PInputPasswordProps = BaseProps & {
     /**
-     * Specifies whether the input can be autofilled by the browser
+     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='current-password').
      */
-    autoComplete?: InputPasswordAutoComplete;
+    autoComplete?: string;
     /**
-     * Displays as a compact version.
+     * A boolean value that, if present, renders the input field as a compact version.
      */
     compact?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the input.
      */
     description?: string;
     /**
-     * Marks the password input as disabled.
+     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
-     * The id of a form element the password input should be associated with.
+     * Specifies the id of the <form> element that the input belongs to (useful if the input is not a direct descendant of the form).
      */
     form?: string;
     /**
-     * Show or hide label and description text. For better accessibility it is recommended to show the label.
+     * Controls the visibility of the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -34,19 +34,19 @@ export type PInputPasswordProps = BaseProps & {
      */
     loading?: boolean;
     /**
-     * The max length of the password input.
+     * A non-negative integer specifying the maximum number of characters the user can enter into the input.
      */
     maxLength?: number;
     /**
-     * The message styled depending on validation state.
+     * Dynamic feedback text for validation or status.
      */
     message?: string;
     /**
-     * The min length of the password input.
+     * A non-negative integer specifying the minimum number of characters required for the input's value to be considered valid.
      */
     minLength?: number;
     /**
-     * The name of the password input.
+     * The name of the input field, used when submitting the form data.
      */
     name: string;
     /**
@@ -62,23 +62,23 @@ export type PInputPasswordProps = BaseProps & {
      */
     onInput?: (event: CustomEvent<InputPasswordInputEventDetail>) => void;
     /**
-     * The placeholder text.
+     * A string that provides a brief hint to the user about what kind of information is expected in the field (e.g., placeholder='Enter your password'). This text is displayed when the input field is empty.
      */
     placeholder?: string;
     /**
-     * Specifies whether the password input should be read-only.
+     * A boolean value that, if present, makes the input field uneditable by the user, but its value will still be submitted with the form.
      */
     readOnly?: boolean;
     /**
-     * Marks the password input as required.
+     * A boolean value that, if present, indicates that the input field must be filled out before the form can be submitted.
      */
     required?: boolean;
     /**
-     * The validation state.
+     * Indicates the validation or overall status of the input component.
      */
     state?: InputPasswordState;
     /**
-     * Adapts the color depending on the theme.
+     * Controls the visual appearance of the component.
      */
     theme?: Theme;
     /**
@@ -92,31 +92,31 @@ export type PInputPasswordProps = BaseProps & {
 };
 export declare const PInputPassword: import("react").ForwardRefExoticComponent<import("react").DOMAttributes<{}> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Specifies whether the input can be autofilled by the browser
+     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='current-password').
      */
-    autoComplete?: InputPasswordAutoComplete;
+    autoComplete?: string;
     /**
-     * Displays as a compact version.
+     * A boolean value that, if present, renders the input field as a compact version.
      */
     compact?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the input.
      */
     description?: string;
     /**
-     * Marks the password input as disabled.
+     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
-     * The id of a form element the password input should be associated with.
+     * Specifies the id of the <form> element that the input belongs to (useful if the input is not a direct descendant of the form).
      */
     form?: string;
     /**
-     * Show or hide label and description text. For better accessibility it is recommended to show the label.
+     * Controls the visibility of the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -124,19 +124,19 @@ export declare const PInputPassword: import("react").ForwardRefExoticComponent<i
      */
     loading?: boolean;
     /**
-     * The max length of the password input.
+     * A non-negative integer specifying the maximum number of characters the user can enter into the input.
      */
     maxLength?: number;
     /**
-     * The message styled depending on validation state.
+     * Dynamic feedback text for validation or status.
      */
     message?: string;
     /**
-     * The min length of the password input.
+     * A non-negative integer specifying the minimum number of characters required for the input's value to be considered valid.
      */
     minLength?: number;
     /**
-     * The name of the password input.
+     * The name of the input field, used when submitting the form data.
      */
     name: string;
     /**
@@ -152,23 +152,23 @@ export declare const PInputPassword: import("react").ForwardRefExoticComponent<i
      */
     onInput?: (event: CustomEvent<InputPasswordInputEventDetail>) => void;
     /**
-     * The placeholder text.
+     * A string that provides a brief hint to the user about what kind of information is expected in the field (e.g., placeholder='Enter your password'). This text is displayed when the input field is empty.
      */
     placeholder?: string;
     /**
-     * Specifies whether the password input should be read-only.
+     * A boolean value that, if present, makes the input field uneditable by the user, but its value will still be submitted with the form.
      */
     readOnly?: boolean;
     /**
-     * Marks the password input as required.
+     * A boolean value that, if present, indicates that the input field must be filled out before the form can be submitted.
      */
     required?: boolean;
     /**
-     * The validation state.
+     * Indicates the validation or overall status of the input component.
      */
     state?: InputPasswordState;
     /**
-     * Adapts the color depending on the theme.
+     * Controls the visual appearance of the component.
      */
     theme?: Theme;
     /**

package/esm/lib/components/input-search.wrapper.d.ts

@@ -1,32 +1,32 @@
 import type { BaseProps } from '../../BaseProps';
-import type { InputSearchAutoComplete, BreakpointCustomizable, InputSearchBlurEventDetail, InputSearchChangeEventDetail, InputSearchInputEventDetail, InputSearchState, Theme } from '../types';
+import type { BreakpointCustomizable, InputSearchBlurEventDetail, InputSearchChangeEventDetail, InputSearchInputEventDetail, InputSearchState, Theme } from '../types';
 export type PInputSearchProps = BaseProps & {
     /**
-     * Specifies whether the input can be autofilled by the browser
+     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='on').
      */
-    autoComplete?: InputSearchAutoComplete;
+    autoComplete?: string;
     /**
      * Show clear input value button
      */
     clear?: boolean;
     /**
-     * Displays as a compact version.
+     * A boolean value that, if present, renders the input field as a compact version.
      */
     compact?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the input.
      */
     description?: string;
     /**
-     * Marks the search input as disabled.
+     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
-     * The id of a form element the search input should be associated with.
+     * Specifies the id of the <form> element that the input belongs to (useful if the input is not a direct descendant of the form).
      */
     form?: string;
     /**
-     * Show or hide label and description text. For better accessibility it is recommended to show the label.
+     * Controls the visibility of the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -34,7 +34,7 @@ export type PInputSearchProps = BaseProps & {
      */
     indicator?: boolean;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -42,11 +42,11 @@ export type PInputSearchProps = BaseProps & {
      */
     loading?: boolean;
     /**
-     * The message styled depending on validation state.
+     * Dynamic feedback text for validation or status.
      */
     message?: string;
     /**
-     * The name of the search input.
+     * The name of the input field, used when submitting the form data.
      */
     name: string;
     /**
@@ -62,23 +62,23 @@ export type PInputSearchProps = BaseProps & {
      */
     onInput?: (event: CustomEvent<InputSearchInputEventDetail>) => void;
     /**
-     * The placeholder text.
+     * A string that provides a brief hint to the user about what kind of information is expected in the field (e.g., placeholder='Search...'). This text is displayed when the input field is empty.
      */
     placeholder?: string;
     /**
-     * Specifies whether the search input should be read-only.
+     * A boolean value that, if present, makes the input field uneditable by the user, but its value will still be submitted with the form.
      */
     readOnly?: boolean;
     /**
-     * Marks the search input as required.
+     * A boolean value that, if present, indicates that the input field must be filled out before the form can be submitted.
      */
     required?: boolean;
     /**
-     * The validation state.
+     * Indicates the validation or overall status of the input component.
      */
     state?: InputSearchState;
     /**
-     * Adapts the color depending on the theme.
+     * Controls the visual appearance of the component.
      */
     theme?: Theme;
     /**
@@ -88,31 +88,31 @@ export type PInputSearchProps = BaseProps & {
 };
 export declare const PInputSearch: import("react").ForwardRefExoticComponent<import("react").DOMAttributes<{}> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Specifies whether the input can be autofilled by the browser
+     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='on').
      */
-    autoComplete?: InputSearchAutoComplete;
+    autoComplete?: string;
     /**
      * Show clear input value button
      */
     clear?: boolean;
     /**
-     * Displays as a compact version.
+     * A boolean value that, if present, renders the input field as a compact version.
      */
     compact?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the input.
      */
     description?: string;
     /**
-     * Marks the search input as disabled.
+     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
-     * The id of a form element the search input should be associated with.
+     * Specifies the id of the <form> element that the input belongs to (useful if the input is not a direct descendant of the form).
      */
     form?: string;
     /**
-     * Show or hide label and description text. For better accessibility it is recommended to show the label.
+     * Controls the visibility of the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -120,7 +120,7 @@ export declare const PInputSearch: import("react").ForwardRefExoticComponent<imp
      */
     indicator?: boolean;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -128,11 +128,11 @@ export declare const PInputSearch: import("react").ForwardRefExoticComponent<imp
      */
     loading?: boolean;
     /**
-     * The message styled depending on validation state.
+     * Dynamic feedback text for validation or status.
      */
     message?: string;
     /**
-     * The name of the search input.
+     * The name of the input field, used when submitting the form data.
      */
     name: string;
     /**
@@ -148,23 +148,23 @@ export declare const PInputSearch: import("react").ForwardRefExoticComponent<imp
      */
     onInput?: (event: CustomEvent<InputSearchInputEventDetail>) => void;
     /**
-     * The placeholder text.
+     * A string that provides a brief hint to the user about what kind of information is expected in the field (e.g., placeholder='Search...'). This text is displayed when the input field is empty.
      */
     placeholder?: string;
     /**
-     * Specifies whether the search input should be read-only.
+     * A boolean value that, if present, makes the input field uneditable by the user, but its value will still be submitted with the form.
      */
     readOnly?: boolean;
     /**
-     * Marks the search input as required.
+     * A boolean value that, if present, indicates that the input field must be filled out before the form can be submitted.
      */
     required?: boolean;
     /**
-     * The validation state.
+     * Indicates the validation or overall status of the input component.
      */
     state?: InputSearchState;
     /**
-     * Adapts the color depending on the theme.
+     * Controls the visual appearance of the component.
      */
     theme?: Theme;
     /**

package/esm/lib/components/input-text.wrapper.d.ts

@@ -1,12 +1,12 @@
 import type { BaseProps } from '../../BaseProps';
-import type { InputTextAutoComplete, BreakpointCustomizable, InputTextBlurEventDetail, InputTextChangeEventDetail, InputTextInputEventDetail, InputTextState, Theme } from '../types';
+import type { BreakpointCustomizable, InputTextBlurEventDetail, InputTextChangeEventDetail, InputTextInputEventDetail, InputTextState, Theme } from '../types';
 export type PInputTextProps = BaseProps & {
     /**
-     * Specifies whether the input can be autofilled by the browser
+     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='name').
      */
-    autoComplete?: InputTextAutoComplete;
+    autoComplete?: string;
     /**
-     * Displays as a compact version.
+     * A boolean value that, if present, renders the input field as a compact version.
      */
     compact?: boolean;
     /**
@@ -14,23 +14,23 @@ export type PInputTextProps = BaseProps & {
      */
     counter?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the input.
      */
     description?: string;
     /**
-     * Marks the text input as disabled.
+     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
-     * The id of a form element the text input should be associated with.
+     * Specifies the id of the <form> element that the input belongs to (useful if the input is not a direct descendant of the form).
      */
     form?: string;
     /**
-     * Show or hide label and description text. For better accessibility, it is recommended to show the label.
+     * Controls the visibility of the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -38,19 +38,19 @@ export type PInputTextProps = BaseProps & {
      */
     loading?: boolean;
     /**
-     * The max length of the text input.
+     * A non-negative integer specifying the maximum number of characters the user can enter into the input.
      */
     maxLength?: number;
     /**
-     * The message styled depending on validation state.
+     * Dynamic feedback text for validation or status.
      */
     message?: string;
     /**
-     * The min length of the text input.
+     * A non-negative integer specifying the minimum number of characters required for the input's value to be considered valid.
      */
     minLength?: number;
     /**
-     * The name of the text input.
+     * The name of the input field, used when submitting the form data.
      */
     name: string;
     /**
@@ -66,15 +66,15 @@ export type PInputTextProps = BaseProps & {
      */
     onInput?: (event: CustomEvent<InputTextInputEventDetail>) => void;
     /**
-     * The placeholder text.
+     * A string that provides a brief hint to the user about what kind of information is expected in the field (e.g., placeholder='Enter your full name'). This text is displayed when the input field is empty.
      */
     placeholder?: string;
     /**
-     * Specifies whether the text input should be read-only.
+     * A boolean value that, if present, makes the input field uneditable by the user, but its value will still be submitted with the form.
      */
     readOnly?: boolean;
     /**
-     * Marks the text input as required.
+     * A boolean value that, if present, indicates that the input field must be filled out before the form can be submitted.
      */
     required?: boolean;
     /**
@@ -82,11 +82,11 @@ export type PInputTextProps = BaseProps & {
      */
     spellCheck?: boolean;
     /**
-     * The validation state.
+     * Indicates the validation or overall status of the input component.
      */
     state?: InputTextState;
     /**
-     * Adapts the color depending on the theme.
+     * Controls the visual appearance of the component.
      */
     theme?: Theme;
     /**
@@ -96,11 +96,11 @@ export type PInputTextProps = BaseProps & {
 };
 export declare const PInputText: import("react").ForwardRefExoticComponent<import("react").DOMAttributes<{}> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Specifies whether the input can be autofilled by the browser
+     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='name').
      */
-    autoComplete?: InputTextAutoComplete;
+    autoComplete?: string;
     /**
-     * Displays as a compact version.
+     * A boolean value that, if present, renders the input field as a compact version.
      */
     compact?: boolean;
     /**
@@ -108,23 +108,23 @@ export declare const PInputText: import("react").ForwardRefExoticComponent<impor
      */
     counter?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the input.
      */
     description?: string;
     /**
-     * Marks the text input as disabled.
+     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
-     * The id of a form element the text input should be associated with.
+     * Specifies the id of the <form> element that the input belongs to (useful if the input is not a direct descendant of the form).
      */
     form?: string;
     /**
-     * Show or hide label and description text. For better accessibility, it is recommended to show the label.
+     * Controls the visibility of the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
@@ -132,19 +132,19 @@ export declare const PInputText: import("react").ForwardRefExoticComponent<impor
      */
     loading?: boolean;
     /**
-     * The max length of the text input.
+     * A non-negative integer specifying the maximum number of characters the user can enter into the input.
      */
     maxLength?: number;
     /**
-     * The message styled depending on validation state.
+     * Dynamic feedback text for validation or status.
      */
     message?: string;
     /**
-     * The min length of the text input.
+     * A non-negative integer specifying the minimum number of characters required for the input's value to be considered valid.
      */
     minLength?: number;
     /**
-     * The name of the text input.
+     * The name of the input field, used when submitting the form data.
      */
     name: string;
     /**
@@ -160,15 +160,15 @@ export declare const PInputText: import("react").ForwardRefExoticComponent<impor
      */
     onInput?: (event: CustomEvent<InputTextInputEventDetail>) => void;
     /**
-     * The placeholder text.
+     * A string that provides a brief hint to the user about what kind of information is expected in the field (e.g., placeholder='Enter your full name'). This text is displayed when the input field is empty.
      */
     placeholder?: string;
     /**
-     * Specifies whether the text input should be read-only.
+     * A boolean value that, if present, makes the input field uneditable by the user, but its value will still be submitted with the form.
      */
     readOnly?: boolean;
     /**
-     * Marks the text input as required.
+     * A boolean value that, if present, indicates that the input field must be filled out before the form can be submitted.
      */
     required?: boolean;
     /**
@@ -176,11 +176,11 @@ export declare const PInputText: import("react").ForwardRefExoticComponent<impor
      */
     spellCheck?: boolean;
     /**
-     * The validation state.
+     * Indicates the validation or overall status of the input component.
      */
     state?: InputTextState;
     /**
-     * Adapts the color depending on the theme.
+     * Controls the visual appearance of the component.
      */
     theme?: Theme;
     /**