/*
Theme Name: DocsPress
Theme URI: https://example.com/docspress
Author: Custom Documentation Theme
Author URI: https://example.com
Description: A customizable WordPress theme for documentation websites. Features a white background with dark text (plus full dark/light mode toggle), a thin top header with light/dark logos and navigation links, a hierarchical category and subpage tree sidebar on the left, customizable color schemes, accent color, element roundness, shadow intensity, custom font uploads, per-page layout modes (standard, header & footer only, or blank), per-page title and breadcrumb toggles, canonical URLs, full meta tags, and Google Schema (JSON-LD).
Version: 1.1.0
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: docspress
Tags: documentation, knowledge-base, two-columns, left-sidebar, custom-colors, custom-logo, custom-menu, footer-widgets
*/

/* ==========================================================================
   1. Custom Properties, Color Scheme & Modern Reset
   ========================================================================== */

:root {
	/* Opt-in globally for intrinsic keyword transitions (animate-to-intrinsic-sizes) */
	interpolate-size: allow-keywords;

	/* Base light & dark token definitions (overridable via Customizer) */
	--docs-bg-light: #ffffff;
	--docs-bg-subtle-light: #f8fafc;
	--docs-bg-hover-light: #f1f5f9;
	--docs-bg-active-light: #eff6ff;
	--docs-text-light: #0f172a;
	--docs-text-secondary-light: #334155;
	--docs-text-muted-light: #64748b;
	--docs-border-light: #e2e8f0;
	--docs-accent-light: #2563eb;
	--docs-accent-hover-light: #1d4ed8;

	--docs-bg-dark: #0b0f19;
	--docs-bg-subtle-dark: #111827;
	--docs-bg-hover-dark: #1e293b;
	--docs-bg-active-dark: #1e3a8a;
	--docs-text-dark: #f1f5f9;
	--docs-text-secondary-dark: #cbd5e1;
	--docs-text-muted-dark: #94a3b8;
	--docs-border-dark: #1e293b;
	--docs-accent-dark: #60a5fa;
	--docs-accent-hover-dark: #93c5fd;

	/* Active tokens (defaulting to light with prefers-color-scheme & light-dark() progression) */
	--docs-bg: var(--docs-bg-light);
	--docs-bg-subtle: var(--docs-bg-subtle-light);
	--docs-bg-hover: var(--docs-bg-hover-light);
	--docs-bg-active: var(--docs-bg-active-light);
	--docs-text: var(--docs-text-light);
	--docs-text-secondary: var(--docs-text-secondary-light);
	--docs-text-muted: var(--docs-text-muted-light);
	--docs-border: var(--docs-border-light);
	--docs-accent: var(--docs-accent-light);
	--docs-accent-hover: var(--docs-accent-hover-light);
	--docs-header-glass: rgba(255, 255, 255, 0.92);

	/* Dark Footer Palette (remains dark in both light & dark modes) */
	--docs-footer-bg: #0f172a;
	--docs-footer-bottom-bg: #090e1a;
	--docs-footer-text: #e2e8f0;
	--docs-footer-muted: #94a3b8;
	--docs-footer-border: #1e293b;

	/* Customizable Roundness Tokens (none, small, medium, large, pill) */
	--docs-radius-sm: 0.25rem;
	--docs-radius-md: 0.375rem;
	--docs-radius-lg: 0.5rem;
	--docs-radius-btn: 0.375rem;

	/* Customizable Shadow Tokens (small, medium, large, very-large) */
	--docs-shadow: 0 1px 2px 0 rgba(15, 23, 42, 0.05);
	--docs-shadow-hover: 0 4px 10px -1px rgba(15, 23, 42, 0.08);

	/* Layout Dimensions */
	--docs-header-height: 3.5rem;
	--docs-sidebar-width: 18rem;
	--docs-max-width: 90rem;
	--docs-content-max-width: 52rem;

	/* Typography */
	--docs-font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen-Sans, Ubuntu, Cantarell, "Helvetica Neue", sans-serif;
	--docs-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;

	/* MANDATORY: Automatically adapt native UI to user system preferences */
	color-scheme: light dark;
	--color-scheme: light;

	@media (prefers-color-scheme: dark) {
		--color-scheme: dark;
		--docs-bg: var(--docs-bg-dark);
		--docs-bg-subtle: var(--docs-bg-subtle-dark);
		--docs-bg-hover: var(--docs-bg-hover-dark);
		--docs-bg-active: var(--docs-bg-active-dark);
		--docs-text: var(--docs-text-dark);
		--docs-text-secondary: var(--docs-text-secondary-dark);
		--docs-text-muted: var(--docs-text-muted-dark);
		--docs-border: var(--docs-border-dark);
		--docs-accent: var(--docs-accent-dark);
		--docs-accent-hover: var(--docs-accent-hover-dark);
		--docs-header-glass: rgba(11, 15, 25, 0.92);
	}

	&:has(> head > meta[name="color-scheme"][content="dark"]) {
		color-scheme: dark;
		--color-scheme: dark;
		--docs-bg: var(--docs-bg-dark);
		--docs-bg-subtle: var(--docs-bg-subtle-dark);
		--docs-bg-hover: var(--docs-bg-hover-dark);
		--docs-bg-active: var(--docs-bg-active-dark);
		--docs-text: var(--docs-text-dark);
		--docs-text-secondary: var(--docs-text-secondary-dark);
		--docs-text-muted: var(--docs-text-muted-dark);
		--docs-border: var(--docs-border-dark);
		--docs-accent: var(--docs-accent-dark);
		--docs-accent-hover: var(--docs-accent-hover-dark);
		--docs-header-glass: rgba(11, 15, 25, 0.92);
	}

	&:has(> head > meta[name="color-scheme"][content="light"]) {
		color-scheme: light;
		--color-scheme: light;
		--docs-bg: var(--docs-bg-light);
		--docs-bg-subtle: var(--docs-bg-subtle-light);
		--docs-bg-hover: var(--docs-bg-hover-light);
		--docs-bg-active: var(--docs-bg-active-light);
		--docs-text: var(--docs-text-light);
		--docs-text-secondary: var(--docs-text-secondary-light);
		--docs-text-muted: var(--docs-text-muted-light);
		--docs-border: var(--docs-border-light);
		--docs-accent: var(--docs-accent-light);
		--docs-accent-hover: var(--docs-accent-hover-light);
		--docs-header-glass: rgba(255, 255, 255, 0.92);
	}

	@supports (color: light-dark(white, black)) {
		--docs-bg: light-dark(var(--docs-bg-light), var(--docs-bg-dark));
		--docs-bg-subtle: light-dark(var(--docs-bg-subtle-light), var(--docs-bg-subtle-dark));
		--docs-bg-hover: light-dark(var(--docs-bg-hover-light), var(--docs-bg-hover-dark));
		--docs-bg-active: light-dark(var(--docs-bg-active-light), var(--docs-bg-active-dark));
		--docs-text: light-dark(var(--docs-text-light), var(--docs-text-dark));
		--docs-text-secondary: light-dark(var(--docs-text-secondary-light), var(--docs-text-secondary-dark));
		--docs-text-muted: light-dark(var(--docs-text-muted-light), var(--docs-text-muted-dark));
		--docs-border: light-dark(var(--docs-border-light), var(--docs-border-dark));
		--docs-accent: light-dark(var(--docs-accent-light), var(--docs-accent-dark));
		--docs-accent-hover: light-dark(var(--docs-accent-hover-light), var(--docs-accent-hover-dark));
		--docs-header-glass: light-dark(rgba(255, 255, 255, 0.92), rgba(11, 15, 25, 0.92));
	}

	accent-color: var(--docs-accent);
}

/* Non-color visibility branching for light/dark logos and toggle icons */
.if-dark {
	display: none;
}

@media (prefers-color-scheme: dark) {
	:root:not(:has(> head > meta[name="color-scheme"][content="light"])) .if-dark {
		display: inline-flex;
	}
	:root:not(:has(> head > meta[name="color-scheme"][content="light"])) .if-light {
		display: none;
	}
}

:root:has(> head > meta[name="color-scheme"][content="dark"]) .if-dark {
	display: inline-flex;
}

:root:has(> head > meta[name="color-scheme"][content="dark"]) .if-light {
	display: none;
}

@container not style(--color-scheme: dark) {
	.if-dark {
		display: none !important;
	}
}

@container not style(--color-scheme: light) {
	.if-light {
		display: none !important;
	}
}

*,
*::before,
*::after {
	box-sizing: border-box;
}

html {
	font-family: var(--docs-font-sans);
	font-size: 16px;
	line-height: 1.6;
	color: var(--docs-text);
	background-color: var(--docs-bg);
	scroll-behavior: smooth;
}

body {
	margin: 0;
	background-color: var(--docs-bg);
	color: var(--docs-text);
	min-block-size: 100dvh;
	display: grid;
	grid-template-rows: var(--docs-header-height) 1fr auto;
	grid-template-columns: minmax(0, 1fr);
	grid-template-areas:
		"header"
		"workspace"
		"footer";
}

/* Totally Blank Page Layout Mode */
body.docspress-layout-blank {
	grid-template-rows: 1fr;
	grid-template-areas: "workspace";
}

/* Replaced elements display block to prevent inline baseline gaps */
img,
svg,
video,
canvas {
	display: block;
	max-inline-size: 100%;
	block-size: auto;
}

/* Screen Reader Utility */
.screen-reader-text {
	border: 0;
	clip: rect(1px, 1px, 1px, 1px);
	clip-path: inset(50%);
	block-size: 1px;
	inline-size: 1px;
	margin: -1px;
	overflow: hidden;
	padding: 0;
	position: absolute;
	word-wrap: normal !important;
}

/* Inactive / Inert state styling */
[inert],
[inert] * {
	opacity: 0.5;
	cursor: default;
	user-select: none;
}

/* Accessibility Skip Link */
.skip-link {
	position: absolute;
	inset-block-start: -100%;
	inset-inline-start: 1rem;
	z-index: 1000;
	padding-block: 0.5rem;
	padding-inline: 1rem;
	background-color: var(--docs-accent);
	color: #ffffff;
	font-weight: 600;
	text-decoration: none;
	border-radius: 0 0 var(--docs-radius-md) var(--docs-radius-md);
}

.skip-link:focus {
	inset-block-start: 0;
}

/* ==========================================================================
   2. Thin Top Header & Dark/Light Mode Toggle
   ========================================================================== */

.site-header {
	grid-area: header;
	position: sticky;
	inset-block-start: 0;
	z-index: 100;
	block-size: var(--docs-header-height);
	background-color: var(--docs-header-glass);
	backdrop-filter: blur(8px);
	border-block-end: 1px solid var(--docs-border);
}

.header-inner {
	max-inline-size: var(--docs-max-width);
	block-size: 100%;
	margin-inline: auto;
	padding-inline: 1.5rem;
	display: flex;
	align-items: safe center;
	gap: 1.5rem;
}

.site-branding {
	display: flex;
	align-items: safe center;
	gap: 0.75rem;
	min-inline-size: 0;
}

.site-brand-link {
	display: inline-flex;
	align-items: safe center;
	gap: 0.625rem;
	font-size: 1.0625rem;
	font-weight: 700;
	color: var(--docs-text);
	text-decoration: none;
	letter-spacing: -0.015em;
	white-space: nowrap;
}

.site-brand-link:hover,
.site-brand-link:focus-visible {
	color: var(--docs-accent);
}

.site-logo {
	max-block-size: 2rem;
	inline-size: auto;
	object-fit: contain;
}

.site-logo-footer {
	max-block-size: 2.25rem;
}

.site-brand-icon {
	inline-size: 1.375rem;
	block-size: 1.375rem;
	color: var(--docs-accent);
	flex-shrink: 0;
}

.header-page-indicator {
	font-size: 0.875rem;
	color: var(--docs-text-muted);
	padding-inline-start: 0.75rem;
	border-inline-start: 1px solid var(--docs-border);
	white-space: nowrap;
	overflow: clip;
	text-overflow: ellipsis;
}

/* Header Right Actions (Nav + Theme Toggle) */
.header-actions {
	margin-inline-start: auto;
	display: flex;
	align-items: safe center;
	gap: 1.25rem;
}

.top-nav-list {
	list-style: none;
	margin: 0;
	padding: 0;
	display: flex;
	flex-wrap: wrap;
	flex-wrap: balance;
	align-items: safe center;
	gap: 1.5rem;
}

.top-nav-list a {
	font-size: 0.875rem;
	font-weight: 500;
	color: var(--docs-text-secondary);
	text-decoration: none;
	padding-block: 0.25rem;
	transition: color 0.15s ease;
}

.top-nav-list a:hover,
.top-nav-list a:focus-visible,
.top-nav-list .current-menu-item > a {
	color: var(--docs-accent);
}

/* Dark / Light Mode Toggle Button */
.theme-mode-toggle {
	display: inline-flex;
	align-items: safe center;
	justify-content: center;
	inline-size: 2.125rem;
	block-size: 2.125rem;
	padding: 0;
	background-color: var(--docs-bg-subtle);
	border: 1px solid var(--docs-border);
	border-radius: var(--docs-radius-btn);
	box-shadow: var(--docs-shadow);
	color: var(--docs-text-secondary);
	cursor: pointer;
	transition: background-color 0.15s ease, color 0.15s ease, border-color 0.15s ease, box-shadow 0.15s ease;
}

.theme-mode-toggle:hover,
.theme-mode-toggle:focus-visible {
	background-color: var(--docs-bg-hover);
	color: var(--docs-accent);
	border-color: var(--docs-accent);
	box-shadow: var(--docs-shadow-hover);
}

.theme-toggle-option {
	display: inline-flex;
	align-items: safe center;
	justify-content: center;
}

/* Mobile Sidebar Toggle Button */
.mobile-nav-toggle {
	display: none;
	align-items: safe center;
	justify-content: center;
	inline-size: 2.25rem;
	block-size: 2.25rem;
	padding: 0;
	background-color: var(--docs-bg-subtle);
	border: 1px solid var(--docs-border);
	border-radius: var(--docs-radius-btn);
	box-shadow: var(--docs-shadow);
	color: var(--docs-text);
	cursor: pointer;
}

.mobile-nav-toggle:hover,
.mobile-nav-toggle:focus-visible {
	background-color: var(--docs-bg-hover);
	border-color: var(--docs-text-muted);
}

/* ==========================================================================
   3. Main Workspace Layout (Standard, Header & Footer Only, Blank)
   ========================================================================== */

.docs-workspace {
	grid-area: workspace;
	max-inline-size: var(--docs-max-width);
	inline-size: 100%;
	margin-inline: auto;
	display: grid;
	grid-template-columns: var(--docs-sidebar-width) minmax(0, 1fr);
	grid-template-areas: "sidebar main";
	align-items: start;
}

/* Header & Footer Only OR Blank Page Layout (No Sidebar) */
body.docspress-layout-header-footer .docs-workspace,
body.docspress-layout-blank .docs-workspace {
	grid-template-columns: minmax(0, 1fr);
	grid-template-areas: "main";
}

body.docspress-layout-header-footer .docs-article,
body.docspress-layout-blank .docs-article {
	max-inline-size: 64rem;
	margin-inline: auto;
}

/* ==========================================================================
   4. Left Documentation Sidebar (Categories & Subpage Tree)
   ========================================================================== */

.docs-sidebar {
	grid-area: sidebar;
	position: sticky;
	inset-block-start: var(--docs-header-height);
	block-size: calc(100dvh - var(--docs-header-height));
	overflow-y: auto;
	scrollbar-gutter: stable;
	overscroll-behavior: contain;
	border-inline-end: 1px solid var(--docs-border);
	background-color: var(--docs-bg-subtle);
	padding-block: 1.25rem 2.5rem;
	padding-inline: 1rem;
}

/* Sidebar Search Landmark */
.sidebar-search {
	margin-block-end: 1.25rem;
}

.sidebar-search-form {
	position: relative;
	display: flex;
	align-items: safe center;
}

.sidebar-search-input {
	inline-size: 100%;
	padding-block: 0.45rem;
	padding-inline: 2rem 0.75rem;
	font-size: 0.875rem;
	font-family: inherit;
	color: var(--docs-text);
	background-color: var(--docs-bg);
	border: 1px solid var(--docs-border);
	border-radius: var(--docs-radius-btn);
	box-shadow: var(--docs-shadow);
	transition: border-color 0.15s ease, box-shadow 0.15s ease;
}

.sidebar-search-input:focus {
	outline: none;
	border-color: var(--docs-accent);
	box-shadow: 0 0 0 3px rgba(37, 99, 235, 0.2);
}

.sidebar-search-icon {
	position: absolute;
	inset-inline-start: 0.625rem;
	inline-size: 0.95rem;
	block-size: 0.95rem;
	color: var(--docs-text-muted);
	pointer-events: none;
}

/* Tree Navigation Structure */
.docs-tree-nav {
	font-size: 0.875rem;
}

.docs-category-group {
	margin-block-end: 0.75rem;
}

.docs-category-details {
	border-radius: var(--docs-radius-md);
}

.docs-category-summary {
	list-style: none;
	display: flex;
	align-items: safe center;
	justify-content: space-between;
	gap: 0.5rem;
	padding-block: 0.4rem;
	padding-inline: 0.5rem;
	font-size: 0.75rem;
	font-weight: 700;
	text-transform: uppercase;
	letter-spacing: 0.05em;
	color: var(--docs-text-secondary);
	cursor: pointer;
	border-radius: var(--docs-radius-md);
	user-select: none;
	transition: background-color 0.15s ease, color 0.15s ease;
}

.docs-category-summary::-webkit-details-marker {
	display: none;
}

/* Explicit directional cue via ::after since native marker is hidden */
.docs-category-summary::after {
	content: "";
	inline-size: 0.45rem;
	block-size: 0.45rem;
	border-inline-end: 1.75px solid currentColor;
	border-block-end: 1.75px solid currentColor;
	transform: rotate(-45deg);
	transition: transform 0.2s ease;
	flex-shrink: 0;
}

.docs-category-details[open] > .docs-category-summary::after {
	transform: rotate(45deg);
}

.docs-category-summary:hover,
.docs-category-summary:focus-visible {
	background-color: var(--docs-bg-hover);
	color: var(--docs-text);
}

/* Smooth intrinsic height transition for details content where supported */
.docs-category-details::details-content {
	block-size: 0;
	overflow: clip;
	transition: block-size 0.25s ease-out, content-visibility 0.25s ease-out allow-discrete;
}

.docs-category-details[open]::details-content {
	block-size: auto;
}

/* Tree Lists & Nested Subpage Branches */
.docs-tree-list,
.docs-tree-list ul.children,
.docs-tree-list ul.sub-menu {
	list-style: none;
	margin: 0;
	padding: 0;
}

.docs-tree-list {
	margin-block-start: 0.25rem;
	padding-inline-start: 0.5rem;
}

/* Nested subpage tree connector lines */
.docs-tree-list ul.children,
.docs-tree-list ul.sub-menu,
.docs-subpage-tree {
	list-style: none;
	margin-block: 0.125rem;
	margin-inline-start: 0.625rem;
	padding-inline-start: 0.75rem;
	border-inline-start: 1px solid var(--docs-border);
}

.docs-tree-item,
.docs-tree-list li {
	margin-block: 0.125rem;
}

.docs-tree-link,
.docs-tree-list a {
	display: flex;
	align-items: safe center;
	justify-content: space-between;
	gap: 0.5rem;
	padding-block: 0.375rem;
	padding-inline: 0.625rem;
	border-radius: var(--docs-radius-md);
	color: var(--docs-text-secondary);
	text-decoration: none;
	line-height: 1.35;
	transition: background-color 0.15s ease, color 0.15s ease;
}

.docs-tree-link:hover,
.docs-tree-link:focus-visible,
.docs-tree-list a:hover,
.docs-tree-list a:focus-visible {
	background-color: var(--docs-bg-hover);
	color: var(--docs-text);
}

.docs-tree-item.is-active > .docs-tree-link,
.docs-tree-item.is-active > .docs-branch-row > .docs-tree-link,
.docs-tree-list .current_page_item > a,
.docs-tree-list .current-menu-item > a {
	background-color: var(--docs-bg-active);
	color: var(--docs-accent);
	font-weight: 600;
}

/* Collapsible subpage branch toggle inside a category */
.docs-branch-row {
	display: flex;
	align-items: safe center;
	gap: 0.125rem;
}

.docs-branch-row > .docs-tree-link {
	flex: 1 1 auto;
	min-inline-size: 0;
}

.docs-branch-toggle {
	display: inline-flex;
	align-items: safe center;
	justify-content: center;
	inline-size: 1.5rem;
	block-size: 1.5rem;
	padding: 0;
	background: transparent;
	border: none;
	border-radius: var(--docs-radius-sm);
	color: var(--docs-text-muted);
	cursor: pointer;
	flex-shrink: 0;
}

.docs-branch-toggle:hover,
.docs-branch-toggle:focus-visible {
	background-color: var(--docs-bg-hover);
	color: var(--docs-text);
}

.docs-branch-toggle-icon {
	inline-size: 0.875rem;
	block-size: 0.875rem;
	transition: transform 0.2s ease;
}

.docs-branch-toggle[aria-expanded="true"] .docs-branch-toggle-icon {
	transform: rotate(90deg);
}

.docs-subpage-collapse {
	block-size: 0;
	overflow: hidden;
	transition: block-size 0.25s ease-out;
}

.docs-subpage-collapse.is-expanded {
	block-size: auto;
}

/* ==========================================================================
   5. Main Documentation Content Area
   ========================================================================== */

.docs-main {
	grid-area: main;
	min-inline-size: 0;
	padding-block: 2.5rem 4rem;
	padding-inline: clamp(1.5rem, 4vw, 3.5rem);
	container: docs-content / inline-size;
}

.docs-article {
	max-inline-size: var(--docs-content-max-width);
}

/* Breadcrumbs */
.docs-breadcrumbs {
	margin-block-end: 1.25rem;
	font-size: 0.8125rem;
	color: var(--docs-text-muted);
}

.docs-breadcrumb-list {
	list-style: none;
	margin: 0;
	padding: 0;
	display: flex;
	flex-wrap: wrap;
	align-items: safe center;
	gap: 0.375rem;
}

.docs-breadcrumb-list li + li::before {
	content: "/";
	margin-inline-end: 0.375rem;
	color: var(--docs-border);
}

.docs-breadcrumb-list a {
	color: var(--docs-text-muted);
	text-decoration: none;
}

.docs-breadcrumb-list a:hover,
.docs-breadcrumb-list a:focus-visible {
	color: var(--docs-accent);
	text-decoration: underline;
}

/* Article Typography */
.docs-article-header {
	margin-block-end: 2rem;
	padding-block-end: 1.25rem;
	border-block-end: 1px solid var(--docs-border);
}

.docs-category-badge {
	display: inline-block;
	margin-block-end: 0.5rem;
	font-size: 0.75rem;
	font-weight: 600;
	text-transform: uppercase;
	letter-spacing: 0.04em;
	color: var(--docs-accent);
	text-decoration: none;
}

.docs-title {
	margin: 0;
	font-size: clamp(1.75rem, 4cqi, 2.25rem);
	font-weight: 800;
	line-height: 1.2;
	letter-spacing: -0.025em;
	color: var(--docs-text);
}

.docs-meta {
	margin-block-start: 0.75rem;
	font-size: 0.8125rem;
	color: var(--docs-text-muted);
	display: flex;
	flex-wrap: wrap;
	gap: 1rem;
}

.docs-entry-content {
	font-size: 1rem;
	line-height: 1.75;
	color: var(--docs-text);
}

.docs-entry-content h2 {
	margin-block: 2.25rem 0.75rem;
	padding-block-end: 0.375rem;
	font-size: 1.5rem;
	font-weight: 700;
	letter-spacing: -0.015em;
	color: var(--docs-text);
	border-block-end: 1px solid var(--docs-border);
}

.docs-entry-content h3 {
	margin-block: 1.75rem 0.5rem;
	font-size: 1.25rem;
	font-weight: 600;
	color: var(--docs-text);
}

.docs-entry-content h4 {
	margin-block: 1.5rem 0.5rem;
	font-size: 1.0625rem;
	font-weight: 600;
	color: var(--docs-text);
}

.docs-entry-content p,
.docs-entry-content ul,
.docs-entry-content ol,
.docs-entry-content dl,
.docs-entry-content figure,
.docs-entry-content blockquote {
	margin-block: 0 1.25rem;
}

.docs-entry-content a {
	color: var(--docs-accent);
	text-decoration: underline;
	text-underline-offset: 0.15em;
}

.docs-entry-content a:hover {
	color: var(--docs-accent-hover);
}

/* Buttons */
.docs-button,
.wp-block-button__link,
button[type="submit"],
input[type="submit"] {
	display: inline-flex;
	align-items: safe center;
	justify-content: center;
	gap: 0.5rem;
	padding-block: 0.55rem;
	padding-inline: 1.125rem;
	font-family: inherit;
	font-size: 0.875rem;
	font-weight: 600;
	color: #ffffff;
	background-color: var(--docs-accent);
	border: 1px solid transparent;
	border-radius: var(--docs-radius-btn);
	box-shadow: var(--docs-shadow);
	text-decoration: none;
	cursor: pointer;
	transition: background-color 0.15s ease, box-shadow 0.15s ease, transform 0.15s ease;
}

.docs-button:hover,
.docs-button:focus-visible,
.wp-block-button__link:hover,
button[type="submit"]:hover {
	background-color: var(--docs-accent-hover);
	color: #ffffff;
	box-shadow: var(--docs-shadow-hover);
}

/* Inline & Block Code */
.docs-entry-content code {
	font-family: var(--docs-font-mono);
	font-size: 0.875em;
	background-color: var(--docs-bg-hover);
	color: var(--docs-text);
	padding-block: 0.15rem;
	padding-inline: 0.375rem;
	border-radius: var(--docs-radius-sm);
	border: 1px solid var(--docs-border);
}

.docs-entry-content pre {
	color-scheme: dark;
	accent-color: var(--docs-accent);
	margin-block: 0 1.5rem;
	padding: 1rem 1.25rem;
	background-color: #0f172a;
	color: #f8fafc;
	border-radius: var(--docs-radius-lg);
	box-shadow: var(--docs-shadow);
	overflow-x: auto;
	scrollbar-gutter: stable;
	font-size: 0.875rem;
	line-height: 1.6;
}

.docs-entry-content pre:focus-visible {
	outline: 2px solid var(--docs-accent);
	outline-offset: 2px;
}

.docs-entry-content pre code {
	background: transparent;
	color: inherit;
	padding: 0;
	border: none;
	font-size: inherit;
}

/* Callout / Blockquote styling */
.docs-entry-content blockquote,
.docs-callout {
	padding: 1rem 1.25rem;
	background-color: var(--docs-bg-subtle);
	border-inline-start: 4px solid var(--docs-accent);
	border-radius: 0 var(--docs-radius-md) var(--docs-radius-md) 0;
	box-shadow: var(--docs-shadow);
	color: var(--docs-text-secondary);
}

/* Documentation Tables */
.docs-entry-content table {
	inline-size: 100%;
	border-collapse: collapse;
	margin-block-end: 1.5rem;
	font-size: 0.9375rem;
}

.docs-entry-content th,
.docs-entry-content td {
	padding: 0.625rem 0.875rem;
	border: 1px solid var(--docs-border);
	text-align: start;
}

.docs-entry-content th {
	background-color: var(--docs-bg-subtle);
	font-weight: 600;
}

/* Category & Child Subpages Grid (for Overview / Archive Views) */
.docs-card-grid {
	display: grid;
	grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
	grid-template-rows: auto 1fr;
	gap: 1rem;
	margin-block-start: 1.5rem;
}

.docs-card {
	grid-row: span 2;
	display: grid;
	grid-template-rows: auto 1fr;
	grid-template-rows: subgrid;
	row-gap: 0.375rem;
	padding: 1.125rem 1.25rem;
	background-color: var(--docs-bg);
	border: 1px solid var(--docs-border);
	border-radius: var(--docs-radius-lg);
	box-shadow: var(--docs-shadow);
	text-decoration: none;
	color: var(--docs-text);
	transition: border-color 0.15s ease, box-shadow 0.15s ease, transform 0.15s ease;
}

.docs-card:hover,
.docs-card:focus-visible {
	border-color: var(--docs-accent);
	box-shadow: var(--docs-shadow-hover);
}

.docs-card-title {
	margin: 0;
	font-size: 1rem;
	font-weight: 600;
	color: var(--docs-text);
}

.docs-card-excerpt {
	margin: 0;
	font-size: 0.875rem;
	color: var(--docs-text-muted);
	display: -webkit-box;
	-webkit-line-clamp: 3;
	-webkit-box-orient: vertical;
	line-clamp: 3;
	overflow: clip;
}

/* Prev / Next Documentation Page Navigation */
.docs-page-pagination {
	margin-block-start: 3rem;
	padding-block-start: 1.5rem;
	border-block-start: 1px solid var(--docs-border);
	display: grid;
	grid-template-columns: repeat(2, minmax(0, 1fr));
	gap: 1rem;
}

.docs-page-nav-link {
	display: flex;
	flex-direction: column;
	gap: 0.25rem;
	padding: 0.875rem 1rem;
	border: 1px solid var(--docs-border);
	border-radius: var(--docs-radius-lg);
	box-shadow: var(--docs-shadow);
	text-decoration: none;
	transition: border-color 0.15s ease, background-color 0.15s ease, box-shadow 0.15s ease;
}

.docs-page-nav-link:hover,
.docs-page-nav-link:focus-visible {
	border-color: var(--docs-accent);
	background-color: var(--docs-bg-subtle);
	box-shadow: var(--docs-shadow-hover);
}

.docs-page-nav-link.is-next {
	grid-column: 2;
	text-align: end;
}

.docs-page-nav-label {
	font-size: 0.75rem;
	font-weight: 600;
	text-transform: uppercase;
	letter-spacing: 0.04em;
	color: var(--docs-text-muted);
}

.docs-page-nav-title {
	font-size: 0.9375rem;
	font-weight: 600;
	color: var(--docs-accent);
}

/* ==========================================================================
   6. Dark Three-Column Footer & Copyright Bottom Bar
   ========================================================================== */

.site-footer {
	grid-area: footer;
	color-scheme: dark;
	accent-color: var(--docs-accent);
	background-color: var(--docs-footer-bg);
	color: var(--docs-footer-text);
	border-block-start: 1px solid var(--docs-footer-border);
}

.footer-columns-container {
	max-inline-size: var(--docs-max-width);
	margin-inline: auto;
	padding-block: 3.5rem 3rem;
	padding-inline: 1.5rem;
	display: grid;
	grid-template-columns: repeat(3, minmax(0, 1fr));
	gap: 2.5rem;
}

.footer-column {
	min-inline-size: 0;
}

.footer-column-title,
.footer-column .widget-title {
	margin-block: 0 1rem;
	font-size: 0.875rem;
	font-weight: 700;
	text-transform: uppercase;
	letter-spacing: 0.06em;
	color: #ffffff;
}

.footer-column p {
	margin-block: 0 1rem;
	font-size: 0.875rem;
	line-height: 1.65;
	color: var(--docs-footer-muted);
}

.footer-links-list,
.footer-column ul {
	list-style: none;
	margin: 0;
	padding: 0;
	display: flex;
	flex-direction: column;
	gap: 0.625rem;
}

.footer-links-list a,
.footer-column ul a {
	font-size: 0.875rem;
	color: var(--docs-footer-muted);
	text-decoration: none;
	transition: color 0.15s ease;
}

.footer-links-list a:hover,
.footer-links-list a:focus-visible,
.footer-column ul a:hover,
.footer-column ul a:focus-visible {
	color: #ffffff;
	text-decoration: underline;
}

/* Footer Bottom Bar with Copyright Info */
.footer-bottom-bar {
	background-color: var(--docs-footer-bottom-bg);
	border-block-start: 1px solid var(--docs-footer-border);
}

.footer-bottom-inner {
	max-inline-size: var(--docs-max-width);
	margin-inline: auto;
	padding-block: 1.25rem;
	padding-inline: 1.5rem;
	display: flex;
	flex-wrap: wrap;
	align-items: safe center;
	justify-content: space-between;
	gap: 1rem;
	font-size: 0.8125rem;
	color: var(--docs-footer-muted);
}

.footer-copyright {
	margin: 0;
}

.footer-bottom-links {
	list-style: none;
	margin: 0;
	padding: 0;
	display: flex;
	flex-wrap: wrap;
	gap: 1.25rem;
}

.footer-bottom-links a {
	color: var(--docs-footer-muted);
	text-decoration: none;
}

.footer-bottom-links a:hover,
.footer-bottom-links a:focus-visible {
	color: #ffffff;
}

/* ==========================================================================
   7. Responsive Breakpoints & Reduced Motion Safety
   ========================================================================== */

@media (max-width: 900px) {
	.mobile-nav-toggle {
		display: inline-flex;
	}

	.header-page-indicator {
		display: none;
	}

	.docs-workspace {
		grid-template-columns: minmax(0, 1fr);
		grid-template-areas: "main";
	}

	.docs-sidebar {
		position: fixed;
		inset-block-start: var(--docs-header-height);
		inset-inline-start: 0;
		z-index: 90;
		inline-size: min(20rem, 85vw);
		block-size: calc(100dvh - var(--docs-header-height));
		box-shadow: var(--docs-shadow-hover);
		transform: translateX(-100%);
		transition: transform 0.25s ease;
	}

	.docs-sidebar.is-open {
		transform: translateX(0);
	}

	.footer-columns-container {
		grid-template-columns: minmax(0, 1fr);
		gap: 2rem;
	}
}

@media (max-width: 600px) {
	.docs-page-pagination {
		grid-template-columns: minmax(0, 1fr);
	}

	.docs-page-nav-link.is-next {
		grid-column: 1;
		text-align: start;
	}
}

/* Mandatory Copy-Paste Safety: Disable sizing animations for motion-sensitive users */
@media (prefers-reduced-motion: reduce) {
	html {
		scroll-behavior: auto;
	}

	.docs-category-details::details-content,
	.docs-subpage-collapse,
	.docs-sidebar,
	.docs-category-summary::after,
	.docs-branch-toggle-icon {
		transition: none !important;
	}
}