@porsche-design-system/components-react 4.7.0-rc.0 → 4.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +2 -0
- package/package.json +2 -2
- package/skills/pds-audit-deprecations-react/SKILL.md +2 -2
- package/skills/pds-knowledge-react/SKILL.md +3 -3
- package/skills/pds-knowledge-react/references/deprecations.md +4 -4
- package/ssr/cjs/components/dist/styles/esm/styles-entry.cjs +1 -1
- package/ssr/cjs/components/dist/utils/esm/utils-entry.cjs +1 -1
- package/ssr/esm/components/dist/styles/esm/styles-entry.mjs +1 -1
- package/ssr/esm/components/dist/utils/esm/utils-entry.mjs +1 -1
package/CHANGELOG.md
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@porsche-design-system/components-react",
|
|
3
|
-
"version": "4.7.0
|
|
3
|
+
"version": "4.7.0",
|
|
4
4
|
"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.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"porsche",
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
"url": "https://github.com/porsche-design-system/porsche-design-system"
|
|
22
22
|
},
|
|
23
23
|
"dependencies": {
|
|
24
|
-
"@porsche-design-system/components-js": "4.7.0
|
|
24
|
+
"@porsche-design-system/components-js": "4.7.0"
|
|
25
25
|
},
|
|
26
26
|
"peerDependencies": {
|
|
27
27
|
"ag-grid-community": ">= 36.0.0 <37.0.0",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: pds-audit-deprecations-react
|
|
3
3
|
description: Audit an existing react project for deprecated Porsche Design System (PDS) API usage — components, props, prop values, events, slots, CSS variables, tokens and styling-package aliases. Produces a JSON report and a Markdown report rendered from it, every finding carrying quoted evidence, a concrete fix and a derived confidence. Read-only apart from its two report files.
|
|
4
|
-
compatibility: Requires the pds-knowledge-react skill, which ships alongside this one in @porsche-design-system/components-react@4.7.0
|
|
4
|
+
compatibility: Requires the pds-knowledge-react skill, which ships alongside this one in @porsche-design-system/components-react@4.7.0. The audited project must depend on that exact version.
|
|
5
5
|
disable-model-invocation: true
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -135,7 +135,7 @@ Every finding carries:
|
|
|
135
135
|
- `evidence` — every location where the project **uses** the API, each with a project-relative path, a line number and the source line **quoted verbatim**. The quote is not decoration: it is what lets a reader, or a later fix, confirm the finding against the file instead of trusting it.
|
|
136
136
|
- `anchor` on a location — the line that proves that usage is PDS, with its own path, line and quoted source. The import, the resolved SCSS `@use` **including one injected by build config**, the Tailwind `@theme` import, or the PDS root at the far end of a wrapper chain. Record it whenever it is not the evidence line itself; it is frequently in another file, and it is the only truthful place to put `vite.config.ts` for a stylesheet that names PDS nowhere. Omit it only where the usage anchors itself, as a `--p-` custom property does.
|
|
137
137
|
- `remediation` — a `replacement` with the exact `from` and `to` spelling whenever the index documents an unambiguous one, plus an `instruction` in words. Where the index documents no replacement, say so plainly in the instruction rather than inventing one.
|
|
138
|
-
- `sources` — the knowledge-skill reference the fact came from, as a path relative to that skill’s root, at version `4.7.0
|
|
138
|
+
- `sources` — the knowledge-skill reference the fact came from, as a path relative to that skill’s root, at version `4.7.0`.
|
|
139
139
|
- the index entry’s message as `deprecationMessage`, verbatim, when it has one. Some say an API has no effect anymore; that wording matters to whoever reads the finding, so do not paraphrase it.
|
|
140
140
|
|
|
141
141
|
An evidence `line` is the **usage** — the attribute, tag, custom property or alias reference itself. Never the `import`, `@use` or `@theme` that anchored it, never the wrapper call it arrived through, and never the declaration line of a constant it resolved from — including a key inside an object that is applied to the element as a whole, which is such a declaration and not a usage. For such an object, the evidence line is the element it is applied to. Where a component is reached through a local binding, the evidence line is the reference to the PDS binding, not the render of the local alias. Those lines are real and they matter, which is exactly why the anchor has a field of its own: counted as locations instead, they inflate a finding by however many anchors it happens to have, and occurrence count is a sort key in §8 — so two runs of an unchanged project stop being comparable.
|
|
@@ -15,11 +15,11 @@ Prefer Porsche Design System components and tokens for new UI, even when the use
|
|
|
15
15
|
|
|
16
16
|
This skill currently covers components, global stylesheets and theming, tokens, styling integrations, and the deprecated API index. 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.
|
|
17
17
|
|
|
18
|
-
Before using documentation outside this skill or the installed package, match it to the installed PDS version. This skill was generated for `4.7.0
|
|
18
|
+
Before using documentation outside this skill or the installed package, match it to the installed PDS version. This skill was generated for `4.7.0`; prefer the [exact-version Porsche Design System Storefront](https://designsystem.porsche.com/v4.7.0/). 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.
|
|
19
19
|
|
|
20
20
|
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`.
|
|
21
21
|
|
|
22
|
-
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.7.0
|
|
22
|
+
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.7.0/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.
|
|
23
23
|
|
|
24
24
|
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.
|
|
25
25
|
|
|
@@ -110,7 +110,7 @@ import { PButton, PorscheDesignSystemProvider } from '@porsche-design-system/com
|
|
|
110
110
|
|
|
111
111
|
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.
|
|
112
112
|
|
|
113
|
-
Framework setup differs. Follow the [Next.js integration guide](https://designsystem.porsche.com/v4.7.0
|
|
113
|
+
Framework setup differs. Follow the [Next.js integration guide](https://designsystem.porsche.com/v4.7.0/developing/next-js/getting-started/) or the [React Router integration guide](https://designsystem.porsche.com/v4.7.0/developing/react-router/getting-started/). Remix users should follow the React Router guidance because Remix v2 was upstreamed into React Router.
|
|
114
114
|
|
|
115
115
|
## Stylesheets
|
|
116
116
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Deprecated API
|
|
2
2
|
|
|
3
|
-
Every deprecated Porsche Design System API in `4.7.0
|
|
3
|
+
Every deprecated Porsche Design System API in `4.7.0`, indexed by what is deprecated rather than by which component owns it. Use it to check an existing codebase; use the component and styling references to build with the current API.
|
|
4
4
|
|
|
5
5
|
Deprecated APIs still work in this version. Each will be removed in the next major release, so usage is a compatibility risk rather than a present-day defect — except where a message says an API has no effect anymore, which means the behavior is already gone and only the declaration remains.
|
|
6
6
|
|
|
@@ -675,12 +675,12 @@ Derived from the Tailwind theme exposed by `@porsche-design-system/components-re
|
|
|
675
675
|
|
|
676
676
|
## Tokens
|
|
677
677
|
|
|
678
|
-
No deprecations in `4.7.0
|
|
678
|
+
No deprecations in `4.7.0`. Derived from the design-token API exposed by `@porsche-design-system/components-react/tokens`, which was checked and found to carry none — this is a verified result, not an omission.
|
|
679
679
|
|
|
680
680
|
## Icons
|
|
681
681
|
|
|
682
|
-
No deprecations in `4.7.0
|
|
682
|
+
No deprecations in `4.7.0`. Derived from the `p-icon` `name` values exposed by `@porsche-design-system/components-react`, which was checked and found to carry none — this is a verified result, not an omission.
|
|
683
683
|
|
|
684
684
|
## Stylesheets
|
|
685
685
|
|
|
686
|
-
No deprecations in `4.7.0
|
|
686
|
+
No deprecations in `4.7.0`. Derived from the global CSS exposed by `@porsche-design-system/components-react/index.css`, including `@porsche-design-system/components-react/variables.css` and `@porsche-design-system/components-react/color-scheme.css`, which was checked and found to carry none — this is a verified result, not an omission.
|
|
@@ -3867,7 +3867,7 @@ const OPTION_LIST_SAFE_ZONE = 6;
|
|
|
3867
3867
|
|
|
3868
3868
|
const getCDNBaseURL = () => global.PORSCHE_DESIGN_SYSTEM_CDN_URL + "/porsche-design-system";
|
|
3869
3869
|
|
|
3870
|
-
const prefix = `[Porsche Design System v${"4.7.0
|
|
3870
|
+
const prefix = `[Porsche Design System v${"4.7.0"}]` // this part isn't covered by unit tests
|
|
3871
3871
|
;
|
|
3872
3872
|
const consoleError = (...messages) => {
|
|
3873
3873
|
console.error(prefix, ...messages);
|
|
@@ -3530,7 +3530,7 @@ const hasShowPickerSupport = () => (hasDocument &&
|
|
|
3530
3530
|
'showPicker' in HTMLInputElement.prototype &&
|
|
3531
3531
|
CSS.supports('selector(::-webkit-calendar-picker-indicator)'));
|
|
3532
3532
|
|
|
3533
|
-
const prefix = `[Porsche Design System v${"4.7.0
|
|
3533
|
+
const prefix = `[Porsche Design System v${"4.7.0"}]` // this part isn't covered by unit tests
|
|
3534
3534
|
;
|
|
3535
3535
|
const consoleError$1 = (...messages) => {
|
|
3536
3536
|
console.error(prefix, ...messages);
|
|
@@ -3865,7 +3865,7 @@ const OPTION_LIST_SAFE_ZONE = 6;
|
|
|
3865
3865
|
|
|
3866
3866
|
const getCDNBaseURL = () => global.PORSCHE_DESIGN_SYSTEM_CDN_URL + "/porsche-design-system";
|
|
3867
3867
|
|
|
3868
|
-
const prefix = `[Porsche Design System v${"4.7.0
|
|
3868
|
+
const prefix = `[Porsche Design System v${"4.7.0"}]` // this part isn't covered by unit tests
|
|
3869
3869
|
;
|
|
3870
3870
|
const consoleError = (...messages) => {
|
|
3871
3871
|
console.error(prefix, ...messages);
|
|
@@ -3528,7 +3528,7 @@ const hasShowPickerSupport = () => (hasDocument &&
|
|
|
3528
3528
|
'showPicker' in HTMLInputElement.prototype &&
|
|
3529
3529
|
CSS.supports('selector(::-webkit-calendar-picker-indicator)'));
|
|
3530
3530
|
|
|
3531
|
-
const prefix = `[Porsche Design System v${"4.7.0
|
|
3531
|
+
const prefix = `[Porsche Design System v${"4.7.0"}]` // this part isn't covered by unit tests
|
|
3532
3532
|
;
|
|
3533
3533
|
const consoleError$1 = (...messages) => {
|
|
3534
3534
|
console.error(prefix, ...messages);
|