@frontfactory/vitepress-theme 1.7.0 → 1.9.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 (100) hide show
  1. package/CHANGELOG.md +83 -0
  2. package/README.md +163 -7
  3. package/config.d.ts +27 -1
  4. package/config.js +186 -21
  5. package/dist/style.css +1 -1
  6. package/node/blog.d.ts +3 -0
  7. package/node/blog.js +19 -0
  8. package/node/llms.js +32 -0
  9. package/node/og.js +158 -0
  10. package/node/pages.js +162 -0
  11. package/node/rss.js +78 -0
  12. package/package.json +42 -28
  13. package/src/blog/posts.data.ts +47 -0
  14. package/src/components/FfBackToTop.vue +19 -10
  15. package/src/components/FfBanner.vue +24 -6
  16. package/src/components/FfCopyStatus.vue +64 -0
  17. package/src/components/FfDocMeta.vue +325 -3
  18. package/src/components/FfFeature.vue +18 -7
  19. package/src/components/FfFeedback.vue +96 -0
  20. package/src/components/FfHero.vue +26 -35
  21. package/src/components/FfHeroActions.vue +44 -0
  22. package/src/components/FfHeroCommand.vue +22 -35
  23. package/src/components/FfHomeSponsors.vue +2 -2
  24. package/src/components/FfNavBarTitle.vue +63 -0
  25. package/src/components/FfPost.vue +50 -0
  26. package/src/components/FfProgress.vue +69 -0
  27. package/src/components/FfVersionSwitcher.vue +20 -0
  28. package/src/composables/blog.ts +41 -0
  29. package/src/composables/copy.ts +36 -0
  30. package/src/composables/options.ts +20 -1
  31. package/src/composables/tabs.ts +122 -0
  32. package/src/content/Api.vue +6 -2
  33. package/src/content/Badge.vue +26 -0
  34. package/src/content/Callout.vue +27 -0
  35. package/src/content/FileTree.vue +118 -0
  36. package/src/content/Tab.vue +11 -0
  37. package/src/content/Tabs.vue +95 -0
  38. package/src/content/Timeline.vue +19 -0
  39. package/src/content/TimelineItem.vue +37 -0
  40. package/src/content/timeline.ts +4 -0
  41. package/src/index.ts +37 -1
  42. package/src/internal.ts +8 -2
  43. package/src/layout/FfBlog.vue +62 -0
  44. package/src/layout/FfLayout.vue +20 -4
  45. package/src/styles/_base.scss +6 -14
  46. package/src/styles/_blocks.scss +29 -8
  47. package/src/styles/_blog.scss +130 -0
  48. package/src/styles/_breakpoints.scss +26 -0
  49. package/src/styles/_code.scss +11 -17
  50. package/src/styles/_content.scss +377 -18
  51. package/src/styles/_doc.scss +32 -29
  52. package/src/styles/_home.scss +47 -65
  53. package/src/styles/_mixins.scss +63 -0
  54. package/src/styles/_motion.scss +24 -13
  55. package/src/styles/_nav.scss +90 -24
  56. package/src/styles/_print.scss +77 -0
  57. package/src/styles/_sidebar.scss +7 -10
  58. package/src/styles/_tokens.scss +92 -11
  59. package/src/styles/index.scss +2 -0
  60. package/src/types.ts +148 -0
  61. package/types/blog/posts.data.d.ts +14 -0
  62. package/types/components/FfBackToTop.vue.d.ts +3 -0
  63. package/types/components/FfBanner.vue.d.ts +3 -0
  64. package/types/components/FfCopyStatus.vue.d.ts +3 -0
  65. package/types/components/FfDocMeta.vue.d.ts +3 -0
  66. package/types/components/FfFeature.vue.d.ts +13 -0
  67. package/types/components/FfFeedback.vue.d.ts +3 -0
  68. package/types/components/FfFooter.vue.d.ts +3 -0
  69. package/types/components/FfHero.vue.d.ts +42 -0
  70. package/types/components/FfHeroActions.vue.d.ts +19 -0
  71. package/types/components/FfHeroCommand.vue.d.ts +9 -0
  72. package/types/components/FfHomeSponsors.vue.d.ts +19 -0
  73. package/types/components/FfNavBarTitle.vue.d.ts +17 -0
  74. package/types/components/FfPost.vue.d.ts +3 -0
  75. package/types/components/FfProgress.vue.d.ts +3 -0
  76. package/types/components/FfVersionSwitcher.vue.d.ts +3 -0
  77. package/types/composables/blog.d.ts +10 -0
  78. package/types/composables/copy.d.ts +6 -0
  79. package/types/composables/link.d.ts +12 -0
  80. package/types/composables/options.d.ts +15 -0
  81. package/types/composables/relativeTime.d.ts +2 -0
  82. package/types/composables/tabs.d.ts +10 -0
  83. package/types/content/Api.vue.d.ts +27 -0
  84. package/types/content/Badge.vue.d.ts +21 -0
  85. package/types/content/Callout.vue.d.ts +24 -0
  86. package/types/content/Card.vue.d.ts +23 -0
  87. package/types/content/CardGrid.vue.d.ts +20 -0
  88. package/types/content/FileTree.vue.d.ts +6 -0
  89. package/types/content/Kbd.vue.d.ts +15 -0
  90. package/types/content/Steps.vue.d.ts +15 -0
  91. package/types/content/Tab.vue.d.ts +19 -0
  92. package/types/content/Tabs.vue.d.ts +7 -0
  93. package/types/content/Timeline.vue.d.ts +21 -0
  94. package/types/content/TimelineItem.vue.d.ts +21 -0
  95. package/types/content/timeline.d.ts +3 -0
  96. package/types/index.d.ts +25 -0
  97. package/types/internal.d.ts +10 -0
  98. package/types/layout/FfBlog.vue.d.ts +3 -0
  99. package/types/layout/FfLayout.vue.d.ts +23 -0
  100. package/types/types.d.ts +280 -0
@@ -0,0 +1,130 @@
1
+ // ============================================================================================= //
2
+ // BLOG //
3
+ // ============================================================================================= //
4
+
5
+ @use "breakpoints" as bp;
6
+ @use "mixins";
7
+ @use "theme" as mg;
8
+
9
+ .ff-theme {
10
+
11
+ // ----------------------------------------------------------------------------------------- //
12
+ // Index: one hairline-ruled row per post
13
+ // ----------------------------------------------------------------------------------------- //
14
+
15
+ .ff-blog {
16
+ max-width: #{mg.ref("layout-content")};
17
+ margin: 0 auto;
18
+ padding: 3rem 1.5rem 6rem;
19
+
20
+ @include bp.up("md") {
21
+ padding-top: 4.5rem;
22
+ }
23
+ }
24
+
25
+ .ff-blog-title {
26
+ margin: 0;
27
+ font-family: #{mg.ref("font-display")};
28
+
29
+ @include mixins.page-title;
30
+ }
31
+
32
+ .ff-blog-lede {
33
+ margin: 1.25rem 0 0;
34
+ font-size: #{mg.ref("size-body")};
35
+ line-height: 1.65;
36
+ color: #{mg.ref("color-ink-muted")};
37
+ }
38
+
39
+ .ff-blog-list {
40
+ margin: 3rem 0 0;
41
+ padding: 0;
42
+ border-top: #{mg.ref("rule-width")} solid #{mg.ref("color-rule-strong")};
43
+ list-style: none;
44
+ }
45
+
46
+ .ff-blog-post {
47
+ padding: 2rem 0;
48
+ border-bottom: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
49
+ }
50
+
51
+ .ff-blog-meta,
52
+ .ff-post {
53
+ flex-wrap: wrap;
54
+ gap: 0.375rem 0.75rem;
55
+ }
56
+
57
+ .ff-blog-meta > * + *::before,
58
+ .ff-post-item + .ff-post-item::before {
59
+ content: "·";
60
+ margin-right: 0.75rem;
61
+ }
62
+
63
+ .ff-blog-post-title {
64
+ margin: 0.875rem 0 0;
65
+ font-family: #{mg.ref("font-display")};
66
+ font-size: #{mg.ref("size-h2")};
67
+ font-weight: 600;
68
+ line-height: 1.3;
69
+ letter-spacing: #{mg.ref("tracking-heading")};
70
+ }
71
+
72
+ .ff-blog-post-title a {
73
+ color: #{mg.ref("color-ink")};
74
+ text-decoration: none;
75
+ transition: color #{mg.ref("motion-duration")} #{mg.ref("motion-ease")};
76
+ }
77
+
78
+ .ff-blog-post-title a:hover {
79
+ color: #{mg.ref("color-accent")};
80
+ }
81
+
82
+ .ff-blog-excerpt {
83
+ margin: 0.75rem 0 0;
84
+ line-height: #{mg.ref("leading-body")};
85
+ color: #{mg.ref("color-ink-muted")};
86
+ }
87
+
88
+ // ----------------------------------------------------------------------------------------- //
89
+ // Post header, under the kicker
90
+ // ----------------------------------------------------------------------------------------- //
91
+
92
+ // The header takes over the closing rule of the kicker above it, so the two read as one block.
93
+
94
+ .ff-doc-meta:has(+ .ff-post) {
95
+ margin-bottom: 1rem;
96
+ padding-bottom: 0;
97
+ border-bottom: 0;
98
+ }
99
+
100
+ .ff-post {
101
+ display: flex;
102
+ margin-bottom: 1.5rem;
103
+ padding-bottom: 1rem;
104
+ border-bottom: #{mg.ref("rule-width")} solid #{mg.ref("color-rule")};
105
+ }
106
+
107
+ .ff-post-author {
108
+ display: inline-flex;
109
+ align-items: center;
110
+ gap: 0.5rem;
111
+ }
112
+
113
+ .ff-post-author a {
114
+ color: inherit;
115
+ text-decoration: underline;
116
+ text-decoration-color: #{mg.ref("color-rule-strong")};
117
+ text-underline-offset: 0.25em;
118
+ }
119
+
120
+ .ff-post-author a:hover {
121
+ color: #{mg.ref("color-accent")};
122
+ }
123
+
124
+ .ff-post-avatar {
125
+ width: 1.25rem;
126
+ height: 1.25rem;
127
+ border-radius: 50%;
128
+ object-fit: cover;
129
+ }
130
+ }
@@ -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
+ }
@@ -2,6 +2,7 @@
2
2
  // CODE //
3
3
  // ============================================================================================= //
4
4
 
5
+ @use "mixins";
5
6
  @use "theme" as mg;
6
7
 
7
8
  .ff-theme {
@@ -31,12 +32,9 @@
31
32
  left: 0;
32
33
  height: 2.5rem;
33
34
  padding: 0 1rem;
34
- font-family: #{mg.ref("font-mono")};
35
- font-size: #{mg.ref("size-label")};
36
- font-weight: 500;
37
- text-transform: uppercase;
38
- letter-spacing: #{mg.ref("tracking-label")};
39
- color: #{mg.ref("color-ink-faint")};
35
+
36
+ @include mixins.label;
37
+
40
38
  opacity: 1;
41
39
  }
42
40
 
@@ -53,11 +51,8 @@
53
51
  border-radius: #{mg.ref("radius-sm")};
54
52
  background-color: transparent;
55
53
  background-size: 0.875rem;
56
- opacity: 0.55;
57
- }
58
54
 
59
- .vp-doc [class*="language-"]:hover > button.copy,
60
- .vp-doc [class*="language-"] > button.copy:focus {
55
+ // Fully opaque at rest: dimmed, the grey icon falls under the 3:1 non-text contrast minimum.
61
56
  opacity: 1;
62
57
  }
63
58
 
@@ -75,7 +70,7 @@
75
70
  font-family: #{mg.ref("font-mono")};
76
71
  font-size: #{mg.ref("size-label")};
77
72
  text-transform: uppercase;
78
- letter-spacing: 0.06em;
73
+ letter-spacing: #{mg.ref("tracking-label-tight")};
79
74
  }
80
75
 
81
76
  .vp-doc div[class*="language-"].line-numbers-mode {
@@ -111,8 +106,11 @@
111
106
  box-shadow: inset #{mg.ref("rule-accent-width")} 0 0 0 #{mg.ref("color-success")};
112
107
  }
113
108
 
109
+ // The default theme also fades a removed line to 0.7, which drops its tokens below 4.5:1; the
110
+ // rule and the "-" marker already say the line is gone.
114
111
  .vp-doc [class*="language-"] code .diff.remove {
115
112
  box-shadow: inset #{mg.ref("rule-accent-width")} 0 0 0 #{mg.ref("color-danger")};
113
+ opacity: 1;
116
114
  }
117
115
 
118
116
  // ----------------------------------------------------------------------------------------- //
@@ -139,12 +137,8 @@
139
137
  .vp-doc .vp-code-group .tabs label {
140
138
  padding: 0 0.75rem;
141
139
  line-height: 2.5rem;
142
- font-family: #{mg.ref("font-mono")};
143
- font-size: #{mg.ref("size-label")};
144
- font-weight: 500;
145
- text-transform: uppercase;
146
- letter-spacing: #{mg.ref("tracking-label")};
147
- color: #{mg.ref("color-ink-faint")};
140
+
141
+ @include mixins.label;
148
142
  }
149
143
 
150
144
  .vp-doc .vp-code-group input:checked + label {