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

package/ssr/esm/lib/components/text-list.wrapper.d.ts

@@ -3,12 +3,14 @@ import type { TextListType } from '../types';
 export type PTextListProps = BaseProps & {
     /**
      * The list style type.
+     * @default 'unordered'
      */
     type?: TextListType;
 };
 export declare const PTextList: 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"> & {
     /**
      * The list style type.
+     * @default 'unordered'
      */
     type?: TextListType;
 } & {

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

@@ -3,60 +3,74 @@ import type { TextAlign, TextColor, TextHyphens, BreakpointCustomizable, TextSiz
 export type PTextProps = BaseProps & {
     /**
      * Text alignment of the text. Use 'start' for left-aligned text (in LTR), 'center' for centered, 'end' for right-aligned (in LTR), or 'inherit' to adopt the parent's alignment.
+     * @default 'start'
      */
     align?: TextAlign;
     /**
      * Text color of the text. Use 'primary' for default, 'contrast-higher' / 'contrast-high' / 'contrast-medium' for alternative emphasis levels, 'success' / 'warning' / 'error' / 'info' for status messages, or 'inherit' to adopt the parent's color.
+     * @default 'primary'
      */
     color?: TextColor;
     /**
      * Adds an ellipsis to a single line of text if it overflows the container width. When enabled, the text is truncated to a single line with `text-overflow: ellipsis`. Cannot be combined with multi-line content.
+     * @default false
      */
     ellipsis?: boolean;
     /**
      * Controls the hyphenation behavior of the text. Use 'auto' to let the browser automatically hyphenate words at appropriate points, 'manual' to only hyphenate at manually inserted hyphenation points (e.g. `­`), 'none' to disable hyphenation entirely, or 'inherit' to adopt the parent's hyphenation setting.
+     * @default 'inherit'
      */
     hyphens?: TextHyphens;
     /**
      * Size of the text. Also defines the size for specific breakpoints, like {base: "sm", l: "md"}. You always need to provide a base value when doing this. Use 'inherit' to adopt the parent's font size.
+     * @default 'sm'
      */
     size?: BreakpointCustomizable<TextSize>;
     /**
      * Sets the HTML tag of the rendered element to ensure correct semantic meaning (e.g. 'p' for paragraphs, 'blockquote' for quotes, 'time' for dates).
+     * @default 'p'
      */
     tag?: TextTag;
     /**
      * The font weight of the text. Use 'normal' for regular body text, 'semibold' for slightly emphasized text, or 'bold' for strong emphasis.
+     * @default 'normal'
      */
     weight?: TextWeight;
 };
 export declare const PText: 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"> & {
     /**
      * Text alignment of the text. Use 'start' for left-aligned text (in LTR), 'center' for centered, 'end' for right-aligned (in LTR), or 'inherit' to adopt the parent's alignment.
+     * @default 'start'
      */
     align?: TextAlign;
     /**
      * Text color of the text. Use 'primary' for default, 'contrast-higher' / 'contrast-high' / 'contrast-medium' for alternative emphasis levels, 'success' / 'warning' / 'error' / 'info' for status messages, or 'inherit' to adopt the parent's color.
+     * @default 'primary'
      */
     color?: TextColor;
     /**
      * Adds an ellipsis to a single line of text if it overflows the container width. When enabled, the text is truncated to a single line with `text-overflow: ellipsis`. Cannot be combined with multi-line content.
+     * @default false
      */
     ellipsis?: boolean;
     /**
      * Controls the hyphenation behavior of the text. Use 'auto' to let the browser automatically hyphenate words at appropriate points, 'manual' to only hyphenate at manually inserted hyphenation points (e.g. `&shy;`), 'none' to disable hyphenation entirely, or 'inherit' to adopt the parent's hyphenation setting.
+     * @default 'inherit'
      */
     hyphens?: TextHyphens;
     /**
      * Size of the text. Also defines the size for specific breakpoints, like {base: "sm", l: "md"}. You always need to provide a base value when doing this. Use 'inherit' to adopt the parent's font size.
+     * @default 'sm'
      */
     size?: BreakpointCustomizable<TextSize>;
     /**
      * Sets the HTML tag of the rendered element to ensure correct semantic meaning (e.g. 'p' for paragraphs, 'blockquote' for quotes, 'time' for dates).
+     * @default 'p'
      */
     tag?: TextTag;
     /**
      * The font weight of the text. Use 'normal' for regular body text, 'semibold' for slightly emphasized text, or 'bold' for strong emphasis.
+     * @default 'normal'
      */
     weight?: TextWeight;
 } & {

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

@@ -7,18 +7,22 @@ export type PTextareaProps = BaseProps & {
     autoComplete?: string;
     /**
      * Displays the textarea in compact mode.
+     * @default false
      */
     compact?: boolean;
     /**
      * Show or hide the character counter.
+     * @default false
      */
     counter?: boolean;
     /**
      * Supplementary text providing more context or explanation for the textarea.
+     * @default ''
      */
     description?: string;
     /**
      * Disables the textarea. The value will not be submitted with the form.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -27,10 +31,12 @@ export type PTextareaProps = 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;
     /**
@@ -39,6 +45,7 @@ export type PTextareaProps = BaseProps & {
     maxLength?: number;
     /**
      * Dynamic feedback text for validation or status.
+     * @default ''
      */
     message?: string;
     /**
@@ -63,22 +70,27 @@ export type PTextareaProps = BaseProps & {
     onInput?: (event: CustomEvent<TextareaInputEventDetail>) => void;
     /**
      * 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.
+     * @default ''
      */
     placeholder?: string;
     /**
      * A boolean value that, if present, makes the textarea uneditable by the user, but its value will still be submitted with the form.
+     * @default false
      */
     readOnly?: boolean;
     /**
      * A boolean value that, if present, indicates that the textarea must be filled out before the form can be submitted.
+     * @default false
      */
     required?: boolean;
     /**
      * Controls whether the textarea is resizable and in which direction.
+     * @default 'vertical'
      */
     resize?: TextareaResize;
     /**
      * The number of rows. Has no effect when field-sizing CSS Variable '--p-textarea-field-sizing' is set to 'content'.
+     * @default 7
      */
     rows?: number;
     /**
@@ -87,14 +99,17 @@ export type PTextareaProps = BaseProps & {
     spellCheck?: boolean;
     /**
      * Indicates the validation or overall status of the textarea component.
+     * @default 'none'
      */
     state?: TextareaState;
     /**
      * The textarea value.
+     * @default ''
      */
     value?: string;
     /**
      * Handles wrapping behavior of elements.
+     * @default 'soft'
      */
     wrap?: TextareaWrap;
 };
@@ -105,18 +120,22 @@ export declare const PTextarea: import("react").ForwardRefExoticComponent<Omit<i
     autoComplete?: string;
     /**
      * Displays the textarea in compact mode.
+     * @default false
      */
     compact?: boolean;
     /**
      * Show or hide the character counter.
+     * @default false
      */
     counter?: boolean;
     /**
      * Supplementary text providing more context or explanation for the textarea.
+     * @default ''
      */
     description?: string;
     /**
      * Disables the textarea. The value will not be submitted with the form.
+     * @default false
      */
     disabled?: boolean;
     /**
@@ -125,10 +144,12 @@ export declare const PTextarea: import("react").ForwardRefExoticComponent<Omit<i
     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;
     /**
@@ -137,6 +158,7 @@ export declare const PTextarea: import("react").ForwardRefExoticComponent<Omit<i
     maxLength?: number;
     /**
      * Dynamic feedback text for validation or status.
+     * @default ''
      */
     message?: string;
     /**
@@ -161,22 +183,27 @@ export declare const PTextarea: import("react").ForwardRefExoticComponent<Omit<i
     onInput?: (event: CustomEvent<TextareaInputEventDetail>) => void;
     /**
      * 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.
+     * @default ''
      */
     placeholder?: string;
     /**
      * A boolean value that, if present, makes the textarea uneditable by the user, but its value will still be submitted with the form.
+     * @default false
      */
     readOnly?: boolean;
     /**
      * A boolean value that, if present, indicates that the textarea must be filled out before the form can be submitted.
+     * @default false
      */
     required?: boolean;
     /**
      * Controls whether the textarea is resizable and in which direction.
+     * @default 'vertical'
      */
     resize?: TextareaResize;
     /**
      * The number of rows. Has no effect when field-sizing CSS Variable '--p-textarea-field-sizing' is set to 'content'.
+     * @default 7
      */
     rows?: number;
     /**
@@ -185,14 +212,17 @@ export declare const PTextarea: import("react").ForwardRefExoticComponent<Omit<i
     spellCheck?: boolean;
     /**
      * Indicates the validation or overall status of the textarea component.
+     * @default 'none'
      */
     state?: TextareaState;
     /**
      * The textarea value.
+     * @default ''
      */
     value?: string;
     /**
      * Handles wrapping behavior of elements.
+     * @default 'soft'
      */
     wrap?: TextareaWrap;
 } & {

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

@@ -11,10 +11,12 @@ export type PWordmarkProps = BaseProps & {
     href?: string;
     /**
      * Controls the size of the wordmark.
+     * @default 'small'
      */
     size?: WordmarkSize;
     /**
      * Specifies where to open the linked document.
+     * @default '_self'
      */
     target?: WordmarkTarget;
 };
@@ -29,10 +31,12 @@ export declare const PWordmark: import("react").ForwardRefExoticComponent<Omit<i
     href?: string;
     /**
      * Controls the size of the wordmark.
+     * @default 'small'
      */
     size?: WordmarkSize;
     /**
      * Specifies where to open the linked document.
+     * @default '_self'
      */
     target?: WordmarkTarget;
 } & import("react").RefAttributes<HTMLElement>>;

package/ssr/esm/lib/dsr-components/banner.d.ts

@@ -7,7 +7,7 @@ import { Component } from 'react';
  */
 export declare class DSRBanner extends Component<any> {
     host: HTMLElement;
-    private inlineNotificationElement;
-    private closeBtn;
+    private refPopover;
+    private refDismiss;
     render(): JSX.Element;
 }

package/ssr/esm/lib/types.d.ts

@@ -784,6 +784,11 @@ export type SelectedAriaAttributes<T extends keyof AriaAttributes> = Pick<AriaAt
 export type SelectedAriaRole<T> = {
     role: Extract<AriaRole, T>;
 };
+declare const BANNER_POSITIONS: readonly [
+    "top",
+    "bottom"
+];
+export type BannerPosition = (typeof BANNER_POSITIONS)[number];
 declare const BANNER_STATES: readonly [
     "info",
     "success",

package/tailwindcss/index.css

@@ -163,6 +163,7 @@
   --spacing-fluid-xl: clamp(48px, 3vw + 38px, 96px);
   --spacing-fluid-2xl: clamp(80px, 7.5vw + 56px, 200px);
 
+  --spacing-static-2xs: 1px;
   --spacing-static-xs: 4px;
   --spacing-static-sm: 8px;
   --spacing-static-md: 16px;
@@ -475,48 +476,106 @@
 
 /* Typography: Text */
 @utility prose-text-2xs {
-  @apply font-porsche-next not-italic font-normal text-2xs text-primary;
+  font: var(--font-weight-normal) var(--text-2xs) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-text-xs {
-  @apply font-porsche-next not-italic font-normal text-xs text-primary;
+  font: var(--font-weight-normal) var(--text-xs) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-text-sm {
-  @apply font-porsche-next not-italic font-normal text-sm text-primary;
+  font: var(--font-weight-normal) var(--text-sm) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-text-md {
-  @apply font-porsche-next not-italic font-normal text-md text-primary;
+  font: var(--font-weight-normal) var(--text-md) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-text-lg {
-  @apply font-porsche-next not-italic font-normal text-lg text-primary;
+  font: var(--font-weight-normal) var(--text-lg) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-text-xl {
-  @apply font-porsche-next not-italic font-normal text-xl text-primary;
+  font: var(--font-weight-normal) var(--text-xl) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
+}
+@utility prose-text-2xl {
+  font: var(--font-weight-normal) var(--text-2xl) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
+}
+@utility prose-text-3xl {
+  font: var(--font-weight-normal) var(--text-3xl) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
+}
+@utility prose-text-4xl {
+  font: var(--font-weight-normal) var(--text-4xl) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
+}
+@utility prose-text-5xl {
+  font: var(--font-weight-normal) var(--text-5xl) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 
 /* Typography: Heading */
+@utility prose-heading-2xs {
+  font: var(--font-weight-semibold) var(--text-2xs) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
+}
+@utility prose-heading-xs {
+  font: var(--font-weight-semibold) var(--text-xs) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
+}
 @utility prose-heading-sm {
-  @apply font-porsche-next not-italic font-semibold text-sm text-primary;
+  font: var(--font-weight-semibold) var(--text-sm) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-heading-md {
-  @apply font-porsche-next not-italic font-normal text-md text-primary;
+  font: var(--font-weight-normal) var(--text-md) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-heading-lg {
-  @apply font-porsche-next not-italic font-normal text-lg text-primary;
+  font: var(--font-weight-normal) var(--text-lg) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-heading-xl {
-  @apply font-porsche-next not-italic font-normal text-xl text-primary;
+  font: var(--font-weight-normal) var(--text-xl) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-heading-2xl {
-  @apply font-porsche-next not-italic font-normal text-2xl text-primary;
+  font: var(--font-weight-normal) var(--text-2xl) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-heading-3xl {
-  @apply font-porsche-next not-italic font-normal text-3xl text-primary;
+  font: var(--font-weight-normal) var(--text-3xl) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-heading-4xl {
-  @apply font-porsche-next not-italic font-normal text-4xl text-primary;
+  font: var(--font-weight-normal) var(--text-4xl) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 @utility prose-heading-5xl {
-  @apply font-porsche-next not-italic font-normal text-5xl text-primary;
+  font: var(--font-weight-normal) var(--text-5xl) / var(--leading-normal)
+    var(--font-porsche-next);
+  color: var(--color-primary);
 }
 
 /* Typography: Display */