@frontfactory/vitepress-theme 1.5.3 → 1.7.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.
- package/CHANGELOG.md +159 -0
- package/README.md +12 -3
- package/dist/style.css +1 -1
- package/package.json +22 -13
- package/src/components/FfBackToTop.vue +20 -6
- package/src/components/FfBanner.vue +18 -2
- package/src/components/FfDocMeta.vue +9 -44
- package/src/components/FfFooter.vue +11 -5
- package/src/components/FfHero.vue +4 -4
- package/src/components/FfHeroCommand.vue +16 -5
- package/src/composables/options.ts +7 -13
- package/src/composables/relativeTime.ts +59 -0
- package/src/styles/_base.scss +19 -0
- package/src/styles/_content.scss +4 -5
- package/src/styles/_motion.scss +11 -0
- package/src/styles/_sidebar.scss +19 -2
- package/src/styles/_tokens.scss +2 -2
- package/src/types.ts +18 -2
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
4
|
+
|
|
5
|
+
## [1.7.0](https://github.com/front-factory/vitepress-theme/compare/v1.6.0...v1.7.0) (2026-10-11)
|
|
6
|
+
|
|
7
|
+
### Features
|
|
8
|
+
|
|
9
|
+
* **a11y:** support forced colours ([391e35c](https://github.com/front-factory/vitepress-theme/commit/391e35cd8fc65a7638acf5d5fddefdda003764ab))
|
|
10
|
+
|
|
11
|
+
### Bug Fixes
|
|
12
|
+
|
|
13
|
+
* **a11y:** honour reduced motion on the remaining transitions ([a3529d7](https://github.com/front-factory/vitepress-theme/commit/a3529d783851719230601b5832bb08fffd6de21e))
|
|
14
|
+
* **a11y:** label the hero install group and drop its aside landmark ([1d303e2](https://github.com/front-factory/vitepress-theme/commit/1d303e2dc41bc95ee44beabb205eec4c0d9681a2))
|
|
15
|
+
* **a11y:** name footer navs and announce links opening in a new tab ([5c18122](https://github.com/front-factory/vitepress-theme/commit/5c18122a18be72c1e25233f2d08564929ff7cb27))
|
|
16
|
+
* **a11y:** raise the contrast of the faint ink token ([0e5a4fe](https://github.com/front-factory/vitepress-theme/commit/0e5a4fe5b604ef05c0baa362cc6502c4b9d08981))
|
|
17
|
+
* **back-to-top:** throttle scroll and respect reduced motion ([8549fc5](https://github.com/front-factory/vitepress-theme/commit/8549fc523414b4347d837cb43d0b17670dd2beb6))
|
|
18
|
+
* **banner:** enlarge and centre the dismiss button ([f9043c6](https://github.com/front-factory/vitepress-theme/commit/f9043c642633b06cbdde0c4a298995df476bfedf))
|
|
19
|
+
* **banner:** survive unavailable localStorage ([4a317f2](https://github.com/front-factory/vitepress-theme/commit/4a317f27147818b14f0e7d862071937effc2fa78))
|
|
20
|
+
* **doc-meta:** mark the last-updated stamp up as a time element ([303459f](https://github.com/front-factory/vitepress-theme/commit/303459fcebaa1688df122300a8f3041925f086da))
|
|
21
|
+
* **hero:** handle clipboard failure and announce the copy ([d2a29c1](https://github.com/front-factory/vitepress-theme/commit/d2a29c1e4cd67cac04b1942e4015e8ad1d6f94b3))
|
|
22
|
+
|
|
23
|
+
## [1.6.0](https://github.com/front-factory/vitepress-theme/compare/v1.5.3...v1.6.0) (2026-09-13)
|
|
24
|
+
|
|
25
|
+
### Features
|
|
26
|
+
|
|
27
|
+
* **playground:** add a custom 404 page ([fc08f30](https://github.com/front-factory/vitepress-theme/commit/fc08f303a6713102490d29f48bf1f871722eee7d))
|
|
28
|
+
* **playground:** add a team page ([5098161](https://github.com/front-factory/vitepress-theme/commit/50981617a5fd108b22ccfa6cab29ac940dc32119))
|
|
29
|
+
* **playground:** demonstrate VPDocAsideSponsors in the doc aside ([d4af98a](https://github.com/front-factory/vitepress-theme/commit/d4af98a3a28d9b9147918b0ba32e423da94463e5))
|
|
30
|
+
* **playground:** reach the team page from the top nav ([b948cad](https://github.com/front-factory/vitepress-theme/commit/b948cad271c0707030b4bc7f88025645a4b44d9b))
|
|
31
|
+
|
|
32
|
+
### Bug Fixes
|
|
33
|
+
|
|
34
|
+
* **sidebar:** center a level-0 caret with the label it collapses ([bfb7dac](https://github.com/front-factory/vitepress-theme/commit/bfb7dac6e4173136333f1277cd55759940eb3fe5))
|
|
35
|
+
* **sidebar:** distinguish a nested group heading from a real link ([16217ae](https://github.com/front-factory/vitepress-theme/commit/16217ae8d986e1fbc2cb98658edceeb8c415caae))
|
|
36
|
+
|
|
37
|
+
## [1.5.3](https://github.com/front-factory/vitepress-theme/compare/v1.5.2...v1.5.3) (2026-09-12)
|
|
38
|
+
|
|
39
|
+
### Bug Fixes
|
|
40
|
+
|
|
41
|
+
* **config:** escape the banner id before inlining it into the head script ([a1e22a4](https://github.com/front-factory/vitepress-theme/commit/a1e22a489663fcf787838f86fa344ca3433e838e))
|
|
42
|
+
* **feature:** hide the decorative icon from assistive tech ([835b418](https://github.com/front-factory/vitepress-theme/commit/835b4180846097c2ae1ae7739e231595e66f37a8))
|
|
43
|
+
* **hero-command:** clear the copy-feedback timer on unmount ([c8bbe2f](https://github.com/front-factory/vitepress-theme/commit/c8bbe2f5a126d0550237a0b7ee9674b186a25fe2))
|
|
44
|
+
|
|
45
|
+
## [1.5.2](https://github.com/front-factory/vitepress-theme/compare/v1.5.1...v1.5.2) (2026-09-12)
|
|
46
|
+
|
|
47
|
+
### Bug Fixes
|
|
48
|
+
|
|
49
|
+
* **release:** add a Performance changelog section for perf commits ([26044d2](https://github.com/front-factory/vitepress-theme/commit/26044d2e6536dee315c90ee30bb9247867b7287d))
|
|
50
|
+
|
|
51
|
+
## [1.5.1](https://github.com/front-factory/vitepress-theme/compare/v1.5.0...v1.5.1) (2026-09-12)
|
|
52
|
+
|
|
53
|
+
### Performance
|
|
54
|
+
|
|
55
|
+
* **build:** compress the published stylesheet ([8c0e56c](https://github.com/front-factory/vitepress-theme/commit/8c0e56c6e3a47aeced17f99933dc936df65bcfa3))
|
|
56
|
+
|
|
57
|
+
## [1.5.0](https://github.com/front-factory/vitepress-theme/compare/v1.4.2...v1.5.0) (2026-09-11)
|
|
58
|
+
|
|
59
|
+
### Features
|
|
60
|
+
|
|
61
|
+
* **home:** add a themed sponsors section ([fb8c3db](https://github.com/front-factory/vitepress-theme/commit/fb8c3db346749c9a55cb45172c837b08dcf55119))
|
|
62
|
+
|
|
63
|
+
## [1.4.2](https://github.com/front-factory/vitepress-theme/compare/v1.4.1...v1.4.2) (2026-09-11)
|
|
64
|
+
|
|
65
|
+
### Bug Fixes
|
|
66
|
+
|
|
67
|
+
* **config:** extend Vite's fs.allow instead of replacing it ([30fdf17](https://github.com/front-factory/vitepress-theme/commit/30fdf17043d6bf41d68bed9bc497f0589f09b926))
|
|
68
|
+
|
|
69
|
+
## [1.4.1](https://github.com/front-factory/vitepress-theme/compare/v1.4.0...v1.4.1) (2026-09-11)
|
|
70
|
+
|
|
71
|
+
### Bug Fixes
|
|
72
|
+
|
|
73
|
+
* **home:** drop the hero meta strip's top margin ([9d748c4](https://github.com/front-factory/vitepress-theme/commit/9d748c4b23fc26218a64768f87810fd7ef3708f8))
|
|
74
|
+
|
|
75
|
+
## [1.4.0](https://github.com/front-factory/vitepress-theme/compare/v1.3.2...v1.4.0) (2026-09-11)
|
|
76
|
+
|
|
77
|
+
### Features
|
|
78
|
+
|
|
79
|
+
* **theme:** add ff.navSticky option to un-fix the nav and banner ([6d82b32](https://github.com/front-factory/vitepress-theme/commit/6d82b3266240e86357599ff28f768275735e5482))
|
|
80
|
+
|
|
81
|
+
### Bug Fixes
|
|
82
|
+
|
|
83
|
+
* **home:** shrink the features section's top/bottom padding ([4d9886d](https://github.com/front-factory/vitepress-theme/commit/4d9886dc5142249f85aae6a4663cb7f8f5b07763))
|
|
84
|
+
|
|
85
|
+
## [1.3.2](https://github.com/front-factory/vitepress-theme/compare/v1.3.1...v1.3.2) (2026-09-11)
|
|
86
|
+
|
|
87
|
+
### Bug Fixes
|
|
88
|
+
|
|
89
|
+
* **home:** even hero top spacing, top-align columns when uneven height ([2d8dd0a](https://github.com/front-factory/vitepress-theme/commit/2d8dd0a1e05c07abe8d42a10518a0e25299390df))
|
|
90
|
+
|
|
91
|
+
## [1.3.1](https://github.com/front-factory/vitepress-theme/compare/v1.3.0...v1.3.1) (2026-09-11)
|
|
92
|
+
|
|
93
|
+
### Bug Fixes
|
|
94
|
+
|
|
95
|
+
* **home:** tighten hero top spacing and drop grey band in ragged feature rows ([0edfcc3](https://github.com/front-factory/vitepress-theme/commit/0edfcc30aeca60aa8055f5fa0c2db4a01fac283a))
|
|
96
|
+
|
|
97
|
+
## [1.3.0](https://github.com/front-factory/vitepress-theme/compare/v1.2.0...v1.3.0) (2026-09-10)
|
|
98
|
+
|
|
99
|
+
### Features
|
|
100
|
+
|
|
101
|
+
* **hero:** support command tabs and a bare install panel ([6abb42c](https://github.com/front-factory/vitepress-theme/commit/6abb42ccbab64fd077b6d089e7d50be6f0bab4e1))
|
|
102
|
+
|
|
103
|
+
## [1.2.0](https://github.com/front-factory/vitepress-theme/compare/v1.1.0...v1.2.0) (2026-09-10)
|
|
104
|
+
|
|
105
|
+
### Features
|
|
106
|
+
|
|
107
|
+
* **banner:** add a rainbow variant ([8f92631](https://github.com/front-factory/vitepress-theme/commit/8f92631b2bfc6ce5cc80781a30230ba154616dba))
|
|
108
|
+
* **banner:** add variant, gradient and icon options ([c7894c2](https://github.com/front-factory/vitepress-theme/commit/c7894c2f36fbd4c75faeb2822354815b3185fc56))
|
|
109
|
+
* **footer:** pin a social column to the right of the link columns ([56db5b0](https://github.com/front-factory/vitepress-theme/commit/56db5b0608754c17b60aa6e72c25310ccec81819))
|
|
110
|
+
* **hero:** add hero.quote ([672d2c3](https://github.com/front-factory/vitepress-theme/commit/672d2c325464210adec53fca8c170b0933ea4559))
|
|
111
|
+
* **hero:** keep the install panel when the hero has an image ([ee8ed76](https://github.com/front-factory/vitepress-theme/commit/ee8ed76f39bdf46c9fffb56f1ac61e24a789d08a))
|
|
112
|
+
* **nav:** add an option to put the menu before the search box ([f25c5d2](https://github.com/front-factory/vitepress-theme/commit/f25c5d21a2ea96bb028b49bb34601f6743b13b1e))
|
|
113
|
+
* **playground:** derive the displayed version from package.json ([3758539](https://github.com/front-factory/vitepress-theme/commit/37585394f9d560f58a1f53581ba25ca32b59c35e))
|
|
114
|
+
|
|
115
|
+
### Bug Fixes
|
|
116
|
+
|
|
117
|
+
* **code:** give error/warning/diff line annotations a visible mark ([d4ae4dd](https://github.com/front-factory/vitepress-theme/commit/d4ae4dd8a24843608764d53960ca1c612cd7ab9e))
|
|
118
|
+
|
|
119
|
+
## [1.1.0](https://github.com/front-factory/vitepress-theme/compare/v1.0.0...v1.1.0) (2026-09-10)
|
|
120
|
+
|
|
121
|
+
### Features
|
|
122
|
+
|
|
123
|
+
* **home:** drop the accent mark from the hero kicker ([ba519ab](https://github.com/front-factory/vitepress-theme/commit/ba519ab5df9778c6db9890a3fdedd22affb842ca))
|
|
124
|
+
* **home:** tighten the hero headline ([3e92837](https://github.com/front-factory/vitepress-theme/commit/3e92837098c5e689f17b4ddd0bd953f739a55cb4))
|
|
125
|
+
* **home:** turn the hero glow off by default ([a520b78](https://github.com/front-factory/vitepress-theme/commit/a520b781f1f5d2c052ad8605fc973f51d8e74142))
|
|
126
|
+
|
|
127
|
+
## 1.0.0 (2026-09-10)
|
|
128
|
+
|
|
129
|
+
### ⚠ BREAKING CHANGES
|
|
130
|
+
|
|
131
|
+
* **config:** extendConfig() is replaced by a default-exported config
|
|
132
|
+
object, consumed via defineConfig({ extends: baseConfig, ... }) as documented
|
|
133
|
+
at https://vitepress.dev/guide/custom-theme#distributing-a-custom-theme. The
|
|
134
|
+
banner anti-flash script now injects through the transformHead build hook
|
|
135
|
+
instead of a config mutation.
|
|
136
|
+
|
|
137
|
+
### refactor
|
|
138
|
+
|
|
139
|
+
* **config:** switch /config to extends per VitePress docs ([c15d573](https://github.com/front-factory/vitepress-theme/commit/c15d57332bbaf697b7768991494fefb7c9025137))
|
|
140
|
+
|
|
141
|
+
### Features
|
|
142
|
+
|
|
143
|
+
* **doc:** set the standfirst at body size ([7ca7021](https://github.com/front-factory/vitepress-theme/commit/7ca7021ec8d5e4b512ddbbd973b8c14bb9368b50))
|
|
144
|
+
* editorial vitepress theme ([b9c087f](https://github.com/front-factory/vitepress-theme/commit/b9c087f5fa5182e312ee7529f65123290185873f))
|
|
145
|
+
* **home:** give the hero a second column and a colophon ([1394bee](https://github.com/front-factory/vitepress-theme/commit/1394bee297b51bff6fd54693728a6c4f34c63494))
|
|
146
|
+
* **home:** set the hero in uppercase mono ([c647fd5](https://github.com/front-factory/vitepress-theme/commit/c647fd501096137dd4f653d56fd681649e7a923b))
|
|
147
|
+
* **i18n:** move the theme's own strings into themeConfig.ff.labels ([51fcbda](https://github.com/front-factory/vitepress-theme/commit/51fcbdaa7ab23e740db8a984f189a25287a53877))
|
|
148
|
+
* **layout:** one content band for every page ([f2b295d](https://github.com/front-factory/vitepress-theme/commit/f2b295dcdc2a9c167db13bcfb262362e51e75a9a))
|
|
149
|
+
* **motion:** add light and movement ([420d6cf](https://github.com/front-factory/vitepress-theme/commit/420d6cfdc74bdf109b109b2c7a6b352c4ddef824))
|
|
150
|
+
* **sidebar:** drop the group headings to the label size ([fa07db1](https://github.com/front-factory/vitepress-theme/commit/fa07db1977406b0500c0e2d60e6faf9ccaa255a4))
|
|
151
|
+
* **sidebar:** give the navigation room to read ([11c3d34](https://github.com/front-factory/vitepress-theme/commit/11c3d3433ceb76b3765696225f8bbee215357e22))
|
|
152
|
+
* **sidebar:** tighten the navigation column ([76f1e2b](https://github.com/front-factory/vitepress-theme/commit/76f1e2b48cc219ecb3ea98cf329fdc8afa7d454a))
|
|
153
|
+
* **type:** bring the headline sizes down a step ([82da285](https://github.com/front-factory/vitepress-theme/commit/82da285615e8a6e61e06aed013f65cf90084a450))
|
|
154
|
+
* **type:** take the page title down another step ([201f95a](https://github.com/front-factory/vitepress-theme/commit/201f95a4dc8426ca3b29090dfe47f017ead7304b))
|
|
155
|
+
|
|
156
|
+
### Bug Fixes
|
|
157
|
+
|
|
158
|
+
* **doc:** align the heading anchors with their headings ([1b14a83](https://github.com/front-factory/vitepress-theme/commit/1b14a83b0ac3ad424e3d710c8ef536304bfbbbb3))
|
|
159
|
+
* settle hover, the hero offsets and the banner ([223f2df](https://github.com/front-factory/vitepress-theme/commit/223f2df4a5156d28c87168d1320ff68be48883a0))
|
package/README.md
CHANGED
|
@@ -52,6 +52,13 @@ export default Theme
|
|
|
52
52
|
of dependency pre-bundling, and injects the inline script that keeps a dismissed banner from
|
|
53
53
|
painting in the built site.
|
|
54
54
|
|
|
55
|
+
The package ships its Vue and TypeScript sources as-is (`main`, `module` and `types` point at
|
|
56
|
+
`src/index.ts`) and relies on Vite to compile them, which `extends: baseConfig` sets up. Tooling that
|
|
57
|
+
type-checks outside Vite, such as `vue-tsc`, may need `skipLibCheck`. Importing
|
|
58
|
+
`@frontfactory/vitepress-theme/config` from `.vitepress/config.ts`, as above, also makes
|
|
59
|
+
`themeConfig.ff` known to TypeScript. `@frontfactory/vitepress-theme/style.css` is exported for
|
|
60
|
+
tooling that needs the stylesheet on its own; the theme entry already imports it.
|
|
61
|
+
|
|
55
62
|
## Rebranding
|
|
56
63
|
|
|
57
64
|
Every value is a `--ff-*` custom property. Point the accent at your own colour and the whole site
|
|
@@ -169,11 +176,11 @@ locales: {
|
|
|
169
176
|
readingTime: '{0} min de lecture',
|
|
170
177
|
lastUpdated: 'Mis à jour {0}',
|
|
171
178
|
heroInstall: 'Installation',
|
|
172
|
-
heroCopy: 'Copier',
|
|
173
179
|
heroCopied: 'Copié',
|
|
174
180
|
heroCopyLabel: 'Copier {0}',
|
|
175
181
|
backToTop: 'Haut',
|
|
176
|
-
footerSocial: 'Nous suivre'
|
|
182
|
+
footerSocial: 'Nous suivre',
|
|
183
|
+
newTab: 's\u2019ouvre dans un nouvel onglet'
|
|
177
184
|
}
|
|
178
185
|
}
|
|
179
186
|
}
|
|
@@ -187,11 +194,13 @@ locales: {
|
|
|
187
194
|
| `readingTime` | `{0} min read` |
|
|
188
195
|
| `lastUpdated` | `Updated {0}` |
|
|
189
196
|
| `heroInstall` | `Install` |
|
|
190
|
-
| `heroCopy` | `Copy` |
|
|
191
197
|
| `heroCopied` | `Copied` |
|
|
192
198
|
| `heroCopyLabel` | `Copy {0}` |
|
|
193
199
|
| `backToTop` | `Top` |
|
|
194
200
|
| `footerSocial` | `Follow` |
|
|
201
|
+
| `newTab` | `opens in a new tab` |
|
|
202
|
+
| `sponsors` | `Sponsors` |
|
|
203
|
+
| `sponsorsAction` | `Become a sponsor` |
|
|
195
204
|
|
|
196
205
|
The banner's own `text` and `linkText` are content, not labels, so they stay under `ff.banner`. The
|
|
197
206
|
back-to-top tooltip reuses the default theme's `returnToTopLabel`, and the last-updated stamp is
|
package/dist/style.css
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
:root{--ff-font-display:inter,ui-sans-serif,system-ui,sans-serif;--ff-font-title:var(--vp-font-family-mono);--ff-font-body:var(--vp-font-family-base);--ff-font-mono:var(--vp-font-family-mono);--ff-tracking-display:-0.025em;--ff-tracking-label:.1em;--ff-size-label:.6875rem;--ff-size-meta:.75rem;--ff-size-body:1rem;--ff-size-lead:1.125rem;--ff-size-h1:clamp(1.625rem,1.3rem + 1.3vw,2rem);--ff-size-h2:1.5rem;--ff-size-h3:1.1875rem;--ff-size-hero:clamp(1.5rem,1.05rem + 1.8vw,2.375rem);--ff-leading-body:1.75;--ff-leading-tight:1.15;--ff-radius-sm:5px;--ff-radius-md:10px;--ff-rule-width:1px;--ff-rule-accent-width:2px;--ff-motion-duration:200ms;--ff-motion-duration-slow:420ms;--ff-motion-ease:cubic-bezier(0.2, 0.6, 0.2, 1);--ff-banner-height:2.6875rem;--ff-hero-glow-opacity:0;--ff-layout-content:44rem;--ff-layout-wide:76rem;--ff-color-paper:#fbfaf8;--ff-color-surface:#fff;--ff-color-surface-alt:#f4f2ee;--ff-color-ink:#1a1917;--ff-color-ink-muted:#55524c;--ff-color-ink-faint:#8b867d;--ff-color-rule:#e6e2da;--ff-color-rule-strong:#d3cec4;--ff-color-accent:#2745cf;--ff-color-accent-hover:#1b34a8;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(39,69,207,.09);--ff-color-accent-glow:rgba(39,69,207,.16);--ff-color-success:#1c7a52;--ff-color-warning:#8a5a00;--ff-color-danger:#b32835;color-scheme:light}.dark{--ff-color-paper:#121110;--ff-color-surface:#1a1917;--ff-color-surface-alt:#201e1b;--ff-color-ink:#ece9e3;--ff-color-ink-muted:#a5a099;--ff-color-ink-faint:#77726a;--ff-color-rule:#2c2a26;--ff-color-rule-strong:#423e38;--ff-color-accent:#94a8ff;--ff-color-accent-hover:#b5c2ff;--ff-color-accent-contrast:#101018;--ff-color-accent-soft:rgba(148,168,255,.13);--ff-color-accent-glow:rgba(148,168,255,.2);--ff-color-success:#4ac48b;--ff-color-warning:#e0a942;--ff-color-danger:#f0707f;color-scheme:dark}:root{--vp-c-bg: var(--ff-color-paper);--vp-c-bg-alt: var(--ff-color-surface-alt);--vp-c-bg-elv: var(--ff-color-surface);--vp-c-bg-soft: var(--ff-color-surface-alt);--vp-c-text-1: var(--ff-color-ink);--vp-c-text-2: var(--ff-color-ink-muted);--vp-c-text-3: var(--ff-color-ink-faint);--vp-c-border: var(--ff-color-rule-strong);--vp-c-divider: var(--ff-color-rule);--vp-c-gutter: var(--ff-color-rule);--vp-c-brand-1: var(--ff-color-accent);--vp-c-brand-2: var(--ff-color-accent-hover);--vp-c-brand-3: var(--ff-color-accent);--vp-c-brand-soft: var(--ff-color-accent-soft);--vp-c-default-1: var(--ff-color-rule-strong);--vp-c-default-2: var(--ff-color-rule);--vp-c-default-3: var(--ff-color-surface-alt);--vp-c-default-soft: var(--ff-color-accent-soft);--vp-c-tip-1: var(--ff-color-accent);--vp-c-tip-soft: transparent;--vp-c-note-1: var(--ff-color-accent);--vp-c-note-soft: transparent;--vp-c-success-1: var(--ff-color-success);--vp-c-success-soft: transparent;--vp-c-warning-1: var(--ff-color-warning);--vp-c-warning-soft: transparent;--vp-c-danger-1: var(--ff-color-danger);--vp-c-danger-soft: transparent;--vp-c-caution-1: var(--ff-color-danger);--vp-c-caution-soft: transparent;--vp-c-important-1: var(--ff-color-accent);--vp-c-important-soft: transparent;--vp-shadow-1: none;--vp-shadow-2: none;--vp-shadow-3: 0 16px 40px rgb(0 0 0 / 0.08);--vp-shadow-4: 0 16px 40px rgb(0 0 0 / 0.1);--vp-shadow-5: 0 24px 64px rgb(0 0 0 / 0.12);--ff-frame: max(4rem, calc((100% - var(--ff-layout-wide)) / 2));--vp-nav-height: 60px;--vp-nav-bg-color: var(--ff-color-paper);--vp-nav-backdrop-filter: none;--vp-layout-max-width: 76rem;--vp-sidebar-width: 15rem;--vp-header-anchor-symbol: "#";--vp-code-font-size: 0.8125em;--vp-code-color: var(--ff-color-ink);--vp-code-bg: var(--ff-color-surface-alt);--vp-code-block-color: var(--ff-color-ink-muted);--vp-code-block-bg: var(--ff-color-surface);--vp-code-block-divider-color: var(--ff-color-rule);--vp-code-copy-code-border-color: var(--ff-color-rule);--vp-code-copy-code-bg: var(--ff-color-surface);--vp-code-copy-code-hover-bg: var(--ff-color-surface-alt);--vp-code-tab-divider: var(--ff-color-rule);--vp-code-tab-active-bar-color: var(--ff-color-accent);--vp-button-brand-border: var(--ff-color-accent);--vp-button-brand-text: var(--ff-color-accent-contrast);--vp-button-brand-bg: var(--ff-color-accent);--vp-button-brand-hover-border: var(--ff-color-accent-hover);--vp-button-brand-hover-text: var(--ff-color-accent-contrast);--vp-button-brand-hover-bg: var(--ff-color-accent-hover);--vp-button-brand-active-bg: var(--ff-color-accent-hover);--vp-button-alt-border: var(--ff-color-rule-strong);--vp-button-alt-text: var(--ff-color-ink);--vp-button-alt-bg: transparent;--vp-button-alt-hover-border: var(--ff-color-ink);--vp-button-alt-hover-text: var(--ff-color-ink);--vp-button-alt-hover-bg: transparent;--vp-button-alt-active-bg: var(--ff-color-surface-alt);--vp-custom-block-font-size: 0.9375rem;--vp-custom-block-code-font-size: 0.8125rem;--vp-home-hero-name-color: var(--ff-color-ink)}.ff-theme{font-family:var(--ff-font-body);font-size:var(--ff-size-body);line-height:var(--ff-leading-body);-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.ff-label{display:inline-flex;align-items:center;gap:.5em;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;line-height:1;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-display{font-family:var(--ff-font-display);font-weight:620;letter-spacing:var(--ff-tracking-display);line-height:var(--ff-leading-tight);font-variation-settings:"opsz" 32}::selection{background:var(--ff-color-accent-soft)}.ff-theme :focus-visible,.VPLocalSearchBox :focus-visible{outline:2px solid var(--ff-color-accent);outline-offset:2px;border-radius:var(--ff-radius-sm)}.ff-theme *{scrollbar-width:thin;scrollbar-color:var(--ff-color-rule-strong) rgba(0,0,0,0)}.ff-theme .VPButton{border-radius:var(--ff-radius-sm);border-width:var(--ff-rule-width);font-weight:550;letter-spacing:.01em;transition:background-color var(--ff-motion-duration) var(--ff-motion-ease),border-color var(--ff-motion-duration) var(--ff-motion-ease),color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .VPButton.medium{padding:0 1.25rem;line-height:2.75rem;font-size:.875rem}.ff-theme .VPButton.big{padding:0 1.75rem;line-height:3.25rem;font-size:.9375rem}.ff-theme .VPBadge{border-radius:var(--ff-radius-sm);border:var(--ff-rule-width) solid var(--ff-color-rule-strong);background:rgba(0,0,0,0);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-transform:uppercase;letter-spacing:.06em;color:var(--ff-color-ink-muted)}.ff-theme .VPBadge.tip,.ff-theme .VPBadge.info{border-color:var(--ff-color-accent);color:var(--ff-color-accent)}.ff-theme .VPBadge.warning{border-color:var(--ff-color-warning);color:var(--ff-color-warning)}.ff-theme .VPBadge.danger{border-color:var(--ff-color-danger);color:var(--ff-color-danger)}.ff-theme .VPNavBar{border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme[data-nav-sticky=false] .VPNav{position:relative;top:0}.ff-theme[data-nav-sticky=false] .VPContent{margin-top:0}@media(width >= 960px){.ff-theme[data-nav-sticky=false] .VPContent{padding-top:0}}.ff-theme[data-nav-order=menu-first] .content-body .menu{order:1;flex-grow:0;margin-left:1.5rem;margin-right:auto}.ff-theme[data-nav-order=menu-first] .content-body .search{order:2;margin-right:0}.ff-theme[data-nav-order=menu-first] .content-body .translations{order:3}.ff-theme[data-nav-order=menu-first] .content-body .appearance{order:4}.ff-theme[data-nav-order=menu-first] .content-body .social-links{order:5}.ff-theme[data-nav-order=menu-first] .content-body .extra{order:6}.ff-theme[data-nav-order=menu-first] .content-body .hamburger{order:7}.ff-theme .VPNavBar.has-sidebar .curtain,.ff-theme .VPNavBar .divider{display:none}.ff-theme .VPNavBar:not(.has-sidebar) .container{max-width:var(--ff-layout-wide)}@media(width >= 640px){.ff-theme .VPNavBar:not(.has-sidebar) .wrapper{padding:0 3rem}}@media(width >= 960px){.ff-theme .VPNavBar:not(.has-sidebar) .wrapper{padding:0 4rem}.ff-theme .VPNavBar.has-sidebar{--vp-nav-col-offset: calc(var(--ff-frame) + var(--vp-sidebar-width))}.ff-theme .VPNavBar.has-sidebar .wrapper{padding:0}.ff-theme .VPNavBar.has-sidebar .container{max-width:none;padding-right:var(--ff-frame);padding-left:var(--ff-frame)}.ff-theme .VPNavBar.has-sidebar .container>.title{min-width:var(--vp-sidebar-width);max-width:var(--vp-sidebar-width)}}.ff-theme .VPNavBar .content-body{background:rgba(0,0,0,0)}.ff-theme .VPNavBarTitle .title{border-bottom:0;gap:.625rem;font-family:var(--ff-font-display);font-size:.9375rem;font-weight:620;letter-spacing:-0.01em}.ff-theme .VPNavBarTitle .title:not(:has(.logo))::before{content:"";width:.5rem;height:.5rem;background:var(--ff-color-accent)}.ff-theme .VPNavBarMenuLink,.ff-theme .VPNavBarMenuGroup .button{font-size:.875rem;font-weight:500;color:var(--ff-color-ink-muted);transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .VPNavBarMenuLink:hover,.ff-theme .VPNavBarMenuGroup .button:hover{color:var(--ff-color-ink)}.ff-theme .VPNavBarMenuLink.active{color:var(--ff-color-ink);text-decoration:underline;text-decoration-color:var(--ff-color-accent);text-decoration-thickness:2px;text-underline-offset:.5rem}.ff-theme .VPNavBarSearch .DocSearch-Button,.ff-theme .VPNavBarSearchButton{display:flex;align-items:center;gap:.5rem;padding:0 .5rem 0 .625rem;height:2rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0);font-size:.8125rem;color:var(--ff-color-ink-faint);transition:border-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .VPNavBarSearchButton:hover{border-color:var(--ff-color-rule-strong);color:var(--ff-color-ink-muted)}.ff-theme .VPNavBarSearchButton .keys kbd,.ff-theme .VPNavBarSearchButton .keys .key-cmd{border:0;border-radius:0;background:rgba(0,0,0,0);box-shadow:none;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);color:var(--ff-color-ink-faint)}.ff-theme .VPSwitch{border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0)}.ff-theme .VPSwitch .check{border-radius:2px;background:var(--ff-color-surface-alt);box-shadow:none}.ff-theme .VPSwitch .icon{border-radius:2px}.ff-theme .VPLocalNav .menu-text,.ff-theme .VPLocalNavOutlineDropdown .menu-text,.ff-theme .VPLocalNavOutlineDropdown button{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);text-transform:uppercase;letter-spacing:var(--ff-tracking-label)}.ff-theme .VPNavScreen{background:var(--ff-color-paper)}.ff-theme .VPNavScreenMenuLink,.ff-theme .VPNavScreenMenuGroupLink{border-bottom:var(--ff-rule-width) solid var(--ff-color-rule);font-weight:500}.VPLocalSearchBox .shell{border:var(--ff-rule-width) solid var(--ff-color-rule-strong);border-radius:var(--ff-radius-md);background:var(--ff-color-paper)}.VPLocalSearchBox .search-actions button,.VPLocalSearchBox .search-keyboard-shortcuts{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);text-transform:uppercase;letter-spacing:.06em}.VPLocalSearchBox .titles .title{font-weight:500}.VPLocalSearchBox .result{border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0)}.VPLocalSearchBox .result.selected{border-color:var(--ff-color-accent);background:var(--ff-color-accent-soft)}.ff-theme .VPSidebar{border-right:var(--ff-rule-width) solid var(--ff-color-rule);background:var(--ff-color-paper)}.ff-theme .VPSidebar .curtain{background:var(--ff-color-paper)}.ff-theme .VPSidebar .nav{padding-top:1.5rem}.ff-theme .VPSidebar .nav{counter-reset:ff-section}.ff-theme .VPSidebar .group{counter-increment:ff-section}.ff-theme .VPSidebar .group+.group{margin-top:1.75rem;padding-top:1.5rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .VPSidebar .group .VPSidebarItem.level-0{padding-bottom:0}.ff-theme .VPSidebar .group>.VPSidebarItem.level-0>.item{position:relative;gap:.75rem;padding-bottom:.75rem}.ff-theme .VPSidebar .group>.VPSidebarItem.level-0>.item::before{content:counter(ff-section, decimal-leading-zero);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:600;line-height:1.4;letter-spacing:.02em;color:var(--ff-color-accent)}.ff-theme .VPSidebarItem.level-0>.item>.text{padding:0;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:600;line-height:1.4;text-transform:uppercase;letter-spacing:.08em;color:var(--ff-color-ink)}.ff-theme .VPSidebarItem.level-1 .text,.ff-theme .VPSidebarItem.level-2 .text,.ff-theme .VPSidebarItem.level-3 .text{padding:.25rem 0;font-size:.875rem;font-weight:450;line-height:1.6;color:var(--ff-color-ink-muted)}.ff-theme .VPSidebarItem.is-link.is-active>.item>.link>.text{font-weight:600}.ff-theme .VPSidebarItem.level-1 .items{margin-top:.25rem;padding-left:.875rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .VPSidebarItem.level-2 .text,.ff-theme .VPSidebarItem.level-3 .text{padding:.375rem 0;font-size:.8125rem}.ff-theme .VPSidebarItem.is-active>.item>.indicator{top:.5rem;bottom:.5rem;width:var(--ff-rule-accent-width);border-radius:0;background-color:var(--ff-color-accent)}.ff-theme .VPSidebarItem .caret{margin-right:-0.5rem;color:var(--ff-color-ink-faint)}@media(width >= 960px){.ff-theme .VPSidebar{padding-left:var(--ff-frame);width:calc(var(--ff-frame) + var(--vp-sidebar-width))}.ff-theme .VPContent.has-sidebar{padding-right:var(--ff-frame);padding-left:calc(var(--ff-frame) + var(--vp-sidebar-width))}.ff-theme .VPDoc.has-sidebar{padding-right:0;padding-left:0}.ff-theme .VPLocalNav.has-sidebar{padding-left:calc(var(--ff-frame) + var(--vp-sidebar-width))}}@media(width >= 1280px){.ff-theme .VPDoc .aside{flex:0 0 auto;width:16rem}.ff-theme .VPDoc .content{min-width:0}}.ff-theme .VPDoc .container{max-width:none}.ff-theme .VPDoc.has-aside .content-container,.ff-theme .VPDoc .content-container{max-width:var(--ff-layout-content)}.ff-theme .VPDoc:not(.has-sidebar) .content{max-width:none}.ff-theme .vp-doc h1,.ff-theme .vp-doc h2,.ff-theme .vp-doc h3,.ff-theme .vp-doc h4{font-family:var(--ff-font-display);letter-spacing:var(--ff-tracking-display);font-variation-settings:"opsz" 32}.ff-theme .vp-doc h1{margin:0 0 1.25rem;font-size:var(--ff-size-h1);font-weight:620;line-height:var(--ff-leading-tight);letter-spacing:-0.03em}.ff-theme .vp-doc h2{--ff-h2-rule-gap: 1.75rem;margin:3.5rem 0 1.25rem;padding-top:var(--ff-h2-rule-gap);border-top:var(--ff-rule-width) solid var(--ff-color-rule);border-image:linear-gradient(90deg, var(--ff-color-rule-strong), transparent 85%) 1;font-size:var(--ff-size-h2);font-weight:600;line-height:1.3}.ff-theme .vp-doc h3{margin:2.5rem 0 .75rem;font-size:var(--ff-size-h3);font-weight:600;letter-spacing:-0.015em}.ff-theme .vp-doc h4{margin:2rem 0 .5rem;font-size:1rem;font-weight:600}.ff-theme .vp-doc .header-anchor{left:-1.5rem;margin-left:0;font-family:var(--ff-font-mono);font-weight:400;color:var(--ff-color-ink-faint);opacity:0;transition:opacity var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .vp-doc h2 .header-anchor{top:var(--ff-h2-rule-gap)}.ff-theme .vp-doc h1:hover .header-anchor,.ff-theme .vp-doc h2:hover .header-anchor,.ff-theme .vp-doc h3:hover .header-anchor,.ff-theme .vp-doc h4:hover .header-anchor,.ff-theme .vp-doc .header-anchor:focus{opacity:1}.ff-theme .vp-doc p,.ff-theme .vp-doc li{line-height:var(--ff-leading-body);color:var(--ff-color-ink)}.ff-theme .vp-doc p{margin:1.25rem 0}.ff-theme .vp-doc>div>h1+p{margin-top:1.5rem;font-size:var(--ff-size-body);line-height:1.65;color:var(--ff-color-ink-muted)}.ff-theme .vp-doc a{font-weight:inherit;color:var(--ff-color-accent);text-decoration-thickness:1px;text-underline-offset:.2em;text-decoration-color:var(--ff-color-accent-soft);transition:text-decoration-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .vp-doc a:hover{text-decoration-color:currentcolor}.ff-theme .vp-doc strong{font-weight:620;color:var(--ff-color-ink)}.ff-theme .vp-doc blockquote{margin:1.75rem 0;padding-left:1.25rem;border-left:var(--ff-rule-accent-width) solid var(--ff-color-rule-strong)}.ff-theme .vp-doc blockquote>p{font-size:1rem;font-style:italic;color:var(--ff-color-ink-muted)}.ff-theme .vp-doc hr{margin:3rem 0;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc :not(pre)>code{padding:.15em .35em;border-radius:var(--ff-radius-sm);background:var(--ff-color-surface-alt);font-size:.8125em;color:var(--ff-color-ink)}.ff-theme .vp-doc a>code{color:var(--ff-color-accent)}.ff-theme .vp-doc h1 code,.ff-theme .vp-doc h2 code,.ff-theme .vp-doc h3 code,.ff-theme .vp-doc h4 code{padding:0;border-radius:0;background:rgba(0,0,0,0);font-size:.9em;font-weight:600;color:inherit}.ff-theme .vp-doc table{display:table;width:100%;margin:1.75rem 0;border-collapse:collapse}.ff-theme .vp-doc tr{border:0;background:rgba(0,0,0,0)}.ff-theme .vp-doc th{padding:.5rem .875rem .5rem 0;border:0;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule-strong);background:rgba(0,0,0,0);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-align:left;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-theme .vp-doc td{padding:.75rem .875rem .75rem 0;border:0;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule);font-size:.9375rem;line-height:1.6;vertical-align:top}.ff-theme .vp-doc th:last-child,.ff-theme .vp-doc td:last-child{padding-right:0}.ff-theme .vp-doc img{border-radius:var(--ff-radius-md)}.ff-theme .VPDocFooter{margin-top:3.5rem}.ff-theme .VPDocFooter .edit-info{padding-bottom:1.25rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .VPDocFooter .edit-link-button,.ff-theme .VPDocFooter .last-updated{font-family:var(--ff-font-mono);font-size:var(--ff-size-meta);font-weight:400;color:var(--ff-color-ink-faint)}.ff-theme .VPDocFooter .edit-link-button{color:var(--ff-color-accent)}.ff-theme .VPDocFooter .prev-next{margin-top:0;padding-top:0;border-top:0;gap:0}.ff-theme .VPDocFooter .pager-link{padding:1.5rem 0;border:0;border-bottom:var(--ff-rule-accent-width) solid var(--ff-color-rule);border-radius:0;background:rgba(0,0,0,0);transition:border-color var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme .VPDocFooter .pager-link:hover{border-bottom-color:var(--ff-color-accent)}.ff-theme .VPDocFooter .pager-link .desc{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-theme .VPDocFooter .pager-link .title{font-family:var(--ff-font-display);font-size:1.0625rem;font-weight:600;letter-spacing:-0.015em;color:var(--ff-color-ink)}.ff-theme .VPDocFooter .pager-link .desc,.ff-theme .VPDocFooter .pager-link .title{transition:color var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme .VPDocFooter .pager-link:hover .desc,.ff-theme .VPDocFooter .pager-link:hover .title{color:var(--ff-color-accent)}.ff-theme .VPDocAsideOutline .content{padding-left:1rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .VPDocAsideOutline .outline-title{margin-bottom:.75rem;font-family:var(--ff-font-mono);font-size:var(--ff-size-meta);font-weight:600;line-height:1.4;text-transform:uppercase;letter-spacing:.08em;color:var(--ff-color-ink)}.ff-theme .VPDocAsideOutline .outline-marker{width:var(--ff-rule-accent-width);border-radius:0;background-color:var(--ff-color-accent)}.ff-theme .VPDocAsideOutline .outline-link{display:block;padding:.25rem 0;font-size:.875rem;font-weight:450;line-height:1.5;color:var(--ff-color-ink-muted);white-space:normal;overflow:visible;overflow-wrap:break-word;transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .VPDocAsideOutline .outline-link:hover{color:var(--ff-color-ink)}.ff-theme .VPDocAsideOutline .outline-link.active{font-weight:600;color:var(--ff-color-accent)}.ff-theme .VPDocAsideOutline .VPDocOutlineItem.nested{padding-left:.75rem}.ff-theme .VPDocAsideOutline .VPDocOutlineItem.nested .outline-link{font-size:.8125rem}.ff-theme .vp-doc div[class*=language-],.ff-theme .vp-doc .vp-block{margin:1.75rem 0;padding-top:2.5rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md);background:var(--ff-color-surface)}.ff-theme .vp-doc [class*=language-]>pre{margin:0;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc [class*=language-]>span.lang{display:flex;align-items:center;top:0;right:auto;left:0;height:2.5rem;padding:0 1rem;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint);opacity:1}.ff-theme .vp-doc [class*=language-]:hover>button.copy+span.lang,.ff-theme .vp-doc [class*=language-]>button.copy:focus+span.lang{opacity:1}.ff-theme .vp-doc [class*=language-]>button.copy{top:.4375rem;right:.625rem;width:1.75rem;height:1.75rem;border-radius:var(--ff-radius-sm);background-color:rgba(0,0,0,0);background-size:.875rem;opacity:.55}.ff-theme .vp-doc [class*=language-]:hover>button.copy,.ff-theme .vp-doc [class*=language-]>button.copy:focus{opacity:1}.ff-theme .vp-doc [class*=language-]>button.copy.copied,.ff-theme .vp-doc [class*=language-]>button.copy:hover.copied{border-radius:0 var(--ff-radius-sm) var(--ff-radius-sm) 0}.ff-theme .vp-doc [class*=language-]>button.copy.copied::before,.ff-theme .vp-doc [class*=language-]>button.copy:hover.copied::before{top:0;height:1.75rem;border-radius:var(--ff-radius-sm) 0 0 var(--ff-radius-sm);background:var(--ff-color-surface);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);text-transform:uppercase;letter-spacing:.06em}.ff-theme .vp-doc div[class*=language-].line-numbers-mode{padding-left:0}.ff-theme .vp-doc [class*=language-] .line-numbers-wrapper{top:2.5rem;border-right:var(--ff-rule-width) solid var(--ff-color-rule);font-family:var(--ff-font-mono);color:var(--ff-color-ink-faint)}.ff-theme .vp-doc [class*=language-] code .highlighted.error{box-shadow:inset var(--ff-rule-accent-width) 0 0 0 var(--ff-color-danger)}.ff-theme .vp-doc [class*=language-] code .highlighted.warning{box-shadow:inset var(--ff-rule-accent-width) 0 0 0 var(--ff-color-warning)}.ff-theme .vp-doc [class*=language-] code .diff.add{box-shadow:inset var(--ff-rule-accent-width) 0 0 0 var(--ff-color-success)}.ff-theme .vp-doc [class*=language-] code .diff.remove{box-shadow:inset var(--ff-rule-accent-width) 0 0 0 var(--ff-color-danger)}.ff-theme .vp-doc .vp-code-group{margin:1.75rem 0;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md);background:var(--ff-color-surface);overflow:hidden}.ff-theme .vp-doc .vp-code-group .tabs{margin:0;padding:0 .5rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:0;background:rgba(0,0,0,0);box-shadow:none}.ff-theme .vp-doc .vp-code-group .tabs label{padding:0 .75rem;line-height:2.5rem;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-theme .vp-doc .vp-code-group input:checked+label{color:var(--ff-color-ink)}.ff-theme .vp-doc .vp-code-group .tabs label::after{right:0;left:0;border-radius:0}.ff-theme .vp-doc .vp-code-group div[class*=language-]{margin:0;padding-top:0;border:0;border-radius:0}.ff-theme .vp-doc .vp-code-group div[class*=language-]>pre{border-top:0}.ff-theme .vp-doc .vp-code-group div[class*=language-]>span.lang,.ff-theme .vp-doc .custom-block div[class*=language-]>span.lang{display:none}.ff-theme .vp-doc .vp-code-group [class*=language-] .line-numbers-wrapper{top:0}.ff-theme .vp-doc .custom-block div[class*=language-]{padding-top:0;background:var(--ff-color-surface)}.ff-theme .vp-doc .custom-block div[class*=language-]>pre{border-top:0}.ff-theme .vp-doc .custom-block{margin:1.75rem 0;padding:0 0 0 1.25rem;border:0;border-left:var(--ff-rule-accent-width) solid var(--ff-color-rule-strong);border-radius:0;background:rgba(0,0,0,0);font-size:.9375rem}.ff-theme .vp-doc .custom-block p,.ff-theme .vp-doc .custom-block li{line-height:1.7;color:var(--ff-color-ink-muted)}.ff-theme .vp-doc .custom-block p:first-of-type{margin-top:0}.ff-theme .vp-doc .custom-block p:last-child{margin-bottom:0}.ff-theme .vp-doc .custom-block .custom-block-title{margin-bottom:.5rem;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;line-height:1;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-theme .vp-doc .custom-block.tip,.ff-theme .vp-doc .custom-block.note,.ff-theme .vp-doc .custom-block.info,.ff-theme .vp-doc .custom-block.important{border-left-color:var(--ff-color-accent)}.ff-theme .vp-doc .custom-block.tip .custom-block-title,.ff-theme .vp-doc .custom-block.note .custom-block-title,.ff-theme .vp-doc .custom-block.important .custom-block-title{color:var(--ff-color-accent)}.ff-theme .vp-doc .custom-block.warning{border-left-color:var(--ff-color-warning)}.ff-theme .vp-doc .custom-block.warning .custom-block-title{color:var(--ff-color-warning)}.ff-theme .vp-doc .custom-block.danger,.ff-theme .vp-doc .custom-block.caution{border-left-color:var(--ff-color-danger)}.ff-theme .vp-doc .custom-block.danger .custom-block-title,.ff-theme .vp-doc .custom-block.caution .custom-block-title{color:var(--ff-color-danger)}.ff-theme .vp-doc .custom-block a{font-weight:inherit}.ff-theme .vp-doc .custom-block.details{padding:1rem 1.25rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md)}.ff-theme .vp-doc .custom-block.details summary{margin-bottom:0;font-family:var(--ff-font-mono);font-size:var(--ff-size-meta);font-weight:500;text-transform:uppercase;letter-spacing:.06em;color:var(--ff-color-ink);cursor:pointer}.ff-theme .vp-doc .custom-block.details[open] summary{margin-bottom:.75rem}.ff-theme .VPHome{margin-bottom:0}.ff-theme .ff-hero{--ff-hero-offset: calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px));position:relative;margin-top:calc(var(--ff-hero-offset)*-1);padding:calc(var(--ff-hero-offset) + 1.5rem) 1.5rem 3.5rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule);overflow:hidden}.ff-theme[data-nav-sticky=false] .ff-hero{--ff-hero-offset: 0px}.ff-theme .VPNavBar.home.top{border-bottom-color:rgba(0,0,0,0)}.ff-theme .ff-hero-glow{position:absolute;top:-50%;left:-6%;display:block;width:min(72rem,150%);aspect-ratio:1;background:radial-gradient(circle closest-side at 45% 45%, var(--ff-color-accent-glow), transparent);opacity:var(--ff-hero-glow-opacity);pointer-events:none}.ff-theme .ff-hero-glow-far{top:-20%;right:-20%;left:auto;width:min(50rem,100%);background:radial-gradient(circle closest-side at 50% 50%, var(--ff-color-accent-soft), transparent)}.ff-theme .ff-hero-container{position:relative;display:grid;gap:3rem;max-width:var(--ff-layout-wide);margin:0 auto}.ff-theme .ff-hero-kicker{margin:0 0 1.5rem;color:var(--ff-color-ink-muted)}.ff-theme .ff-hero-title{max-width:20ch;margin:0;font-family:var(--ff-font-title);font-size:var(--ff-size-hero);font-weight:600;letter-spacing:0;word-spacing:-0.3em;text-transform:uppercase;color:var(--ff-color-ink);text-wrap:balance;font-variation-settings:normal}.ff-theme .ff-hero-tagline{max-width:42ch;margin:1.75rem 0 0;font-size:var(--ff-size-body);line-height:1.55;color:var(--ff-color-ink-muted);text-wrap:pretty}.ff-theme .ff-hero-quote{max-width:38ch;margin:1.75rem 0 0;padding-left:1.25rem;border-left:var(--ff-rule-accent-width) solid var(--ff-color-rule-strong);font-size:var(--ff-size-body);font-style:italic;line-height:1.55;color:var(--ff-color-ink-muted)}.ff-theme .ff-hero-quote strong{font-style:normal;font-weight:620;color:var(--ff-color-ink)}.ff-theme .ff-hero-actions{display:flex;flex-wrap:wrap;gap:.75rem;margin-top:2.5rem}.ff-theme .ff-hero-panel{align-self:center;padding:1.75rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md);background:var(--ff-color-surface);box-shadow:0 1.5rem 3rem rgba(0,0,0,.05)}.ff-theme .ff-hero-panel-label{margin:0 0 1rem}.ff-theme .ff-hero-command-tabs{display:flex;flex-wrap:wrap;margin-bottom:.75rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-hero-command-tab{position:relative;padding:0 .75rem .625rem;border:0;background:rgba(0,0,0,0);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint);cursor:pointer;transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-hero-command-tab:first-child{padding-left:0}.ff-theme .ff-hero-command-tab::after{position:absolute;right:0;bottom:calc(var(--ff-rule-accent-width)*-1);left:0;height:var(--ff-rule-accent-width);background:rgba(0,0,0,0);content:"";transition:background-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-hero-command-tab:hover{color:var(--ff-color-ink)}.ff-theme .ff-hero-command-tab.active{color:var(--ff-color-ink)}.ff-theme .ff-hero-command-tab.active::after{background:var(--ff-color-accent)}.ff-theme .ff-hero-panel-inline{max-width:28rem;margin-top:2.5rem}.ff-theme .ff-hero-panel-bare{padding:0;border:0;border-radius:0;background:rgba(0,0,0,0);box-shadow:none}.ff-theme .ff-hero-panel .ff-hero-actions{margin-top:1.25rem}.ff-theme .ff-hero-panel .ff-btn{flex:1 1 8rem;justify-content:center}.ff-theme .ff-hero-command{display:flex;align-items:center;justify-content:space-between;gap:1rem;padding:.625rem .625rem .625rem .875rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:var(--ff-color-paper)}.ff-theme .ff-hero-command code{font-family:var(--ff-font-mono);font-size:.8125rem;color:var(--ff-color-ink);overflow-x:auto}.ff-theme .ff-hero-prompt{margin-right:.5rem;color:var(--ff-color-accent)}.ff-theme .ff-hero-copy-group{position:relative;display:flex;align-items:center;flex-shrink:0}.ff-theme .ff-hero-copied{position:absolute;top:0;right:100%;z-index:1;display:flex;align-items:center;height:1.75rem;padding:0 .625rem;border:var(--ff-rule-width) solid var(--ff-color-rule-strong);border-right:0;border-radius:var(--ff-radius-sm) 0 0 var(--ff-radius-sm);background:var(--ff-color-surface-alt);color:var(--ff-color-ink-muted);white-space:nowrap}.ff-theme .ff-hero-copy{flex-shrink:0;width:1.75rem;height:1.75rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background-color:rgba(0,0,0,0);background-image:var(--vp-icon-copy);background-position:50%;background-repeat:no-repeat;background-size:.875rem;cursor:pointer;transition:border-color var(--ff-motion-duration) var(--ff-motion-ease),background-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-hero-copy:hover{border-color:var(--ff-color-rule-strong);background-color:var(--ff-color-surface-alt)}.ff-theme .ff-hero-copy.copied{border-radius:0 var(--ff-radius-sm) var(--ff-radius-sm) 0;border-color:var(--ff-color-rule-strong);background-color:var(--ff-color-surface-alt);background-image:var(--vp-icon-copied)}.ff-theme .ff-hero-image{display:flex;align-items:center;justify-content:center;max-width:28rem}.ff-theme .ff-hero-image img{width:100%;height:auto}@media(width >= 960px){.ff-theme .ff-hero-image{max-width:none}}.ff-theme .ff-hero-meta{position:relative;display:grid;grid-template-columns:repeat(auto-fit, minmax(7rem, 1fr));gap:1.5rem;max-width:var(--ff-layout-wide);margin:0 auto;padding-top:1.75rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-hero-meta-item{padding-left:1.5rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-hero-meta-item:first-child{padding-left:0;border-left:0}.ff-theme .ff-hero-meta dt{margin-bottom:.625rem}.ff-theme .ff-hero-meta dd{margin:0;font-family:var(--ff-font-display);font-size:1.125rem;font-weight:600;letter-spacing:-0.01em;color:var(--ff-color-ink)}@media(width >= 640px){.ff-theme .ff-hero{padding:calc(var(--ff-hero-offset) + 2rem) 3rem 4rem}}@media(width >= 960px){.ff-theme .ff-hero{padding:calc(var(--ff-hero-offset) + 2.25rem) 4rem 4.5rem}.ff-theme .ff-hero-container{gap:4.5rem}.ff-theme .ff-hero.has-panel .ff-hero-container{grid-template-columns:minmax(0, 1.3fr) minmax(0, 1fr);align-items:start}.ff-theme .ff-hero.has-image .ff-hero-container{grid-template-columns:minmax(0, 1fr) minmax(0, 1fr);align-items:start}}.ff-theme .ff-btn{display:inline-flex;align-items:center;height:2.875rem;padding:0 1.375rem;border:var(--ff-rule-width) solid rgba(0,0,0,0);border-radius:var(--ff-radius-sm);font-size:.875rem;font-weight:550;text-decoration:none;white-space:nowrap}.ff-theme .vp-doc .ff-btn{font-weight:550;text-decoration:none}.ff-theme .ff-btn.ff-btn-brand{border-color:var(--ff-color-accent);background:var(--ff-color-accent);color:var(--ff-color-accent-contrast)}.ff-theme .ff-btn.ff-btn-brand:hover{border-color:var(--ff-color-accent-hover);background:var(--ff-color-accent-hover);color:var(--ff-color-accent-contrast)}.ff-theme .ff-btn.ff-btn-alt{border-color:var(--ff-color-rule-strong);color:var(--ff-color-ink)}.ff-theme .ff-btn.ff-btn-alt:hover{border-color:var(--ff-color-ink);color:var(--ff-color-ink)}.ff-theme .VPFeatures{padding:2.5rem 1.5rem 3rem}.ff-theme .VPFeatures .container{max-width:var(--ff-layout-wide)}.ff-theme .VPFeatures .items{display:grid;grid-template-columns:minmax(0, 1fr);gap:0;margin:0;overflow:hidden;counter-reset:ff-feature}.ff-theme .VPFeatures .items>.item,.ff-theme .VPFeatures .items>.item[class*=grid-]{width:auto;padding:0;counter-increment:ff-feature}.ff-theme .ff-feature{position:relative;display:flex;flex-direction:column;height:100%;padding:2.25rem 2rem 2.5rem;background:var(--ff-color-paper);box-shadow:calc(-1*var(--ff-rule-width)) 0 0 0 var(--ff-color-rule),0 calc(-1*var(--ff-rule-width)) 0 0 var(--ff-color-rule);isolation:isolate}.ff-theme .ff-feature-index::before{content:counter(ff-feature, decimal-leading-zero);position:absolute;top:1.5rem;right:1.75rem;font-family:var(--ff-font-mono);font-size:2rem;font-weight:500;line-height:1;letter-spacing:-0.02em;color:var(--ff-color-rule-strong);transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme a.ff-feature:hover .ff-feature-index::before{color:var(--ff-color-accent)}.ff-theme .ff-feature-icon{font-size:1.5rem;line-height:1;color:var(--ff-color-accent)}.ff-theme .ff-feature-icon svg{width:1.625rem;height:1.625rem}.ff-theme .ff-feature-title{margin:2.25rem 0 0;font-family:var(--ff-font-display);font-size:1.1875rem;font-weight:620;letter-spacing:-0.015em;color:var(--ff-color-ink)}.ff-theme .ff-feature-icon+.ff-feature-title{margin-top:1.5rem}.ff-theme .ff-feature-details{flex-grow:1;margin:.75rem 0 0;padding:0;font-size:.9375rem;line-height:1.7;color:var(--ff-color-ink-muted)}.ff-theme ul.ff-feature-details{padding-left:1rem;list-style:disc}.ff-theme .ff-feature-link{margin-top:1.75rem;color:var(--ff-color-accent)}@media(width >= 640px){.ff-theme .VPFeatures{padding:3rem 3rem 3.5rem}.ff-theme .VPFeatures .items{grid-template-columns:repeat(2, minmax(0, 1fr))}}@media(width >= 960px){.ff-theme .VPFeatures{padding:3.5rem 4rem 4rem}.ff-theme .VPFeatures .items:has(.grid-3){grid-template-columns:repeat(3, minmax(0, 1fr))}.ff-theme .VPFeatures .items:has(.grid-4),.ff-theme .VPFeatures .items:has(.grid-6){grid-template-columns:repeat(4, minmax(0, 1fr))}}.ff-theme .ff-sponsors{padding:2.5rem 1.5rem 3rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc .VPHomeSponsors.ff-sponsors{margin-left:-1.5rem;margin-right:-1.5rem}.ff-theme .ff-sponsors-container{max-width:var(--ff-layout-wide);margin:0 auto;text-align:center}.ff-theme .vp-doc .ff-sponsors-title{margin:0;border-top:0;padding-top:0;font-family:var(--ff-font-title);font-size:var(--ff-size-h1);font-weight:600;letter-spacing:0;word-spacing:-0.3em;text-transform:uppercase;color:var(--ff-color-ink);font-variation-settings:normal}.ff-theme .ff-sponsors-message{max-width:42ch;margin:.75rem auto 0;font-size:var(--ff-size-body);line-height:1.55;color:var(--ff-color-ink-muted)}.ff-theme .ff-sponsors-grid{margin-top:2rem}.ff-theme .ff-sponsors-grid.vp-sponsor{border-radius:var(--ff-radius-md)}.ff-theme .ff-sponsors-grid .vp-sponsor-grid{justify-content:center}.ff-theme .ff-sponsors-grid .vp-sponsor-grid-link{min-height:90px}.ff-theme .ff-sponsors-grid .vp-sponsor-grid-image{max-width:120px;max-height:32px}.ff-theme .ff-sponsors-grid .vp-sponsor-tier{display:flex;align-items:center;justify-content:flex-start;height:60px;margin:0 0 .25rem;padding:0 1.25rem;font-family:var(--ff-font-mono);font-size:14px;font-weight:500;letter-spacing:var(--ff-tracking-label);text-align:left;text-transform:uppercase;color:var(--ff-color-ink-faint)}.ff-theme .ff-sponsors-action{margin-top:2rem}@media(width >= 640px){.ff-theme .ff-sponsors{padding:3rem 3rem 3.5rem}.ff-theme .vp-doc .VPHomeSponsors.ff-sponsors{margin-left:-3rem;margin-right:-3rem}}@media(width >= 960px){.ff-theme .ff-sponsors{padding:3.5rem 4rem 4rem}.ff-theme .vp-doc .VPHomeSponsors.ff-sponsors{margin-left:-4rem;margin-right:-4rem}}.ff-banner-dismissed .ff-theme .ff-banner{display:none}:root:has(.ff-banner):not(.ff-banner-dismissed){--vp-layout-top-height: var(--ff-banner-height)}.ff-theme .ff-banner{position:fixed;top:0;right:0;left:0;z-index:var(--vp-z-index-layout-top);display:flex;align-items:center;justify-content:center;gap:1rem;min-height:var(--ff-banner-height);padding:.625rem 3rem;background:var(--ff-color-ink);color:var(--ff-color-paper)}.ff-theme[data-nav-sticky=false] .ff-banner{position:relative}.ff-theme .ff-banner[data-variant=ink]{--ff-banner-from: var(--ff-color-ink);--ff-banner-to: var(--ff-color-ink-muted);color:var(--ff-color-paper)}.ff-theme .ff-banner[data-variant=accent]{--ff-banner-from: var(--ff-color-accent);--ff-banner-to: var(--ff-color-accent-hover);color:var(--ff-color-accent-contrast)}.ff-theme .ff-banner[data-variant=success]{--ff-banner-from: var(--ff-color-success);--ff-banner-to: var(--ff-color-ink);color:var(--ff-color-paper)}.ff-theme .ff-banner[data-variant=warning]{--ff-banner-from: var(--ff-color-warning);--ff-banner-to: var(--ff-color-ink);color:var(--ff-color-paper)}.ff-theme .ff-banner[data-variant=danger]{--ff-banner-from: var(--ff-color-danger);--ff-banner-to: var(--ff-color-ink);color:var(--ff-color-paper)}.ff-theme .ff-banner:not([data-gradient]){background:var(--ff-banner-from)}.ff-theme .ff-banner[data-gradient]{background:linear-gradient(100deg, var(--ff-banner-from), var(--ff-banner-to))}.ff-theme .ff-banner[data-variant=rainbow]{background:linear-gradient(100deg, var(--ff-color-accent), var(--ff-color-danger), var(--ff-color-warning), var(--ff-color-success));color:var(--ff-color-accent-contrast)}.ff-theme .ff-banner-icon{font-size:1rem;line-height:1}.ff-theme .ff-banner-body{display:flex;align-items:center;gap:.75rem;font-size:.8125rem;color:inherit}.ff-theme .ff-banner-cta{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);text-transform:uppercase;letter-spacing:var(--ff-tracking-label);text-decoration:underline;text-underline-offset:.25em}.ff-theme .ff-banner-close{position:absolute;top:50%;right:1rem;display:flex;align-items:center;justify-content:center;width:1.5rem;height:1.5rem;border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0);font-size:1.125rem;line-height:1;color:inherit;opacity:.6;transform:translateY(-50%);cursor:pointer}.ff-theme .ff-banner-close:hover{opacity:1}.ff-theme .ff-doc-meta{flex-wrap:wrap;gap:.75rem;margin-bottom:1.5rem;padding-bottom:1rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-doc-meta-item+.ff-doc-meta-item::before{content:"·";margin-right:.75rem}.ff-theme .ff-to-top{position:fixed;right:1.5rem;bottom:1.5rem;z-index:20;gap:.375rem;padding:.625rem .75rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:var(--ff-color-surface);cursor:pointer;opacity:0;transform:translateY(0.5rem);pointer-events:none;transition:opacity var(--ff-motion-duration) var(--ff-motion-ease),transform var(--ff-motion-duration) var(--ff-motion-ease),border-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-to-top.is-visible{opacity:1;transform:translateY(0);pointer-events:auto}.ff-theme .ff-footer{position:relative;z-index:var(--vp-z-index-footer);padding:3.5rem 1.5rem 2.5rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule);background:var(--ff-color-paper)}.ff-theme .ff-footer.has-sidebar{display:none}.ff-theme .ff-footer-container{max-width:var(--ff-layout-wide);margin:0 auto}.ff-theme .ff-footer-top{display:flex;flex-wrap:wrap;justify-content:space-between;gap:2rem}.ff-theme .ff-footer-columns{flex:1 1 auto;display:grid;grid-template-columns:repeat(auto-fill, minmax(9rem, 12rem));gap:2rem}.ff-theme .ff-footer-social a{display:inline-flex;align-items:center;gap:.5rem;text-transform:capitalize}.ff-theme .ff-footer-social a>span:first-child{flex:none;font-size:1.05em;opacity:.8}.ff-theme .ff-footer-column ul{margin:1rem 0 0;padding:0;list-style:none}.ff-theme .ff-footer-column li+li{margin-top:.5rem}.ff-theme .ff-footer-column a{font-size:.875rem;color:var(--ff-color-ink-muted);transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-footer-column a:hover{color:var(--ff-color-ink)}.ff-theme .ff-footer-legal{display:flex;flex-wrap:wrap;justify-content:space-between;gap:.5rem 2rem;margin-top:3rem;padding-top:1.5rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule);font-family:var(--ff-font-mono);font-size:var(--ff-size-meta);color:var(--ff-color-ink-faint)}.ff-theme .ff-footer-legal p{margin:0}@media(width >= 768px){.ff-theme .ff-footer{padding:4rem 3rem 2.5rem}.ff-theme .ff-footer-social{margin-left:auto}}.ff-theme .vp-doc .ff-card-grid{display:grid;grid-template-columns:repeat(var(--ff-card-columns, 2), minmax(0, 1fr));gap:1rem;margin:1.75rem 0}.ff-theme .vp-doc .ff-card{display:block;padding:1.25rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md);background:var(--ff-color-surface);transition:border-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .vp-doc a.ff-card{text-decoration:none}.ff-theme .vp-doc a.ff-card:hover{border-color:var(--ff-color-accent)}.ff-theme .vp-doc .ff-card-icon{display:block;margin-bottom:.75rem;font-size:1.25rem;line-height:1;color:var(--ff-color-accent)}.ff-theme .vp-doc .ff-card-title{margin:0;font-family:var(--ff-font-display);font-size:1rem;font-weight:620;letter-spacing:-0.01em;color:var(--ff-color-ink)}.ff-theme .vp-doc .ff-card-body,.ff-theme .vp-doc .ff-card-body p{margin:.5rem 0 0;font-size:.9375rem;line-height:1.6;color:var(--ff-color-ink-muted)}@media(width <= 640px){.ff-theme .vp-doc .ff-card-grid{grid-template-columns:minmax(0, 1fr)}}.ff-theme .vp-doc .ff-steps ol{margin:1.75rem 0;padding-left:2.5rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule);list-style:none;counter-reset:ff-step}.ff-theme .vp-doc .ff-steps ol>li{position:relative;margin:0;padding-bottom:1.5rem;counter-increment:ff-step}.ff-theme .vp-doc .ff-steps ol>li:last-child{padding-bottom:0}.ff-theme .vp-doc .ff-steps ol>li::before{content:counter(ff-step, decimal-leading-zero);position:absolute;top:.25rem;left:-3.25rem;width:1.5rem;padding:.125rem 0;background:var(--ff-color-paper);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-align:center;color:var(--ff-color-accent)}.ff-theme .vp-doc .ff-api{margin:2.5rem 0;padding-top:1.25rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc .ff-api-head{display:flex;flex-wrap:wrap;align-items:baseline;gap:.75rem}.ff-theme .vp-doc .ff-api-name,.ff-theme .vp-doc .ff-api-signature code{padding:0;border-radius:0;background:rgba(0,0,0,0);font-family:var(--ff-font-mono)}.ff-theme .vp-doc .ff-api-name{font-size:1.0625rem;font-weight:600;color:var(--ff-color-ink)}.ff-theme .vp-doc .ff-api.is-deprecated .ff-api-name{text-decoration:line-through;color:var(--ff-color-ink-faint)}.ff-theme .vp-doc .ff-api-kind{color:var(--ff-color-accent)}.ff-theme .vp-doc .ff-api-deprecated{color:var(--ff-color-danger)}.ff-theme .vp-doc .ff-api-signature{margin:.625rem 0 0}.ff-theme .vp-doc .ff-api-signature code{font-size:.8125rem;color:var(--ff-color-ink-muted)}.ff-theme .vp-doc .ff-api-body>:first-child{margin-top:.75rem}.ff-theme .vp-doc .ff-kbd{display:inline-block;min-width:1.5rem;padding:.0625rem .375rem;border:var(--ff-rule-width) solid var(--ff-color-rule-strong);border-radius:var(--ff-radius-sm);background:var(--ff-color-surface);font-family:var(--ff-font-mono);font-size:.75rem;line-height:1.4;text-align:center;color:var(--ff-color-ink-muted)}@keyframes ff-rise{from{opacity:0;transform:translateY(0.875rem)}to{opacity:1;transform:none}}@keyframes ff-drift{from{transform:translate3d(-4%, -3%, 0) scale(1)}to{transform:translate3d(6%, 4%, 0) scale(1.12)}}@media(prefers-reduced-motion: no-preference){.ff-theme .ff-hero-glow{animation:ff-drift 26s var(--ff-motion-ease) infinite alternate}.ff-theme .ff-hero-kicker,.ff-theme .ff-hero-title,.ff-theme .ff-hero-tagline,.ff-theme .ff-hero-main .ff-hero-actions,.ff-theme .ff-hero-panel,.ff-theme .ff-hero-meta,.ff-theme .ff-hero-image{animation:ff-rise .65s var(--ff-motion-ease) both}.ff-theme .ff-hero-title{animation-delay:.06s}.ff-theme .ff-hero-tagline{animation-delay:.12s}.ff-theme .ff-hero-main .ff-hero-actions{animation-delay:.18s}.ff-theme .ff-hero-panel{animation-delay:.2s;animation-duration:.8s}.ff-theme .ff-hero-meta{animation-delay:.3s}.ff-theme .ff-hero-image{animation-delay:.14s;animation-duration:.9s}}.ff-theme .ff-btn,.ff-theme .VPButton{transition:background-color var(--ff-motion-duration) var(--ff-motion-ease),border-color var(--ff-motion-duration) var(--ff-motion-ease),box-shadow var(--ff-motion-duration) var(--ff-motion-ease),color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-btn-brand:hover,.ff-theme .VPButton.brand:hover{box-shadow:0 .5rem 1.5rem var(--ff-color-accent-glow)}.ff-theme .VPNavBarMenuLink{position:relative}.ff-theme .VPNavBarMenuLink::after{content:"";position:absolute;right:.75rem;bottom:1rem;left:.75rem;height:2px;background:var(--ff-color-accent);transform:scaleX(0);transform-origin:left;transition:transform var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .VPNavBarMenuLink:hover::after,.ff-theme .VPNavBarMenuLink.active::after{transform:scaleX(1)}.ff-theme .VPNavBarMenuLink.active{text-decoration:none}.ff-theme .ff-feature::after{content:"";position:absolute;z-index:-1;inset:0;background:linear-gradient(160deg, var(--ff-color-accent-soft), transparent 60%);opacity:0;transition:opacity var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme a.ff-feature:hover::after{opacity:1}.ff-theme .ff-feature-index::before{transition:color var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme .vp-doc .ff-card{transition:border-color var(--ff-motion-duration-slow) var(--ff-motion-ease),box-shadow var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme .vp-doc a.ff-card:hover{box-shadow:0 .75rem 1.75rem var(--ff-color-accent-glow)}.ff-theme .vp-doc div[class*=language-]{transition:border-color var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme .vp-doc div[class*=language-]:hover{border-color:var(--ff-color-rule-strong)}.ff-theme .ff-to-top:hover{border-color:var(--ff-color-accent);color:var(--ff-color-accent)}.ff-theme .ff-hero-copy,.ff-theme .ff-banner-close,.ff-theme .ff-to-top,.ff-theme .VPNavBarSearchButton,.ff-theme .vp-doc [class*=language-]>button.copy,.ff-theme .VPDocFooter .pager-link .title,.ff-theme .ff-footer-column a,.ff-theme .VPDocAsideOutline .outline-link,.ff-theme .VPSidebarItem .link .text{transition:background-color var(--ff-motion-duration) var(--ff-motion-ease),border-color var(--ff-motion-duration) var(--ff-motion-ease),color var(--ff-motion-duration) var(--ff-motion-ease),opacity var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-to-top{transition:border-color var(--ff-motion-duration) var(--ff-motion-ease),color var(--ff-motion-duration) var(--ff-motion-ease),opacity var(--ff-motion-duration-slow) var(--ff-motion-ease),transform var(--ff-motion-duration-slow) var(--ff-motion-ease)}
|
|
1
|
+
:root{--ff-font-display:inter,ui-sans-serif,system-ui,sans-serif;--ff-font-title:var(--vp-font-family-mono);--ff-font-body:var(--vp-font-family-base);--ff-font-mono:var(--vp-font-family-mono);--ff-tracking-display:-0.025em;--ff-tracking-label:.1em;--ff-size-label:.6875rem;--ff-size-meta:.75rem;--ff-size-body:1rem;--ff-size-lead:1.125rem;--ff-size-h1:clamp(1.625rem,1.3rem + 1.3vw,2rem);--ff-size-h2:1.5rem;--ff-size-h3:1.1875rem;--ff-size-hero:clamp(1.5rem,1.05rem + 1.8vw,2.375rem);--ff-leading-body:1.75;--ff-leading-tight:1.15;--ff-radius-sm:5px;--ff-radius-md:10px;--ff-rule-width:1px;--ff-rule-accent-width:2px;--ff-motion-duration:200ms;--ff-motion-duration-slow:420ms;--ff-motion-ease:cubic-bezier(0.2, 0.6, 0.2, 1);--ff-banner-height:2.6875rem;--ff-hero-glow-opacity:0;--ff-layout-content:44rem;--ff-layout-wide:76rem;--ff-color-paper:#fbfaf8;--ff-color-surface:#fff;--ff-color-surface-alt:#f4f2ee;--ff-color-ink:#1a1917;--ff-color-ink-muted:#55524c;--ff-color-ink-faint:#6b665e;--ff-color-rule:#e6e2da;--ff-color-rule-strong:#d3cec4;--ff-color-accent:#2745cf;--ff-color-accent-hover:#1b34a8;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(39,69,207,.09);--ff-color-accent-glow:rgba(39,69,207,.16);--ff-color-success:#1c7a52;--ff-color-warning:#8a5a00;--ff-color-danger:#b32835;color-scheme:light}.dark{--ff-color-paper:#121110;--ff-color-surface:#1a1917;--ff-color-surface-alt:#201e1b;--ff-color-ink:#ece9e3;--ff-color-ink-muted:#a5a099;--ff-color-ink-faint:#8f8a82;--ff-color-rule:#2c2a26;--ff-color-rule-strong:#423e38;--ff-color-accent:#94a8ff;--ff-color-accent-hover:#b5c2ff;--ff-color-accent-contrast:#101018;--ff-color-accent-soft:rgba(148,168,255,.13);--ff-color-accent-glow:rgba(148,168,255,.2);--ff-color-success:#4ac48b;--ff-color-warning:#e0a942;--ff-color-danger:#f0707f;color-scheme:dark}:root{--vp-c-bg: var(--ff-color-paper);--vp-c-bg-alt: var(--ff-color-surface-alt);--vp-c-bg-elv: var(--ff-color-surface);--vp-c-bg-soft: var(--ff-color-surface-alt);--vp-c-text-1: var(--ff-color-ink);--vp-c-text-2: var(--ff-color-ink-muted);--vp-c-text-3: var(--ff-color-ink-faint);--vp-c-border: var(--ff-color-rule-strong);--vp-c-divider: var(--ff-color-rule);--vp-c-gutter: var(--ff-color-rule);--vp-c-brand-1: var(--ff-color-accent);--vp-c-brand-2: var(--ff-color-accent-hover);--vp-c-brand-3: var(--ff-color-accent);--vp-c-brand-soft: var(--ff-color-accent-soft);--vp-c-default-1: var(--ff-color-rule-strong);--vp-c-default-2: var(--ff-color-rule);--vp-c-default-3: var(--ff-color-surface-alt);--vp-c-default-soft: var(--ff-color-accent-soft);--vp-c-tip-1: var(--ff-color-accent);--vp-c-tip-soft: transparent;--vp-c-note-1: var(--ff-color-accent);--vp-c-note-soft: transparent;--vp-c-success-1: var(--ff-color-success);--vp-c-success-soft: transparent;--vp-c-warning-1: var(--ff-color-warning);--vp-c-warning-soft: transparent;--vp-c-danger-1: var(--ff-color-danger);--vp-c-danger-soft: transparent;--vp-c-caution-1: var(--ff-color-danger);--vp-c-caution-soft: transparent;--vp-c-important-1: var(--ff-color-accent);--vp-c-important-soft: transparent;--vp-shadow-1: none;--vp-shadow-2: none;--vp-shadow-3: 0 16px 40px rgb(0 0 0 / 0.08);--vp-shadow-4: 0 16px 40px rgb(0 0 0 / 0.1);--vp-shadow-5: 0 24px 64px rgb(0 0 0 / 0.12);--ff-frame: max(4rem, calc((100% - var(--ff-layout-wide)) / 2));--vp-nav-height: 60px;--vp-nav-bg-color: var(--ff-color-paper);--vp-nav-backdrop-filter: none;--vp-layout-max-width: 76rem;--vp-sidebar-width: 15rem;--vp-header-anchor-symbol: "#";--vp-code-font-size: 0.8125em;--vp-code-color: var(--ff-color-ink);--vp-code-bg: var(--ff-color-surface-alt);--vp-code-block-color: var(--ff-color-ink-muted);--vp-code-block-bg: var(--ff-color-surface);--vp-code-block-divider-color: var(--ff-color-rule);--vp-code-copy-code-border-color: var(--ff-color-rule);--vp-code-copy-code-bg: var(--ff-color-surface);--vp-code-copy-code-hover-bg: var(--ff-color-surface-alt);--vp-code-tab-divider: var(--ff-color-rule);--vp-code-tab-active-bar-color: var(--ff-color-accent);--vp-button-brand-border: var(--ff-color-accent);--vp-button-brand-text: var(--ff-color-accent-contrast);--vp-button-brand-bg: var(--ff-color-accent);--vp-button-brand-hover-border: var(--ff-color-accent-hover);--vp-button-brand-hover-text: var(--ff-color-accent-contrast);--vp-button-brand-hover-bg: var(--ff-color-accent-hover);--vp-button-brand-active-bg: var(--ff-color-accent-hover);--vp-button-alt-border: var(--ff-color-rule-strong);--vp-button-alt-text: var(--ff-color-ink);--vp-button-alt-bg: transparent;--vp-button-alt-hover-border: var(--ff-color-ink);--vp-button-alt-hover-text: var(--ff-color-ink);--vp-button-alt-hover-bg: transparent;--vp-button-alt-active-bg: var(--ff-color-surface-alt);--vp-custom-block-font-size: 0.9375rem;--vp-custom-block-code-font-size: 0.8125rem;--vp-home-hero-name-color: var(--ff-color-ink)}.ff-theme{font-family:var(--ff-font-body);font-size:var(--ff-size-body);line-height:var(--ff-leading-body);-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.ff-label{display:inline-flex;align-items:center;gap:.5em;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;line-height:1;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-display{font-family:var(--ff-font-display);font-weight:620;letter-spacing:var(--ff-tracking-display);line-height:var(--ff-leading-tight);font-variation-settings:"opsz" 32}::selection{background:var(--ff-color-accent-soft)}.ff-theme :focus-visible,.VPLocalSearchBox :focus-visible{outline:2px solid var(--ff-color-accent);outline-offset:2px;border-radius:var(--ff-radius-sm)}.ff-theme *{scrollbar-width:thin;scrollbar-color:var(--ff-color-rule-strong) rgba(0,0,0,0)}.ff-theme .VPButton{border-radius:var(--ff-radius-sm);border-width:var(--ff-rule-width);font-weight:550;letter-spacing:.01em;transition:background-color var(--ff-motion-duration) var(--ff-motion-ease),border-color var(--ff-motion-duration) var(--ff-motion-ease),color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .VPButton.medium{padding:0 1.25rem;line-height:2.75rem;font-size:.875rem}.ff-theme .VPButton.big{padding:0 1.75rem;line-height:3.25rem;font-size:.9375rem}.ff-theme .VPBadge{border-radius:var(--ff-radius-sm);border:var(--ff-rule-width) solid var(--ff-color-rule-strong);background:rgba(0,0,0,0);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-transform:uppercase;letter-spacing:.06em;color:var(--ff-color-ink-muted)}.ff-theme .VPBadge.tip,.ff-theme .VPBadge.info{border-color:var(--ff-color-accent);color:var(--ff-color-accent)}.ff-theme .VPBadge.warning{border-color:var(--ff-color-warning);color:var(--ff-color-warning)}.ff-theme .VPBadge.danger{border-color:var(--ff-color-danger);color:var(--ff-color-danger)}@media(forced-colors: active){.ff-theme .ff-hero-command-tab.active::after{background:Highlight}.ff-theme .ff-hero-copy{border-color:ButtonText}}.ff-theme .VPNavBar{border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme[data-nav-sticky=false] .VPNav{position:relative;top:0}.ff-theme[data-nav-sticky=false] .VPContent{margin-top:0}@media(width >= 960px){.ff-theme[data-nav-sticky=false] .VPContent{padding-top:0}}.ff-theme[data-nav-order=menu-first] .content-body .menu{order:1;flex-grow:0;margin-left:1.5rem;margin-right:auto}.ff-theme[data-nav-order=menu-first] .content-body .search{order:2;margin-right:0}.ff-theme[data-nav-order=menu-first] .content-body .translations{order:3}.ff-theme[data-nav-order=menu-first] .content-body .appearance{order:4}.ff-theme[data-nav-order=menu-first] .content-body .social-links{order:5}.ff-theme[data-nav-order=menu-first] .content-body .extra{order:6}.ff-theme[data-nav-order=menu-first] .content-body .hamburger{order:7}.ff-theme .VPNavBar.has-sidebar .curtain,.ff-theme .VPNavBar .divider{display:none}.ff-theme .VPNavBar:not(.has-sidebar) .container{max-width:var(--ff-layout-wide)}@media(width >= 640px){.ff-theme .VPNavBar:not(.has-sidebar) .wrapper{padding:0 3rem}}@media(width >= 960px){.ff-theme .VPNavBar:not(.has-sidebar) .wrapper{padding:0 4rem}.ff-theme .VPNavBar.has-sidebar{--vp-nav-col-offset: calc(var(--ff-frame) + var(--vp-sidebar-width))}.ff-theme .VPNavBar.has-sidebar .wrapper{padding:0}.ff-theme .VPNavBar.has-sidebar .container{max-width:none;padding-right:var(--ff-frame);padding-left:var(--ff-frame)}.ff-theme .VPNavBar.has-sidebar .container>.title{min-width:var(--vp-sidebar-width);max-width:var(--vp-sidebar-width)}}.ff-theme .VPNavBar .content-body{background:rgba(0,0,0,0)}.ff-theme .VPNavBarTitle .title{border-bottom:0;gap:.625rem;font-family:var(--ff-font-display);font-size:.9375rem;font-weight:620;letter-spacing:-0.01em}.ff-theme .VPNavBarTitle .title:not(:has(.logo))::before{content:"";width:.5rem;height:.5rem;background:var(--ff-color-accent)}.ff-theme .VPNavBarMenuLink,.ff-theme .VPNavBarMenuGroup .button{font-size:.875rem;font-weight:500;color:var(--ff-color-ink-muted);transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .VPNavBarMenuLink:hover,.ff-theme .VPNavBarMenuGroup .button:hover{color:var(--ff-color-ink)}.ff-theme .VPNavBarMenuLink.active{color:var(--ff-color-ink);text-decoration:underline;text-decoration-color:var(--ff-color-accent);text-decoration-thickness:2px;text-underline-offset:.5rem}.ff-theme .VPNavBarSearch .DocSearch-Button,.ff-theme .VPNavBarSearchButton{display:flex;align-items:center;gap:.5rem;padding:0 .5rem 0 .625rem;height:2rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0);font-size:.8125rem;color:var(--ff-color-ink-faint);transition:border-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .VPNavBarSearchButton:hover{border-color:var(--ff-color-rule-strong);color:var(--ff-color-ink-muted)}.ff-theme .VPNavBarSearchButton .keys kbd,.ff-theme .VPNavBarSearchButton .keys .key-cmd{border:0;border-radius:0;background:rgba(0,0,0,0);box-shadow:none;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);color:var(--ff-color-ink-faint)}.ff-theme .VPSwitch{border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0)}.ff-theme .VPSwitch .check{border-radius:2px;background:var(--ff-color-surface-alt);box-shadow:none}.ff-theme .VPSwitch .icon{border-radius:2px}.ff-theme .VPLocalNav .menu-text,.ff-theme .VPLocalNavOutlineDropdown .menu-text,.ff-theme .VPLocalNavOutlineDropdown button{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);text-transform:uppercase;letter-spacing:var(--ff-tracking-label)}.ff-theme .VPNavScreen{background:var(--ff-color-paper)}.ff-theme .VPNavScreenMenuLink,.ff-theme .VPNavScreenMenuGroupLink{border-bottom:var(--ff-rule-width) solid var(--ff-color-rule);font-weight:500}.VPLocalSearchBox .shell{border:var(--ff-rule-width) solid var(--ff-color-rule-strong);border-radius:var(--ff-radius-md);background:var(--ff-color-paper)}.VPLocalSearchBox .search-actions button,.VPLocalSearchBox .search-keyboard-shortcuts{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);text-transform:uppercase;letter-spacing:.06em}.VPLocalSearchBox .titles .title{font-weight:500}.VPLocalSearchBox .result{border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0)}.VPLocalSearchBox .result.selected{border-color:var(--ff-color-accent);background:var(--ff-color-accent-soft)}.ff-theme .VPSidebar{border-right:var(--ff-rule-width) solid var(--ff-color-rule);background:var(--ff-color-paper)}.ff-theme .VPSidebar .curtain{background:var(--ff-color-paper)}.ff-theme .VPSidebar .nav{padding-top:1.5rem}.ff-theme .VPSidebar .nav{counter-reset:ff-section}.ff-theme .VPSidebar .group{counter-increment:ff-section}.ff-theme .VPSidebar .group+.group{margin-top:1.75rem;padding-top:1.5rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .VPSidebar .group .VPSidebarItem.level-0{padding-bottom:0}.ff-theme .VPSidebar .group>.VPSidebarItem.level-0>.item{position:relative;align-items:center;gap:.75rem;padding-bottom:.75rem}.ff-theme .VPSidebar .group>.VPSidebarItem.level-0>.item::before{content:counter(ff-section, decimal-leading-zero);font-family:var(--ff-font-mono);font-size:.8125rem;font-weight:600;line-height:1.4;letter-spacing:.02em;color:var(--ff-color-accent)}.ff-theme .VPSidebarItem.level-0>.item>.text{padding:0;font-family:var(--ff-font-mono);font-size:.8125rem;font-weight:600;line-height:1.4;text-transform:uppercase;letter-spacing:.08em;color:var(--ff-color-ink)}.ff-theme .VPSidebarItem.level-1 .text,.ff-theme .VPSidebarItem.level-2 .text,.ff-theme .VPSidebarItem.level-3 .text{padding:.25rem 0;font-size:.875rem;font-weight:450;line-height:1.6;color:var(--ff-color-ink-muted)}.ff-theme .VPSidebarItem.is-link.is-active>.item>.link>.text{font-weight:600}.ff-theme .VPSidebarItem.level-1>.item>.text,.ff-theme .VPSidebarItem.level-2>.item>.text,.ff-theme .VPSidebarItem.level-3>.item>.text{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:600;text-transform:uppercase;letter-spacing:.06em;color:var(--ff-color-ink-faint)}.ff-theme .VPSidebarItem.level-1 .items{margin-top:.25rem;padding-left:.875rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .VPSidebarItem.level-2 .text,.ff-theme .VPSidebarItem.level-3 .text{padding:.375rem 0;font-size:.8125rem}.ff-theme .VPSidebarItem.is-active>.item>.indicator{top:.5rem;bottom:.5rem;width:var(--ff-rule-accent-width);border-radius:0;background-color:var(--ff-color-accent)}.ff-theme .VPSidebarItem .caret{margin-right:-0.5rem;color:var(--ff-color-ink-faint)}@media(width >= 960px){.ff-theme .VPSidebar{padding-left:var(--ff-frame);width:calc(var(--ff-frame) + var(--vp-sidebar-width))}.ff-theme .VPContent.has-sidebar{padding-right:var(--ff-frame);padding-left:calc(var(--ff-frame) + var(--vp-sidebar-width))}.ff-theme .VPDoc.has-sidebar{padding-right:0;padding-left:0}.ff-theme .VPLocalNav.has-sidebar{padding-left:calc(var(--ff-frame) + var(--vp-sidebar-width))}}@media(width >= 1280px){.ff-theme .VPDoc .aside{flex:0 0 auto;width:16rem}.ff-theme .VPDoc .content{min-width:0}}.ff-theme .VPDoc .container{max-width:none}.ff-theme .VPDoc.has-aside .content-container,.ff-theme .VPDoc .content-container{max-width:var(--ff-layout-content)}.ff-theme .VPDoc:not(.has-sidebar) .content{max-width:none}.ff-theme .vp-doc h1,.ff-theme .vp-doc h2,.ff-theme .vp-doc h3,.ff-theme .vp-doc h4{font-family:var(--ff-font-display);letter-spacing:var(--ff-tracking-display);font-variation-settings:"opsz" 32}.ff-theme .vp-doc h1{margin:0 0 1.25rem;font-size:var(--ff-size-h1);font-weight:620;line-height:var(--ff-leading-tight);letter-spacing:-0.03em}.ff-theme .vp-doc h2{--ff-h2-rule-gap: 1.75rem;margin:3.5rem 0 1.25rem;padding-top:var(--ff-h2-rule-gap);border-top:var(--ff-rule-width) solid var(--ff-color-rule);border-image:linear-gradient(90deg, var(--ff-color-rule-strong), transparent 85%) 1;font-size:var(--ff-size-h2);font-weight:600;line-height:1.3}.ff-theme .vp-doc h3{margin:2.5rem 0 .75rem;font-size:var(--ff-size-h3);font-weight:600;letter-spacing:-0.015em}.ff-theme .vp-doc h4{margin:2rem 0 .5rem;font-size:1rem;font-weight:600}.ff-theme .vp-doc .header-anchor{left:-1.5rem;margin-left:0;font-family:var(--ff-font-mono);font-weight:400;color:var(--ff-color-ink-faint);opacity:0;transition:opacity var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .vp-doc h2 .header-anchor{top:var(--ff-h2-rule-gap)}.ff-theme .vp-doc h1:hover .header-anchor,.ff-theme .vp-doc h2:hover .header-anchor,.ff-theme .vp-doc h3:hover .header-anchor,.ff-theme .vp-doc h4:hover .header-anchor,.ff-theme .vp-doc .header-anchor:focus{opacity:1}.ff-theme .vp-doc p,.ff-theme .vp-doc li{line-height:var(--ff-leading-body);color:var(--ff-color-ink)}.ff-theme .vp-doc p{margin:1.25rem 0}.ff-theme .vp-doc>div>h1+p{margin-top:1.5rem;font-size:var(--ff-size-body);line-height:1.65;color:var(--ff-color-ink-muted)}.ff-theme .vp-doc a{font-weight:inherit;color:var(--ff-color-accent);text-decoration-thickness:1px;text-underline-offset:.2em;text-decoration-color:var(--ff-color-accent-soft);transition:text-decoration-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .vp-doc a:hover{text-decoration-color:currentcolor}.ff-theme .vp-doc strong{font-weight:620;color:var(--ff-color-ink)}.ff-theme .vp-doc blockquote{margin:1.75rem 0;padding-left:1.25rem;border-left:var(--ff-rule-accent-width) solid var(--ff-color-rule-strong)}.ff-theme .vp-doc blockquote>p{font-size:1rem;font-style:italic;color:var(--ff-color-ink-muted)}.ff-theme .vp-doc hr{margin:3rem 0;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc :not(pre)>code{padding:.15em .35em;border-radius:var(--ff-radius-sm);background:var(--ff-color-surface-alt);font-size:.8125em;color:var(--ff-color-ink)}.ff-theme .vp-doc a>code{color:var(--ff-color-accent)}.ff-theme .vp-doc h1 code,.ff-theme .vp-doc h2 code,.ff-theme .vp-doc h3 code,.ff-theme .vp-doc h4 code{padding:0;border-radius:0;background:rgba(0,0,0,0);font-size:.9em;font-weight:600;color:inherit}.ff-theme .vp-doc table{display:table;width:100%;margin:1.75rem 0;border-collapse:collapse}.ff-theme .vp-doc tr{border:0;background:rgba(0,0,0,0)}.ff-theme .vp-doc th{padding:.5rem .875rem .5rem 0;border:0;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule-strong);background:rgba(0,0,0,0);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-align:left;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-theme .vp-doc td{padding:.75rem .875rem .75rem 0;border:0;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule);font-size:.9375rem;line-height:1.6;vertical-align:top}.ff-theme .vp-doc th:last-child,.ff-theme .vp-doc td:last-child{padding-right:0}.ff-theme .vp-doc img{border-radius:var(--ff-radius-md)}.ff-theme .VPDocFooter{margin-top:3.5rem}.ff-theme .VPDocFooter .edit-info{padding-bottom:1.25rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .VPDocFooter .edit-link-button,.ff-theme .VPDocFooter .last-updated{font-family:var(--ff-font-mono);font-size:var(--ff-size-meta);font-weight:400;color:var(--ff-color-ink-faint)}.ff-theme .VPDocFooter .edit-link-button{color:var(--ff-color-accent)}.ff-theme .VPDocFooter .prev-next{margin-top:0;padding-top:0;border-top:0;gap:0}.ff-theme .VPDocFooter .pager-link{padding:1.5rem 0;border:0;border-bottom:var(--ff-rule-accent-width) solid var(--ff-color-rule);border-radius:0;background:rgba(0,0,0,0);transition:border-color var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme .VPDocFooter .pager-link:hover{border-bottom-color:var(--ff-color-accent)}.ff-theme .VPDocFooter .pager-link .desc{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-theme .VPDocFooter .pager-link .title{font-family:var(--ff-font-display);font-size:1.0625rem;font-weight:600;letter-spacing:-0.015em;color:var(--ff-color-ink)}.ff-theme .VPDocFooter .pager-link .desc,.ff-theme .VPDocFooter .pager-link .title{transition:color var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme .VPDocFooter .pager-link:hover .desc,.ff-theme .VPDocFooter .pager-link:hover .title{color:var(--ff-color-accent)}.ff-theme .VPDocAsideOutline .content{padding-left:1rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .VPDocAsideOutline .outline-title{margin-bottom:.75rem;font-family:var(--ff-font-mono);font-size:var(--ff-size-meta);font-weight:600;line-height:1.4;text-transform:uppercase;letter-spacing:.08em;color:var(--ff-color-ink)}.ff-theme .VPDocAsideOutline .outline-marker{width:var(--ff-rule-accent-width);border-radius:0;background-color:var(--ff-color-accent)}.ff-theme .VPDocAsideOutline .outline-link{display:block;padding:.25rem 0;font-size:.875rem;font-weight:450;line-height:1.5;color:var(--ff-color-ink-muted);white-space:normal;overflow:visible;overflow-wrap:break-word;transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .VPDocAsideOutline .outline-link:hover{color:var(--ff-color-ink)}.ff-theme .VPDocAsideOutline .outline-link.active{font-weight:600;color:var(--ff-color-accent)}.ff-theme .VPDocAsideOutline .VPDocOutlineItem.nested{padding-left:.75rem}.ff-theme .VPDocAsideOutline .VPDocOutlineItem.nested .outline-link{font-size:.8125rem}.ff-theme .vp-doc div[class*=language-],.ff-theme .vp-doc .vp-block{margin:1.75rem 0;padding-top:2.5rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md);background:var(--ff-color-surface)}.ff-theme .vp-doc [class*=language-]>pre{margin:0;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc [class*=language-]>span.lang{display:flex;align-items:center;top:0;right:auto;left:0;height:2.5rem;padding:0 1rem;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint);opacity:1}.ff-theme .vp-doc [class*=language-]:hover>button.copy+span.lang,.ff-theme .vp-doc [class*=language-]>button.copy:focus+span.lang{opacity:1}.ff-theme .vp-doc [class*=language-]>button.copy{top:.4375rem;right:.625rem;width:1.75rem;height:1.75rem;border-radius:var(--ff-radius-sm);background-color:rgba(0,0,0,0);background-size:.875rem;opacity:.55}.ff-theme .vp-doc [class*=language-]:hover>button.copy,.ff-theme .vp-doc [class*=language-]>button.copy:focus{opacity:1}.ff-theme .vp-doc [class*=language-]>button.copy.copied,.ff-theme .vp-doc [class*=language-]>button.copy:hover.copied{border-radius:0 var(--ff-radius-sm) var(--ff-radius-sm) 0}.ff-theme .vp-doc [class*=language-]>button.copy.copied::before,.ff-theme .vp-doc [class*=language-]>button.copy:hover.copied::before{top:0;height:1.75rem;border-radius:var(--ff-radius-sm) 0 0 var(--ff-radius-sm);background:var(--ff-color-surface);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);text-transform:uppercase;letter-spacing:.06em}.ff-theme .vp-doc div[class*=language-].line-numbers-mode{padding-left:0}.ff-theme .vp-doc [class*=language-] .line-numbers-wrapper{top:2.5rem;border-right:var(--ff-rule-width) solid var(--ff-color-rule);font-family:var(--ff-font-mono);color:var(--ff-color-ink-faint)}.ff-theme .vp-doc [class*=language-] code .highlighted.error{box-shadow:inset var(--ff-rule-accent-width) 0 0 0 var(--ff-color-danger)}.ff-theme .vp-doc [class*=language-] code .highlighted.warning{box-shadow:inset var(--ff-rule-accent-width) 0 0 0 var(--ff-color-warning)}.ff-theme .vp-doc [class*=language-] code .diff.add{box-shadow:inset var(--ff-rule-accent-width) 0 0 0 var(--ff-color-success)}.ff-theme .vp-doc [class*=language-] code .diff.remove{box-shadow:inset var(--ff-rule-accent-width) 0 0 0 var(--ff-color-danger)}.ff-theme .vp-doc .vp-code-group{margin:1.75rem 0;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md);background:var(--ff-color-surface);overflow:hidden}.ff-theme .vp-doc .vp-code-group .tabs{margin:0;padding:0 .5rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:0;background:rgba(0,0,0,0);box-shadow:none}.ff-theme .vp-doc .vp-code-group .tabs label{padding:0 .75rem;line-height:2.5rem;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-theme .vp-doc .vp-code-group input:checked+label{color:var(--ff-color-ink)}.ff-theme .vp-doc .vp-code-group .tabs label::after{right:0;left:0;border-radius:0}.ff-theme .vp-doc .vp-code-group div[class*=language-]{margin:0;padding-top:0;border:0;border-radius:0}.ff-theme .vp-doc .vp-code-group div[class*=language-]>pre{border-top:0}.ff-theme .vp-doc .vp-code-group div[class*=language-]>span.lang,.ff-theme .vp-doc .custom-block div[class*=language-]>span.lang{display:none}.ff-theme .vp-doc .vp-code-group [class*=language-] .line-numbers-wrapper{top:0}.ff-theme .vp-doc .custom-block div[class*=language-]{padding-top:0;background:var(--ff-color-surface)}.ff-theme .vp-doc .custom-block div[class*=language-]>pre{border-top:0}.ff-theme .vp-doc .custom-block{margin:1.75rem 0;padding:0 0 0 1.25rem;border:0;border-left:var(--ff-rule-accent-width) solid var(--ff-color-rule-strong);border-radius:0;background:rgba(0,0,0,0);font-size:.9375rem}.ff-theme .vp-doc .custom-block p,.ff-theme .vp-doc .custom-block li{line-height:1.7;color:var(--ff-color-ink-muted)}.ff-theme .vp-doc .custom-block p:first-of-type{margin-top:0}.ff-theme .vp-doc .custom-block p:last-child{margin-bottom:0}.ff-theme .vp-doc .custom-block .custom-block-title{margin-bottom:.5rem;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;line-height:1;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-theme .vp-doc .custom-block.tip,.ff-theme .vp-doc .custom-block.note,.ff-theme .vp-doc .custom-block.info,.ff-theme .vp-doc .custom-block.important{border-left-color:var(--ff-color-accent)}.ff-theme .vp-doc .custom-block.tip .custom-block-title,.ff-theme .vp-doc .custom-block.note .custom-block-title,.ff-theme .vp-doc .custom-block.important .custom-block-title{color:var(--ff-color-accent)}.ff-theme .vp-doc .custom-block.warning{border-left-color:var(--ff-color-warning)}.ff-theme .vp-doc .custom-block.warning .custom-block-title{color:var(--ff-color-warning)}.ff-theme .vp-doc .custom-block.danger,.ff-theme .vp-doc .custom-block.caution{border-left-color:var(--ff-color-danger)}.ff-theme .vp-doc .custom-block.danger .custom-block-title,.ff-theme .vp-doc .custom-block.caution .custom-block-title{color:var(--ff-color-danger)}.ff-theme .vp-doc .custom-block a{font-weight:inherit}.ff-theme .vp-doc .custom-block.details{padding:1rem 1.25rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md)}.ff-theme .vp-doc .custom-block.details summary{margin-bottom:0;font-family:var(--ff-font-mono);font-size:var(--ff-size-meta);font-weight:500;text-transform:uppercase;letter-spacing:.06em;color:var(--ff-color-ink);cursor:pointer}.ff-theme .vp-doc .custom-block.details[open] summary{margin-bottom:.75rem}.ff-theme .VPHome{margin-bottom:0}.ff-theme .ff-hero{--ff-hero-offset: calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px));position:relative;margin-top:calc(var(--ff-hero-offset)*-1);padding:calc(var(--ff-hero-offset) + 1.5rem) 1.5rem 3.5rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule);overflow:hidden}.ff-theme[data-nav-sticky=false] .ff-hero{--ff-hero-offset: 0px}.ff-theme .VPNavBar.home.top{border-bottom-color:rgba(0,0,0,0)}.ff-theme .ff-hero-glow{position:absolute;top:-50%;left:-6%;display:block;width:min(72rem,150%);aspect-ratio:1;background:radial-gradient(circle closest-side at 45% 45%, var(--ff-color-accent-glow), transparent);opacity:var(--ff-hero-glow-opacity);pointer-events:none}.ff-theme .ff-hero-glow-far{top:-20%;right:-20%;left:auto;width:min(50rem,100%);background:radial-gradient(circle closest-side at 50% 50%, var(--ff-color-accent-soft), transparent)}.ff-theme .ff-hero-container{position:relative;display:grid;gap:3rem;max-width:var(--ff-layout-wide);margin:0 auto}.ff-theme .ff-hero-kicker{margin:0 0 1.5rem;color:var(--ff-color-ink-muted)}.ff-theme .ff-hero-title{max-width:20ch;margin:0;font-family:var(--ff-font-title);font-size:var(--ff-size-hero);font-weight:600;letter-spacing:0;word-spacing:-0.3em;text-transform:uppercase;color:var(--ff-color-ink);text-wrap:balance;font-variation-settings:normal}.ff-theme .ff-hero-tagline{max-width:42ch;margin:1.75rem 0 0;font-size:var(--ff-size-body);line-height:1.55;color:var(--ff-color-ink-muted);text-wrap:pretty}.ff-theme .ff-hero-quote{max-width:38ch;margin:1.75rem 0 0;padding-left:1.25rem;border-left:var(--ff-rule-accent-width) solid var(--ff-color-rule-strong);font-size:var(--ff-size-body);font-style:italic;line-height:1.55;color:var(--ff-color-ink-muted)}.ff-theme .ff-hero-quote strong{font-style:normal;font-weight:620;color:var(--ff-color-ink)}.ff-theme .ff-hero-actions{display:flex;flex-wrap:wrap;gap:.75rem;margin-top:2.5rem}.ff-theme .ff-hero-panel{align-self:center;padding:1.75rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md);background:var(--ff-color-surface);box-shadow:0 1.5rem 3rem rgba(0,0,0,.05)}.ff-theme .ff-hero-panel-label{margin:0 0 1rem}.ff-theme .ff-hero-command-tabs{display:flex;flex-wrap:wrap;margin-bottom:.75rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-hero-command-tab{position:relative;padding:0 .75rem .625rem;border:0;background:rgba(0,0,0,0);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint);cursor:pointer;transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-hero-command-tab:first-child{padding-left:0}.ff-theme .ff-hero-command-tab::after{position:absolute;right:0;bottom:calc(var(--ff-rule-accent-width)*-1);left:0;height:var(--ff-rule-accent-width);background:rgba(0,0,0,0);content:"";transition:background-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-hero-command-tab:hover{color:var(--ff-color-ink)}.ff-theme .ff-hero-command-tab.active{color:var(--ff-color-ink)}.ff-theme .ff-hero-command-tab.active::after{background:var(--ff-color-accent)}.ff-theme .ff-hero-panel-inline{max-width:28rem;margin-top:2.5rem}.ff-theme .ff-hero-panel-bare{padding:0;border:0;border-radius:0;background:rgba(0,0,0,0);box-shadow:none}.ff-theme .ff-hero-panel .ff-hero-actions{margin-top:1.25rem}.ff-theme .ff-hero-panel .ff-btn{flex:1 1 8rem;justify-content:center}.ff-theme .ff-hero-command{display:flex;align-items:center;justify-content:space-between;gap:1rem;padding:.625rem .625rem .625rem .875rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:var(--ff-color-paper)}.ff-theme .ff-hero-command code{font-family:var(--ff-font-mono);font-size:.8125rem;color:var(--ff-color-ink);overflow-x:auto}.ff-theme .ff-hero-prompt{margin-right:.5rem;color:var(--ff-color-accent)}.ff-theme .ff-hero-copy-group{position:relative;display:flex;align-items:center;flex-shrink:0}.ff-theme .ff-hero-copied{position:absolute;top:0;right:100%;z-index:1;display:flex;align-items:center;height:1.75rem;padding:0 .625rem;border:var(--ff-rule-width) solid var(--ff-color-rule-strong);border-right:0;border-radius:var(--ff-radius-sm) 0 0 var(--ff-radius-sm);background:var(--ff-color-surface-alt);color:var(--ff-color-ink-muted);white-space:nowrap}.ff-theme .ff-hero-copy{flex-shrink:0;width:1.75rem;height:1.75rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background-color:rgba(0,0,0,0);background-image:var(--vp-icon-copy);background-position:50%;background-repeat:no-repeat;background-size:.875rem;cursor:pointer;transition:border-color var(--ff-motion-duration) var(--ff-motion-ease),background-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-hero-copy:hover{border-color:var(--ff-color-rule-strong);background-color:var(--ff-color-surface-alt)}.ff-theme .ff-hero-copy.copied{border-radius:0 var(--ff-radius-sm) var(--ff-radius-sm) 0;border-color:var(--ff-color-rule-strong);background-color:var(--ff-color-surface-alt);background-image:var(--vp-icon-copied)}.ff-theme .ff-hero-image{display:flex;align-items:center;justify-content:center;max-width:28rem}.ff-theme .ff-hero-image img{width:100%;height:auto}@media(width >= 960px){.ff-theme .ff-hero-image{max-width:none}}.ff-theme .ff-hero-meta{position:relative;display:grid;grid-template-columns:repeat(auto-fit, minmax(7rem, 1fr));gap:1.5rem;max-width:var(--ff-layout-wide);margin:0 auto;padding-top:1.75rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-hero-meta-item{padding-left:1.5rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-hero-meta-item:first-child{padding-left:0;border-left:0}.ff-theme .ff-hero-meta dt{margin-bottom:.625rem}.ff-theme .ff-hero-meta dd{margin:0;font-family:var(--ff-font-display);font-size:1.125rem;font-weight:600;letter-spacing:-0.01em;color:var(--ff-color-ink)}@media(width >= 640px){.ff-theme .ff-hero{padding:calc(var(--ff-hero-offset) + 2rem) 3rem 4rem}}@media(width >= 960px){.ff-theme .ff-hero{padding:calc(var(--ff-hero-offset) + 2.25rem) 4rem 4.5rem}.ff-theme .ff-hero-container{gap:4.5rem}.ff-theme .ff-hero.has-panel .ff-hero-container{grid-template-columns:minmax(0, 1.3fr) minmax(0, 1fr);align-items:start}.ff-theme .ff-hero.has-image .ff-hero-container{grid-template-columns:minmax(0, 1fr) minmax(0, 1fr);align-items:start}}.ff-theme .ff-btn{display:inline-flex;align-items:center;height:2.875rem;padding:0 1.375rem;border:var(--ff-rule-width) solid rgba(0,0,0,0);border-radius:var(--ff-radius-sm);font-size:.875rem;font-weight:550;text-decoration:none;white-space:nowrap}.ff-theme .vp-doc .ff-btn{font-weight:550;text-decoration:none}.ff-theme .ff-btn.ff-btn-brand{border-color:var(--ff-color-accent);background:var(--ff-color-accent);color:var(--ff-color-accent-contrast)}.ff-theme .ff-btn.ff-btn-brand:hover{border-color:var(--ff-color-accent-hover);background:var(--ff-color-accent-hover);color:var(--ff-color-accent-contrast)}.ff-theme .ff-btn.ff-btn-alt{border-color:var(--ff-color-rule-strong);color:var(--ff-color-ink)}.ff-theme .ff-btn.ff-btn-alt:hover{border-color:var(--ff-color-ink);color:var(--ff-color-ink)}.ff-theme .VPFeatures{padding:2.5rem 1.5rem 3rem}.ff-theme .VPFeatures .container{max-width:var(--ff-layout-wide)}.ff-theme .VPFeatures .items{display:grid;grid-template-columns:minmax(0, 1fr);gap:0;margin:0;overflow:hidden;counter-reset:ff-feature}.ff-theme .VPFeatures .items>.item,.ff-theme .VPFeatures .items>.item[class*=grid-]{width:auto;padding:0;counter-increment:ff-feature}.ff-theme .ff-feature{position:relative;display:flex;flex-direction:column;height:100%;padding:2.25rem 2rem 2.5rem;background:var(--ff-color-paper);box-shadow:calc(-1*var(--ff-rule-width)) 0 0 0 var(--ff-color-rule),0 calc(-1*var(--ff-rule-width)) 0 0 var(--ff-color-rule);isolation:isolate}.ff-theme .ff-feature-index::before{content:counter(ff-feature, decimal-leading-zero);position:absolute;top:1.5rem;right:1.75rem;font-family:var(--ff-font-mono);font-size:2rem;font-weight:500;line-height:1;letter-spacing:-0.02em;color:var(--ff-color-rule-strong);transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme a.ff-feature:hover .ff-feature-index::before{color:var(--ff-color-accent)}.ff-theme .ff-feature-icon{font-size:1.5rem;line-height:1;color:var(--ff-color-accent)}.ff-theme .ff-feature-icon svg{width:1.625rem;height:1.625rem}.ff-theme .ff-feature-title{margin:2.25rem 0 0;font-family:var(--ff-font-display);font-size:1.1875rem;font-weight:620;letter-spacing:-0.015em;color:var(--ff-color-ink)}.ff-theme .ff-feature-icon+.ff-feature-title{margin-top:1.5rem}.ff-theme .ff-feature-details{flex-grow:1;margin:.75rem 0 0;padding:0;font-size:.9375rem;line-height:1.7;color:var(--ff-color-ink-muted)}.ff-theme ul.ff-feature-details{padding-left:1rem;list-style:disc}.ff-theme .ff-feature-link{margin-top:1.75rem;color:var(--ff-color-accent)}@media(width >= 640px){.ff-theme .VPFeatures{padding:3rem 3rem 3.5rem}.ff-theme .VPFeatures .items{grid-template-columns:repeat(2, minmax(0, 1fr))}}@media(width >= 960px){.ff-theme .VPFeatures{padding:3.5rem 4rem 4rem}.ff-theme .VPFeatures .items:has(.grid-3){grid-template-columns:repeat(3, minmax(0, 1fr))}.ff-theme .VPFeatures .items:has(.grid-4),.ff-theme .VPFeatures .items:has(.grid-6){grid-template-columns:repeat(4, minmax(0, 1fr))}}.ff-theme .ff-sponsors{padding:2.5rem 1.5rem 3rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc .VPHomeSponsors.ff-sponsors{margin-left:-1.5rem;margin-right:-1.5rem}.ff-theme .ff-sponsors-container{max-width:var(--ff-layout-wide);margin:0 auto;text-align:center}.ff-theme .vp-doc .ff-sponsors-title{margin:0;border-top:0;padding-top:0;font-family:var(--ff-font-title);font-size:var(--ff-size-h1);font-weight:600;letter-spacing:0;word-spacing:-0.3em;text-transform:uppercase;color:var(--ff-color-ink);font-variation-settings:normal}.ff-theme .ff-sponsors-message{max-width:42ch;margin:.75rem auto 0;font-size:var(--ff-size-body);line-height:1.55;color:var(--ff-color-ink-muted)}.ff-theme .ff-sponsors-grid{margin-top:2rem}.ff-theme .ff-sponsors-grid.vp-sponsor{border-radius:var(--ff-radius-md)}.ff-theme .ff-sponsors-grid .vp-sponsor-grid{justify-content:center}.ff-theme .ff-sponsors-grid .vp-sponsor-grid-link{min-height:90px}.ff-theme .ff-sponsors-grid .vp-sponsor-grid-image{max-width:120px;max-height:32px}.ff-theme .ff-sponsors-grid .vp-sponsor-tier{display:flex;align-items:center;justify-content:flex-start;height:60px;margin:0 0 .25rem;padding:0 1.25rem;font-family:var(--ff-font-mono);font-size:14px;font-weight:500;letter-spacing:var(--ff-tracking-label);text-align:left;text-transform:uppercase;color:var(--ff-color-ink-faint)}.ff-theme .ff-sponsors-action{margin-top:2rem}@media(width >= 640px){.ff-theme .ff-sponsors{padding:3rem 3rem 3.5rem}.ff-theme .vp-doc .VPHomeSponsors.ff-sponsors{margin-left:-3rem;margin-right:-3rem}}@media(width >= 960px){.ff-theme .ff-sponsors{padding:3.5rem 4rem 4rem}.ff-theme .vp-doc .VPHomeSponsors.ff-sponsors{margin-left:-4rem;margin-right:-4rem}}.ff-banner-dismissed .ff-theme .ff-banner{display:none}:root:has(.ff-banner):not(.ff-banner-dismissed){--vp-layout-top-height: var(--ff-banner-height)}.ff-theme .ff-banner{position:fixed;top:0;right:0;left:0;z-index:var(--vp-z-index-layout-top);display:flex;align-items:center;justify-content:center;gap:1rem;min-height:var(--ff-banner-height);padding:.625rem 3rem;background:var(--ff-color-ink);color:var(--ff-color-paper)}.ff-theme[data-nav-sticky=false] .ff-banner{position:relative}.ff-theme .ff-banner[data-variant=ink]{--ff-banner-from: var(--ff-color-ink);--ff-banner-to: var(--ff-color-ink-muted);color:var(--ff-color-paper)}.ff-theme .ff-banner[data-variant=accent]{--ff-banner-from: var(--ff-color-accent);--ff-banner-to: var(--ff-color-accent-hover);color:var(--ff-color-accent-contrast)}.ff-theme .ff-banner[data-variant=success]{--ff-banner-from: var(--ff-color-success);--ff-banner-to: var(--ff-color-ink);color:var(--ff-color-paper)}.ff-theme .ff-banner[data-variant=warning]{--ff-banner-from: var(--ff-color-warning);--ff-banner-to: var(--ff-color-ink);color:var(--ff-color-paper)}.ff-theme .ff-banner[data-variant=danger]{--ff-banner-from: var(--ff-color-danger);--ff-banner-to: var(--ff-color-ink);color:var(--ff-color-paper)}.ff-theme .ff-banner:not([data-gradient]){background:var(--ff-banner-from)}.ff-theme .ff-banner[data-gradient]{background:linear-gradient(100deg, var(--ff-banner-from), var(--ff-banner-to))}.ff-theme .ff-banner[data-variant=rainbow]{background:linear-gradient(100deg, var(--ff-color-accent), var(--ff-color-danger), var(--ff-color-warning), var(--ff-color-success));color:var(--ff-color-accent-contrast)}.ff-theme .ff-banner-icon{font-size:1rem;line-height:1}.ff-theme .ff-banner-body{display:flex;align-items:center;gap:.75rem;font-size:.8125rem;color:inherit}.ff-theme .ff-banner-cta{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);text-transform:uppercase;letter-spacing:var(--ff-tracking-label);text-decoration:underline;text-underline-offset:.25em}.ff-theme .ff-banner-close{position:absolute;top:50%;right:1rem;display:flex;align-items:center;justify-content:center;width:2rem;height:2rem;border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0);font-size:1.25rem;line-height:1;color:inherit;transform:translateY(-50%);cursor:pointer}.ff-theme .ff-banner-close:hover{background:color-mix(in srgb, currentcolor 18%, transparent)}.ff-theme .ff-doc-meta{flex-wrap:wrap;gap:.75rem;margin-bottom:1.5rem;padding-bottom:1rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-doc-meta-item+.ff-doc-meta-item::before{content:"·";margin-right:.75rem}.ff-theme .ff-to-top{position:fixed;right:1.5rem;bottom:1.5rem;z-index:20;gap:.375rem;padding:.625rem .75rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:var(--ff-color-surface);cursor:pointer;opacity:0;transform:translateY(0.5rem);pointer-events:none;transition:opacity var(--ff-motion-duration) var(--ff-motion-ease),transform var(--ff-motion-duration) var(--ff-motion-ease),border-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-to-top.is-visible{opacity:1;transform:translateY(0);pointer-events:auto}.ff-theme .ff-footer{position:relative;z-index:var(--vp-z-index-footer);padding:3.5rem 1.5rem 2.5rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule);background:var(--ff-color-paper)}.ff-theme .ff-footer.has-sidebar{display:none}.ff-theme .ff-footer-container{max-width:var(--ff-layout-wide);margin:0 auto}.ff-theme .ff-footer-top{display:flex;flex-wrap:wrap;justify-content:space-between;gap:2rem}.ff-theme .ff-footer-columns{flex:1 1 auto;display:grid;grid-template-columns:repeat(auto-fill, minmax(9rem, 12rem));gap:2rem}.ff-theme .ff-footer-social a{display:inline-flex;align-items:center;gap:.5rem;text-transform:capitalize}.ff-theme .ff-footer-social a>span:first-child{flex:none;font-size:1.05em;opacity:.8}.ff-theme .ff-footer-column ul{margin:1rem 0 0;padding:0;list-style:none}.ff-theme .ff-footer-column li+li{margin-top:.5rem}.ff-theme .ff-footer-column a{font-size:.875rem;color:var(--ff-color-ink-muted);transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-footer-column a:hover{color:var(--ff-color-ink)}.ff-theme .ff-footer-legal{display:flex;flex-wrap:wrap;justify-content:space-between;gap:.5rem 2rem;margin-top:3rem;padding-top:1.5rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule);font-family:var(--ff-font-mono);font-size:var(--ff-size-meta);color:var(--ff-color-ink-faint)}.ff-theme .ff-footer-legal p{margin:0}@media(width >= 768px){.ff-theme .ff-footer{padding:4rem 3rem 2.5rem}.ff-theme .ff-footer-social{margin-left:auto}}.ff-theme .vp-doc .ff-card-grid{display:grid;grid-template-columns:repeat(var(--ff-card-columns, 2), minmax(0, 1fr));gap:1rem;margin:1.75rem 0}.ff-theme .vp-doc .ff-card{display:block;padding:1.25rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md);background:var(--ff-color-surface);transition:border-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .vp-doc a.ff-card{text-decoration:none}.ff-theme .vp-doc a.ff-card:hover{border-color:var(--ff-color-accent)}.ff-theme .vp-doc .ff-card-icon{display:block;margin-bottom:.75rem;font-size:1.25rem;line-height:1;color:var(--ff-color-accent)}.ff-theme .vp-doc .ff-card-title{margin:0;font-family:var(--ff-font-display);font-size:1rem;font-weight:620;letter-spacing:-0.01em;color:var(--ff-color-ink)}.ff-theme .vp-doc .ff-card-body,.ff-theme .vp-doc .ff-card-body p{margin:.5rem 0 0;font-size:.9375rem;line-height:1.6;color:var(--ff-color-ink-muted)}@media(width <= 640px){.ff-theme .vp-doc .ff-card-grid{grid-template-columns:minmax(0, 1fr)}}.ff-theme .vp-doc .ff-steps ol{margin:1.75rem 0;padding-left:2.5rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule);list-style:none;counter-reset:ff-step}.ff-theme .vp-doc .ff-steps ol>li{position:relative;margin:0;padding-bottom:1.5rem;counter-increment:ff-step}.ff-theme .vp-doc .ff-steps ol>li:last-child{padding-bottom:0}.ff-theme .vp-doc .ff-steps ol>li::before{content:counter(ff-step, decimal-leading-zero);position:absolute;top:.25rem;left:-3.25rem;width:1.5rem;padding:.125rem 0;background:var(--ff-color-paper);font-family:var(--ff-font-mono);font-size:var(--ff-size-label);font-weight:500;text-align:center;color:var(--ff-color-accent)}.ff-theme .vp-doc .ff-api{margin:2.5rem 0;padding-top:1.25rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc .ff-api-head{display:flex;flex-wrap:wrap;align-items:baseline;gap:.75rem}.ff-theme .vp-doc .ff-api-name,.ff-theme .vp-doc .ff-api-signature code{padding:0;border-radius:0;background:rgba(0,0,0,0);font-family:var(--ff-font-mono)}.ff-theme .vp-doc .ff-api-name{font-size:1.0625rem;font-weight:600;color:var(--ff-color-ink)}.ff-theme .vp-doc .ff-api.is-deprecated .ff-api-name{text-decoration:line-through;color:var(--ff-color-ink-faint)}.ff-theme .vp-doc .ff-api-kind{color:var(--ff-color-accent)}.ff-theme .vp-doc .ff-api-deprecated{color:var(--ff-color-danger)}.ff-theme .vp-doc .ff-api-signature{margin:.625rem 0 0}.ff-theme .vp-doc .ff-api-signature code{font-size:.8125rem;color:var(--ff-color-ink-muted)}.ff-theme .vp-doc .ff-api-body>:first-child{margin-top:.75rem}.ff-theme .vp-doc .ff-kbd{display:inline-block;min-width:1.5rem;padding:.0625rem .375rem;border:var(--ff-rule-width) solid var(--ff-color-rule-strong);border-radius:var(--ff-radius-sm);background:var(--ff-color-surface);font-family:var(--ff-font-mono);font-size:.75rem;line-height:1.4;text-align:center;color:var(--ff-color-ink-muted)}@keyframes ff-rise{from{opacity:0;transform:translateY(0.875rem)}to{opacity:1;transform:none}}@keyframes ff-drift{from{transform:translate3d(-4%, -3%, 0) scale(1)}to{transform:translate3d(6%, 4%, 0) scale(1.12)}}@media(prefers-reduced-motion: no-preference){.ff-theme .ff-hero-glow{animation:ff-drift 26s var(--ff-motion-ease) infinite alternate}.ff-theme .ff-hero-kicker,.ff-theme .ff-hero-title,.ff-theme .ff-hero-tagline,.ff-theme .ff-hero-main .ff-hero-actions,.ff-theme .ff-hero-panel,.ff-theme .ff-hero-meta,.ff-theme .ff-hero-image{animation:ff-rise .65s var(--ff-motion-ease) both}.ff-theme .ff-hero-title{animation-delay:.06s}.ff-theme .ff-hero-tagline{animation-delay:.12s}.ff-theme .ff-hero-main .ff-hero-actions{animation-delay:.18s}.ff-theme .ff-hero-panel{animation-delay:.2s;animation-duration:.8s}.ff-theme .ff-hero-meta{animation-delay:.3s}.ff-theme .ff-hero-image{animation-delay:.14s;animation-duration:.9s}}.ff-theme .ff-btn,.ff-theme .VPButton{transition:background-color var(--ff-motion-duration) var(--ff-motion-ease),border-color var(--ff-motion-duration) var(--ff-motion-ease),box-shadow var(--ff-motion-duration) var(--ff-motion-ease),color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-btn-brand:hover,.ff-theme .VPButton.brand:hover{box-shadow:0 .5rem 1.5rem var(--ff-color-accent-glow)}.ff-theme .VPNavBarMenuLink{position:relative}.ff-theme .VPNavBarMenuLink::after{content:"";position:absolute;right:.75rem;bottom:1rem;left:.75rem;height:2px;background:var(--ff-color-accent);transform:scaleX(0);transform-origin:left;transition:transform var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .VPNavBarMenuLink:hover::after,.ff-theme .VPNavBarMenuLink.active::after{transform:scaleX(1)}.ff-theme .VPNavBarMenuLink.active{text-decoration:none}.ff-theme .ff-feature::after{content:"";position:absolute;z-index:-1;inset:0;background:linear-gradient(160deg, var(--ff-color-accent-soft), transparent 60%);opacity:0;transition:opacity var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme a.ff-feature:hover::after{opacity:1}.ff-theme .ff-feature-index::before{transition:color var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme .vp-doc .ff-card{transition:border-color var(--ff-motion-duration-slow) var(--ff-motion-ease),box-shadow var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme .vp-doc a.ff-card:hover{box-shadow:0 .75rem 1.75rem var(--ff-color-accent-glow)}.ff-theme .vp-doc div[class*=language-]{transition:border-color var(--ff-motion-duration-slow) var(--ff-motion-ease)}.ff-theme .vp-doc div[class*=language-]:hover{border-color:var(--ff-color-rule-strong)}.ff-theme .ff-to-top:hover{border-color:var(--ff-color-accent);color:var(--ff-color-accent)}.ff-theme .ff-hero-copy,.ff-theme .ff-banner-close,.ff-theme .ff-to-top,.ff-theme .VPNavBarSearchButton,.ff-theme .vp-doc [class*=language-]>button.copy,.ff-theme .VPDocFooter .pager-link .title,.ff-theme .ff-footer-column a,.ff-theme .VPDocAsideOutline .outline-link,.ff-theme .VPSidebarItem .link .text{transition:background-color var(--ff-motion-duration) var(--ff-motion-ease),border-color var(--ff-motion-duration) var(--ff-motion-ease),color var(--ff-motion-duration) var(--ff-motion-ease),opacity var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-to-top{transition:border-color var(--ff-motion-duration) var(--ff-motion-ease),color var(--ff-motion-duration) var(--ff-motion-ease),opacity var(--ff-motion-duration-slow) var(--ff-motion-ease),transform var(--ff-motion-duration-slow) var(--ff-motion-ease)}@media(prefers-reduced-motion: reduce){.ff-theme .ff-to-top,.ff-theme .ff-hero-command-tab,.ff-theme .ff-hero-command-tab::after,.ff-theme .ff-hero-copy{transition:none}}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@frontfactory/vitepress-theme",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.7.0",
|
|
4
4
|
"description": "Editorial VitePress theme — hairline rules, numbered sections and monospaced metadata.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"scripts": {
|
|
@@ -35,31 +35,39 @@
|
|
|
35
35
|
"./package.json": "./package.json"
|
|
36
36
|
},
|
|
37
37
|
"devDependencies": {
|
|
38
|
-
"@commitlint/cli": "^21.2.
|
|
39
|
-
"@commitlint/config-conventional": "^21.2.
|
|
40
|
-
"@
|
|
38
|
+
"@commitlint/cli": "^21.2.3",
|
|
39
|
+
"@commitlint/config-conventional": "^21.2.3",
|
|
40
|
+
"@eslint/js": "^10.0.1",
|
|
41
|
+
"@front-factory/eslint-config": "^2.5.0",
|
|
41
42
|
"@front-factory/stylelint-config": "^1.12.1",
|
|
42
|
-
"@magnesium/theme": "^5.
|
|
43
|
+
"@magnesium/theme": "^5.3.0",
|
|
43
44
|
"@semantic-release/changelog": "^7.0.0",
|
|
44
45
|
"@semantic-release/git": "^11.0.1",
|
|
45
|
-
"@semantic-release/github": "^12.0.
|
|
46
|
+
"@semantic-release/github": "^12.0.10",
|
|
46
47
|
"conventional-changelog-conventionalcommits": "^9.3.1",
|
|
47
|
-
"eslint": "^10.
|
|
48
|
-
"eslint-plugin-vue": "^10.11.
|
|
48
|
+
"eslint": "^10.12.0",
|
|
49
|
+
"eslint-plugin-vue": "^10.11.1",
|
|
50
|
+
"globals": "^17.13.0",
|
|
49
51
|
"husky": "^9.1.7",
|
|
50
|
-
"sass": "^1.
|
|
52
|
+
"sass": "^1.105.1",
|
|
51
53
|
"semantic-release": "^25.0.9",
|
|
52
54
|
"stylelint": "^16.26.1",
|
|
53
55
|
"typescript": "^5.9.3",
|
|
54
|
-
"typescript-eslint": "^8.
|
|
56
|
+
"typescript-eslint": "^8.71.1",
|
|
55
57
|
"vitepress": "^2.0.0-alpha.20",
|
|
56
|
-
"vue": "^3.5.
|
|
57
|
-
"vue-tsc": "^3.
|
|
58
|
+
"vue": "^3.5.43",
|
|
59
|
+
"vue-tsc": "^3.3.13"
|
|
58
60
|
},
|
|
59
61
|
"peerDependencies": {
|
|
62
|
+
"vite": ">=5",
|
|
60
63
|
"vitepress": "^2.0.0-alpha.20",
|
|
61
64
|
"vue": "^3.5.0"
|
|
62
65
|
},
|
|
66
|
+
"peerDependenciesMeta": {
|
|
67
|
+
"vite": {
|
|
68
|
+
"optional": true
|
|
69
|
+
}
|
|
70
|
+
},
|
|
63
71
|
"keywords": [
|
|
64
72
|
"vitepress",
|
|
65
73
|
"vitepress-theme",
|
|
@@ -82,7 +90,8 @@
|
|
|
82
90
|
],
|
|
83
91
|
"files": [
|
|
84
92
|
"src",
|
|
85
|
-
"dist",
|
|
93
|
+
"dist/style.css",
|
|
94
|
+
"CHANGELOG.md",
|
|
86
95
|
"config.js",
|
|
87
96
|
"config.d.ts"
|
|
88
97
|
],
|
|
@@ -17,25 +17,40 @@ const enabled = computed(() => options.value.backToTop !== false);
|
|
|
17
17
|
|
|
18
18
|
const visible = ref(false);
|
|
19
19
|
|
|
20
|
-
function
|
|
20
|
+
function update() {
|
|
21
21
|
visible.value = window.scrollY > window.innerHeight;
|
|
22
22
|
}
|
|
23
23
|
|
|
24
|
+
// At most one state update per frame, however many scroll events fire.
|
|
25
|
+
let frame = 0;
|
|
26
|
+
|
|
27
|
+
function onScroll() {
|
|
28
|
+
if (!frame) {
|
|
29
|
+
frame = requestAnimationFrame(() => {
|
|
30
|
+
frame = 0;
|
|
31
|
+
update();
|
|
32
|
+
});
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
|
|
24
36
|
function toTop() {
|
|
25
37
|
window.scrollTo({
|
|
26
38
|
top: 0,
|
|
27
|
-
behavior: 'smooth'
|
|
39
|
+
behavior: window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 'auto' : 'smooth'
|
|
28
40
|
});
|
|
29
41
|
}
|
|
30
42
|
|
|
31
43
|
onMounted(() => {
|
|
32
|
-
|
|
44
|
+
update();
|
|
33
45
|
window.addEventListener('scroll', onScroll, {
|
|
34
46
|
passive: true
|
|
35
47
|
});
|
|
36
48
|
});
|
|
37
49
|
|
|
38
|
-
onUnmounted(() =>
|
|
50
|
+
onUnmounted(() => {
|
|
51
|
+
cancelAnimationFrame(frame);
|
|
52
|
+
window.removeEventListener('scroll', onScroll);
|
|
53
|
+
});
|
|
39
54
|
</script>
|
|
40
55
|
|
|
41
56
|
<template>
|
|
@@ -45,8 +60,7 @@ onUnmounted(() => window.removeEventListener('scroll', onScroll));
|
|
|
45
60
|
type="button"
|
|
46
61
|
class="ff-to-top ff-label"
|
|
47
62
|
:class="{ 'is-visible': visible }"
|
|
48
|
-
:
|
|
49
|
-
:aria-hidden="!visible"
|
|
63
|
+
:inert="visible ? undefined : true"
|
|
50
64
|
:title="title"
|
|
51
65
|
@click="toTop"
|
|
52
66
|
>
|
|
@@ -32,7 +32,12 @@ function dismiss() {
|
|
|
32
32
|
return;
|
|
33
33
|
}
|
|
34
34
|
|
|
35
|
-
|
|
35
|
+
try {
|
|
36
|
+
localStorage.setItem(`ff-banner-${banner.value.id}`, 'dismissed');
|
|
37
|
+
} catch {
|
|
38
|
+
// Private mode or full quota: the banner is dismissed for this page view only.
|
|
39
|
+
}
|
|
40
|
+
|
|
36
41
|
document.documentElement.classList.add(DISMISSED);
|
|
37
42
|
height();
|
|
38
43
|
}
|
|
@@ -89,7 +94,18 @@ onUnmounted(() => {
|
|
|
89
94
|
:aria-label="labels.bannerDismiss"
|
|
90
95
|
@click="dismiss"
|
|
91
96
|
>
|
|
92
|
-
|
|
97
|
+
<svg
|
|
98
|
+
width="12"
|
|
99
|
+
height="12"
|
|
100
|
+
viewBox="0 0 12 12"
|
|
101
|
+
fill="none"
|
|
102
|
+
stroke="currentColor"
|
|
103
|
+
stroke-width="1.5"
|
|
104
|
+
stroke-linecap="round"
|
|
105
|
+
aria-hidden="true"
|
|
106
|
+
>
|
|
107
|
+
<path d="M1.5 1.5l9 9M10.5 1.5l-9 9" />
|
|
108
|
+
</svg>
|
|
93
109
|
</button>
|
|
94
110
|
</div>
|
|
95
111
|
</template>
|
|
@@ -4,6 +4,7 @@ import {
|
|
|
4
4
|
} from 'vue';
|
|
5
5
|
import { useData } from 'vitepress';
|
|
6
6
|
import { useLayout } from '../internal';
|
|
7
|
+
import { formatRelative } from '../composables/relativeTime';
|
|
7
8
|
import {
|
|
8
9
|
format, useLabels, useThemeOptions
|
|
9
10
|
} from '../composables/options';
|
|
@@ -84,55 +85,18 @@ const minutes = computed(() => {
|
|
|
84
85
|
// Last updated
|
|
85
86
|
// --------------------------------------------------------------------------------------------- //
|
|
86
87
|
|
|
87
|
-
const units: [Intl.RelativeTimeFormatUnit, number][] = [
|
|
88
|
-
[
|
|
89
|
-
'year',
|
|
90
|
-
31536000000
|
|
91
|
-
],
|
|
92
|
-
[
|
|
93
|
-
'month',
|
|
94
|
-
2592000000
|
|
95
|
-
],
|
|
96
|
-
[
|
|
97
|
-
'week',
|
|
98
|
-
604800000
|
|
99
|
-
],
|
|
100
|
-
[
|
|
101
|
-
'day',
|
|
102
|
-
86400000
|
|
103
|
-
],
|
|
104
|
-
[
|
|
105
|
-
'hour',
|
|
106
|
-
3600000
|
|
107
|
-
],
|
|
108
|
-
[
|
|
109
|
-
'minute',
|
|
110
|
-
60000
|
|
111
|
-
]
|
|
112
|
-
];
|
|
113
|
-
|
|
114
88
|
const updated = computed(() => {
|
|
115
89
|
if (!meta.value || meta.value.lastUpdated === false || !page.value.lastUpdated) {
|
|
116
90
|
return null;
|
|
117
91
|
}
|
|
118
92
|
|
|
119
|
-
|
|
120
|
-
const relative = new Intl.RelativeTimeFormat(lang.value, {
|
|
121
|
-
numeric: 'auto'
|
|
122
|
-
});
|
|
123
|
-
|
|
124
|
-
for (const [
|
|
125
|
-
unit,
|
|
126
|
-
ms
|
|
127
|
-
] of units) {
|
|
128
|
-
if (Math.abs(elapsed) >= ms) {
|
|
129
|
-
return relative.format(Math.round(elapsed / ms), unit);
|
|
130
|
-
}
|
|
131
|
-
}
|
|
132
|
-
|
|
133
|
-
return relative.format(0, 'minute');
|
|
93
|
+
return formatRelative(page.value.lastUpdated, lang.value);
|
|
134
94
|
});
|
|
135
95
|
|
|
96
|
+
const updatedAt = computed(() =>
|
|
97
|
+
page.value.lastUpdated ? new Date(page.value.lastUpdated).toISOString() : undefined
|
|
98
|
+
);
|
|
99
|
+
|
|
136
100
|
const hidden = computed(() => !meta.value || frontmatter.value.layout === 'home');
|
|
137
101
|
</script>
|
|
138
102
|
|
|
@@ -153,12 +117,13 @@ const hidden = computed(() => !meta.value || frontmatter.value.layout === 'home'
|
|
|
153
117
|
>
|
|
154
118
|
{{ format(labels.readingTime, minutes) }}
|
|
155
119
|
</span>
|
|
156
|
-
<
|
|
120
|
+
<time
|
|
157
121
|
v-if="updated"
|
|
158
122
|
class="ff-doc-meta-item"
|
|
123
|
+
:datetime="updatedAt"
|
|
159
124
|
>
|
|
160
125
|
{{ format(labels.lastUpdated, updated) }}
|
|
161
|
-
</
|
|
126
|
+
</time>
|
|
162
127
|
</ClientOnly>
|
|
163
128
|
</div>
|
|
164
129
|
</template>
|
|
@@ -55,10 +55,11 @@ const visible = computed(
|
|
|
55
55
|
v-if="columns.length"
|
|
56
56
|
class="ff-footer-columns"
|
|
57
57
|
>
|
|
58
|
-
<
|
|
58
|
+
<nav
|
|
59
59
|
v-for="column in columns"
|
|
60
60
|
:key="column.title"
|
|
61
61
|
class="ff-footer-column"
|
|
62
|
+
:aria-label="column.title"
|
|
62
63
|
>
|
|
63
64
|
<p class="ff-label">
|
|
64
65
|
{{ column.title }}
|
|
@@ -78,12 +79,13 @@ const visible = computed(
|
|
|
78
79
|
</VPLink>
|
|
79
80
|
</li>
|
|
80
81
|
</ul>
|
|
81
|
-
</
|
|
82
|
+
</nav>
|
|
82
83
|
</div>
|
|
83
84
|
|
|
84
|
-
<
|
|
85
|
+
<nav
|
|
85
86
|
v-if="social.length"
|
|
86
87
|
class="ff-footer-column ff-footer-social"
|
|
88
|
+
:aria-label="labels.footerSocial"
|
|
87
89
|
>
|
|
88
90
|
<p class="ff-label">
|
|
89
91
|
{{ labels.footerSocial }}
|
|
@@ -97,14 +99,18 @@ const visible = computed(
|
|
|
97
99
|
<a
|
|
98
100
|
:href="item.link"
|
|
99
101
|
:target="item.target ?? '_blank'"
|
|
100
|
-
rel="me noopener"
|
|
102
|
+
rel="me noopener noreferrer"
|
|
101
103
|
>
|
|
102
104
|
<VPIcon :icon="item.icon" />
|
|
103
105
|
<span>{{ item.text }}</span>
|
|
106
|
+
<span
|
|
107
|
+
v-if="(item.target ?? '_blank') === '_blank'"
|
|
108
|
+
class="visually-hidden"
|
|
109
|
+
>({{ labels.newTab }})</span>
|
|
104
110
|
</a>
|
|
105
111
|
</li>
|
|
106
112
|
</ul>
|
|
107
|
-
</
|
|
113
|
+
</nav>
|
|
108
114
|
</div>
|
|
109
115
|
|
|
110
116
|
<div
|
|
@@ -141,7 +141,7 @@ function hasInlineCommand() {
|
|
|
141
141
|
:class="`ff-btn-${action.theme ?? 'brand'}`"
|
|
142
142
|
:href="action.link"
|
|
143
143
|
:target="action.target"
|
|
144
|
-
:rel="action.rel"
|
|
144
|
+
:rel="action.rel ?? (action.target === '_blank' ? 'noopener' : undefined)"
|
|
145
145
|
>
|
|
146
146
|
{{ action.text }}
|
|
147
147
|
</a>
|
|
@@ -176,7 +176,7 @@ function hasInlineCommand() {
|
|
|
176
176
|
</slot>
|
|
177
177
|
</div>
|
|
178
178
|
|
|
179
|
-
<
|
|
179
|
+
<div
|
|
180
180
|
v-else-if="hasPanel()"
|
|
181
181
|
class="ff-hero-panel"
|
|
182
182
|
:class="{ 'ff-hero-panel-bare': !hasActions }"
|
|
@@ -199,12 +199,12 @@ function hasInlineCommand() {
|
|
|
199
199
|
:class="`ff-btn-${action.theme ?? 'brand'}`"
|
|
200
200
|
:href="action.link"
|
|
201
201
|
:target="action.target"
|
|
202
|
-
:rel="action.rel"
|
|
202
|
+
:rel="action.rel ?? (action.target === '_blank' ? 'noopener' : undefined)"
|
|
203
203
|
>
|
|
204
204
|
{{ action.text }}
|
|
205
205
|
</a>
|
|
206
206
|
</div>
|
|
207
|
-
</
|
|
207
|
+
</div>
|
|
208
208
|
</div>
|
|
209
209
|
|
|
210
210
|
<dl
|
|
@@ -38,7 +38,13 @@ async function copy() {
|
|
|
38
38
|
return;
|
|
39
39
|
}
|
|
40
40
|
|
|
41
|
-
|
|
41
|
+
try {
|
|
42
|
+
await navigator.clipboard.writeText(activeCommand.value);
|
|
43
|
+
} catch {
|
|
44
|
+
// Insecure context or denied permission: there is nothing to confirm.
|
|
45
|
+
return;
|
|
46
|
+
}
|
|
47
|
+
|
|
42
48
|
copied.value = true;
|
|
43
49
|
|
|
44
50
|
clearTimeout(copiedTimer);
|
|
@@ -60,16 +66,16 @@ onUnmounted(() => clearTimeout(copiedTimer));
|
|
|
60
66
|
<div
|
|
61
67
|
v-if="tabs"
|
|
62
68
|
class="ff-hero-command-tabs"
|
|
63
|
-
role="
|
|
69
|
+
role="group"
|
|
70
|
+
:aria-label="labels.heroInstall"
|
|
64
71
|
>
|
|
65
72
|
<button
|
|
66
73
|
v-for="(tab, index) in tabs"
|
|
67
74
|
:key="tab.label"
|
|
68
75
|
type="button"
|
|
69
|
-
role="tab"
|
|
70
76
|
class="ff-hero-command-tab"
|
|
71
77
|
:class="{ active: index === activeTab }"
|
|
72
|
-
:aria-
|
|
78
|
+
:aria-pressed="index === activeTab"
|
|
73
79
|
@click="activeTab = index"
|
|
74
80
|
>
|
|
75
81
|
{{ tab.label }}
|
|
@@ -89,13 +95,18 @@ onUnmounted(() => clearTimeout(copiedTimer));
|
|
|
89
95
|
<span
|
|
90
96
|
v-if="copied"
|
|
91
97
|
class="ff-hero-copied ff-label"
|
|
98
|
+
aria-hidden="true"
|
|
92
99
|
>{{ labels.heroCopied }}</span>
|
|
93
100
|
|
|
101
|
+
<span
|
|
102
|
+
class="visually-hidden"
|
|
103
|
+
aria-live="polite"
|
|
104
|
+
>{{ copied ? labels.heroCopied : '' }}</span>
|
|
105
|
+
|
|
94
106
|
<button
|
|
95
107
|
type="button"
|
|
96
108
|
class="ff-hero-copy"
|
|
97
109
|
:class="{ copied }"
|
|
98
|
-
:title="format(labels.heroCopyLabel, activeCommand)"
|
|
99
110
|
:aria-label="format(labels.heroCopyLabel, activeCommand)"
|
|
100
111
|
@click="copy"
|
|
101
112
|
/>
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
import { computed } from 'vue';
|
|
2
2
|
import { useData } from 'vitepress';
|
|
3
|
-
import type {
|
|
4
|
-
ThemeConfig, ThemeLabels, ThemeOptions
|
|
5
|
-
} from '../types';
|
|
3
|
+
import type { ThemeLabels, ThemeOptions } from '../types';
|
|
6
4
|
|
|
7
5
|
/**
|
|
8
6
|
* Theme options declared under `themeConfig.ff`, with an empty object as a fallback so callers
|
|
@@ -11,7 +9,7 @@ import type {
|
|
|
11
9
|
export function useThemeOptions() {
|
|
12
10
|
const { theme } = useData();
|
|
13
11
|
|
|
14
|
-
return computed<ThemeOptions>(() =>
|
|
12
|
+
return computed<ThemeOptions>(() => theme.value.ff ?? {});
|
|
15
13
|
}
|
|
16
14
|
|
|
17
15
|
/** English fallbacks for every string this theme adds. */
|
|
@@ -20,11 +18,11 @@ export const defaultLabels: Required<ThemeLabels> = {
|
|
|
20
18
|
readingTime: '{0} min read',
|
|
21
19
|
lastUpdated: 'Updated {0}',
|
|
22
20
|
heroInstall: 'Install',
|
|
23
|
-
heroCopy: 'Copy',
|
|
24
21
|
heroCopied: 'Copied',
|
|
25
22
|
heroCopyLabel: 'Copy {0}',
|
|
26
23
|
backToTop: 'Top',
|
|
27
24
|
footerSocial: 'Follow',
|
|
25
|
+
newTab: 'opens in a new tab',
|
|
28
26
|
sponsors: 'Sponsors',
|
|
29
27
|
sponsorsAction: 'Become a sponsor'
|
|
30
28
|
};
|
|
@@ -37,17 +35,13 @@ export function useLabels() {
|
|
|
37
35
|
const options = useThemeOptions();
|
|
38
36
|
|
|
39
37
|
return computed<Required<ThemeLabels>>(() => {
|
|
38
|
+
const overrides = options.value.labels ?? {};
|
|
40
39
|
const labels = {
|
|
41
|
-
...defaultLabels
|
|
40
|
+
...defaultLabels
|
|
42
41
|
};
|
|
43
42
|
|
|
44
|
-
for (const [
|
|
45
|
-
key
|
|
46
|
-
value
|
|
47
|
-
] of Object.entries(options.value.labels ?? {})) {
|
|
48
|
-
if (value) {
|
|
49
|
-
labels[key as keyof ThemeLabels] = value;
|
|
50
|
-
}
|
|
43
|
+
for (const key of Object.keys(defaultLabels) as (keyof ThemeLabels)[]) {
|
|
44
|
+
labels[key] = overrides[key] || labels[key];
|
|
51
45
|
}
|
|
52
46
|
|
|
53
47
|
return labels;
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
const units: [Intl.RelativeTimeFormatUnit, number][] = [
|
|
2
|
+
[
|
|
3
|
+
'year',
|
|
4
|
+
31536000000
|
|
5
|
+
],
|
|
6
|
+
[
|
|
7
|
+
'month',
|
|
8
|
+
2592000000
|
|
9
|
+
],
|
|
10
|
+
[
|
|
11
|
+
'week',
|
|
12
|
+
604800000
|
|
13
|
+
],
|
|
14
|
+
[
|
|
15
|
+
'day',
|
|
16
|
+
86400000
|
|
17
|
+
],
|
|
18
|
+
[
|
|
19
|
+
'hour',
|
|
20
|
+
3600000
|
|
21
|
+
],
|
|
22
|
+
[
|
|
23
|
+
'minute',
|
|
24
|
+
60000
|
|
25
|
+
]
|
|
26
|
+
];
|
|
27
|
+
|
|
28
|
+
const formatters = new Map<string, Intl.RelativeTimeFormat>();
|
|
29
|
+
|
|
30
|
+
function formatter(lang: string) {
|
|
31
|
+
let relative = formatters.get(lang);
|
|
32
|
+
|
|
33
|
+
if (!relative) {
|
|
34
|
+
relative = new Intl.RelativeTimeFormat(lang, {
|
|
35
|
+
numeric: 'auto'
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
formatters.set(lang, relative);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
return relative;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** Formats a timestamp relative to now, in the largest unit it spans: "3 days ago". */
|
|
45
|
+
export function formatRelative(timestamp: number, lang: string) {
|
|
46
|
+
const elapsed = timestamp - Date.now();
|
|
47
|
+
const relative = formatter(lang);
|
|
48
|
+
|
|
49
|
+
for (const [
|
|
50
|
+
unit,
|
|
51
|
+
ms
|
|
52
|
+
] of units) {
|
|
53
|
+
if (Math.abs(elapsed) >= ms) {
|
|
54
|
+
return relative.format(Math.round(elapsed / ms), unit);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
return relative.format(0, 'minute');
|
|
59
|
+
}
|
package/src/styles/_base.scss
CHANGED
|
@@ -119,3 +119,22 @@
|
|
|
119
119
|
color: #{mg.ref("color-danger")};
|
|
120
120
|
}
|
|
121
121
|
}
|
|
122
|
+
|
|
123
|
+
// --------------------------------------------------------------------------------------------- //
|
|
124
|
+
// Forced colours (Windows high contrast)
|
|
125
|
+
//
|
|
126
|
+
// Borders and text are remapped by the browser; what it drops are the colours painted as a
|
|
127
|
+
// background, such as the active tab's underline.
|
|
128
|
+
// --------------------------------------------------------------------------------------------- //
|
|
129
|
+
|
|
130
|
+
@media (forced-colors: active) {
|
|
131
|
+
.ff-theme {
|
|
132
|
+
.ff-hero-command-tab.active::after {
|
|
133
|
+
background: Highlight;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
.ff-hero-copy {
|
|
137
|
+
border-color: ButtonText;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
}
|
package/src/styles/_content.scss
CHANGED
|
@@ -141,20 +141,19 @@
|
|
|
141
141
|
display: flex;
|
|
142
142
|
align-items: center;
|
|
143
143
|
justify-content: center;
|
|
144
|
-
width:
|
|
145
|
-
height:
|
|
144
|
+
width: 2rem;
|
|
145
|
+
height: 2rem;
|
|
146
146
|
border-radius: #{mg.ref("radius-sm")};
|
|
147
147
|
background: transparent;
|
|
148
|
-
font-size: 1.
|
|
148
|
+
font-size: 1.25rem;
|
|
149
149
|
line-height: 1;
|
|
150
150
|
color: inherit;
|
|
151
|
-
opacity: 0.6;
|
|
152
151
|
transform: translateY(-50%);
|
|
153
152
|
cursor: pointer;
|
|
154
153
|
}
|
|
155
154
|
|
|
156
155
|
.ff-banner-close:hover {
|
|
157
|
-
|
|
156
|
+
background: color-mix(in srgb, currentcolor 18%, transparent);
|
|
158
157
|
}
|
|
159
158
|
|
|
160
159
|
// ----------------------------------------------------------------------------------------- //
|
package/src/styles/_motion.scss
CHANGED
|
@@ -213,3 +213,14 @@
|
|
|
213
213
|
transform #{mg.ref("motion-duration-slow")} #{mg.ref("motion-ease")};
|
|
214
214
|
}
|
|
215
215
|
}
|
|
216
|
+
|
|
217
|
+
@media (prefers-reduced-motion: reduce) {
|
|
218
|
+
.ff-theme {
|
|
219
|
+
.ff-to-top,
|
|
220
|
+
.ff-hero-command-tab,
|
|
221
|
+
.ff-hero-command-tab::after,
|
|
222
|
+
.ff-hero-copy {
|
|
223
|
+
transition: none;
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
}
|
package/src/styles/_sidebar.scss
CHANGED
|
@@ -54,6 +54,7 @@
|
|
|
54
54
|
|
|
55
55
|
.VPSidebar .group > .VPSidebarItem.level-0 > .item {
|
|
56
56
|
position: relative;
|
|
57
|
+
align-items: center;
|
|
57
58
|
gap: 0.75rem;
|
|
58
59
|
padding-bottom: 0.75rem;
|
|
59
60
|
}
|
|
@@ -61,7 +62,7 @@
|
|
|
61
62
|
.VPSidebar .group > .VPSidebarItem.level-0 > .item::before {
|
|
62
63
|
content: counter(ff-section, decimal-leading-zero);
|
|
63
64
|
font-family: #{mg.ref("font-mono")};
|
|
64
|
-
font-size:
|
|
65
|
+
font-size: 0.8125rem;
|
|
65
66
|
font-weight: 600;
|
|
66
67
|
line-height: 1.4;
|
|
67
68
|
letter-spacing: 0.02em;
|
|
@@ -71,7 +72,7 @@
|
|
|
71
72
|
.VPSidebarItem.level-0 > .item > .text {
|
|
72
73
|
padding: 0;
|
|
73
74
|
font-family: #{mg.ref("font-mono")};
|
|
74
|
-
font-size:
|
|
75
|
+
font-size: 0.8125rem;
|
|
75
76
|
font-weight: 600;
|
|
76
77
|
line-height: 1.4;
|
|
77
78
|
text-transform: uppercase;
|
|
@@ -97,6 +98,22 @@
|
|
|
97
98
|
font-weight: 600;
|
|
98
99
|
}
|
|
99
100
|
|
|
101
|
+
// A sub-group with no link of its own (`items` but no `link`) still renders a `.text` node, but
|
|
102
|
+
// as a direct child of `.item` rather than nested in `.link` like every real page — the same
|
|
103
|
+
// distinction the level-0 section headings above already rely on. Borrow their faint-caps
|
|
104
|
+
// voice, scaled down, so a category reads as a category rather than a destination.
|
|
105
|
+
|
|
106
|
+
.VPSidebarItem.level-1 > .item > .text,
|
|
107
|
+
.VPSidebarItem.level-2 > .item > .text,
|
|
108
|
+
.VPSidebarItem.level-3 > .item > .text {
|
|
109
|
+
font-family: #{mg.ref("font-mono")};
|
|
110
|
+
font-size: #{mg.ref("size-label")};
|
|
111
|
+
font-weight: 600;
|
|
112
|
+
text-transform: uppercase;
|
|
113
|
+
letter-spacing: 0.06em;
|
|
114
|
+
color: #{mg.ref("color-ink-faint")};
|
|
115
|
+
}
|
|
116
|
+
|
|
100
117
|
// Nested levels step down in size and hang off a rule.
|
|
101
118
|
|
|
102
119
|
.VPSidebarItem.level-1 .items {
|
package/src/styles/_tokens.scss
CHANGED
|
@@ -83,7 +83,7 @@ $light: (
|
|
|
83
83
|
"surface-alt": #f4f2ee,
|
|
84
84
|
"ink": #1a1917,
|
|
85
85
|
"ink-muted": #55524c,
|
|
86
|
-
"ink-faint": #
|
|
86
|
+
"ink-faint": #6b665e,
|
|
87
87
|
"rule": #e6e2da,
|
|
88
88
|
"rule-strong": #d3cec4,
|
|
89
89
|
"accent": #2745cf,
|
|
@@ -104,7 +104,7 @@ $dark: (
|
|
|
104
104
|
"surface-alt": #201e1b,
|
|
105
105
|
"ink": #ece9e3,
|
|
106
106
|
"ink-muted": #a5a099,
|
|
107
|
-
"ink-faint": #
|
|
107
|
+
"ink-faint": #8f8a82,
|
|
108
108
|
"rule": #2c2a26,
|
|
109
109
|
"rule-strong": #423e38,
|
|
110
110
|
"accent": #94a8ff,
|
package/src/types.ts
CHANGED
|
@@ -58,8 +58,6 @@ export interface ThemeLabels {
|
|
|
58
58
|
lastUpdated?: string
|
|
59
59
|
/** Heading of the hero install panel. Defaults to `Install`. */
|
|
60
60
|
heroInstall?: string
|
|
61
|
-
/** Hero copy button. Defaults to `Copy`. */
|
|
62
|
-
heroCopy?: string
|
|
63
61
|
/** Hero copy button once the command is on the clipboard. Defaults to `Copied`. */
|
|
64
62
|
heroCopied?: string
|
|
65
63
|
/** Accessible name of the hero copy button; `{0}` is the command. Defaults to `Copy {0}`. */
|
|
@@ -68,6 +66,8 @@ export interface ThemeLabels {
|
|
|
68
66
|
backToTop?: string
|
|
69
67
|
/** Heading of the footer social column. Defaults to `Follow`. */
|
|
70
68
|
footerSocial?: string
|
|
69
|
+
/** Hidden hint after links that open in a new tab. Defaults to `opens in a new tab`. */
|
|
70
|
+
newTab?: string
|
|
71
71
|
/** Heading of the sponsors section. Defaults to `Sponsors`. */
|
|
72
72
|
sponsors?: string
|
|
73
73
|
/** Sponsors section action button, when the site sets `actionLink` but no `actionText`. Defaults to `Become a sponsor`. */
|
|
@@ -108,6 +108,11 @@ export interface HeroExtras {
|
|
|
108
108
|
meta?: HeroMetaItem[]
|
|
109
109
|
}
|
|
110
110
|
|
|
111
|
+
/**
|
|
112
|
+
* Text fields documented as accepting inline HTML (banner text, hero and feature copy, footer
|
|
113
|
+
* message) are rendered as-is. They come from the site's own config and frontmatter, so they are
|
|
114
|
+
* trusted: never feed them user-submitted content.
|
|
115
|
+
*/
|
|
111
116
|
export interface ThemeOptions {
|
|
112
117
|
/** Dismissible announcement bar above the navigation. */
|
|
113
118
|
banner?: BannerConfig
|
|
@@ -137,4 +142,15 @@ export interface ThemeConfig extends DefaultTheme.Config {
|
|
|
137
142
|
ff?: ThemeOptions
|
|
138
143
|
}
|
|
139
144
|
|
|
145
|
+
// Declares `themeConfig.ff` on the default theme's own config type, so a host's `defineConfig`
|
|
146
|
+
// accepts it and the theme reads it without a cast.
|
|
147
|
+
declare module 'vitepress/theme' {
|
|
148
|
+
// eslint-disable-next-line @typescript-eslint/no-namespace
|
|
149
|
+
namespace DefaultTheme {
|
|
150
|
+
interface Config {
|
|
151
|
+
ff?: ThemeOptions
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
|
|
140
156
|
export type { DefaultTheme };
|