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

package/ssr/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='new-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='new-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/ssr/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/ssr/esm/lib/components/input-tel.wrapper.d.ts

@@ -0,0 +1,192 @@
+import type { BaseProps } from '../../BaseProps';
+import type { BreakpointCustomizable, InputTelBlurEventDetail, InputTelChangeEventDetail, InputTelInputEventDetail, InputTelState, Theme } from '../types';
+export type PInputTelProps = BaseProps & {
+    /**
+     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='tel').
+     */
+    autoComplete?: string;
+    /**
+     * A boolean value that, if present, renders the input field as a compact version.
+     */
+    compact?: boolean;
+    /**
+     * Supplementary text providing more context or explanation for the input.
+     */
+    description?: string;
+    /**
+     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     */
+    disabled?: boolean;
+    /**
+     * 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;
+    /**
+     * Controls the visibility of the label.
+     */
+    hideLabel?: BreakpointCustomizable<boolean>;
+    /**
+     * Controls the visibility of the phone icon.
+     */
+    indicator?: boolean;
+    /**
+     * Text content for a user-facing label.
+     */
+    label?: string;
+    /**
+     * @experimental Shows a loading indicator.
+     */
+    loading?: boolean;
+    /**
+     * A non-negative integer specifying the maximum number of characters the user can enter into the input.
+     */
+    maxLength?: number;
+    /**
+     * Dynamic feedback text for validation or status.
+     */
+    message?: string;
+    /**
+     * 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 input field, used when submitting the form data.
+     */
+    name: string;
+    /**
+     * Emitted when the tel input has lost focus.
+     */
+    onBlur?: (event: CustomEvent<InputTelBlurEventDetail>) => void;
+    /**
+     * Emitted when the tel input loses focus after its value was changed.
+     */
+    onChange?: (event: CustomEvent<InputTelChangeEventDetail>) => void;
+    /**
+     * Emitted when the value has been changed as a direct result of a user action.
+     */
+    onInput?: (event: CustomEvent<InputTelInputEventDetail>) => void;
+    /**
+     * Specifies a regular expression that the input's value must match for the value to pass constraint validation. This allows for more specific tel validation rules than the browser's default. If provided, it overrides the browser's default tel validation.
+     */
+    pattern?: string;
+    /**
+     * A string that provides a brief hint to the user about what kind of information is expected in the field (e.g., placeholder='(123) 456-7890')
+     */
+    placeholder?: string;
+    /**
+     * 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;
+    /**
+     * A boolean value that, if present, indicates that the input field must be filled out before the form can be submitted.
+     */
+    required?: boolean;
+    /**
+     * Indicates the validation or overall status of the input component.
+     */
+    state?: InputTelState;
+    /**
+     * Controls the visual appearance of the component.
+     */
+    theme?: Theme;
+    /**
+     * The tel input value.
+     */
+    value?: string;
+};
+export declare const PInputTel: import("react").ForwardRefExoticComponent<import("react").DOMAttributes<{}> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
+    /**
+     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='tel').
+     */
+    autoComplete?: string;
+    /**
+     * A boolean value that, if present, renders the input field as a compact version.
+     */
+    compact?: boolean;
+    /**
+     * Supplementary text providing more context or explanation for the input.
+     */
+    description?: string;
+    /**
+     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     */
+    disabled?: boolean;
+    /**
+     * 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;
+    /**
+     * Controls the visibility of the label.
+     */
+    hideLabel?: BreakpointCustomizable<boolean>;
+    /**
+     * Controls the visibility of the phone icon.
+     */
+    indicator?: boolean;
+    /**
+     * Text content for a user-facing label.
+     */
+    label?: string;
+    /**
+     * @experimental Shows a loading indicator.
+     */
+    loading?: boolean;
+    /**
+     * A non-negative integer specifying the maximum number of characters the user can enter into the input.
+     */
+    maxLength?: number;
+    /**
+     * Dynamic feedback text for validation or status.
+     */
+    message?: string;
+    /**
+     * 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 input field, used when submitting the form data.
+     */
+    name: string;
+    /**
+     * Emitted when the tel input has lost focus.
+     */
+    onBlur?: (event: CustomEvent<InputTelBlurEventDetail>) => void;
+    /**
+     * Emitted when the tel input loses focus after its value was changed.
+     */
+    onChange?: (event: CustomEvent<InputTelChangeEventDetail>) => void;
+    /**
+     * Emitted when the value has been changed as a direct result of a user action.
+     */
+    onInput?: (event: CustomEvent<InputTelInputEventDetail>) => void;
+    /**
+     * Specifies a regular expression that the input's value must match for the value to pass constraint validation. This allows for more specific tel validation rules than the browser's default. If provided, it overrides the browser's default tel validation.
+     */
+    pattern?: string;
+    /**
+     * A string that provides a brief hint to the user about what kind of information is expected in the field (e.g., placeholder='(123) 456-7890')
+     */
+    placeholder?: string;
+    /**
+     * 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;
+    /**
+     * A boolean value that, if present, indicates that the input field must be filled out before the form can be submitted.
+     */
+    required?: boolean;
+    /**
+     * Indicates the validation or overall status of the input component.
+     */
+    state?: InputTelState;
+    /**
+     * Controls the visual appearance of the component.
+     */
+    theme?: Theme;
+    /**
+     * The tel input value.
+     */
+    value?: string;
+} & {
+    children?: import("react").ReactNode | undefined;
+} & import("react").RefAttributes<HTMLElement>>;