@frontfactory/vitepress-theme 1.6.0 → 1.8.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.
Files changed (95) hide show
  1. package/CHANGELOG.md +214 -0
  2. package/README.md +160 -8
  3. package/config.d.ts +26 -1
  4. package/config.js +165 -21
  5. package/dist/style.css +1 -1
  6. package/node/llms.js +31 -0
  7. package/node/og.js +159 -0
  8. package/node/pages.js +154 -0
  9. package/node/rss.js +81 -0
  10. package/package.json +49 -26
  11. package/src/blog/posts.data.ts +46 -0
  12. package/src/components/FfBackToTop.vue +33 -10
  13. package/src/components/FfBanner.vue +42 -8
  14. package/src/components/FfCopyStatus.vue +64 -0
  15. package/src/components/FfDocMeta.vue +50 -46
  16. package/src/components/FfFeature.vue +18 -7
  17. package/src/components/FfFeedback.vue +96 -0
  18. package/src/components/FfFooter.vue +11 -5
  19. package/src/components/FfHero.vue +20 -10
  20. package/src/components/FfHeroCommand.vue +24 -27
  21. package/src/components/FfHomeSponsors.vue +2 -2
  22. package/src/components/FfNavBarTitle.vue +63 -0
  23. package/src/components/FfPost.vue +49 -0
  24. package/src/components/FfProgress.vue +69 -0
  25. package/src/components/FfVersionSwitcher.vue +20 -0
  26. package/src/composables/blog.ts +38 -0
  27. package/src/composables/options.ts +19 -14
  28. package/src/composables/relativeTime.ts +59 -0
  29. package/src/composables/tabs.ts +155 -0
  30. package/src/content/Api.vue +6 -2
  31. package/src/content/Badge.vue +26 -0
  32. package/src/content/Callout.vue +27 -0
  33. package/src/content/FileTree.vue +118 -0
  34. package/src/content/Tab.vue +11 -0
  35. package/src/content/Tabs.vue +74 -0
  36. package/src/content/Timeline.vue +19 -0
  37. package/src/content/TimelineItem.vue +37 -0
  38. package/src/content/timeline.ts +4 -0
  39. package/src/index.ts +37 -1
  40. package/src/internal.ts +7 -2
  41. package/src/layout/FfBlog.vue +62 -0
  42. package/src/layout/FfLayout.vue +17 -1
  43. package/src/styles/_base.scss +20 -5
  44. package/src/styles/_blocks.scss +25 -1
  45. package/src/styles/_blog.scss +131 -0
  46. package/src/styles/_breakpoints.scss +26 -0
  47. package/src/styles/_code.scss +5 -5
  48. package/src/styles/_content.scss +280 -12
  49. package/src/styles/_doc.scss +18 -5
  50. package/src/styles/_home.scss +37 -17
  51. package/src/styles/_motion.scss +22 -2
  52. package/src/styles/_nav.scss +81 -8
  53. package/src/styles/_print.scss +77 -0
  54. package/src/styles/_sidebar.scss +2 -2
  55. package/src/styles/_tokens.scss +75 -9
  56. package/src/styles/index.scss +2 -0
  57. package/src/types.ts +140 -2
  58. package/types/blog/posts.data.d.ts +14 -0
  59. package/types/components/FfBackToTop.vue.d.ts +3 -0
  60. package/types/components/FfBanner.vue.d.ts +3 -0
  61. package/types/components/FfCopyStatus.vue.d.ts +3 -0
  62. package/types/components/FfDocMeta.vue.d.ts +3 -0
  63. package/types/components/FfFeature.vue.d.ts +13 -0
  64. package/types/components/FfFeedback.vue.d.ts +3 -0
  65. package/types/components/FfFooter.vue.d.ts +3 -0
  66. package/types/components/FfHero.vue.d.ts +42 -0
  67. package/types/components/FfHeroCommand.vue.d.ts +9 -0
  68. package/types/components/FfHomeSponsors.vue.d.ts +19 -0
  69. package/types/components/FfNavBarTitle.vue.d.ts +17 -0
  70. package/types/components/FfPost.vue.d.ts +3 -0
  71. package/types/components/FfProgress.vue.d.ts +3 -0
  72. package/types/components/FfVersionSwitcher.vue.d.ts +3 -0
  73. package/types/composables/blog.d.ts +10 -0
  74. package/types/composables/link.d.ts +12 -0
  75. package/types/composables/options.d.ts +15 -0
  76. package/types/composables/relativeTime.d.ts +2 -0
  77. package/types/composables/tabs.d.ts +15 -0
  78. package/types/content/Api.vue.d.ts +27 -0
  79. package/types/content/Badge.vue.d.ts +21 -0
  80. package/types/content/Callout.vue.d.ts +24 -0
  81. package/types/content/Card.vue.d.ts +23 -0
  82. package/types/content/CardGrid.vue.d.ts +20 -0
  83. package/types/content/FileTree.vue.d.ts +6 -0
  84. package/types/content/Kbd.vue.d.ts +15 -0
  85. package/types/content/Steps.vue.d.ts +15 -0
  86. package/types/content/Tab.vue.d.ts +19 -0
  87. package/types/content/Tabs.vue.d.ts +7 -0
  88. package/types/content/Timeline.vue.d.ts +21 -0
  89. package/types/content/TimelineItem.vue.d.ts +21 -0
  90. package/types/content/timeline.d.ts +3 -0
  91. package/types/index.d.ts +25 -0
  92. package/types/internal.d.ts +9 -0
  93. package/types/layout/FfBlog.vue.d.ts +3 -0
  94. package/types/layout/FfLayout.vue.d.ts +23 -0
  95. package/types/types.d.ts +256 -0
@@ -0,0 +1,131 @@
1
+ // ============================================================================================= //
2
+ // BLOG //
3
+ // ============================================================================================= //
4
+
5
+ @use "breakpoints" as bp;
6
+ @use "theme" as mg;
7
+
8
+ .ff-theme {
9
+
10
+ // ----------------------------------------------------------------------------------------- //
11
+ // Index: one hairline-ruled row per post
12
+ // ----------------------------------------------------------------------------------------- //
13
+
14
+ .ff-blog {
15
+ max-width: #{mg.ref("layout-content")};
16
+ margin: 0 auto;
17
+ padding: 3rem 1.5rem 6rem;
18
+
19
+ @include bp.up("md") {
20
+ padding-top: 4.5rem;
21
+ }
22
+ }
23
+
24
+ .ff-blog-title {
25
+ margin: 0;
26
+ font-family: #{mg.ref("font-display")};
27
+ font-size: #{mg.ref("size-h1")};
28
+ font-weight: 620;
29
+ line-height: #{mg.ref("leading-tight")};
30
+ letter-spacing: -0.03em;
31
+ }
32
+
33
+ .ff-blog-lede {
34
+ margin: 1.25rem 0 0;
35
+ font-size: #{mg.ref("size-body")};
36
+ line-height: 1.65;
37
+ color: #{mg.ref("color-ink-muted")};
38
+ }
39
+
40
+ .ff-blog-list {
41
+ margin: 3rem 0 0;
42
+ padding: 0;
43
+ border-top: #{mg.ref("rule-width")} solid #{mg.ref("color-rule-strong")};
44
+ list-style: none;
45
+ }
46
+
47
+ .ff-blog-post {
48
+ padding: 2rem 0;
49
+ border-bottom: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
50
+ }
51
+
52
+ .ff-blog-meta,
53
+ .ff-post {
54
+ flex-wrap: wrap;
55
+ gap: 0.375rem 0.75rem;
56
+ }
57
+
58
+ .ff-blog-meta > * + *::before,
59
+ .ff-post-item + .ff-post-item::before {
60
+ content: "·";
61
+ margin-right: 0.75rem;
62
+ }
63
+
64
+ .ff-blog-post-title {
65
+ margin: 0.875rem 0 0;
66
+ font-family: #{mg.ref("font-display")};
67
+ font-size: #{mg.ref("size-h2")};
68
+ font-weight: 600;
69
+ line-height: 1.3;
70
+ letter-spacing: -0.02em;
71
+ }
72
+
73
+ .ff-blog-post-title a {
74
+ color: #{mg.ref("color-ink")};
75
+ text-decoration: none;
76
+ transition: color #{mg.ref("motion-duration")} #{mg.ref("motion-ease")};
77
+ }
78
+
79
+ .ff-blog-post-title a:hover {
80
+ color: #{mg.ref("color-accent")};
81
+ }
82
+
83
+ .ff-blog-excerpt {
84
+ margin: 0.75rem 0 0;
85
+ line-height: #{mg.ref("leading-body")};
86
+ color: #{mg.ref("color-ink-muted")};
87
+ }
88
+
89
+ // ----------------------------------------------------------------------------------------- //
90
+ // Post header, under the kicker
91
+ // ----------------------------------------------------------------------------------------- //
92
+
93
+ // The header takes over the closing rule of the kicker above it, so the two read as one block.
94
+
95
+ .ff-doc-meta:has(+ .ff-post) {
96
+ margin-bottom: 1rem;
97
+ padding-bottom: 0;
98
+ border-bottom: 0;
99
+ }
100
+
101
+ .ff-post {
102
+ display: flex;
103
+ margin-bottom: 1.5rem;
104
+ padding-bottom: 1rem;
105
+ border-bottom: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
106
+ }
107
+
108
+ .ff-post-author {
109
+ display: inline-flex;
110
+ align-items: center;
111
+ gap: 0.5rem;
112
+ }
113
+
114
+ .ff-post-author a {
115
+ color: inherit;
116
+ text-decoration: underline;
117
+ text-decoration-color: #{mg.ref("color-rule-strong")};
118
+ text-underline-offset: 0.25em;
119
+ }
120
+
121
+ .ff-post-author a:hover {
122
+ color: #{mg.ref("color-accent")};
123
+ }
124
+
125
+ .ff-post-avatar {
126
+ width: 1.25rem;
127
+ height: 1.25rem;
128
+ border-radius: 50%;
129
+ object-fit: cover;
130
+ }
131
+ }
@@ -0,0 +1,26 @@
1
+ // ============================================================================================= //
2
+ // BREAKPOINTS //
3
+ // ============================================================================================= //
4
+
5
+ @use "sass:map";
6
+
7
+ // The three widths every partial lays out against. Media queries cannot read custom properties,
8
+ // so these stay Sass values rather than --ff-* tokens.
9
+
10
+ $widths: (
11
+ "sm": 640px,
12
+ "md": 960px,
13
+ "lg": 1280px
14
+ );
15
+
16
+ @mixin up($name) {
17
+ @media (width >= map.get($widths, $name)) {
18
+ @content;
19
+ }
20
+ }
21
+
22
+ @mixin down($name) {
23
+ @media (width < map.get($widths, $name)) {
24
+ @content;
25
+ }
26
+ }
@@ -53,11 +53,8 @@
53
53
  border-radius: #{mg.ref("radius-sm")};
54
54
  background-color: transparent;
55
55
  background-size: 0.875rem;
56
- opacity: 0.55;
57
- }
58
56
 
59
- .vp-doc [class*="language-"]:hover > button.copy,
60
- .vp-doc [class*="language-"] > button.copy:focus {
57
+ // Fully opaque at rest: dimmed, the grey icon falls under the 3:1 non-text contrast minimum.
61
58
  opacity: 1;
62
59
  }
63
60
 
@@ -75,7 +72,7 @@
75
72
  font-family: #{mg.ref("font-mono")};
76
73
  font-size: #{mg.ref("size-label")};
77
74
  text-transform: uppercase;
78
- letter-spacing: 0.06em;
75
+ letter-spacing: #{mg.ref("tracking-label-tight")};
79
76
  }
80
77
 
81
78
  .vp-doc div[class*="language-"].line-numbers-mode {
@@ -111,8 +108,11 @@
111
108
  box-shadow: inset #{mg.ref("rule-accent-width")} 0 0 0 #{mg.ref("color-success")};
112
109
  }
113
110
 
111
+ // The default theme also fades a removed line to 0.7, which drops its tokens below 4.5:1; the
112
+ // rule and the "-" marker already say the line is gone.
114
113
  .vp-doc [class*="language-"] code .diff.remove {
115
114
  box-shadow: inset #{mg.ref("rule-accent-width")} 0 0 0 #{mg.ref("color-danger")};
115
+ opacity: 1;
116
116
  }
117
117
 
118
118
  // ----------------------------------------------------------------------------------------- //
@@ -2,6 +2,7 @@
2
2
  // THEME COMPONENTS //
3
3
  // ============================================================================================= //
4
4
 
5
+ @use "breakpoints" as bp;
5
6
  @use "theme" as mg;
6
7
 
7
8
  // The dismissal class is set on <html>, outside the themed root. It carries the themed root in the
@@ -141,20 +142,19 @@
141
142
  display: flex;
142
143
  align-items: center;
143
144
  justify-content: center;
144
- width: 1.5rem;
145
- height: 1.5rem;
145
+ width: 2rem;
146
+ height: 2rem;
146
147
  border-radius: #{mg.ref("radius-sm")};
147
148
  background: transparent;
148
- font-size: 1.125rem;
149
+ font-size: 1.25rem;
149
150
  line-height: 1;
150
151
  color: inherit;
151
- opacity: 0.6;
152
152
  transform: translateY(-50%);
153
153
  cursor: pointer;
154
154
  }
155
155
 
156
156
  .ff-banner-close:hover {
157
- opacity: 1;
157
+ background: color-mix(in srgb, currentcolor 18%, transparent);
158
158
  }
159
159
 
160
160
  // ----------------------------------------------------------------------------------------- //
@@ -162,6 +162,7 @@
162
162
  // ----------------------------------------------------------------------------------------- //
163
163
 
164
164
  .ff-doc-meta {
165
+ display: flex;
165
166
  flex-wrap: wrap;
166
167
  gap: 0.75rem;
167
168
  margin-bottom: 1.5rem;
@@ -174,6 +175,43 @@
174
175
  margin-right: 0.75rem;
175
176
  }
176
177
 
178
+ // Pushed to the end of the row and framed like the hero copy button, so it reads as a control
179
+ // rather than one more piece of metadata.
180
+
181
+ .ff-doc-meta-copy {
182
+ display: inline-flex;
183
+ align-items: center;
184
+ gap: 0.5em;
185
+ margin-left: auto;
186
+ padding: 0.375rem 0.625rem;
187
+ border: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
188
+ border-radius: #{mg.ref("radius-sm")};
189
+ background: transparent;
190
+ font: inherit;
191
+ letter-spacing: inherit;
192
+ text-transform: inherit;
193
+ color: inherit;
194
+ cursor: pointer;
195
+ }
196
+
197
+ .ff-doc-meta-copy::before {
198
+ content: "";
199
+ width: 0.875rem;
200
+ height: 0.875rem;
201
+ background: var(--vp-icon-copy) 50% / contain no-repeat;
202
+ }
203
+
204
+ .ff-doc-meta-copy:hover,
205
+ .ff-doc-meta-copy.copied {
206
+ border-color: #{mg.ref("color-rule-strong")};
207
+ background-color: #{mg.ref("color-surface-alt")};
208
+ color: #{mg.ref("color-ink")};
209
+ }
210
+
211
+ .ff-doc-meta-copy.copied::before {
212
+ background-image: var(--vp-icon-copied);
213
+ }
214
+
177
215
  // ----------------------------------------------------------------------------------------- //
178
216
  // Back to top
179
217
  // ----------------------------------------------------------------------------------------- //
@@ -192,10 +230,6 @@
192
230
  opacity: 0;
193
231
  transform: translateY(0.5rem);
194
232
  pointer-events: none;
195
- transition:
196
- opacity #{mg.ref("motion-duration")} #{mg.ref("motion-ease")},
197
- transform #{mg.ref("motion-duration")} #{mg.ref("motion-ease")},
198
- border-color #{mg.ref("motion-duration")} #{mg.ref("motion-ease")};
199
233
  }
200
234
 
201
235
  .ff-to-top.is-visible {
@@ -204,6 +238,62 @@
204
238
  pointer-events: auto;
205
239
  }
206
240
 
241
+ // ----------------------------------------------------------------------------------------- //
242
+ // Reading progress
243
+ // ----------------------------------------------------------------------------------------- //
244
+
245
+ // One step above the layout-top band, so it also covers the banner and the navigation.
246
+
247
+ .ff-progress {
248
+ position: fixed;
249
+ top: 0;
250
+ right: 0;
251
+ left: 0;
252
+ z-index: calc(var(--vp-z-index-layout-top) + 1);
253
+ height: 2px;
254
+ background: #{mg.ref("color-accent")};
255
+ transform-origin: left;
256
+ pointer-events: none;
257
+ }
258
+
259
+ // ----------------------------------------------------------------------------------------- //
260
+ // Page feedback
261
+ // ----------------------------------------------------------------------------------------- //
262
+
263
+ .ff-feedback {
264
+ display: flex;
265
+ flex-wrap: wrap;
266
+ align-items: center;
267
+ gap: 0.75rem 1rem;
268
+ margin-bottom: 1.5rem;
269
+ padding-top: 1.5rem;
270
+ border-top: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
271
+ }
272
+
273
+ .ff-feedback-question,
274
+ .ff-feedback-thanks {
275
+ margin: 0;
276
+ }
277
+
278
+ .ff-feedback-actions {
279
+ display: flex;
280
+ gap: 0.5rem;
281
+ }
282
+
283
+ .ff-feedback-button {
284
+ padding: 0.5rem 0.75rem;
285
+ border: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
286
+ border-radius: #{mg.ref("radius-sm")};
287
+ background: transparent;
288
+ color: #{mg.ref("color-ink-muted")};
289
+ cursor: pointer;
290
+ }
291
+
292
+ .ff-feedback-button:hover {
293
+ border-color: #{mg.ref("color-rule-strong")};
294
+ background: #{mg.ref("color-surface-alt")};
295
+ }
296
+
207
297
  // ----------------------------------------------------------------------------------------- //
208
298
  // Footer
209
299
  // ----------------------------------------------------------------------------------------- //
@@ -289,7 +379,7 @@
289
379
  margin: 0;
290
380
  }
291
381
 
292
- @media (width >= 768px) {
382
+ @include bp.up("sm") {
293
383
  .ff-footer {
294
384
  padding: 4rem 3rem 2.5rem;
295
385
  }
@@ -318,7 +408,6 @@
318
408
  border: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
319
409
  border-radius: #{mg.ref("radius-md")};
320
410
  background: #{mg.ref("color-surface")};
321
- transition: border-color #{mg.ref("motion-duration")} #{mg.ref("motion-ease")};
322
411
  }
323
412
 
324
413
  .vp-doc a.ff-card {
@@ -354,7 +443,7 @@
354
443
  color: #{mg.ref("color-ink-muted")};
355
444
  }
356
445
 
357
- @media (width <= 640px) {
446
+ @include bp.down("sm") {
358
447
  .vp-doc .ff-card-grid {
359
448
  grid-template-columns: minmax(0, 1fr);
360
449
  }
@@ -472,4 +561,183 @@
472
561
  text-align: center;
473
562
  color: #{mg.ref("color-ink-muted")};
474
563
  }
564
+
565
+ // ----------------------------------------------------------------------------------------- //
566
+ // Tabs
567
+ // ----------------------------------------------------------------------------------------- //
568
+
569
+ .vp-doc .ff-tabs {
570
+ margin: 1.5rem 0;
571
+ }
572
+
573
+ .vp-doc .ff-tabs-list {
574
+ display: flex;
575
+ flex-wrap: wrap;
576
+ margin-bottom: 1rem;
577
+ border-bottom: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
578
+ }
579
+
580
+ .vp-doc .ff-tabs-tab {
581
+ position: relative;
582
+ padding: 0 0.75rem 0.625rem;
583
+ border: 0;
584
+ background: transparent;
585
+ font-family: #{mg.ref("font-mono")};
586
+ font-size: #{mg.ref("size-label")};
587
+ font-weight: 500;
588
+ text-transform: uppercase;
589
+ letter-spacing: #{mg.ref("tracking-label")};
590
+ color: #{mg.ref("color-ink-faint")};
591
+ cursor: pointer;
592
+ transition: color #{mg.ref("motion-duration")} #{mg.ref("motion-ease")};
593
+ }
594
+
595
+ .vp-doc .ff-tabs-tab:first-child {
596
+ padding-left: 0;
597
+ }
598
+
599
+ .vp-doc .ff-tabs-tab::after {
600
+ position: absolute;
601
+ right: 0;
602
+ bottom: calc(#{mg.ref("rule-accent-width")} * -1);
603
+ left: 0;
604
+ height: #{mg.ref("rule-accent-width")};
605
+ background: transparent;
606
+ content: "";
607
+ transition: background-color #{mg.ref("motion-duration")} #{mg.ref("motion-ease")};
608
+ }
609
+
610
+ .vp-doc .ff-tabs-tab:hover,
611
+ .vp-doc .ff-tabs-tab.active {
612
+ color: #{mg.ref("color-ink")};
613
+ }
614
+
615
+ .vp-doc .ff-tabs-tab.active::after {
616
+ background: #{mg.ref("color-accent")};
617
+ }
618
+
619
+ // The first and last blocks of a panel carry their own margins, which would double up with
620
+ // the gap under the tab list.
621
+
622
+ .vp-doc .ff-tabs-panel > :first-child {
623
+ margin-top: 0;
624
+ }
625
+
626
+ .vp-doc .ff-tabs-panel > :last-child {
627
+ margin-bottom: 0;
628
+ }
629
+
630
+ // ----------------------------------------------------------------------------------------- //
631
+ // File tree
632
+ // ----------------------------------------------------------------------------------------- //
633
+
634
+ .vp-doc .ff-filetree {
635
+ margin: 1.75rem 0;
636
+ font-family: #{mg.ref("font-mono")};
637
+ font-size: 0.875rem;
638
+ }
639
+
640
+ .vp-doc .ff-filetree ul {
641
+ margin: 0;
642
+ padding: 0;
643
+ list-style: none;
644
+ }
645
+
646
+ // Each level hangs from a hairline guide, like the rail of the steps.
647
+
648
+ .vp-doc .ff-filetree ul ul {
649
+ margin-left: 0.5rem;
650
+ padding-left: 1rem;
651
+ border-left: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
652
+ }
653
+
654
+ .vp-doc .ff-filetree li {
655
+ margin: 0;
656
+ padding: 0.125rem 0;
657
+ line-height: 1.6;
658
+ }
659
+
660
+ .vp-doc .ff-filetree .is-file > .ff-filetree-name {
661
+ color: #{mg.ref("color-ink-muted")};
662
+ }
663
+
664
+ .vp-doc .ff-filetree .is-folder > .ff-filetree-name {
665
+ font-weight: 500;
666
+ color: #{mg.ref("color-ink")};
667
+ }
668
+
669
+ .vp-doc .ff-filetree .is-folder > .ff-filetree-name::after {
670
+ content: "/";
671
+ color: #{mg.ref("color-ink-faint")};
672
+ }
673
+
674
+ .vp-doc .ff-filetree code {
675
+ padding: 0;
676
+ background: transparent;
677
+ font-size: inherit;
678
+ color: inherit;
679
+ }
680
+
681
+ // ----------------------------------------------------------------------------------------- //
682
+ // Timeline
683
+ // ----------------------------------------------------------------------------------------- //
684
+
685
+ // The same ruled rail as the steps, with a square marker on the line instead of a number.
686
+
687
+ .vp-doc .ff-timeline {
688
+ margin: 1.75rem 0;
689
+ padding-left: 2.5rem;
690
+ border-left: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
691
+ }
692
+
693
+ .vp-doc .ff-timeline-item {
694
+ position: relative;
695
+ padding-bottom: 1.75rem;
696
+ }
697
+
698
+ .vp-doc .ff-timeline-item:last-child {
699
+ padding-bottom: 0;
700
+ }
701
+
702
+ .vp-doc .ff-timeline-item::before {
703
+ position: absolute;
704
+ top: 0.3125rem;
705
+ left: -2.8125rem;
706
+ width: 0.625rem;
707
+ height: 0.625rem;
708
+ border: #{mg.ref("rule-accent-width")} solid #{mg.ref("color-accent")};
709
+ background: #{mg.ref("color-paper")};
710
+ content: "";
711
+ }
712
+
713
+ .vp-doc .ff-timeline-date {
714
+ margin: 0;
715
+ font-family: #{mg.ref("font-mono")};
716
+ font-size: #{mg.ref("size-label")};
717
+ text-transform: uppercase;
718
+ letter-spacing: #{mg.ref("tracking-label")};
719
+ color: #{mg.ref("color-ink-faint")};
720
+ }
721
+
722
+ .vp-doc .ff-timeline-title {
723
+ margin: 0.25rem 0 0;
724
+ padding: 0;
725
+ border: 0;
726
+ font-family: #{mg.ref("font-display")};
727
+ font-size: 1.0625rem;
728
+
729
+ // Pinned rather than inherited: the title can be any heading level (see Timeline `level`).
730
+ font-weight: 600;
731
+ font-variation-settings: "opsz" 32;
732
+ line-height: 1.75rem;
733
+ letter-spacing: normal;
734
+ }
735
+
736
+ .vp-doc .ff-timeline-body > :first-child {
737
+ margin-top: 0.5rem;
738
+ }
739
+
740
+ .vp-doc .ff-timeline-body > :last-child {
741
+ margin-bottom: 0;
742
+ }
475
743
  }
@@ -2,6 +2,7 @@
2
2
  // DOCUMENT //
3
3
  // ============================================================================================= //
4
4
 
5
+ @use "breakpoints" as bp;
5
6
  @use "theme" as mg;
6
7
 
7
8
  // The frame: the band every page lives in.
@@ -13,7 +14,7 @@
13
14
 
14
15
 
15
16
  .ff-theme {
16
- @media (width >= 960px) {
17
+ @include bp.up("md") {
17
18
  .VPSidebar {
18
19
  padding-left: var(--ff-frame);
19
20
  width: calc(var(--ff-frame) + var(--vp-sidebar-width));
@@ -39,7 +40,7 @@
39
40
  // The outline lives in a container of a fixed width, so the column that holds it must never be
40
41
  // squeezed by the text: it would spill out of the band, past the bar above it.
41
42
 
42
- @media (width >= 1280px) {
43
+ @include bp.up("lg") {
43
44
  .VPDoc .aside {
44
45
  flex: 0 0 auto;
45
46
  width: 16rem;
@@ -67,6 +68,19 @@
67
68
  max-width: none;
68
69
  }
69
70
 
71
+ // `wide: true` in the frontmatter: wide tables and API listings take the full band and give the
72
+ // outline column back.
73
+
74
+ &[data-layout="wide"] {
75
+ .VPDoc .content-container {
76
+ max-width: #{mg.ref("layout-wide")};
77
+ }
78
+
79
+ .VPDoc .aside {
80
+ display: none;
81
+ }
82
+ }
83
+
70
84
  // ----------------------------------------------------------------------------------------- //
71
85
  // Headings
72
86
  // ----------------------------------------------------------------------------------------- //
@@ -176,7 +190,7 @@
176
190
  color: #{mg.ref("color-accent")};
177
191
  text-decoration-thickness: 1px;
178
192
  text-underline-offset: 0.2em;
179
- text-decoration-color: #{mg.ref("color-accent-soft")};
193
+ text-decoration-color: color-mix(in srgb, #{mg.ref("color-accent")} 55%, transparent);
180
194
  transition: text-decoration-color #{mg.ref("motion-duration")} #{mg.ref("motion-ease")};
181
195
  }
182
196
 
@@ -375,7 +389,7 @@
375
389
  font-weight: 600;
376
390
  line-height: 1.4;
377
391
  text-transform: uppercase;
378
- letter-spacing: 0.08em;
392
+ letter-spacing: #{mg.ref("tracking-label-wide")};
379
393
  color: #{mg.ref("color-ink")};
380
394
  }
381
395
 
@@ -395,7 +409,6 @@
395
409
  white-space: normal;
396
410
  overflow: visible;
397
411
  overflow-wrap: break-word;
398
- transition: color #{mg.ref("motion-duration")} #{mg.ref("motion-ease")};
399
412
  }
400
413
 
401
414
  .VPDocAsideOutline .outline-link:hover {