@whatsaaaa/design-system 0.7.0 → 0.8.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.
- package/README.md +1 -1
- package/dist/css/callout.css +2 -2
- package/dist/css/ghost.css +5 -3
- package/dist/css/icons.css +6 -3
- package/dist/css/pairs.css +33 -0
- package/dist/css/prose.css +5 -3
- package/dist/css/terminal.css +29 -11
- package/dist/index.css +71 -16
- package/dist/tailwind/theme.css +4 -2
- package/dist/theme/meta.d.ts +8 -0
- package/dist/theme/meta.js +23 -0
- package/dist/tokens.css +2 -0
- package/dist/tokens.d.ts +1 -0
- package/dist/tokens.js +2 -0
- package/dist/vitepress-config/index.js +3 -0
- package/docs/usage.md +56 -25
- package/package.json +5 -1
- package/src/vitepress/styles/doc.css +21 -7
- package/src/vitepress/styles/home.css +18 -0
- package/src/vitepress/styles/layout.css +26 -6
- package/src/vitepress/styles/nav.css +55 -9
- package/src/vitepress/styles/sidebar.css +8 -0
- package/tokens/core.tokens.json +7 -0
package/README.md
CHANGED
|
@@ -65,7 +65,7 @@ CI runs on every pull request:
|
|
|
65
65
|
- the unit tests, with the contrast of every role pair in both themes, the comments of the stylesheets in the built ones, and Nuxt UI's colors read from tokens outside any layer,
|
|
66
66
|
- that `assets/` is what the sources produce,
|
|
67
67
|
- that the package and the style guide build,
|
|
68
|
-
- the browser tests: no page overflows sideways at phone, tablet and desktop width in either theme, and no terminal window or bar of one cuts off its content, no page logs an error when it loads, the easter egg works with the mouse, the keyboard and reduced motion, the keys of the status line work and their switch turns them off, the numbers of the tabs show only while their keys work and keep their place while the keys load, the path of the status line gives way at every width from 320 px and the theme button switches the theme, a `dark` or `light` class chooses the theme as `data-theme` does, an element for one theme shows only in it, the browser's theme-color follows the theme, a control that takes the focus is not left under the status line and no bar or corner of the window cuts off its focus ring, a radius of the page's own wins over the focus ring's and a button without one takes its small corners, with index.css and with tailwind.css, a state lines up with the text beside it, a prompt that wraps keeps its chevron on its first line at every width from 320 px, assistive technology reads the parts of the path above a page title as words of their own, the first tab starts on the border of the sidebar, the pieces of a form fit every width from 320 px (a segmented control works with the keyboard, stands out at 3:1 and takes the selection colors in forced colors, amounts line up at the right in figures of one width, a number field has no spin buttons and its arrow keys step it, wrapped code hangs and stays inside its block, a long email breaks after its @, and the
|
|
68
|
+
- the browser tests: no page overflows sideways at phone, tablet and desktop width in either theme, and no terminal window or bar of one cuts off its content, no page logs an error when it loads, the easter egg works with the mouse, the keyboard and reduced motion, the keys of the status line work and their switch turns them off, the numbers of the tabs show only while their keys work and keep their place while the keys load, the path of the status line gives way at every width from 320 px without leaving a stub, its items take less padding on a phone and the theme button switches the theme, the content of a window starts at the gutter where the brand of the tab bar does on a phone, in the docs theme too, where a project's mark as the logo starts on it as well and over the sidebar's headings from 60rem up, a `dark` or `light` class chooses the theme as `data-theme` does, an element for one theme shows only in it, the browser's theme-color follows the theme and the page as it is sent has it for both themes, without JavaScript, a control that takes the focus is not left under the status line and no bar or corner of the window cuts off its focus ring, a button of the docs theme takes its ring and not the browser's and the ring of its brand paints over neither the mark nor the name, a code group's language stands in the row of its tabs and off its code, a radius of the page's own wins over the focus ring's and a button without one takes its small corners, with index.css and with tailwind.css, a state lines up with the text beside it, a prompt that wraps keeps its chevron on its first line at every width from 320 px, assistive technology reads the parts of the path above a page title as words of their own, the first tab starts on the border of the sidebar, the pieces of a form fit every width from 320 px (a segmented control works with the keyboard, stands out at 3:1 and takes the selection colors in forced colors, amounts line up at the right in figures of one width, the sections of a review share a term column, two fields share a row from 40rem, a number field has no spin buttons and its arrow keys step it, wrapped code hangs and stays inside its block, a long email breaks after its @, and the icons draw at the icon size and the ghost files draw), both fonts draw Serbian Latin, an app built on the Tailwind entry takes its utilities, layers and `dark:` and `light:` from the tokens and their theme, Nuxt UI's colors take the roles of the theme chosen around them, and the pages of the style guide look like their stored screenshots.
|
|
69
69
|
|
|
70
70
|
The screenshots are in `tests/browser/__screenshots__/` and are taken on Linux, in the Playwright container, so they are the same on every machine. After a change that is meant to be seen, update them:
|
|
71
71
|
|
package/dist/css/callout.css
CHANGED
|
@@ -54,9 +54,9 @@
|
|
|
54
54
|
}
|
|
55
55
|
|
|
56
56
|
.ws-callout__title:before {
|
|
57
|
+
width: var(--ws-size-icon);
|
|
58
|
+
height: var(--ws-size-icon);
|
|
57
59
|
content: "";
|
|
58
|
-
width: 1rem;
|
|
59
|
-
height: 1rem;
|
|
60
60
|
-webkit-mask: var(--ws-callout-icon) center / contain no-repeat;
|
|
61
61
|
mask: var(--ws-callout-icon) center / contain no-repeat;
|
|
62
62
|
background: currentColor;
|
package/dist/css/ghost.css
CHANGED
|
@@ -5,9 +5,11 @@
|
|
|
5
5
|
*/
|
|
6
6
|
|
|
7
7
|
/*
|
|
8
|
-
* The
|
|
9
|
-
* headings take their compact sizes.
|
|
10
|
-
*
|
|
8
|
+
* The two breakpoints of the system. Below --ws-compact there is one column, the tab bar
|
|
9
|
+
* wraps and headings take their compact sizes. Below --ws-narrow, on a phone, a row of
|
|
10
|
+
* fields has no room and each takes a line of its own: from 40rem up two fields fit side
|
|
11
|
+
* by side. Custom properties cannot be used in media queries, so in another project write
|
|
12
|
+
* the queries out: @media (width < 64rem) and @media (width < 40rem).
|
|
11
13
|
*/
|
|
12
14
|
ws-ghost {
|
|
13
15
|
color: var(--ws-color-text);
|
package/dist/css/icons.css
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
/*
|
|
2
2
|
* The few icons the styles draw themselves, as masks, so they take the color of their text
|
|
3
|
-
* and need no markup.
|
|
3
|
+
* and need no markup. The icons of the callouts, the tick and the calendar are 16 x 16 strokes
|
|
4
|
+
* of 1.5, drawn at --ws-size-icon, 16 px, the size they are drawn for. The chevron of a
|
|
5
|
+
* prompt and the arrow of a link take the size of their text.
|
|
4
6
|
*
|
|
5
7
|
* .done::before {
|
|
6
|
-
* width:
|
|
7
|
-
* height:
|
|
8
|
+
* width: var(--ws-size-icon);
|
|
9
|
+
* height: var(--ws-size-icon);
|
|
8
10
|
* background: currentcolor;
|
|
9
11
|
* content: '';
|
|
10
12
|
* mask: var(--ws-icon-check) center / contain no-repeat;
|
|
@@ -16,6 +18,7 @@
|
|
|
16
18
|
--ws-icon-warning: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='%23000' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M8 2.2 14.2 13H1.8ZM8 6.6v3M8 11.3v.2'/%3E%3C/svg%3E");
|
|
17
19
|
--ws-icon-danger: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='%23000' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M5.4 1.8h5.2l3.6 3.6v5.2l-3.6 3.6H5.4l-3.6-3.6V5.4ZM8 5v3.6M8 10.9v.2'/%3E%3C/svg%3E");
|
|
18
20
|
--ws-icon-check: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='%23000' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M3 8.5 6.5 12 13 4.5'/%3E%3C/svg%3E");
|
|
21
|
+
--ws-icon-calendar: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='%23000' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect x='1.8' y='3' width='12.4' height='11.2' rx='1.8'/%3E%3Cpath d='M1.8 6.8h12.4M5.2 1.8v2.4M10.8 1.8v2.4'/%3E%3C/svg%3E");
|
|
19
22
|
--ws-icon-chevron: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 10 14' fill='none' stroke='%23000' stroke-width='2.4' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M2 2 8 7 2 12'/%3E%3C/svg%3E");
|
|
20
23
|
--ws-icon-arrow: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' fill='none' stroke='%23000' stroke-width='1.6' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M3 9 9 3M4.25 3H9v4.75'/%3E%3C/svg%3E");
|
|
21
24
|
}
|
package/dist/css/pairs.css
CHANGED
|
@@ -10,6 +10,18 @@
|
|
|
10
10
|
* <div><dt>Email</dt><dd>ana@<wbr />example.com</dd></div>
|
|
11
11
|
* </dl>
|
|
12
12
|
*
|
|
13
|
+
* The sections of one review step, each a list under its own heading, share a term column in
|
|
14
|
+
* ws-pairs-group, so the values of every section line up. The column is as wide as the longest
|
|
15
|
+
* term of them all, at most two fifths of the row. A heading, or anything else in the group,
|
|
16
|
+
* takes a row of its own.
|
|
17
|
+
*
|
|
18
|
+
* <div class="ws-pairs-group">
|
|
19
|
+
* <h3>About you</h3>
|
|
20
|
+
* <dl class="ws-pairs">...</dl>
|
|
21
|
+
* <h3>Your visit</h3>
|
|
22
|
+
* <dl class="ws-pairs">...</dl>
|
|
23
|
+
* </div>
|
|
24
|
+
*
|
|
13
25
|
* Amounts take ws-pairs--amounts: each value at the right edge, in figures of one width, so
|
|
14
26
|
* the digits of the rows line up, and the terms take the rest of the row. The total is the
|
|
15
27
|
* last row, ws-pairs__total.
|
|
@@ -47,6 +59,27 @@
|
|
|
47
59
|
}
|
|
48
60
|
}
|
|
49
61
|
|
|
62
|
+
/*
|
|
63
|
+
* The group holds the columns, and each list in it takes them as its own. A browser without
|
|
64
|
+
* subgrid sizes the term column of each list apart, as without a group. A list of amounts
|
|
65
|
+
* keeps its own columns: its amounts stand at the right edge.
|
|
66
|
+
*/
|
|
67
|
+
.ws-pairs-group {
|
|
68
|
+
column-gap: var(--ws-space-16);
|
|
69
|
+
grid-template-columns: fit-content(40%) minmax(0, 1fr);
|
|
70
|
+
display: grid;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
.ws-pairs-group > * {
|
|
74
|
+
grid-column: 1 / -1;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
@supports (grid-template-columns: subgrid) {
|
|
78
|
+
.ws-pairs-group > .ws-pairs:not(.ws-pairs--amounts) {
|
|
79
|
+
grid-template-columns: subgrid;
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
|
|
50
83
|
.ws-pairs dt {
|
|
51
84
|
color: var(--ws-color-text-secondary);
|
|
52
85
|
font: var(--ws-text-label);
|
package/dist/css/prose.css
CHANGED
|
@@ -5,9 +5,11 @@
|
|
|
5
5
|
*/
|
|
6
6
|
|
|
7
7
|
/*
|
|
8
|
-
* The
|
|
9
|
-
* headings take their compact sizes.
|
|
10
|
-
*
|
|
8
|
+
* The two breakpoints of the system. Below --ws-compact there is one column, the tab bar
|
|
9
|
+
* wraps and headings take their compact sizes. Below --ws-narrow, on a phone, a row of
|
|
10
|
+
* fields has no room and each takes a line of its own: from 40rem up two fields fit side
|
|
11
|
+
* by side. Custom properties cannot be used in media queries, so in another project write
|
|
12
|
+
* the queries out: @media (width < 64rem) and @media (width < 40rem).
|
|
11
13
|
*/
|
|
12
14
|
.ws-prose, .vp-doc {
|
|
13
15
|
color: var(--ws-color-text);
|
package/dist/css/terminal.css
CHANGED
|
@@ -4,9 +4,11 @@
|
|
|
4
4
|
*/
|
|
5
5
|
|
|
6
6
|
/*
|
|
7
|
-
* The
|
|
8
|
-
* headings take their compact sizes.
|
|
9
|
-
*
|
|
7
|
+
* The two breakpoints of the system. Below --ws-compact there is one column, the tab bar
|
|
8
|
+
* wraps and headings take their compact sizes. Below --ws-narrow, on a phone, a row of
|
|
9
|
+
* fields has no room and each takes a line of its own: from 40rem up two fields fit side
|
|
10
|
+
* by side. Custom properties cannot be used in media queries, so in another project write
|
|
11
|
+
* the queries out: @media (width < 64rem) and @media (width < 40rem).
|
|
10
12
|
*/
|
|
11
13
|
|
|
12
14
|
/*
|
|
@@ -403,9 +405,9 @@
|
|
|
403
405
|
|
|
404
406
|
/*
|
|
405
407
|
* The room the other items leave, which the path takes: the items after it go to the right
|
|
406
|
-
* edge, as after a spacer. The path gives way to them inside it. It
|
|
407
|
-
*
|
|
408
|
-
*
|
|
408
|
+
* edge, as after a spacer. The path gives way to them inside it. It is cut with an ellipsis
|
|
409
|
+
* down to five characters, then goes as a whole, padding and all: a letter or two before
|
|
410
|
+
* the ellipsis reads as a glitch, not a path.
|
|
409
411
|
*/
|
|
410
412
|
.ws-status-line__path {
|
|
411
413
|
flex: 1;
|
|
@@ -427,13 +429,24 @@
|
|
|
427
429
|
}
|
|
428
430
|
|
|
429
431
|
/*
|
|
430
|
-
* No room for
|
|
432
|
+
* No room for five characters and the ellipsis, 6ch of the caption's mono face, between the
|
|
433
|
+
* padding of the path, --ws-space-14 on each side, and --ws-space-10 below 64rem. The padding
|
|
431
434
|
* is written out, as a container query takes no var(). The browser test of the path,
|
|
432
|
-
* tests/browser/status-line.spec.ts, holds
|
|
435
|
+
* tests/browser/status-line.spec.ts, holds them together.
|
|
433
436
|
*/
|
|
434
|
-
@
|
|
435
|
-
|
|
436
|
-
|
|
437
|
+
@media (width >= 64rem) {
|
|
438
|
+
@container ws-status-line-path (width < calc(6ch + 1.75rem)) {
|
|
439
|
+
.ws-status-line__file {
|
|
440
|
+
display: none;
|
|
441
|
+
}
|
|
442
|
+
}
|
|
443
|
+
}
|
|
444
|
+
|
|
445
|
+
@media (width < 64rem) {
|
|
446
|
+
@container ws-status-line-path (width < calc(6ch + 1.25rem)) {
|
|
447
|
+
.ws-status-line__file {
|
|
448
|
+
display: none;
|
|
449
|
+
}
|
|
437
450
|
}
|
|
438
451
|
}
|
|
439
452
|
|
|
@@ -607,6 +620,11 @@
|
|
|
607
620
|
border-right-color: #0000;
|
|
608
621
|
}
|
|
609
622
|
|
|
623
|
+
/* The items are padded less on a phone, so the path keeps room for more of itself. */
|
|
624
|
+
.ws-status-line__mode, .ws-status-line__file, .ws-status-line__item, .ws-status-line__switch, .ws-status-line__theme {
|
|
625
|
+
padding-inline: var(--ws-space-10);
|
|
626
|
+
}
|
|
627
|
+
|
|
610
628
|
/* The key hints and the wide items do not fit. A key whose hint is hidden does nothing. */
|
|
611
629
|
:is([data-ws-keys="on"], [data-ws-keys="off"]) .ws-status-line__keys, .ws-status-line__item--wide {
|
|
612
630
|
display: none;
|
package/dist/index.css
CHANGED
|
@@ -159,6 +159,7 @@
|
|
|
159
159
|
--ws-size-content: 50rem;
|
|
160
160
|
--ws-size-control: 2.5rem;
|
|
161
161
|
--ws-size-frame: 90rem;
|
|
162
|
+
--ws-size-icon: 1rem;
|
|
162
163
|
--ws-size-outline: 15rem;
|
|
163
164
|
--ws-size-sidebar: 17rem;
|
|
164
165
|
--ws-size-status-line: 2rem;
|
|
@@ -411,11 +412,13 @@
|
|
|
411
412
|
|
|
412
413
|
/*
|
|
413
414
|
* The few icons the styles draw themselves, as masks, so they take the color of their text
|
|
414
|
-
* and need no markup.
|
|
415
|
+
* and need no markup. The icons of the callouts, the tick and the calendar are 16 x 16 strokes
|
|
416
|
+
* of 1.5, drawn at --ws-size-icon, 16 px, the size they are drawn for. The chevron of a
|
|
417
|
+
* prompt and the arrow of a link take the size of their text.
|
|
415
418
|
*
|
|
416
419
|
* .done::before {
|
|
417
|
-
* width:
|
|
418
|
-
* height:
|
|
420
|
+
* width: var(--ws-size-icon);
|
|
421
|
+
* height: var(--ws-size-icon);
|
|
419
422
|
* background: currentcolor;
|
|
420
423
|
* content: '';
|
|
421
424
|
* mask: var(--ws-icon-check) center / contain no-repeat;
|
|
@@ -427,6 +430,7 @@
|
|
|
427
430
|
--ws-icon-warning: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='%23000' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M8 2.2 14.2 13H1.8ZM8 6.6v3M8 11.3v.2'/%3E%3C/svg%3E");
|
|
428
431
|
--ws-icon-danger: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='%23000' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M5.4 1.8h5.2l3.6 3.6v5.2l-3.6 3.6H5.4l-3.6-3.6V5.4ZM8 5v3.6M8 10.9v.2'/%3E%3C/svg%3E");
|
|
429
432
|
--ws-icon-check: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='%23000' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M3 8.5 6.5 12 13 4.5'/%3E%3C/svg%3E");
|
|
433
|
+
--ws-icon-calendar: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='%23000' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect x='1.8' y='3' width='12.4' height='11.2' rx='1.8'/%3E%3Cpath d='M1.8 6.8h12.4M5.2 1.8v2.4M10.8 1.8v2.4'/%3E%3C/svg%3E");
|
|
430
434
|
--ws-icon-chevron: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 10 14' fill='none' stroke='%23000' stroke-width='2.4' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M2 2 8 7 2 12'/%3E%3C/svg%3E");
|
|
431
435
|
--ws-icon-arrow: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 12 12' fill='none' stroke='%23000' stroke-width='1.6' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M3 9 9 3M4.25 3H9v4.75'/%3E%3C/svg%3E");
|
|
432
436
|
}
|
|
@@ -999,9 +1003,9 @@ input[type="number"]::-webkit-outer-spin-button {
|
|
|
999
1003
|
}
|
|
1000
1004
|
|
|
1001
1005
|
.ws-callout__title:before {
|
|
1006
|
+
width: var(--ws-size-icon);
|
|
1007
|
+
height: var(--ws-size-icon);
|
|
1002
1008
|
content: "";
|
|
1003
|
-
width: 1rem;
|
|
1004
|
-
height: 1rem;
|
|
1005
1009
|
-webkit-mask: var(--ws-callout-icon) center / contain no-repeat;
|
|
1006
1010
|
mask: var(--ws-callout-icon) center / contain no-repeat;
|
|
1007
1011
|
background: currentColor;
|
|
@@ -1122,6 +1126,18 @@ input[type="number"]::-webkit-outer-spin-button {
|
|
|
1122
1126
|
* <div><dt>Email</dt><dd>ana@<wbr />example.com</dd></div>
|
|
1123
1127
|
* </dl>
|
|
1124
1128
|
*
|
|
1129
|
+
* The sections of one review step, each a list under its own heading, share a term column in
|
|
1130
|
+
* ws-pairs-group, so the values of every section line up. The column is as wide as the longest
|
|
1131
|
+
* term of them all, at most two fifths of the row. A heading, or anything else in the group,
|
|
1132
|
+
* takes a row of its own.
|
|
1133
|
+
*
|
|
1134
|
+
* <div class="ws-pairs-group">
|
|
1135
|
+
* <h3>About you</h3>
|
|
1136
|
+
* <dl class="ws-pairs">...</dl>
|
|
1137
|
+
* <h3>Your visit</h3>
|
|
1138
|
+
* <dl class="ws-pairs">...</dl>
|
|
1139
|
+
* </div>
|
|
1140
|
+
*
|
|
1125
1141
|
* Amounts take ws-pairs--amounts: each value at the right edge, in figures of one width, so
|
|
1126
1142
|
* the digits of the rows line up, and the terms take the rest of the row. The total is the
|
|
1127
1143
|
* last row, ws-pairs__total.
|
|
@@ -1159,6 +1175,27 @@ input[type="number"]::-webkit-outer-spin-button {
|
|
|
1159
1175
|
}
|
|
1160
1176
|
}
|
|
1161
1177
|
|
|
1178
|
+
/*
|
|
1179
|
+
* The group holds the columns, and each list in it takes them as its own. A browser without
|
|
1180
|
+
* subgrid sizes the term column of each list apart, as without a group. A list of amounts
|
|
1181
|
+
* keeps its own columns: its amounts stand at the right edge.
|
|
1182
|
+
*/
|
|
1183
|
+
.ws-pairs-group {
|
|
1184
|
+
column-gap: var(--ws-space-16);
|
|
1185
|
+
grid-template-columns: fit-content(40%) minmax(0, 1fr);
|
|
1186
|
+
display: grid;
|
|
1187
|
+
}
|
|
1188
|
+
|
|
1189
|
+
.ws-pairs-group > * {
|
|
1190
|
+
grid-column: 1 / -1;
|
|
1191
|
+
}
|
|
1192
|
+
|
|
1193
|
+
@supports (grid-template-columns: subgrid) {
|
|
1194
|
+
.ws-pairs-group > .ws-pairs:not(.ws-pairs--amounts) {
|
|
1195
|
+
grid-template-columns: subgrid;
|
|
1196
|
+
}
|
|
1197
|
+
}
|
|
1198
|
+
|
|
1162
1199
|
.ws-pairs dt {
|
|
1163
1200
|
color: var(--ws-color-text-secondary);
|
|
1164
1201
|
font: var(--ws-text-label);
|
|
@@ -1593,9 +1630,9 @@ input[type="number"]::-webkit-outer-spin-button {
|
|
|
1593
1630
|
|
|
1594
1631
|
/*
|
|
1595
1632
|
* The room the other items leave, which the path takes: the items after it go to the right
|
|
1596
|
-
* edge, as after a spacer. The path gives way to them inside it. It
|
|
1597
|
-
*
|
|
1598
|
-
*
|
|
1633
|
+
* edge, as after a spacer. The path gives way to them inside it. It is cut with an ellipsis
|
|
1634
|
+
* down to five characters, then goes as a whole, padding and all: a letter or two before
|
|
1635
|
+
* the ellipsis reads as a glitch, not a path.
|
|
1599
1636
|
*/
|
|
1600
1637
|
.ws-status-line__path {
|
|
1601
1638
|
flex: 1;
|
|
@@ -1617,13 +1654,24 @@ input[type="number"]::-webkit-outer-spin-button {
|
|
|
1617
1654
|
}
|
|
1618
1655
|
|
|
1619
1656
|
/*
|
|
1620
|
-
* No room for
|
|
1657
|
+
* No room for five characters and the ellipsis, 6ch of the caption's mono face, between the
|
|
1658
|
+
* padding of the path, --ws-space-14 on each side, and --ws-space-10 below 64rem. The padding
|
|
1621
1659
|
* is written out, as a container query takes no var(). The browser test of the path,
|
|
1622
|
-
* tests/browser/status-line.spec.ts, holds
|
|
1660
|
+
* tests/browser/status-line.spec.ts, holds them together.
|
|
1623
1661
|
*/
|
|
1624
|
-
@
|
|
1625
|
-
|
|
1626
|
-
|
|
1662
|
+
@media (width >= 64rem) {
|
|
1663
|
+
@container ws-status-line-path (width < calc(6ch + 1.75rem)) {
|
|
1664
|
+
.ws-status-line__file {
|
|
1665
|
+
display: none;
|
|
1666
|
+
}
|
|
1667
|
+
}
|
|
1668
|
+
}
|
|
1669
|
+
|
|
1670
|
+
@media (width < 64rem) {
|
|
1671
|
+
@container ws-status-line-path (width < calc(6ch + 1.25rem)) {
|
|
1672
|
+
.ws-status-line__file {
|
|
1673
|
+
display: none;
|
|
1674
|
+
}
|
|
1627
1675
|
}
|
|
1628
1676
|
}
|
|
1629
1677
|
|
|
@@ -1797,6 +1845,11 @@ input[type="number"]::-webkit-outer-spin-button {
|
|
|
1797
1845
|
border-right-color: #0000;
|
|
1798
1846
|
}
|
|
1799
1847
|
|
|
1848
|
+
/* The items are padded less on a phone, so the path keeps room for more of itself. */
|
|
1849
|
+
.ws-status-line__mode, .ws-status-line__file, .ws-status-line__item, .ws-status-line__switch, .ws-status-line__theme {
|
|
1850
|
+
padding-inline: var(--ws-space-10);
|
|
1851
|
+
}
|
|
1852
|
+
|
|
1800
1853
|
/* The key hints and the wide items do not fit. A key whose hint is hidden does nothing. */
|
|
1801
1854
|
:is([data-ws-keys="on"], [data-ws-keys="off"]) .ws-status-line__keys, .ws-status-line__item--wide {
|
|
1802
1855
|
display: none;
|
|
@@ -1810,9 +1863,11 @@ input[type="number"]::-webkit-outer-spin-button {
|
|
|
1810
1863
|
*/
|
|
1811
1864
|
|
|
1812
1865
|
/*
|
|
1813
|
-
* The
|
|
1814
|
-
* headings take their compact sizes.
|
|
1815
|
-
*
|
|
1866
|
+
* The two breakpoints of the system. Below --ws-compact there is one column, the tab bar
|
|
1867
|
+
* wraps and headings take their compact sizes. Below --ws-narrow, on a phone, a row of
|
|
1868
|
+
* fields has no room and each takes a line of its own: from 40rem up two fields fit side
|
|
1869
|
+
* by side. Custom properties cannot be used in media queries, so in another project write
|
|
1870
|
+
* the queries out: @media (width < 64rem) and @media (width < 40rem).
|
|
1816
1871
|
*/
|
|
1817
1872
|
ws-ghost {
|
|
1818
1873
|
color: var(--ws-color-text);
|
package/dist/tailwind/theme.css
CHANGED
|
@@ -160,6 +160,7 @@
|
|
|
160
160
|
--spacing-content: var(--ws-size-content);
|
|
161
161
|
--spacing-control: var(--ws-size-control);
|
|
162
162
|
--spacing-frame: var(--ws-size-frame);
|
|
163
|
+
--spacing-icon: var(--ws-size-icon);
|
|
163
164
|
--spacing-outline: var(--ws-size-outline);
|
|
164
165
|
--spacing-sidebar: var(--ws-size-sidebar);
|
|
165
166
|
--spacing-status-line: var(--ws-size-status-line);
|
|
@@ -200,7 +201,8 @@
|
|
|
200
201
|
--default-transition-timing-function: var(--ws-motion-easing-standard);
|
|
201
202
|
|
|
202
203
|
/*
|
|
203
|
-
* The
|
|
204
|
-
* width < 64rem
|
|
204
|
+
* The two breakpoints are Tailwind's lg, 64rem, and sm, 40rem: max-lg: is the system's
|
|
205
|
+
* compact width, width < 64rem, and max-sm: its narrow width, width < 40rem, where a row of
|
|
206
|
+
* fields stacks. The other breakpoints stay for code that expects them.
|
|
205
207
|
*/
|
|
206
208
|
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/** The attributes of one theme-color tag. */
|
|
2
|
+
export interface ThemeColorMeta {
|
|
3
|
+
name: 'theme-color';
|
|
4
|
+
content: string;
|
|
5
|
+
media: string;
|
|
6
|
+
}
|
|
7
|
+
/** The tags as attributes, for a framework that writes the <head> from data. */
|
|
8
|
+
export declare const themeColorMeta: readonly ThemeColorMeta[];
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The theme-color tags of the served HTML, for a visitor without JavaScript and for a link
|
|
3
|
+
* preview, which read the page as the server sends it: the background of the dark theme,
|
|
4
|
+
* unless the system asks for light, as the stylesheet chooses with no choice by hand. The
|
|
5
|
+
* head script of the theme module takes them over from the first paint on and gives them the
|
|
6
|
+
* background of the theme shown, a choice by hand included.
|
|
7
|
+
*
|
|
8
|
+
* The dark tag comes first, so a reader that ignores media, such as a link preview, takes the
|
|
9
|
+
* system's default theme. It reads the tokens, so it is for a build or a server, and not for
|
|
10
|
+
* the page's own script: the theme module itself carries no color.
|
|
11
|
+
*/
|
|
12
|
+
import { resolver } from '../../dist/tokens.js';
|
|
13
|
+
import { colorHex } from "../color.js";
|
|
14
|
+
const background = (theme) => colorHex(resolver.apply({ theme })['color.bg'].$value);
|
|
15
|
+
/** The tags as attributes, for a framework that writes the <head> from data. */
|
|
16
|
+
export const themeColorMeta = [
|
|
17
|
+
{
|
|
18
|
+
name: 'theme-color',
|
|
19
|
+
content: background('dark'),
|
|
20
|
+
media: 'not all and (prefers-color-scheme: light)',
|
|
21
|
+
},
|
|
22
|
+
{ name: 'theme-color', content: background('light'), media: '(prefers-color-scheme: light)' },
|
|
23
|
+
];
|
package/dist/tokens.css
CHANGED
|
@@ -128,6 +128,8 @@
|
|
|
128
128
|
--ws-size-control: 2.5rem;
|
|
129
129
|
/* Widest a page frame gets. */
|
|
130
130
|
--ws-size-frame: 90rem;
|
|
131
|
+
/* An icon next to text, such as a tick, the icon of a callout or a calendar. */
|
|
132
|
+
--ws-size-icon: 1rem;
|
|
131
133
|
/* Page outline. */
|
|
132
134
|
--ws-size-outline: 15rem;
|
|
133
135
|
/* Side navigation. */
|
package/dist/tokens.d.ts
CHANGED
package/dist/tokens.js
CHANGED
|
@@ -121,6 +121,7 @@ export const PERMUTATIONS = {
|
|
|
121
121
|
"size.content":{"$type":"dimension","$description":"Widest a column of long-form text gets, padding included.","$value":{"value":50,"unit":"rem"}},
|
|
122
122
|
"size.control":{"$type":"dimension","$description":"Height of a one-line field, a button and a segmented control.","$value":{"value":2.5,"unit":"rem"}},
|
|
123
123
|
"size.frame":{"$type":"dimension","$description":"Widest a page frame gets.","$value":{"value":90,"unit":"rem"}},
|
|
124
|
+
"size.icon":{"$type":"dimension","$description":"An icon next to text, such as a tick, the icon of a callout or a calendar.","$value":{"value":1,"unit":"rem"}},
|
|
124
125
|
"size.outline":{"$type":"dimension","$description":"Page outline.","$value":{"value":15,"unit":"rem"}},
|
|
125
126
|
"size.sidebar":{"$type":"dimension","$description":"Side navigation.","$value":{"value":17,"unit":"rem"}},
|
|
126
127
|
"size.status-line":{"$type":"dimension","$description":"Height of the status line.","$value":{"value":2,"unit":"rem"}},
|
|
@@ -286,6 +287,7 @@ export const PERMUTATIONS = {
|
|
|
286
287
|
"size.content":{"$type":"dimension","$description":"Widest a column of long-form text gets, padding included.","$value":{"value":50,"unit":"rem"}},
|
|
287
288
|
"size.control":{"$type":"dimension","$description":"Height of a one-line field, a button and a segmented control.","$value":{"value":2.5,"unit":"rem"}},
|
|
288
289
|
"size.frame":{"$type":"dimension","$description":"Widest a page frame gets.","$value":{"value":90,"unit":"rem"}},
|
|
290
|
+
"size.icon":{"$type":"dimension","$description":"An icon next to text, such as a tick, the icon of a callout or a calendar.","$value":{"value":1,"unit":"rem"}},
|
|
289
291
|
"size.outline":{"$type":"dimension","$description":"Page outline.","$value":{"value":15,"unit":"rem"}},
|
|
290
292
|
"size.sidebar":{"$type":"dimension","$description":"Side navigation.","$value":{"value":17,"unit":"rem"}},
|
|
291
293
|
"size.status-line":{"$type":"dimension","$description":"Height of the status line.","$value":{"value":2,"unit":"rem"}},
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { codeTheme } from "../shiki/index.js";
|
|
2
2
|
import { keysInitScript } from "../shortcuts/index.js";
|
|
3
3
|
import { themeColorScript } from "../theme/color.js";
|
|
4
|
+
import { themeColorMeta } from "../theme/meta.js";
|
|
4
5
|
import { whatsaaaaMarkdown } from "./markdown.js";
|
|
5
6
|
export { whatsaaaaMarkdown } from "./markdown.js";
|
|
6
7
|
/**
|
|
@@ -23,6 +24,8 @@ export function whatsaaaaConfig() {
|
|
|
23
24
|
['script', { id: 'ws-theme' }, themeScript],
|
|
24
25
|
// the browser's own bars take the background of the theme shown, as VitePress switches it
|
|
25
26
|
['script', { id: 'ws-theme-color' }, themeColorScript],
|
|
27
|
+
// and the served page has their colors, for a visitor without JavaScript and a link preview
|
|
28
|
+
...themeColorMeta.map((meta) => ['meta', { ...meta }]),
|
|
26
29
|
// from the first paint the keys are pending, so the numbers of the tabs keep their place
|
|
27
30
|
// unseen until the module runs, or off where they are remembered so, with no numbers
|
|
28
31
|
['script', { id: 'ws-keys' }, keysInitScript],
|
package/docs/usage.md
CHANGED
|
@@ -18,21 +18,21 @@ One import has everything: fonts, tokens, page defaults and every class.
|
|
|
18
18
|
|
|
19
19
|
Or take pieces. `tokens.css` and `fonts.css` first, then what you use:
|
|
20
20
|
|
|
21
|
-
| Import | What it has
|
|
22
|
-
| -------------------------------------------- |
|
|
23
|
-
| `@whatsaaaa/design-system/tokens.css` | Every token as a CSS variable, for both themes
|
|
24
|
-
| `@whatsaaaa/design-system/fonts.css` | JetBrains Mono and Inter, self-hosted, with Serbian Latin
|
|
25
|
-
| `@whatsaaaa/design-system/css/base.css` | Page defaults. It resets margins and list markers
|
|
26
|
-
| `@whatsaaaa/design-system/css/prose.css` | Long-form text, in a `.ws-prose` container
|
|
27
|
-
| `@whatsaaaa/design-system/css/code.css` | `.ws-code`, a code block with a caption
|
|
28
|
-
| `@whatsaaaa/design-system/css/callout.css` | `.ws-callout`
|
|
29
|
-
| `@whatsaaaa/design-system/css/segmented.css` | `.ws-segmented`, buttons in a row with one pressed
|
|
30
|
-
| `@whatsaaaa/design-system/css/pairs.css` | `.ws-pairs`, terms and their values, such as an order summary
|
|
31
|
-
| `@whatsaaaa/design-system/css/terminal.css` | Tab bar, prompts, status line, key caps, tags. It brings `theme.css` along
|
|
32
|
-
| `@whatsaaaa/design-system/css/theme.css` | `ws-theme-dark` and `ws-theme-light`, for an element of one theme only
|
|
33
|
-
| `@whatsaaaa/design-system/css/ghost.css` | Styles of `<ws-ghost>`
|
|
34
|
-
| `@whatsaaaa/design-system/css/icons.css` | The icons the callouts and prompts draw, and `--ws-icon-check`, the tick
|
|
35
|
-
| `@whatsaaaa/design-system/css/nuxt-ui.css` | Nuxt UI's colors on the roles. Only in an app on Nuxt UI, after it: see With Tailwind CSS below
|
|
21
|
+
| Import | What it has |
|
|
22
|
+
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
23
|
+
| `@whatsaaaa/design-system/tokens.css` | Every token as a CSS variable, for both themes |
|
|
24
|
+
| `@whatsaaaa/design-system/fonts.css` | JetBrains Mono and Inter, self-hosted, with Serbian Latin |
|
|
25
|
+
| `@whatsaaaa/design-system/css/base.css` | Page defaults. It resets margins and list markers |
|
|
26
|
+
| `@whatsaaaa/design-system/css/prose.css` | Long-form text, in a `.ws-prose` container |
|
|
27
|
+
| `@whatsaaaa/design-system/css/code.css` | `.ws-code`, a code block with a caption |
|
|
28
|
+
| `@whatsaaaa/design-system/css/callout.css` | `.ws-callout` |
|
|
29
|
+
| `@whatsaaaa/design-system/css/segmented.css` | `.ws-segmented`, buttons in a row with one pressed |
|
|
30
|
+
| `@whatsaaaa/design-system/css/pairs.css` | `.ws-pairs`, terms and their values, such as an order summary, and `.ws-pairs-group` |
|
|
31
|
+
| `@whatsaaaa/design-system/css/terminal.css` | Tab bar, prompts, status line, key caps, tags. It brings `theme.css` along |
|
|
32
|
+
| `@whatsaaaa/design-system/css/theme.css` | `ws-theme-dark` and `ws-theme-light`, for an element of one theme only |
|
|
33
|
+
| `@whatsaaaa/design-system/css/ghost.css` | Styles of `<ws-ghost>` |
|
|
34
|
+
| `@whatsaaaa/design-system/css/icons.css` | The icons the callouts and prompts draw, and the icons of a form: `--ws-icon-check`, the tick, and `--ws-icon-calendar`. Needed with `callout.css` and `terminal.css`, and for those |
|
|
35
|
+
| `@whatsaaaa/design-system/css/nuxt-ui.css` | Nuxt UI's colors on the roles. Only in an app on Nuxt UI, after it: see With Tailwind CSS below |
|
|
36
36
|
|
|
37
37
|
Everything is prefixed: classes with `ws-`, variables with `--ws-`. Only `nuxt-ui.css` sets variables of another prefix, Nuxt UI's `--ui-*`.
|
|
38
38
|
|
|
@@ -83,7 +83,7 @@ The tokens are Tailwind's theme, and a utility reads its token where it is used,
|
|
|
83
83
|
| `rounded-md` | The radii, by name only, so no bare `rounded`. `rounded-full` is Tailwind's own |
|
|
84
84
|
| `border-thin` | The border widths. There are no shadow utilities |
|
|
85
85
|
| `ease-standard`, `transition` | The easings. A transition takes `--ws-motion-duration-fast` |
|
|
86
|
-
| `max-lg:`
|
|
86
|
+
| `max-lg:`, `max-sm:` | The two breakpoints: below 64rem and below 40rem |
|
|
87
87
|
|
|
88
88
|
The entry takes out Tailwind's defaults that no token stands behind, as the system colors interface with its roles only and draws edges with borders, not shadows. As classes their utilities compile to nothing, with no error. In `@apply`, in the app's CSS or a component's `<style>` block, one fails the build with `Cannot apply unknown utility class`:
|
|
89
89
|
|
|
@@ -146,13 +146,14 @@ setTheme('system') // follows the system again
|
|
|
146
146
|
|
|
147
147
|
Run the head script before the stylesheet, so a remembered choice applies before the first paint. Inline `themeInitScript` in a `<script>`, or load it as a file: `<script src=".../theme/init.js"></script>`. It is a plain script, not a module.
|
|
148
148
|
|
|
149
|
-
A bundler does not copy a plain script out of `node_modules`, so in an app built with Vite inline both head scripts, this one and the one of the keys in section 7, with a plugin. They come from the installed package, so they stay in step with it:
|
|
149
|
+
A bundler does not copy a plain script out of `node_modules`, so in an app built with Vite inline both head scripts, this one and the one of the keys in section 7, with a plugin, and the theme-color tags below with them. They come from the installed package, so they stay in step with it:
|
|
150
150
|
|
|
151
151
|
```ts
|
|
152
152
|
// vite.config.ts
|
|
153
153
|
import { defineConfig, type Plugin } from 'vite'
|
|
154
154
|
import { keysInitScript } from '@whatsaaaa/design-system/shortcuts'
|
|
155
155
|
import { themeInitScript } from '@whatsaaaa/design-system/theme'
|
|
156
|
+
import { themeColorMeta } from '@whatsaaaa/design-system/theme/meta'
|
|
156
157
|
|
|
157
158
|
function designSystemHead(): Plugin {
|
|
158
159
|
return {
|
|
@@ -161,6 +162,11 @@ function designSystemHead(): Plugin {
|
|
|
161
162
|
// before Vite adds the stylesheet and the app's script to the <head>
|
|
162
163
|
order: 'pre',
|
|
163
164
|
handler: () => [
|
|
165
|
+
...themeColorMeta.map((attrs) => ({
|
|
166
|
+
tag: 'meta',
|
|
167
|
+
attrs: { ...attrs },
|
|
168
|
+
injectTo: 'head' as const,
|
|
169
|
+
})),
|
|
164
170
|
{ tag: 'script', children: themeInitScript, injectTo: 'head' },
|
|
165
171
|
{ tag: 'script', children: keysInitScript, injectTo: 'head' },
|
|
166
172
|
],
|
|
@@ -173,19 +179,21 @@ export default defineConfig({
|
|
|
173
179
|
})
|
|
174
180
|
```
|
|
175
181
|
|
|
176
|
-
The browser's own bars, such as a phone's address bar, take the background of the theme shown, `--ws-color-bg`. The head script keeps
|
|
182
|
+
The browser's own bars, such as a phone's address bar, take the background of the theme shown, `--ws-color-bg`. Put the two theme-color tags in the `<head>` the server sends: the background of the dark theme, and of the light one where the system asks for light, as the stylesheet chooses. So a visitor without JavaScript, and a link preview such as a chat app's, which reads the page as it is sent, get the color too. The dark tag comes first, for a reader that takes the first tag and ignores `media`. The head script then keeps every theme-color tag at the theme shown, from the first paint on, when the theme is chosen by hand, with `setTheme`, `toggleTheme` or anything else that sets `data-theme` or the class of `<html>`, and when the system's theme changes:
|
|
177
183
|
|
|
178
184
|
```html
|
|
179
185
|
<head>
|
|
180
186
|
<meta charset="utf-8" />
|
|
181
187
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
188
|
+
<meta name="theme-color" content="#191724" media="not all and (prefers-color-scheme: light)" />
|
|
189
|
+
<meta name="theme-color" content="#faf4ed" media="(prefers-color-scheme: light)" />
|
|
182
190
|
<script src=".../theme/init.js"></script>
|
|
183
191
|
<script src=".../shortcuts/init.js"></script>
|
|
184
192
|
<link rel="stylesheet" href=".../index.css" />
|
|
185
193
|
</head>
|
|
186
194
|
```
|
|
187
195
|
|
|
188
|
-
|
|
196
|
+
These are the only colors to write out by hand, as a `<meta>` cannot read a variable. Take them from the package where a build writes the `<head>`: `themeColorMeta` from `@whatsaaaa/design-system/theme/meta` is the attributes of the two tags, as in the Vite plugin above. It reads the tokens, so import it in the build or on the server, not in the page's own script. Without the tags the head script adds one, so a page still gets the color once its script runs. Do not set it from a script of your own. A docs site gets the tags and the script from the base config of the docs theme.
|
|
189
197
|
|
|
190
198
|
An element for one theme only, such as a cut of a mark, takes `ws-theme-dark` or `ws-theme-light`. Put both in the page and the styles show the one of the theme in effect where it stands: the nearest `data-theme` or `dark` or `light` class, on `<html>` or on an element around it, or the system's theme. So the right one shows before any script runs. Do not swap them from a script.
|
|
191
199
|
|
|
@@ -226,11 +234,12 @@ Do not load other fonts, and do not load these from a CDN. Set `font-variant-lig
|
|
|
226
234
|
## 5. Space, radius, motion
|
|
227
235
|
|
|
228
236
|
- Space: `--ws-space-2` to `--ws-space-64`, named by px, set in rem. Use them for padding, margin and gap.
|
|
229
|
-
-
|
|
237
|
+
- The gutter of a phone is `--ws-space-16`. Below 64rem the tab bar starts its brand that far in from the window's edge, and ends its end that far from the other. Pad what is under it by the same, a pane, a page or a form, and its content starts at the pixel the brand starts at. From 64rem a pane takes the padding of its own design.
|
|
238
|
+
- Sizes: `--ws-size-control` (40 px) is the height of a one-line field, a button and a segmented control. `--ws-size-check` (20 px) is a checkbox or a radio button, `--ws-size-step` (24 px) the circle of a step number and `--ws-size-icon` (16 px) an icon next to text. Use them for those, not a space token.
|
|
230
239
|
- Radius: `--ws-radius-xs` (key caps), `-sm` (inline code, tags), `-md` (inputs, buttons), `-lg` (blocks, cards), `-xl` (the window), `-full` (dots).
|
|
231
240
|
- Borders, not shadows: `--ws-border-width-thin`, `-medium`, `-thick`.
|
|
232
241
|
- Motion: `--ws-motion-duration-fast`, `-base`, `-slow` with `--ws-motion-easing-standard`. Wrap movement in `@media (prefers-reduced-motion: no-preference)`.
|
|
233
|
-
-
|
|
242
|
+
- Two breakpoints. Below `64rem`, `@media (width < 64rem)`, a page has one column, the tab bar wraps and headings take their compact sizes. Below `40rem`, `@media (width < 40rem)`, a row of fields stacks, one field to a line: from 40rem up two fields fit side by side.
|
|
234
243
|
|
|
235
244
|
## 6. Classes
|
|
236
245
|
|
|
@@ -240,7 +249,7 @@ Do not load other fonts, and do not load these from a CDN. Set `font-variant-lig
|
|
|
240
249
|
- Terminal frame: `ws-term` (the window), `ws-tab-bar` with `ws-tab-bar__brand`, `ws-tabs` and `ws-tab-bar__end`, `ws-prompt` for headings, `ws-output`, `ws-status-line`. Mark the current tab with `aria-current="page"`. The tabs are optional: a site of one page has nothing to tab to, and a tab that only reloads the page would lose what was typed in it. Its bar is the brand and the end.
|
|
241
250
|
- The path above a page title: `<p class="ws-crumb"><span>writing</span><span>form-builder</span><span>conditions</span></p>`, right before the `<h1>`. The slashes between the parts are drawn, and assistive technology reads a comma in their place, so the parts come out as words of their own. It comes with `prose.css`.
|
|
242
251
|
- Small pieces: `ws-kbd`, `ws-tag`, `ws-tag--outline`, `ws-state` with `--active` or `--experimental`, `ws-arrow`, `ws-cursor`, and `ws-visually-hidden` for text that only assistive technology reads.
|
|
243
|
-
- Forms: `ws-segmented` and `ws-pairs`. See [forms](#forms).
|
|
252
|
+
- Forms: `ws-segmented`, `ws-pairs` and `ws-pairs-group`. See [forms](#forms).
|
|
244
253
|
|
|
245
254
|
The markup of each piece is in the comment above its rules, in its stylesheet in `dist/css/` and in `dist/index.css`, and in the style guide.
|
|
246
255
|
|
|
@@ -262,7 +271,7 @@ The markup of each piece is in the comment above its rules, in its stylesheet in
|
|
|
262
271
|
```
|
|
263
272
|
|
|
264
273
|
- **The mode** says whether the key hints work. It reads `NORMAL`, and `INSERT` while the focus is in a field, where a key is typed and not a shortcut. Use those two words and no others. `isTyping` from `@whatsaaaa/design-system/shortcuts` tells which: check `isTyping(document.activeElement)` on `focusin` and `focusout`. A page without fields stays `NORMAL`.
|
|
265
|
-
- **The path** goes in `ws-status-line__path`, which takes the room the other items leave and puts the items after it at the right edge. The path gives way to them on its own: it is cut with an ellipsis,
|
|
274
|
+
- **The path** goes in `ws-status-line__path`, which takes the room the other items leave and puts the items after it at the right edge. The path gives way to them on its own: it is cut with an ellipsis, down to five characters, and with less room than that it goes as a whole. Write no breakpoint or width for it. The status line pads its items `--ws-space-14` on each side, and `--ws-space-10` below 64rem, so on a phone the path has more room. A status line without a path puts `<span class="ws-status-line__spacer"></span>` where the path would be.
|
|
266
275
|
- **The theme button** names the theme shown and switches it, at every width: below 64rem, where the key hints are hidden, it is the only theme switch. Call `toggleTheme` when it is clicked. It holds both names, and the styles show the one of the theme, so the name is right before any script runs and the button keeps the focus when the theme changes. Its name for assistive technology is "Switch theme, now rose-pine". Where the key hints show, keep the theme's `t` hint as well.
|
|
267
276
|
- An item for wide screens only takes `ws-status-line__item--wide`, and one with a border on its left `ws-status-line__item--edge`.
|
|
268
277
|
- A focus ring in the window's bars is drawn inside its control, so neither the bars nor the window's corners cut it off. A control of your own in a bar does the same: `outline-offset: calc(-1 * var(--ws-border-width-medium))`.
|
|
@@ -272,8 +281,10 @@ The markup of each piece is in the comment above its rules, in its stylesheet in
|
|
|
272
281
|
The system draws no fields and no buttons: draw them from the roles, with these.
|
|
273
282
|
|
|
274
283
|
- **One height.** A one-line field, a button and a segmented control are `--ws-size-control` tall. A checkbox or a radio button is `--ws-size-check`, a step number's circle `--ws-size-step`.
|
|
284
|
+
- **Rows of fields.** Fields that belong together, such as a date and a time, may share a row from 40rem up. Below it, `@media (width < 40rem)`, each takes a line of its own.
|
|
275
285
|
- **The primary button** is filled with `--ws-color-interactive`, its label `--ws-color-on-interactive`. Under the pointer it takes `--ws-color-interactive-hover`, while pressed `--ws-color-interactive-active`. Do not mix a hover color of your own.
|
|
276
|
-
- **A tick** is `--ws-icon-check` from `css/icons.css`, a mask like the other icons: a ticked box, a done step, a sent form. Draw it at
|
|
286
|
+
- **A tick** is `--ws-icon-check` from `css/icons.css`, a mask like the other icons: a ticked box, a done step, a sent form. Draw it at `--ws-size-icon` in `currentcolor`, or `--ws-color-on-interactive` on a checked box.
|
|
287
|
+
- **A date** has `--ws-icon-calendar`, such as on the button that opens a date picker, at `--ws-size-icon` in `currentcolor`. Do not draw your own.
|
|
277
288
|
- **A number field has no spin buttons.** `base.css` hides the browser's own, and the arrow keys still step the value. Without `base.css`, hide them the same way: `appearance: textfield` on the field, and `appearance: none` on its `::-webkit-inner-spin-button` and `::-webkit-outer-spin-button`.
|
|
278
289
|
|
|
279
290
|
A **segmented control** is a few buttons with one pressed, such as a switch between the languages of a page:
|
|
@@ -314,6 +325,26 @@ A **segmented control** is a few buttons with one pressed, such as a switch betw
|
|
|
314
325
|
|
|
315
326
|
- `ws-pairs--amounts` is for money and other numbers: each value at the right edge, in figures of one width, so the digits of the rows line up. Write each amount whole, with its currency and the same number of decimals.
|
|
316
327
|
- `ws-pairs__total` is the last row: set off by a solid rule, and semibold.
|
|
328
|
+
- **Sections that line up.** A review step of several sections, each a list under its own heading, puts them in one `ws-pairs-group`: the lists share a term column, as wide as the longest term of them all, so the values of every section start at one edge. Each heading, or anything else in the group, takes a row of its own. A list of amounts in the group keeps its own columns.
|
|
329
|
+
|
|
330
|
+
```html
|
|
331
|
+
<div class="ws-pairs-group">
|
|
332
|
+
<h3>About you</h3>
|
|
333
|
+
<dl class="ws-pairs">
|
|
334
|
+
<div>
|
|
335
|
+
<dt>Name</dt>
|
|
336
|
+
<dd>Milica Đorđević</dd>
|
|
337
|
+
</div>
|
|
338
|
+
</dl>
|
|
339
|
+
<h3>Your visit</h3>
|
|
340
|
+
<dl class="ws-pairs">
|
|
341
|
+
<div>
|
|
342
|
+
<dt>Workshop</dt>
|
|
343
|
+
<dd>Forms that check themselves</dd>
|
|
344
|
+
</div>
|
|
345
|
+
</dl>
|
|
346
|
+
</div>
|
|
347
|
+
```
|
|
317
348
|
|
|
318
349
|
### Code blocks
|
|
319
350
|
|
|
@@ -425,7 +456,7 @@ export default defineConfigWithTheme<ThemeConfig>({
|
|
|
425
456
|
|
|
426
457
|
Keep the site's nav, sidebar and search config as they are. Do not restyle the theme with `--vp-*` variables: change a token here instead.
|
|
427
458
|
|
|
428
|
-
From 60rem up the brand has a box as wide as the sidebar, 17rem with the sidebar's padding, and the first tab starts on the sidebar's border, on pages without a sidebar too. With a logo there is room for about
|
|
459
|
+
From 60rem up the brand has a box as wide as the sidebar, 17rem with the sidebar's padding, and the first tab starts on the sidebar's border, on pages without a sidebar too. With a logo there is room for about 24 characters in the site title, without one about 28. A longer title is cut with an ellipsis: shorten it with `themeConfig.siteTitle`. A short one leaves a gap before the tabs. The labels of the tabs have no such limit: a long one moves the tabs after it. Below 60rem there is no sidebar and the tabs follow the brand, and on a phone they take a row of their own under it. On a phone, below 48rem, the page, the row of its menu and the home page's hero, features and content take the gutter of a phone, as the brand does. The theme pulls a project's mark as the logo out by its empty columns, as in section 9, so its pixels start on that gutter too, and over the sidebar's headings from 60rem up.
|
|
429
460
|
|
|
430
461
|
## 11. Data
|
|
431
462
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@whatsaaaa/design-system",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.1",
|
|
4
4
|
"description": "Whatsaaaa's design system: brand identity, design tokens, typography, docs theme and asset kit",
|
|
5
5
|
"homepage": "https://github.com/whatsaaaa/design-system#readme",
|
|
6
6
|
"bugs": "https://github.com/whatsaaaa/design-system/issues",
|
|
@@ -45,6 +45,10 @@
|
|
|
45
45
|
"default": "./dist/theme/index.js"
|
|
46
46
|
},
|
|
47
47
|
"./theme/init.js": "./dist/theme/init.js",
|
|
48
|
+
"./theme/meta": {
|
|
49
|
+
"types": "./dist/theme/meta.d.ts",
|
|
50
|
+
"default": "./dist/theme/meta.js"
|
|
51
|
+
},
|
|
48
52
|
"./shortcuts": {
|
|
49
53
|
"types": "./dist/shortcuts/index.d.ts",
|
|
50
54
|
"default": "./dist/shortcuts/index.js"
|
|
@@ -166,20 +166,32 @@
|
|
|
166
166
|
color: var(--ws-code-text);
|
|
167
167
|
}
|
|
168
168
|
|
|
169
|
-
/*
|
|
169
|
+
/*
|
|
170
|
+
* A group of code blocks shares one frame, and its tabs are the caption: the language and
|
|
171
|
+
* the copy button of the block shown stand at its right end, as in the caption of a block on
|
|
172
|
+
* its own. The tabs end where the language starts, 6rem from the right as the file name of a
|
|
173
|
+
* block does, so a tab never runs under it. The frame draws the caption's background and its
|
|
174
|
+
* rule across the whole width.
|
|
175
|
+
*/
|
|
170
176
|
.vp-doc .vp-code-group {
|
|
171
177
|
margin-top: var(--ws-space-16);
|
|
172
178
|
overflow: hidden;
|
|
173
179
|
border: var(--ws-border-width-thin) solid var(--ws-code-border);
|
|
174
180
|
border-radius: var(--ws-radius-lg);
|
|
181
|
+
background: var(--ws-code-header-bg);
|
|
175
182
|
color-scheme: dark;
|
|
176
183
|
}
|
|
177
184
|
|
|
178
185
|
.vp-doc .vp-code-group .tabs {
|
|
179
|
-
margin: 0;
|
|
186
|
+
margin: 0 6rem 0 0;
|
|
180
187
|
padding: 0 var(--ws-space-8);
|
|
181
188
|
border-radius: 0;
|
|
182
|
-
|
|
189
|
+
background: none;
|
|
190
|
+
box-shadow: none;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
.vp-doc .vp-code-group .blocks {
|
|
194
|
+
box-shadow: 0 calc(-1 * var(--ws-border-width-thin)) var(--ws-code-border);
|
|
183
195
|
}
|
|
184
196
|
|
|
185
197
|
.vp-doc .vp-code-group .tabs label {
|
|
@@ -199,6 +211,7 @@
|
|
|
199
211
|
.vp-doc .vp-code-group div[class*='language-'] {
|
|
200
212
|
margin: 0;
|
|
201
213
|
padding-top: 0;
|
|
214
|
+
overflow: visible;
|
|
202
215
|
border: 0;
|
|
203
216
|
border-radius: 0;
|
|
204
217
|
}
|
|
@@ -208,12 +221,13 @@
|
|
|
208
221
|
display: none;
|
|
209
222
|
}
|
|
210
223
|
|
|
224
|
+
/* up into the row of the tabs: a caption's height and the rule under the tabs */
|
|
211
225
|
.vp-doc .vp-code-group div[class*='language-'] > span.lang {
|
|
212
|
-
top: var(--ws-
|
|
226
|
+
top: calc(-1 * (var(--ws-caption) + var(--ws-border-width-thin)));
|
|
213
227
|
}
|
|
214
228
|
|
|
215
229
|
.vp-doc .vp-code-group div[class*='language-'] > button.copy {
|
|
216
|
-
top: var(--ws-
|
|
230
|
+
top: calc(0.375rem - var(--ws-caption) - var(--ws-border-width-thin));
|
|
217
231
|
}
|
|
218
232
|
|
|
219
233
|
/* custom blocks: a bar in the status color, a label with an icon, then text */
|
|
@@ -266,8 +280,8 @@
|
|
|
266
280
|
|
|
267
281
|
.vp-doc .custom-block .custom-block-title::before {
|
|
268
282
|
flex: none;
|
|
269
|
-
width:
|
|
270
|
-
height:
|
|
283
|
+
width: var(--ws-size-icon);
|
|
284
|
+
height: var(--ws-size-icon);
|
|
271
285
|
background: currentcolor;
|
|
272
286
|
content: '';
|
|
273
287
|
mask: var(--ws-callout-icon) center / contain no-repeat;
|
|
@@ -45,3 +45,21 @@
|
|
|
45
45
|
border-radius: var(--ws-radius-md);
|
|
46
46
|
background: var(--ws-color-raised);
|
|
47
47
|
}
|
|
48
|
+
|
|
49
|
+
/*
|
|
50
|
+
* The gutter of a phone, as on every page: the hero, the cards of the features and the page's
|
|
51
|
+
* own content start where the brand does. The default theme pads them 24 px there, and 48 px
|
|
52
|
+
* from 40rem.
|
|
53
|
+
*/
|
|
54
|
+
@media (width < 48rem) {
|
|
55
|
+
.VPHome .VPHero.VPHero,
|
|
56
|
+
.VPHome .VPFeatures.VPFeatures,
|
|
57
|
+
.VPHome > .vp-doc.container {
|
|
58
|
+
padding-inline: var(--ws-space-16);
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/* the image of the hero reaches the edges of the window, through the gutter */
|
|
62
|
+
.VPHome .VPHero.VPHero .image {
|
|
63
|
+
margin-inline: calc(-1 * var(--ws-space-16));
|
|
64
|
+
}
|
|
65
|
+
}
|
|
@@ -22,7 +22,13 @@ body {
|
|
|
22
22
|
color: var(--ws-color-text);
|
|
23
23
|
}
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
/*
|
|
26
|
+
* The default theme gives a button the browser's own ring, as button:focus-visible, which
|
|
27
|
+
* weighs more than :focus-visible alone. A button takes the theme's ring too: a tab that opens
|
|
28
|
+
* a menu, the copy button of a code block, the controls of the status line.
|
|
29
|
+
*/
|
|
30
|
+
:focus-visible,
|
|
31
|
+
button:focus-visible {
|
|
26
32
|
outline: var(--ws-border-width-medium) solid var(--ws-color-interactive);
|
|
27
33
|
outline-offset: 2px;
|
|
28
34
|
}
|
|
@@ -40,11 +46,6 @@ body {
|
|
|
40
46
|
height: var(--ws-size-status-line);
|
|
41
47
|
}
|
|
42
48
|
|
|
43
|
-
/* VitePress gives a button the browser's own ring: the status line's controls take the theme's */
|
|
44
|
-
.WsStatusLine button:focus-visible {
|
|
45
|
-
outline: var(--ws-border-width-medium) solid var(--ws-color-interactive);
|
|
46
|
-
}
|
|
47
|
-
|
|
48
49
|
.WsStatusLine .WsStatusLine-pair {
|
|
49
50
|
gap: var(--ws-space-6);
|
|
50
51
|
}
|
|
@@ -65,6 +66,25 @@ body {
|
|
|
65
66
|
font: var(--ws-text-caption);
|
|
66
67
|
}
|
|
67
68
|
|
|
69
|
+
/*
|
|
70
|
+
* The gutter of a phone, 16 px, as in the terminal frame: below 48rem, where the default theme
|
|
71
|
+
* lays out for a phone, the page and the row of the menu start where the brand does and end
|
|
72
|
+
* where the lines of the menu button do. The default theme pads them 24 px.
|
|
73
|
+
*/
|
|
74
|
+
@media (width < 48rem) {
|
|
75
|
+
.VPDoc.VPDoc,
|
|
76
|
+
.VPFooter.VPFooter,
|
|
77
|
+
.VPLocalNav.VPLocalNav .menu,
|
|
78
|
+
.WsNotFound.WsNotFound {
|
|
79
|
+
padding-inline: var(--ws-space-16);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/* the chevron is drawn 4 px inside its box */
|
|
83
|
+
.VPLocalNav.VPLocalNav .VPLocalNavOutlineDropdown {
|
|
84
|
+
padding-right: var(--ws-space-12);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
|
|
68
88
|
/* skip link */
|
|
69
89
|
.VPSkipLink.VPSkipLink {
|
|
70
90
|
border-radius: var(--ws-radius-md);
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
}
|
|
19
19
|
|
|
20
20
|
.VPNav .VPNavBar .wrapper {
|
|
21
|
-
padding: 0 var(--ws-space-
|
|
21
|
+
padding: 0 var(--ws-space-16);
|
|
22
22
|
}
|
|
23
23
|
|
|
24
24
|
.VPNav .VPNavBar .wrapper > .container {
|
|
@@ -40,9 +40,15 @@
|
|
|
40
40
|
background: none;
|
|
41
41
|
}
|
|
42
42
|
|
|
43
|
-
/*
|
|
43
|
+
/*
|
|
44
|
+
* brand, with room for the focus ring of the link around the mark and the name, taken from
|
|
45
|
+
* the gutter at its left, as in the tab bar of the terminal frame
|
|
46
|
+
*/
|
|
44
47
|
.VPNav .VPNavBarTitle .title {
|
|
45
48
|
gap: var(--ws-space-10);
|
|
49
|
+
width: fit-content;
|
|
50
|
+
margin-left: calc(-1 * var(--ws-space-10));
|
|
51
|
+
padding-inline: var(--ws-space-10);
|
|
46
52
|
border-bottom: 0;
|
|
47
53
|
color: var(--ws-color-text);
|
|
48
54
|
font: var(--ws-text-label);
|
|
@@ -50,11 +56,16 @@
|
|
|
50
56
|
letter-spacing: -0.02em;
|
|
51
57
|
}
|
|
52
58
|
|
|
53
|
-
/*
|
|
59
|
+
/*
|
|
60
|
+
* A mark in a 64 box at 32 px draws each sprite pixel as 2 px. A project's mark keeps two
|
|
61
|
+
* empty sprite columns on each side, 4 px here: pulled out by them, its pixels start where
|
|
62
|
+
* the brand's text would, on the edge of the page on a phone and of the sidebar's text above.
|
|
63
|
+
*/
|
|
54
64
|
.VPNav .VPNavBarTitle .logo {
|
|
55
65
|
width: auto;
|
|
66
|
+
max-width: none;
|
|
56
67
|
height: 2rem;
|
|
57
|
-
margin-
|
|
68
|
+
margin-inline: calc(-1 * var(--ws-space-4));
|
|
58
69
|
image-rendering: pixelated;
|
|
59
70
|
}
|
|
60
71
|
|
|
@@ -105,6 +116,17 @@
|
|
|
105
116
|
visibility: hidden;
|
|
106
117
|
}
|
|
107
118
|
|
|
119
|
+
/*
|
|
120
|
+
* A tab, the button of a menu and the brand fill the bar from the top edge of the window,
|
|
121
|
+
* which cuts off what crosses it: their ring goes inside them, as in the tab bar of the
|
|
122
|
+
* terminal frame.
|
|
123
|
+
*/
|
|
124
|
+
.VPNav .VPNavBarTitle .title:focus-visible,
|
|
125
|
+
.VPNav .VPNavBarMenu .VPNavBarMenuLink:focus-visible,
|
|
126
|
+
.VPNav .VPNavBar .VPFlyout > .button:focus-visible {
|
|
127
|
+
outline-offset: calc(-1 * var(--ws-border-width-medium));
|
|
128
|
+
}
|
|
129
|
+
|
|
108
130
|
.VPNav .VPNavBarMenu .VPNavBarMenuLink:hover,
|
|
109
131
|
.VPNav .VPNavBarMenu .VPNavBarMenuGroup:hover .button {
|
|
110
132
|
color: var(--ws-color-text);
|
|
@@ -151,6 +173,16 @@
|
|
|
151
173
|
font-family: var(--ws-font-family-mono);
|
|
152
174
|
}
|
|
153
175
|
|
|
176
|
+
/*
|
|
177
|
+
* The default theme gives the search button the browser's ring, by a rule that weighs more than
|
|
178
|
+
* the theme's. On a phone the button fills its row of the bar from the top edge of the window,
|
|
179
|
+
* so its ring goes inside it, as the menu button's does.
|
|
180
|
+
*/
|
|
181
|
+
.VPNav .VPNavBarSearch .DocSearch-Button:focus-visible {
|
|
182
|
+
outline: var(--ws-border-width-medium) solid var(--ws-color-interactive);
|
|
183
|
+
outline-offset: calc(-1 * var(--ws-border-width-medium));
|
|
184
|
+
}
|
|
185
|
+
|
|
154
186
|
.VPNav .DocSearch-Button .DocSearch-Button-Placeholder {
|
|
155
187
|
margin: 0;
|
|
156
188
|
padding: 0;
|
|
@@ -217,6 +249,19 @@
|
|
|
217
249
|
background-color: var(--ws-color-text);
|
|
218
250
|
}
|
|
219
251
|
|
|
252
|
+
/*
|
|
253
|
+
* The menu button is wider than its lines by 16 px on each side: pulled out by that much, its
|
|
254
|
+
* lines end at the gutter, under the end of the page. Its ring goes inside it, at the edge of
|
|
255
|
+
* the window.
|
|
256
|
+
*/
|
|
257
|
+
.VPNav .VPNavBarHamburger {
|
|
258
|
+
margin-right: calc(-1 * var(--ws-space-16));
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
.VPNav .VPNavBarHamburger:focus-visible {
|
|
262
|
+
outline-offset: calc(-1 * var(--ws-border-width-medium));
|
|
263
|
+
}
|
|
264
|
+
|
|
220
265
|
@media (width >= 48rem) {
|
|
221
266
|
.VPNav .VPNavBar .wrapper,
|
|
222
267
|
.VPNav .VPNavBar.has-sidebar .wrapper {
|
|
@@ -273,7 +318,6 @@
|
|
|
273
318
|
/* with the focus it takes the color of the ring, as the field of the search dialog does */
|
|
274
319
|
.VPNav .VPNavBarSearch .DocSearch-Button:focus-visible {
|
|
275
320
|
border-color: var(--ws-color-interactive);
|
|
276
|
-
outline: var(--ws-border-width-medium) solid var(--ws-color-interactive);
|
|
277
321
|
outline-offset: 2px;
|
|
278
322
|
}
|
|
279
323
|
|
|
@@ -334,12 +378,14 @@
|
|
|
334
378
|
padding: 0 var(--ws-space-20) 0 0;
|
|
335
379
|
}
|
|
336
380
|
|
|
337
|
-
/*
|
|
381
|
+
/*
|
|
382
|
+
* A brand too long for the box is cut with an ellipsis. The room for the ring at the right
|
|
383
|
+
* of the link is taken from the padding of the box, so the brand keeps the whole box.
|
|
384
|
+
*/
|
|
338
385
|
.VPNav .VPNavBar .VPNavBarTitle .title {
|
|
339
|
-
width:
|
|
340
|
-
max-width: 100%;
|
|
386
|
+
max-width: calc(100% + 2 * var(--ws-space-10));
|
|
341
387
|
height: var(--vp-nav-height);
|
|
342
|
-
|
|
388
|
+
margin-right: calc(-1 * var(--ws-space-10));
|
|
343
389
|
}
|
|
344
390
|
|
|
345
391
|
.VPNav .VPNavBar .VPNavBarTitle .title > span {
|
|
@@ -121,6 +121,14 @@
|
|
|
121
121
|
padding: 0;
|
|
122
122
|
}
|
|
123
123
|
|
|
124
|
+
/*
|
|
125
|
+
* The row sticks to the top edge of the window as the page scrolls, so the ring of its menu
|
|
126
|
+
* button goes inside it.
|
|
127
|
+
*/
|
|
128
|
+
.VPLocalNav .menu:focus-visible {
|
|
129
|
+
outline-offset: calc(-1 * var(--ws-border-width-medium));
|
|
130
|
+
}
|
|
131
|
+
|
|
124
132
|
.VPLocalNav .VPLocalNavOutlineDropdown .items {
|
|
125
133
|
border: var(--ws-border-width-thin) solid var(--ws-color-border);
|
|
126
134
|
border-radius: var(--ws-radius-lg);
|
package/tokens/core.tokens.json
CHANGED
|
@@ -659,6 +659,13 @@
|
|
|
659
659
|
"unit": "rem"
|
|
660
660
|
},
|
|
661
661
|
"$description": "The number of a step in its circle."
|
|
662
|
+
},
|
|
663
|
+
"icon": {
|
|
664
|
+
"$value": {
|
|
665
|
+
"value": 1,
|
|
666
|
+
"unit": "rem"
|
|
667
|
+
},
|
|
668
|
+
"$description": "An icon next to text, such as a tick, the icon of a callout or a calendar."
|
|
662
669
|
}
|
|
663
670
|
},
|
|
664
671
|
"motion": {
|