/**
 * Fillvox Docs — front-end styles
 *
 * Self-contained — no Tailwind dependency. Uses CSS custom properties so
 * themes can override the brand color, fonts, and surface colors via
 * `:root { --fvd-brand: #...; }` or `.fillvox-docs { --fvd-brand: #...; }`.
 *
 * Layout matches docs.html: sticky sidebar (260px) + scrolling article.
 */

.fillvox-docs {
	--fvd-brand:        #2563eb;
	--fvd-brand-hover:  #1d4ed8;
	--fvd-brand-bg:     #eff6ff;
	--fvd-text:         #0f172a;
	--fvd-text-muted:   #475569;
	--fvd-text-soft:    #64748b;
	--fvd-border:       #e2e8f0;
	--fvd-bg:           #ffffff;
	--fvd-bg-soft:      #f8fafc;
	--fvd-bg-code:      #0f172a;
	--fvd-bg-code-text: #e2e8f0;
	--fvd-radius:       12px;
	--fvd-font:         'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
	--fvd-font-mono:    ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
	font-family:        var( --fvd-font );
	color:              var( --fvd-text );
	line-height:        1.6;
}

.fillvox-docs__container {
	max-width: 1200px;
	margin: 0 auto;
	padding: 3rem 1.25rem 4rem;
}
.fillvox-docs__grid {
	display: grid;
	grid-template-columns: 260px 1fr;
	gap: 3rem;
}

/* ---- Sidebar ---- */
.fillvox-docs__sidebar { min-width: 0; }
.fillvox-docs__sidebar-inner {
	position: sticky;
	top: 6rem;
}

.fillvox-docs__menu { font-size: 0.9375rem; }
.fillvox-docs__menu-empty {
	color: var( --fvd-text-soft );
	font-size: 0.875rem;
	line-height: 1.6;
}

.fillvox-docs__menu-group + .fillvox-docs__menu-group {
	margin-top: 1.5rem;
}

.fillvox-docs__menu-label {
	display: block;
	font-weight: 700;
	font-size: 0.75rem;
	letter-spacing: 0.12em;
	text-transform: uppercase;
	color: var( --fvd-text );
	margin-bottom: 0.5rem;
	padding: 0.25rem 0.75rem;
	text-decoration: none;
	transition: color 0.15s ease;
}
.fillvox-docs__menu-label:hover { color: var( --fvd-brand ); }

.fillvox-docs__menu-children {
	display: flex;
	flex-direction: column;
	gap: 0.125rem;
}
.fillvox-docs__menu-child,
.fillvox-docs__menu-bare {
	display: block;
	padding: 0.375rem 0.75rem;
	border-radius: 6px;
	color: var( --fvd-text-muted );
	text-decoration: none;
	transition: background 0.15s ease, color 0.15s ease;
	font-size: 0.9375rem;
}
.fillvox-docs__menu-bare {
	font-weight: 600;
	color: var( --fvd-text );
	margin-bottom: 0.25rem;
}
.fillvox-docs__menu-child:hover,
.fillvox-docs__menu-bare:hover {
	background: var( --fvd-bg-soft );
	color: var( --fvd-text );
}
.fillvox-docs__menu-child.is-active,
.fillvox-docs__menu-bare.is-active {
	background: var( --fvd-brand-bg );
	color: var( --fvd-brand );
	font-weight: 600;
}
.fillvox-docs__menu-bottom {
	margin-top: 2rem;
	padding-top: 1rem;
	border-top: 1px solid var( --fvd-border );
}
.fillvox-docs__menu-back {
	display: inline-block;
	color: var( --fvd-text-soft );
	text-decoration: none;
	font-size: 0.875rem;
	font-weight: 500;
}
.fillvox-docs__menu-back:hover { color: var( --fvd-brand ); }

/* ---- Content ---- */
.fillvox-docs__content { min-width: 0; }
.fillvox-docs__eyebrow {
	display: inline-block;
	color: var( --fvd-brand );
	font-weight: 700;
	font-size: 0.75rem;
	letter-spacing: 0.12em;
	text-transform: uppercase;
}
.fillvox-docs__title {
	font-size: 2.25rem;
	font-weight: 800;
	letter-spacing: -0.02em;
	color: var( --fvd-text );
	line-height: 1.15;
	margin: 0.5rem 0 2rem;
}

.fillvox-docs__h { scroll-margin-top: 6rem; }

.fillvox-docs__content h2 {
	font-size: 1.875rem;
	font-weight: 800;
	color: var( --fvd-text );
	letter-spacing: -0.02em;
	margin: 3rem 0 1rem;
	line-height: 1.2;
}
.fillvox-docs__content h3 {
	font-size: 1.375rem;
	font-weight: 700;
	color: var( --fvd-text );
	margin: 2rem 0 0.75rem;
	line-height: 1.3;
}
.fillvox-docs__content h4 {
	font-size: 1.125rem;
	font-weight: 700;
	color: var( --fvd-text );
	margin: 1.5rem 0 0.5rem;
}
.fillvox-docs__content p,
.fillvox-docs__content li {
	color: var( --fvd-text-muted );
	line-height: 1.7;
}
.fillvox-docs__content > p:first-of-type {
	font-size: 1.125rem;
}
.fillvox-docs__content ul,
.fillvox-docs__content ol { padding-left: 1.5rem; margin: 1rem 0; }
.fillvox-docs__content li { margin-top: 0.5rem; }
.fillvox-docs__content a {
	color: var( --fvd-brand );
	text-decoration: none;
	border-bottom: 1px solid rgba( 37, 99, 235, 0.3 );
	transition: border-color 0.15s ease;
}
.fillvox-docs__content a:hover { border-bottom-color: var( --fvd-brand ); }
.fillvox-docs__content strong { color: var( --fvd-text ); }
.fillvox-docs__content blockquote {
	border-left: 4px solid var( --fvd-border );
	padding: 0.25rem 0 0.25rem 1rem;
	margin: 1.5rem 0;
	color: var( --fvd-text-muted );
	font-style: italic;
}

/* Code blocks */
.fillvox-docs__content code {
	font-family: var( --fvd-font-mono );
	background: #f1f5f9;
	padding: 0.15em 0.4em;
	border-radius: 4px;
	font-size: 0.875em;
	color: var( --fvd-text );
	border: 1px solid var( --fvd-border );
}
.fillvox-docs__content pre {
	background: var( --fvd-bg-code );
	color: var( --fvd-bg-code-text );
	padding: 1.25rem;
	border-radius: var( --fvd-radius );
	overflow-x: auto;
	font-size: 0.875rem;
	line-height: 1.6;
	margin: 1.5rem 0;
}
.fillvox-docs__content pre code {
	background: transparent;
	padding: 0;
	border: 0;
	color: inherit;
}

/* Images */
.fillvox-docs__content img {
	max-width: 100%;
	height: auto;
	border-radius: var( --fvd-radius );
	margin: 1.5rem 0;
}
.fillvox-docs__content figure { margin: 1.5rem 0; }
.fillvox-docs__content figcaption {
	color: var( --fvd-text-soft );
	font-size: 0.875rem;
	text-align: center;
	margin-top: 0.5rem;
}

/* Tables */
.fillvox-docs__content table {
	width: 100%;
	border-collapse: collapse;
	margin: 1.5rem 0;
	font-size: 0.9375rem;
}
.fillvox-docs__content th,
.fillvox-docs__content td {
	padding: 0.625rem 1rem;
	text-align: left;
	border-bottom: 1px solid var( --fvd-border );
}
.fillvox-docs__content th {
	background: var( --fvd-bg-soft );
	font-weight: 600;
	color: var( --fvd-text );
}

/* ---- Callout blocks ---- */
.fillvox-docs__callout {
	display: flex;
	gap: 0.875rem;
	padding: 1rem 1.25rem;
	border-radius: var( --fvd-radius );
	margin: 1.5rem 0;
	border-left: 4px solid;
}
.fillvox-docs__callout-icon { font-size: 1.25rem; line-height: 1.2; }
.fillvox-docs__callout-body { flex: 1; }
.fillvox-docs__callout-body p { margin: 0; color: var( --fvd-text ); }
.fillvox-docs__callout-body p + p { margin-top: 0.5rem; }
.fillvox-docs__callout-label { color: var( --fvd-text ); margin-right: 0.25rem; }

.fillvox-docs__callout.is-tip     { background: #eff6ff; border-color: #2563eb; }
.fillvox-docs__callout.is-warning { background: #fffbeb; border-color: #d97706; }
.fillvox-docs__callout.is-note    { background: #f8fafc; border-color: #64748b; }
.fillvox-docs__callout.is-success { background: #ecfdf5; border-color: #059669; }

/* ---- Help card ---- */
.fillvox-docs__help-card {
	background: var( --fvd-bg-soft );
	border: 1px solid var( --fvd-border );
	border-radius: var( --fvd-radius );
	padding: 1.5rem;
	margin-top: 3rem;
	display: flex;
	align-items: center;
	justify-content: space-between;
	gap: 1.5rem;
	flex-wrap: wrap;
}
.fillvox-docs__help-card-title {
	font-weight: 700;
	color: var( --fvd-text );
	margin: 0 0 0.25rem;
	font-size: 1.0625rem;
}
.fillvox-docs__help-card-message {
	color: var( --fvd-text-muted );
	font-size: 0.9375rem;
	margin: 0;
}
.fillvox-docs__help-card-btn {
	background: var( --fvd-brand );
	color: white;
	padding: 0.625rem 1.25rem;
	border-radius: 999px;
	font-weight: 600;
	font-size: 0.875rem;
	text-decoration: none;
	transition: background 0.15s ease;
	white-space: nowrap;
}
.fillvox-docs__help-card-btn:hover {
	background: var( --fvd-brand-hover );
	color: white;
}

/* ---- Archive cards ---- */
.fillvox-docs__lead {
	font-size: 1.125rem;
	color: var( --fvd-text-muted );
	margin: 0 0 2rem;
	line-height: 1.6;
}
.fillvox-docs__cards {
	display: grid;
	grid-template-columns: repeat( auto-fit, minmax( 240px, 1fr ) );
	gap: 1.5rem;
	margin-top: 2rem;
}
.fillvox-docs__card {
	background: var( --fvd-bg );
	border: 1px solid var( --fvd-border );
	border-radius: var( --fvd-radius );
	padding: 1.5rem;
}
.fillvox-docs__card-title {
	font-size: 1rem;
	font-weight: 700;
	color: var( --fvd-text );
	margin: 0 0 1rem;
	letter-spacing: 0.02em;
}
.fillvox-docs__card-list {
	list-style: none;
	padding: 0;
	margin: 0;
}
.fillvox-docs__card-list li { margin: 0.375rem 0; }
.fillvox-docs__card-list a {
	color: var( --fvd-text-muted );
	text-decoration: none;
	font-size: 0.9375rem;
}
.fillvox-docs__card-list a:hover { color: var( --fvd-brand ); }

.fillvox-docs__empty {
	background: var( --fvd-bg-soft );
	border: 1px solid var( --fvd-border );
	border-radius: var( --fvd-radius );
	padding: 2rem;
	text-align: center;
	color: var( --fvd-text-muted );
}

/* ---- Mobile ---- */
@media ( max-width: 1023px ) {
	.fillvox-docs__grid { grid-template-columns: 1fr; gap: 1.5rem; }
	.fillvox-docs__sidebar-inner { position: static; }
	.fillvox-docs__sidebar {
		border-bottom: 1px solid var( --fvd-border );
		padding-bottom: 1.5rem;
	}
	.fillvox-docs__title { font-size: 1.875rem; }
	.fillvox-docs__content h2 { font-size: 1.5rem; }
}