/*
 * Docs hub (/docs/, Docs.dc.html lines 55-126), search results (search.php), product docs homes
 * (views/doc-home.php) and doc articles (views/doc.php).
 * Spec: plan/phase-07-documentation.md.
 */

/* The artboard sets no body line-height; text without its own renders at "normal" (see PROGRESS note 6). */
.sit-docs-hub,
.sit-docpage {
	line-height: normal;
}

/* 1. Dark hero with search (lines 56-68) */
.sit-docs-hero {
	background: var(--sit-ink);
	color: #fff;
}

.sit-docs-hero :focus-visible {
	outline-color: #fff;
}

.sit-docs-hero__inner {
	display: flex;
	flex-direction: column;
	gap: 22px;
	align-items: center;
	text-align: center;
	padding-top: 72px;
	padding-bottom: 72px;
}

.sit-docs-hero__eyebrow {
	color: var(--sit-on-dark-blue);
}

.sit-docs-hero__title {
	color: #fff;
	overflow-wrap: anywhere;
}

.sit-docs-hero__lead {
	font-size: 18px;
	line-height: 1.6;
	color: var(--sit-dark-muted);
	max-width: 600px;
}

.sit-docs-search {
	position: relative;
	width: 100%;
	max-width: 640px;
}

.sit-docs-search__icon {
	position: absolute;
	left: 16px;
	top: 16px;
	color: var(--sit-muted);
	pointer-events: none;
}

.sit-field--search {
	display: block;
	width: 100%;
	min-height: 52px;
	border-radius: 12px;
	padding: 0 16px 0 46px;
	font-size: 16px;
}

/* Instant results under the hero field (docs home only; assets/js/docs-search.js) */
.sit-docs-search-wrap {
	position: relative;
	width: 100%;
	max-width: 640px;
}

.sit-docs-search-wrap .sit-field--search {
	padding-right: 72px;
}

.sit-docs-search__kbd {
	position: absolute;
	right: 14px;
	top: 50%;
	transform: translateY(-50%);
	padding: 2px 7px;
	border: 1px solid var(--sit-line);
	border-radius: 6px;
	background: var(--sit-bg);
	color: var(--sit-muted);
	font: 500 12px/1.4 var(--sit-font-body);
	pointer-events: none;
}

html:not(.sit-js) .sit-docs-search__kbd,
.sit-field--search:not(:placeholder-shown) + .sit-docs-search__kbd {
	display: none;
}

.sit-docs-search__results {
	position: absolute;
	z-index: 20;
	top: calc(100% + 8px);
	left: 0;
	right: 0;
	max-height: min(60vh, 480px);
	overflow-y: auto;
	padding: 8px;
	background: var(--sit-surface);
	border: 1px solid var(--sit-line);
	border-radius: 12px;
	box-shadow: 0 16px 40px rgba(14, 23, 38, 0.24);
	text-align: left;
	color: var(--sit-ink);
}

.sit-docs-hero .sit-docs-search__results :focus-visible {
	outline-color: var(--sit-accent);
}

.sit-docs-search__results .sit-docside__empty {
	padding: 10px 12px;
}

.sit-docs-hero__popular {
	display: flex;
	flex-wrap: wrap;
	gap: 8px 18px;
	justify-content: center;
	font-size: 14px;
	color: var(--sit-dark-muted);
}

.sit-docs-hero__popular a,
.sit-docs-hero__popular a:hover {
	color: var(--sit-on-dark-blue-link);
}

/* Body (lines 71-72) */
.sit-docs-hub__body {
	padding: 72px 0 96px;
}

.sit-docs-hub__inner {
	display: flex;
	flex-direction: column;
	gap: 56px;
}

.sit-docs-hub__section {
	display: flex;
	flex-direction: column;
	gap: 22px;
}

.sit-docs-hub__title {
	font-size: 28px;
}

/* 2. Plugin cards (lines 77-106) */
.sit-doc-card {
	padding: 30px;
	gap: 18px;
	min-width: 0;
}

.sit-doc-card__head {
	display: flex;
	align-items: center;
	gap: 14px;
}

.sit-doc-card__title {
	font-size: 21px;
}

.sit-doc-card__versions {
	font-size: 13px;
	color: var(--sit-muted);
}

/* Doc list (.doclist) */
.sit-doclist {
	margin: 0;
	padding: 0;
	list-style: none;
	display: flex;
	flex-direction: column;
}

.sit-doclist a {
	display: flex;
	justify-content: space-between;
	gap: 12px;
	padding: 13px 0;
	border-bottom: 1px solid var(--sit-line-soft);
	color: var(--sit-ink);
	text-decoration: none;
	font-size: 15px;
}

.sit-doclist a:hover {
	color: var(--sit-accent);
}

.sit-doclist__tier {
	color: var(--sit-muted);
	font-size: 13px;
	white-space: nowrap;
}

/* Results variant (search results, empty docs index): the divider sits under the excerpt, not the title. */
.sit-doclist--results > li {
	padding: 13px 0;
	border-bottom: 1px solid var(--sit-line-soft);
	display: flex;
	flex-direction: column;
	gap: 4px;
}

.sit-doclist--results > li:first-child {
	padding-top: 0;
}

.sit-doclist--results > li:last-child {
	padding-bottom: 0;
	border-bottom: 0;
}

.sit-doclist--results a {
	padding: 0;
	border-bottom: 0;
	font-weight: 600;
}

.sit-doclist__excerpt {
	font-size: 14px;
	line-height: 1.6;
	color: var(--sit-muted);
}

/* 3. Topic cards (lines 114-116) */
.sit-topic {
	padding: 24px;
	gap: 8px;
	text-decoration: none;
	color: var(--sit-ink);
	min-width: 0;
	transition: border-color 150ms;
}

.sit-topic:hover {
	color: var(--sit-ink);
	border-color: var(--sit-line-strong);
}

.sit-topic__title {
	font-weight: 600;
	font-size: 17px;
}

.sit-topic__text {
	font-size: 14px;
	color: var(--sit-muted);
	line-height: 1.6;
}

/* Search results card */
.sit-search__card {
	padding: 30px;
	gap: 18px;
}

.sit-search__empty-text {
	font-size: 16px;
	line-height: 1.6;
	color: var(--sit-prose);
	overflow-wrap: anywhere;
}

/*
 * Doc article (views/doc.php): left sidebar, article, "On this page" on the right (not in the artboards;
 * docs-site layout decided 2026-11-17). One column under 961px, no right column under 1200px.
 */
.sit-docpage__wrap {
	display: flex;
	flex-direction: column;
	gap: 48px;
	padding-top: 48px;
	padding-bottom: 96px;
}

.sit-docpage__layout {
	display: grid;
	grid-template-columns: minmax(0, 1fr);
	gap: 32px;
	align-items: start;
}

.sit-docpage__head {
	display: flex;
	flex-direction: column;
	gap: 10px;
}

.sit-docpage__eyebrow {
	color: var(--sit-accent);
}

.sit-docpage__main {
	min-width: 0;
	display: flex;
	flex-direction: column;
	gap: 24px;
}

.sit-docpage__updated {
	font-size: 13px;
	color: var(--sit-muted);
}

/* Sidebar: the .sit-toc links, with one nested level */
.sit-docside__list,
.sit-docside__sub {
	margin: 0;
	padding: 0;
	list-style: none;
}

.sit-docside__sub {
	margin: 2px 0 6px 12px;
	padding-left: 8px;
	border-left: 1px solid var(--sit-line);
}

.sit-docside__sub a {
	min-height: 38px;
	font-size: 14px;
}

/* Sidebar search (assets/js/docs-search.js) */
.sit-docside {
	display: flex;
	flex-direction: column;
	gap: 16px;
	min-width: 0;
}

.sit-docside__search {
	position: relative;
}

.sit-docside__search-icon {
	position: absolute;
	left: 12px;
	top: 50%;
	transform: translateY(-50%);
	color: var(--sit-muted);
	pointer-events: none;
}

.sit-docside__field {
	display: block;
	width: 100%;
	min-height: 44px;
	padding: 0 64px 0 36px;
	font-size: 14px;
}

.sit-docside__kbd {
	position: absolute;
	right: 10px;
	top: 50%;
	transform: translateY(-50%);
	padding: 2px 6px;
	border: 1px solid var(--sit-line);
	border-radius: 6px;
	background: var(--sit-bg);
	color: var(--sit-muted);
	font: 500 11px/1.4 var(--sit-font-body);
	pointer-events: none;
}

html:not(.sit-js) .sit-docside__kbd,
.sit-docside__field:not(:placeholder-shown) + .sit-docside__kbd {
	display: none;
}

.sit-docside__result-list {
	margin: 0;
	padding: 0;
	list-style: none;
	display: flex;
	flex-direction: column;
	gap: 2px;
}

.sit-docside__result {
	display: flex;
	flex-direction: column;
	gap: 3px;
	padding: 10px 12px;
	border-radius: 10px;
	color: var(--sit-ink);
	text-decoration: none;
}

.sit-docside__result:hover,
.sit-docside__result:focus-visible {
	background: var(--sit-accent-tint);
	color: var(--sit-ink);
}

.sit-docside__result-title {
	font-weight: 600;
	font-size: 14px;
	color: var(--sit-accent-on-tint);
}

.sit-docside__result-text {
	font-size: 13px;
	line-height: 1.5;
	color: var(--sit-muted);
	overflow-wrap: anywhere;
}

.sit-docside__empty {
	font-size: 14px;
	line-height: 1.5;
	color: var(--sit-muted);
	padding: 0 12px;
	overflow-wrap: anywhere;
}

/* On this page */
.sit-onpage {
	display: none;
	font-size: 14px;
}

.sit-onpage__title {
	font-weight: 600;
	font-size: 13px;
	color: var(--sit-ink);
	margin-bottom: 10px;
}

.sit-onpage__list {
	margin: 0;
	padding: 0 0 0 12px;
	list-style: none;
	border-left: 1px solid var(--sit-line);
	display: flex;
	flex-direction: column;
	gap: 8px;
}

.sit-onpage__item--h3 {
	padding-left: 12px;
}

.sit-onpage a {
	color: var(--sit-muted);
	text-decoration: none;
	line-height: 1.45;
}

.sit-onpage a:hover {
	color: var(--sit-accent);
}

/* Heading being read (assets/js/doc-outline.js): accent text and a 2px accent bar over the list's
   left rule. The bar sits on the <li> so it lines up with the rule for h2 and indented h3 items alike. */
.sit-onpage__item {
	position: relative;
}

.sit-onpage__item::before {
	content: "";
	position: absolute;
	left: -13px;
	top: 0;
	bottom: 0;
	width: 2px;
	background: transparent;
	transition: background-color 0.15s ease;
}

.sit-onpage__item.is-active::before {
	background: var(--sit-accent);
}

.sit-onpage a.is-active {
	color: var(--sit-accent);
	font-weight: 500;
}

@media (prefers-reduced-motion: reduce) {
	.sit-onpage__item::before {
		transition: none;
	}
}

.sit-docpage .sit-prose :is(h2, h3) {
	scroll-margin-top: 24px;
}

@media (min-width: 961px) {
	.sit-docpage__layout {
		grid-template-columns: 240px minmax(0, 1fr);
		gap: 40px;
	}

	.sit-docside {
		position: sticky;
		top: 24px;
		max-height: calc(100vh - 48px);
		overflow-y: auto;
	}
}

@media (min-width: 1200px) {
	/* Docs-site width (developer's request 2026-11-17): wider than the 1200px marketing wrap so the
	   article column is not squeezed between the two sidebars. */
	.sit-docpage__wrap {
		max-width: 1440px;
		padding-left: 32px;
		padding-right: 32px;
	}

	.sit-docpage__layout {
		grid-template-columns: 260px minmax(0, 1fr);
		gap: 56px;
	}

	.sit-docpage__layout--outline {
		grid-template-columns: 260px minmax(0, 1fr) 224px;
	}

	.sit-onpage {
		display: block;
		position: sticky;
		top: 24px;
		max-height: calc(100vh - 48px);
		overflow-y: auto;
	}
}

/* "On this page" scrollbar: 1px thumb, no track, no arrow buttons (Chromium, Safari) */
.sit-onpage::-webkit-scrollbar {
	width: 1px;
	height: 1px;
}

.sit-onpage::-webkit-scrollbar-track {
	background: transparent;
}

.sit-onpage::-webkit-scrollbar-thumb {
	background: var(--sit-line);
}

.sit-onpage:hover::-webkit-scrollbar-thumb {
	background: var(--sit-muted);
}

.sit-onpage::-webkit-scrollbar-button {
	display: none;
	width: 0;
	height: 0;
}

/* Firefox has no ::-webkit-scrollbar; "thin" is the narrowest it allows. Kept out of Chromium,
   where setting scrollbar-width would switch off the 1px rules above. */
@supports not selector(::-webkit-scrollbar) {
	.sit-onpage {
		scrollbar-width: thin;
		scrollbar-color: var(--sit-line) transparent;
	}
}

/* Product docs home (views/doc-home.php): hero, breadcrumb, one card per article */
.sit-dochome .sit-docs-hero__eyebrow {
	color: var(--sit-accent-on-dark);
}

.sit-dochome__body {
	display: flex;
	flex-direction: column;
	gap: 32px;
	padding-top: 40px;
	padding-bottom: 96px;
}

.sit-dochome__grid {
	margin: 0;
	padding: 0;
	list-style: none;
	display: grid;
	grid-template-columns: repeat(auto-fill, minmax(min(100%, 300px), 1fr));
	gap: 20px;
}

.sit-dochome__grid > li {
	display: flex;
	min-width: 0;
}

.sit-dochome-card {
	flex: 1;
	padding: 24px;
	gap: 10px;
	text-decoration: none;
	color: var(--sit-ink);
	min-width: 0;
	transition: border-color 150ms;
}

.sit-dochome-card:hover {
	color: var(--sit-ink);
	border-color: var(--sit-accent);
}

.sit-dochome-card__title {
	font-size: 18px;
	margin-top: 6px;
}

.sit-dochome-card__text {
	font-size: 14px;
	line-height: 1.6;
	color: var(--sit-muted);
}

.sit-dochome-card__arrow {
	margin-top: auto;
	padding-top: 4px;
	color: var(--sit-accent);
	font-weight: 600;
}

/* Administrator note on stub pages */
.sit-docpage__stub {
	background: var(--sit-error-tint);
	border: 1px solid var(--sit-error-line);
	color: var(--sit-error-ink);
	border-radius: 12px;
	padding: 14px 16px;
	font-size: 15px;
	line-height: 1.6;
}

.sit-docpage__stub code {
	font-size: 0.9em;
}

/* Previous / next */
.sit-docnav {
	display: grid;
	grid-template-columns: repeat(auto-fit, minmax(min(100%, 240px), 1fr));
	gap: 16px;
}

:where(.sit-product) .sit-docnav__link {
	padding: 20px 24px;
	gap: 4px;
	text-decoration: none;
	color: var(--sit-ink);
	min-width: 0;
	transition: border-color 150ms;
}

:where(.sit-product) .sit-docnav__link:hover {
	color: var(--sit-ink);
	border-color: var(--sit-line-strong);
}

.sit-docnav__link--next {
	grid-column: -2;
	text-align: right;
}

.sit-docnav__label {
	font-size: 13px;
	color: var(--sit-muted);
}

.sit-docnav__title {
	font-weight: 600;
	font-size: 16px;
	color: var(--sit-accent);
}

/* The article list on an empty docs index sits inside .sit-prose; keep the doc list look there. */
.sit-prose .sit-doclist {
	padding-left: 0;
	gap: 0;
}

.sit-prose .sit-doclist a {
	color: var(--sit-ink);
	text-decoration: none;
	font-size: 15px;
}

.sit-prose .sit-doclist a:hover {
	color: var(--sit-accent);
}

.sit-prose .sit-doclist__excerpt {
	font-size: 14px;
	line-height: 1.6;
	color: var(--sit-muted);
}
