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

package/esm/lib/types.d.ts

@@ -326,10 +326,12 @@ declare const ICON_NAMES: readonly [
     "compare",
     "compass",
     "configurate",
+    "connect-services",
     "copy",
     "country-road",
     "coupe",
     "cubic-capacity",
+    "customer-support",
     "cut",
     "delete",
     "disable",
@@ -489,6 +491,7 @@ declare const ICON_NAMES: readonly [
     "shopping-bag-filled",
     "shopping-cart",
     "shopping-cart-filled",
+    "shopping-cart-off",
     "sidebar",
     "sidelights",
     "skip-backward",
@@ -694,6 +697,10 @@ export type BreakpointValues<T> = {
     base: T;
 };
 export type BreakpointCustomizable<T> = T | BreakpointValues<T>;
+export type DialogDismissReason = "dismiss-button" | "backdrop" | "escape";
+export type DialogDismissEventDetail = {
+    reason: DialogDismissReason;
+};
 declare const LINK_TARGETS: readonly [
     "_self",
     "_blank",
@@ -784,225 +791,193 @@ export type SelectedAriaAttributes<T extends keyof AriaAttributes> = Pick<AriaAt
 export type SelectedAriaRole<T> = {
     role: Extract<AriaRole, T>;
 };
+declare const MARKET_LOCALES: readonly [
+    "ar-BH",
+    "ar-KW",
+    "ar-QA",
+    "ar-SA",
+    "az-AZ",
+    "bg-BG",
+    "bs-BA",
+    "cs-CZ",
+    "cs-SK",
+    "da-DK",
+    "de-AT",
+    "de-CH",
+    "de-DE",
+    "de-LI",
+    "de-LU",
+    "el-GR",
+    "en",
+    "en-AE",
+    "en-AE-x-abu-dhabi",
+    "en-AE-x-abudhabi",
+    "en-AE-x-dubai",
+    "en-AL",
+    "en-AU",
+    "en-BA",
+    "en-BG",
+    "en-BH",
+    "en-BN",
+    "en-CA",
+    "en-CH",
+    "en-CN",
+    "en-CW",
+    "en-CY",
+    "en-CZ",
+    "en-DK",
+    "en-EE",
+    "en-EG",
+    "en-FI",
+    "en-GB",
+    "en-GE",
+    "en-GH",
+    "en-GI",
+    "en-GR",
+    "en-HK",
+    "en-HR",
+    "en-HT",
+    "en-ID",
+    "en-IE",
+    "en-IL",
+    "en-IN",
+    "en-IS",
+    "en-JM",
+    "en-JO",
+    "en-KH",
+    "en-KR",
+    "en-KW",
+    "en-KZ",
+    "en-LB",
+    "en-LK",
+    "en-LT",
+    "en-LV",
+    "en-ME",
+    "en-MK",
+    "en-MN",
+    "en-MT",
+    "en-MU",
+    "en-MY",
+    "en-NC",
+    "en-NL",
+    "en-NO",
+    "en-NZ",
+    "en-OM",
+    "en-PF",
+    "en-PH",
+    "en-PL",
+    "en-PR",
+    "en-QA",
+    "en-RO",
+    "en-RS",
+    "en-SA",
+    "en-SE",
+    "en-SG",
+    "en-SI",
+    "en-SK",
+    "en-TH",
+    "en-TR",
+    "en-TT",
+    "en-TW",
+    "en-UA",
+    "en-US",
+    "en-VE",
+    "en-VN",
+    "en-XA",
+    "en-YE",
+    "en-ZA",
+    "es-AD",
+    "es-AR",
+    "es-BO",
+    "es-CL",
+    "es-CO",
+    "es-CR",
+    "es-DO",
+    "es-EC",
+    "es-ES",
+    "es-GT",
+    "es-HN",
+    "es-MX",
+    "es-PA",
+    "es-PE",
+    "es-PR",
+    "es-PY",
+    "es-SV",
+    "es-TT",
+    "es-UY",
+    "es-VE",
+    "et-EE",
+    "fi-FI",
+    "fr-BE",
+    "fr-CA",
+    "fr-CH",
+    "fr-DZ",
+    "fr-FR",
+    "fr-GP",
+    "fr-LI",
+    "fr-LU",
+    "fr-MA",
+    "fr-MC",
+    "fr-MQ",
+    "fr-MU",
+    "fr-NC",
+    "fr-PF",
+    "fr-RE",
+    "fr-TN",
+    "he-IL",
+    "hr-HR",
+    "hu-HU",
+    "hy-AM",
+    "is-IS",
+    "it-CH",
+    "it-IT",
+    "ja-JP",
+    "ka-GE",
+    "ko-KR",
+    "lt-LT",
+    "lv-LV",
+    "me-ME",
+    "mk-MK",
+    "mt-MT",
+    "nb-NO",
+    "nl-BE",
+    "nl-NL",
+    "no-NO",
+    "pl-PL",
+    "pt-BR",
+    "pt-PT",
+    "ro-MD",
+    "ro-RO",
+    "ru-AZ",
+    "ru-BY",
+    "ru-CY",
+    "ru-EE",
+    "ru-KZ",
+    "ru-LT",
+    "ru-LV",
+    "ru-RU",
+    "ru-UK",
+    "ru-UZ",
+    "sk-SK",
+    "sl-SI",
+    "sr-ME",
+    "sr-RS",
+    "sv-SE",
+    "tr-TR",
+    "uk-UA",
+    "zh-CN",
+    "zh-HK",
+    "zh-TW"
+];
+export type MarketLocale = (typeof MARKET_LOCALES)[number];
+export type ToPosixLocale<T extends string> = T extends `${infer Head}-${infer Tail}` ? `${Head}_${ToPosixLocale<Tail>}` : T;
+export type AiTagLocale = MarketLocale | ToPosixLocale<MarketLocale>;
 declare const AI_TAG_VARIANTS: readonly [
     "abbreviation",
     "generated",
     "modified"
 ];
 export type AiTagVariant = (typeof AI_TAG_VARIANTS)[number];
-declare const AI_TAG_TRANSLATIONS: {
-    bg_BG: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    bs_BA: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    cs_CZ: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    da_DK: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    de_DE: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    el_GR: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    en_CY: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    en_GB: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    en_US: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    es_ES: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    et_EE: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    fi_FI: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    fr_FR: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    he_IL: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    hr_HR: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    hu_HU: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    is_IS: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    it_IT: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    lt_LT: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    lv_LV: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    me_ME: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    mk_MK: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    mt_MT: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    nb_NO: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    nl_NL: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    pl_PL: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    pt_PT: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    ro_RO: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    ru_RU: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    sk_SK: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    sl_SI: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    sr_RS: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    sv_SE: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    tr_TR: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-    uk_UA: {
-        short: string;
-        long: string;
-        generated: string;
-        modified: string;
-    };
-};
-export type AiTagLocale = keyof typeof AI_TAG_TRANSLATIONS;
 declare const BANNER_POSITIONS: readonly [
     "top",
     "bottom"
@@ -1158,6 +1133,7 @@ export type DrilldownAriaAttribute = (typeof DRILLDOWN_ARIA_ATTRIBUTES)[number];
 export type DrilldownUpdateEventDetail = {
     activeIdentifier: string | undefined;
 };
+export type DrilldownDismissEventDetail = DialogDismissEventDetail;
 export type DrilldownLinkTarget = LinkTarget;
 export type DrilldownLinkAriaAttribute = LinkAriaAttribute;
 declare const FIELDSET_LABEL_SIZES: readonly [
@@ -1217,6 +1193,7 @@ declare const FLYOUT_ARIA_ATTRIBUTES: readonly [
 export type FlyoutAriaAttribute = (typeof FLYOUT_ARIA_ATTRIBUTES)[number];
 export type FlyoutMotionVisibleEndEventDetail = TransitionEvent;
 export type FlyoutMotionHiddenEndEventDetail = TransitionEvent;
+export type FlyoutDismissEventDetail = DialogDismissEventDetail;
 export type FlyoutBackdrop = Backdrop;
 declare const HEADING_TAGS: readonly [
     "h1",
@@ -1446,6 +1423,7 @@ export type ModalBackground = (typeof MODAL_BACKGROUNDS)[number];
 export type ModalBackdrop = Backdrop;
 export type ModalMotionVisibleEndEventDetail = TransitionEvent;
 export type ModalMotionHiddenEndEventDetail = TransitionEvent;
+export type ModalDismissEventDetail = DialogDismissEventDetail;
 declare const MODEL_SIGNATURES_MANIFEST: {
     "718": {
         src: string;
@@ -1568,6 +1546,9 @@ declare const POPOVER_ARIA_ATTRIBUTES: readonly [
     "aria-label"
 ];
 export type PopoverAriaAttribute = (typeof POPOVER_ARIA_ATTRIBUTES)[number];
+export type PopoverDismissEventDetail = {
+    reason: "outside-click" | "focus-out" | "escape";
+};
 declare const GROUP_DIRECTIONS: readonly [
     "row",
     "column"
@@ -1616,6 +1597,7 @@ declare const SHEET_BACKGROUNDS: readonly [
 export type SheetBackground = (typeof SHEET_BACKGROUNDS)[number];
 export type SheetMotionVisibleEndEventDetail = TransitionEvent;
 export type SheetMotionHiddenEndEventDetail = TransitionEvent;
+export type SheetDismissEventDetail = DialogDismissEventDetail;
 declare const SPINNER_COLORS: readonly [
     "primary",
     "inherit"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@porsche-design-system/components-react",
-  "version": "4.6.0-rc.1",
+  "version": "4.6.0-rc.3",
   "description": "Porsche Design System is a component library designed to help developers create the best experience for software or services distributed by Dr. Ing. h.c. F. Porsche AG.",
   "keywords": [
     "porsche",
@@ -21,12 +21,13 @@
     "url": "https://github.com/porsche-design-system/porsche-design-system"
   },
   "dependencies": {
-    "@porsche-design-system/components-js": "4.6.0-rc.1"
+    "@porsche-design-system/components-js": "4.6.0-rc.3"
   },
   "peerDependencies": {
     "ag-grid-community": ">= 36.0.0 <37.0.0",
     "ag-grid-enterprise": ">= 36.0.0 <37.0.0",
     "ag-grid-react": ">= 36.0.0 <37.0.0",
+    "jsdom": ">=30.0.0",
     "react": ">=19.0.0 <20.0.0",
     "react-dom": ">=19.0.0 <20.0.0",
     "tailwindcss": ">= 4.0.0 <5.0.0"
@@ -41,6 +42,9 @@
     "ag-grid-react": {
       "optional": true
     },
+    "jsdom": {
+      "optional": true
+    },
     "tailwindcss": {
       "optional": true
     }

package/skills/pds-knowledge-react/SKILL.md

@@ -15,11 +15,11 @@ Prefer Porsche Design System components and tokens for new UI, even when the use
 
 This skill currently covers components, global stylesheets and theming, tokens, and styling integrations. It does not yet include complete getting-started, setup, and installation guidance; the v3-to-v4 migration guide; the changelog; partials; patterns and templates; the AG Grid theme; or the Storefront’s Must Know and Help sections.
 
-Before using documentation outside this skill or the installed package, match it to the installed PDS version. This skill was generated for `4.6.0-rc.1`; prefer the [exact-version Porsche Design System Storefront](https://designsystem.porsche.com/v4.6.0-rc.1/). Major-version URLs such as `/v4/` always serve the latest v4 release and may describe APIs or setup introduced after the installed version. Use them only as a fallback and verify relevant details against the installed package.
+Before using documentation outside this skill or the installed package, match it to the installed PDS version. This skill was generated for `4.6.0-rc.3`; prefer the [exact-version Porsche Design System Storefront](https://designsystem.porsche.com/v4.6.0-rc.3/). Major-version URLs such as `/v4/` always serve the latest v4 release and may describe APIs or setup introduced after the installed version. Use them only as a fallback and verify relevant details against the installed package.
 
 For runnable patterns and templates, consult the [Porsche Design System examples repository](https://github.com/porsche-design-system/examples), selecting a release tag or commit that matches the installed package instead of assuming its default branch is compatible. For release-specific changes, read `../../CHANGELOG.md`.
 
-For exact API facts, inspect the installed typings and metadata first. When readable implementation details are necessary, use the [exact-version component source](https://github.com/porsche-design-system/porsche-design-system/tree/v4.6.0-rc.1/packages/components/src/components) under the repository's `packages/components/src/components/<component>` directory. Do not use the default branch, which may represent a newer release.
+For exact API facts, inspect the installed typings and metadata first. When readable implementation details are necessary, use the [exact-version component source](https://github.com/porsche-design-system/porsche-design-system/tree/v4.6.0-rc.3/packages/components/src/components) under the repository's `packages/components/src/components/<component>` directory. Do not use the default branch, which may represent a newer release.
 
 For deployed browser behavior, inspect component requests in the Network panel. Treat these minified, content-hashed CDN artifacts as a debugging fallback; use the exact-version repository source for readable implementation details.
 
@@ -110,7 +110,7 @@ import { PButton, PorscheDesignSystemProvider } from '@porsche-design-system/com
 
 On the server, the `/ssr` build emits component markup and styles as Declarative Shadow DOM so the browser can create the Shadow DOM before JavaScript runs. In the browser, it initializes like the standard React wrapper. The framework build must replace `process.browser` for its server and client targets and eliminate the unused branch.
 
-Framework setup differs. Follow the [Next.js integration guide](https://designsystem.porsche.com/v4.6.0-rc.1/developing/next-js/getting-started/) or the [React Router integration guide](https://designsystem.porsche.com/v4.6.0-rc.1/developing/react-router/getting-started/). Remix users should follow the React Router guidance because Remix v2 was upstreamed into React Router.
+Framework setup differs. Follow the [Next.js integration guide](https://designsystem.porsche.com/v4.6.0-rc.3/developing/next-js/getting-started/) or the [React Router integration guide](https://designsystem.porsche.com/v4.6.0-rc.3/developing/react-router/getting-started/). Remix users should follow the React Router guidance because Remix v2 was upstreamed into React Router.
 
 ## Stylesheets
 

package/skills/pds-knowledge-react/references/components/p-ai-tag/p-ai-tag.md

@@ -11,7 +11,7 @@ The following segment provides instructions for designers and developers regardi
 ### Do:
 
 - Use to indicate AI-generated or AI-assisted content.
-- Use the appropriate `locale` to match the user's language.
+- Prefer BCP47 `locale` values (e.g. `de-DE`, `en-US`, or language-only `en`). POSIX forms (e.g. `de_DE`) are deprecated but still accepted. Copy is resolved by language; markets without a translation fall back to English.
 - Use the `abbreviation` variant for compact contexts where space is limited.
 - Use the `generated` or `modified` variant when a full label improves clarity.
 
@@ -30,7 +30,7 @@ For the `abbreviation` variant, the component uses an `<abbr>` element so the fu
 
 | Property | Type | Default | Description |
 | --- | --- | --- | --- |
-| `locale` | `'bg_BG'` `'bs_BA'` `'cs_CZ'` `'da_DK'` `'de_DE'` `'el_GR'` `'en_CY'` `'en_GB'` `'en_US'` `'es_ES'` `'et_EE'` `'fi_FI'` `'fr_FR'` `'he_IL'` `'hr_HR'` `'hu_HU'` `'is_IS'` `'it_IT'` `'lt_LT'` `'lv_LV'` `'me_ME'` `'mk_MK'` `'mt_MT'` `'nb_NO'` `'nl_NL'` `'pl_PL'` `'pt_PT'` `'ro_RO'` `'ru_RU'` `'sk_SK'` `'sl_SI'` `'sr_RS'` `'sv_SE'` `'tr_TR'` `'uk_UA'` | `'en_US'` | Locale for the AI text (ISO format, e.g. "de_DE"). |
+| `locale` | `'ar-BH'` `'ar-KW'` `'ar-QA'` `'ar-SA'` `'az-AZ'` `'bg-BG'` `'bs-BA'` `'cs-CZ'` `'cs-SK'` `'da-DK'` `'de-AT'` `'de-CH'` `'de-DE'` `'de-LI'` `'de-LU'` `'el-GR'` `'en'` `'en-AE'` `'en-AE-x-abu-dhabi'` `'en-AE-x-abudhabi'` `'en-AE-x-dubai'` `'en-AL'` `'en-AU'` `'en-BA'` `'en-BG'` `'en-BH'` `'en-BN'` `'en-CA'` `'en-CH'` `'en-CN'` `'en-CW'` `'en-CY'` `'en-CZ'` `'en-DK'` `'en-EE'` `'en-EG'` `'en-FI'` `'en-GB'` `'en-GE'` `'en-GH'` `'en-GI'` `'en-GR'` `'en-HK'` `'en-HR'` `'en-HT'` `'en-ID'` `'en-IE'` `'en-IL'` `'en-IN'` `'en-IS'` `'en-JM'` `'en-JO'` `'en-KH'` `'en-KR'` `'en-KW'` `'en-KZ'` `'en-LB'` `'en-LK'` `'en-LT'` `'en-LV'` `'en-ME'` `'en-MK'` `'en-MN'` `'en-MT'` `'en-MU'` `'en-MY'` `'en-NC'` `'en-NL'` `'en-NO'` `'en-NZ'` `'en-OM'` `'en-PF'` `'en-PH'` `'en-PL'` `'en-PR'` `'en-QA'` `'en-RO'` `'en-RS'` `'en-SA'` `'en-SE'` `'en-SG'` `'en-SI'` `'en-SK'` `'en-TH'` `'en-TR'` `'en-TT'` `'en-TW'` `'en-UA'` `'en-US'` `'en-VE'` `'en-VN'` `'en-XA'` `'en-YE'` `'en-ZA'` `'es-AD'` `'es-AR'` `'es-BO'` `'es-CL'` `'es-CO'` `'es-CR'` `'es-DO'` `'es-EC'` `'es-ES'` `'es-GT'` `'es-HN'` `'es-MX'` `'es-PA'` `'es-PE'` `'es-PR'` `'es-PY'` `'es-SV'` `'es-TT'` `'es-UY'` `'es-VE'` `'et-EE'` `'fi-FI'` `'fr-BE'` `'fr-CA'` `'fr-CH'` `'fr-DZ'` `'fr-FR'` `'fr-GP'` `'fr-LI'` `'fr-LU'` `'fr-MA'` `'fr-MC'` `'fr-MQ'` `'fr-MU'` `'fr-NC'` `'fr-PF'` `'fr-RE'` `'fr-TN'` `'he-IL'` `'hr-HR'` `'hu-HU'` `'hy-AM'` `'is-IS'` `'it-CH'` `'it-IT'` `'ja-JP'` `'ka-GE'` `'ko-KR'` `'lt-LT'` `'lv-LV'` `'me-ME'` `'mk-MK'` `'mt-MT'` `'nb-NO'` `'nl-BE'` `'nl-NL'` `'no-NO'` `'pl-PL'` `'pt-BR'` `'pt-PT'` `'ro-MD'` `'ro-RO'` `'ru-AZ'` `'ru-BY'` `'ru-CY'` `'ru-EE'` `'ru-KZ'` `'ru-LT'` `'ru-LV'` `'ru-RU'` `'ru-UK'` `'ru-UZ'` `'sk-SK'` `'sl-SI'` `'sr-ME'` `'sr-RS'` `'sv-SE'` `'tr-TR'` `'uk-UA'` `'zh-CN'` `'zh-HK'` `'zh-TW'`<br>_deprecated:_ `'ar_BH'` `'ar_KW'` `'ar_QA'` `'ar_SA'` `'az_AZ'` `'bg_BG'` `'bs_BA'` `'cs_CZ'` `'cs_SK'` `'da_DK'` `'de_AT'` `'de_CH'` `'de_DE'` `'de_LI'` `'de_LU'` `'el_GR'` `'en_AE'` `'en_AE_x_abu_dhabi'` `'en_AE_x_abudhabi'` `'en_AE_x_dubai'` `'en_AL'` `'en_AU'` `'en_BA'` `'en_BG'` `'en_BH'` `'en_BN'` `'en_CA'` `'en_CH'` `'en_CN'` `'en_CW'` `'en_CY'` `'en_CZ'` `'en_DK'` `'en_EE'` `'en_EG'` `'en_FI'` `'en_GB'` `'en_GE'` `'en_GH'` `'en_GI'` `'en_GR'` `'en_HK'` `'en_HR'` `'en_HT'` `'en_ID'` `'en_IE'` `'en_IL'` `'en_IN'` `'en_IS'` `'en_JM'` `'en_JO'` `'en_KH'` `'en_KR'` `'en_KW'` `'en_KZ'` `'en_LB'` `'en_LK'` `'en_LT'` `'en_LV'` `'en_ME'` `'en_MK'` `'en_MN'` `'en_MT'` `'en_MU'` `'en_MY'` `'en_NC'` `'en_NL'` `'en_NO'` `'en_NZ'` `'en_OM'` `'en_PF'` `'en_PH'` `'en_PL'` `'en_PR'` `'en_QA'` `'en_RO'` `'en_RS'` `'en_SA'` `'en_SE'` `'en_SG'` `'en_SI'` `'en_SK'` `'en_TH'` `'en_TR'` `'en_TT'` `'en_TW'` `'en_UA'` `'en_US'` `'en_VE'` `'en_VN'` `'en_XA'` `'en_YE'` `'en_ZA'` `'es_AD'` `'es_AR'` `'es_BO'` `'es_CL'` `'es_CO'` `'es_CR'` `'es_DO'` `'es_EC'` `'es_ES'` `'es_GT'` `'es_HN'` `'es_MX'` `'es_PA'` `'es_PE'` `'es_PR'` `'es_PY'` `'es_SV'` `'es_TT'` `'es_UY'` `'es_VE'` `'et_EE'` `'fi_FI'` `'fr_BE'` `'fr_CA'` `'fr_CH'` `'fr_DZ'` `'fr_FR'` `'fr_GP'` `'fr_LI'` `'fr_LU'` `'fr_MA'` `'fr_MC'` `'fr_MQ'` `'fr_MU'` `'fr_NC'` `'fr_PF'` `'fr_RE'` `'fr_TN'` `'he_IL'` `'hr_HR'` `'hu_HU'` `'hy_AM'` `'is_IS'` `'it_CH'` `'it_IT'` `'ja_JP'` `'ka_GE'` `'ko_KR'` `'lt_LT'` `'lv_LV'` `'me_ME'` `'mk_MK'` `'mt_MT'` `'nb_NO'` `'nl_BE'` `'nl_NL'` `'no_NO'` `'pl_PL'` `'pt_BR'` `'pt_PT'` `'ro_MD'` `'ro_RO'` `'ru_AZ'` `'ru_BY'` `'ru_CY'` `'ru_EE'` `'ru_KZ'` `'ru_LT'` `'ru_LV'` `'ru_RU'` `'ru_UK'` `'ru_UZ'` `'sk_SK'` `'sl_SI'` `'sr_ME'` `'sr_RS'` `'sv_SE'` `'tr_TR'` `'uk_UA'` `'zh_CN'` `'zh_HK'` `'zh_TW'` | `'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. |
 | `variant` | `'abbreviation'` `'generated'` `'modified'` | `'generated'` | Variant to display: 'abbreviation' (e.g. "AI"), 'generated' (e.g. "AI-generated"), or 'modified' (e.g. "AI-modified"). |
 
 ## Examples

package/skills/pds-knowledge-react/references/components/p-button/p-button.md

@@ -99,7 +99,7 @@ See [accessibility integration examples](./accessibility.md) for paired anti-pat
 | `disabled` | `boolean` | `false` | Disables the button, preventing all interaction and blocking events. |
 | `form` | `string` | `undefined` | Associates the button with a form element by its ID, so it can submit or reset that form even when placed outside of it. |
 | `hideLabel` | `boolean`<br>`BreakpointCustomizable<boolean>` | `false` | Hides the visible label while keeping it accessible to screen readers. Supports responsive breakpoint values. |
-| `icon` | `'none'`<br>one of 290 icon names — see [icon names](references/icons.md) | `'none'` | Sets the icon displayed inside the button. Use `none` to show no icon. |
+| `icon` | `'none'`<br>one of 293 icon names — see [icon names](references/icons.md) | `'none'` | Sets the icon displayed inside the button. Use `none` to show no icon. |
 | `iconSource` | `string` | `undefined` | Sets a path to a custom SVG icon, used instead of the built-in icon set. |
 | `loading` | `boolean` | `false` | Disables the button and replaces its content with a loading spinner to indicate an ongoing operation. |
 | `name` | `string` | `undefined` | Sets the name submitted with the form data when this button triggers form submission. |

package/skills/pds-knowledge-react/references/components/p-button-pure/p-button-pure.md

@@ -96,7 +96,7 @@ See [accessibility integration examples](./accessibility.md) for paired anti-pat
 | `disabled` | `boolean` | `false` | Disables the button, preventing all interaction and blocking events. |
 | `form` | `string` | `undefined` | Associates the button with a form element by its ID, so it can submit or reset that form even when placed outside of it. |
 | `hideLabel` | `boolean`<br>`BreakpointCustomizable<boolean>` | `false` | Hides the visible label while keeping it accessible to screen readers. Supports responsive breakpoint values. |
-| `icon` | `''`<br>one of 290 icon names — see [icon names](references/icons.md) | `'arrow-right'` | Sets the icon displayed next to the label. |
+| `icon` | `''`<br>one of 293 icon names — see [icon names](references/icons.md) | `'arrow-right'` | Sets the icon displayed next to the label. |
 | `iconSource` | `string` | `undefined` | Sets a path to a custom SVG icon, used instead of the built-in icon set. |
 | `loading` | `boolean` | `false` | Disables the button and replaces its icon with a loading spinner to indicate an ongoing operation. |
 | `name` | `string` | `undefined` | Sets the name submitted with the form data when this button triggers form submission. |

package/skills/pds-knowledge-react/references/components/p-button-tile/p-button-tile.md

@@ -92,7 +92,7 @@ See [accessibility integration examples](./accessibility.md) for paired anti-pat
 | `description` _(required)_ | `string` | `undefined` | Sets the description text displayed in the tile's content area. |
 | `disabled` | `boolean` | `false` | Disables the tile, preventing button interaction. |
 | `gradient` | `boolean` | `false` | Shows a gradient overlay over the media slot to improve text legibility on bright images or videos. |
-| `icon` | `'none'`<br>one of 290 icon names — see [icon names](references/icons.md) | `'none'` | Sets the icon displayed in the tile's action button. Use `none` to show no icon. |
+| `icon` | `'none'`<br>one of 293 icon names — see [icon names](references/icons.md) | `'none'` | Sets the icon displayed in the tile's action button. Use `none` to show no icon. |
 | `iconSource` | `string` | `undefined` | Sets a path to a custom SVG icon for the action button, used instead of the built-in icon set. |
 | `label` _(required)_ | `string` | `undefined` | Sets the accessible label text of the action button rendered inside the tile. |
 | `loading` | `boolean` | `false` | Disables the tile and shows a loading spinner to indicate an ongoing operation. |

package/skills/pds-knowledge-react/references/components/p-carousel/p-carousel.md

@@ -59,7 +59,7 @@ Therefore, the `p-carousel`'s content has to be divided into multiple parts or s
 | `aria-labelledby="IDREF"` | References the accessible name. |
 | `aria-roledescription="carousel"` | Specifies the role as "carousel". |
 | `aria-roledescription="slide"` | Specifies the role of the carousel item as "slide". |
-| `aria-live="polite"` | Announces current active slide item. |
+| `aria-live="polite"` | Announces page position after control-driven movement (prev/next, pagination, drag), e.g. "2 of 8" via `intl.slideLabel`. Not announced when navigating by focusing slides. |
 
 ## Development considerations
 

package/skills/pds-knowledge-react/references/components/p-drilldown/p-drilldown.md

@@ -92,7 +92,7 @@ See [accessibility integration examples](./accessibility.md) for paired anti-pat
 
 | Event | Type | Description |
 | --- | --- | --- |
-| `dismiss` | `CustomEvent<void>` | Emitted when the user closes the drilldown via the close button or Escape key. |
+| `dismiss` | `CustomEvent<DrilldownDismissEventDetail>`<br>`{ reason: 'dismiss-button' | 'backdrop' | 'escape' }` | 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. |
 | `update` | `CustomEvent<DrilldownUpdateEventDetail>`<br>`{ activeIdentifier: string | undefined }` | Emitted when the active navigation level changes, with the new `activeIdentifier` in the event detail. |
 
 ### Controlled properties

package/skills/pds-knowledge-react/references/components/p-flyout/p-flyout.md

@@ -95,7 +95,7 @@ See [accessibility integration examples](./accessibility.md) for paired anti-pat
 
 | Event | Type | Description |
 | --- | --- | --- |
-| `dismiss` | `CustomEvent<void>` | Emitted when the user closes the flyout via the close button, backdrop click, or Escape key. |
+| `dismiss` | `CustomEvent<FlyoutDismissEventDetail>`<br>`{ reason: 'dismiss-button' | 'backdrop' | 'escape' }` | 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. |
 | `motionHiddenEnd` | `CustomEvent<FlyoutMotionHiddenEndEventDetail>`<br>`TransitionEvent` | Emitted after the flyout's close transition completes and the panel is fully hidden. |
 | `motionVisibleEnd` | `CustomEvent<FlyoutMotionVisibleEndEventDetail>`<br>`TransitionEvent` | Emitted after the flyout's open transition completes and the panel is fully visible. |
 

package/skills/pds-knowledge-react/references/components/p-icon/examples/Overview.tsx

@@ -166,6 +166,8 @@ export const Example = () => {
 
       <PIcon name="configurate" aria={{'aria-label': 'Configurate icon'}}></PIcon>
 
+      <PIcon name="connect-services" aria={{'aria-label': 'Connect Services icon'}}></PIcon>
+
       <PIcon name="copy" aria={{'aria-label': 'Copy icon'}}></PIcon>
 
       <PIcon name="country-road" aria={{'aria-label': 'Country Road icon'}}></PIcon>
@@ -174,6 +176,8 @@ export const Example = () => {
 
       <PIcon name="cubic-capacity" aria={{'aria-label': 'Cubic Capacity icon'}}></PIcon>
 
+      <PIcon name="customer-support" aria={{'aria-label': 'Customer Support icon'}}></PIcon>
+
       <PIcon name="cut" aria={{'aria-label': 'Cut icon'}}></PIcon>
 
       <PIcon name="delete" aria={{'aria-label': 'Delete icon'}}></PIcon>
@@ -492,6 +496,8 @@ export const Example = () => {
 
       <PIcon name="shopping-cart-filled" aria={{'aria-label': 'Shopping Cart Filled icon'}}></PIcon>
 
+      <PIcon name="shopping-cart-off" aria={{'aria-label': 'Shopping Cart Off icon'}}></PIcon>
+
       <PIcon name="sidebar" aria={{'aria-label': 'Sidebar icon'}}></PIcon>
 
       <PIcon name="sidelights" aria={{'aria-label': 'Sidelights icon'}}></PIcon>

package/skills/pds-knowledge-react/references/components/p-icon/p-icon.md

@@ -67,7 +67,7 @@ See [accessibility integration examples](./accessibility.md) for paired anti-pat
 | --- | --- | --- | --- |
 | `aria` | `IconAriaAttribute` | `undefined` | Sets ARIA attributes on the icon — use `aria-label` to make the icon meaningful to screen readers when it conveys information. |
 | `color` | `'primary'` `'contrast-higher'` `'contrast-high'` `'contrast-medium'` `'contrast-low'` `'contrast-lower'` `'success'` `'warning'` `'error'` `'info'` `'inherit'` | `'primary'` | Sets the fill color of the icon using PDS color tokens. |
-| `name` | one of 290 icon names — see [icon names](references/icons.md) | `'arrow-right'` | Selects an icon from the built-in PDS icon library by name (e.g. `arrow-right`, `close`). |
+| `name` | one of 293 icon names — see [icon names](references/icons.md) | `'arrow-right'` | Selects an icon from the built-in PDS icon library by name (e.g. `arrow-right`, `close`). |
 | `size` | `'2xs'` `'xs'` `'sm'` `'md'` `'lg'` `'xl'` `'2xl'` `'3xl'` `'4xl'` `'5xl'` `'inherit'`<br>_deprecated:_ `'xx-small'` `'x-small'` `'small'` `'medium'` `'large'` `'x-large'` `'xx-large'`<br>`BreakpointCustomizable<IconSize>` | `'sm'` | Sets the icon size using the PDS typographic scale. Use `inherit` to derive size from the parent element. Supports responsive breakpoint values. |
 | `source` | `string` | `undefined` | Sets a path to a custom SVG icon, used instead of the built-in icon library. |