@frontfactory/vitepress-theme 1.4.2 → 1.5.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.
@@ -5,6 +5,7 @@
5
5
  @use "theme" as mg;
6
6
 
7
7
  .ff-theme {
8
+
8
9
  // ----------------------------------------------------------------------------------------- //
9
10
  // Hero
10
11
  //
@@ -101,6 +102,7 @@
101
102
  font-family: #{mg.ref("font-title")};
102
103
  font-size: #{mg.ref("size-hero")};
103
104
  font-weight: 600;
105
+
104
106
  // Capitals on a monospaced face put every glyph on the same square cell — the blockiest
105
107
  // the headline can get without shipping a webfont. A monospaced face already sets its own
106
108
  // cell width, so at this size the capitals need no tracking added on top. The word gap is
@@ -161,7 +163,7 @@
161
163
  border: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
162
164
  border-radius: #{mg.ref("radius-md")};
163
165
  background: #{mg.ref("color-surface")};
164
- box-shadow: 0 1.5rem 3rem rgb(0 0 0 / 5%);
166
+ box-shadow: 0 1.5rem 3rem rgb(0 0 0 / 0.05);
165
167
  }
166
168
 
167
169
  .ff-hero-panel-label {
@@ -340,6 +342,7 @@
340
342
  display: flex;
341
343
  align-items: center;
342
344
  justify-content: center;
345
+
343
346
  // Caps it against the viewport rather than the column: at narrow widths the column itself
344
347
  // is the limit; past 960px the column is half the hero, wide enough that this is the one
345
348
  // that bites, so the image can run as large as the site's own picture allows.
@@ -351,7 +354,7 @@
351
354
  height: auto;
352
355
  }
353
356
 
354
- @media (min-width: 960px) {
357
+ @media (width >= 960px) {
355
358
  .ff-hero-image {
356
359
  max-width: none;
357
360
  }
@@ -395,13 +398,13 @@
395
398
  color: #{mg.ref("color-ink")};
396
399
  }
397
400
 
398
- @media (min-width: 640px) {
401
+ @media (width >= 640px) {
399
402
  .ff-hero {
400
403
  padding: calc(var(--ff-hero-offset) + 2rem) 3rem 4rem;
401
404
  }
402
405
  }
403
406
 
404
- @media (min-width: 960px) {
407
+ @media (width >= 960px) {
405
408
  .ff-hero {
406
409
  padding: calc(var(--ff-hero-offset) + 2.25rem) 4rem 4.5rem;
407
410
  }
@@ -438,27 +441,41 @@
438
441
  border-radius: #{mg.ref("radius-sm")};
439
442
  font-size: 0.875rem;
440
443
  font-weight: 550;
444
+ text-decoration: none;
441
445
  white-space: nowrap;
442
446
  }
443
447
 
444
- .ff-btn-brand {
448
+ // The sponsors button is the one `.ff-btn` that lands inside `.vp-doc` — `.ff-theme .vp-doc a`
449
+ // (see _doc.scss) sets prose-link weight and colour there, at a higher specificity than a bare
450
+ // `.ff-btn`/`.ff-btn-brand` class reaches on its own (an extra `a` in its selector). Scoping
451
+ // this rule to `.vp-doc` and compounding the modifiers onto `.ff-btn` below both add the class
452
+ // this needs to outrank it.
453
+
454
+ .vp-doc .ff-btn {
455
+ font-weight: 550;
456
+ text-decoration: none;
457
+ }
458
+
459
+ .ff-btn.ff-btn-brand {
445
460
  border-color: #{mg.ref("color-accent")};
446
461
  background: #{mg.ref("color-accent")};
447
462
  color: #{mg.ref("color-accent-contrast")};
448
463
  }
449
464
 
450
- .ff-btn-brand:hover {
465
+ .ff-btn.ff-btn-brand:hover {
451
466
  border-color: #{mg.ref("color-accent-hover")};
452
467
  background: #{mg.ref("color-accent-hover")};
468
+ color: #{mg.ref("color-accent-contrast")};
453
469
  }
454
470
 
455
- .ff-btn-alt {
471
+ .ff-btn.ff-btn-alt {
456
472
  border-color: #{mg.ref("color-rule-strong")};
457
473
  color: #{mg.ref("color-ink")};
458
474
  }
459
475
 
460
- .ff-btn-alt:hover {
476
+ .ff-btn.ff-btn-alt:hover {
461
477
  border-color: #{mg.ref("color-ink")};
478
+ color: #{mg.ref("color-ink")};
462
479
  }
463
480
 
464
481
  // ----------------------------------------------------------------------------------------- //
@@ -572,7 +589,7 @@
572
589
  color: #{mg.ref("color-accent")};
573
590
  }
574
591
 
575
- @media (min-width: 640px) {
592
+ @media (width >= 640px) {
576
593
  .VPFeatures {
577
594
  padding: 3rem 3rem 3.5rem;
578
595
  }
@@ -582,7 +599,7 @@
582
599
  }
583
600
  }
584
601
 
585
- @media (min-width: 960px) {
602
+ @media (width >= 960px) {
586
603
  .VPFeatures {
587
604
  padding: 3.5rem 4rem 4rem;
588
605
  }
@@ -596,4 +613,143 @@
596
613
  grid-template-columns: repeat(4, minmax(0, 1fr));
597
614
  }
598
615
  }
616
+
617
+ // ----------------------------------------------------------------------------------------- //
618
+ // Sponsors
619
+ //
620
+ // A closing section under the features: a title, an optional line of thanks, then the grid
621
+ // itself — the default theme's own components (see FfHomeSponsors), restyled onto the theme's
622
+ // own radius and heading tokens rather than the default's pill tier and 1rem-rounded card.
623
+ // Centred throughout, including the grid — flex-wrap content ignores the container's own
624
+ // text-align, so it needs its own justify-content to actually sit in the middle.
625
+ // ----------------------------------------------------------------------------------------- //
626
+
627
+ .ff-sponsors {
628
+
629
+ // Matches `.VPFeatures`'s own padding exactly, top/bottom included, so the two sections
630
+ // read as one continuous rhythm rather than the sponsors block sitting noticeably taller.
631
+ padding: 2.5rem 1.5rem 3rem;
632
+ border-top: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
633
+ }
634
+
635
+ // The default theme bleeds `.VPHomeSponsors` to the full *viewport* width inside `.vp-doc` (see
636
+ // VPHomeContent.vue) via `calc(50% - 50vw)` — `vw` counts the scrollbar, `.VPFeatures` doesn't,
637
+ // so the two sections' edges landed a scrollbar's-width apart. Replaced with a
638
+ // bleed sized to `.vp-doc .container`'s own padding instead (same breakpoints, matched below):
639
+ // exactly cancels that padding rather than approximating the viewport, so this section's edges
640
+ // land exactly on `.VPFeatures`'s, which carries no such container to escape in the first place.
641
+
642
+ .vp-doc .VPHomeSponsors.ff-sponsors {
643
+ margin-left: -1.5rem;
644
+ margin-right: -1.5rem;
645
+ }
646
+
647
+ .ff-sponsors-container {
648
+ max-width: #{mg.ref("layout-wide")};
649
+ margin: 0 auto;
650
+ text-align: center;
651
+ }
652
+
653
+ // Borrows the hero headline's voice — mono, uppercase, tight word-spacing — rather than the
654
+ // doc prose treatment `.vp-doc h2` (see _doc.scss) would otherwise give it. Scoped through
655
+ // `.vp-doc` (not just `.ff-sponsors-title` alone): `.ff-theme .vp-doc h2` carries an extra `h2`
656
+ // in its selector, which outranks a single bare class on specificity.
657
+
658
+ .vp-doc .ff-sponsors-title {
659
+ margin: 0;
660
+ border-top: 0;
661
+ padding-top: 0;
662
+ font-family: #{mg.ref("font-title")};
663
+ font-size: #{mg.ref("size-h1")};
664
+ font-weight: 600;
665
+ letter-spacing: 0;
666
+ word-spacing: -0.3em;
667
+ text-transform: uppercase;
668
+ color: #{mg.ref("color-ink")};
669
+
670
+ // Drops the optical-size axis .ff-display sets for Inter — same reasoning as the hero title.
671
+ font-variation-settings: normal;
672
+ }
673
+
674
+ .ff-sponsors-message {
675
+
676
+ // Matches `.ff-hero-tagline`'s measure — 32ch was breaking this sentence into an unbalanced
677
+ // two-line stub.
678
+ max-width: 42ch;
679
+ margin: 0.75rem auto 0;
680
+ font-size: #{mg.ref("size-body")};
681
+ line-height: 1.55;
682
+ color: #{mg.ref("color-ink-muted")};
683
+ }
684
+
685
+ .ff-sponsors-grid {
686
+ margin-top: 2rem;
687
+ }
688
+
689
+ .ff-sponsors-grid.vp-sponsor {
690
+ border-radius: #{mg.ref("radius-md")};
691
+ }
692
+
693
+ .ff-sponsors-grid .vp-sponsor-grid {
694
+ justify-content: center;
695
+ }
696
+
697
+ // The default theme's size presets (`.medium`, `.big`, …) grow the tile far faster than the
698
+ // logo inside it — `.big` triples the tile's height for one extra rem of logo — leaving mostly
699
+ // dead padding. Fixed values here instead, sized so the mark actually fills its tile.
700
+
701
+ .ff-sponsors-grid .vp-sponsor-grid-link {
702
+ min-height: 90px;
703
+ }
704
+
705
+ .ff-sponsors-grid .vp-sponsor-grid-image {
706
+ max-width: 120px;
707
+ max-height: 32px;
708
+ }
709
+
710
+ // Same background band as the default (`--vp-c-bg-soft`, already remapped to the theme's own
711
+ // surface token), left-aligned and fixed-height instead of the default's centred auto-height
712
+ // pill, with the theme's own label typography (mono, uppercase, tracked).
713
+
714
+ .ff-sponsors-grid .vp-sponsor-tier {
715
+ display: flex;
716
+ align-items: center;
717
+ justify-content: flex-start;
718
+ height: 60px;
719
+ margin: 0 0 0.25rem;
720
+ padding: 0 1.25rem;
721
+ font-family: #{mg.ref("font-mono")};
722
+ font-size: 14px;
723
+ font-weight: 500;
724
+ letter-spacing: #{mg.ref("tracking-label")};
725
+ text-align: left;
726
+ text-transform: uppercase;
727
+ color: #{mg.ref("color-ink-faint")};
728
+ }
729
+
730
+ .ff-sponsors-action {
731
+ margin-top: 2rem;
732
+ }
733
+
734
+ @media (width >= 640px) {
735
+ .ff-sponsors {
736
+ padding: 3rem 3rem 3.5rem;
737
+ }
738
+
739
+ .vp-doc .VPHomeSponsors.ff-sponsors {
740
+ margin-left: -3rem;
741
+ margin-right: -3rem;
742
+ }
743
+ }
744
+
745
+ @media (width >= 960px) {
746
+ .ff-sponsors {
747
+ padding: 3.5rem 4rem 4rem;
748
+ }
749
+
750
+ .vp-doc .VPHomeSponsors.ff-sponsors {
751
+ margin-left: -4rem;
752
+ margin-right: -4rem;
753
+ }
754
+ }
599
755
  }
@@ -32,6 +32,7 @@
32
32
 
33
33
  @media (prefers-reduced-motion: no-preference) {
34
34
  .ff-theme {
35
+
35
36
  // ------------------------------------------------------------------------------------- //
36
37
  // The hero lights up and settles
37
38
  // ------------------------------------------------------------------------------------- //
@@ -5,6 +5,7 @@
5
5
  @use "theme" as mg;
6
6
 
7
7
  .ff-theme {
8
+
8
9
  // ----------------------------------------------------------------------------------------- //
9
10
  // Top bar
10
11
  // ----------------------------------------------------------------------------------------- //
@@ -36,7 +37,7 @@
36
37
  margin-top: 0;
37
38
  }
38
39
 
39
- @media (min-width: 960px) {
40
+ @media (width >= 960px) {
40
41
  &[data-nav-sticky="false"] .VPContent {
41
42
  padding-top: 0;
42
43
  }
@@ -56,6 +57,7 @@
56
57
  .menu {
57
58
  order: 1;
58
59
  flex-grow: 0;
60
+
59
61
  // Search owes its own breathing room from the title to its box's border and padding;
60
62
  // plain text links have neither, so without this they sit right against the title.
61
63
  margin-left: 1.5rem;
@@ -105,13 +107,13 @@
105
107
  // The gutters have to match the ones the hero uses, or the bar lands a few pixels off the
106
108
  // content it sits above.
107
109
 
108
- @media (min-width: 640px) {
110
+ @media (width >= 640px) {
109
111
  .VPNavBar:not(.has-sidebar) .wrapper {
110
112
  padding: 0 3rem;
111
113
  }
112
114
  }
113
115
 
114
- @media (min-width: 960px) {
116
+ @media (width >= 960px) {
115
117
  .VPNavBar:not(.has-sidebar) .wrapper {
116
118
  padding: 0 4rem;
117
119
  }
@@ -5,6 +5,7 @@
5
5
  @use "theme" as mg;
6
6
 
7
7
  .ff-theme {
8
+
8
9
  // The top padding of the sidebar is what the sticky curtain is aligned on — the breathing room
9
10
  // goes on the first group instead.
10
11
 
@@ -13,10 +13,10 @@
13
13
 
14
14
  $scales: (
15
15
  "font": (
16
- "display": (Inter, ui-sans-serif, system-ui, sans-serif),
16
+ "display": (inter, ui-sans-serif, system-ui, sans-serif),
17
17
 
18
- // The hero headline only. It borrows the mono the theme already speaks in its labels,
19
- // section numbers and install line, so the front page sounds like the tool it documents.
18
+ /* The hero headline only. It borrows the mono the theme already speaks in its labels,*/
19
+ /* section numbers and install line, so the front page sounds like the tool it documents.*/
20
20
  "title": var(--vp-font-family-mono),
21
21
 
22
22
  "body": var(--vp-font-family-base),
@@ -57,9 +57,9 @@ $scales: (
57
57
  "height": 2.6875rem
58
58
  ),
59
59
 
60
- // The two washes of light behind the hero. Off by default: they are a house style, not a
61
- // structural part of the layout, and they read as noise under a headline that is already
62
- // carried by its type. A site opts in by setting this to 1, or to anything in between.
60
+ /* The two washes of light behind the hero. Off by default: they are a house style, not a*/
61
+ /* structural part of the layout, and they read as noise under a headline that is already*/
62
+ /* carried by its type. A site opts in by setting this to 1, or to anything in between.*/
63
63
  "hero": (
64
64
  "glow-opacity": 0
65
65
  ),
@@ -79,7 +79,7 @@ $scales: (
79
79
  $light: (
80
80
  "color": (
81
81
  "paper": #fbfaf8,
82
- "surface": #ffffff,
82
+ "surface": #fff,
83
83
  "surface-alt": #f4f2ee,
84
84
  "ink": #1a1917,
85
85
  "ink-muted": #55524c,
@@ -88,9 +88,9 @@ $light: (
88
88
  "rule-strong": #d3cec4,
89
89
  "accent": #2745cf,
90
90
  "accent-hover": #1b34a8,
91
- "accent-contrast": #ffffff,
92
- "accent-soft": rgba(39, 69, 207, 0.09),
93
- "accent-glow": rgba(39, 69, 207, 0.16),
91
+ "accent-contrast": #fff,
92
+ "accent-soft": rgb(39 69 207 / 0.09),
93
+ "accent-glow": rgb(39 69 207 / 0.16),
94
94
  "success": #1c7a52,
95
95
  "warning": #8a5a00,
96
96
  "danger": #b32835
@@ -110,8 +110,8 @@ $dark: (
110
110
  "accent": #94a8ff,
111
111
  "accent-hover": #b5c2ff,
112
112
  "accent-contrast": #101018,
113
- "accent-soft": rgba(148, 168, 255, 0.13),
114
- "accent-glow": rgba(148, 168, 255, 0.2),
113
+ "accent-soft": rgb(148 168 255 / 0.13),
114
+ "accent-glow": rgb(148 168 255 / 0.2),
115
115
  "success": #4ac48b,
116
116
  "warning": #e0a942,
117
117
  "danger": #f0707f
@@ -147,25 +147,20 @@ $dark: (
147
147
  --vp-c-bg-alt: #{mg.ref("color-surface-alt")};
148
148
  --vp-c-bg-elv: #{mg.ref("color-surface")};
149
149
  --vp-c-bg-soft: #{mg.ref("color-surface-alt")};
150
-
151
150
  --vp-c-text-1: #{mg.ref("color-ink")};
152
151
  --vp-c-text-2: #{mg.ref("color-ink-muted")};
153
152
  --vp-c-text-3: #{mg.ref("color-ink-faint")};
154
-
155
153
  --vp-c-border: #{mg.ref("color-rule-strong")};
156
154
  --vp-c-divider: #{mg.ref("color-rule")};
157
155
  --vp-c-gutter: #{mg.ref("color-rule")};
158
-
159
156
  --vp-c-brand-1: #{mg.ref("color-accent")};
160
157
  --vp-c-brand-2: #{mg.ref("color-accent-hover")};
161
158
  --vp-c-brand-3: #{mg.ref("color-accent")};
162
159
  --vp-c-brand-soft: #{mg.ref("color-accent-soft")};
163
-
164
160
  --vp-c-default-1: #{mg.ref("color-rule-strong")};
165
161
  --vp-c-default-2: #{mg.ref("color-rule")};
166
162
  --vp-c-default-3: #{mg.ref("color-surface-alt")};
167
163
  --vp-c-default-soft: #{mg.ref("color-accent-soft")};
168
-
169
164
  --vp-c-tip-1: #{mg.ref("color-accent")};
170
165
  --vp-c-tip-soft: transparent;
171
166
  --vp-c-note-1: #{mg.ref("color-accent")};
@@ -184,9 +179,9 @@ $dark: (
184
179
  /* Elevation is a hairline job here — only overlays keep a shadow. */
185
180
  --vp-shadow-1: none;
186
181
  --vp-shadow-2: none;
187
- --vp-shadow-3: 0 16px 40px rgb(0 0 0 / 8%);
188
- --vp-shadow-4: 0 16px 40px rgb(0 0 0 / 10%);
189
- --vp-shadow-5: 0 24px 64px rgb(0 0 0 / 12%);
182
+ --vp-shadow-3: 0 16px 40px rgb(0 0 0 / 0.08);
183
+ --vp-shadow-4: 0 16px 40px rgb(0 0 0 / 0.1);
184
+ --vp-shadow-5: 0 24px 64px rgb(0 0 0 / 0.12);
190
185
 
191
186
  /**
192
187
  * Distance from the edge of the viewport to the content band — the frame the whole theme is
@@ -194,7 +189,6 @@ $dark: (
194
189
  * percentage resolves where the property is used.
195
190
  */
196
191
  --ff-frame: max(4rem, calc((100% - #{mg.ref("layout-wide")}) / 2));
197
-
198
192
  --vp-nav-height: 60px;
199
193
 
200
194
  /**
@@ -206,7 +200,6 @@ $dark: (
206
200
  --vp-layout-max-width: 76rem;
207
201
  --vp-sidebar-width: 15rem;
208
202
  --vp-header-anchor-symbol: "#";
209
-
210
203
  --vp-code-font-size: 0.8125em;
211
204
  --vp-code-color: #{mg.ref("color-ink")};
212
205
  --vp-code-bg: #{mg.ref("color-surface-alt")};
@@ -218,7 +211,6 @@ $dark: (
218
211
  --vp-code-copy-code-hover-bg: #{mg.ref("color-surface-alt")};
219
212
  --vp-code-tab-divider: #{mg.ref("color-rule")};
220
213
  --vp-code-tab-active-bar-color: #{mg.ref("color-accent")};
221
-
222
214
  --vp-button-brand-border: #{mg.ref("color-accent")};
223
215
  --vp-button-brand-text: #{mg.ref("color-accent-contrast")};
224
216
  --vp-button-brand-bg: #{mg.ref("color-accent")};
@@ -226,7 +218,6 @@ $dark: (
226
218
  --vp-button-brand-hover-text: #{mg.ref("color-accent-contrast")};
227
219
  --vp-button-brand-hover-bg: #{mg.ref("color-accent-hover")};
228
220
  --vp-button-brand-active-bg: #{mg.ref("color-accent-hover")};
229
-
230
221
  --vp-button-alt-border: #{mg.ref("color-rule-strong")};
231
222
  --vp-button-alt-text: #{mg.ref("color-ink")};
232
223
  --vp-button-alt-bg: transparent;
@@ -234,9 +225,7 @@ $dark: (
234
225
  --vp-button-alt-hover-text: #{mg.ref("color-ink")};
235
226
  --vp-button-alt-hover-bg: transparent;
236
227
  --vp-button-alt-active-bg: #{mg.ref("color-surface-alt")};
237
-
238
228
  --vp-custom-block-font-size: 0.9375rem;
239
229
  --vp-custom-block-code-font-size: 0.8125rem;
240
-
241
230
  --vp-home-hero-name-color: #{mg.ref("color-ink")};
242
231
  }
package/src/types.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { DefaultTheme } from 'vitepress/theme'
1
+ import type { DefaultTheme } from 'vitepress/theme';
2
2
 
3
3
  export interface BannerConfig {
4
4
  /** Stable id — changing it brings the banner back for readers who dismissed the previous one. */
@@ -68,6 +68,10 @@ export interface ThemeLabels {
68
68
  backToTop?: string
69
69
  /** Heading of the footer social column. Defaults to `Follow`. */
70
70
  footerSocial?: string
71
+ /** Heading of the sponsors section. Defaults to `Sponsors`. */
72
+ sponsors?: string
73
+ /** Sponsors section action button, when the site sets `actionLink` but no `actionText`. Defaults to `Become a sponsor`. */
74
+ sponsorsAction?: string
71
75
  }
72
76
 
73
77
  /** One entry of the colophon strip printed under the hero. */
@@ -133,4 +137,4 @@ export interface ThemeConfig extends DefaultTheme.Config {
133
137
  ff?: ThemeOptions
134
138
  }
135
139
 
136
- export type { DefaultTheme }
140
+ export type { DefaultTheme };