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

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

@@ -2,162 +2,162 @@ import type { BaseProps } from '../../BaseProps';
 import type { CarouselAlignControls, CarouselAlignHeader, SelectedAriaAttributes, CarouselAriaAttribute, CarouselHeadingSize, CarouselInternationalization, CarouselUpdateEventDetail, BreakpointCustomizable, CarouselSlidesPerPage, CarouselWidth } from '../types';
 export type PCarouselProps = BaseProps & {
     /**
-     * Defines which slide is active (zero-based numbering).
+     * Sets the zero-based index of the currently visible slide. Update this to navigate programmatically.
      * @default 0
      */
     activeSlideIndex?: number;
     /**
-     * Aligns the slotted controls.
+     * Controls the alignment of custom slotted controls within the header area.
      * @default 'auto'
      */
     alignControls?: CarouselAlignControls;
     /**
-     * Aligns the heading and description.
+     * Controls the horizontal alignment of the heading and description.
      * @default 'start'
      */
     alignHeader?: CarouselAlignHeader;
     /**
-     * Sets ARIA attributes.
+     * Sets ARIA attributes on the carousel region element for improved accessibility.
      */
     aria?: SelectedAriaAttributes<CarouselAriaAttribute>;
     /**
-     * Defines the description used in the carousel.
+     * Sets the description text displayed below the heading for additional context.
      */
     description?: string;
     /**
-     * Indicates whether focus should be set on the center slide. If true, the carousel loops by individual slide; otherwise, it loops by page.
+     * When enabled, each slide is individually focusable and the carousel navigates one slide at a time instead of one page.
      * @default false
      */
     focusOnCenterSlide?: boolean;
     /**
-     * Fades the slides out.
+     * Shows a gradient fade at the start and end edges to visually indicate more slides beyond the viewport.
      * @default false
      */
     gradient?: boolean;
     /**
-     * Defines the heading used in the carousel.
+     * Sets the heading text displayed above the carousel. Also used as the accessible label when no `aria` prop is set.
      */
     heading?: string;
     /**
-     * Defines the heading size used in the carousel.
+     * Sets the font size of the carousel heading.
      * @default 'x-large'
      */
     headingSize?: CarouselHeadingSize;
     /**
-     * Override the default wordings that are used for aria-labels on the next/prev buttons and pagination.
+     * Overrides the default label strings used for the previous, next, and page indicators — useful for localization.
      */
     intl?: CarouselInternationalization;
     /**
-     * Emitted when carousel's content slides.
+     * Emitted when the carousel navigates to a new slide, with the active and previous slide indexes in the event detail.
      */
     onUpdate?: (event: CustomEvent<CarouselUpdateEventDetail>) => void;
     /**
-     * If false, the carousel will not show pagination bullets at the bottom.
+     * Shows pagination dot indicators below the carousel. Supports responsive breakpoint values.
      * @default false
      */
     pagination?: BreakpointCustomizable<boolean>;
     /**
-     * Whether the slides should rewind from last to first slide and vice versa.
+     * Enables infinite looping — navigating past the last slide wraps back to the first, and vice versa.
      * @default false
      */
     rewind?: boolean;
     /**
-     * Defines the skip link target used to skip carousel entries.
+     * Sets the `href` of an in-page skip link that lets keyboard users jump past the carousel slides.
      */
     skipLinkTarget?: string;
     /**
-     * Sets the amount of slides visible at the same time. Can be set to `auto` if you want to define different widths per slide via CSS.
+     * Sets how many slides are visible at once. Use `auto` to control each slide's width via CSS. Supports responsive breakpoint values.
      * @default 1
      */
     slidesPerPage?: BreakpointCustomizable<CarouselSlidesPerPage>;
     /**
-     * Determines whether to trim spaces before/after the carousel if `focusOnCenterSlide` option is true.
+     * Removes whitespace before the first and after the last slide when `focusOnCenterSlide` is enabled.
      * @default false
      */
     trimSpace?: boolean;
     /**
-     * Defines the outer spacings between the carousel and the left and right screen sides.
+     * Sets the maximum width and outer spacing of the carousel, aligned to PDS grid widths.
      * @default 'basic'
      */
     width?: CarouselWidth;
 };
 export declare const PCarousel: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Defines which slide is active (zero-based numbering).
+     * Sets the zero-based index of the currently visible slide. Update this to navigate programmatically.
      * @default 0
      */
     activeSlideIndex?: number;
     /**
-     * Aligns the slotted controls.
+     * Controls the alignment of custom slotted controls within the header area.
      * @default 'auto'
      */
     alignControls?: CarouselAlignControls;
     /**
-     * Aligns the heading and description.
+     * Controls the horizontal alignment of the heading and description.
      * @default 'start'
      */
     alignHeader?: CarouselAlignHeader;
     /**
-     * Sets ARIA attributes.
+     * Sets ARIA attributes on the carousel region element for improved accessibility.
      */
     aria?: SelectedAriaAttributes<CarouselAriaAttribute>;
     /**
-     * Defines the description used in the carousel.
+     * Sets the description text displayed below the heading for additional context.
      */
     description?: string;
     /**
-     * Indicates whether focus should be set on the center slide. If true, the carousel loops by individual slide; otherwise, it loops by page.
+     * When enabled, each slide is individually focusable and the carousel navigates one slide at a time instead of one page.
      * @default false
      */
     focusOnCenterSlide?: boolean;
     /**
-     * Fades the slides out.
+     * Shows a gradient fade at the start and end edges to visually indicate more slides beyond the viewport.
      * @default false
      */
     gradient?: boolean;
     /**
-     * Defines the heading used in the carousel.
+     * Sets the heading text displayed above the carousel. Also used as the accessible label when no `aria` prop is set.
      */
     heading?: string;
     /**
-     * Defines the heading size used in the carousel.
+     * Sets the font size of the carousel heading.
      * @default 'x-large'
      */
     headingSize?: CarouselHeadingSize;
     /**
-     * Override the default wordings that are used for aria-labels on the next/prev buttons and pagination.
+     * Overrides the default label strings used for the previous, next, and page indicators — useful for localization.
      */
     intl?: CarouselInternationalization;
     /**
-     * Emitted when carousel's content slides.
+     * Emitted when the carousel navigates to a new slide, with the active and previous slide indexes in the event detail.
      */
     onUpdate?: (event: CustomEvent<CarouselUpdateEventDetail>) => void;
     /**
-     * If false, the carousel will not show pagination bullets at the bottom.
+     * Shows pagination dot indicators below the carousel. Supports responsive breakpoint values.
      * @default false
      */
     pagination?: BreakpointCustomizable<boolean>;
     /**
-     * Whether the slides should rewind from last to first slide and vice versa.
+     * Enables infinite looping — navigating past the last slide wraps back to the first, and vice versa.
      * @default false
      */
     rewind?: boolean;
     /**
-     * Defines the skip link target used to skip carousel entries.
+     * Sets the `href` of an in-page skip link that lets keyboard users jump past the carousel slides.
      */
     skipLinkTarget?: string;
     /**
-     * Sets the amount of slides visible at the same time. Can be set to `auto` if you want to define different widths per slide via CSS.
+     * Sets how many slides are visible at once. Use `auto` to control each slide's width via CSS. Supports responsive breakpoint values.
      * @default 1
      */
     slidesPerPage?: BreakpointCustomizable<CarouselSlidesPerPage>;
     /**
-     * Determines whether to trim spaces before/after the carousel if `focusOnCenterSlide` option is true.
+     * Removes whitespace before the first and after the last slide when `focusOnCenterSlide` is enabled.
      * @default false
      */
     trimSpace?: boolean;
     /**
-     * Defines the outer spacings between the carousel and the left and right screen sides.
+     * Sets the maximum width and outer spacing of the carousel, aligned to PDS grid widths.
      * @default 'basic'
      */
     width?: CarouselWidth;

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

@@ -2,148 +2,148 @@ import type { BaseProps } from '../../BaseProps';
 import type { BreakpointCustomizable, CheckboxBlurEventDetail, CheckboxChangeEventDetail, CheckboxState } from '../types';
 export type PCheckboxProps = BaseProps & {
     /**
-     * Reflects the checkbox current checked state and allows setting the initial checked state.
+     * Reflects the checkbox's current checked state and allows setting the initial checked value on load.
      * @default false
      */
     checked?: boolean;
     /**
-     * Displays the checkbox in compact mode.
+     * Reduces the checkbox size and spacing for a more compact layout.
      * @default false
      */
     compact?: boolean;
     /**
-     * Marks the checkbox as disabled.
+     * Disables the checkbox, preventing all interaction. The value is not submitted with the form.
      * @default false
      */
     disabled?: boolean;
     /**
-     * The id of a form element the checkbox should be associated with.
+     * Associates the checkbox with a form element by its ID when not directly nested inside it.
      */
     form?: string;
     /**
-     * Shows or hides the label. For better accessibility, it is recommended to show the label.
+     * Hides the visible label while keeping it accessible to screen readers. Supports responsive breakpoint values.
      * @default false
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * Marks the checkbox as indeterminate.
+     * Puts the checkbox into an indeterminate state, indicating that a group of child items is only partially selected.
      * @default false
      */
     indeterminate?: boolean;
     /**
-     * Text content for a user-facing label.
+     * Sets the visible label text displayed next to the checkbox.
      * @default ''
      */
     label?: string;
     /**
-     * @experimental Disables the checkbox and shows a loading indicator.
+     * @experimental Disables the checkbox and displays a loading spinner to indicate an ongoing operation.
      * @default false
      */
     loading?: boolean;
     /**
-     * The message styled depending on validation state.
+     * Sets the validation feedback message displayed below the checkbox when `state` is `success` or `error`.
      * @default ''
      */
     message?: string;
     /**
-     * The name of the checkbox.
+     * Sets the name submitted with the form data to identify this checkbox's value on the server.
      * @default ''
      */
     name?: string;
     /**
-     * Emitted when the checkbox has lost focus.
+     * Emitted when the checkbox loses focus.
      */
     onBlur?: (event: CustomEvent<CheckboxBlurEventDetail>) => void;
     /**
-     * Emitted when checkbox checked property is changed.
+     * Emitted when the user changes the checked state of the checkbox.
      */
     onChange?: (event: CustomEvent<CheckboxChangeEventDetail>) => void;
     /**
-     * Marks the checkbox as required.
+     * Marks the checkbox as required — form submission is blocked unless the checkbox is checked.
      * @default false
      */
     required?: boolean;
     /**
-     * The validation state.
+     * Sets the validation state, controlling the visual appearance and style of the feedback message (`none`, `success`, `error`).
      * @default 'none'
      */
     state?: CheckboxState;
     /**
-     * The checkbox value. When a form is submitted, only a checkbox which is currently checked is included in the submission.
+     * Sets the value submitted with the form data when the checkbox is checked. Unchecked checkboxes are excluded from form submissions.
      * @default 'on'
      */
     value?: string;
 };
 export declare const PCheckbox: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Reflects the checkbox current checked state and allows setting the initial checked state.
+     * Reflects the checkbox's current checked state and allows setting the initial checked value on load.
      * @default false
      */
     checked?: boolean;
     /**
-     * Displays the checkbox in compact mode.
+     * Reduces the checkbox size and spacing for a more compact layout.
      * @default false
      */
     compact?: boolean;
     /**
-     * Marks the checkbox as disabled.
+     * Disables the checkbox, preventing all interaction. The value is not submitted with the form.
      * @default false
      */
     disabled?: boolean;
     /**
-     * The id of a form element the checkbox should be associated with.
+     * Associates the checkbox with a form element by its ID when not directly nested inside it.
      */
     form?: string;
     /**
-     * Shows or hides the label. For better accessibility, it is recommended to show the label.
+     * Hides the visible label while keeping it accessible to screen readers. Supports responsive breakpoint values.
      * @default false
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
-     * Marks the checkbox as indeterminate.
+     * Puts the checkbox into an indeterminate state, indicating that a group of child items is only partially selected.
      * @default false
      */
     indeterminate?: boolean;
     /**
-     * Text content for a user-facing label.
+     * Sets the visible label text displayed next to the checkbox.
      * @default ''
      */
     label?: string;
     /**
-     * @experimental Disables the checkbox and shows a loading indicator.
+     * @experimental Disables the checkbox and displays a loading spinner to indicate an ongoing operation.
      * @default false
      */
     loading?: boolean;
     /**
-     * The message styled depending on validation state.
+     * Sets the validation feedback message displayed below the checkbox when `state` is `success` or `error`.
      * @default ''
      */
     message?: string;
     /**
-     * The name of the checkbox.
+     * Sets the name submitted with the form data to identify this checkbox's value on the server.
      * @default ''
      */
     name?: string;
     /**
-     * Emitted when the checkbox has lost focus.
+     * Emitted when the checkbox loses focus.
      */
     onBlur?: (event: CustomEvent<CheckboxBlurEventDetail>) => void;
     /**
-     * Emitted when checkbox checked property is changed.
+     * Emitted when the user changes the checked state of the checkbox.
      */
     onChange?: (event: CustomEvent<CheckboxChangeEventDetail>) => void;
     /**
-     * Marks the checkbox as required.
+     * Marks the checkbox as required — form submission is blocked unless the checkbox is checked.
      * @default false
      */
     required?: boolean;
     /**
-     * The validation state.
+     * Sets the validation state, controlling the visual appearance and style of the feedback message (`none`, `success`, `error`).
      * @default 'none'
      */
     state?: CheckboxState;
     /**
-     * The checkbox value. When a form is submitted, only a checkbox which is currently checked is included in the submission.
+     * Sets the value submitted with the form data when the checkbox is checked. Unchecked checkboxes are excluded from form submissions.
      * @default 'on'
      */
     value?: string;

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

@@ -2,30 +2,30 @@ import type { BaseProps } from '../../BaseProps';
 import type { SelectedAriaAttributes, CrestAriaAttribute, CrestTarget } from '../types';
 export type PCrestProps = BaseProps & {
     /**
-     * Sets ARIA attributes.
+     * Sets ARIA attributes on the anchor element to improve accessibility when the crest is used as a link.
      */
     aria?: SelectedAriaAttributes<CrestAriaAttribute>;
     /**
-     * When `href` is provided, the component renders as an `<a>` element.
+     * When set, renders the crest as an anchor element navigating to this URL when clicked.
      */
     href?: string;
     /**
-     * Specifies where to open the linked document.
+     * Specifies where to open the linked URL (e.g. `_self`, `_blank`). Only applies when `href` is set.
      * @default '_self'
      */
     target?: CrestTarget;
 };
 export declare const PCrest: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Sets ARIA attributes.
+     * Sets ARIA attributes on the anchor element to improve accessibility when the crest is used as a link.
      */
     aria?: SelectedAriaAttributes<CrestAriaAttribute>;
     /**
-     * When `href` is provided, the component renders as an `<a>` element.
+     * When set, renders the crest as an anchor element navigating to this URL when clicked.
      */
     href?: string;
     /**
-     * Specifies where to open the linked document.
+     * Specifies where to open the linked URL (e.g. `_self`, `_blank`). Only applies when `href` is set.
      * @default '_self'
      */
     target?: CrestTarget;

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

@@ -2,54 +2,54 @@ import type { BaseProps } from '../../BaseProps';
 import type { DisplayAlign, DisplayColor, BreakpointCustomizable, DisplaySize, DisplayTag } from '../types';
 export type PDisplayProps = BaseProps & {
     /**
-     * Text alignment of the component.
+     * Sets the horizontal text alignment (`start`, `center`, `end`, or `inherit`).
      * @default 'start'
      */
     align?: DisplayAlign;
     /**
-     * Basic text color variations.
+     * Sets the text color using PDS color tokens.
      * @default 'primary'
      */
     color?: DisplayColor;
     /**
-     * Adds an ellipsis to a single line of text if it overflows.
+     * Truncates the text with an ellipsis when it overflows the container on a single line.
      * @default false
      */
     ellipsis?: boolean;
     /**
-     * Size of the component. Also defines the size for specific breakpoints, like {base: "medium", l: "large"}. You always need to provide a base value when doing this.
+     * Sets the visual text size. Supports responsive breakpoint values.
      * @default 'large'
      */
     size?: BreakpointCustomizable<DisplaySize>;
     /**
-     * Sets a heading tag, so it fits correctly within the outline of the page.
+     * Sets the HTML heading tag (h1–h6) for correct document outline placement. When omitted, the tag is inferred from `size`.
      */
     tag?: DisplayTag;
 };
 /** @deprecated since v4.0.0, will be removed with next major release. Please use `p-heading` instead. */
 export declare const PDisplay: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Text alignment of the component.
+     * Sets the horizontal text alignment (`start`, `center`, `end`, or `inherit`).
      * @default 'start'
      */
     align?: DisplayAlign;
     /**
-     * Basic text color variations.
+     * Sets the text color using PDS color tokens.
      * @default 'primary'
      */
     color?: DisplayColor;
     /**
-     * Adds an ellipsis to a single line of text if it overflows.
+     * Truncates the text with an ellipsis when it overflows the container on a single line.
      * @default false
      */
     ellipsis?: boolean;
     /**
-     * Size of the component. Also defines the size for specific breakpoints, like {base: "medium", l: "large"}. You always need to provide a base value when doing this.
+     * Sets the visual text size. Supports responsive breakpoint values.
      * @default 'large'
      */
     size?: BreakpointCustomizable<DisplaySize>;
     /**
-     * Sets a heading tag, so it fits correctly within the outline of the page.
+     * Sets the HTML heading tag (h1–h6) for correct document outline placement. When omitted, the tag is inferred from `size`.
      */
     tag?: DisplayTag;
 } & {

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

@@ -2,24 +2,24 @@ import type { BaseProps } from '../../BaseProps';
 import type { DividerColor, BreakpointCustomizable, DividerDirection } from '../types';
 export type PDividerProps = BaseProps & {
     /**
-     * Defines color.
+     * Sets the color of the divider line using PDS contrast tokens.
      * @default 'contrast-lower'
      */
     color?: DividerColor;
     /**
-     * Defines direction.
+     * Sets the orientation of the divider to `horizontal` or `vertical`. Supports responsive breakpoint values.
      * @default 'horizontal'
      */
     direction?: BreakpointCustomizable<DividerDirection>;
 };
 export declare const PDivider: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Defines color.
+     * Sets the color of the divider line using PDS contrast tokens.
      * @default 'contrast-lower'
      */
     color?: DividerColor;
     /**
-     * Defines direction.
+     * Sets the orientation of the divider to `horizontal` or `vertical`. Supports responsive breakpoint values.
      * @default 'horizontal'
      */
     direction?: BreakpointCustomizable<DividerDirection>;

package/ssr/esm/lib/components/drilldown-item.wrapper.d.ts

@@ -6,11 +6,11 @@ export type PDrilldownItemProps = BaseProps & {
      */
     cascade?: boolean;
     /**
-     * Unique identifier which controls if this item should be shown when the active-identifier on the drilldown is set to this value.
+     * Sets the unique identifier matched against the drilldown's `activeIdentifier` to determine if this item is shown.
      */
     identifier: string;
     /**
-     * Renders back button, header section on mobile view and cascade button to reach a deeper level of the navigation structure.
+     * Sets the text used for the back button, sticky header, and cascade button that navigates into this navigation level.
      */
     label?: string;
     /**
@@ -31,11 +31,11 @@ export declare const PDrilldownItem: import("react").ForwardRefExoticComponent<O
      */
     cascade?: boolean;
     /**
-     * Unique identifier which controls if this item should be shown when the active-identifier on the drilldown is set to this value.
+     * Sets the unique identifier matched against the drilldown's `activeIdentifier` to determine if this item is shown.
      */
     identifier: string;
     /**
-     * Renders back button, header section on mobile view and cascade button to reach a deeper level of the navigation structure.
+     * Sets the text used for the back button, sticky header, and cascade button that navigates into this navigation level.
      */
     label?: string;
     /**

package/ssr/esm/lib/components/drilldown-link.wrapper.d.ts

@@ -2,56 +2,56 @@ import type { BaseProps } from '../../BaseProps';
 import type { SelectedAriaAttributes, DrilldownLinkAriaAttribute, DrilldownLinkTarget } from '../types';
 export type PDrilldownLinkProps = BaseProps & {
     /**
-     * Displays the link in its active state.
+     * Visually marks the link as the currently active navigation item, e.g. the current page.
      * @default false
      */
     active?: boolean;
     /**
-     * Add ARIA attributes (only has effect when `href` is defined and no slotted anchor is used).
+     * Sets ARIA attributes on the link for improved accessibility. Only applies when `href` is set.
      */
     aria?: SelectedAriaAttributes<DrilldownLinkAriaAttribute>;
     /**
-     * Sets the native `download` attribute when the target URL points to a downloadable file (only has effect when `href` is defined and no slotted anchor is used).
+     * Sets the native `download` attribute to trigger a file download. Only applies when `href` is set.
      */
     download?: string;
     /**
-     * When `href` is provided, the component renders as an `<a>` element. Otherwise, provide a slotted anchor element.
+     * When set, the component renders as an anchor navigating to this URL. Otherwise, provide a slotted anchor element.
      */
     href?: string;
     /**
-     * Sets the `rel` attribute on the link (only has effect when `href` is defined and no slotted anchor is used).
+     * Sets the `rel` attribute on the link element (e.g. `noopener`). Only applies when `href` is set.
      */
     rel?: string;
     /**
-     * Target attribute where the link should be opened (only has effect when `href` is defined and no slotted anchor is used).
+     * Specifies where to open the linked URL (e.g. `_self`, `_blank`). Only applies when `href` is set.
      * @default '_self'
      */
     target?: DrilldownLinkTarget;
 };
 export declare const PDrilldownLink: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Displays the link in its active state.
+     * Visually marks the link as the currently active navigation item, e.g. the current page.
      * @default false
      */
     active?: boolean;
     /**
-     * Add ARIA attributes (only has effect when `href` is defined and no slotted anchor is used).
+     * Sets ARIA attributes on the link for improved accessibility. Only applies when `href` is set.
      */
     aria?: SelectedAriaAttributes<DrilldownLinkAriaAttribute>;
     /**
-     * Sets the native `download` attribute when the target URL points to a downloadable file (only has effect when `href` is defined and no slotted anchor is used).
+     * Sets the native `download` attribute to trigger a file download. Only applies when `href` is set.
      */
     download?: string;
     /**
-     * When `href` is provided, the component renders as an `<a>` element. Otherwise, provide a slotted anchor element.
+     * When set, the component renders as an anchor navigating to this URL. Otherwise, provide a slotted anchor element.
      */
     href?: string;
     /**
-     * Sets the `rel` attribute on the link (only has effect when `href` is defined and no slotted anchor is used).
+     * Sets the `rel` attribute on the link element (e.g. `noopener`). Only applies when `href` is set.
      */
     rel?: string;
     /**
-     * Target attribute where the link should be opened (only has effect when `href` is defined and no slotted anchor is used).
+     * Specifies where to open the linked URL (e.g. `_self`, `_blank`). Only applies when `href` is set.
      * @default '_self'
      */
     target?: DrilldownLinkTarget;