/* ==========================================================================
   Docs pages (hub, single article, category archive)
   Scoped to .docs-* classes only. Shared components (v-*) live in main.css.
   ========================================================================== */

/* --------------------------------------------------------------------------
   1. HERO (docs hub)
   -------------------------------------------------------------------------- */
.docs-hero{padding-bottom:72px;background:linear-gradient(180deg,var(--paper-tint) 0%,var(--paper) 78%)}
.docs-hero-aura{position:absolute;inset:0;pointer-events:none;
	background:
		radial-gradient(620px 300px at 16% -8%,rgba(124,92,255,.14),transparent 70%),
		radial-gradient(520px 280px at 86% -4%,rgba(124,92,255,.09),transparent 70%)}
.docs-hero .v-hero-note{margin-bottom:0}

/* search field */
.docs-search{position:relative;max-width:580px;margin:38px auto 0}
.docs-search>svg{position:absolute;left:20px;top:50%;transform:translateY(-50%);width:19px;height:19px;
	color:var(--faint);pointer-events:none}
.docs-search input{width:100%;margin:0;padding:17px 22px 17px 52px;border-radius:16px;
	border:1px solid var(--line-2);background:var(--paper);
	font-family:var(--body);font-size:16px;color:var(--ink);
	box-shadow:var(--shadow-sm);
	transition:border-color .16s,box-shadow .16s}
.docs-search input::placeholder{color:var(--faint)}
.docs-search input:focus{outline:none;border-color:var(--violet);
	box-shadow:0 0 0 4px var(--violet-tint),var(--shadow)}

/* --------------------------------------------------------------------------
   2. CATEGORY GRID (docs hub)
   -------------------------------------------------------------------------- */
.docs-cats{padding-top:80px}
.docs-cats .v-shead{margin-bottom:56px}

.docs-cat-card{display:flex;flex-direction:column}
.docs-cat-card h3{margin-bottom:7px}
.docs-cat-card h3 a{color:var(--ink);transition:color .15s}
.docs-cat-card h3 a:hover{color:var(--violet-d)}

.docs-card-links{list-style:none;margin:18px 0 4px;padding:16px 0 0;flex:1;
	border-top:1px solid var(--line);display:flex;flex-direction:column;gap:1px}
.docs-card-links li.docs-extra{display:none}
.docs-card-links li.docs-li-hide{display:none}
.docs-searching .docs-card-links li.docs-extra{display:block}
.docs-searching .docs-card-links li.docs-li-hide{display:none}
.docs-card-links a{display:flex;align-items:center;gap:9px;padding:7px 10px;margin:0 -10px;
	border-radius:9px;font-size:14px;font-weight:500;color:var(--text);
	transition:background .14s,color .14s}
.docs-card-links a:hover{background:var(--paper-soft);color:var(--violet-d)}
.docs-card-links svg{width:15px;height:15px;flex:none;color:var(--faint)}
.docs-card-links a:hover svg{color:var(--violet-d)}
.docs-card-all{margin-top:16px}

/* empty state (toggled by the inline search script) */
.docs-empty{text-align:center;padding:60px 24px;margin-top:8px;
	border:1px dashed var(--line-2);border-radius:var(--r-lg);background:var(--paper-soft)}
.docs-empty strong{color:var(--ink)}
.docs-empty p{color:var(--muted);margin:0}
.docs-empty p+p{margin-top:6px}
.docs-empty a{color:var(--violet-d);font-weight:600}

/* "more resources" strip */
.docs-cats-perf{margin:64px 0 0}
.docs-more{display:flex;align-items:center;justify-content:center;gap:16px 34px;flex-wrap:wrap;
	padding-top:36px}
.docs-more .v-mono{color:var(--faint)}

.docs-cta{padding-top:0}

/* --------------------------------------------------------------------------
   3. SHARED INNER-PAGE SCAFFOLD (single + taxonomy)
   -------------------------------------------------------------------------- */
.docs-wrap{padding:calc(var(--header-h) + 56px) 0 104px;background:var(--paper)}

.docs-crumb{display:flex;align-items:center;gap:10px;flex-wrap:wrap;
	font-family:var(--mono);font-size:12px;font-weight:500;letter-spacing:.1em;text-transform:uppercase;
	color:var(--faint);margin-bottom:44px}
.docs-crumb a{color:var(--muted);transition:color .14s}
.docs-crumb a:hover{color:var(--violet-d)}
.docs-crumb-sep{color:var(--line-2)}
.docs-crumb-cur{color:var(--ink)}

/* --------------------------------------------------------------------------
   4. SINGLE ARTICLE LAYOUT
   -------------------------------------------------------------------------- */
.docs-grid{display:grid;grid-template-columns:264px minmax(0,1fr);gap:72px;align-items:start}

/* sidebar */
.docs-side-inner{position:sticky;top:calc(var(--header-h) + 28px)}
.docs-side-cat{display:flex;align-items:center;gap:11px;
	padding-bottom:18px;margin-bottom:16px;border-bottom:1px solid var(--line)}
.docs-side-ic{width:36px;height:36px;flex:none;border-radius:10px;
	background:var(--violet-tint);color:var(--violet-d);display:grid;place-items:center}
.docs-side-ic svg{width:19px;height:19px}
.docs-side-cat-name{font-weight:600;font-size:15px;color:var(--ink);line-height:1.25}
.docs-side-count{margin-left:auto;font-family:var(--mono);font-size:10px;letter-spacing:.08em;
	text-transform:uppercase;color:var(--faint);white-space:nowrap}

.docs-side-list{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:1px}
.docs-side-list li a{position:relative;display:block;padding:8px 12px;border-radius:9px;
	font-size:14px;color:var(--text);transition:background .14s,color .14s}
.docs-side-list li a:hover{background:var(--paper-soft);color:var(--ink)}
.docs-side-list li.cur>a{background:var(--violet-tint);color:var(--violet-d);font-weight:600}
.docs-side-sub{list-style:none;margin:2px 0 4px 16px;padding-left:13px;border-left:1px solid var(--line)}
.docs-side-sub li a{font-size:13.5px}

.docs-side-help{margin-top:26px;padding:20px;border:1px solid var(--line);
	border-radius:var(--r);background:var(--paper-soft)}
.docs-side-help h4{font-size:15px;color:var(--ink);margin-bottom:6px}
.docs-side-help p{font-size:13.5px;color:var(--muted);margin-bottom:14px}
.docs-side-help .v-btn{width:100%}

/* article header + meta */
.docs-article{max-width:780px}
.docs-title{letter-spacing:-.028em}
.docs-meta{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin-top:16px;
	font-family:var(--mono);font-size:12px;letter-spacing:.08em;text-transform:uppercase;color:var(--faint)}
.docs-meta a{color:var(--violet-d);font-weight:600}
.docs-meta a:hover{color:var(--violet-dd)}
.docs-meta-sep{color:var(--line-2)}

/* "you're here because" intro box */
.docs-because{margin:36px 0 4px;padding:22px 24px;border:1px solid var(--line);
	border-left:3px solid var(--violet);border-radius:var(--r);background:var(--paper-tint)}
.docs-because-lbl{display:block;font-family:var(--mono);font-size:11px;font-weight:500;
	letter-spacing:.12em;text-transform:uppercase;color:var(--violet-d);margin-bottom:8px}
.docs-because p{margin:0;font-size:15.5px;color:var(--text)}

/* --------------------------------------------------------------------------
   5. PROSE (.docs-content)
   -------------------------------------------------------------------------- */
.docs-content{margin-top:34px;font-size:16.5px;line-height:1.75;color:var(--text)}
.docs-content p{margin:0 0 1.15em}
.docs-content strong{color:var(--ink);font-weight:600}
.docs-content h2{font-family:var(--display);font-size:27px;font-weight:700;letter-spacing:-.02em;
	color:var(--ink);margin:1.9em 0 .7em;padding-top:1.5em;border-top:1px solid var(--line)}
.docs-content h2:first-child{margin-top:0;padding-top:0;border-top:0}
.docs-content h3{font-family:var(--display);font-size:19px;font-weight:600;letter-spacing:-.015em;
	color:var(--ink);margin:1.8em 0 .55em}
.docs-content h4{font-size:16.5px;font-weight:600;color:var(--ink);margin:1.6em 0 .5em}

.docs-content ul,.docs-content ol{margin:0 0 1.3em}
.docs-content ul{list-style:none;padding-left:2px}
.docs-content ul li{position:relative;padding-left:26px}
.docs-content ul li::before{content:"";position:absolute;left:6px;top:.72em;width:6px;height:6px;
	border-radius:50%;background:var(--violet)}
.docs-content ol{padding-left:24px}
.docs-content ol li::marker{font-family:var(--mono);font-weight:600;font-size:.85em;color:var(--violet-d)}
.docs-content li{margin-bottom:.45em}
.docs-content li>ul,.docs-content li>ol{margin-top:.45em;margin-bottom:0}

.docs-content a{color:var(--violet-d);font-weight:500;
	text-decoration:underline;text-decoration-color:rgba(124,92,255,.35);text-underline-offset:3px;
	transition:color .14s,text-decoration-color .14s}
.docs-content a:hover{color:var(--violet-dd);text-decoration-color:var(--violet-dd)}

.docs-content code{font-family:var(--mono);font-size:.84em;color:var(--ink);
	background:var(--paper-soft);border:1px solid var(--line);border-radius:6px;padding:2px 7px}
.docs-content pre{margin:1.6em 0;padding:20px 22px;border-radius:var(--r);
	background:var(--ink-900);color:var(--d-text);overflow-x:auto}
.docs-content pre code{background:none;border:0;padding:0;color:inherit;font-size:13.5px}

.docs-content blockquote{margin:1.8em 0;padding:2px 0 2px 22px;border-left:3px solid var(--violet);
	color:var(--ink);font-size:1.04em}

.docs-content hr{border:0;height:1px;background:var(--line);margin:2.4em 0}

.docs-content img{max-width:100%;height:auto;border-radius:var(--r)}
.docs-content figure{margin:2em 0;border:1px solid var(--line);border-radius:var(--r-lg);
	overflow:hidden;background:var(--paper);box-shadow:var(--shadow-sm)}
.docs-content figure img{display:block;width:100%;border-radius:0}
.docs-content figcaption{padding:13px 18px;border-top:1px solid var(--line);
	background:var(--paper-soft);font-size:13.5px;color:var(--muted)}

.docs-content table{width:100%;border-collapse:collapse;margin:1.8em 0;font-size:15px}
.docs-content th{font-family:var(--mono);font-size:11px;letter-spacing:.1em;text-transform:uppercase;
	color:var(--muted);text-align:left;padding:10px 14px;border-bottom:1px solid var(--line-2)}
.docs-content td{padding:12px 14px;border-bottom:1px solid var(--line);vertical-align:top}

/* tip / note callout authored in the article bodies (inc/docs-data.php) */
.docs-content .v-doc-note{margin:1.8em 0;padding:18px 22px;border:1px solid var(--line);
	border-left:3px solid var(--violet);border-radius:var(--r);background:var(--paper-tint);
	font-size:15px;line-height:1.65;color:var(--text)}
.docs-content .v-doc-note strong{color:var(--ink)}

/* keep in-content anchors clear of the fixed header */
.docs-content [id]{scroll-margin-top:calc(var(--header-h) + 20px)}

/* --------------------------------------------------------------------------
   6. ARTICLE FOOTER BLOCKS (related, pager, helpful)
   -------------------------------------------------------------------------- */
.docs-related{margin-top:58px;padding-top:36px;border-top:1px solid var(--line)}
.docs-related .v-h3{margin-bottom:18px}
.docs-related ul{list-style:none;margin:0;padding:0;display:grid;gap:10px}
.docs-related a{display:flex;align-items:center;justify-content:space-between;gap:14px;
	padding:15px 20px;border:1px solid var(--line);border-radius:var(--r);
	font-weight:600;font-size:15px;color:var(--ink);
	transition:border-color .16s,background .16s,transform .16s}
.docs-related a:hover{border-color:var(--violet);background:var(--paper-soft);transform:translateY(-1px)}
.docs-related .v-arrow{color:var(--faint);flex:none;transition:transform .16s,color .16s}
.docs-related a:hover .v-arrow{transform:translateX(4px);color:var(--violet-d)}

.docs-pager{display:grid;grid-template-columns:1fr 1fr;gap:16px;margin-top:42px}
.docs-page-link{display:block;padding:20px 22px;border:1px solid var(--line);border-radius:var(--r-lg);
	background:var(--paper);transition:border-color .16s,box-shadow .16s,transform .16s}
.docs-page-link:hover{border-color:var(--violet);box-shadow:var(--shadow-sm);transform:translateY(-2px)}
.docs-page-link span{display:block;margin-bottom:8px;
	font-family:var(--mono);font-size:11px;letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.docs-page-link strong{display:flex;align-items:center;gap:9px;font-size:16px;color:var(--ink)}
.docs-page-link.next{text-align:right}
.docs-page-link.next strong{justify-content:flex-end}
.docs-page-link.next.solo{grid-column:2}
.docs-page-link .v-arrow{color:var(--violet-d);flex:none}

.docs-helpful{display:flex;align-items:center;justify-content:space-between;gap:12px 20px;flex-wrap:wrap;
	margin-top:42px;padding:20px 24px;border:1px dashed var(--line-2);border-radius:var(--r);
	font-size:14.5px;color:var(--muted)}
.docs-helpful a{display:inline-flex;align-items:center;gap:7px;
	color:var(--violet-d);font-weight:600;transition:color .14s}
.docs-helpful a:hover{color:var(--violet-dd)}
.docs-helpful .v-arrow{transition:transform .16s}
.docs-helpful a:hover .v-arrow{transform:translateX(3px)}

/* --------------------------------------------------------------------------
   7. TAXONOMY (category archive)
   -------------------------------------------------------------------------- */
.docs-tax-head{display:flex;gap:24px;align-items:flex-start}
.docs-tax-ic{width:64px;height:64px;flex:none;border-radius:16px;
	background:var(--violet-tint);color:var(--violet-d);display:grid;place-items:center}
.docs-tax-ic svg{width:30px;height:30px}
.docs-tax-head-txt .v-badge{margin-bottom:14px}
.docs-tax-blurb{margin-top:14px;max-width:620px}
.docs-tax-count{margin-top:16px;color:var(--faint)}
.docs-tax-perf{margin:44px 0 0}

.docs-cat-list{display:flex;flex-direction:column;gap:12px;margin-top:44px}
.docs-cat-item{display:flex;align-items:center;gap:18px;padding:20px 24px;
	border:1px solid var(--line);border-radius:var(--r-lg);background:var(--paper);
	transition:border-color .16s,box-shadow .16s,transform .16s}
.docs-cat-item:hover{border-color:var(--violet);box-shadow:var(--shadow);transform:translateY(-2px)}
.docs-cat-num{min-width:26px;font-family:var(--mono);font-size:12px;font-weight:500;
	letter-spacing:.08em;color:var(--faint)}
.docs-cat-ic{width:40px;height:40px;flex:none;border-radius:11px;
	background:var(--paper-soft);color:var(--violet-d);display:grid;place-items:center}
.docs-cat-ic svg{width:18px;height:18px}
.docs-cat-txt{flex:1;min-width:0;display:flex;flex-direction:column;gap:3px}
.docs-cat-txt strong{font-size:16.5px;font-weight:600;color:var(--ink);letter-spacing:-.01em}
.docs-cat-txt em{font-style:normal;font-size:13px;color:var(--muted)}
.docs-cat-item .v-arrow{color:var(--faint);flex:none;transition:transform .16s,color .16s}
.docs-cat-item:hover .v-arrow{transform:translateX(4px);color:var(--violet-d)}
.docs-cat-back{margin-top:40px}

/* --------------------------------------------------------------------------
   8. RESPONSIVE
   -------------------------------------------------------------------------- */
@media(max-width:1024px){
	.docs-cats .v-grid-3{grid-template-columns:repeat(2,1fr)}
	.docs-grid{grid-template-columns:1fr;gap:48px}
	.docs-side-inner{position:static}
	.docs-side-list{display:grid;grid-template-columns:1fr 1fr;gap:1px 10px}
	.docs-side-sub{margin-left:12px}
	.docs-side-help{max-width:420px}
	.docs-article{max-width:none}
}

@media(max-width:768px){
	.docs-hero{padding-bottom:56px}
	.docs-cats{padding-top:64px}
	.docs-wrap{padding:calc(var(--header-h) + 40px) 0 80px}
	.docs-crumb{margin-bottom:34px}
	.docs-grid{gap:40px}
	.docs-tax-head{gap:18px}
	.docs-tax-ic{width:52px;height:52px;border-radius:13px}
	.docs-tax-ic svg{width:24px;height:24px}
	.docs-cat-item{padding:17px 18px;gap:14px}
	.docs-pager{grid-template-columns:1fr}
	.docs-page-link.next.solo{grid-column:auto}
	.docs-page-link.next{text-align:left}
	.docs-page-link.next strong{justify-content:flex-start}
}

@media(max-width:520px){
	.docs-search{margin-top:30px}
	.docs-search input{font-size:15px;padding:15px 18px 15px 48px;border-radius:14px}
	.docs-search>svg{left:17px}
	.docs-side-list{grid-template-columns:1fr}
	.docs-cat-num{display:none}
	.docs-cat-ic{display:none}
	.docs-cat-item{gap:12px}
	.docs-helpful{flex-direction:column;align-items:flex-start}
	.docs-more{flex-direction:column;align-items:flex-start;gap:14px}
}

/* --------------------------------------------------------------------------
   9. REDUCED MOTION
   -------------------------------------------------------------------------- */
@media(prefers-reduced-motion:reduce){
	.docs-cat-item:hover,.docs-page-link:hover,.docs-related a:hover{transform:none}
	.docs-cat-item:hover .v-arrow,.docs-related a:hover .v-arrow,
	.docs-helpful a:hover .v-arrow{transform:none}
}