@solid-design-system/mcp 7.0.0-next.8 → 7.0.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 CHANGED
@@ -1,5 +1,26 @@
1
1
  # Changelog
2
2
 
3
+ ## 7.0.0
4
+
5
+ ### Major Changes
6
+
7
+ - Consolidated `sd-chip` and `sd-flag`: _[`#3267`](https://github.com/solid-design-system/solid/pull/3267) [`12db708`](https://github.com/solid-design-system/solid/commit/12db708ea227bc2ce2a7835d12190ee1ae40f891) [@auroraVasconcelos](https://github.com/auroraVasconcelos)_
8
+
9
+ - Removed the `sd-flag` style.
10
+ - Added `sd-chip--color-{primary,neutral,white}`, `sd-chip--shade-{subtle,low,medium,high}`, `sd-chip--size-{sm,lg}`, `sd-chip--outline` and `sd-chip--sharp` classes.
11
+
12
+ ### Patch Changes
13
+
14
+ - Fix versioned icons to work with next versions. _[`#3186`](https://github.com/solid-design-system/solid/pull/3186) [`30af3ad`](https://github.com/solid-design-system/solid/commit/30af3ad6d2e8daebeaa9d6a863fdd5794a015da9) [@auroraVasconcelos](https://github.com/auroraVasconcelos)_
15
+
16
+ ## 7.0.0-next.12
17
+
18
+ ## 7.0.0-next.11
19
+
20
+ ## 7.0.0-next.10
21
+
22
+ ## 7.0.0-next.9
23
+
3
24
  ## 7.0.0-next.8
4
25
 
5
26
  ### Major Changes
@@ -1,8 +1,8 @@
1
1
  # Installation
2
2
 
3
- You can load Solid Components via CDN or by installing it locally.
3
+ Solid Components is installed via npm. For environments without a bundler, see [CDN Hosting](?path=/docs/docs-general-cdn-hosting--docs).
4
4
 
5
- <sd-notification type="info" open id="versioning-info">
5
+ <sd-notification variant="info" open id="versioning-info">
6
6
  The `components`, `styles`, and `tokens` packages now always share the same version. We use fixed versioning to keep
7
7
  them fully in sync, so every release updates all three packages, even if only one of them changed. Make sure to
8
8
  install or update them using the same version number.
@@ -40,98 +40,9 @@ Keep the following in mind for nested components:
40
40
  - _Slotted components_, which are added by your app or website, are not automatically versioned. You need to version them yourself if necessary.
41
41
  - _Nested components_, which are generated by the component itself, are automatically versioned (e.g., `sd-%DASHED-COMPONENTS-VERSION%-button` will generate an `sd-%DASHED-COMPONENTS-VERSION%-spinner` when in the loading state).
42
42
 
43
- ## CDN Installation
43
+ ## Installation
44
44
 
45
- ### Bundle
46
-
47
- The bundle registers all Solid Components in a single file. If you're using many Solid Components, this is the most performant way to load and hydrate them. Still, you should ensure that other applications are not loading components with the same tag names via an additional CDN or npm package. This therefore makes most sense in e. g. a CMS context.
48
- You can use the following script tag to load all components:
49
-
50
- <sd-tab-group>
51
- {/* prettier-ignore */}
52
- <sd-tab slot="nav" panel="unversioned"> Unversioned </sd-tab>
53
- {/* prettier-ignore */}
54
- <sd-tab slot="nav" panel="versioned"> Versioned </sd-tab>
55
- <sd-tab-panel name="unversioned">
56
- ```html
57
- <link
58
- rel="stylesheet"
59
- href="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn/solid-components.css"
60
- />
61
- <link
62
- rel="stylesheet"
63
- href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-light/ui-light.css"
64
- />
65
- <script
66
- type="module"
67
- src="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn/solid-components.bundle.js"
68
- ></script>
69
- ```
70
- </sd-tab-panel>
71
- <sd-tab-panel name="versioned">
72
- ```html
73
- <link
74
- rel="stylesheet"
75
- href="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn-versioned/solid-components.css"
76
- />
77
- <link
78
- rel="stylesheet"
79
- href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-light/ui-light.css"
80
- />
81
- <script
82
- type="module"
83
- src="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn-versioned/solid-components.bundle.js"
84
- ></script>
85
- ```
86
- </sd-tab-panel>
87
- </sd-tab-group>
88
-
89
- ### ESM
90
-
91
- The CDN loader registers all Solid elements up front. Note that, if you're only using a handful of components, it could be more efficient [cherry pick](#cherry-picking) components if you want to load specific ones up front.
92
-
93
- <sd-tab-group>
94
- {/* prettier-ignore */}
95
- <sd-tab slot="nav" panel="unversioned">Unversioned</sd-tab>
96
- {/* prettier-ignore */}
97
- <sd-tab slot="nav" panel="versioned">Versioned</sd-tab>
98
- <sd-tab-panel name="unversioned">
99
- ```html
100
- <link
101
- rel="stylesheet"
102
- href="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn/solid-components.css"
103
- />
104
- <link
105
- rel="stylesheet"
106
- href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-light/ui-light.css"
107
- />
108
- <script
109
- type="module"
110
- src="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn/solid-components.js"
111
- ></script>
112
- ```
113
- </sd-tab-panel>
114
- <sd-tab-panel name="versioned">
115
- ```html
116
- <link
117
- rel="stylesheet"
118
- href="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn-versioned/solid-components.css"
119
- />
120
- <link
121
- rel="stylesheet"
122
- href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-light/ui-light.css"
123
- />
124
- <script
125
- type="module"
126
- src="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn-versioned/solid-components.js"
127
- ></script>
128
- ```
129
- </sd-tab-panel>
130
- </sd-tab-group>
131
-
132
- ## npm installation
133
-
134
- If you don't want to use the CDN, you can install Solid Components from npm with the following command.
45
+ Install Solid Components from npm:
135
46
 
136
47
  ```bash
137
48
  npm install @solid-design-system/components @solid-design-system/tokens
@@ -166,7 +77,7 @@ Alternatively, [you can use a bundler](#bundling).
166
77
 
167
78
  ## Cherry Picking
168
79
 
169
- Cherry picking can be done from [the CDN](#cdn-installation) or from [npm](#npm-installation). This approach will load only the components you need up front, while limiting the number of files the browser has to download. The disadvantage is that you need to import each individual component.
80
+ Cherry picking loads only the components you need up front, limiting the number of files the browser has to download. The disadvantage is that you need to import each individual component.
170
81
 
171
82
  Here's an example that loads only the button component. Again, if you're not using a module resolver, you'll need to adjust the path to point to the folder Solid is in.
172
83
 
@@ -209,7 +120,7 @@ You can copy and paste the code to import a component from the "Importing" secti
209
120
 
210
121
  ## Bundling
211
122
 
212
- Solid Components are distributed as a collection of standard ES modules that [all modern browsers can understand](https://caniuse.com/es6-module). However, importing a lot of modules can result in a lot of HTTP requests and potentially longer load times. Using a CDN can alleviate this, but some users may wish to further optimize their imports with a bundler.
123
+ Solid Components are distributed as a collection of standard ES modules that [all modern browsers can understand](https://caniuse.com/es6-module). However, importing a lot of modules can result in a lot of HTTP requests and potentially longer load times. You can optimize your imports with a bundler.
213
124
 
214
125
  To use Solid with a bundler, first install Solid along with your bundler of choice.
215
126
 
@@ -245,27 +156,8 @@ Once your bundler is configured, you'll be able to import Solid components and u
245
156
 
246
157
  > Component modules include side effects for registration purposes. Because of this, importing directly from `@solid-design-system/components` may result in a larger bundle size than necessary. For optimal tree shaking, always cherry pick, i.e. import components and utilities from their respective files, as shown above.
247
158
 
248
- ## The difference between CDN and npm
159
+ ## cdn/ vs dist/
249
160
 
250
- CDN links all start with `/cdn/<path>` and npm imports use `/dist/<path>`. The `/cdn` files are bundled separately from the `/dist` files. The `/cdn` files come pre-bundled, which means all dependencies are inlined so you do not need to worry about loading additional libraries. The `/dist` files **DO NOT** come pre-bundled, allowing your bundler of choice to more efficiently deduplicate dependencies, resulting in smaller bundles and optimal code sharing.
161
+ The package ships both `cdn/` and `dist/` artifacts. The `/cdn` files are pre-bundled with all dependencies inlined. The `/dist` files are not pre-bundled, allowing your bundler to deduplicate shared dependencies for a smaller total bundle.
251
162
 
252
- TL;DR:
253
-
254
- <sd-tab-group>
255
- {/* prettier-ignore */}
256
- <sd-tab slot="nav" panel="unversioned">Unversioned</sd-tab>
257
- {/* prettier-ignore */}
258
- <sd-tab slot="nav" panel="versioned">Versioned</sd-tab>
259
- <sd-tab-panel name="unversioned">
260
-
261
- - `@solid-design-system/components/cdn` is for CDN users
262
- - `@solid-design-system/components/dist` is for npm users
263
-
264
- </sd-tab-panel>
265
- <sd-tab-panel name="versioned">
266
-
267
- - `@solid-design-system/components/cdn-versioned` is for CDN users
268
- - `@solid-design-system/components/dist-versioned` is for npm users
269
-
270
- </sd-tab-panel>
271
- </sd-tab-group>
163
+ Use `/dist` with a bundler (recommended). Use `/cdn` only when hosting on your own CDN without build tooling — see [CDN Hosting](?path=/docs/general-cdn-hosting--docs).
@@ -8,7 +8,9 @@ Use the `headline` attribute to set the headline of the dialog. If you need to u
8
8
  Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et
9
9
  dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam.
10
10
  </p>
11
- <sd-button slot="footer">Button</sd-button>
11
+ <div slot="footer" class="flex sm:justify-end gap-4">
12
+ <sd-button>Button</sd-button>
13
+ </div>
12
14
  </sd-dialog>
13
15
  </div>
14
16
  <script type="module">
@@ -9,7 +9,9 @@ Use the `no-close-button` attribute to hide the close button in the dialog.
9
9
  Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et
10
10
  dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam.
11
11
  </p>
12
- <sd-button class="close-button" slot="footer" variant="primary">Button</sd-button>
12
+ <div slot="footer" class="flex sm:justify-end gap-4">
13
+ <sd-button class="close-button" variant="primary">Button</sd-button>
14
+ </div>
13
15
  </sd-dialog>
14
16
  </div>
15
17
 
@@ -61,7 +61,9 @@ Use the `open` attribute to show the dialog.
61
61
  Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et
62
62
  dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam.
63
63
  </p>
64
- <sd-button slot="footer">Button</sd-button>
64
+ <div slot="footer" class="flex sm:justify-end gap-4">
65
+ <sd-button>Button</sd-button>
66
+ </div>
65
67
  </sd-dialog>
66
68
  </div>
67
69
  <script type="module">
@@ -16,7 +16,7 @@ Here's an example that registers an icon library located in the `/assets/icons`
16
16
  If you use the IIFE bundle, you have to access the `registerIconLibrary()` function from the `SolidComponents` global.
17
17
 
18
18
  ```html
19
- <script src="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn/solid-components.iife.js"></script>
19
+ <script src="https://your-cdn.example.com/components/%COMPONENTS-VERSION%/cdn/solid-components.iife.js"></script>
20
20
  <script>
21
21
  const { registerIconLibrary } = window['SolidComponents'];
22
22
  registerIconLibrary('my-icons', {
@@ -19,8 +19,8 @@ Solid ships with three public icon libraries, `default`, `sd-status-assets`, and
19
19
  <h3 class="sd-headline sd-headline--size-base mb-4">Status Library</h3>
20
20
  <div class="flex gap-6">
21
21
  <sd-icon color="primary" library="sd-status-assets" name="status-check"></sd-icon>
22
- <sd-icon color="primary" library="sd-status-assets" name="status-exclamation"></sd-icon>
23
22
  <sd-icon color="primary" library="sd-status-assets" name="status-close"></sd-icon>
23
+ <sd-icon color="primary" library="sd-status-assets" name="status-exclamation"></sd-icon>
24
24
  </div>
25
25
  </div>
26
26
 
@@ -4,7 +4,7 @@ Use dividers to group menu-items in a menu.
4
4
  <sd-dropdown distance="4" rounded>
5
5
  <sd-button variant="secondary" slot="trigger">
6
6
  Menu
7
- <sd-icon library="_internal" name="chevron-down" slot="icon-right"></sd-icon>
7
+ <sd-icon library="_internal" name="chevron-bottom" slot="icon-right"></sd-icon>
8
8
  </sd-button>
9
9
  <sd-menu>
10
10
  <sd-menu-item>Menu item 1</sd-menu-item>
@@ -44,7 +44,7 @@ return html` <div class="h-[350px]">
44
44
  <sd-dropdown distance="4" rounded open>
45
45
  <sd-button variant="secondary" slot="trigger">
46
46
  Menu
47
- <sd-icon library="_internal" name="chevron-down" slot="icon-right"></sd-icon>
47
+ <sd-icon library="_internal" name="chevron-bottom" slot="icon-right"></sd-icon>
48
48
  </sd-button>
49
49
  ${generateTemplate({
50
50
  args
@@ -6,33 +6,15 @@ To develop with Solid Design System, you need the following three packages:
6
6
  - `@solid-design-system/styles`: Smaller components built with CSS.
7
7
  - `@solid-design-system/tokens`: Tokens and themes for consistent design.
8
8
 
9
- <sd-tab-group>
10
- {/* prettier-ignore */}
11
- <sd-tab slot="nav" panel="npm" variant="container"> NPM </sd-tab>
12
- {/* prettier-ignore */}
13
- <sd-tab slot="nav" panel="cdn" variant="container"> CDN </sd-tab>
14
- <sd-tab-panel name="npm">
15
- ```bash
16
- pnpm i @solid-design-system/components @solid-design-system/styles @solid-design-system/tokens
17
- ```
18
-
19
- ```js
20
- import '@solid-design-system/tokens/dist/themes/ui-light/ui-light.css';
21
- import '@solid-design-system/styles/dist/solid-styles.css';
22
- import '@solid-design-system/components/dist/solid-components.css';
23
- import '@solid-design-system/components/dist/solid-components.js';
24
- ```
25
-
26
- </sd-tab-panel>
27
- <sd-tab-panel name="cdn">
28
- ```html
29
- <link rel="stylesheet" href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-light/ui-light.css" />
30
- <link rel="stylesheet" href="https://solid-design-system.fe.union-investment.de/styles/%STYLES-VERSION%/cdn/solid-styles.css" />
31
- <link rel="stylesheet" href="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn/solid-components.css" />
32
- <script type="module" src="https://solid-design-system.fe.union-investment.de/components/%COMPONENTS-VERSION%/cdn/solid-components.js"></script>
33
- ```
34
- </sd-tab-panel>
35
- </sd-tab-group>
9
+ ```bash
10
+ pnpm i @solid-design-system/components @solid-design-system/styles @solid-design-system/tokens
11
+ ```
12
+
13
+ ```js
14
+
15
+ ```
16
+
17
+ For environments without a bundler (e.g. a CMS), see [CDN Hosting](?path=/docs/docs-general-cdn-hosting--docs).
36
18
 
37
19
  Now you are ready to use Solid Design System in your project!
38
20
 
@@ -1,8 +1,8 @@
1
1
  # Installation
2
2
 
3
- You can load Solid via CDN or by installing it locally.
3
+ Solid Styles is installed via npm. For environments without a bundler, see [CDN Hosting](?path=/docs/docs-general-cdn-hosting--docs).
4
4
 
5
- <sd-notification type="info" open id="versioning-info">
5
+ <sd-notification variant="info" open id="versioning-info">
6
6
  The `components`, `styles`, and `tokens` packages now always share the same version. We use fixed versioning to keep
7
7
  them fully in sync, so every release updates all three packages, even if only one of them changed. Make sure to
8
8
  install or update them using the same version number.
@@ -37,38 +37,9 @@ Including version numbers in component names provides more control over updates
37
37
  </sd-tab-panel>
38
38
  </sd-tab-group>
39
39
 
40
- ## CDN Installation
40
+ ## Installation
41
41
 
42
- ### Bundle
43
-
44
- The CDN Bundle registers all Solid elements up front. Note that, if you're only using a handful of components, it could be more efficient [cherry pick](#cherry-picking) components if you want to load specific ones up front.
45
-
46
- <sd-tab-group>
47
- {/* prettier-ignore */}
48
- <sd-tab slot="nav" panel="unversioned">Unversioned</sd-tab>
49
- {/* prettier-ignore */}
50
- <sd-tab slot="nav" panel="versioned">Versioned</sd-tab>
51
- <sd-tab-panel name="unversioned">
52
- ```html
53
- <link
54
- rel="stylesheet"
55
- href="https://solid-design-system.fe.union-investment.de/styles/%STYLES-VERSION%/cdn/solid-styles.css"
56
- />
57
- ```
58
- </sd-tab-panel>
59
- <sd-tab-panel name="versioned">
60
- ```html
61
- <link
62
- rel="stylesheet"
63
- href="https://solid-design-system.fe.union-investment.de/styles/%STYLES-VERSION%/cdn-versioned/solid-styles.css"
64
- />
65
- ```
66
- </sd-tab-panel>
67
- </sd-tab-group>
68
-
69
- ## npm installation
70
-
71
- If you don't want to use the CDN, you can install Solid Styles from npm with the following command.
42
+ Install Solid Styles from npm:
72
43
 
73
44
  ```bash
74
45
  npm install @solid-design-system/styles
@@ -99,7 +70,7 @@ Alternatively, you can use a bundler.
99
70
 
100
71
  ## Cherry Picking
101
72
 
102
- Cherry picking can be done from [the CDN](#cdn-installation) or from [npm](#npm-installation). This approach will load only the styles you need up front, while limiting the number of files the browser has to download. The disadvantage is that you need to import each individual style.
73
+ Cherry picking loads only the styles you need up front, limiting the number of files the browser has to download. The disadvantage is that you need to import each individual style.
103
74
 
104
75
  Here's an example that loads only the mark style that would work in Vite.
105
76
 
@@ -135,27 +106,8 @@ Here's an example that loads only the mark style that would work in Vite.
135
106
 
136
107
  tbd.
137
108
 
138
- ## The difference between CDN and npm
139
-
140
- CDN links all start with `/cdn/<path>` and npm imports use `/dist/<path>`. The `/cdn` files are already minified, while `npm` can be easily patched.
141
-
142
- TL;DR:
143
-
144
- <sd-tab-group>
145
- {/* prettier-ignore */}
146
- <sd-tab slot="nav" panel="unversioned">Unversioned</sd-tab>
147
- {/* prettier-ignore */}
148
- <sd-tab slot="nav" panel="versioned">Versioned</sd-tab>
149
- <sd-tab-panel name="unversioned">
150
-
151
- - `@solid-design-system/styles/cdn` is for CDN users
152
- - `@solid-design-system/styles/dist` is for npm users
153
-
154
- </sd-tab-panel>
155
- <sd-tab-panel name="versioned">
109
+ ## cdn/ vs dist/
156
110
 
157
- - `@solid-design-system/styles/cdn-versioned` is for CDN users
158
- - `@solid-design-system/styles/dist-versioned` is for npm users
111
+ The package ships both `cdn/` and `dist/` artifacts. The `/cdn` files are already minified. The `/dist` files can be more easily patched and are better suited for bundlers.
159
112
 
160
- </sd-tab-panel>
161
- </sd-tab-group>
113
+ Use `/dist` with a bundler (recommended). Use `/cdn` only when hosting on your own CDN without build tooling — see [CDN Hosting](?path=/docs/general-cdn-hosting--docs).
@@ -3,33 +3,90 @@ name: chip
3
3
  title: Chip
4
4
  components:
5
5
  - sd-chip
6
- - sd-chip--primary-200
7
- - sd-chip--primary-300
8
- - sd-chip--primary-500
9
- - sd-chip--white
6
+ - sd-chip--color-neutral
7
+ - sd-chip--color-white
8
+ - sd-chip--outline
9
+ - sd-chip--shade-high
10
+ - sd-chip--shade-low
11
+ - sd-chip--shade-medium
12
+ - sd-chip--sharp
13
+ - sd-chip--size-lg
10
14
  version: 1.0.0
11
15
  ---
12
16
 
13
17
  ## Template: Background Options
14
18
 
15
19
  ```html
16
- <div class="grid grid-cols-2 grid-rows-2">
17
- <div class="bg-white p-4 border border-neutral-200">
18
- <span class="sd-chip sd-chip--primary-200">primary-200</span>
20
+ <div class="grid grid-col-1 sm:grid-cols-3 gap-px bg-neutral-400 border border-neutral-400">
21
+ <div class="bg-white py-6 px-8 flex flex-col gap-2 items-start min-h-32">
22
+ <span class="sd-chip">primary-subtle</span>
23
+ <span class="sd-chip sd-chip--color-neutral">neutral-subtle</span>
19
24
  </div>
20
- <div class="bg-primary-100 p-4">
21
- <span class=" sd-chip sd-chip--primary-300">primary-300</span>
25
+ <div class="bg-primary-100 py-6 px-8 min-h-32">
26
+ <span class="sd-chip sd-chip--shade-low">primary-low</span>
22
27
  </div>
23
- <div class="bg-primary p-4">
24
- <span class="sd-chip sd-chip--primary-500">primary-500</span>
28
+ <div class="bg-neutral-100 py-6 px-8 min-h-32">
29
+ <span class="sd-chip sd-chip--color-neutral sd-chip--shade-low">neutral-low</span>
25
30
  </div>
26
- <div slot="media" class="relative">
31
+ <div class="bg-primary py-6 px-8 min-h-32">
32
+ <span class="sd-chip sd-chip--shade-high">primary-high</span>
33
+ </div>
34
+ <div class="relative col-span-1 sm:col-span-2 py-6 px-8 min-h-32">
27
35
  <img
28
- class="aspect-video object-cover"
36
+ class="absolute inset-0 w-full h-full object-cover"
29
37
  src="./placeholders/images/coffeeshop.jpg"
30
- alt="A group of people sitting in a coffee shop"
38
+ alt="Four young people sit around a café table laughing, while one of them looks at a tablet."
31
39
  />
32
- <span class="absolute top-3 left-4 sd-chip sd-chip--white">white</span>
40
+ <div class="relative">
41
+ <span class="sd-chip sd-chip--color-white">white</span>
42
+ </div>
43
+ </div>
44
+ </div>
45
+
46
+ <div class="grid grid-col-1 sm:grid-cols-3 gap-px bg-neutral-400 border border-neutral-400 mt-8">
47
+ <div class="bg-white py-6 flex flex-col gap-4 items-end min-h-32">
48
+ <span class="sd-chip sd-chip--shade-low sd-chip--size-lg sd-chip--sharp">primary-low</span>
49
+ <span class="sd-chip sd-chip--color-neutral sd-chip--shade-low sd-chip--size-lg sd-chip--sharp"> neutral-low </span>
50
+ </div>
51
+ <div class="bg-primary-100 py-6 min-h-32 relative">
52
+ <span class="sd-chip sd-chip--shade-medium sd-chip--size-lg sd-chip--sharp absolute right-0">primary-medium</span>
53
+ </div>
54
+ <div class="bg-neutral-100 py-6 min-h-32 relative">
55
+ <span class="sd-chip sd-chip--color-neutral sd-chip--shade-medium sd-chip--size-lg sd-chip--sharp absolute right-0"
56
+ >neutral-medium</span
57
+ >
58
+ </div>
59
+ <div class="bg-primary min-h-32 py-6 relative">
60
+ <span class="sd-chip sd-chip--shade-high sd-chip--size-lg sd-chip--sharp absolute right-0">primary-high</span>
61
+ </div>
62
+ <div class="relative col-span-1 sm:col-span-2 py-6 min-h-32">
63
+ <img
64
+ class="absolute inset-0 w-full h-full object-cover"
65
+ src="./placeholders/images/coffeeshop.jpg"
66
+ alt="Four young people sit around a café table laughing, while one of them looks at a tablet."
67
+ />
68
+ <div class="relative">
69
+ <span class="sd-chip sd-chip--color-neutral sd-chip--size-lg sd-chip--sharp absolute right-0"
70
+ >neutral-subtle</span
71
+ >
72
+ </div>
73
+ </div>
74
+ </div>
75
+ ```
76
+
77
+ ## Template: Background Options Outlined
78
+
79
+ ```html
80
+ <div class="grid grid-col-1 sm:grid-cols-3 gap-px bg-neutral-400 border border-neutral-400 mt-4">
81
+ <div class="bg-white py-6 px-8 flex flex-col gap-2 items-start min-h-32">
82
+ <span class="sd-chip sd-chip--shade-medium sd-chip--outline">primary-medium</span>
83
+ <span class="sd-chip sd-chip--color-neutral sd-chip--shade-medium sd-chip--outline">neutral-medium</span>
84
+ </div>
85
+ <div class="bg-primary-100 py-6 px-8 min-h-32">
86
+ <span class="sd-chip sd-chip--shade-medium sd-chip--outline">primary-medium</span>
87
+ </div>
88
+ <div class="bg-neutral-100 py-6 px-8 min-h-32">
89
+ <span class="sd-chip sd-chip--color-neutral sd-chip--shade-medium sd-chip--outline">neutral-medium</span>
33
90
  </div>
34
91
  </div>
35
92
  ```
@@ -18,16 +18,6 @@ version: 1.0.0
18
18
  ## Template: Dialog with Button Group
19
19
 
20
20
  ```html
21
- <!-- TODO: remove once this bugfix is addressed: https://github.com/solid-design-system/solid/issues/1325 -->
22
- <style>
23
- @media (min-width: 414px) {
24
- sd-dialog::part(footer) {
25
- width: 100%;
26
- margin: 0;
27
- }
28
- }
29
- </style>
30
-
31
21
  <sd-button id="drawer-trigger">Open Dialog</sd-button>
32
22
  <sd-dialog id="dialog" open>
33
23
  <span slot="headline" class="sd-headline sd-headline--size-3xl">Cancel your subscription?</span>
@@ -64,7 +64,7 @@ version: 1.0.0
64
64
  <sd-dropdown distance="4" rounded stay-open-on-select>
65
65
  <sd-button variant="secondary" slot="trigger">
66
66
  Menu
67
- <sd-icon library="_internal" name="chevron-down" slot="icon-right"></sd-icon>
67
+ <sd-icon library="_internal" name="chevron-bottom" slot="icon-right"></sd-icon>
68
68
  </sd-button>
69
69
  <sd-menu>
70
70
  <sd-menu-item type="checkbox">Account overview</sd-menu-item>
@@ -2,7 +2,7 @@
2
2
 
3
3
  This page guides you through installing and setting up the `@solid-design-system/tokens` package to use themes and/or design tokens in your project.
4
4
 
5
- <sd-notification type="info" open>
5
+ <sd-notification variant="info" open>
6
6
  The `components`, `styles`, and `tokens` packages always share the same version. We use fixed versioning to keep them
7
7
  fully in sync, so every release updates all three packages, even if only one of them changed. Make sure to install or
8
8
  update them using the same version number.
@@ -23,29 +23,12 @@ npm install @solid-design-system/tokens
23
23
 
24
24
  ## Import a theme
25
25
 
26
- Load at least one theme — either via NPM import or a CDN `<link>` tag. This only needs to be done **once per document**. Every component and embedded consumer on the page will automatically inherit the theme.
26
+ Load at least one theme via NPM import. This only needs to be done **once per document**. Every component and embedded consumer on the page will automatically inherit the theme.
27
27
 
28
- <sd-tab-group>
29
- {/* prettier-ignore */}
30
- <sd-tab slot="nav" panel="npm" variant="container">NPM</sd-tab>
31
- {/* prettier-ignore */}
32
- <sd-tab slot="nav" panel="cdn" variant="container">CDN</sd-tab>
33
- <sd-tab-panel name="npm">
34
28
  ```js
35
- ```
36
29
 
37
- </sd-tab-panel>
38
- <sd-tab-panel name="cdn">
39
- ```html
40
- <link
41
- rel="stylesheet"
42
- href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-light/ui-light.css"
43
- />
44
30
  ```
45
31
 
46
- </sd-tab-panel>
47
- </sd-tab-group>
48
-
49
32
  ## Next steps
50
33
 
51
34
  Depending on the theme, make sure the following page-level concerns are covered.
@@ -304,9 +287,9 @@ That's it — your page is now themed. Head over to the <sd-link href="?path=/do
304
287
 
305
288
  </sd-accordion>
306
289
 
307
- </sd-tab-panel>
290
+ </sd-tab-panel>
308
291
 
309
- <sd-tab-panel name="consumer">
292
+ <sd-tab-panel name="consumer">
310
293
 
311
294
  <sd-notification variant="warning" open>
312
295
  **Do not import or bundle theme CSS.** The Theme Host already provides the theme for the entire page. Bundling it
@@ -386,7 +369,7 @@ extend: {
386
369
  }
387
370
  };
388
371
 
389
- ```
372
+ ````
390
373
 
391
374
  </sd-tab-panel>
392
375
  </sd-tab-group>
@@ -396,46 +379,20 @@ That's it — you're ready to build. Head over to the <sd-link href="?path=/docs
396
379
  </sd-tab-panel>
397
380
  </sd-tab-group>
398
381
 
399
- ## ⚠️ Upcoming breaking changes
400
-
401
- Breaking changes will be introduced in a future release (date to be announced).
402
-
403
- ### CSS Variables
404
-
405
- Some CSS variables used for custom theming will be removed.
406
-
407
- - Deprecated variables are still functional for now
408
- - All deprecated variables are clearly marked in the documentation
409
- - Recommended replacements are already provided
382
+ ## CSS Variables deprecation
410
383
 
411
- **Where to find deprecated variables**: You can find this information directly on each component’s documentation page.
384
+ CSS variables used for custom theming can become deprecated as token versions are updated.
385
+ These changes will always be communicated properly before breaking changes are applied and are currently listed in the
386
+ <sd-link href="https://solid-design-system.fe.union-investment.de/docs/?path=/docs/packages-tokens-installation--docs#css-variables-deprecation">Usage</sd-link> page under "Deprecated CSS variables (tokens)"
412
387
 
413
- Deprecated variables:
388
+ However, if you manage an environment that still requires the use of these variables, you can import the `legacy-variables.css` stylesheet
389
+ as fallback layer:
414
390
 
415
- - `--sd-button--size-lg-border-radius` replace with `--sd-button-border-radius`
416
- - `--sd-button--size-md-border-radius` replace with `--sd-button-border-radius`
417
- - `--sd-button--size-sm-border-radius` replace with `--sd-button-border-radius`
418
- - `--sd-button--secondary--inverted--color-border` replace with `--sd-button-secondary-inverted-color-border`
419
- - `--sd-form-control-color-icon` replace with `--sd-form-control-color-icon-fill`
420
- - `--sd-menu-color-icon` replace with `--sd-menu-item-color-icon-fill`
421
- - `--sd-menu-color-text` replace with `--sd-menu-item-color-text`
422
- - `--sd-menu--disabled-color-icon` replace with `--sd-menu-item--disabled-color-icon-fill`
423
- - `--sd-menu--disabled-color-text` replace with `--sd-menu-item--disabled-color-text`
424
- - `--sd-tag-font-weight` replace with `--sd-choice-control-font-weight`
425
- - `--sd-tag--disabled-color-border` replace with `--sd-color-border-neutral-500`
426
- - `--sd-navigation-item--current-color-text` replace with `--sd-navigation-item-color-text`
427
- - `--sd-option--disabled-color-border` replace with `--sd-color-border-neutral-500`
428
- - `--sd-audio__timestamp-color-text` replace with `--sd-color-text-neutral-700`
429
- - `--sd-accordion__chevron-color-text` replace with `--sd-accordion-color-icon-fill`
430
-
431
- ---
432
-
433
- ### Minimum dependency requirement
391
+ ```js
392
+ ````
434
393
 
435
- Currently, any version of the **components** and **styles** packages is compatible with any version of the **tokens** package. In a future release:
394
+ ## Minimum dependency requirement
436
395
 
437
- - A **minimum dependency requirement** will be introduced
438
- - The **tokens package version must be equal to or higher than** the components and styles versions
396
+ The installed `@solid-design-system/tokens` version must always be equal to or greater than the versions of the `@solid-design-system/components` and `@solid-design-system/styles` packages.
439
397
 
440
- We recommend reviewing your setup now to ensure that your tokens package is **aligned with (or ahead of)** your components and styles. This will help you avoid compatibility issues once the new requirement is enforced.
441
- ```
398
+ For example, when using version `6.30.0` of components or styles, the minimum supported tokens version is `6.30.0`.
@@ -16,17 +16,9 @@ This page covers advanced usage patterns for `@solid-design-system/tokens`. Make
16
16
 
17
17
  To automatically respect the user's OS-level preference, use the `prefers-color-scheme` media query on your `<link>` tags:
18
18
 
19
- ```html
20
- <link
21
- rel="stylesheet"
22
- href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-light/ui-light.css"
23
- media="(prefers-color-scheme: light)"
24
- />
25
- <link
26
- rel="stylesheet"
27
- href="https://solid-design-system.fe.union-investment.de/tokens/%TOKENS-VERSION%/cdn/themes/ui-dark/ui-dark.css"
28
- media="(prefers-color-scheme: dark)"
29
- />
19
+ ```css
20
+ @import '@solid-design-system/tokens/dist/themes/ui-light/ui-light.css' (prefers-color-scheme: light);
21
+ @import '@solid-design-system/tokens/dist/themes/ui-dark/ui-dark.css' (prefers-color-scheme: dark);
30
22
  ```
31
23
 
32
24
  For further information on how to make this more dynamic, check out [this article](https://pepelsbey.dev/articles/native-light-dark/).
@@ -107,15 +99,19 @@ This will only affect the primary background color inside `sd-button` components
107
99
  <sd-notification variant="warning" open>
108
100
  Make sure the **theme you load** (from `@solid-design-system/tokens`) is at a version **equal to or higher than** the
109
101
  highest `@solid-design-system/components` and `@solid-design-system/styles` version used anywhere on the page —
110
- including by any embedded consumers. This will become a hard requirement in a future release — aligning now avoids
111
- breakage later.
102
+ including by any embedded consumers.
112
103
  </sd-notification>
113
104
 
114
105
  ### Deprecated CSS variables (tokens)
115
106
 
116
- The following CSS variables (tokens) are deprecated and will be removed in a future release. Update your custom styles to use the recommended replacements.
107
+ The following CSS variables (tokens) are deprecated. Please update your custom styles to use the recommended replacements.
108
+ If you manage an environment that still requires the use of these variables,
109
+ please refer to the <sd-link href="https://solid-design-system.fe.union-investment.de/docs/?path=/docs/packages-tokens-installation--docs#css-variables-deprecation">Installation</sd-link>
110
+ section on loading `legacy-variables.css`.
111
+
112
+ #### Deprecated variables:
117
113
 
118
- <table>
114
+ <table class="sd-table">
119
115
  <tr>
120
116
  <th>Deprecated variable</th>
121
117
  <th>Replacement</th>
@@ -180,13 +176,91 @@ The following CSS variables (tokens) are deprecated and will be removed in a fut
180
176
  <td>`--sd-accordion__chevron-color-text`</td>
181
177
  <td>`--sd-accordion-color-icon-fill`</td>
182
178
  </tr>
179
+ <tr>
180
+ <td>`--sd-chip--primary-200-color-background`</td>
181
+ <td>`--sd-chip--primary-low-color-background`</td>
182
+ </tr>
183
+ <tr>
184
+ <td>`--sd-chip--primary-200-color-border`</td>
185
+ <td>`--sd-chip--primary-subtle-color-filled-border`</td>
186
+ </tr>
187
+ <tr>
188
+ <td>`--sd-chip--primary-300-color-background`</td>
189
+ <td>`--sd-chip--primary-medium-color-background`</td>
190
+ </tr>
191
+ <tr>
192
+ <td>`--sd-chip--primary-300-color-border`</td>
193
+ <td>`--sd-chip--primary-medium-color-filled-border`</td>
194
+ </tr>
195
+ <tr>
196
+ <td>`--sd-chip--primary-500-color-background`</td>
197
+ <td>`--sd-chip--primary-high-color-background`</td>
198
+ </tr>
199
+ <tr>
200
+ <td>`--sd-chip--primary-500-color-border`</td>
201
+ <td>`--sd-chip--primary-high-color-filled-border`</td>
202
+ </tr>
203
+ <tr>
204
+ <td>`--sd-chip--primary-500-color-text`</td>
205
+ <td>`text-black`</td>
206
+ </tr>
207
+ <tr>
208
+ <td>`--sd-chip--white-color-border`</td>
209
+ <td>`--sd-chip--white-color-filled-border`</td>
210
+ </tr>
211
+ <tr>
212
+ <td>`--sd-chip-font-size`</td>
213
+ <td>`--sd-marker-font-size`</td>
214
+ </tr>
215
+ <tr>
216
+ <td>`--sd-chip-font-weight`</td>
217
+ <td>`--sd-marker-font-weight`</td>
218
+ </tr>
219
+ <tr>
220
+ <td>`--sd-flag-border-radius`</td>
221
+ <td>`--sd-chip-border-radius`</td>
222
+ </tr>
223
+ <tr>
224
+ <td>`--sd-flag-border-width`</td>
225
+ <td>`--sd-chip-border-width`</td>
226
+ </tr>
227
+ <tr>
228
+ <td>`--sd-flag--neutral-200-color-background`</td>
229
+ <td>`--sd-chip--neutral-low-color-background`</td>
230
+ </tr>
231
+ <tr>
232
+ <td>`--sd-flag--neutral-200-color-border`</td>
233
+ <td>`--sd-chip--neutral-low-color-filled-border`</td>
234
+ </tr>
235
+ <tr>
236
+ <td>`--sd-flag--neutral-300-color-background`</td>
237
+ <td>`--sd-chip--neutral-medium-color-background`</td>
238
+ </tr>
239
+ <tr>
240
+ <td>`--sd-flag--neutral-300-color-border`</td>
241
+ <td>`--sd-chip--neutral-medium-color-filled-border`</td>
242
+ </tr>
243
+ <tr>
244
+ <td>`--sd-flag--neutral-500-color-background`</td>
245
+ <td>`--sd-chip--neutral-high-color-background`</td>
246
+ </tr>
247
+ <tr>
248
+ <td>`--sd-flag--neutral-500-color-border`</td>
249
+ <td>`--sd-chip--neutral-high-color-filled-border`</td>
250
+ </tr>
251
+ <tr>
252
+ <td>`--sd-flag--white-color-background`</td>
253
+ <td>`--sd-chip--white-color-background`</td>
254
+ </tr>
255
+ <tr>
256
+ <td>`--sd-flag--white-color-border`</td>
257
+ <td>`--sd-chip--white-color-filled-border`</td>
258
+ </tr>
183
259
  </table>
184
260
 
185
- You can also find deprecated variables directly on each component's documentation page.
186
-
187
- </sd-tab-panel>
261
+ </sd-tab-panel>
188
262
 
189
- <sd-tab-panel name="consumer">
263
+ <sd-tab-panel name="consumer">
190
264
 
191
265
  ## Using tokens
192
266
 
package/package.json CHANGED
@@ -20,9 +20,9 @@
20
20
  "prettier": "^3.9.5",
21
21
  "tsx": "^4.23.1",
22
22
  "typescript": "^5.9.3",
23
- "@solid-design-system/components": "7.0.0-next.8",
24
- "@solid-design-system/styles": "7.0.0-next.8",
25
- "@solid-design-system/tokens": "7.0.0-next.8"
23
+ "@solid-design-system/components": "7.0.0",
24
+ "@solid-design-system/styles": "7.0.0",
25
+ "@solid-design-system/tokens": "7.0.0"
26
26
  },
27
27
  "exports": {
28
28
  ".": {
@@ -59,7 +59,7 @@
59
59
  "directory": "packages/mcp"
60
60
  },
61
61
  "type": "module",
62
- "version": "7.0.0-next.8",
62
+ "version": "7.0.0",
63
63
  "scripts": {
64
64
  "build": "pnpm run build:components && pnpm run build:tokens && pnpm run build:ts && pnpm run build:metadata && cd ../.. && pnpm exec prettier --write --log-level warn packages/mcp/metadata",
65
65
  "build:components": "cd ../components && pnpm exec node scripts/make-metadata.js --outdir dist",