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

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-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;
     /**

package/ssr/esm/lib/components/textarea.wrapper.d.ts

@@ -1,48 +1,48 @@
 import type { BaseProps } from '../../BaseProps';
-import type { TextareaAutoComplete, BreakpointCustomizable, TextareaBlurEventDetail, TextareaChangeEventDetail, TextareaInputEventDetail, TextareaResize, TextareaState, Theme, TextareaWrap } from '../types';
+import type { BreakpointCustomizable, TextareaBlurEventDetail, TextareaChangeEventDetail, TextareaInputEventDetail, TextareaResize, TextareaState, Theme, TextareaWrap } from '../types';
 export type PTextareaProps = 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?: TextareaAutoComplete;
+    autoComplete?: string;
     /**
      * Show or hide the character counter.
      */
     counter?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the textarea.
      */
     description?: string;
     /**
-     * Marks the textarea as disabled.
+     * A boolean value that, if present, makes the textarea unusable and unclickable. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
-     * The id of a form element the textarea should be associated with.
+     * Specifies the id of the <form> element that the textarea belongs to (useful if the textarea is not a direct descendant of the form).
      */
     form?: string;
     /**
-     * Show or hide label. 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;
     /**
-     * The max length of the textarea.
+     * A non-negative integer specifying the maximum number of characters the user can enter into the textarea.
      */
     maxLength?: number;
     /**
-     * The message styled depending on validation state.
+     * Dynamic feedback text for validation or status.
      */
     message?: string;
     /**
-     * The min length of the textarea.
+     * A non-negative integer specifying the minimum number of characters required for the textarea's value to be considered valid.
      */
     minLength?: number;
     /**
-     * The name of the textarea.
+     * The name of the textarea, used when submitting the form data.
      */
     name: string;
     /**
@@ -58,15 +58,15 @@ export type PTextareaProps = BaseProps & {
      */
     onInput?: (event: CustomEvent<TextareaInputEventDetail>) => 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='Write your message here...'). This text is displayed when the textarea is empty.
      */
     placeholder?: string;
     /**
-     * Specifies whether the textarea should be read-only.
+     * A boolean value that, if present, makes the textarea uneditable by the user, but its value will still be submitted with the form.
      */
     readOnly?: boolean;
     /**
-     * Marks the textarea as required.
+     * A boolean value that, if present, indicates that the textarea must be filled out before the form can be submitted.
      */
     required?: boolean;
     /**
@@ -78,15 +78,15 @@ export type PTextareaProps = BaseProps & {
      */
     rows?: number;
     /**
-     * Specifies whether the input should have its spelling and grammar checked
+     * Specifies whether the textarea should have its spelling and grammar checked
      */
     spellCheck?: boolean;
     /**
-     * The validation state.
+     * Indicates the validation or overall status of the textarea component.
      */
     state?: TextareaState;
     /**
-     * Adapts the color depending on the theme.
+     * Controls the visual appearance of the component.
      */
     theme?: Theme;
     /**
@@ -94,53 +94,53 @@ export type PTextareaProps = BaseProps & {
      */
     value?: string;
     /**
-     * Handles wrapping behaviour of elements.
+     * Handles wrapping behavior of elements.
      */
     wrap?: TextareaWrap;
 };
 export declare const PTextarea: 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?: TextareaAutoComplete;
+    autoComplete?: string;
     /**
      * Show or hide the character counter.
      */
     counter?: boolean;
     /**
-     * The description text.
+     * Supplementary text providing more context or explanation for the textarea.
      */
     description?: string;
     /**
-     * Marks the textarea as disabled.
+     * A boolean value that, if present, makes the textarea unusable and unclickable. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
-     * The id of a form element the textarea should be associated with.
+     * Specifies the id of the <form> element that the textarea belongs to (useful if the textarea is not a direct descendant of the form).
      */
     form?: string;
     /**
-     * Show or hide label. 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;
     /**
-     * The max length of the textarea.
+     * A non-negative integer specifying the maximum number of characters the user can enter into the textarea.
      */
     maxLength?: number;
     /**
-     * The message styled depending on validation state.
+     * Dynamic feedback text for validation or status.
      */
     message?: string;
     /**
-     * The min length of the textarea.
+     * A non-negative integer specifying the minimum number of characters required for the textarea's value to be considered valid.
      */
     minLength?: number;
     /**
-     * The name of the textarea.
+     * The name of the textarea, used when submitting the form data.
      */
     name: string;
     /**
@@ -156,15 +156,15 @@ export declare const PTextarea: import("react").ForwardRefExoticComponent<import
      */
     onInput?: (event: CustomEvent<TextareaInputEventDetail>) => 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='Write your message here...'). This text is displayed when the textarea is empty.
      */
     placeholder?: string;
     /**
-     * Specifies whether the textarea should be read-only.
+     * A boolean value that, if present, makes the textarea uneditable by the user, but its value will still be submitted with the form.
      */
     readOnly?: boolean;
     /**
-     * Marks the textarea as required.
+     * A boolean value that, if present, indicates that the textarea must be filled out before the form can be submitted.
      */
     required?: boolean;
     /**
@@ -176,15 +176,15 @@ export declare const PTextarea: import("react").ForwardRefExoticComponent<import
      */
     rows?: number;
     /**
-     * Specifies whether the input should have its spelling and grammar checked
+     * Specifies whether the textarea should have its spelling and grammar checked
      */
     spellCheck?: boolean;
     /**
-     * The validation state.
+     * Indicates the validation or overall status of the textarea component.
      */
     state?: TextareaState;
     /**
-     * Adapts the color depending on the theme.
+     * Controls the visual appearance of the component.
      */
     theme?: Theme;
     /**
@@ -192,7 +192,7 @@ export declare const PTextarea: import("react").ForwardRefExoticComponent<import
      */
     value?: string;
     /**
-     * Handles wrapping behaviour of elements.
+     * Handles wrapping behavior of elements.
      */
     wrap?: TextareaWrap;
 } & {

package/ssr/esm/lib/dsr-components/input-base.d.ts

@@ -22,6 +22,8 @@ type InputBaseProps = {
     max?: number;
     min?: number;
     autoComplete?: string;
+    pattern?: string;
+    multiple?: boolean;
     type: string;
     value?: string;
     step?: number;

package/ssr/esm/lib/dsr-components/input-email.d.ts

@@ -0,0 +1,19 @@
+import { Component } from 'react';
+/**
+ * @slot {"name": "label", "description": "Shows a label. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed."}
+ * @slot {"name": "description", "description": "Shows a description. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed."}
+ * @slot {"name": "message", "description": "Shows a state message. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed."}
+ * @slot {"name": "start", "description": "Shows content at the start of the input (e.g. unit prefix)."}
+ * @slot {"name": "end", "description": "Shows content at the end of the input (e.g. toggle button, unit suffix)."}
+ */
+export declare class DSRInputEmail extends Component<any> {
+    host: HTMLElement;
+    private internals;
+    private initialLoading;
+    private inputElement;
+    private defaultValue;
+    formResetCallback(): void;
+    formDisabledCallback(): void;
+    formStateRestoreCallback(): void;
+    render(): JSX.Element;
+}