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

package/esm/lib/components/TextareaWrapper.vue.d.ts

@@ -1,59 +1,59 @@
-import type { TextareaAutoComplete, BreakpointCustomizable, TextareaResize, TextareaState, Theme, TextareaWrap } from '../types';
+import type { BreakpointCustomizable, TextareaResize, TextareaState, Theme, TextareaWrap } from '../types';
 type PTextareaProps = {
     /**
-     * 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;
     /**
-     * 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;
     /**
@@ -65,15 +65,15 @@ type PTextareaProps = {
      */
     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;
     /**
@@ -81,7 +81,7 @@ type PTextareaProps = {
      */
     value?: string;
     /**
-     * Handles wrapping behaviour of elements.
+     * Handles wrapping behavior of elements.
      */
     wrap?: TextareaWrap;
 };
@@ -108,8 +108,8 @@ declare const __VLS_component: import("vue").DefineComponent<PTextareaProps, voi
     hideLabel: BreakpointCustomizable<boolean>;
     value: string;
     message: string;
-    placeholder: string;
     readOnly: boolean;
+    placeholder: string;
     counter: boolean;
     rows: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/esm/lib/components/index.d.ts

@@ -17,6 +17,7 @@ export { default as PDrilldownItem } from './DrilldownItemWrapper.vue';
 export { default as PDrilldownLink } from './DrilldownLinkWrapper.vue';
 export { default as PFieldset } from './FieldsetWrapper.vue';
 export { default as PFieldsetWrapper } from './FieldsetWrapperWrapper.vue';
+export { default as PFlag } from './FlagWrapper.vue';
 export { default as PFlex } from './FlexWrapper.vue';
 export { default as PFlexItem } from './FlexItemWrapper.vue';
 export { default as PFlyout } from './FlyoutWrapper.vue';
@@ -26,10 +27,15 @@ export { default as PHeading } from './HeadingWrapper.vue';
 export { default as PHeadline } from './HeadlineWrapper.vue';
 export { default as PIcon } from './IconWrapper.vue';
 export { default as PInlineNotification } from './InlineNotificationWrapper.vue';
+export { default as PInputDate } from './InputDateWrapper.vue';
+export { default as PInputEmail } from './InputEmailWrapper.vue';
 export { default as PInputNumber } from './InputNumberWrapper.vue';
 export { default as PInputPassword } from './InputPasswordWrapper.vue';
 export { default as PInputSearch } from './InputSearchWrapper.vue';
+export { default as PInputTel } from './InputTelWrapper.vue';
 export { default as PInputText } from './InputTextWrapper.vue';
+export { default as PInputTime } from './InputTimeWrapper.vue';
+export { default as PInputUrl } from './InputUrlWrapper.vue';
 export { default as PLink } from './LinkWrapper.vue';
 export { default as PLinkPure } from './LinkPureWrapper.vue';
 export { default as PLinkSocial } from './LinkSocialWrapper.vue';

package/esm/lib/types.d.ts

@@ -493,6 +493,116 @@ declare const ICON_NAMES: readonly [
     "zoom-out"
 ];
 export type IconName = typeof ICON_NAMES[number];
+declare const FLAG_NAMES: readonly [
+    "ae",
+    "am",
+    "ar",
+    "at",
+    "au",
+    "az",
+    "ba",
+    "be",
+    "bg",
+    "bh",
+    "bn",
+    "bo",
+    "br",
+    "by",
+    "ca",
+    "ch",
+    "cl",
+    "cn",
+    "co",
+    "cr",
+    "cw",
+    "cy",
+    "cz",
+    "de",
+    "dk",
+    "do",
+    "dz",
+    "ec",
+    "ee",
+    "eg",
+    "es",
+    "fi",
+    "fr",
+    "gb",
+    "ge",
+    "gh",
+    "gr",
+    "gt",
+    "hk",
+    "hn",
+    "hr",
+    "ht",
+    "hu",
+    "id",
+    "ie",
+    "il",
+    "in",
+    "is",
+    "it",
+    "jm",
+    "jo",
+    "jp",
+    "ke",
+    "kh",
+    "kr",
+    "kw",
+    "kz",
+    "lb",
+    "lk",
+    "lt",
+    "lu",
+    "lv",
+    "ma",
+    "md",
+    "mk",
+    "mn",
+    "mo",
+    "mq",
+    "mt",
+    "mu",
+    "mx",
+    "my",
+    "ng",
+    "nl",
+    "no",
+    "nz",
+    "om",
+    "pa",
+    "pe",
+    "pf",
+    "ph",
+    "pk",
+    "pl",
+    "pr",
+    "pt",
+    "py",
+    "qa",
+    "ro",
+    "rs",
+    "ru",
+    "sa",
+    "se",
+    "sg",
+    "si",
+    "sk",
+    "sv",
+    "th",
+    "tn",
+    "tr",
+    "tt",
+    "ua",
+    "us",
+    "uy",
+    "uz",
+    "ve",
+    "vn",
+    "za"
+];
+export type FlagName = typeof FLAG_NAMES[number];
 declare const FORM_STATES: readonly [
     "none",
     "error",
@@ -586,6 +696,7 @@ declare const GRADIENT_COLORS: readonly [
     "background-base",
     "background-surface"
 ];
+/** @deprecated */
 export type ScrollerGradientColor = (typeof GRADIENT_COLORS)[number];
 export type ScrollerScrollToPosition = {
     scrollPosition: number;
@@ -598,6 +709,20 @@ declare const SCROLL_INDICATOR_POSITIONS: readonly [
 /** @deprecated */
 export type ScrollerScrollIndicatorPosition = (typeof SCROLL_INDICATOR_POSITIONS)[number];
 export type ScrollerAlignScrollIndicator = ScrollerScrollIndicatorPosition;
+export type MultiSelectState = FormState;
+export type MultiSelectDropdownDirection = SelectComponentsDropdownDirection;
+/** @deprecated */
+export type MultiSelectUpdateEvent = {
+    name: string;
+    value: string[];
+};
+export type MultiSelectUpdateEventDetail = MultiSelectUpdateEvent;
+export type SelectState = FormState;
+export type SelectDropdownDirection = SelectComponentsDropdownDirection;
+export type SelectUpdateEventDetail = {
+    name: string;
+    value: string;
+};
 declare const SELECT_DROPDOWN_DIRECTIONS: readonly [
     "down",
     "up",
@@ -702,6 +827,9 @@ export type PorscheDesignSystem = {
     };
 };
 export type SelectedAriaAttributes<T extends keyof AriaAttributes> = Pick<AriaAttributes, T>;
+export type SelectedAriaRole<T> = {
+    role: Extract<AriaRole, T>;
+};
 declare const ACCORDION_SIZES: readonly [
     "small",
     "medium"
@@ -881,6 +1009,11 @@ export type FieldsetLabelSize = (typeof FIELDSET_LABEL_SIZES)[number];
 export type FieldsetState = FormState;
 export type FieldsetWrapperLabelSize = FieldsetLabelSize;
 export type FieldsetWrapperState = FieldsetState;
+declare const FLAG_ARIA_ATTRIBUTES: readonly [
+    "aria-label"
+];
+export type FlagAriaAttribute = (typeof FLAG_ARIA_ATTRIBUTES)[number];
+export type FlagSize = TextSize;
 export type FlexInline = boolean;
 declare const FLEX_WRAPS: readonly [
     "nowrap",
@@ -1090,44 +1223,42 @@ declare const ICON_COLORS: readonly [
     "state-disabled"
 ];
 export type IconColor = (typeof ICON_COLORS)[number];
+export type InputDateState = FormState;
+export type InputDateChangeEventDetail = Event;
+export type InputDateBlurEventDetail = Event;
+export type InputDateInputEventDetail = InputEvent;
+export type InputEmailState = FormState;
+export type InputEmailChangeEventDetail = Event;
+export type InputEmailBlurEventDetail = Event;
+export type InputEmailInputEventDetail = InputEvent;
 export type InputNumberState = FormState;
-declare const INPUT_NUMBER_AUTO_COMPLETE: readonly [
-    "off",
-    "on"
-];
-export type InputNumberAutoComplete = (typeof INPUT_NUMBER_AUTO_COMPLETE)[number];
 export type InputNumberChangeEventDetail = Event;
 export type InputNumberBlurEventDetail = Event;
 export type InputNumberInputEventDetail = InputEvent;
 export type InputPasswordState = FormState;
-declare const INPUT_PASSWORD_AUTO_COMPLETE: readonly [
-    "off",
-    "on",
-    "current-password",
-    "new-password"
-];
-export type InputPasswordAutoComplete = (typeof INPUT_PASSWORD_AUTO_COMPLETE)[number];
 export type InputPasswordChangeEventDetail = Event;
 export type InputPasswordBlurEventDetail = Event;
 export type InputPasswordInputEventDetail = InputEvent;
 export type InputSearchState = FormState;
-declare const INPUT_SEARCH_AUTO_COMPLETE: readonly [
-    "off",
-    "on"
-];
-export type InputSearchAutoComplete = (typeof INPUT_SEARCH_AUTO_COMPLETE)[number];
 export type InputSearchChangeEventDetail = Event;
 export type InputSearchBlurEventDetail = Event;
 export type InputSearchInputEventDetail = InputEvent;
+export type InputTelState = FormState;
+export type InputTelChangeEventDetail = Event;
+export type InputTelBlurEventDetail = Event;
+export type InputTelInputEventDetail = InputEvent;
 export type InputTextState = FormState;
-declare const INPUT_TEXT_AUTO_COMPLETE: readonly [
-    "off",
-    "on"
-];
-export type InputTextAutoComplete = (typeof INPUT_TEXT_AUTO_COMPLETE)[number];
 export type InputTextChangeEventDetail = Event;
 export type InputTextBlurEventDetail = Event;
 export type InputTextInputEventDetail = InputEvent;
+export type InputTimeState = FormState;
+export type InputTimeChangeEventDetail = Event;
+export type InputTimeBlurEventDetail = Event;
+export type InputTimeInputEventDetail = InputEvent;
+export type InputUrlState = FormState;
+export type InputUrlChangeEventDetail = Event;
+export type InputUrlBlurEventDetail = Event;
+export type InputUrlInputEventDetail = InputEvent;
 export type LinkIcon = LinkButtonIconName;
 export type LinkPureIcon = LinkButtonIconName;
 export type LinkPureAriaAttribute = LinkAriaAttribute;
@@ -1282,14 +1413,6 @@ declare const MODEL_SIGNATURE_COLORS: readonly [
     "inherit"
 ];
 export type ModelSignatureColor = (typeof MODEL_SIGNATURE_COLORS)[number];
-export type MultiSelectState = FormState;
-export type MultiSelectDropdownDirection = SelectComponentsDropdownDirection;
-/** @deprecated */
-export type MultiSelectUpdateEvent = {
-    name: string;
-    value: string[];
-};
-export type MultiSelectUpdateEventDetail = MultiSelectUpdateEvent;
 declare const PAGINATION_NUMBER_OF_PAGE_LINKS: readonly [
     5,
     7
@@ -1353,12 +1476,6 @@ declare const SEGMENTED_CONTROL_ITEM_ARIA_ATTRIBUTES: readonly [
     "aria-label"
 ];
 export type SegmentedControlItemAriaAttribute = (typeof SEGMENTED_CONTROL_ITEM_ARIA_ATTRIBUTES)[number];
-export type SelectState = FormState;
-export type SelectDropdownDirection = SelectComponentsDropdownDirection;
-export type SelectUpdateEventDetail = {
-    name: string;
-    value: string;
-};
 declare const DROPDOWN_DIRECTIONS: readonly [
     "down",
     "up",
@@ -1516,11 +1633,6 @@ declare const TEXT_LIST_TYPES: readonly [
 ];
 export type TextListType = (typeof TEXT_LIST_TYPES)[number];
 export type TextareaState = FormState;
-declare const AUTO_COMPLETE: readonly [
-    "off",
-    "on"
-];
-export type TextareaAutoComplete = (typeof AUTO_COMPLETE)[number];
 declare const TEXTAREA_WRAPS: readonly [
     "hard",
     "soft",