@microsoft/atlas-css 3.43.0 → 3.44.1

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.
Files changed (110) hide show
  1. package/README.md +42 -42
  2. package/dist/class-names.json +1 -1
  3. package/dist/index.css +1 -1
  4. package/dist/index.css.map +1 -1
  5. package/package.json +91 -91
  6. package/src/atomics/README.md +56 -56
  7. package/src/atomics/aspect-ratio.scss +13 -13
  8. package/src/atomics/background.scss +11 -11
  9. package/src/atomics/border.scss +113 -113
  10. package/src/atomics/colors.scss +204 -204
  11. package/src/atomics/display.scss +33 -33
  12. package/src/atomics/flex.scss +74 -71
  13. package/src/atomics/gap.scss +60 -60
  14. package/src/atomics/image.scss +15 -15
  15. package/src/atomics/index.scss +18 -18
  16. package/src/atomics/line-clamp.scss +15 -15
  17. package/src/atomics/list.scss +8 -3
  18. package/src/atomics/overflow.scss +9 -9
  19. package/src/atomics/position.scss +19 -19
  20. package/src/atomics/shadow.scss +19 -19
  21. package/src/atomics/spacing-auto.scss +52 -52
  22. package/src/atomics/spacing.scss +98 -98
  23. package/src/atomics/typography.scss +203 -203
  24. package/src/atomics/visually-hidden.scss +4 -4
  25. package/src/atomics/width.scss +44 -44
  26. package/src/components/README.md +69 -69
  27. package/src/components/banner.scss +69 -69
  28. package/src/components/breadcrumbs.scss +37 -37
  29. package/src/components/button-reset.scss +8 -8
  30. package/src/components/button.scss +241 -241
  31. package/src/components/buttons.scss +93 -93
  32. package/src/components/card.scss +252 -252
  33. package/src/components/form/checkbox.scss +141 -141
  34. package/src/components/form/form.scss +67 -67
  35. package/src/components/form/help.scss +18 -18
  36. package/src/components/form/index.scss +8 -8
  37. package/src/components/form/input.scss +143 -143
  38. package/src/components/form/label.scss +14 -14
  39. package/src/components/form/radio.scss +121 -121
  40. package/src/components/form/select.scss +116 -116
  41. package/src/components/form/textarea.scss +82 -82
  42. package/src/components/gradient-card.scss +14 -14
  43. package/src/components/gradient.scss +85 -85
  44. package/src/components/hero.scss +197 -197
  45. package/src/components/icon.scss +20 -20
  46. package/src/components/image.scss +44 -44
  47. package/src/components/index.scss +27 -27
  48. package/src/components/layout.scss +189 -189
  49. package/src/components/link-button.scss +34 -34
  50. package/src/components/markdown.scss +158 -158
  51. package/src/components/media.scss +22 -22
  52. package/src/components/message.scss +74 -74
  53. package/src/components/notification.scss +101 -101
  54. package/src/components/pagination.scss +183 -183
  55. package/src/components/persona.scss +60 -60
  56. package/src/components/popover.scss +42 -42
  57. package/src/components/scroll.scss +26 -26
  58. package/src/components/segmented-control.scss +128 -128
  59. package/src/components/site-header.scss +255 -255
  60. package/src/components/stretched-link.scss +8 -8
  61. package/src/components/table.scss +114 -114
  62. package/src/components/toggle.scss +86 -86
  63. package/src/core/animations.scss +55 -55
  64. package/src/core/bare-elements.scss +38 -38
  65. package/src/core/focus.scss +45 -45
  66. package/src/core/font-stack.scss +28 -28
  67. package/src/core/index.scss +7 -7
  68. package/src/core/minireset.scss +79 -79
  69. package/src/core/normalize.scss +353 -353
  70. package/src/core/themes.scss +91 -91
  71. package/src/index.scss +5 -5
  72. package/src/mixins/center.scss +11 -11
  73. package/src/mixins/code-block.scss +43 -43
  74. package/src/mixins/colors.scss +6 -6
  75. package/src/mixins/control.scss +43 -43
  76. package/src/mixins/dismiss.scss +22 -22
  77. package/src/mixins/focus.scss +23 -23
  78. package/src/mixins/font-size.scss +35 -35
  79. package/src/mixins/force-colors.scss +5 -5
  80. package/src/mixins/gradient.scss +11 -11
  81. package/src/mixins/index.scss +17 -17
  82. package/src/mixins/layout-gap.scss +7 -7
  83. package/src/mixins/line-clamp.scss +15 -15
  84. package/src/mixins/loader.scss +16 -16
  85. package/src/mixins/media-queries.scss +61 -61
  86. package/src/mixins/overlay.scss +12 -12
  87. package/src/mixins/transparency.scss +15 -15
  88. package/src/mixins/unselectable.scss +13 -13
  89. package/src/mixins/visually-hidden.scss +12 -12
  90. package/src/tokens/animation.scss +8 -8
  91. package/src/tokens/border.scss +12 -12
  92. package/src/tokens/breakpoints.scss +11 -11
  93. package/src/tokens/colors.scss +239 -239
  94. package/src/tokens/direction.scss +25 -25
  95. package/src/tokens/display.scss +5 -5
  96. package/src/tokens/focus.scss +9 -9
  97. package/src/tokens/font-stack.scss +10 -10
  98. package/src/tokens/index.scss +17 -17
  99. package/src/tokens/layout.scss +17 -17
  100. package/src/tokens/palette.scss +200 -200
  101. package/src/tokens/position.scss +5 -5
  102. package/src/tokens/schemes.scss +14 -14
  103. package/src/tokens/shadow.scss +11 -11
  104. package/src/tokens/spacing.scss +25 -25
  105. package/src/tokens/themes.scss +318 -318
  106. package/src/tokens/typography.scss +33 -33
  107. package/src/tokens/z-index.scss +20 -20
  108. package/tokens/README.md +34 -34
  109. package/tokens/index.js +246 -246
  110. package/tokens/types.d.ts +35 -35
@@ -1,203 +1,203 @@
1
- // Font family
2
-
3
- .font-family-monospace {
4
- font-family: $monospace-font-stack !important;
5
- -moz-osx-font-smoothing: auto;
6
- -webkit-font-smoothing: auto;
7
- }
8
-
9
- .font-family-quote {
10
- font-family: $quote-font-stack !important;
11
- }
12
-
13
- // Heading sizes
14
-
15
- .font-size-h0 {
16
- font-size: $font-size-0 !important;
17
- }
18
-
19
- .font-size-h1 {
20
- font-size: $font-size-1 !important;
21
- }
22
-
23
- .font-size-h2 {
24
- font-size: $font-size-2 !important;
25
- }
26
-
27
- .font-size-h3 {
28
- font-size: $font-size-3 !important;
29
- }
30
-
31
- .font-size-h4 {
32
- font-size: $font-size-4 !important;
33
- }
34
-
35
- .font-size-h5 {
36
- font-size: $font-size-5 !important;
37
- }
38
-
39
- .font-size-h6 {
40
- font-size: $font-size-6 !important;
41
- }
42
-
43
- @include tablet {
44
- .font-size-h0-tablet {
45
- font-size: $font-size-0 !important;
46
- }
47
-
48
- .font-size-h1-tablet {
49
- font-size: $font-size-1 !important;
50
- }
51
-
52
- .font-size-h2-tablet {
53
- font-size: $font-size-2 !important;
54
- }
55
-
56
- .font-size-h3-tablet {
57
- font-size: $font-size-3 !important;
58
- }
59
-
60
- .font-size-h4-tablet {
61
- font-size: $font-size-4 !important;
62
- }
63
-
64
- .font-size-h5-tablet {
65
- font-size: $font-size-5 !important;
66
- }
67
-
68
- .font-size-h6-tablet {
69
- font-size: $font-size-6 !important;
70
- }
71
- }
72
-
73
- // Non-heading sizes
74
-
75
- .font-size-xl {
76
- font-size: $font-size-5 !important;
77
- }
78
-
79
- .font-size-lg {
80
- font-size: $font-size-6 !important;
81
- }
82
-
83
- .font-size-md {
84
- font-size: $font-size-7 !important;
85
- }
86
-
87
- .font-size-sm {
88
- font-size: $font-size-8 !important;
89
- }
90
-
91
- .font-size-xs {
92
- font-size: $font-size-9 !important;
93
- }
94
-
95
- // Non-heading sizes
96
-
97
- @include tablet {
98
- .font-size-xl-tablet {
99
- font-size: $font-size-5 !important;
100
- }
101
-
102
- .font-size-lg-tablet {
103
- font-size: $font-size-6 !important;
104
- }
105
-
106
- .font-size-md-tablet {
107
- font-size: $font-size-7 !important;
108
- }
109
-
110
- .font-size-sm-tablet {
111
- font-size: $font-size-8 !important;
112
- }
113
-
114
- .font-size-xs-tablet {
115
- font-size: $font-size-9 !important;
116
- }
117
- }
118
-
119
- // Weight
120
-
121
- .font-weight-light {
122
- font-weight: $weight-light !important;
123
- }
124
-
125
- .font-weight-semilight {
126
- font-weight: $weight-semilight !important;
127
- }
128
-
129
- .font-weight-normal {
130
- font-weight: $weight-normal !important;
131
- }
132
-
133
- .font-weight-semibold {
134
- font-weight: $weight-semibold !important;
135
- }
136
-
137
- .font-weight-bold {
138
- font-weight: $weight-bold !important;
139
- }
140
-
141
- // Case
142
-
143
- .font-style-italic {
144
- font-style: italic !important;
145
- }
146
-
147
- .text-decoration-underline {
148
- text-decoration: underline !important;
149
- }
150
-
151
- .text-decoration-none {
152
- text-decoration: none !important;
153
- }
154
-
155
- // Letter Spacing
156
-
157
- .letter-spacing-wide {
158
- letter-spacing: $letter-spacing-wide !important;
159
- }
160
-
161
- .text-transform-uppercase {
162
- text-transform: uppercase !important;
163
- }
164
-
165
- // Alignment
166
-
167
- .text-align-left {
168
- text-align: start !important;
169
- }
170
-
171
- .text-align-center {
172
- text-align: center !important;
173
- }
174
-
175
- .text-align-right {
176
- text-align: end !important;
177
- }
178
-
179
- @include tablet {
180
- .text-align-left-tablet {
181
- text-align: start !important;
182
- }
183
-
184
- .text-align-center-tablet {
185
- text-align: center !important;
186
- }
187
-
188
- .text-align-right-tablet {
189
- text-align: end !important;
190
- }
191
- }
192
-
193
- // Text wrapping behavior
194
-
195
- .text-wrap-pretty {
196
- text-wrap: pretty !important;
197
- }
198
-
199
- // Line height
200
-
201
- .line-height-normal {
202
- line-height: $line-height-normal;
203
- }
1
+ // Font family
2
+
3
+ .font-family-monospace {
4
+ font-family: $monospace-font-stack !important;
5
+ -moz-osx-font-smoothing: auto;
6
+ -webkit-font-smoothing: auto;
7
+ }
8
+
9
+ .font-family-quote {
10
+ font-family: $quote-font-stack !important;
11
+ }
12
+
13
+ // Heading sizes
14
+
15
+ .font-size-h0 {
16
+ font-size: $font-size-0 !important;
17
+ }
18
+
19
+ .font-size-h1 {
20
+ font-size: $font-size-1 !important;
21
+ }
22
+
23
+ .font-size-h2 {
24
+ font-size: $font-size-2 !important;
25
+ }
26
+
27
+ .font-size-h3 {
28
+ font-size: $font-size-3 !important;
29
+ }
30
+
31
+ .font-size-h4 {
32
+ font-size: $font-size-4 !important;
33
+ }
34
+
35
+ .font-size-h5 {
36
+ font-size: $font-size-5 !important;
37
+ }
38
+
39
+ .font-size-h6 {
40
+ font-size: $font-size-6 !important;
41
+ }
42
+
43
+ @include tablet {
44
+ .font-size-h0-tablet {
45
+ font-size: $font-size-0 !important;
46
+ }
47
+
48
+ .font-size-h1-tablet {
49
+ font-size: $font-size-1 !important;
50
+ }
51
+
52
+ .font-size-h2-tablet {
53
+ font-size: $font-size-2 !important;
54
+ }
55
+
56
+ .font-size-h3-tablet {
57
+ font-size: $font-size-3 !important;
58
+ }
59
+
60
+ .font-size-h4-tablet {
61
+ font-size: $font-size-4 !important;
62
+ }
63
+
64
+ .font-size-h5-tablet {
65
+ font-size: $font-size-5 !important;
66
+ }
67
+
68
+ .font-size-h6-tablet {
69
+ font-size: $font-size-6 !important;
70
+ }
71
+ }
72
+
73
+ // Non-heading sizes
74
+
75
+ .font-size-xl {
76
+ font-size: $font-size-5 !important;
77
+ }
78
+
79
+ .font-size-lg {
80
+ font-size: $font-size-6 !important;
81
+ }
82
+
83
+ .font-size-md {
84
+ font-size: $font-size-7 !important;
85
+ }
86
+
87
+ .font-size-sm {
88
+ font-size: $font-size-8 !important;
89
+ }
90
+
91
+ .font-size-xs {
92
+ font-size: $font-size-9 !important;
93
+ }
94
+
95
+ // Non-heading sizes
96
+
97
+ @include tablet {
98
+ .font-size-xl-tablet {
99
+ font-size: $font-size-5 !important;
100
+ }
101
+
102
+ .font-size-lg-tablet {
103
+ font-size: $font-size-6 !important;
104
+ }
105
+
106
+ .font-size-md-tablet {
107
+ font-size: $font-size-7 !important;
108
+ }
109
+
110
+ .font-size-sm-tablet {
111
+ font-size: $font-size-8 !important;
112
+ }
113
+
114
+ .font-size-xs-tablet {
115
+ font-size: $font-size-9 !important;
116
+ }
117
+ }
118
+
119
+ // Weight
120
+
121
+ .font-weight-light {
122
+ font-weight: $weight-light !important;
123
+ }
124
+
125
+ .font-weight-semilight {
126
+ font-weight: $weight-semilight !important;
127
+ }
128
+
129
+ .font-weight-normal {
130
+ font-weight: $weight-normal !important;
131
+ }
132
+
133
+ .font-weight-semibold {
134
+ font-weight: $weight-semibold !important;
135
+ }
136
+
137
+ .font-weight-bold {
138
+ font-weight: $weight-bold !important;
139
+ }
140
+
141
+ // Case
142
+
143
+ .font-style-italic {
144
+ font-style: italic !important;
145
+ }
146
+
147
+ .text-decoration-underline {
148
+ text-decoration: underline !important;
149
+ }
150
+
151
+ .text-decoration-none {
152
+ text-decoration: none !important;
153
+ }
154
+
155
+ // Letter Spacing
156
+
157
+ .letter-spacing-wide {
158
+ letter-spacing: $letter-spacing-wide !important;
159
+ }
160
+
161
+ .text-transform-uppercase {
162
+ text-transform: uppercase !important;
163
+ }
164
+
165
+ // Alignment
166
+
167
+ .text-align-left {
168
+ text-align: start !important;
169
+ }
170
+
171
+ .text-align-center {
172
+ text-align: center !important;
173
+ }
174
+
175
+ .text-align-right {
176
+ text-align: end !important;
177
+ }
178
+
179
+ @include tablet {
180
+ .text-align-left-tablet {
181
+ text-align: start !important;
182
+ }
183
+
184
+ .text-align-center-tablet {
185
+ text-align: center !important;
186
+ }
187
+
188
+ .text-align-right-tablet {
189
+ text-align: end !important;
190
+ }
191
+ }
192
+
193
+ // Text wrapping behavior
194
+
195
+ .text-wrap-pretty {
196
+ text-wrap: pretty !important;
197
+ }
198
+
199
+ // Line height
200
+
201
+ .line-height-normal {
202
+ line-height: $line-height-normal;
203
+ }
@@ -1,4 +1,4 @@
1
- .visually-hidden,
2
- ::part(visually-hidden) {
3
- @include visually-hidden();
4
- }
1
+ .visually-hidden,
2
+ ::part(visually-hidden) {
3
+ @include visually-hidden();
4
+ }
@@ -1,44 +1,44 @@
1
- @use 'sass:list';
2
-
3
- $universal-widths: auto, 100, 150, 200, 250, 300, 350 !default;
4
- $mobile-incompatible-widths: 400, 450, 500, unset !default;
5
- $all-widths: list.join($universal-widths, $mobile-incompatible-widths);
6
-
7
- // widths
8
-
9
- .width-full {
10
- width: 100% !important;
11
- }
12
-
13
- @each $width in $universal-widths {
14
- $unit: if($width != auto, 'px', '');
15
- .width-#{$width} {
16
- width: #{$width}#{$unit} !important;
17
- }
18
- }
19
-
20
- @include tablet {
21
- .width-full-tablet {
22
- width: 100% !important;
23
- }
24
-
25
- @each $width in $all-widths {
26
- $unit: if($width != auto and $width != unset, 'px', '');
27
- .width-#{$width}-tablet {
28
- width: #{$width}#{$unit} !important;
29
- }
30
- }
31
- }
32
-
33
- @include desktop {
34
- .width-full-desktop {
35
- width: 100% !important;
36
- }
37
-
38
- @each $width in $all-widths {
39
- $unit: if($width != auto and $width != unset, 'px', '');
40
- .width-#{$width}-desktop {
41
- width: #{$width}#{$unit} !important;
42
- }
43
- }
44
- }
1
+ @use 'sass:list';
2
+
3
+ $universal-widths: auto, 100, 150, 200, 250, 300, 350 !default;
4
+ $mobile-incompatible-widths: 400, 450, 500, unset !default;
5
+ $all-widths: list.join($universal-widths, $mobile-incompatible-widths);
6
+
7
+ // widths
8
+
9
+ .width-full {
10
+ width: 100% !important;
11
+ }
12
+
13
+ @each $width in $universal-widths {
14
+ $unit: if($width != auto, 'px', '');
15
+ .width-#{$width} {
16
+ width: #{$width}#{$unit} !important;
17
+ }
18
+ }
19
+
20
+ @include tablet {
21
+ .width-full-tablet {
22
+ width: 100% !important;
23
+ }
24
+
25
+ @each $width in $all-widths {
26
+ $unit: if($width != auto and $width != unset, 'px', '');
27
+ .width-#{$width}-tablet {
28
+ width: #{$width}#{$unit} !important;
29
+ }
30
+ }
31
+ }
32
+
33
+ @include desktop {
34
+ .width-full-desktop {
35
+ width: 100% !important;
36
+ }
37
+
38
+ @each $width in $all-widths {
39
+ $unit: if($width != auto and $width != unset, 'px', '');
40
+ .width-#{$width}-desktop {
41
+ width: #{$width}#{$unit} !important;
42
+ }
43
+ }
44
+ }
@@ -1,69 +1,69 @@
1
- # Atlas CSS Components
2
-
3
- Each of the files in the `/components` folder (or subfolders) contain one Atlas component. Create new component when you have a complex layout that requires many helper classes to recreate.
4
-
5
- ## Guidance
6
-
7
- There are a few things to think about when adding a new component, though none of them are strict rules.
8
-
9
- - File name should match the class of the component.
10
- - There should only be one top level class per file.
11
- - Subclasses (classes that to go inside the main class) are fine.
12
- - Modifier classes on the main class are also fine.
13
- - Seek to nest only two levels deep, three at most.
14
-
15
- ## Direction
16
-
17
- When horizontal (inline) direction is important to a component, the user's text direction should be interpolated into the appropriate place(s). This guidance will be updated after Atlas moves to logical properties for direction related styles. See below for an example of how that is
18
-
19
- ```scss
20
- .thing-with-side-border {
21
- border-#{$user-left}: 1px solid magenta;
22
- }
23
- ```
24
-
25
- ## Class nomenclature within components
26
-
27
- The component name itself should be a noun or noun-phrase. Endeavor to choose the shortest applicable word or series of words that best describes the component. Modifiers on a particular component should contain the top level component within the class name. State based class modifiers will follow a different convention, and be prefixed with `is-`.
28
-
29
- Examples of state-targeting classes are:
30
-
31
- - `is-disabled`
32
- - `is-hovered`
33
- - `is-focused`
34
-
35
- ## Sizes within class names
36
-
37
- Although we favor unabbreviated names in our design system, we've made one exception. This exception applies to both components and atomics, and it is in the use of sizes. We abbreviate size with at-least-two-letter t-shirt sizes. If it weren't for the terrible ergonomics of writing `extra-extra-large` then we'd likely have stuck to standard operating procudure here, but as George Orwell said in his final rule for clear writing, "Break any of these rules sooner than say anything outright barbarous."
38
-
39
- - extra extra small - xs
40
- - extra small - xs
41
- - small -> sm
42
- - large -> lg
43
- - extra large - xl
44
- - extra extra large - xl
45
-
46
- ## Example
47
-
48
- ```scss
49
- // main class
50
- .component {
51
- [...]
52
-
53
- &.component-sm {
54
- [...]
55
- }
56
-
57
- &.component-lg {
58
- [...]
59
- }
60
-
61
- .component-sub {
62
- [...]
63
- }
64
-
65
- .component-sub-component {
66
- [...]
67
- }
68
- }
69
- ```
1
+ # Atlas CSS Components
2
+
3
+ Each of the files in the `/components` folder (or subfolders) contain one Atlas component. Create new component when you have a complex layout that requires many helper classes to recreate.
4
+
5
+ ## Guidance
6
+
7
+ There are a few things to think about when adding a new component, though none of them are strict rules.
8
+
9
+ - File name should match the class of the component.
10
+ - There should only be one top level class per file.
11
+ - Subclasses (classes that to go inside the main class) are fine.
12
+ - Modifier classes on the main class are also fine.
13
+ - Seek to nest only two levels deep, three at most.
14
+
15
+ ## Direction
16
+
17
+ When horizontal (inline) direction is important to a component, the user's text direction should be interpolated into the appropriate place(s). This guidance will be updated after Atlas moves to logical properties for direction related styles. See below for an example of how that is
18
+
19
+ ```scss
20
+ .thing-with-side-border {
21
+ border-#{$user-left}: 1px solid magenta;
22
+ }
23
+ ```
24
+
25
+ ## Class nomenclature within components
26
+
27
+ The component name itself should be a noun or noun-phrase. Endeavor to choose the shortest applicable word or series of words that best describes the component. Modifiers on a particular component should contain the top level component within the class name. State based class modifiers will follow a different convention, and be prefixed with `is-`.
28
+
29
+ Examples of state-targeting classes are:
30
+
31
+ - `is-disabled`
32
+ - `is-hovered`
33
+ - `is-focused`
34
+
35
+ ## Sizes within class names
36
+
37
+ Although we favor unabbreviated names in our design system, we've made one exception. This exception applies to both components and atomics, and it is in the use of sizes. We abbreviate size with at-least-two-letter t-shirt sizes. If it weren't for the terrible ergonomics of writing `extra-extra-large` then we'd likely have stuck to standard operating procudure here, but as George Orwell said in his final rule for clear writing, "Break any of these rules sooner than say anything outright barbarous."
38
+
39
+ - extra extra small - xs
40
+ - extra small - xs
41
+ - small -> sm
42
+ - large -> lg
43
+ - extra large - xl
44
+ - extra extra large - xl
45
+
46
+ ## Example
47
+
48
+ ```scss
49
+ // main class
50
+ .component {
51
+ [...]
52
+
53
+ &.component-sm {
54
+ [...]
55
+ }
56
+
57
+ &.component-lg {
58
+ [...]
59
+ }
60
+
61
+ .component-sub {
62
+ [...]
63
+ }
64
+
65
+ .component-sub-component {
66
+ [...]
67
+ }
68
+ }
69
+ ```