@porsche-design-system/components-react 3.6.1 → 3.7.0-rc.1

package/CHANGELOG.md

@@ -14,6 +14,44 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ### [Unreleased]
 
+### [3.7.0-rc.1] - 2023-09-20
+
+#### Added
+
+- **[EXPERIMENTAL]** Prop `loading` for `Radio Button Wrapper`
+  ([#2774](https://github.com/porsche-design-system/porsche-design-system/pull/2774))
+- Theme property supports `auto` for all themeable components, reflecting `prefers-color-scheme` based on OS system
+  settings ([#2719](https://github.com/porsche-design-system/porsche-design-system/pull/2719))
+- `hyphens` CSS property can now be overwritten in `Button Tile`, `Link Tile` and `Link Tile Model Signature` components
+  ([#2758](https://github.com/porsche-design-system/porsche-design-system/pull/2758))
+- Partials that produce innerHTML support `{ format: 'sha256' }` option for whitelisting in
+  [Content-Security-Policy (CSP)](must-know/security/content-security-policy)
+  ([#2773](https://github.com/porsche-design-system/porsche-design-system/pull/2773))
+- `Pin Code` ([#2691](https://github.com/porsche-design-system/porsche-design-system/pull/2691))
+
+#### Fixed
+
+- Dragging of `Carousel` can become stucked
+  ([#2768](https://github.com/porsche-design-system/porsche-design-system/pull/2768))
+- Color of `message` for `Fieldset`, `Fieldset Wrapper`, `Text Field Wrapper` and `Textarea Wrapper` in dark theme
+  ([#2769](https://github.com/porsche-design-system/porsche-design-system/pull/2769))
+
+#### Changed
+
+- Usage of `getInitialStyles()` partial is required and validated with an exception
+  ([#2749](https://github.com/porsche-design-system/porsche-design-system/pull/2749))
+
+### [3.7.0-rc.0] - 2023-09-05
+
+#### Added
+
+- `Multi Select` ([#2658](https://github.com/porsche-design-system/porsche-design-system/pull/2658))
+
+#### Changed
+
+- Partials: `Cdn` and `Format` types are exposed
+  ([#2760](https://github.com/porsche-design-system/porsche-design-system/pull/2760))
+
 ### [3.6.1] - 2023-08-29
 
 ### [3.6.1-rc.0] - 2023-08-29

package/cjs/lib/components/multi-select-option.wrapper.cjs

@@ -0,0 +1,25 @@
+'use client';
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('react');
+var hooks = require('../../hooks.cjs');
+var utils = require('../../utils.cjs');
+
+const PMultiSelectOption = react.forwardRef(({ disabled = false, value, className, ...rest }, ref) => {
+    const elementRef = react.useRef();
+    const WebComponentTag = hooks.usePrefix('p-multi-select-option');
+    const propsToSync = [disabled, value];
+    hooks.useBrowserLayoutEffect(() => {
+        const { current } = elementRef;
+        ['disabled', 'value'].forEach((propName, i) => (current[propName] = propsToSync[i]));
+    }, propsToSync);
+    const props = {
+        ...rest,
+        class: hooks.useMergedClass(elementRef, className),
+        ref: utils.syncRef(elementRef, ref)
+    };
+    return jsxRuntime.jsx(WebComponentTag, { ...props });
+});
+
+exports.PMultiSelectOption = PMultiSelectOption;

package/cjs/lib/components/multi-select.wrapper.cjs

@@ -0,0 +1,26 @@
+'use client';
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('react');
+var hooks = require('../../hooks.cjs');
+var utils = require('../../utils.cjs');
+
+const PMultiSelect = react.forwardRef(({ description = '', disabled = false, dropdownDirection = 'auto', hideLabel = false, label = '', message = '', name, onUpdate, required = false, state = 'none', theme = 'light', value = [], className, ...rest }, ref) => {
+    const elementRef = react.useRef();
+    hooks.useEventCallback(elementRef, 'update', onUpdate);
+    const WebComponentTag = hooks.usePrefix('p-multi-select');
+    const propsToSync = [description, disabled, dropdownDirection, hideLabel, label, message, name, required, state, theme, value];
+    hooks.useBrowserLayoutEffect(() => {
+        const { current } = elementRef;
+        ['description', 'disabled', 'dropdownDirection', 'hideLabel', 'label', 'message', 'name', 'required', 'state', 'theme', 'value'].forEach((propName, i) => (current[propName] = propsToSync[i]));
+    }, propsToSync);
+    const props = {
+        ...rest,
+        class: hooks.useMergedClass(elementRef, className),
+        ref: utils.syncRef(elementRef, ref)
+    };
+    return jsxRuntime.jsx(WebComponentTag, { ...props });
+});
+
+exports.PMultiSelect = PMultiSelect;

package/cjs/lib/components/pin-code.wrapper.cjs

@@ -0,0 +1,26 @@
+'use client';
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('react');
+var hooks = require('../../hooks.cjs');
+var utils = require('../../utils.cjs');
+
+const PPinCode = react.forwardRef(({ description = '', disabled = false, hideLabel = false, label = '', length = 4, loading = false, message = '', name, onUpdate, required = false, state = 'none', theme = 'light', type = 'number', value = '', className, ...rest }, ref) => {
+    const elementRef = react.useRef();
+    hooks.useEventCallback(elementRef, 'update', onUpdate);
+    const WebComponentTag = hooks.usePrefix('p-pin-code');
+    const propsToSync = [description, disabled, hideLabel, label, length, loading, message, name, required, state, theme, type, value];
+    hooks.useBrowserLayoutEffect(() => {
+        const { current } = elementRef;
+        ['description', 'disabled', 'hideLabel', 'label', 'length', 'loading', 'message', 'name', 'required', 'state', 'theme', 'type', 'value'].forEach((propName, i) => (current[propName] = propsToSync[i]));
+    }, propsToSync);
+    const props = {
+        ...rest,
+        class: hooks.useMergedClass(elementRef, className),
+        ref: utils.syncRef(elementRef, ref)
+    };
+    return jsxRuntime.jsx(WebComponentTag, { ...props });
+});
+
+exports.PPinCode = PPinCode;

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

@@ -6,13 +6,13 @@ var react = require('react');
 var hooks = require('../../hooks.cjs');
 var utils = require('../../utils.cjs');
 
-const PRadioButtonWrapper = react.forwardRef(({ hideLabel = false, label = '', message = '', state = 'none', theme = 'light', className, ...rest }, ref) => {
+const PRadioButtonWrapper = react.forwardRef(({ hideLabel = false, label = '', loading = false, message = '', state = 'none', theme = 'light', className, ...rest }, ref) => {
     const elementRef = react.useRef();
     const WebComponentTag = hooks.usePrefix('p-radio-button-wrapper');
-    const propsToSync = [hideLabel, label, message, state, theme];
+    const propsToSync = [hideLabel, label, loading, message, state, theme];
     hooks.useBrowserLayoutEffect(() => {
         const { current } = elementRef;
-        ['hideLabel', 'label', 'message', 'state', 'theme'].forEach((propName, i) => (current[propName] = propsToSync[i]));
+        ['hideLabel', 'label', 'loading', 'message', 'state', 'theme'].forEach((propName, i) => (current[propName] = propsToSync[i]));
     }, propsToSync);
     const props = {
         ...rest,

package/cjs/public-api.cjs

@@ -32,7 +32,10 @@ var linkTileModelSignature_wrapper = require('./lib/components/link-tile-model-s
 var marque_wrapper = require('./lib/components/marque.wrapper.cjs');
 var modal_wrapper = require('./lib/components/modal.wrapper.cjs');
 var modelSignature_wrapper = require('./lib/components/model-signature.wrapper.cjs');
+var multiSelect_wrapper = require('./lib/components/multi-select.wrapper.cjs');
+var multiSelectOption_wrapper = require('./lib/components/multi-select-option.wrapper.cjs');
 var pagination_wrapper = require('./lib/components/pagination.wrapper.cjs');
+var pinCode_wrapper = require('./lib/components/pin-code.wrapper.cjs');
 var popover_wrapper = require('./lib/components/popover.wrapper.cjs');
 var radioButtonWrapper_wrapper = require('./lib/components/radio-button-wrapper.wrapper.cjs');
 var scroller_wrapper = require('./lib/components/scroller.wrapper.cjs');
@@ -103,7 +106,10 @@ exports.PLinkTileModelSignature = linkTileModelSignature_wrapper.PLinkTileModelS
 exports.PMarque = marque_wrapper.PMarque;
 exports.PModal = modal_wrapper.PModal;
 exports.PModelSignature = modelSignature_wrapper.PModelSignature;
+exports.PMultiSelect = multiSelect_wrapper.PMultiSelect;
+exports.PMultiSelectOption = multiSelectOption_wrapper.PMultiSelectOption;
 exports.PPagination = pagination_wrapper.PPagination;
+exports.PPinCode = pinCode_wrapper.PPinCode;
 exports.PPopover = popover_wrapper.PPopover;
 exports.PRadioButtonWrapper = radioButtonWrapper_wrapper.PRadioButtonWrapper;
 exports.PScroller = scroller_wrapper.PScroller;

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

@@ -66,7 +66,7 @@ export declare const PAccordion: import("react").ForwardRefExoticComponent<Omit<
     /**
      * Adapts the color when used on dark background.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & {
     children?: import("react").ReactNode;
 } & import("react").RefAttributes<HTMLElement>>;

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

@@ -71,7 +71,7 @@ export declare const PBanner: import("react").ForwardRefExoticComponent<Omit<HTM
     /**
      * Adapts the banner color depending on the theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
     /**
      * Has no effect anymore
      * @deprecated since v3.0.0, will be removed with next major release

package/esm/lib/components/button-pure.wrapper.d.ts

@@ -99,7 +99,7 @@ export declare const PButtonPure: import("react").ForwardRefExoticComponent<Omit
     /**
      * Adapts the button color depending on the theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
     /**
      * Specifies the type of the button.
      */

package/esm/lib/components/button-tile.wrapper.d.ts

@@ -78,7 +78,7 @@ export declare const PButtonTile: import("react").ForwardRefExoticComponent<Omit
     /**
      * Adapts the description and button theme when used on light background image.
      */
-    background?: "light" | "dark" | undefined;
+    background?: "auto" | "light" | "dark" | undefined;
     /**
      * Displays the button-tile as compact version with description and button icon only.
      */

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

@@ -66,7 +66,7 @@ export declare const PButton: import("react").ForwardRefExoticComponent<Omit<HTM
     /**
      * Adapts the button color depending on the theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
     /**
      * Specifies the type of the button.
      */

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

@@ -115,7 +115,7 @@ export declare const PCarousel: import("react").ForwardRefExoticComponent<Omit<H
     /**
      * Adapts the color when used on dark background.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
     /**
      * Defines the outer spacings between the carousel and the left and right screen sides.
      */

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

@@ -50,7 +50,7 @@ export declare const PCheckboxWrapper: import("react").ForwardRefExoticComponent
     /**
      * Adapts the color depending on the theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & {
     children?: import("react").ReactNode;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/content-wrapper.wrapper.d.ts

@@ -27,7 +27,7 @@ export declare const PContentWrapper: import("react").ForwardRefExoticComponent<
      * Has no effect anymore
      * @deprecated since v3.0.0, will be removed with next major release
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
     /**
      * Defines the outer spacings between the content area and the left and right screen sides, as well as centering its content and setting a max-width.
      */

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

@@ -50,7 +50,7 @@ export declare const PDisplay: import("react").ForwardRefExoticComponent<Omit<HT
     /**
      * Adapts the text color depending on the theme. Has no effect when "inherit" is set as color prop.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & {
     children?: import("react").ReactNode;
 } & import("react").RefAttributes<HTMLElement>>;

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

@@ -34,5 +34,5 @@ export declare const PDivider: import("react").ForwardRefExoticComponent<Omit<HT
     /**
      * Adapts color depending on theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/fieldset-wrapper.wrapper.d.ts

@@ -51,7 +51,7 @@ export declare const PFieldsetWrapper: import("react").ForwardRefExoticComponent
     /**
      * Adapts color depending on theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & {
     children?: import("react").ReactNode;
 } & import("react").RefAttributes<HTMLElement>>;

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

@@ -50,7 +50,7 @@ export declare const PFieldset: import("react").ForwardRefExoticComponent<Omit<H
     /**
      * Adapts color depending on theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & {
     children?: import("react").ReactNode;
 } & import("react").RefAttributes<HTMLElement>>;

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

@@ -42,7 +42,7 @@ export declare const PFlyout: import("react").ForwardRefExoticComponent<Omit<HTM
     /**
      * Adapts the flyout color depending on the theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & {
     children?: import("react").ReactNode;
 } & import("react").RefAttributes<HTMLElement>>;

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

@@ -50,7 +50,7 @@ export declare const PHeading: import("react").ForwardRefExoticComponent<Omit<HT
     /**
      * Adapts the text color depending on the theme. Has no effect when "inherit" is set as color prop.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & {
     children?: import("react").ReactNode;
 } & import("react").RefAttributes<HTMLElement>>;

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

@@ -47,7 +47,7 @@ export declare const PHeadline: import("react").ForwardRefExoticComponent<Omit<H
     /**
      * Adapts the text color depending on the theme. Has no effect when "inherit" is set as color prop.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
     /**
      * Predefined style of the headline.
      */

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

@@ -60,5 +60,5 @@ export declare const PIcon: import("react").ForwardRefExoticComponent<Omit<HTMLA
     /**
      * Adapts the color depending on the theme. Has no effect when "inherit" is set as color prop.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

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

@@ -29,7 +29,10 @@ export * from './link-tile-model-signature.wrapper';
 export * from './marque.wrapper';
 export * from './modal.wrapper';
 export * from './model-signature.wrapper';
+export * from './multi-select.wrapper';
+export * from './multi-select-option.wrapper';
 export * from './pagination.wrapper';
+export * from './pin-code.wrapper';
 export * from './popover.wrapper';
 export * from './radio-button-wrapper.wrapper';
 export * from './scroller.wrapper';

package/esm/lib/components/inline-notification.wrapper.d.ts

@@ -90,7 +90,7 @@ export declare const PInlineNotification: import("react").ForwardRefExoticCompon
     /**
      * Adapts the inline-notification color depending on the theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & {
     children?: import("react").ReactNode;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/link-pure.wrapper.d.ts

@@ -115,7 +115,7 @@ export declare const PLinkPure: import("react").ForwardRefExoticComponent<Omit<H
     /**
      * Adapts the button color depending on the theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
     /**
      * Shows an underline under the label.
      */

package/esm/lib/components/link-social.wrapper.d.ts

@@ -59,7 +59,7 @@ export declare const PLinkSocial: import("react").ForwardRefExoticComponent<Omit
     /**
      * Adapts the link color when used on dark background.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & {
     children?: import("react").ReactNode;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/link-tile.wrapper.d.ts

@@ -74,7 +74,7 @@ export declare const PLinkTile: import("react").ForwardRefExoticComponent<Omit<H
     /**
      * Adapts the description and link theme when used on light background image.
      */
-    background?: "light" | "dark" | undefined;
+    background?: "auto" | "light" | "dark" | undefined;
     /**
      * Displays the link-tile as compact version with description and link icon only.
      */

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

@@ -78,7 +78,7 @@ export declare const PLink: import("react").ForwardRefExoticComponent<Omit<HTMLA
     /**
      * Adapts the link color when used on dark background.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
     /**
      * The style variant of the link.
      */

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

@@ -10,7 +10,8 @@ export type PModalProps = Omit<HTMLAttributes<{}>, 'color'> & {
      */
     disableBackdropClick?: boolean;
     /**
-     * @deprecated since v3.0.0, will be removed with next major release, use `dismissButton` instead. If true, the modal will not have a dismiss button.
+     * If true, the modal will not have a dismiss button.
+     * @deprecated since v3.0.0, will be removed with next major release, use `dismissButton` instead.
      */
     disableCloseButton?: boolean;
     /**
@@ -48,7 +49,8 @@ export declare const PModal: import("react").ForwardRefExoticComponent<Omit<HTML
      */
     disableBackdropClick?: boolean | undefined;
     /**
-     * @deprecated since v3.0.0, will be removed with next major release, use `dismissButton` instead. If true, the modal will not have a dismiss button.
+     * If true, the modal will not have a dismiss button.
+     * @deprecated since v3.0.0, will be removed with next major release, use `dismissButton` instead.
      */
     disableCloseButton?: boolean | undefined;
     /**

package/esm/lib/components/model-signature.wrapper.d.ts

@@ -34,5 +34,5 @@ export declare const PModelSignature: import("react").ForwardRefExoticComponent<
     /**
      * Adapts color depending on theme.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

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

@@ -0,0 +1,23 @@
+import { type HTMLAttributes } from 'react';
+export type PMultiSelectOptionProps = Omit<HTMLAttributes<{}>, 'color'> & {
+    /**
+     * Disables the option.
+     */
+    disabled?: boolean;
+    /**
+     * The option value.
+     */
+    value: string;
+};
+export declare const PMultiSelectOption: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<{}>, "color"> & {
+    /**
+     * Disables the option.
+     */
+    disabled?: boolean | undefined;
+    /**
+     * The option value.
+     */
+    value: string;
+} & {
+    children?: import("react").ReactNode;
+} & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/multi-select-option.wrapper.mjs

@@ -0,0 +1,23 @@
+'use client';
+import { jsx } from 'react/jsx-runtime';
+import { forwardRef, useRef } from 'react';
+import { usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
+import { syncRef } from '../../utils.mjs';
+
+const PMultiSelectOption = forwardRef(({ disabled = false, value, className, ...rest }, ref) => {
+    const elementRef = useRef();
+    const WebComponentTag = usePrefix('p-multi-select-option');
+    const propsToSync = [disabled, value];
+    useBrowserLayoutEffect(() => {
+        const { current } = elementRef;
+        ['disabled', 'value'].forEach((propName, i) => (current[propName] = propsToSync[i]));
+    }, propsToSync);
+    const props = {
+        ...rest,
+        class: useMergedClass(elementRef, className),
+        ref: syncRef(elementRef, ref)
+    };
+    return jsx(WebComponentTag, { ...props });
+});
+
+export { PMultiSelectOption };

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

@@ -0,0 +1,104 @@
+import { type HTMLAttributes } from 'react';
+import type { MultiSelectDropdownDirection, BreakpointCustomizable, MultiSelectUpdateEvent, MultiSelectState, Theme } from '../types';
+export type PMultiSelectProps = Omit<HTMLAttributes<{}>, 'color'> & {
+    /**
+     * The description text.
+     */
+    description?: string;
+    /**
+     * Disables the multi-select
+     */
+    disabled?: boolean;
+    /**
+     * Changes the direction to which the dropdown list appears.
+     */
+    dropdownDirection?: MultiSelectDropdownDirection;
+    /**
+     * Show or hide label. For better accessibility it is recommended to show the label.
+     */
+    hideLabel?: BreakpointCustomizable<boolean>;
+    /**
+     * The label text.
+     */
+    label?: string;
+    /**
+     * The message styled depending on validation state.
+     */
+    message?: string;
+    /**
+     * The name of the control.
+     */
+    name: string;
+    /**
+     * Emitted when the selection is changed.
+     */
+    onUpdate?: (event: CustomEvent<MultiSelectUpdateEvent>) => void;
+    /**
+     * A Boolean attribute indicating that an option with a non-empty string value must be selected.
+     */
+    required?: boolean;
+    /**
+     * The validation state.
+     */
+    state?: MultiSelectState;
+    /**
+     * Adapts the select color depending on the theme.
+     */
+    theme?: Theme;
+    /**
+     * The selected values.
+     */
+    value?: string[];
+};
+export declare const PMultiSelect: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<{}>, "color"> & {
+    /**
+     * The description text.
+     */
+    description?: string | undefined;
+    /**
+     * Disables the multi-select
+     */
+    disabled?: boolean | undefined;
+    /**
+     * Changes the direction to which the dropdown list appears.
+     */
+    dropdownDirection?: "auto" | "down" | "up" | undefined;
+    /**
+     * Show or hide label. For better accessibility it is recommended to show the label.
+     */
+    hideLabel?: BreakpointCustomizable<boolean> | undefined;
+    /**
+     * The label text.
+     */
+    label?: string | undefined;
+    /**
+     * The message styled depending on validation state.
+     */
+    message?: string | undefined;
+    /**
+     * The name of the control.
+     */
+    name: string;
+    /**
+     * Emitted when the selection is changed.
+     */
+    onUpdate?: ((event: CustomEvent<MultiSelectUpdateEvent>) => void) | undefined;
+    /**
+     * A Boolean attribute indicating that an option with a non-empty string value must be selected.
+     */
+    required?: boolean | undefined;
+    /**
+     * The validation state.
+     */
+    state?: "none" | "success" | "error" | undefined;
+    /**
+     * Adapts the select color depending on the theme.
+     */
+    theme?: "auto" | "light" | "dark" | undefined;
+    /**
+     * The selected values.
+     */
+    value?: string[] | undefined;
+} & {
+    children?: import("react").ReactNode;
+} & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/multi-select.wrapper.mjs

@@ -0,0 +1,24 @@
+'use client';
+import { jsx } from 'react/jsx-runtime';
+import { forwardRef, useRef } from 'react';
+import { useEventCallback, usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
+import { syncRef } from '../../utils.mjs';
+
+const PMultiSelect = forwardRef(({ description = '', disabled = false, dropdownDirection = 'auto', hideLabel = false, label = '', message = '', name, onUpdate, required = false, state = 'none', theme = 'light', value = [], className, ...rest }, ref) => {
+    const elementRef = useRef();
+    useEventCallback(elementRef, 'update', onUpdate);
+    const WebComponentTag = usePrefix('p-multi-select');
+    const propsToSync = [description, disabled, dropdownDirection, hideLabel, label, message, name, required, state, theme, value];
+    useBrowserLayoutEffect(() => {
+        const { current } = elementRef;
+        ['description', 'disabled', 'dropdownDirection', 'hideLabel', 'label', 'message', 'name', 'required', 'state', 'theme', 'value'].forEach((propName, i) => (current[propName] = propsToSync[i]));
+    }, propsToSync);
+    const props = {
+        ...rest,
+        class: useMergedClass(elementRef, className),
+        ref: syncRef(elementRef, ref)
+    };
+    return jsx(WebComponentTag, { ...props });
+});
+
+export { PMultiSelect };

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

@@ -102,7 +102,7 @@ export declare const PPagination: import("react").ForwardRefExoticComponent<Omit
     /**
      * Adapts the color when used on dark background.
      */
-    theme?: "light" | "dark" | undefined;
+    theme?: "auto" | "light" | "dark" | undefined;
     /**
      * The total count of items.
      */