@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 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.5.3",
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.2",
39
- "@commitlint/config-conventional": "^21.2.2",
40
- "@front-factory/eslint-config": "^2.4.2",
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.2.2",
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.9",
46
+ "@semantic-release/github": "^12.0.10",
46
47
  "conventional-changelog-conventionalcommits": "^9.3.1",
47
- "eslint": "^10.10.0",
48
- "eslint-plugin-vue": "^10.11.0",
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.100.0",
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.70.0",
56
+ "typescript-eslint": "^8.71.1",
55
57
  "vitepress": "^2.0.0-alpha.20",
56
- "vue": "^3.5.34",
57
- "vue-tsc": "^3.2.0"
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 onScroll() {
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
- onScroll();
44
+ update();
33
45
  window.addEventListener('scroll', onScroll, {
34
46
  passive: true
35
47
  });
36
48
  });
37
49
 
38
- onUnmounted(() => window.removeEventListener('scroll', onScroll));
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
- :tabindex="visible ? 0 : -1"
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
- localStorage.setItem(`ff-banner-${banner.value.id}`, 'dismissed');
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
- &#215;
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
- const elapsed = page.value.lastUpdated - Date.now();
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
- <span
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
- </span>
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
- <div
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
- </div>
82
+ </nav>
82
83
  </div>
83
84
 
84
- <div
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
- </div>
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
- <aside
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
- </aside>
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
- await navigator.clipboard.writeText(activeCommand.value);
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="tablist"
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-selected="index === activeTab"
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>(() => (theme.value as ThemeConfig).ff ?? {});
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
+ }
@@ -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
+ }
@@ -141,20 +141,19 @@
141
141
  display: flex;
142
142
  align-items: center;
143
143
  justify-content: center;
144
- width: 1.5rem;
145
- height: 1.5rem;
144
+ width: 2rem;
145
+ height: 2rem;
146
146
  border-radius: #{mg.ref("radius-sm")};
147
147
  background: transparent;
148
- font-size: 1.125rem;
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
- opacity: 1;
156
+ background: color-mix(in srgb, currentcolor 18%, transparent);
158
157
  }
159
158
 
160
159
  // ----------------------------------------------------------------------------------------- //
@@ -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
+ }
@@ -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: #{mg.ref("size-label")};
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: #{mg.ref("size-label")};
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 {
@@ -83,7 +83,7 @@ $light: (
83
83
  "surface-alt": #f4f2ee,
84
84
  "ink": #1a1917,
85
85
  "ink-muted": #55524c,
86
- "ink-faint": #8b867d,
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": #77726a,
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 };