@frontfactory/vitepress-theme 1.8.0 → 1.10.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 +39 -0
- package/README.md +11 -391
- package/config.d.ts +4 -3
- package/config.js +58 -40
- package/dist/style.css +1 -1
- package/node/banner.d.ts +3 -0
- package/node/banner.js +14 -0
- package/node/blog.d.ts +11 -0
- package/node/blog.js +63 -0
- package/node/llms.js +4 -3
- package/node/og.js +5 -6
- package/node/options.d.ts +1 -0
- package/node/options.js +17 -0
- package/node/page-actions.d.ts +12 -0
- package/node/page-actions.js +34 -0
- package/node/pages.js +34 -14
- package/node/rss.js +13 -21
- package/package.json +1 -1
- package/src/blog/posts.data.ts +7 -4
- package/src/components/FfBackToTop.vue +6 -36
- package/src/components/FfBanner.vue +3 -2
- package/src/components/FfCopyStatus.vue +6 -14
- package/src/components/FfDocMeta.vue +299 -24
- package/src/components/FfFeedback.vue +4 -9
- package/src/components/FfHero.vue +14 -33
- package/src/components/FfHeroActions.vue +44 -0
- package/src/components/FfHeroCommand.vue +3 -2
- package/src/components/FfPost.vue +6 -4
- package/src/components/FfProgress.vue +6 -40
- package/src/composables/blog.ts +8 -11
- package/src/composables/copy.ts +29 -0
- package/src/composables/frame.ts +50 -0
- package/src/composables/options.ts +9 -1
- package/src/composables/tabs.ts +2 -35
- package/src/composables/transient.ts +27 -0
- package/src/content/Tabs.vue +27 -6
- package/src/internal.ts +1 -0
- package/src/layout/FfLayout.vue +3 -3
- package/src/styles/_base.scss +5 -9
- package/src/styles/_blocks.scss +4 -7
- package/src/styles/_blog.scss +4 -5
- package/src/styles/_code.scss +12 -20
- package/src/styles/_content.scss +153 -63
- package/src/styles/_doc.scss +26 -25
- package/src/styles/_home.scss +31 -61
- package/src/styles/_mixins.scss +87 -0
- package/src/styles/_motion.scss +12 -10
- package/src/styles/_nav.scss +12 -19
- package/src/styles/_sidebar.scss +5 -8
- package/src/styles/_tokens.scss +19 -4
- package/src/types.ts +31 -4
- package/types/components/FfHeroActions.vue.d.ts +19 -0
- package/types/composables/blog.d.ts +3 -4
- package/types/composables/copy.d.ts +6 -0
- package/types/composables/frame.d.ts +6 -0
- package/types/composables/tabs.d.ts +0 -5
- package/types/composables/transient.d.ts +6 -0
- package/types/internal.d.ts +1 -0
- package/types/types.d.ts +29 -4
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-tracking-label-tight:.06em;--ff-tracking-label-wide:.08em;--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-duration-enter:650ms;--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;--ff-color-shadow-sm:rgba(0,0,0,.05);--ff-color-shadow-md:rgba(0,0,0,.08);--ff-color-shadow-lg:rgba(0,0,0,.1);--ff-color-shadow-xl:rgba(0,0,0,.12);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;--ff-color-shadow-sm:rgba(0,0,0,.3);--ff-color-shadow-md:rgba(0,0,0,.4);--ff-color-shadow-lg:rgba(0,0,0,.45);--ff-color-shadow-xl:rgba(0,0,0,.5);color-scheme:dark}:root[data-ff-preset=emerald]{--ff-color-accent:#0f7a55;--ff-color-accent-hover:#0b5e41;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(15,122,85,.09);--ff-color-accent-glow:rgba(15,122,85,.16)}:root.dark[data-ff-preset=emerald]{--ff-color-accent:#4fd1a1;--ff-color-accent-hover:#7fe0bc;--ff-color-accent-contrast:#0c1512;--ff-color-accent-soft:rgba(79,209,161,.13);--ff-color-accent-glow:rgba(79,209,161,.2)}:root[data-ff-preset=crimson]{--ff-color-accent:#b4233c;--ff-color-accent-hover:#8f1a2f;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(180,35,60,.09);--ff-color-accent-glow:rgba(180,35,60,.16)}:root.dark[data-ff-preset=crimson]{--ff-color-accent:#ff8a9b;--ff-color-accent-hover:#ffb0bc;--ff-color-accent-contrast:#1a0d10;--ff-color-accent-soft:rgba(255,138,155,.13);--ff-color-accent-glow:rgba(255,138,155,.2)}:root[data-ff-preset=violet]{--ff-color-accent:#6d3fd1;--ff-color-accent-hover:#5530a8;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(109,63,209,.09);--ff-color-accent-glow:rgba(109,63,209,.16)}:root.dark[data-ff-preset=violet]{--ff-color-accent:#b9a2ff;--ff-color-accent-hover:#d0c2ff;--ff-color-accent-contrast:#140f20;--ff-color-accent-soft:rgba(185,162,255,.13);--ff-color-accent-glow:rgba(185,162,255,.2)}:root[data-ff-preset=amber]{--ff-color-accent:#a35200;--ff-color-accent-hover:#7f3f00;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(163,82,0,.09);--ff-color-accent-glow:rgba(163,82,0,.16)}:root.dark[data-ff-preset=amber]{--ff-color-accent:#f5b452;--ff-color-accent-hover:#f8ca82;--ff-color-accent-contrast:#1a1206;--ff-color-accent-soft:rgba(245,180,82,.13);--ff-color-accent-glow:rgba(245,180,82,.2)}: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 var(--ff-color-shadow-md);--vp-shadow-4: 0 16px 40px var(--ff-color-shadow-lg);--vp-shadow-5: 0 24px 64px var(--ff-color-shadow-xl);--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: var(--ff-layout-wide);--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}.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:var(--ff-tracking-label-tight);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 .VPNavBarTitle{display:flex;align-items:center;gap:.75rem;height:var(--vp-nav-height)}.ff-theme .VPNavBarTitle .title{display:flex;align-items:center;min-width:0;height:100%;color:var(--vp-c-text-1);transition:opacity .25s}.ff-theme .VPNavBarTitle .title>span{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ff-theme .VPNavBarTitle .logo{flex:none;height:var(--vp-nav-logo-height)}@media(width >= 960px){.ff-theme .VPNavBarTitle .title{flex-shrink:0}.ff-theme .VPNavBarTitle.has-sidebar{max-width:calc(var(--vp-sidebar-width) - 4rem)}}.ff-theme .ff-version-switcher{flex:none}.ff-theme .ff-version-switcher .button{height:auto;padding:.25rem .5rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);transition:border-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-version-switcher .button:hover,.ff-theme .ff-version-switcher .button[aria-expanded=true]{border-color:var(--ff-color-rule-strong)}.ff-theme .ff-version-switcher .text{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);line-height:1;color:var(--ff-color-ink-muted)}.ff-theme .ff-version-switcher .menu{top:100%;inset-inline:0 auto;padding-top:.5rem}.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)}.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:var(--ff-tracking-label-tight)}.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:var(--ff-tracking-label-wide);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:var(--ff-tracking-label-tight);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[data-layout=wide] .VPDoc .content-container{max-width:var(--ff-layout-wide)}.ff-theme[data-layout=wide] .VPDoc .aside{display: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:color-mix(in srgb, var(--ff-color-accent) 55%, transparent);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:var(--ff-tracking-label-wide);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}.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: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:var(--ff-tracking-label-tight)}.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);opacity:1}.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:var(--ff-tracking-label-tight);color:var(--ff-color-ink);cursor:pointer}.ff-theme .vp-doc .custom-block.details[open] summary{margin-bottom:.75rem}.ff-theme .VPBadge.new{border-color:var(--ff-color-accent);color:var(--ff-color-accent)}.ff-theme .VPBadge.beta{border-color:var(--ff-color-warning);color:var(--ff-color-warning)}.ff-theme .VPBadge.deprecated{border-color:var(--ff-color-danger);color:var(--ff-color-danger);text-decoration:line-through}.ff-theme .VPBadge.since{border-color:var(--ff-color-rule-strong);color:var(--ff-color-ink-muted)}.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 var(--ff-color-shadow-sm)}.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}.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 .ff-feature-linked: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-anchor{color:inherit;text-decoration:none}.ff-theme .ff-feature-anchor::before{content:"";position:absolute;inset:0}.ff-theme .ff-feature-anchor:focus-visible{outline:none}.ff-theme .ff-feature:has(.ff-feature-anchor:focus-visible){outline:2px solid var(--ff-color-accent);outline-offset:-2px}.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:5.625rem}.ff-theme .ff-sponsors-grid .vp-sponsor-grid-image{max-width:7.5rem;max-height:2rem}.ff-theme .ff-sponsors-grid .vp-sponsor-tier{display:flex;align-items:center;justify-content:flex-start;height:3.75rem;margin:0 0 .25rem;padding:0 1.25rem;font-family:var(--ff-font-mono);font-size:.875rem;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{display:flex;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-doc-meta-copy{display:inline-flex;align-items:center;gap:.5em;margin-left:auto;padding:.375rem .625rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0);font:inherit;letter-spacing:inherit;text-transform:inherit;color:inherit;cursor:pointer}.ff-theme .ff-doc-meta-copy::before{content:"";width:.875rem;height:.875rem;background:var(--vp-icon-copy) 50%/contain no-repeat}.ff-theme .ff-doc-meta-copy:hover,.ff-theme .ff-doc-meta-copy.copied{border-color:var(--ff-color-rule-strong);background-color:var(--ff-color-surface-alt);color:var(--ff-color-ink)}.ff-theme .ff-doc-meta-copy.copied::before{background-image:var(--vp-icon-copied)}.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}.ff-theme .ff-to-top.is-visible{opacity:1;transform:translateY(0);pointer-events:auto}.ff-theme .ff-progress{position:fixed;top:0;right:0;left:0;z-index:calc(var(--vp-z-index-layout-top) + 1);height:2px;background:var(--ff-color-accent);transform-origin:left;pointer-events:none}.ff-theme .ff-feedback{display:flex;flex-wrap:wrap;align-items:center;gap:.75rem 1rem;margin-bottom:1.5rem;padding-top:1.5rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-feedback-question,.ff-theme .ff-feedback-thanks{margin:0}.ff-theme .ff-feedback-actions{display:flex;gap:.5rem}.ff-theme .ff-feedback-button{padding:.5rem .75rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0);color:var(--ff-color-ink-muted);cursor:pointer}.ff-theme .ff-feedback-button:hover{border-color:var(--ff-color-rule-strong);background:var(--ff-color-surface-alt)}.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 >= 640px){.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)}.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)}.ff-theme .vp-doc .ff-tabs{margin:1.5rem 0}.ff-theme .vp-doc .ff-tabs-list{display:flex;flex-wrap:wrap;margin-bottom:1rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc .ff-tabs-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 .vp-doc .ff-tabs-tab:first-child{padding-left:0}.ff-theme .vp-doc .ff-tabs-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 .vp-doc .ff-tabs-tab:hover,.ff-theme .vp-doc .ff-tabs-tab.active{color:var(--ff-color-ink)}.ff-theme .vp-doc .ff-tabs-tab.active::after{background:var(--ff-color-accent)}.ff-theme .vp-doc .ff-tabs-panel>:first-child{margin-top:0}.ff-theme .vp-doc .ff-tabs-panel>:last-child{margin-bottom:0}.ff-theme .vp-doc .ff-filetree{margin:1.75rem 0;font-family:var(--ff-font-mono);font-size:.875rem}.ff-theme .vp-doc .ff-filetree ul{margin:0;padding:0;list-style:none}.ff-theme .vp-doc .ff-filetree ul ul{margin-left:.5rem;padding-left:1rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc .ff-filetree li{margin:0;padding:.125rem 0;line-height:1.6}.ff-theme .vp-doc .ff-filetree .is-file>.ff-filetree-name{color:var(--ff-color-ink-muted)}.ff-theme .vp-doc .ff-filetree .is-folder>.ff-filetree-name{font-weight:500;color:var(--ff-color-ink)}.ff-theme .vp-doc .ff-filetree .is-folder>.ff-filetree-name::after{content:"/";color:var(--ff-color-ink-faint)}.ff-theme .vp-doc .ff-filetree code{padding:0;background:rgba(0,0,0,0);font-size:inherit;color:inherit}.ff-theme .vp-doc .ff-timeline{margin:1.75rem 0;padding-left:2.5rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc .ff-timeline-item{position:relative;padding-bottom:1.75rem}.ff-theme .vp-doc .ff-timeline-item:last-child{padding-bottom:0}.ff-theme .vp-doc .ff-timeline-item::before{position:absolute;top:.3125rem;left:-2.8125rem;width:.625rem;height:.625rem;border:var(--ff-rule-accent-width) solid var(--ff-color-accent);background:var(--ff-color-paper);content:""}.ff-theme .vp-doc .ff-timeline-date{margin:0;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-theme .vp-doc .ff-timeline-title{margin:.25rem 0 0;padding:0;border:0;font-family:var(--ff-font-display);font-size:1.0625rem;font-weight:600;font-variation-settings:"opsz" 32;line-height:1.75rem;letter-spacing:normal}.ff-theme .vp-doc .ff-timeline-body>:first-child{margin-top:.5rem}.ff-theme .vp-doc .ff-timeline-body>:last-child{margin-bottom:0}.ff-theme .ff-blog{max-width:var(--ff-layout-content);margin:0 auto;padding:3rem 1.5rem 6rem}@media(width >= 960px){.ff-theme .ff-blog{padding-top:4.5rem}}.ff-theme .ff-blog-title{margin:0;font-family:var(--ff-font-display);font-size:var(--ff-size-h1);font-weight:620;line-height:var(--ff-leading-tight);letter-spacing:-0.03em}.ff-theme .ff-blog-lede{margin:1.25rem 0 0;font-size:var(--ff-size-body);line-height:1.65;color:var(--ff-color-ink-muted)}.ff-theme .ff-blog-list{margin:3rem 0 0;padding:0;border-top:var(--ff-rule-width) solid var(--ff-color-rule-strong);list-style:none}.ff-theme .ff-blog-post{padding:2rem 0;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-blog-meta,.ff-theme .ff-post{flex-wrap:wrap;gap:.375rem .75rem}.ff-theme .ff-blog-meta>*+*::before,.ff-theme .ff-post-item+.ff-post-item::before{content:"·";margin-right:.75rem}.ff-theme .ff-blog-post-title{margin:.875rem 0 0;font-family:var(--ff-font-display);font-size:var(--ff-size-h2);font-weight:600;line-height:1.3;letter-spacing:-0.02em}.ff-theme .ff-blog-post-title a{color:var(--ff-color-ink);text-decoration:none;transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-blog-post-title a:hover{color:var(--ff-color-accent)}.ff-theme .ff-blog-excerpt{margin:.75rem 0 0;line-height:var(--ff-leading-body);color:var(--ff-color-ink-muted)}.ff-theme .ff-doc-meta:has(+.ff-post){margin-bottom:1rem;padding-bottom:0;border-bottom:0}.ff-theme .ff-post{display:flex;margin-bottom:1.5rem;padding-bottom:1rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-post-author{display:inline-flex;align-items:center;gap:.5rem}.ff-theme .ff-post-author a{color:inherit;text-decoration:underline;text-decoration-color:var(--ff-color-rule-strong);text-underline-offset:.25em}.ff-theme .ff-post-author a:hover{color:var(--ff-color-accent)}.ff-theme .ff-post-avatar{width:1.25rem;height:1.25rem;border-radius:50%;object-fit:cover}@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}@container style(--ff-hero-glow-opacity: 0){.ff-theme .ff-hero-glow{animation:none}}.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 var(--ff-motion-duration-enter) 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 .ff-feature-linked: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,.ff-theme .VPNavBarMenuLink::after{transition:none}}@media print{:root.dark{--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;--ff-color-shadow-sm:rgba(0,0,0,.05);--ff-color-shadow-md:rgba(0,0,0,.08);--ff-color-shadow-lg:rgba(0,0,0,.1);--ff-color-shadow-xl:rgba(0,0,0,.12);color-scheme:light}:root.dark[data-ff-preset=emerald]{--ff-color-accent:#0f7a55;--ff-color-accent-hover:#0b5e41;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(15,122,85,.09);--ff-color-accent-glow:rgba(15,122,85,.16)}:root.dark[data-ff-preset=crimson]{--ff-color-accent:#b4233c;--ff-color-accent-hover:#8f1a2f;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(180,35,60,.09);--ff-color-accent-glow:rgba(180,35,60,.16)}:root.dark[data-ff-preset=violet]{--ff-color-accent:#6d3fd1;--ff-color-accent-hover:#5530a8;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(109,63,209,.09);--ff-color-accent-glow:rgba(109,63,209,.16)}:root.dark[data-ff-preset=amber]{--ff-color-accent:#a35200;--ff-color-accent-hover:#7f3f00;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(163,82,0,.09);--ff-color-accent-glow:rgba(163,82,0,.16)}:root.dark .shiki span{color:var(--shiki-light, inherit);font-weight:var(--shiki-light-font-weight, inherit);text-decoration:var(--shiki-light-text-decoration, inherit)}.ff-theme .VPNav,.ff-theme .VPLocalNav,.ff-theme .VPSidebar,.ff-theme .VPDoc .aside,.ff-theme .VPDocFooter .prev-next,.ff-theme .ff-banner,.ff-theme .ff-to-top,.ff-theme .ff-progress,.ff-theme .ff-feedback{display:none}.ff-theme .VPContent,.ff-theme .VPContent.has-sidebar{margin-top:0;padding-top:0;padding-right:0;padding-left:0}.ff-theme .VPDoc .container{display:block}.vp-doc a[href^=http]:not(.header-anchor)::after{content:" (" attr(href) ")"}}
|
|
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-title:-0.03em;--ff-tracking-heading:-0.02em;--ff-tracking-subheading:-0.015em;--ff-tracking-tight:-0.01em;--ff-tracking-label:.1em;--ff-tracking-label-tight:.06em;--ff-tracking-label-wide:.08em;--ff-size-label:.6875rem;--ff-size-meta:.75rem;--ff-size-small:.8125rem;--ff-size-ui:.875rem;--ff-size-ui-lg:.9375rem;--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-xs:.125rem;--ff-radius-sm:.3125rem;--ff-radius-md:.625rem;--ff-rule-width:1px;--ff-rule-accent-width:2px;--ff-motion-duration:200ms;--ff-motion-duration-slow:420ms;--ff-motion-duration-fade:250ms;--ff-motion-duration-enter:650ms;--ff-motion-duration-enter-panel:800ms;--ff-motion-duration-enter-image:900ms;--ff-motion-stagger:20ms;--ff-motion-ease:cubic-bezier(0.2, 0.6, 0.2, 1);--ff-banner-height:2.6875rem;--ff-z-float:20;--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;--ff-color-shadow-sm:rgba(0,0,0,.05);--ff-color-shadow-md:rgba(0,0,0,.08);--ff-color-shadow-lg:rgba(0,0,0,.1);--ff-color-shadow-xl:rgba(0,0,0,.12);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;--ff-color-shadow-sm:rgba(0,0,0,.3);--ff-color-shadow-md:rgba(0,0,0,.4);--ff-color-shadow-lg:rgba(0,0,0,.45);--ff-color-shadow-xl:rgba(0,0,0,.5);color-scheme:dark}:root[data-ff-preset=emerald]{--ff-color-accent:#0f7a55;--ff-color-accent-hover:#0b5e41;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(15,122,85,.09);--ff-color-accent-glow:rgba(15,122,85,.16)}:root.dark[data-ff-preset=emerald]{--ff-color-accent:#4fd1a1;--ff-color-accent-hover:#7fe0bc;--ff-color-accent-contrast:#0c1512;--ff-color-accent-soft:rgba(79,209,161,.13);--ff-color-accent-glow:rgba(79,209,161,.2)}:root[data-ff-preset=crimson]{--ff-color-accent:#b4233c;--ff-color-accent-hover:#8f1a2f;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(180,35,60,.09);--ff-color-accent-glow:rgba(180,35,60,.16)}:root.dark[data-ff-preset=crimson]{--ff-color-accent:#ff8a9b;--ff-color-accent-hover:#ffb0bc;--ff-color-accent-contrast:#1a0d10;--ff-color-accent-soft:rgba(255,138,155,.13);--ff-color-accent-glow:rgba(255,138,155,.2)}:root[data-ff-preset=violet]{--ff-color-accent:#6d3fd1;--ff-color-accent-hover:#5530a8;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(109,63,209,.09);--ff-color-accent-glow:rgba(109,63,209,.16)}:root.dark[data-ff-preset=violet]{--ff-color-accent:#b9a2ff;--ff-color-accent-hover:#d0c2ff;--ff-color-accent-contrast:#140f20;--ff-color-accent-soft:rgba(185,162,255,.13);--ff-color-accent-glow:rgba(185,162,255,.2)}:root[data-ff-preset=amber]{--ff-color-accent:#a35200;--ff-color-accent-hover:#7f3f00;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(163,82,0,.09);--ff-color-accent-glow:rgba(163,82,0,.16)}:root.dark[data-ff-preset=amber]{--ff-color-accent:#f5b452;--ff-color-accent-hover:#f8ca82;--ff-color-accent-contrast:#1a1206;--ff-color-accent-soft:rgba(245,180,82,.13);--ff-color-accent-glow:rgba(245,180,82,.2)}: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 var(--ff-color-shadow-md);--vp-shadow-4: 0 16px 40px var(--ff-color-shadow-lg);--vp-shadow-5: 0 24px 64px var(--ff-color-shadow-xl);--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: var(--ff-layout-wide);--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: var(--ff-size-ui-lg);--vp-custom-block-code-font-size: var(--ff-size-small);--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;line-height:1;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-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}.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}.ff-theme .VPButton.medium{padding:0 1.25rem;line-height:2.75rem;font-size:var(--ff-size-ui)}.ff-theme .VPButton.big{padding:0 1.75rem;line-height:3.25rem;font-size:var(--ff-size-ui-lg)}.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:var(--ff-tracking-label-tight);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 .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:not(:has(.logo))::before{content:"";width:.5rem;height:.5rem;background:var(--ff-color-accent)}.ff-theme .VPNavBarTitle{display:flex;align-items:center;gap:.75rem;height:var(--vp-nav-height)}.ff-theme .VPNavBarTitle .title{display:flex;align-items:center;min-width:0;height:100%;border-bottom:0;gap:.625rem;font-family:var(--ff-font-display);font-size:var(--ff-size-ui-lg);font-weight:620;letter-spacing:var(--ff-tracking-tight);color:var(--vp-c-text-1);transition:opacity var(--ff-motion-duration-fade) var(--ff-motion-ease)}.ff-theme .VPNavBarTitle .title>span{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ff-theme .VPNavBarTitle .logo{flex:none;height:var(--vp-nav-logo-height)}@media(width >= 960px){.ff-theme .VPNavBarTitle .title{flex-shrink:0}.ff-theme .VPNavBarTitle.has-sidebar{max-width:calc(var(--vp-sidebar-width) - 4rem)}}.ff-theme .ff-version-switcher{flex:none}.ff-theme .ff-version-switcher .button{height:auto;padding:.25rem .5rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);transition:border-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-version-switcher .button:hover,.ff-theme .ff-version-switcher .button[aria-expanded=true]{border-color:var(--ff-color-rule-strong)}.ff-theme .ff-version-switcher .text{font-family:var(--ff-font-mono);font-size:var(--ff-size-label);line-height:1;color:var(--ff-color-ink-muted)}.ff-theme .ff-version-switcher .menu{top:100%;inset-inline:0 auto;padding-top:.5rem}.ff-theme .VPNavBarMenuLink,.ff-theme .VPNavBarMenuGroup .button{font-size:var(--ff-size-ui);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)}.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:var(--ff-size-small);color:var(--ff-color-ink-faint)}.ff-theme .VPNavBarSearchButton:hover{border-color:var(--ff-color-rule-strong);color:var(--ff-color-ink-muted)}.ff-theme .VPNavBarSearchButton .keys kbd{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:var(--ff-radius-xs);background:var(--ff-color-surface-alt);box-shadow:none}.ff-theme .VPSwitch .icon{border-radius:var(--ff-radius-xs)}.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:var(--ff-tracking-label-tight)}.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;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:var(--ff-size-small);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-small);font-weight:600;line-height:1.4;text-transform:uppercase;letter-spacing:var(--ff-tracking-label-wide);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:var(--ff-size-ui);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:var(--ff-tracking-label-tight);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:var(--ff-size-small)}.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[data-layout=wide] .VPDoc .content-container{max-width:var(--ff-layout-wide)}.ff-theme[data-layout=wide] .VPDoc .aside{display: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:var(--ff-tracking-title)}.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:var(--ff-tracking-subheading)}.ff-theme .vp-doc h4{margin:2rem 0 .5rem;font-size:var(--ff-size-body);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-visible{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:color-mix(in srgb, var(--ff-color-accent) 55%, transparent);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:var(--ff-size-body);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);text-align:left;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 td{padding:.75rem .875rem .75rem 0;border:0;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule);font-size:var(--ff-size-ui-lg);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 .VPLastUpdated{font-family:var(--ff-font-mono);font-size:var(--ff-size-meta);font-weight:400;line-height:var(--ff-leading-body);color:var(--ff-color-ink-faint)}.ff-theme .VPDocFooter .edit-link-button{color:var(--ff-color-accent)}.ff-theme .VPDocFooter .last-updated .VPLastUpdated time{margin-inline-start:1ch}.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:var(--ff-tracking-subheading);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:var(--ff-tracking-label-wide);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:var(--ff-size-ui);font-weight:450;line-height:1.5;color:var(--ff-color-ink-muted);white-space:normal;overflow:visible;overflow-wrap:break-word}.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:var(--ff-size-small)}.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: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:var(--ff-tracking-label-tight)}.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);opacity:1}.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:var(--ff-size-ui-lg)}.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;line-height:1;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 .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:var(--ff-tracking-label-tight);color:var(--ff-color-ink);cursor:pointer}.ff-theme .vp-doc .custom-block.details[open] summary{margin-bottom:.75rem}.ff-theme .VPBadge.new{border-color:var(--ff-color-accent);color:var(--ff-color-accent)}.ff-theme .VPBadge.beta{border-color:var(--ff-color-warning);color:var(--ff-color-warning)}.ff-theme .VPBadge.deprecated{border-color:var(--ff-color-danger);color:var(--ff-color-danger);text-decoration:line-through}.ff-theme .VPBadge.since{border-color:var(--ff-color-rule-strong);color:var(--ff-color-ink-muted)}.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 var(--ff-color-shadow-sm)}.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{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);position:relative;padding:0 .75rem .625rem;border:0;background:rgba(0,0,0,0);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,.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:var(--ff-size-small);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;padding:0 .625rem;border:var(--ff-rule-width) solid var(--ff-color-rule-strong);border-right:0;height:1.75rem;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;border:var(--ff-rule-width) solid var(--ff-color-rule);width:1.75rem;height:1.75rem;border-radius:var(--ff-radius-sm);background-color:rgba(0,0,0,0);background-size:.875rem;background-image:var(--vp-icon-copy);background-position:50%;background-repeat:no-repeat;cursor:pointer}.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)}@media(width < 960px){.ff-theme .ff-hero.has-image .ff-hero-meta,.ff-theme .ff-hero.has-panel .ff-hero-meta{margin-top:3rem}}.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:var(--ff-size-lead);font-weight:600;letter-spacing:var(--ff-tracking-tight);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:var(--ff-size-ui);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:var(--ff-tracking-heading);color:var(--ff-color-rule-strong)}.ff-theme .ff-feature-linked: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:var(--ff-size-h3);font-weight:620;letter-spacing:var(--ff-tracking-subheading);color:var(--ff-color-ink)}.ff-theme .ff-feature-anchor{color:inherit;text-decoration:none}.ff-theme .ff-feature-anchor::before{content:"";position:absolute;inset:0}.ff-theme .ff-feature-anchor:focus-visible{outline:none}.ff-theme .ff-feature:has(.ff-feature-anchor:focus-visible){outline:2px solid var(--ff-color-accent);outline-offset:-2px}.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:var(--ff-size-ui-lg);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:5.625rem}.ff-theme .ff-sponsors-grid .vp-sponsor-grid-image{max-width:7.5rem;max-height:2rem}.ff-theme .ff-sponsors-grid .vp-sponsor-tier{display:flex;align-items:center;justify-content:flex-start;height:3.75rem;margin:0 0 .25rem;padding:0 1.25rem;font-family:var(--ff-font-mono);font-size:var(--ff-size-ui);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}.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:var(--ff-size-small);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{display:flex;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-doc-meta-actions{position:relative;margin-left:auto}.ff-theme .ff-doc-meta-split{display:inline-flex;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);transition:border-color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-doc-meta-split:hover,.ff-theme .ff-doc-meta-split.copied{border-color:var(--ff-color-rule-strong)}.ff-theme .ff-doc-meta-main,.ff-theme .ff-doc-meta-toggle{display:inline-flex;align-items:center;gap:.5em;padding:.375rem .625rem;border:0;background:rgba(0,0,0,0);font:inherit;letter-spacing:inherit;text-transform:inherit;color:inherit;cursor:pointer;transition:background-color var(--ff-motion-duration) var(--ff-motion-ease),color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-doc-meta-main{border-radius:var(--ff-radius-sm) 0 0 var(--ff-radius-sm)}.ff-theme .ff-doc-meta-toggle{border-radius:0 var(--ff-radius-sm) var(--ff-radius-sm) 0}.ff-theme .ff-doc-meta-main+.ff-doc-meta-toggle{padding-inline:.5rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-doc-meta-main:hover,.ff-theme .ff-doc-meta-toggle:hover,.ff-theme .ff-doc-meta-toggle.open,.ff-theme .ff-doc-meta-split.copied .ff-doc-meta-main{background-color:var(--ff-color-surface-alt);color:var(--ff-color-ink)}.ff-theme .ff-doc-meta-main:focus-visible,.ff-theme .ff-doc-meta-toggle:focus-visible,.ff-theme .ff-doc-meta-menu>:focus-visible{outline:2px solid var(--vp-c-brand-1);outline-offset:-2px}.ff-theme .ff-doc-meta-icon{flex:none;width:1rem;height:1rem;fill:none;stroke:currentcolor;stroke-width:2;stroke-linecap:round;stroke-linejoin:round}.ff-theme .ff-doc-meta-icon.brand{fill:currentcolor;stroke:none}.ff-theme .ff-doc-meta-chevron{transition:transform var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-doc-meta-toggle.open .ff-doc-meta-chevron{transform:rotate(180deg)}.ff-theme .ff-doc-meta-menu{position:absolute;top:100%;right:0;z-index:var(--ff-z-float);display:flex;flex-direction:column;min-width:14rem;max-width:calc(100vw - 2rem);margin-top:.375rem;padding:.375rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-md);background:var(--vp-c-bg-elv);box-shadow:var(--vp-shadow-3);white-space:nowrap}.ff-theme .ff-doc-meta-menu>button,.ff-theme .ff-doc-meta-menu>a{display:flex;align-items:center;gap:.625rem;padding:.5rem .625rem;border:0;border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0);font:inherit;letter-spacing:inherit;text-transform:inherit;text-align:left;text-decoration:none;color:inherit;cursor:pointer}.ff-theme .ff-doc-meta-menu>button:hover,.ff-theme .ff-doc-meta-menu>a:hover,.ff-theme .ff-doc-meta-menu>:focus-visible{background-color:var(--ff-color-surface-alt);color:var(--ff-color-ink)}.ff-theme .ff-doc-meta-menu-text{display:flex;flex:1;flex-direction:column;gap:.125rem}.ff-theme .ff-doc-meta-menu small{font-size:.85em;color:var(--ff-color-ink-muted)}.ff-theme .ff-doc-meta-external{width:.875rem;height:.875rem;color:var(--ff-color-ink-muted)}.ff-theme .ff-doc-meta-menu hr{width:100%;height:0;margin:.375rem 0;border:0;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-to-top{position:fixed;right:1.5rem;bottom:1.5rem;z-index:var(--ff-z-float);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}.ff-theme .ff-to-top.is-visible{opacity:1;transform:translateY(0);pointer-events:auto}.ff-theme .ff-progress{position:fixed;top:0;right:0;left:0;z-index:calc(var(--vp-z-index-layout-top) + 1);height:var(--ff-rule-accent-width);background:var(--ff-color-accent);transform-origin:left;pointer-events:none}.ff-theme .ff-feedback{display:flex;flex-wrap:wrap;align-items:center;gap:.75rem 1rem;margin-bottom:1.5rem;padding-top:1.5rem;border-top:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-feedback-question,.ff-theme .ff-feedback-thanks{margin:0}.ff-theme .ff-feedback-actions{display:flex;gap:.5rem}.ff-theme .ff-feedback-button{padding:.5rem .75rem;border:var(--ff-rule-width) solid var(--ff-color-rule);border-radius:var(--ff-radius-sm);background:rgba(0,0,0,0);color:var(--ff-color-ink-muted);cursor:pointer}.ff-theme .ff-feedback-button:hover{border-color:var(--ff-color-rule-strong);background:var(--ff-color-surface-alt)}.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:var(--ff-size-ui);color:var(--ff-color-ink-muted)}.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 >= 640px){.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)}.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:var(--ff-size-body);font-weight:620;letter-spacing:var(--ff-tracking-tight);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:var(--ff-size-ui-lg);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:var(--ff-size-small);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:var(--ff-size-meta);line-height:1.4;text-align:center;color:var(--ff-color-ink-muted)}.ff-theme .vp-doc .ff-tabs{margin:1.5rem 0}.ff-theme .vp-doc .ff-tabs-list{display:flex;flex-wrap:wrap;margin-bottom:1rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc .ff-tabs-tab{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);position:relative;padding:0 .75rem .625rem;border:0;background:rgba(0,0,0,0);cursor:pointer;transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .vp-doc .ff-tabs-tab:first-child{padding-left:0}.ff-theme .vp-doc .ff-tabs-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 .vp-doc .ff-tabs-tab:hover,.ff-theme .vp-doc .ff-tabs-tab.active{color:var(--ff-color-ink)}.ff-theme .vp-doc .ff-tabs-tab.active::after{background:var(--ff-color-accent)}.ff-theme .vp-doc .ff-tabs-panel>:first-child{margin-top:0}.ff-theme .vp-doc .ff-tabs-panel>:last-child{margin-bottom:0}.ff-theme .vp-doc .ff-filetree{margin:1.75rem 0;font-family:var(--ff-font-mono);font-size:var(--ff-size-ui)}.ff-theme .vp-doc .ff-filetree ul{margin:0;padding:0;list-style:none}.ff-theme .vp-doc .ff-filetree ul ul{margin-left:.5rem;padding-left:1rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc .ff-filetree li{margin:0;padding:.125rem 0;line-height:1.6}.ff-theme .vp-doc .ff-filetree .is-file>.ff-filetree-name{color:var(--ff-color-ink-muted)}.ff-theme .vp-doc .ff-filetree .is-folder>.ff-filetree-name{font-weight:500;color:var(--ff-color-ink)}.ff-theme .vp-doc .ff-filetree .is-folder>.ff-filetree-name::after{content:"/";color:var(--ff-color-ink-faint)}.ff-theme .vp-doc .ff-filetree code{padding:0;background:rgba(0,0,0,0);font-size:inherit;color:inherit}.ff-theme .vp-doc .ff-timeline{margin:1.75rem 0;padding-left:2.5rem;border-left:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .vp-doc .ff-timeline-item{position:relative;padding-bottom:1.75rem}.ff-theme .vp-doc .ff-timeline-item:last-child{padding-bottom:0}.ff-theme .vp-doc .ff-timeline-item::before{position:absolute;top:.3125rem;left:-2.8125rem;width:.625rem;height:.625rem;border:var(--ff-rule-accent-width) solid var(--ff-color-accent);background:var(--ff-color-paper);content:""}.ff-theme .vp-doc .ff-timeline-date{margin:0;font-family:var(--ff-font-mono);font-size:var(--ff-size-label);text-transform:uppercase;letter-spacing:var(--ff-tracking-label);color:var(--ff-color-ink-faint)}.ff-theme .vp-doc .ff-timeline-title{margin:.25rem 0 0;padding:0;border:0;font-family:var(--ff-font-display);font-size:1.0625rem;font-weight:600;font-variation-settings:"opsz" 32;line-height:1.75rem;letter-spacing:normal}.ff-theme .vp-doc .ff-timeline-body>:first-child{margin-top:.5rem}.ff-theme .vp-doc .ff-timeline-body>:last-child{margin-bottom:0}.ff-theme .ff-blog{max-width:var(--ff-layout-content);margin:0 auto;padding:3rem 1.5rem 6rem}@media(width >= 960px){.ff-theme .ff-blog{padding-top:4.5rem}}.ff-theme .ff-blog-title{margin:0;font-family:var(--ff-font-display);font-size:var(--ff-size-h1);font-weight:620;line-height:var(--ff-leading-tight);letter-spacing:var(--ff-tracking-title)}.ff-theme .ff-blog-lede{margin:1.25rem 0 0;font-size:var(--ff-size-body);line-height:1.65;color:var(--ff-color-ink-muted)}.ff-theme .ff-blog-list{margin:3rem 0 0;padding:0;border-top:var(--ff-rule-width) solid var(--ff-color-rule-strong);list-style:none}.ff-theme .ff-blog-post{padding:2rem 0;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-blog-meta,.ff-theme .ff-post{flex-wrap:wrap;gap:.375rem .75rem}.ff-theme .ff-blog-meta>*+*::before,.ff-theme .ff-post-item+.ff-post-item::before{content:"·";margin-right:.75rem}.ff-theme .ff-blog-post-title{margin:.875rem 0 0;font-family:var(--ff-font-display);font-size:var(--ff-size-h2);font-weight:600;line-height:1.3;letter-spacing:var(--ff-tracking-heading)}.ff-theme .ff-blog-post-title a{color:var(--ff-color-ink);text-decoration:none;transition:color var(--ff-motion-duration) var(--ff-motion-ease)}.ff-theme .ff-blog-post-title a:hover{color:var(--ff-color-accent)}.ff-theme .ff-blog-excerpt{margin:.75rem 0 0;line-height:var(--ff-leading-body);color:var(--ff-color-ink-muted)}.ff-theme .ff-doc-meta:has(+.ff-post){margin-bottom:1rem;padding-bottom:0;border-bottom:0}.ff-theme .ff-post{display:flex;margin-bottom:1.5rem;padding-bottom:1rem;border-bottom:var(--ff-rule-width) solid var(--ff-color-rule)}.ff-theme .ff-post-author{display:inline-flex;align-items:center;gap:.5rem}.ff-theme .ff-post-author a{color:inherit;text-decoration:underline;text-decoration-color:var(--ff-color-rule-strong);text-underline-offset:.25em}.ff-theme .ff-post-author a:hover{color:var(--ff-color-accent)}.ff-theme .ff-post-avatar{width:1.25rem;height:1.25rem;border-radius:50%;object-fit:cover}@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}@container style(--ff-hero-glow-opacity: 0){.ff-theme .ff-hero-glow{animation:none}}.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 var(--ff-motion-duration-enter) var(--ff-motion-ease) both}.ff-theme .ff-hero-title{animation-delay:calc(var(--ff-motion-stagger)*3)}.ff-theme .ff-hero-tagline{animation-delay:calc(var(--ff-motion-stagger)*6)}.ff-theme .ff-hero-main .ff-hero-actions{animation-delay:calc(var(--ff-motion-stagger)*9)}.ff-theme .ff-hero-panel{animation-delay:calc(var(--ff-motion-stagger)*10);animation-duration:var(--ff-motion-duration-enter-panel)}.ff-theme .ff-hero-meta{animation-delay:calc(var(--ff-motion-stagger)*15)}.ff-theme .ff-hero-image{animation-delay:calc(var(--ff-motion-stagger)*7);animation-duration:var(--ff-motion-duration-enter-image)}}.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:var(--ff-rule-accent-width);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 .ff-feature-linked: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 .ff-feedback-button,.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 .vp-doc .ff-tabs-tab,.ff-theme .vp-doc .ff-tabs-tab::after,.ff-theme .ff-hero-copy,.ff-theme .VPNavBarMenuLink::after{transition:none}}@media print{:root.dark{--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;--ff-color-shadow-sm:rgba(0,0,0,.05);--ff-color-shadow-md:rgba(0,0,0,.08);--ff-color-shadow-lg:rgba(0,0,0,.1);--ff-color-shadow-xl:rgba(0,0,0,.12);color-scheme:light}:root.dark[data-ff-preset=emerald]{--ff-color-accent:#0f7a55;--ff-color-accent-hover:#0b5e41;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(15,122,85,.09);--ff-color-accent-glow:rgba(15,122,85,.16)}:root.dark[data-ff-preset=crimson]{--ff-color-accent:#b4233c;--ff-color-accent-hover:#8f1a2f;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(180,35,60,.09);--ff-color-accent-glow:rgba(180,35,60,.16)}:root.dark[data-ff-preset=violet]{--ff-color-accent:#6d3fd1;--ff-color-accent-hover:#5530a8;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(109,63,209,.09);--ff-color-accent-glow:rgba(109,63,209,.16)}:root.dark[data-ff-preset=amber]{--ff-color-accent:#a35200;--ff-color-accent-hover:#7f3f00;--ff-color-accent-contrast:#fff;--ff-color-accent-soft:rgba(163,82,0,.09);--ff-color-accent-glow:rgba(163,82,0,.16)}:root.dark .shiki span{color:var(--shiki-light, inherit);font-weight:var(--shiki-light-font-weight, inherit);text-decoration:var(--shiki-light-text-decoration, inherit)}.ff-theme .VPNav,.ff-theme .VPLocalNav,.ff-theme .VPSidebar,.ff-theme .VPDoc .aside,.ff-theme .VPDocFooter .prev-next,.ff-theme .ff-banner,.ff-theme .ff-to-top,.ff-theme .ff-progress,.ff-theme .ff-feedback{display:none}.ff-theme .VPContent,.ff-theme .VPContent.has-sidebar{margin-top:0;padding-top:0;padding-right:0;padding-left:0}.ff-theme .VPDoc .container{display:block}.vp-doc a[href^=http]:not(.header-anchor)::after{content:" (" attr(href) ")"}}
|
package/node/banner.d.ts
ADDED
package/node/banner.js
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Class put on `<html>` once a banner is dismissed. Shared by the client and the inline head
|
|
3
|
+
* script, so this file stays free of Node imports.
|
|
4
|
+
*/
|
|
5
|
+
export const BANNER_DISMISSED_CLASS = 'ff-banner-dismissed';
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* `localStorage` key that remembers the dismissal of the banner `id`.
|
|
9
|
+
*
|
|
10
|
+
* @param {string} id
|
|
11
|
+
*/
|
|
12
|
+
export function bannerKey(id) {
|
|
13
|
+
return `ff-banner-${id}`;
|
|
14
|
+
}
|
package/node/blog.d.ts
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export function blogDir(ff?: { blog?: { dir?: string } }): string;
|
|
2
|
+
|
|
3
|
+
export function hasValidDate(value: unknown): boolean;
|
|
4
|
+
|
|
5
|
+
export function isPostPath(dir: string, path: string, date: unknown): boolean;
|
|
6
|
+
|
|
7
|
+
export function resolveAuthor<T extends { name?: string }>(authors: Record<string, T>, value?: string): T | null;
|
|
8
|
+
|
|
9
|
+
export function firstHeading(body: string): string | undefined;
|
|
10
|
+
|
|
11
|
+
export function toTags(value: unknown): unknown[];
|
package/node/blog.js
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Blog directory, without a slash at either end. Shared by the client, the content loader and the
|
|
3
|
+
* RSS feed, so it stays free of Node imports.
|
|
4
|
+
*
|
|
5
|
+
* @param {{ blog?: { dir?: string } }} [ff] The `themeConfig.ff` options.
|
|
6
|
+
*/
|
|
7
|
+
export function blogDir(ff) {
|
|
8
|
+
return (ff?.blog?.dir ?? 'blog').replace(/^\/+|\/+$/g, '');
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* Whether a frontmatter `date` is present and parsable: a page without one is not a post, and an
|
|
13
|
+
* unparsable one must not crash `toISOString()`.
|
|
14
|
+
*
|
|
15
|
+
* @param {unknown} value
|
|
16
|
+
*/
|
|
17
|
+
export function hasValidDate(value) {
|
|
18
|
+
return !!value && !Number.isNaN(new Date(/** @type {string} */ (value)).getTime());
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* Whether a page is a post: a dated page under the blog directory, the index excluded.
|
|
23
|
+
*
|
|
24
|
+
* @param {string} dir The blog directory, as returned by `blogDir`.
|
|
25
|
+
* @param {string} path The page path relative to the source directory.
|
|
26
|
+
* @param {unknown} date The frontmatter `date`.
|
|
27
|
+
*/
|
|
28
|
+
export function isPostPath(dir, path, date) {
|
|
29
|
+
return path.startsWith(`${dir}/`) && path !== `${dir}/index.md` && hasValidDate(date);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* `author` is a key of `ff.blog.authors`, or a plain name used as is.
|
|
34
|
+
*
|
|
35
|
+
* @template {{ name?: string }} T
|
|
36
|
+
* @param {Record<string, T>} authors
|
|
37
|
+
* @param {string} [value]
|
|
38
|
+
* @returns {T | null}
|
|
39
|
+
*/
|
|
40
|
+
export function resolveAuthor(authors, value) {
|
|
41
|
+
return value ? authors[value] ?? {
|
|
42
|
+
name: value
|
|
43
|
+
} : null;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Text of the first `# heading` line of a Markdown body, if any.
|
|
48
|
+
*
|
|
49
|
+
* @param {string} body
|
|
50
|
+
*/
|
|
51
|
+
export function firstHeading(body) {
|
|
52
|
+
return /^#\s+(.+)$/m.exec(body)?.[1].trim();
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* The frontmatter `tags` when it is a list, else an empty list.
|
|
57
|
+
*
|
|
58
|
+
* @param {unknown} value
|
|
59
|
+
* @returns {unknown[]}
|
|
60
|
+
*/
|
|
61
|
+
export function toTags(value) {
|
|
62
|
+
return Array.isArray(value) ? value : [];
|
|
63
|
+
}
|
package/node/llms.js
CHANGED
|
@@ -1,17 +1,18 @@
|
|
|
1
1
|
import { mkdir, writeFile } from 'node:fs/promises';
|
|
2
2
|
import { join } from 'node:path';
|
|
3
|
-
import { hostnameOf
|
|
3
|
+
import { hostnameOf } from './pages.js';
|
|
4
4
|
|
|
5
5
|
/**
|
|
6
6
|
* Writes `llms.txt` (an index of the pages) and `llms-full.txt` (their Markdown, concatenated) to
|
|
7
7
|
* the output directory, following https://llmstxt.org. A page opts out with `llms: false`.
|
|
8
8
|
*
|
|
9
9
|
* @param {import('vitepress').SiteConfig} siteConfig
|
|
10
|
+
* @param {Awaited<ReturnType<typeof import('./pages.js').readPages>>} allPages Pages read once by the caller.
|
|
10
11
|
*/
|
|
11
|
-
export async function generateLlms(siteConfig) {
|
|
12
|
+
export async function generateLlms(siteConfig, allPages) {
|
|
12
13
|
const { title, description } = siteConfig.site;
|
|
13
14
|
const hostname = hostnameOf(siteConfig) ?? '';
|
|
14
|
-
const pages =
|
|
15
|
+
const pages = allPages.filter(({ data }) => data.llms !== 'false');
|
|
15
16
|
|
|
16
17
|
const index = pages.map(({ url, title: name, description: summary }) =>
|
|
17
18
|
`- [${name}](${hostname}${url})${summary ? `: ${summary}` : ''}`);
|
package/node/og.js
CHANGED
|
@@ -2,9 +2,7 @@ import {
|
|
|
2
2
|
mkdir, readFile, writeFile
|
|
3
3
|
} from 'node:fs/promises';
|
|
4
4
|
import { join, resolve } from 'node:path';
|
|
5
|
-
import {
|
|
6
|
-
ogOptions, ogSlug, readPages
|
|
7
|
-
} from './pages.js';
|
|
5
|
+
import { ogOptions, ogSlug } from './pages.js';
|
|
8
6
|
|
|
9
7
|
const WIDTH = 1200;
|
|
10
8
|
const HEIGHT = 630;
|
|
@@ -104,8 +102,9 @@ function card({ siteTitle, title, description, family }) {
|
|
|
104
102
|
* so parallelism would only add memory.
|
|
105
103
|
*
|
|
106
104
|
* @param {import('vitepress').SiteConfig} siteConfig
|
|
105
|
+
* @param {Awaited<ReturnType<typeof import('./pages.js').readPages>>} allPages Pages read once by the caller.
|
|
107
106
|
*/
|
|
108
|
-
export async function generateOg(siteConfig) {
|
|
107
|
+
export async function generateOg(siteConfig, allPages) {
|
|
109
108
|
const { fonts } = ogOptions(siteConfig);
|
|
110
109
|
let satori;
|
|
111
110
|
let Resvg;
|
|
@@ -135,7 +134,7 @@ export async function generateOg(siteConfig) {
|
|
|
135
134
|
recursive: true
|
|
136
135
|
});
|
|
137
136
|
|
|
138
|
-
for (const { page, data, title, description } of
|
|
137
|
+
for (const { page, data, title, description } of allPages) {
|
|
139
138
|
if (data.og === 'false') {
|
|
140
139
|
continue;
|
|
141
140
|
}
|
|
@@ -152,7 +151,7 @@ export async function generateOg(siteConfig) {
|
|
|
152
151
|
});
|
|
153
152
|
|
|
154
153
|
await writeFile(
|
|
155
|
-
join(dir, `${ogSlug(page)}.png`),
|
|
154
|
+
join(dir, `${ogSlug(siteConfig.rewrites?.map?.[page] ?? page)}.png`),
|
|
156
155
|
new Resvg(svg).render().asPng()
|
|
157
156
|
);
|
|
158
157
|
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export function resolveOption<T extends object>(value: boolean | T | undefined, optOut?: boolean): T | null;
|
package/node/options.js
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Reads an option written as `boolean | object`: `true` gives the empty object (every default), an
|
|
3
|
+
* object is kept as is, and `false`, a missing value or an opt-out gives `null`. Shared by the
|
|
4
|
+
* client and the build, so it stays free of Node imports.
|
|
5
|
+
*
|
|
6
|
+
* @template T
|
|
7
|
+
* @param {boolean | T | undefined} value The option as written in `themeConfig.ff`.
|
|
8
|
+
* @param {boolean} [optOut] A per-page opt-out, such as `feedback: false` in the frontmatter.
|
|
9
|
+
* @returns {T | null}
|
|
10
|
+
*/
|
|
11
|
+
export function resolveOption(value, optOut = false) {
|
|
12
|
+
if (!value || optOut) {
|
|
13
|
+
return null;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
return value === true ? /** @type {T} */ ({}) : /** @type {T} */ (value);
|
|
17
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { ThemeOptions } from '../src/types';
|
|
2
|
+
|
|
3
|
+
export type Network = 'x' | 'linkedin' | 'bluesky' | 'mastodon';
|
|
4
|
+
|
|
5
|
+
export const NETWORKS: readonly Network[];
|
|
6
|
+
|
|
7
|
+
export function resolvePageActions(ff?: ThemeOptions): {
|
|
8
|
+
markdown: boolean;
|
|
9
|
+
link: boolean;
|
|
10
|
+
share: Network[];
|
|
11
|
+
instance: string;
|
|
12
|
+
};
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Networks the page actions can share to, in menu order. Shared by the client and the build, so
|
|
3
|
+
* this file stays free of Node imports.
|
|
4
|
+
*/
|
|
5
|
+
export const NETWORKS = /** @type {const} */ ([
|
|
6
|
+
'x',
|
|
7
|
+
'linkedin',
|
|
8
|
+
'bluesky',
|
|
9
|
+
'mastodon'
|
|
10
|
+
]);
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* Reads the page actions intent from the `themeConfig.ff` options: `true` turns on everything, an
|
|
14
|
+
* object turns on its explicit flags, `false` nothing, and left unset only "Copy link" is on. The
|
|
15
|
+
* deprecated `copyMarkdown: true` still turns on the Markdown action. `markdown` is the config intent only: the client also needs
|
|
16
|
+
* the page's `ffMarkdown`.
|
|
17
|
+
*
|
|
18
|
+
* @param {import('../src/types.js').ThemeOptions} [ff] The `themeConfig.ff` options.
|
|
19
|
+
*/
|
|
20
|
+
export function resolvePageActions(ff) {
|
|
21
|
+
const all = ff?.pageActions === true;
|
|
22
|
+
const config = typeof ff?.pageActions === 'object' ? ff.pageActions : {};
|
|
23
|
+
|
|
24
|
+
return {
|
|
25
|
+
markdown: all || !!config.copyMarkdown || ff?.copyMarkdown === true,
|
|
26
|
+
link: all || ff?.pageActions === undefined || !!config.copyLink,
|
|
27
|
+
share: all ? [
|
|
28
|
+
...NETWORKS
|
|
29
|
+
] : [
|
|
30
|
+
...(config.share ?? [])
|
|
31
|
+
],
|
|
32
|
+
instance: config.mastodonInstance ?? 'mastodon.social'
|
|
33
|
+
};
|
|
34
|
+
}
|
package/node/pages.js
CHANGED
|
@@ -1,5 +1,8 @@
|
|
|
1
|
+
import { existsSync } from 'node:fs';
|
|
1
2
|
import { readFile } from 'node:fs/promises';
|
|
2
3
|
import { join } from 'node:path';
|
|
4
|
+
import { firstHeading } from './blog.js';
|
|
5
|
+
import { resolveOption } from './options.js';
|
|
3
6
|
|
|
4
7
|
const FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
|
|
5
8
|
|
|
@@ -85,6 +88,30 @@ export function hostnameOf(siteConfig, explicit) {
|
|
|
85
88
|
return hostname?.replace(/\/+$/, '');
|
|
86
89
|
}
|
|
87
90
|
|
|
91
|
+
/**
|
|
92
|
+
* Same as `hostnameOf`, but throws when there is none: a feed or an image URL must be absolute.
|
|
93
|
+
* `optionPath` names the option to set, such as `ff.og`.
|
|
94
|
+
*/
|
|
95
|
+
export function requireHostname(siteConfig, explicit, optionPath) {
|
|
96
|
+
const hostname = hostnameOf(siteConfig, explicit);
|
|
97
|
+
|
|
98
|
+
if (!hostname) {
|
|
99
|
+
throw new Error(`[vitepress-theme] \`${optionPath}\` needs an absolute address: set \`${optionPath}.hostname\` or \`sitemap.hostname\`.`);
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
return hostname;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* Whether a page has a source file on disk. Dynamic routes and generated pages do not.
|
|
107
|
+
*
|
|
108
|
+
* @param {import('vitepress').SiteConfig} siteConfig
|
|
109
|
+
* @param {string} page Path relative to `srcDir`.
|
|
110
|
+
*/
|
|
111
|
+
export function hasSource(siteConfig, page) {
|
|
112
|
+
return existsSync(join(siteConfig.srcDir, page));
|
|
113
|
+
}
|
|
114
|
+
|
|
88
115
|
/**
|
|
89
116
|
* Every Markdown page of the site, source read and frontmatter parsed. `404.md` is left out.
|
|
90
117
|
*
|
|
@@ -98,17 +125,14 @@ export async function readPages(siteConfig) {
|
|
|
98
125
|
continue;
|
|
99
126
|
}
|
|
100
127
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
try {
|
|
104
|
-
source = await readFile(join(siteConfig.srcDir, page), 'utf8');
|
|
105
|
-
} catch {
|
|
106
|
-
// Dynamic route or generated page: no source to read.
|
|
128
|
+
// Dynamic route or generated page: no source to read.
|
|
129
|
+
if (!hasSource(siteConfig, page)) {
|
|
107
130
|
continue;
|
|
108
131
|
}
|
|
109
132
|
|
|
133
|
+
const source = await readFile(join(siteConfig.srcDir, page), 'utf8');
|
|
110
134
|
const { data, body } = parseSource(source);
|
|
111
|
-
const heading =
|
|
135
|
+
const heading = firstHeading(body);
|
|
112
136
|
|
|
113
137
|
pages.push({
|
|
114
138
|
page,
|
|
@@ -136,19 +160,15 @@ export function ogSlug(page) {
|
|
|
136
160
|
*/
|
|
137
161
|
export function ogOptions(siteConfig) {
|
|
138
162
|
const og = siteConfig.site.themeConfig?.ff?.og;
|
|
139
|
-
const
|
|
140
|
-
const fonts =
|
|
163
|
+
const config = resolveOption(og) ?? {};
|
|
164
|
+
const fonts = config.fonts ?? [];
|
|
141
165
|
|
|
142
166
|
if (!fonts.length) {
|
|
143
167
|
throw new Error('[vitepress-theme] `ff.og` needs at least one font: set `ff.og.fonts` (TTF, OTF or WOFF files).');
|
|
144
168
|
}
|
|
145
169
|
|
|
146
|
-
if (!hostname) {
|
|
147
|
-
throw new Error('[vitepress-theme] `ff.og` needs an absolute address: set `ff.og.hostname` or `sitemap.hostname`.');
|
|
148
|
-
}
|
|
149
|
-
|
|
150
170
|
return {
|
|
151
171
|
fonts,
|
|
152
|
-
hostname
|
|
172
|
+
hostname: requireHostname(siteConfig, config.hostname, 'ff.og')
|
|
153
173
|
};
|
|
154
174
|
}
|