/*
 * Knowledge Base styling — everything in this file is scoped under
 * .wphd-kb-wrap. No bare element selectors (a, ul, div, etc.) and no
 * !important are used anywhere, so this can never override the active
 * theme's global styles outside the KB itself, and the theme can never
 * accidentally clobber this by being more specific than a bare tag
 * selector would be. No font-family is set anywhere in this file either
 * — this runs inside other people's sites, on top of their own theme's
 * typography, not a fixed brand identity of its own.
 *
 * Color is entirely driven by --wphd-accent (set inline from the
 * Settings > Knowledge Base Appearance accent color option) — every
 * tint/shadow/border below derives from that one variable via
 * color-mix(), so a site owner's chosen color genuinely propagates
 * through the whole design, not just a couple of icons.
 */

.wphd-kb-wrap {
	--wphd-accent: #2271b1;
	--wphd-accent-soft: color-mix(in srgb, var(--wphd-accent) 12%, transparent);
	--wphd-accent-softer: color-mix(in srgb, var(--wphd-accent) 6%, transparent);
	--wphd-accent-line: color-mix(in srgb, var(--wphd-accent) 30%, transparent);
	/* Neutral tokens follow the theme's own text colour, so the KB works on light and dark themes. Override any of these from your theme CSS. */
	--wphd-surface: transparent;
	--wphd-border: color-mix(in srgb, currentColor 16%, transparent);
	--wphd-border-strong: color-mix(in srgb, currentColor 50%, transparent);
	--wphd-muted: color-mix(in srgb, currentColor 70%, transparent);
	box-sizing: border-box;
	max-width: 960px;
	margin: 0 auto;
}
.wphd-kb-wrap *,
.wphd-kb-wrap *::before,
.wphd-kb-wrap *::after {
	box-sizing: inherit;
}

/* ---------- Hero + live search ---------- */
.wphd-kb-hero {
	text-align: center;
	padding: 8px 0 36px;
}
.wphd-kb-hero-title {
	font-size: 1.7em;
	font-weight: 700;
	margin: 0 0 20px;
}
.wphd-kb-search {
	position: relative;
	max-width: 480px;
	margin: 0 auto;
}
.wphd-kb-search-input {
	width: 100%;
	padding: 14px 18px;
	font-size: 1em;
	border: 1px solid var(--wphd-border-strong); /* 3.24:1 on white (was #ddd = 1.36:1, failed 1.4.11) */
	border-radius: 999px;
	box-shadow: 0 1px 3px rgba(0, 0, 0, 0.06);
	transition: border-color 0.15s ease, box-shadow 0.15s ease;
}
.wphd-kb-search-input:focus {
	/* Keep a real outline (also visible in forced-colours mode) in addition to the accent glow. */
	outline: 2px solid var(--wphd-accent);
	outline-offset: 2px;
	border-color: var(--wphd-accent);
	box-shadow: 0 0 0 3px color-mix(in srgb, var(--wphd-accent) 20%, transparent);
}
.wphd-kb-search-results {
	position: absolute;
	left: 0;
	right: 0;
	top: calc(100% + 8px);
	background: var(--wphd-popover-bg, #fff); /* the pop-over must be opaque, so it brings its own readable pair */
	color: var(--wphd-popover-text, #1d2327);
	border: 1px solid var(--wphd-border);
	border-radius: 12px;
	box-shadow: 0 12px 32px -8px rgba(0, 0, 0, 0.18);
	text-align: left;
	max-height: 360px;
	overflow-y: auto;
	z-index: 20;
}
.wphd-kb-search-result {
	display: block;
	padding: 12px 16px;
	text-decoration: none;
	color: inherit;
	border-bottom: 1px solid var(--wphd-border);
}
.wphd-kb-search-result:last-child {
	border-bottom: none;
}
.wphd-kb-search-result:hover {
	background: var(--wphd-accent-softer);
}
.wphd-kb-search-result-title {
	display: block;
	font-weight: 600;
	font-size: 0.95em;
}
.wphd-kb-search-result-cat {
	display: inline-block;
	font-size: 0.75em;
	color: var(--wphd-accent);
	margin-top: 2px;
}
.wphd-kb-search-result-excerpt {
	display: block;
	font-size: 0.85em;
	color: var(--wphd-muted);
	margin-top: 2px;
}
.wphd-kb-search-empty {
	padding: 14px 16px;
	margin: 0;
	color: var(--wphd-muted);
	font-size: 0.9em;
}

/* ---------- Category tiles (Card Grid layout) ---------- */
.wphd-kb-wrap .wphd-kb-categories {
	display: grid;
	grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
	gap: 18px;
	margin-bottom: 32px;
}
.wphd-kb-wrap .wphd-kb-category-tile {
	position: relative;
	display: flex;
	flex-direction: column;
	align-items: flex-start;
	gap: 10px;
	padding: 24px 20px 20px;
	border: 1px solid var(--wphd-border);
	border-radius: 14px;
	text-decoration: none;
	color: inherit;
	background: var(--wphd-surface);
	overflow: hidden;
	box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04);
	transition: border-color 0.18s ease, transform 0.18s ease, box-shadow 0.18s ease;
}
/* A quiet top accent stripe — the one recurring visual signature tying
   every card in the KB together, rather than color splashed everywhere. */
.wphd-kb-wrap .wphd-kb-category-tile::before {
	content: "";
	position: absolute;
	top: 0;
	left: 0;
	right: 0;
	height: 3px;
	background: var(--wphd-accent);
	opacity: 0.85;
}
.wphd-kb-wrap .wphd-kb-category-tile:hover {
	border-color: var(--wphd-accent-line);
	transform: translateY(-3px);
	box-shadow: 0 10px 24px -12px color-mix(in srgb, var(--wphd-accent) 45%, transparent);
}
.wphd-kb-wrap .wphd-kb-category-icon {
	display: inline-flex;
	align-items: center;
	justify-content: center;
	width: 44px;
	height: 44px;
	border-radius: 12px;
	background: var(--wphd-accent-soft);
}
.wphd-kb-wrap .wphd-kb-category-icon .dashicons {
	font-size: 22px;
	width: 22px;
	height: 22px;
	color: var(--wphd-accent);
}
.wphd-kb-wrap .wphd-kb-category-fallback {
	display: inline-flex;
	align-items: center;
	justify-content: center;
	width: 44px;
	height: 44px;
	border-radius: 12px;
	background: var(--wphd-accent-soft);
	color: var(--wphd-accent);
	font-weight: 700;
	font-size: 17px;
}
.wphd-kb-wrap .wphd-kb-category-name {
	font-weight: 600;
	font-size: 1.08em;
	line-height: 1.3;
}
.wphd-kb-wrap .wphd-kb-category-count {
	display: inline-block;
	font-size: 0.78em;
	font-weight: 600;
	letter-spacing: 0.02em;
	color: var(--wphd-accent);
	background: var(--wphd-accent-softer);
	padding: 3px 10px;
	border-radius: 999px;
}

/* ---------- Sidebar layout ---------- */
.wphd-kb-wrap.wphd-kb-layout-sidebar {
	display: flex;
	gap: 32px;
	align-items: flex-start;
}
.wphd-kb-wrap .wphd-kb-sidebar {
	flex: 0 0 230px;
	display: flex;
	flex-direction: column;
	gap: 2px;
	padding-right: 18px;
	border-right: 1px solid var(--wphd-border);
}
.wphd-kb-wrap .wphd-kb-main {
	flex: 1;
	min-width: 0;
}
.wphd-kb-wrap .wphd-kb-cat-link {
	position: relative;
	display: flex;
	align-items: center;
	gap: 10px;
	padding: 10px 12px 10px 14px;
	border-radius: 8px;
	text-decoration: none;
	color: inherit;
	font-size: 0.95em;
	transition: background 0.15s ease, color 0.15s ease;
}
.wphd-kb-wrap .wphd-kb-cat-link .dashicons {
	color: var(--wphd-accent);
	font-size: 18px;
	width: 18px;
	height: 18px;
	flex-shrink: 0;
}
.wphd-kb-wrap .wphd-kb-cat-link:hover {
	background: var(--wphd-accent-softer);
}
.wphd-kb-wrap .wphd-kb-cat-link.is-active {
	background: var(--wphd-accent-soft);
	color: var(--wphd-accent);
	font-weight: 600;
}
/* A left accent bar on the active item — the one place in the sidebar
   that clearly says "you are here," without relying on color alone. */
.wphd-kb-wrap .wphd-kb-cat-link.is-active::before {
	content: "";
	position: absolute;
	left: 0;
	top: 6px;
	bottom: 6px;
	width: 3px;
	border-radius: 2px;
	background: var(--wphd-accent);
}
.wphd-kb-wrap .wphd-kb-cat-count {
	margin-left: auto;
	color: var(--wphd-muted);
	font-size: 0.82em;
}
.wphd-kb-wrap .wphd-kb-cat-link.is-active .wphd-kb-cat-count {
	color: var(--wphd-accent);
}

/* ---------- Article list (shared by all layouts) ---------- */
.wphd-kb-wrap .wphd-kb-articles {
	display: grid;
	grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
	gap: 16px;
}
.wphd-kb-wrap.wphd-kb-layout-minimal .wphd-kb-articles {
	display: block;
}
.wphd-kb-wrap .wphd-kb-article-card {
	position: relative;
	display: block;
	padding: 18px 20px;
	border: 1px solid var(--wphd-border);
	border-radius: 12px;
	text-decoration: none;
	color: inherit;
	background: var(--wphd-surface);
	box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04);
	transition: border-color 0.18s ease, transform 0.18s ease, box-shadow 0.18s ease;
}
.wphd-kb-wrap .wphd-kb-article-card:hover {
	border-color: var(--wphd-accent-line);
	transform: translateY(-2px);
	box-shadow: 0 8px 20px -12px color-mix(in srgb, var(--wphd-accent) 40%, transparent);
}
.wphd-kb-wrap.wphd-kb-layout-minimal .wphd-kb-article-card {
	border: none;
	border-radius: 0;
	border-bottom: 1px solid var(--wphd-border);
	padding: 14px 2px;
	box-shadow: none;
}
.wphd-kb-wrap.wphd-kb-layout-minimal .wphd-kb-article-card:hover {
	transform: none;
	box-shadow: none;
	border-bottom-color: var(--wphd-accent-line);
}
.wphd-kb-wrap .wphd-kb-article-card:hover .wphd-kb-article-title {
	color: var(--wphd-accent);
}
.wphd-kb-wrap .wphd-kb-article-title {
	display: block;
	font-weight: 600;
	font-size: 1.02em;
	margin-bottom: 6px;
	transition: color 0.15s ease;
}
.wphd-kb-wrap .wphd-kb-article-excerpt {
	display: block;
	font-size: 0.9em;
	line-height: 1.5;
	color: var(--wphd-muted);
}
.wphd-kb-wrap .wphd-kb-back {
	margin-bottom: 18px;
}
.wphd-kb-wrap .wphd-kb-back a {
	display: inline-flex;
	align-items: center;
	gap: 4px;
	text-decoration: none;
	color: var(--wphd-accent);
	font-size: 0.9em;
	font-weight: 500;
}
.wphd-kb-wrap .wphd-kb-empty {
	color: var(--wphd-muted);
	font-style: italic;
}

/* Graceful degradation for browsers without color-mix() support (a
   small minority at this point, but this plugin ships to sites whose
   visitors Claude can't assume anything about) — falls back to the
   plain accent color everywhere a tint/line variant would have been
   used, which is a completely legible, if slightly flatter, result. */
@supports not (background: color-mix(in srgb, red 50%, white)) {
	.wphd-kb-wrap {
		--wphd-accent-soft: var(--wphd-accent);
		--wphd-accent-softer: #f5f5f5;
		--wphd-border: #ddd;
		--wphd-border-strong: #8c8f94;
		--wphd-muted: #646970;
		--wphd-accent-line: var(--wphd-accent);
	}
	.wphd-kb-wrap .wphd-kb-category-icon,
	.wphd-kb-wrap .wphd-kb-category-fallback {
		background: var(--wphd-accent);
		color: #fff;
	}
	.wphd-kb-wrap .wphd-kb-category-count {
		background: #f5f5f5;
	}
	.wphd-kb-wrap .wphd-kb-category-tile:hover,
	.wphd-kb-wrap .wphd-kb-article-card:hover {
		box-shadow: 0 6px 16px -10px rgba(0, 0, 0, 0.35);
	}
}

/* ---------- Accessibility additions ---------- */
.wphd-kb-wrap .screen-reader-text,
.wphd-kb-wrap .wphd-sr-only {
	position: absolute;
	width: 1px;
	height: 1px;
	margin: -1px;
	padding: 0;
	overflow: hidden;
	clip: rect(0, 0, 0, 0);
	clip-path: inset(50%);
	white-space: nowrap;
	border: 0;
}
/* Lists (categories, articles, search results): keep the grid/flow look, drop bullets. */
.wphd-kb-wrap ul.wphd-kb-categories,
.wphd-kb-wrap ul.wphd-kb-articles,
.wphd-kb-wrap .wphd-kb-search-list {
	list-style: none;
	margin-left: 0;
	margin-right: 0;
	padding: 0;
}
.wphd-kb-wrap ul.wphd-kb-categories {
	margin-top: 0;
}
.wphd-kb-wrap ul.wphd-kb-articles {
	margin-top: 0;
	margin-bottom: 0;
}
.wphd-kb-wrap .wphd-kb-category-item,
.wphd-kb-wrap .wphd-kb-article-item,
.wphd-kb-wrap .wphd-kb-search-list > li {
	display: flex;
	margin: 0;
	padding: 0;
}
.wphd-kb-wrap .wphd-kb-category-item::marker,
.wphd-kb-wrap .wphd-kb-article-item::marker {
	content: "";
}
.wphd-kb-wrap .wphd-kb-category-item > .wphd-kb-category-tile,
.wphd-kb-wrap .wphd-kb-article-item > .wphd-kb-article-card {
	flex: 1 1 auto;
	min-width: 0;
}
.wphd-kb-wrap.wphd-kb-layout-minimal .wphd-kb-article-item {
	display: block;
}
.wphd-kb-wrap .wphd-kb-search-list > li {
	display: block;
}
.wphd-kb-wrap .wphd-kb-search-results[hidden] {
	display: none;
}
/* Keyboard focus on results/tiles/cards/sidebar links (hover styles alone are not enough). */
.wphd-kb-wrap .wphd-kb-search-result:focus-visible,
.wphd-kb-wrap .wphd-kb-category-tile:focus-visible,
.wphd-kb-wrap .wphd-kb-article-card:focus-visible,
.wphd-kb-wrap .wphd-kb-cat-link:focus-visible,
.wphd-kb-wrap .wphd-kb-back a:focus-visible {
	outline: 2px solid var(--wphd-accent);
	outline-offset: 2px;
}
.wphd-kb-wrap .wphd-kb-search-result:focus-visible {
	outline-offset: -2px;
	background: var(--wphd-accent-softer);
}
.wphd-kb-wrap .wphd-kb-search-result-excerpt {
	overflow-wrap: anywhere;
}

@media (prefers-reduced-motion: reduce) {
	.wphd-kb-wrap .wphd-kb-search-input,
	.wphd-kb-wrap .wphd-kb-category-tile,
	.wphd-kb-wrap .wphd-kb-article-card,
	.wphd-kb-wrap .wphd-kb-article-title,
	.wphd-kb-wrap .wphd-kb-cat-link,
	.wphd-kb-wrap.wphd-kb-layout-minimal .wphd-kb-article-card {
		transition: none;
	}
	.wphd-kb-wrap .wphd-kb-category-tile:hover,
	.wphd-kb-wrap .wphd-kb-article-card:hover {
		transform: none;
	}
}

/* ================================================================== */
/* Responsive (320px - 768px)                                         */
/* ================================================================== */
.wphd-kb-wrap {
	width: 100%;
}
.wphd-kb-wrap .wphd-kb-article-title,
.wphd-kb-wrap .wphd-kb-article-excerpt,
.wphd-kb-wrap .wphd-kb-category-name {
	overflow-wrap: anywhere;
}
@media (max-width: 768px) {
	/* The 230px sidebar plus content cannot fit a phone: stack it above the content. */
	.wphd-kb-wrap.wphd-kb-layout-sidebar {
		flex-direction: column;
		gap: 20px;
		align-items: stretch;
	}
	.wphd-kb-wrap .wphd-kb-sidebar {
		flex: 0 0 auto;
		padding-right: 0;
		border-right: 0;
		border-bottom: 1px solid var(--wphd-border);
		padding-bottom: 12px;
	}
	.wphd-kb-wrap .wphd-kb-cat-link {
		min-height: 44px;
	}
	.wphd-kb-wrap .wphd-kb-back a {
		min-height: 44px;
	}
	.wphd-kb-wrap .wphd-kb-search-input {
		font-size: 16px; /* prevents iOS focus-zoom */
		min-height: 44px;
	}
	.wphd-kb-wrap .wphd-kb-search-result {
		min-height: 44px;
	}
	.wphd-kb-wrap .wphd-kb-categories {
		grid-template-columns: repeat(auto-fill, minmax(min(100%, 160px), 1fr));
		gap: 12px;
	}
	.wphd-kb-wrap .wphd-kb-articles {
		grid-template-columns: 1fr;
	}
	.wphd-kb-wrap .wphd-kb-search-results {
		max-height: 60vh;
		max-height: 60dvh;
	}
}
@media (max-width: 480px) {
	.wphd-kb-wrap .wphd-kb-hero-title {
		font-size: 1.4em;
	}
}

/* Category view: breadcrumb, heading and intro (2.12.2). */
.wphd-kb-wrap .wphd-kb-breadcrumbs ol {
	display: flex;
	flex-wrap: wrap;
	gap: 6px;
	margin: 0 0 12px;
	padding: 0;
	list-style: none;
	font-size: 0.9em;
}
.wphd-kb-wrap .wphd-kb-breadcrumbs li + li::before {
	content: "\203A";
	margin-right: 6px;
	color: var(--wphd-muted);
}
.wphd-kb-wrap .wphd-kb-breadcrumbs a {
	color: var(--wphd-accent);
}
.wphd-kb-wrap .wphd-kb-category-title {
	margin: 0 0 8px;
}
.wphd-kb-wrap .wphd-kb-category-intro {
	margin: 0 0 18px;
	color: var(--wphd-muted);
}
.wphd-kb-wrap .wphd-kb-breadcrumbs a:focus-visible {
	outline: 2px solid var(--wphd-accent);
	outline-offset: 2px;
}

/* Featured image on an article card and article tags (theme-neutral). */
.wphd-kb-wrap .wphd-kb-article-thumb {
	display: block;
	margin: 0 0 12px;
	overflow: hidden;
	border-radius: 8px;
	aspect-ratio: 16 / 9;
}
.wphd-kb-wrap .wphd-kb-article-thumb img {
	display: block;
	width: 100%;
	height: 100%;
	object-fit: cover;
}
.wphd-kb-article-extras .wphd-kb-tags {
	display: flex;
	flex-wrap: wrap;
	gap: 6px;
	margin: 16px 0;
	padding: 0;
	list-style: none;
}
.wphd-kb-article-extras .wphd-kb-tag {
	margin: 0;
	padding: 2px 10px;
	font-size: 0.85em;
	border: 1px solid color-mix(in srgb, currentColor 25%, transparent);
	border-radius: 999px;
}