@porsche-design-system/components-react 4.6.0-rc.1 → 4.6.0-rc.3

package/cjs/lib/components/ai-tag.wrapper.cjs

@@ -6,7 +6,7 @@ var react = require('react');
 var hooks = require('../../hooks.cjs');
 var utils = require('../../utils.cjs');
 
-const PAiTag = /*#__PURE__*/ react.forwardRef(({ locale = 'en_US', variant = 'generated', className, ...rest }, ref) => {
+const PAiTag = /*#__PURE__*/ react.forwardRef(({ locale = 'en-US', variant = 'generated', className, ...rest }, ref) => {
     const elementRef = react.useRef(undefined);
     const WebComponentTag = hooks.usePrefix('p-ai-tag');
     const propsToSync = [locale, variant];

package/cjs/lib/components/radio-group.wrapper.cjs

@@ -6,7 +6,7 @@ var react = require('react');
 var hooks = require('../../hooks.cjs');
 var utils = require('../../utils.cjs');
 
-const PRadioGroup = /*#__PURE__*/ react.forwardRef(({ compact = false, description = '', direction = 'column', disabled = false, form, hideLabel = false, label = '', loading = false, message = '', name, onBlur, onChange, required = false, state = 'none', value = '', className, ...rest }, ref) => {
+const PRadioGroup = /*#__PURE__*/ react.forwardRef(({ compact = false, description = '', direction = 'column', disabled = false, form, hideLabel = false, label = '', loading = false, message = '', name, onBlur, onChange, required = false, state = 'none', value, className, ...rest }, ref) => {
     const elementRef = react.useRef(undefined);
     hooks.useEventCallback(elementRef, 'blur', onBlur);
     hooks.useEventCallback(elementRef, 'change', onChange);

package/esm/lib/components/ai-tag.wrapper.d.ts

@@ -2,8 +2,8 @@ import type { BaseProps } from '../../BaseProps';
 import type { AiTagLocale, AiTagVariant } from '../types';
 export type PAiTagProps = BaseProps & {
     /**
-     * Locale for the AI text (ISO format, e.g. "de_DE").
-     * @default 'en_US'
+     * Market locale for the AI text (BCP47, e.g. `en-US`). Language-only `en` is supported for international markets. POSIX forms (e.g. `en_US`) are deprecated but still accepted. Copy is resolved by language; unknown languages fall back to English.
+     * @default 'en-US'
      */
     locale?: AiTagLocale;
     /**
@@ -14,8 +14,8 @@ export type PAiTagProps = BaseProps & {
 };
 export declare const PAiTag: 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"> & {
     /**
-     * Locale for the AI text (ISO format, e.g. "de_DE").
-     * @default 'en_US'
+     * Market locale for the AI text (BCP47, e.g. `en-US`). Language-only `en` is supported for international markets. POSIX forms (e.g. `en_US`) are deprecated but still accepted. Copy is resolved by language; unknown languages fall back to English.
+     * @default 'en-US'
      */
     locale?: AiTagLocale;
     /**

package/esm/lib/components/ai-tag.wrapper.mjs

@@ -4,7 +4,7 @@ import { forwardRef, useRef } from 'react';
 import { usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
 import { syncRef } from '../../utils.mjs';
 
-const PAiTag = /*#__PURE__*/ forwardRef(({ locale = 'en_US', variant = 'generated', className, ...rest }, ref) => {
+const PAiTag = /*#__PURE__*/ forwardRef(({ locale = 'en-US', variant = 'generated', className, ...rest }, ref) => {
     const elementRef = useRef(undefined);
     const WebComponentTag = usePrefix('p-ai-tag');
     const propsToSync = [locale, variant];

package/esm/lib/components/drilldown.wrapper.d.ts

@@ -1,5 +1,5 @@
 import type { BaseProps } from '../../BaseProps';
-import type { SelectedAriaAttributes, DrilldownAriaAttribute, DrilldownUpdateEventDetail } from '../types';
+import type { SelectedAriaAttributes, DrilldownAriaAttribute, DrilldownDismissEventDetail, DrilldownUpdateEventDetail } from '../types';
 export type PDrilldownProps = BaseProps & {
     /**
      * Sets which `p-drilldown-item` (by `identifier`) is currently expanded to show its sub-navigation level.
@@ -10,9 +10,9 @@ export type PDrilldownProps = BaseProps & {
      */
     aria?: SelectedAriaAttributes<DrilldownAriaAttribute>;
     /**
-     * Emitted when the user closes the drilldown via the close button or Escape key.
+     * Emitted when the user closes the drilldown via the dismiss button, backdrop click, or Escape key. The event detail identifies which of the three was used.
      */
-    onDismiss?: (event: CustomEvent<void>) => void;
+    onDismiss?: (event: CustomEvent<DrilldownDismissEventDetail>) => void;
     /**
      * Emitted when the active navigation level changes, with the new `activeIdentifier` in the event detail.
      */
@@ -33,9 +33,9 @@ export declare const PDrilldown: import("react").ForwardRefExoticComponent<Omit<
      */
     aria?: SelectedAriaAttributes<DrilldownAriaAttribute>;
     /**
-     * Emitted when the user closes the drilldown via the close button or Escape key.
+     * Emitted when the user closes the drilldown via the dismiss button, backdrop click, or Escape key. The event detail identifies which of the three was used.
      */
-    onDismiss?: (event: CustomEvent<void>) => void;
+    onDismiss?: (event: CustomEvent<DrilldownDismissEventDetail>) => void;
     /**
      * Emitted when the active navigation level changes, with the new `activeIdentifier` in the event detail.
      */

package/esm/lib/components/flyout.wrapper.d.ts

@@ -1,5 +1,5 @@
 import type { BaseProps } from '../../BaseProps';
-import type { SelectedAriaAttributes, FlyoutAriaAttribute, FlyoutBackdrop, FlyoutBackground, FlyoutFooterBehavior, BreakpointCustomizable, FlyoutMotionHiddenEndEventDetail, FlyoutMotionVisibleEndEventDetail, FlyoutPosition } from '../types';
+import type { SelectedAriaAttributes, FlyoutAriaAttribute, FlyoutBackdrop, FlyoutBackground, FlyoutFooterBehavior, BreakpointCustomizable, FlyoutDismissEventDetail, FlyoutMotionHiddenEndEventDetail, FlyoutMotionVisibleEndEventDetail, FlyoutPosition } from '../types';
 export type PFlyoutProps = BaseProps & {
     /**
      * Sets ARIA attributes on the flyout dialog element for improved screen reader accessibility.
@@ -31,9 +31,9 @@ export type PFlyoutProps = BaseProps & {
      */
     fullscreen?: BreakpointCustomizable<boolean>;
     /**
-     * Emitted when the user closes the flyout via the close button, backdrop click, or Escape key.
+     * Emitted when the user closes the flyout via the dismiss button, backdrop click, or Escape key. The event detail identifies which of the three was used.
      */
-    onDismiss?: (event: CustomEvent<void>) => void;
+    onDismiss?: (event: CustomEvent<FlyoutDismissEventDetail>) => void;
     /**
      * Emitted after the flyout's close transition completes and the panel is fully hidden.
      */
@@ -84,9 +84,9 @@ export declare const PFlyout: import("react").ForwardRefExoticComponent<Omit<imp
      */
     fullscreen?: BreakpointCustomizable<boolean>;
     /**
-     * Emitted when the user closes the flyout via the close button, backdrop click, or Escape key.
+     * Emitted when the user closes the flyout via the dismiss button, backdrop click, or Escape key. The event detail identifies which of the three was used.
      */
-    onDismiss?: (event: CustomEvent<void>) => void;
+    onDismiss?: (event: CustomEvent<FlyoutDismissEventDetail>) => void;
     /**
      * Emitted after the flyout's close transition completes and the panel is fully hidden.
      */

package/esm/lib/components/input-number.wrapper.d.ts

@@ -66,11 +66,11 @@ export type PInputNumberProps = BaseProps & {
      */
     onBlur?: (event: CustomEvent<InputNumberBlurEventDetail>) => void;
     /**
-     * Emitted when the number input loses focus after its value was changed.
+     * Emitted when the number input loses focus after its value was changed. The component value and native event target value are strings after user input.
      */
     onChange?: (event: CustomEvent<InputNumberChangeEventDetail>) => void;
     /**
-     * Emitted when the value has been changed as a direct result of a user action.
+     * Emitted when the value has been changed as a direct result of a user action. The component value and native event target value are strings.
      */
     onInput?: (event: CustomEvent<InputNumberInputEventDetail>) => void;
     /**
@@ -99,7 +99,7 @@ export type PInputNumberProps = BaseProps & {
      */
     step?: number;
     /**
-     * Sets the current numeric value of the field.
+     * Sets the current numeric value. Strings and numbers are accepted for programmatic assignment, but user input updates the value as a string to mirror native input behavior.
      * @default ''
      */
     value?: string | number | null;
@@ -170,11 +170,11 @@ export declare const PInputNumber: import("react").ForwardRefExoticComponent<Omi
      */
     onBlur?: (event: CustomEvent<InputNumberBlurEventDetail>) => void;
     /**
-     * Emitted when the number input loses focus after its value was changed.
+     * Emitted when the number input loses focus after its value was changed. The component value and native event target value are strings after user input.
      */
     onChange?: (event: CustomEvent<InputNumberChangeEventDetail>) => void;
     /**
-     * Emitted when the value has been changed as a direct result of a user action.
+     * Emitted when the value has been changed as a direct result of a user action. The component value and native event target value are strings.
      */
     onInput?: (event: CustomEvent<InputNumberInputEventDetail>) => void;
     /**
@@ -203,7 +203,7 @@ export declare const PInputNumber: import("react").ForwardRefExoticComponent<Omi
      */
     step?: number;
     /**
-     * Sets the current numeric value of the field.
+     * Sets the current numeric value. Strings and numbers are accepted for programmatic assignment, but user input updates the value as a string to mirror native input behavior.
      * @default ''
      */
     value?: string | number | null;

package/esm/lib/components/input-text.wrapper.d.ts

@@ -66,11 +66,11 @@ export type PInputTextProps = BaseProps & {
      */
     onBlur?: (event: CustomEvent<InputTextBlurEventDetail>) => void;
     /**
-     * Emitted when the input loses focus after its value was changed.
+     * Emitted when the input loses focus after its value was changed. The component value and native event target value are strings after user input.
      */
     onChange?: (event: CustomEvent<InputTextChangeEventDetail>) => void;
     /**
-     * Emitted on every value change as the user types.
+     * Emitted on every value change as the user types. The component value and native event target value are strings.
      */
     onInput?: (event: CustomEvent<InputTextInputEventDetail>) => void;
     /**
@@ -98,7 +98,7 @@ export type PInputTextProps = BaseProps & {
      */
     state?: InputTextState;
     /**
-     * Sets the current text value of the input field.
+     * Sets the current text value. Numbers are accepted for programmatic assignment, but user input updates the value as a string.
      * @default ''
      */
     value?: string | number | null;
@@ -169,11 +169,11 @@ export declare const PInputText: import("react").ForwardRefExoticComponent<Omit<
      */
     onBlur?: (event: CustomEvent<InputTextBlurEventDetail>) => void;
     /**
-     * Emitted when the input loses focus after its value was changed.
+     * Emitted when the input loses focus after its value was changed. The component value and native event target value are strings after user input.
      */
     onChange?: (event: CustomEvent<InputTextChangeEventDetail>) => void;
     /**
-     * Emitted on every value change as the user types.
+     * Emitted on every value change as the user types. The component value and native event target value are strings.
      */
     onInput?: (event: CustomEvent<InputTextInputEventDetail>) => void;
     /**
@@ -201,7 +201,7 @@ export declare const PInputText: import("react").ForwardRefExoticComponent<Omit<
      */
     state?: InputTextState;
     /**
-     * Sets the current text value of the input field.
+     * Sets the current text value. Numbers are accepted for programmatic assignment, but user input updates the value as a string.
      * @default ''
      */
     value?: string | number | null;

package/esm/lib/components/modal.wrapper.d.ts

@@ -1,5 +1,5 @@
 import type { BaseProps } from '../../BaseProps';
-import type { SelectedAriaAttributes, ModalAriaAttribute, ModalBackdrop, ModalBackground, BreakpointCustomizable, ModalMotionHiddenEndEventDetail, ModalMotionVisibleEndEventDetail } from '../types';
+import type { SelectedAriaAttributes, ModalAriaAttribute, ModalBackdrop, ModalBackground, BreakpointCustomizable, ModalDismissEventDetail, ModalMotionHiddenEndEventDetail, ModalMotionVisibleEndEventDetail } from '../types';
 export type PModalProps = BaseProps & {
     /**
      * Sets ARIA attributes on the dialog element for improved accessibility when no visible heading is present.
@@ -31,9 +31,9 @@ export type PModalProps = BaseProps & {
      */
     fullscreen?: BreakpointCustomizable<boolean>;
     /**
-     * Emitted when the user closes the modal via the dismiss button, backdrop click, or Escape key.
+     * Emitted when the user closes the modal via the dismiss button, backdrop click, or Escape key. The event detail identifies which of the three was used.
      */
-    onDismiss?: (event: CustomEvent<void>) => void;
+    onDismiss?: (event: CustomEvent<ModalDismissEventDetail>) => void;
     /**
      * Emitted after the modal's close transition completes and the dialog is fully hidden.
      */
@@ -79,9 +79,9 @@ export declare const PModal: import("react").ForwardRefExoticComponent<Omit<impo
      */
     fullscreen?: BreakpointCustomizable<boolean>;
     /**
-     * Emitted when the user closes the modal via the dismiss button, backdrop click, or Escape key.
+     * Emitted when the user closes the modal via the dismiss button, backdrop click, or Escape key. The event detail identifies which of the three was used.
      */
-    onDismiss?: (event: CustomEvent<void>) => void;
+    onDismiss?: (event: CustomEvent<ModalDismissEventDetail>) => void;
     /**
      * Emitted after the modal's close transition completes and the dialog is fully hidden.
      */

package/esm/lib/components/multi-select-option.wrapper.d.ts

@@ -6,7 +6,7 @@ export type PMultiSelectOptionProps = BaseProps & {
      */
     disabled?: boolean;
     /**
-     * Sets the value submitted with the form data when this option is selected in the parent multi-select.
+     * Sets the required option value submitted with the form data when selected. Must be a string or number.
      */
     value: string | number;
 };
@@ -17,7 +17,7 @@ export declare const PMultiSelectOption: import("react").ForwardRefExoticCompone
      */
     disabled?: boolean;
     /**
-     * Sets the value submitted with the form data when this option is selected in the parent multi-select.
+     * Sets the required option value submitted with the form data when selected. Must be a string or number.
      */
     value: string | number;
 } & {

package/esm/lib/components/pin-code.wrapper.d.ts

@@ -54,7 +54,7 @@ export type PPinCodeProps = BaseProps & {
      */
     onBlur?: (event: CustomEvent<void>) => void;
     /**
-     * Emitted when the pin code value changes as the user types, carrying the new concatenated value in the event detail.
+     * Emitted when the pin code value changes as the user types, carrying `{ value: string; isComplete: boolean }` in the event detail.
      */
     onChange?: (event: CustomEvent<PinCodeChangeEventDetail>) => void;
     /**
@@ -73,10 +73,10 @@ export type PPinCodeProps = BaseProps & {
      */
     type?: PinCodeType;
     /**
-     * Sets the current concatenated value of all pin code fields and allows setting the initial value.
+     * Sets the current concatenated value. Numbers are accepted for programmatic assignment, but user input updates the value as a string.
      * @default ''
      */
-    value?: string;
+    value?: string | number | null;
 };
 export declare const PPinCode: 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"> & {
     /**
@@ -132,7 +132,7 @@ export declare const PPinCode: import("react").ForwardRefExoticComponent<Omit<im
      */
     onBlur?: (event: CustomEvent<void>) => void;
     /**
-     * Emitted when the pin code value changes as the user types, carrying the new concatenated value in the event detail.
+     * Emitted when the pin code value changes as the user types, carrying `{ value: string; isComplete: boolean }` in the event detail.
      */
     onChange?: (event: CustomEvent<PinCodeChangeEventDetail>) => void;
     /**
@@ -151,10 +151,10 @@ export declare const PPinCode: import("react").ForwardRefExoticComponent<Omit<im
      */
     type?: PinCodeType;
     /**
-     * Sets the current concatenated value of all pin code fields and allows setting the initial value.
+     * Sets the current concatenated value. Numbers are accepted for programmatic assignment, but user input updates the value as a string.
      * @default ''
      */
-    value?: string;
+    value?: string | number | null;
 } & {
     children?: import("react").ReactNode | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/popover.wrapper.d.ts

@@ -1,5 +1,5 @@
 import type { BaseProps } from '../../BaseProps';
-import type { SelectedAriaAttributes, PopoverAriaAttribute, PopoverDirection } from '../types';
+import type { SelectedAriaAttributes, PopoverAriaAttribute, PopoverDirection, PopoverDismissEventDetail } from '../types';
 export type PPopoverProps = BaseProps & {
     /**
      * Sets ARIA attributes on the popover panel to improve accessibility for screen readers.
@@ -19,9 +19,9 @@ export type PPopoverProps = BaseProps & {
      */
     direction?: PopoverDirection;
     /**
-     * Emitted in controlled mode when the user requests to close the popover via the Escape key, an outside click, or when keyboard focus leaves the popover (Tab / Shift+Tab).
+     * Emitted in controlled mode when the user requests to close the popover via the Escape key, an outside click, or when keyboard focus leaves the popover (Tab / Shift+Tab). The event detail identifies which of the three was used.
      */
-    onDismiss?: (event: CustomEvent<void>) => void;
+    onDismiss?: (event: CustomEvent<PopoverDismissEventDetail>) => void;
     /**
      * Controls whether the popover is visible. When set (controlled mode), visibility follows this prop and the consumer owns the open state via a slotted `button`. When omitted (uncontrolled mode), the component manages visibility itself.
      */
@@ -46,9 +46,9 @@ export declare const PPopover: import("react").ForwardRefExoticComponent<Omit<im
      */
     direction?: PopoverDirection;
     /**
-     * Emitted in controlled mode when the user requests to close the popover via the Escape key, an outside click, or when keyboard focus leaves the popover (Tab / Shift+Tab).
+     * Emitted in controlled mode when the user requests to close the popover via the Escape key, an outside click, or when keyboard focus leaves the popover (Tab / Shift+Tab). The event detail identifies which of the three was used.
      */
-    onDismiss?: (event: CustomEvent<void>) => void;
+    onDismiss?: (event: CustomEvent<PopoverDismissEventDetail>) => void;
     /**
      * Controls whether the popover is visible. When set (controlled mode), visibility follows this prop and the consumer owns the open state via a slotted `button`. When omitted (uncontrolled mode), the component manages visibility itself.
      */

package/esm/lib/components/radio-group-option.wrapper.d.ts

@@ -15,9 +15,9 @@ export type PRadioGroupOptionProps = BaseProps & {
      */
     loading?: boolean;
     /**
-     * Sets the value submitted with the form data when this radio option is selected within its parent group.
+     * Sets the required option value. Must be a string or number and is selected when it strictly matches the parent `p-radio-group` value by type and value.
      */
-    value?: string;
+    value: string | number;
 };
 export declare const PRadioGroupOption: 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"> & {
     /**
@@ -35,9 +35,9 @@ export declare const PRadioGroupOption: import("react").ForwardRefExoticComponen
      */
     loading?: boolean;
     /**
-     * Sets the value submitted with the form data when this radio option is selected within its parent group.
+     * Sets the required option value. Must be a string or number and is selected when it strictly matches the parent `p-radio-group` value by type and value.
      */
-    value?: string;
+    value: string | number;
 } & {
     children?: import("react").ReactNode | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/radio-group.wrapper.d.ts

@@ -68,10 +68,9 @@ export type PRadioGroupProps = BaseProps & {
      */
     state?: RadioGroupState;
     /**
-     * Sets the currently selected value that pre-selects the matching radio option and reflects user changes.
-     * @default ''
+     * Sets the currently selected value that pre-selects the matching radio option and reflects user changes. Matches an option strictly by type and value, meaning string or number only match an option whose value has the same type and equal value. Use undefined or null for no preselection; these values never match an option because every option requires a string or number value.  Please note that FormData always serializes values as strings, so when participating in a native (uncontrolled) form a number value is restored as string via formStateRestoreCallback and will no longer strictly match a number-typed option. This limitation only applies to native form state restoration; in controlled forms (where the consumer manages value directly via the change event), the number type is preserved end-to-end.
      */
-    value?: string;
+    value?: string | number | null;
 };
 export declare const PRadioGroup: 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"> & {
     /**
@@ -141,10 +140,9 @@ export declare const PRadioGroup: import("react").ForwardRefExoticComponent<Omit
      */
     state?: RadioGroupState;
     /**
-     * Sets the currently selected value that pre-selects the matching radio option and reflects user changes.
-     * @default ''
+     * Sets the currently selected value that pre-selects the matching radio option and reflects user changes. Matches an option strictly by type and value, meaning string or number only match an option whose value has the same type and equal value. Use undefined or null for no preselection; these values never match an option because every option requires a string or number value.  Please note that FormData always serializes values as strings, so when participating in a native (uncontrolled) form a number value is restored as string via formStateRestoreCallback and will no longer strictly match a number-typed option. This limitation only applies to native form state restoration; in controlled forms (where the consumer manages value directly via the change event), the number type is preserved end-to-end.
      */
-    value?: string;
+    value?: string | number | null;
 } & {
     children?: import("react").ReactNode | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/radio-group.wrapper.mjs

@@ -4,7 +4,7 @@ import { forwardRef, useRef } from 'react';
 import { useEventCallback, usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
 import { syncRef } from '../../utils.mjs';
 
-const PRadioGroup = /*#__PURE__*/ forwardRef(({ compact = false, description = '', direction = 'column', disabled = false, form, hideLabel = false, label = '', loading = false, message = '', name, onBlur, onChange, required = false, state = 'none', value = '', className, ...rest }, ref) => {
+const PRadioGroup = /*#__PURE__*/ forwardRef(({ compact = false, description = '', direction = 'column', disabled = false, form, hideLabel = false, label = '', loading = false, message = '', name, onBlur, onChange, required = false, state = 'none', value, className, ...rest }, ref) => {
     const elementRef = useRef(undefined);
     useEventCallback(elementRef, 'blur', onBlur);
     useEventCallback(elementRef, 'change', onChange);

package/esm/lib/components/segmented-control.wrapper.d.ts

@@ -68,9 +68,9 @@ export type PSegmentedControlProps = BaseProps & {
      */
     state?: SegmentedControlState;
     /**
-     * Sets the currently selected item's value and pre-selects the matching option when the component renders.
+     * Sets the currently selected item's value and pre-selects the matching option when the component renders. Matches an item strictly by type and value, meaning string or number only match an item whose value has the same type and equal value. Use undefined or null for no preselection.  Please note that FormData always serializes values as strings, so when participating in a native (uncontrolled) form a number value is restored as string via formStateRestoreCallback and will no longer strictly match a number-typed item. This limitation only applies to native form state restoration; in controlled forms (where the consumer manages value directly via the change event), the number type is preserved end-to-end.
      */
-    value?: string | number;
+    value?: string | number | null;
 };
 export declare const PSegmentedControl: 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"> & {
     /**
@@ -140,9 +140,9 @@ export declare const PSegmentedControl: import("react").ForwardRefExoticComponen
      */
     state?: SegmentedControlState;
     /**
-     * Sets the currently selected item's value and pre-selects the matching option when the component renders.
+     * Sets the currently selected item's value and pre-selects the matching option when the component renders. Matches an item strictly by type and value, meaning string or number only match an item whose value has the same type and equal value. Use undefined or null for no preselection.  Please note that FormData always serializes values as strings, so when participating in a native (uncontrolled) form a number value is restored as string via formStateRestoreCallback and will no longer strictly match a number-typed item. This limitation only applies to native form state restoration; in controlled forms (where the consumer manages value directly via the change event), the number type is preserved end-to-end.
      */
-    value?: string | number;
+    value?: string | number | null;
 } & {
     children?: import("react").ReactNode | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/sheet.wrapper.d.ts

@@ -1,5 +1,5 @@
 import type { BaseProps } from '../../BaseProps';
-import type { SelectedAriaAttributes, SheetAriaAttribute, SheetBackground, SheetMotionHiddenEndEventDetail, SheetMotionVisibleEndEventDetail } from '../types';
+import type { SelectedAriaAttributes, SheetAriaAttribute, SheetBackground, SheetDismissEventDetail, SheetMotionHiddenEndEventDetail, SheetMotionVisibleEndEventDetail } from '../types';
 export type PSheetProps = BaseProps & {
     /**
      * Sets ARIA attributes on the sheet dialog element for improved accessibility when the default `aria-label` is insufficient.
@@ -21,9 +21,9 @@ export type PSheetProps = BaseProps & {
      */
     dismissButton?: boolean;
     /**
-     * Emitted when the user dismisses the sheet via the close button, backdrop click, or Escape key.
+     * Emitted when the user closes the sheet via the dismiss button, backdrop click, or Escape key. The event detail identifies which of the three was used.
      */
-    onDismiss?: (event: CustomEvent<void>) => void;
+    onDismiss?: (event: CustomEvent<SheetDismissEventDetail>) => void;
     /**
      * Emitted after the sheet's close transition has fully completed and the panel is hidden.
      */
@@ -59,9 +59,9 @@ export declare const PSheet: import("react").ForwardRefExoticComponent<Omit<impo
      */
     dismissButton?: boolean;
     /**
-     * Emitted when the user dismisses the sheet via the close button, backdrop click, or Escape key.
+     * Emitted when the user closes the sheet via the dismiss button, backdrop click, or Escape key. The event detail identifies which of the three was used.
      */
-    onDismiss?: (event: CustomEvent<void>) => void;
+    onDismiss?: (event: CustomEvent<SheetDismissEventDetail>) => void;
     /**
      * Emitted after the sheet's close transition has fully completed and the panel is hidden.
      */

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

@@ -10,7 +10,7 @@ export type PWordmarkProps = BaseProps & {
      */
     href?: string;
     /**
-     * Sets the display size of the Porsche wordmark SVG using predefined PDS size tokens (`small`, `medium`, `large`, `inherit`).
+     * Sets the display size of the Porsche wordmark SVG using predefined PDS size tokens.
      * @default 'small'
      */
     size?: WordmarkSize;
@@ -30,7 +30,7 @@ export declare const PWordmark: import("react").ForwardRefExoticComponent<Omit<i
      */
     href?: string;
     /**
-     * Sets the display size of the Porsche wordmark SVG using predefined PDS size tokens (`small`, `medium`, `large`, `inherit`).
+     * Sets the display size of the Porsche wordmark SVG using predefined PDS size tokens.
      * @default 'small'
      */
     size?: WordmarkSize;