@porsche-design-system/components-react 3.16.0 → 3.17.0-rc.1

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/multi-select.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -73,11 +74,19 @@ import { splitChildren } from '../../splitChildren.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getMultiSelectCss as getComponentCss$z } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getMultiSelectCss as getComponentCss$A } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { getSelectedOptionValues, getSelectedOptions, INTERNAL_MULTI_SELECT_SLOT } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 import { StateMessage } from './state-message.mjs';
 import { Label } from './label.mjs';
 
+/**
+ * @slot {"name": "label", "description": "Shows a label. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ * @slot {"name": "description", "description": "Shows a description. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ * @slot {"name": "", "description": "Default slot for the p-multi-select-option tags." }
+ * @slot {"name": "message", "description": "Shows a state message. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ *
+ * @controlled { "props": ["value"], "event": "update", "isInternallyMutated": true }
+ */
 class DSRMultiSelect extends Component {
     host;
     isOpen = false;
@@ -85,6 +94,7 @@ class DSRMultiSelect extends Component {
     hasFilterResults = true;
     nativeSelect;
     multiSelectOptions = [];
+    multiSelectOptgroups = [];
     inputContainer;
     inputElement;
     listElement;
@@ -102,7 +112,7 @@ class DSRMultiSelect extends Component {
         const optionsSelectedId = 'options-selected';
         const dropdownId = 'list';
         const inputId = 'filter';
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$z('down', this.props.isOpen, this.props.disabled, this.props.hideLabel, this.props.state, this.props.isWithinForm, this.props.isNativePopoverCase, this.props.theme)));
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$A('down', this.props.isOpen, this.props.disabled, this.props.hideLabel, this.props.state, this.props.isWithinForm, this.props.isNativePopoverCase, this.props.theme)));
         return (jsxs(Fragment, { children: [jsxs("template", { shadowroot: "open", shadowrootmode: "open", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsxs("div", { className: "root", children: [jsx(Label, { hasLabel: this.props.label || namedSlotChildren.filter(({ props: { slot } }) => slot === 'label').length > 0, hasDescription: this.props.description || namedSlotChildren.filter(({ props: { slot } }) => slot === 'description').length > 0, host: null, label: this.props.label, description: this.props.description, htmlFor: inputId, isRequired: this.props.required, isDisabled: this.props.disabled }), this.props.currentValue && (jsxs("span", { id: optionsSelectedId, className: "sr-only", children: [getSelectedOptions(this.props.multiSelectOptions).length, " options selected"] })), jsxs("div", { className: `wrapper${this.props.disabled ? ' disabled' : ''}`, children: [jsx("input", { id: inputId, role: "combobox", autoComplete: "off", disabled: this.props.disabled, required: this.props.required, "aria-invalid": this.props.state === 'error' ? 'true' : null }), jsx(PIcon, { className: "icon", name: "arrow-head-down", theme: this.props.theme, "aria-hidden": "true" }), this.props.currentValue && (jsx(PButtonPure, { className: "button", icon: "close", hideLabel: true, theme: this.props.theme, disabled: this.props.disabled, children: "Reset selection" })), jsx("div", { ...(this.props.isNativePopoverCase && {
                                                 popover: 'auto',
                                                 className: 'popover',

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/optgroup.mjs

@@ -0,0 +1,21 @@
+import { jsx, Fragment } from 'react/jsx-runtime';
+import { splitChildren } from '../../splitChildren.mjs';
+import { Component } from 'react';
+import { minifyCss } from '../../minifyCss.mjs';
+import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
+import { getOptgroupCss as getComponentCss$y } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+
+/**
+ * @slot {"name": "", "description": "Default slot for the optgroup content." }
+ */
+class DSROptgroup extends Component {
+    host;
+    render() {
+        splitChildren(this.props.children);
+        const { theme = 'light', hidden } = this.props;
+        minifyCss(stripFocusAndHoverStyles(getComponentCss$y(this.props.disabled, theme)));
+        return (jsx(Fragment, {}));
+    }
+}
+
+export { DSROptgroup };

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/pagination.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -72,9 +73,12 @@ import '../components/wordmark.wrapper.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getPaginationCss as getComponentCss$y } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getPaginationCss as getComponentCss$x } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { getTotalPages, createPaginationItems, getCurrentActivePage, ItemType } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 
+/**
+ * @controlled { "props": ["activePage"], "event": "update", "isInternallyMutated": true }
+ */
 class DSRPagination extends Component {
     host;
     render() {
@@ -84,7 +88,7 @@ class DSRPagination extends Component {
             pageTotal,
             showLastPage: this.props.showLastPage,
         });
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$y(this.props.activePage, pageTotal, this.props.showLastPage, this.props.theme)));
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$x(this.props.activePage, pageTotal, this.props.showLastPage, this.props.theme)));
         return (jsx(Fragment, { children: jsxs("template", { shadowroot: "open", shadowrootmode: "open", shadowrootdelegatesfocus: "true", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsx("nav", { role: "navigation", "aria-label": this.props.allyLabel || this.props.intl.root, children: jsx("ul", { children: paginationItems.map((pageModel, index) => {
                                 const { type, isActive, value, isBeforeCurrent, isAfterCurrent, isBeforeBeforeCurrent, isAfterAfterCurrent, } = pageModel;
                                 const spanProps = {

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/pin-code.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -73,12 +74,19 @@ import { splitChildren } from '../../splitChildren.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getPinCodeCss as getComponentCss$x } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getPinCodeCss as getComponentCss$w } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { isCurrentInput } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 import { messageId, StateMessage } from './state-message.mjs';
 import { Label, labelId, descriptionId } from './label.mjs';
 import { LoadingMessage } from './loading-message.mjs';
 
+/**
+ * @slot {"name": "label", "description": "Shows a label. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ * @slot {"name": "description", "description": "Shows a description. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ * @slot {"name": "message", "description": "Shows a state message. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ *
+ * @controlled { "props": ["value"], "event": "update", "isInternallyMutated": true }
+ */
 class DSRPinCode extends Component {
     host;
     form;
@@ -90,7 +98,7 @@ class DSRPinCode extends Component {
         // reset array of input elements
         this.inputElements = [];
         const currentInputId = 'current-input';
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$x(this.props.hideLabel, this.props.state, this.props.disabled, this.props.loading, this.props.isWithinForm, this.props.length, this.props.theme)));
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$w(this.props.hideLabel, this.props.state, this.props.disabled, this.props.loading, this.props.isWithinForm, this.props.length, this.props.theme)));
         return (jsxs(Fragment, { children: [jsxs("template", { shadowroot: "open", shadowrootmode: "open", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsxs("div", { className: "root", children: [jsx(Label, { hasLabel: this.props.label || namedSlotChildren.filter(({ props: { slot } }) => slot === 'label').length > 0, hasDescription: this.props.description || namedSlotChildren.filter(({ props: { slot } }) => slot === 'description').length > 0, host: null, label: this.props.label, description: this.props.description, htmlFor: currentInputId, isRequired: this.props.required, isLoading: this.props.loading, isDisabled: this.props.disabled }), jsxs("div", { className: "wrapper", children: [Array.from(Array(this.props.length), (_, index) => (jsx("input", { ...(isCurrentInput(index, this.props.value, this.props.length) && { id: currentInputId }), type: this.props.type === 'number' ? 'text' : this.props.type, "aria-label": `${index + 1}-${this.props.length}`, "aria-describedby": `${labelId} ${descriptionId} ${messageId}`, "aria-invalid": this.props.state === 'error' ? 'true' : null, "aria-disabled": this.props.loading ? 'true' : null, autoComplete: "one-time-code", pattern: "\\d*", inputMode: "numeric" // get numeric keyboard on mobile
                                             , defaultValue: this.props.value[index] === ' ' ? null : this.props.value[index], disabled: this.props.disabled, required: this.props.required }, index))), this.props.loading && (jsx(PSpinner, { className: "spinner", size: "inherit", theme: this.props.theme, "aria-hidden": "true" }))] }), jsx(StateMessage, { hasMessage: (this.props.message || namedSlotChildren.filter(({ props: { slot } }) => slot === 'message').length > 0) && ['success', 'error'].includes(this.props.state), state: this.props.state, message: this.props.message, theme: this.props.theme, host: null }), this.props.isWithinForm && jsx("slot", { name: "internal-input" }), jsx(LoadingMessage, { loading: this.props.loading, initialLoading: false })] })] }), this.props.children] }));
     }

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/popover.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -73,8 +74,11 @@ import { splitChildren } from '../../splitChildren.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getPopoverCss as getComponentCss$w } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getPopoverCss as getComponentCss$v } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the popover content." }
+ */
 class DSRPopover extends Component {
     host;
     open = false;
@@ -85,7 +89,7 @@ class DSRPopover extends Component {
     parentTableElement;
     render() {
         splitChildren(this.props.children);
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$w(this.props.direction, this.props.isNativePopoverCase, this.props.theme).replace(/(:host {[\S\s]+?})[\S\s]+(button {[\S\s]+?})[\S\s]+(.icon {[\S\s]+?})[\S\s]+(.label {[\S\s]+?})[\S\s]+/, '$1\n$2\n$3\n$4')));
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$v(this.props.direction, this.props.isNativePopoverCase, this.props.theme).replace(/(:host {[\S\s]+?})[\S\s]+(button {[\S\s]+?})[\S\s]+(.icon {[\S\s]+?})[\S\s]+(.label {[\S\s]+?})[\S\s]+/, '$1\n$2\n$3\n$4')));
         return (jsxs(Fragment, { children: [jsxs("template", { shadowroot: "open", shadowrootmode: "open", shadowrootdelegatesfocus: "true", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsxs(Fragment, { children: [jsxs("button", { type: "button", ...(this.props.isNativePopoverCase ? { popoverTarget: 'spacer' } : { ...(!this.props.isNativePopoverCase && { 'aria-expanded': this.props.open }),
                                     }), children: [jsx(PIcon, { className: "icon", name: "information", theme: this.props.theme }), jsx("span", { className: "label", children: "More information" })] }), (this.props.open || this.props.isNativePopoverCase) && (jsx("div", { className: "spacer", ...(this.props.isNativePopoverCase && { popover: 'auto', id: 'spacer', onToggle: this.props.onToggle }), children: jsx("div", { className: "popover", children: this.props.description ? jsx("p", { children: this.props.description }) : jsx("slot", {}) }) }))] })] }), this.props.children] }));
     }

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/radio-button-wrapper.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -73,11 +74,16 @@ import { splitChildren } from '../../splitChildren.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getRadioButtonWrapperCss as getComponentCss$v } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getRadioButtonWrapperCss as getComponentCss$u } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { StateMessage } from './state-message.mjs';
 import { Label } from './label.mjs';
 import { LoadingMessage } from './loading-message.mjs';
 
+/**
+ * @slot {"name": "label", "description": "Shows a label. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ * @slot {"name": "", "description": "Default slot for the input." }
+ * @slot {"name": "message", "description": "Shows a state message. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ */
 class DSRRadioButtonWrapper extends Component {
     host;
     input;
@@ -85,7 +91,7 @@ class DSRRadioButtonWrapper extends Component {
         const { children, namedSlotChildren, otherChildren } = splitChildren(this.props.children);
         const { disabled } = typeof otherChildren[0] === 'object' && 'props' in otherChildren[0] && otherChildren[0]?.props || {};
         const isLoading = this.props.loading && !(typeof otherChildren[0] === 'object' && 'props' in otherChildren[0] && (otherChildren[0]?.props.checked || otherChildren[0]?.props.defaultChecked)); // spinner is only displayed when radio is not checked already
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$v(this.props.hideLabel, this.props.state, disabled, isLoading, this.props.theme)));
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$u(this.props.hideLabel, this.props.state, disabled, isLoading, this.props.theme)));
         return (jsxs(Fragment, { children: [jsxs("template", { shadowroot: "open", shadowrootmode: "open", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsxs("div", { className: "root", children: [jsx(Label, { hasLabel: this.props.label || namedSlotChildren.filter(({ props: { slot } }) => slot === 'label').length > 0, hasDescription: this.props.description || namedSlotChildren.filter(({ props: { slot } }) => slot === 'description').length > 0, host: null, label: this.props.label, isLoading: isLoading, isDisabled: disabled, formElement: typeof otherChildren[0] === 'object' && 'props' in otherChildren[0] && otherChildren[0]?.props }), jsxs("div", { className: "wrapper", children: [jsx("slot", {}), isLoading && (jsx(PSpinner, { className: "spinner", size: "inherit", theme: this.props.theme, "aria-hidden": "true" }))] }), jsx(StateMessage, { hasMessage: (this.props.message || namedSlotChildren.filter(({ props: { slot } }) => slot === 'message').length > 0) && ['success', 'error'].includes(this.props.state), state: this.props.state, message: this.props.message, theme: this.props.theme, host: null }), jsx(LoadingMessage, { loading: isLoading, initialLoading: false })] })] }), this.props.children] }));
     }
 }

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/required.mjs

@@ -1,7 +1,7 @@
-import { jsx } from 'react/jsx-runtime';
+import { jsxs } from 'react/jsx-runtime';
 
 const Required = () => {
-    return jsx("span", { className: "required", children: " *" });
+    return (jsxs("span", { className: "required", "aria-hidden": "true", children: [' ', "*"] }));
 };
 
 export { Required };

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/scroller.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -73,9 +74,12 @@ import { splitChildren } from '../../splitChildren.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getScrollerCss as getComponentCss$u } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getScrollerCss as getComponentCss$t } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { scrollAreaClass, parseAndGetAriaAttributes, isScrollable } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the scroller content." }
+ */
 class DSRScroller extends Component {
     host;
     isPrevHidden = true;
@@ -92,7 +96,7 @@ class DSRScroller extends Component {
             // TODO: why not use p-button?
             return (jsx("div", { className: direction === 'next' ? 'action-next' : 'action-prev', children: jsx("button", { type: "button", tabIndex: -1, "aria-hidden": "true", "aria-label": direction, children: jsx(PIcon, { className: "icon", name: direction === 'next' ? 'arrow-head-right' : 'arrow-head-left', theme: this.props.theme }) }) }, direction));
         };
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$u(deprecationMap[this.props.gradientColorScheme] || this.props.gradientColor, this.isNextHidden, this.isPrevHidden, this.props.scrollIndicatorPosition || this.props.alignScrollIndicator, this.props.scrollbar, this.props.theme)));
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$t(deprecationMap[this.props.gradientColorScheme] || this.props.gradientColor, this.isNextHidden, this.isPrevHidden, this.props.scrollIndicatorPosition || this.props.alignScrollIndicator, this.props.scrollbar, this.props.theme)));
         return (jsxs(Fragment, { children: [jsxs("template", { shadowroot: "open", shadowrootmode: "open", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsxs("div", { className: "root", children: [jsx("div", { className: scrollAreaClass, children: jsxs("div", { className: "scroll-wrapper", role: parseAndGetAriaAttributes(this.props.aria)?.role || null, tabIndex: isScrollable(this.isPrevHidden, this.isNextHidden) ? 0 : null, children: [jsx("slot", {}), jsx("div", { className: "trigger" }), jsx("div", { className: "trigger" })] }) }), ['prev', 'next'].map(renderPrevNextButton)] })] }), this.props.children] }));
     }
 }

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/segmented-control-item.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -73,9 +74,12 @@ import { splitChildren } from '../../splitChildren.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getSegmentedControlItemCss as getComponentCss$t } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getSegmentedControlItemCss as getComponentCss$s } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { getSegmentedControlItemAriaAttributes, getIconColor } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the content." }
+ */
 class DSRSegmentedControlItem extends Component {
     host;
     render() {
@@ -83,7 +87,7 @@ class DSRSegmentedControlItem extends Component {
         // this additional validation is still needed because undefined is allowed with current propTypes
         const hasIcon = !!this.props.icon || !!this.props.iconSource;
         const hasSlottedContent = !!children.length;
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$t(this.props.disabled, this.props.selected, hasIcon, hasSlottedContent, this.props.theme || 'light' // default as fallback
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$s(this.props.disabled, this.props.selected, hasIcon, hasSlottedContent, this.props.theme || 'light' // default as fallback
         )));
         return (jsxs(Fragment, { children: [jsxs("template", { shadowroot: "open", shadowrootmode: "open", shadowrootdelegatesfocus: "true", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsxs("button", { type: "button", ...getSegmentedControlItemAriaAttributes(this.props.selected, this.props.disabled, this.props.aria), children: [this.props.label && jsx("span", { children: this.props.label }), hasIcon && (jsx(PIcon, { className: "icon", size: "inherit", name: this.props.icon, source: this.props.iconSource, color: getIconColor(this.props.disabled), theme: this.props.theme || 'light', "aria-hidden": "true" })), jsx("slot", {})] })] }), this.props.children] }));
     }

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/segmented-control.mjs

@@ -3,8 +3,13 @@ import { splitChildren } from '../../splitChildren.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getSegmentedControlCss as getComponentCss$s } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getSegmentedControlCss as getComponentCss$r } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the `p-segmented-control-item` tags." }
+ *
+ * @controlled { "props": ["value"], "event": "update", "isInternallyMutated": true }
+ */
 class DSRSegmentedControl extends Component {
     host;
     render() {
@@ -12,7 +17,7 @@ class DSRSegmentedControl extends Component {
         const manipulatedChildren = children.map((child) => typeof child === 'object' && 'props' in child && otherChildren.includes(child)
             ? { ...child, props: { ...child.props, selected: child.props?.value === this.props.value, backgroundColor: this.props.backgroundColor, theme: this.props.theme } }
             : child);
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$s(100, this.props.columns)));
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$r(100, this.props.columns)));
         return (jsxs(Fragment, { children: [jsxs("template", { shadowroot: "open", shadowrootmode: "open", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsx(Fragment, { children: jsx("slot", {}) })] }), manipulatedChildren] }));
     }
 }

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/select-option.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -73,15 +74,18 @@ import { splitChildren } from '../../splitChildren.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getSelectOptionCss as getComponentCss$p } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getSelectOptionCss as getComponentCss$z } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { getOptionAriaAttributes } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the option content." }
+ */
 class DSRSelectOption extends Component {
     host;
     render() {
         splitChildren(this.props.children);
         const { theme = 'light', selected, highlighted, hidden } = this.props;
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$p(theme)));
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$z(theme)));
         return (jsxs(Fragment, { children: [jsxs("template", { shadowroot: "open", shadowrootmode: "open", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsx(Fragment, { children: jsxs("div", { role: "option", className: {
                                     option: true,
                                     'option--selected': selected,

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/select-wrapper-dropdown.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -72,7 +73,7 @@ import '../components/wordmark.wrapper.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getSelectWrapperDropdownCss as getComponentCss$r } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getSelectWrapperDropdownCss as getComponentCss$q } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { getSelectedOptionMap } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 
 class DSRSelectWrapperDropdown extends Component {
@@ -93,7 +94,7 @@ class DSRSelectWrapperDropdown extends Component {
         const part = 'select-wrapper-dropdown';
         this.props.description && 'description';
         const buttonId = 'value';
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$r(this.props.direction === 'auto'
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$q(this.props.direction === 'auto'
             ? 'down'
             : this.props.direction, this.isOpen, this.props.state, this.props.disabled, this.props.filter, this.props.isNativePopoverCase, this.props.theme)));
         return (jsx(Fragment, { children: jsxs("template", { shadowroot: "open", shadowrootmode: "open", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsx(Fragment, { children: this.props.filter ? ([

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/select-wrapper.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -74,11 +75,17 @@ import { splitChildren } from '../../splitChildren.mjs';
 import { Component } from 'react';
 import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
-import { getSelectWrapperCss as getComponentCss$q } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
+import { getSelectWrapperCss as getComponentCss$p } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { isCustomDropdown } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 import { StateMessage } from './state-message.mjs';
 import { Label } from './label.mjs';
 
+/**
+ * @slot {"name": "label", "description": "Shows a label. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ * @slot {"name": "description", "description": "Shows a description. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ * @slot {"name": "", "description": "Default slot for the `select` tag." }
+ * @slot {"name": "message", "description": "Shows a state message. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ */
 class DSRSelectWrapper extends Component {
     host;
     select;
@@ -87,7 +94,7 @@ class DSRSelectWrapper extends Component {
         const hasCustomDropdown = isCustomDropdown(this.props.filter, this.props.native);
         const { children, namedSlotChildren, otherChildren } = splitChildren(this.props.children);
         const { disabled } = typeof otherChildren[0] === 'object' && 'props' in otherChildren[0] && otherChildren[0]?.props || {};
-        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$q(disabled, hasCustomDropdown, this.props.hideLabel, this.props.state, this.props.theme)));
+        const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$p(disabled, hasCustomDropdown, this.props.hideLabel, this.props.state, this.props.theme)));
         return (jsxs(Fragment, { children: [jsxs("template", { shadowroot: "open", shadowrootmode: "open", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsxs("div", { className: "root", children: [jsx(Label, { hasLabel: this.props.label || namedSlotChildren.filter(({ props: { slot } }) => slot === 'label').length > 0, hasDescription: this.props.description || namedSlotChildren.filter(({ props: { slot } }) => slot === 'description').length > 0, host: null, label: this.props.label, description: this.props.description, isDisabled: disabled, formElement: typeof otherChildren[0] === 'object' && 'props' in otherChildren[0] && otherChildren[0]?.props }), jsxs("div", { className: "wrapper", children: [jsx("slot", {}), jsx(PIcon, { className: "icon", name: "arrow-head-down", theme: this.props.theme, color: disabled ? 'state-disabled' : 'primary', "aria-hidden": "true" }), hasCustomDropdown && !disabled && (jsx(PSelectWrapperDropdown, { className: "dropdown", selectRef: typeof otherChildren[0] === 'object' && 'props' in otherChildren[0] && otherChildren[0]?.props, label: this.props.label || namedSlotChildren.find(({ props: { slot } }) => slot === 'label')?.props.children, message: this.props.message || namedSlotChildren.find(({ props: { slot } }) => slot === 'message')?.props.children, description: this.props.description || namedSlotChildren.find(({ props: { slot } }) => slot === 'description')?.props.children, state: this.props.state, direction: this.props.dropdownDirection, filter: this.props.filter, theme: this.props.theme, required: false, disabled: disabled, onOpenChange: (isOpen) => this.props.iconElement.classList.toggle('icon--open', isOpen) }))] }), jsx(StateMessage, { hasMessage: (this.props.message || namedSlotChildren.filter(({ props: { slot } }) => slot === 'message').length > 0) && ['success', 'error'].includes(this.props.state), state: this.props.state, message: this.props.message, theme: this.props.theme, host: null })] })] }), this.props.children] }));
     }
 }

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/select.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -78,6 +79,14 @@ import { getComboboxAriaAttributes, getSelectedOptionString, getListAriaAttribut
 import { Label, labelId } from './label.mjs';
 import { messageId, StateMessage } from './state-message.mjs';
 
+/**
+ * @slot {"name": "label", "description": "Shows a label. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ * @slot {"name": "description", "description": "Shows a description. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ * @slot {"name": "", "description": "Default slot for the `p-select-option` tags." }
+ * @slot {"name": "message", "description": "Shows a state message. Only [phrasing content](https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Phrasing_content) is allowed." }
+ *
+ * @controlled { "props": ["value"], "event": "update", "isInternallyMutated": true }
+ */
 class DSRSelect extends Component {
     host;
     isOpen = false;
@@ -87,6 +96,7 @@ class DSRSelect extends Component {
     combobox;
     listElement;
     selectOptions = [];
+    selectOptgroups = [];
     form;
     isWithinForm;
     preventOptionUpdate = false; // Used to prevent value watcher from updating options when options are already updated
@@ -101,9 +111,8 @@ class DSRSelect extends Component {
         const dropdownId = 'list';
         const descriptionId = this.props.description ? 'description' : undefined;
         const selectMessageId = (this.props.message || namedSlotChildren.filter(({ props: { slot } }) => slot === 'message').length > 0) && ['success', 'error'].includes(this.props.state) ? messageId : undefined;
-        const ariaDescribedBy = descriptionId && selectMessageId
-            ? `${descriptionId} ${selectMessageId}`
-            : descriptionId || selectMessageId || undefined;
+        const initialStatusId = 'initial-status';
+        const ariaDescribedBy = [descriptionId, selectMessageId, initialStatusId].filter(Boolean).join(' ');
         const style = minifyCss(stripFocusAndHoverStyles(getComponentCss$o('down', this.props.isOpen, this.props.disabled, this.props.hideLabel, this.props.state, this.props.isWithinForm, this.props.isNativePopoverCase, this.props.theme)));
         return (jsxs(Fragment, { children: [jsxs("template", { shadowroot: "open", shadowrootmode: "open", children: [jsx("style", { dangerouslySetInnerHTML: { __html: style } }), jsxs("div", { className: "root", children: [jsx(Label, { hasLabel: this.props.label || namedSlotChildren.filter(({ props: { slot } }) => slot === 'label').length > 0, hasDescription: this.props.description || namedSlotChildren.filter(({ props: { slot } }) => slot === 'description').length > 0, host: null, label: this.props.label, description: this.props.description, htmlFor: buttonId, isRequired: this.props.required, isDisabled: this.props.disabled }), jsxs("div", { className: `wrapper${this.props.disabled ? ' disabled' : ''}`, children: [jsx("button", { type: "button", role: "combobox", id: buttonId, ...getComboboxAriaAttributes(this.props.isOpen, this.props.required, labelId, ariaDescribedBy, dropdownId), disabled: this.props.disabled, children: getSelectedOptionString(otherChildren) }), jsx(PIcon, { className: "icon", name: "arrow-head-down", theme: this.props.theme, color: this.props.disabled ? 'state-disabled' : 'primary', "aria-hidden": "true" }), jsx("div", { ...(this.props.isNativePopoverCase && {
                                                 popover: 'auto',

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/state-message.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/stepper-horizontal-item.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -76,6 +77,9 @@ import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
 import { getStepperHorizontalItemCss as getComponentCss$m } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { isStateCompleteOrWarning, getStepperHorizontalIconName } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the content." }
+ */
 class DSRStepperHorizontalItem extends Component {
     host;
     render() {

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/stepper-horizontal.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -75,6 +76,9 @@ import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
 import { getStepperHorizontalCss as getComponentCss$l } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the `p-stepper-horizontal-item` tags." }
+ */
 class DSRStepperHorizontal extends Component {
     host;
     stepperHorizontalItems = [];

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/switch.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -77,6 +78,11 @@ import { getSwitchCss as getComponentCss$k } from '../../../../../../components/
 import { getSwitchButtonAriaAttributes } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 import { loadingId, LoadingMessage } from './loading-message.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the label." }
+ *
+ * @controlled {"props": ["checked"], "event": "update"}
+ */
 class DSRSwitch extends Component {
     host;
     render() {

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/table-body.mjs

@@ -5,6 +5,9 @@ import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
 import { getTableBodyCss as getComponentCss$j } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the table body content." }
+ */
 class DSRTableBody extends Component {
     host;
     render() {

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/table-cell.mjs

@@ -5,6 +5,9 @@ import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
 import { getTableCellCss as getComponentCss$i } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the table cell content." }
+ */
 class DSRTableCell extends Component {
     host;
     render() {

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/table-head-cell.mjs

@@ -36,6 +36,7 @@ import '../components/modal.wrapper.mjs';
 import '../components/model-signature.wrapper.mjs';
 import '../components/multi-select.wrapper.mjs';
 import '../components/multi-select-option.wrapper.mjs';
+import '../components/optgroup.wrapper.mjs';
 import '../components/pagination.wrapper.mjs';
 import '../components/pin-code.wrapper.mjs';
 import '../components/popover.wrapper.mjs';
@@ -76,6 +77,9 @@ import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
 import { getTableHeadCellCss as getComponentCss$g } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 import { isSortable } from '../../../../../../components/dist/utils/esm/utils-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the table head cell content." }
+ */
 class DSRTableHeadCell extends Component {
     host;
     render() {

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/table-head-row.mjs

@@ -5,6 +5,9 @@ import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
 import { getTableHeadRowCss as getComponentCss$f } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the table head row content." }
+ */
 class DSRTableHeadRow extends Component {
     host;
     render() {

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/table-head.mjs

@@ -5,6 +5,9 @@ import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
 import { getTableHeadCss as getComponentCss$e } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the table head content." }
+ */
 class DSRTableHead extends Component {
     host;
     render() {

package/ssr/esm/components-react/projects/react-ssr-wrapper/src/lib/dsr-components/table-row.mjs

@@ -5,6 +5,9 @@ import { minifyCss } from '../../minifyCss.mjs';
 import { stripFocusAndHoverStyles } from '../../stripFocusAndHoverStyles.mjs';
 import { getTableRowCss as getComponentCss$d } from '../../../../../../components/dist/styles/esm/styles-entry.mjs';
 
+/**
+ * @slot {"name": "", "description": "Default slot for the table row content." }
+ */
 class DSRTableRow extends Component {
     host;
     render() {