@norges-domstoler/dds-design-tokens 5.0.0 → 5.1.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/README.md CHANGED
@@ -2,26 +2,32 @@
2
2
 
3
3
  [![Version](https://img.shields.io/npm/v/@norges-domstoler/dds-design-tokens)](https://www.npmjs.com/package/@norges-domstoler/dds-design-tokens)
4
4
 
5
- Biblioteket inneholder design tokens brukt i [Domstolenes designsystem Elsa](https://design.domstol.no/): farger, typografi, avstander skygger og størrelser. Design tokens kan brukes i domstolenes tjenester i bl.a. global styling og custom elementer. Ellers er det obligatorisk å bruke komponentbiblioteket [dds-components](https://www.npmjs.com/package/@norges-domstoler/dds-components).
5
+ Biblioteket inneholder design tokens brukt i [Domstolenes designsystem Elsa](https://design.domstol.no/): farger, typografi, avstander, grid, brekkpunker og skygger. Design tokens kan brukes i domstolenes tjenester i bl.a. global styling og custom elementer. Ellers er det obligatorisk å bruke komponentbiblioteket [dds-components](https://www.npmjs.com/package/@norges-domstoler/dds-components).
6
+
7
+ Les mer om [design tokens i dokumentasjonen](https://design.domstol.no/987b33f71/p/50f2cd-design-tokens).
6
8
 
7
9
  ## 🔍 Oversikt
8
10
 
9
- Design tokens består av base-tokens og referanse-tokens. Base-tokens er variabler genererte fra Figma styles og tilsvarer identiteten til domstolene definert i designprofilen.
11
+ Design tokens består av base-tokens og semantiske tokens. Base-tokens er variabler genererte fra Figma styles og tilsvarer identiteten til domstolene definert i designprofilen.
12
+
13
+ Tanken med semantiske tokens er å innbake i navnet hva token brukes til og kunne benytte seg av themes. Semantiske tokens bruker base-tokens til å definere logikk for hvordan base-tokens skal brukes videre i komponenter og andre elementer. F.eks., semantiske tokens kan spesifisere hva fokusfargen skal være, eller font og farger for knapper.
14
+
15
+ ### 📃 Tilgjengelige samantiske tokens
10
16
 
11
- Referanse-tokens (OBS! under arbeid) bruker base-tokens til å definere logikk for hvordan base-tokens skal brukes videre i komponenter og andre elementer. F.eks., referanse-tokens kan spesifisere hva fokusfargen skal være, eller font og farge for label i skjemakomponenter. Tanken med referanse-tokens er å gjøre det enklere å gjenbruke koden og eventuelt endre på styling i komponenter ved å endre kun på tokens, uten å røre CSS inni komponentene.
17
+ > [!NOTE]
18
+ > Semantiske tokens er under arbeid. Flere typer tokens blir tilgjengelige over tid.
19
+
20
+ - color
12
21
 
13
22
  ### 📃 Tilgjengelige base-tokens
14
23
 
15
- - border
16
24
  - borderRadius
17
- - breakpoints
18
- - colors
25
+ - breakpoint
19
26
  - font
20
27
  - fontPackages (kun JS)
21
28
  - grid
22
- - iconSizes
23
- - innerShadow
24
- - outerShadow
29
+ - iconSize
30
+ - shadow
25
31
  - spacing
26
32
 
27
33
  ## 📦 Installasjon
@@ -32,18 +38,18 @@ pnpm add @norges-domstoler/dds-design-tokens
32
38
 
33
39
  ## 🔨 Bruk
34
40
 
35
- Design tokens er eksportert som JS-konstanter, CSS-variabler og SCSS-variabler. Les mer under [Kom i gang](https://design.domstol.no/987b33f71/p/956e78-kom-i-gang/b/0174a7) og [Design tokens](https://design.domstol.no/987b33f71/p/18bd6f-design-tokens/b/499a2c) i dokumentasjonen.
41
+ Design tokens er eksportert som JS-konstanter, CSS-variabler og SCSS-variabler.
36
42
 
37
43
  ### JS
38
44
 
39
45
  ```js
40
46
  import * as React from 'react';
41
47
  import { render } from 'react-dom';
42
- import { ddsBaseTokens } from '@norges-domstoler/dds-design-tokens';
48
+ import { ddsTokens } from '@norges-domstoler/dds-design-tokens';
43
49
 
44
50
  const style = {
45
- backgroundColor: ddsBaseTokens.DdsColorPrimaryBase,
46
- padding: ddsBaseTokens.DdsSpacingX075,
51
+ backgroundColor: ddsTokens.DdsColorBgDefault,
52
+ padding: ddsTokens.DdsSpacingX075,
47
53
  };
48
54
 
49
55
  const App = () => <div style={style}>Tekst</div>;
@@ -53,21 +59,24 @@ render(<App />, document.getElementById('root'));
53
59
 
54
60
  ### CSS
55
61
 
62
+ > [!TIP]
63
+ > Vi anbefaler VS Code plugin [CSS Variable Autocomplete](https://marketplace.visualstudio.com/items?itemName=vunguyentuan.vscode-css-variables) for sømløs bruk av tokens i CSS.
64
+
56
65
  ```css
57
- @import '@norges-domstoler/dds-design-tokens/dist/css/colors.css';
66
+ @import '@norges-domstoler/dds-design-tokens/dist/css/ddsTokens.css';
58
67
 
59
68
  body {
60
- background-color: var(--dds-color-primary-base);
69
+ background-color: var(--dds-color-bg-default);
61
70
  }
62
71
  ```
63
72
 
64
73
  ### SCSS
65
74
 
66
75
  ```scss
67
- @use '@norges-domstoler/dds-design-tokens/dist/scss/colors' as colors;
76
+ @use '@norges-domstoler/dds-design-tokens/dist/scss/ddsTokens' as ddsTokens;
68
77
 
69
78
  body {
70
- background-color: colors.$dds-color-primary-base;
79
+ background-color: ddsTokens.$dds-color-bg-default;
71
80
  }
72
81
  ```
73
82
 
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Do not edit directly
3
- * Generated on Mon, 10 Jun 2024 11:27:50 GMT
3
+ * Generated on Tue, 23 Jul 2024 10:51:13 GMT
4
4
  */
5
5
  export declare const DdsColorPrimaryLightest = "#eaeff4";
6
6
  export declare const DdsColorPrimaryLighter = "#acbbc6";
@@ -102,6 +102,7 @@ export declare const DdsColorSurfaceFieldDisabled = "#f8f9f9";
102
102
  export declare const DdsColorSurfaceHighlightedDefault = "#ffe6df";
103
103
  export declare const DdsColorSurfaceScrollbar = "#adb5ba";
104
104
  export declare const DdsColorSurfaceNotification = "#d83737";
105
+ export declare const DdsColorSurfaceSkeleton = "#cfd4d7";
105
106
  export declare const DdsColorBorderDefault = "#77838c";
106
107
  export declare const DdsColorBorderSubtle = "#cfd4d7";
107
108
  export declare const DdsColorBorderInverse = "#acbbc6";
@@ -141,7 +142,7 @@ export declare const DdsColorIconOnInfoDefault = "#466f8a";
141
142
  export declare const DdsColorIconOnInfoStrong = "#0b0d0e";
142
143
  export declare const DdsColorBrandPrimaryDefault = "#354754";
143
144
  export declare const DdsColorBrandPrimarySubtle = "#eaeff4";
144
- export declare const DdsColorBrandPrimaryMedium = "#acbbc6";
145
+ export declare const DdsColorBrandPrimaryMedium = "#4f6a7e";
145
146
  export declare const DdsColorBrandPrimaryStrong = "#202b32";
146
147
  export declare const DdsColorBrandSecondaryDefault = "#9ab8b7";
147
148
  export declare const DdsColorBrandSecondarySubtle = "#e6eded";
@@ -506,6 +506,7 @@ export declare const DdsColorSurfaceFieldDisabled = "#f8f9f9";
506
506
  export declare const DdsColorSurfaceHighlightedDefault = "#ffe6df";
507
507
  export declare const DdsColorSurfaceScrollbar = "#adb5ba";
508
508
  export declare const DdsColorSurfaceNotification = "#d83737";
509
+ export declare const DdsColorSurfaceSkeleton = "#cfd4d7";
509
510
  export declare const DdsColorBorderDefault = "#77838c";
510
511
  export declare const DdsColorBorderSubtle = "#cfd4d7";
511
512
  export declare const DdsColorBorderInverse = "#acbbc6";
@@ -545,7 +546,7 @@ export declare const DdsColorIconOnInfoDefault = "#466f8a";
545
546
  export declare const DdsColorIconOnInfoStrong = "#0b0d0e";
546
547
  export declare const DdsColorBrandPrimaryDefault = "#354754";
547
548
  export declare const DdsColorBrandPrimarySubtle = "#eaeff4";
548
- export declare const DdsColorBrandPrimaryMedium = "#acbbc6";
549
+ export declare const DdsColorBrandPrimaryMedium = "#4f6a7e";
549
550
  export declare const DdsColorBrandPrimaryStrong = "#202b32";
550
551
  export declare const DdsColorBrandSecondaryDefault = "#9ab8b7";
551
552
  export declare const DdsColorBrandSecondarySubtle = "#e6eded";