/*
 * DOCS-PORTAL.CSS
 * Styles for the documentation portal at /docs/ — the landing page, the
 * article/sidebar layout, and documentation-scoped search.
 * Loaded only on portal requests. See includes/docs-portal.php.
 */

/* -------------------------------------------------------------------------
 * Layout: sidebar beside the article on desktop, stacked above it on mobile.
 * The navigation comes first in the DOM, so the mobile stack needs no reorder.
 * ------------------------------------------------------------------------- */

.cmd-docs-layout {
	align-items: start;
	display: grid;
	gap: 2rem;
	grid-template-columns: minmax(0, 1fr);
}

.cmd-docs-layout > * {
	margin-block-end: 0;
	margin-block-start: 0;
}

.cmd-docs-main {
	min-width: 0;
}

.cmd-docs-main > * + * {
	margin-top: 1.5rem;
}

/* -------------------------------------------------------------------------
 * Navigation sidebar
 * ------------------------------------------------------------------------- */

.cmd-docs-nav {
	background: var(--wp--preset--color--base);
	border: 1px solid var(--wp--preset--color--border);
	border-radius: 0.25rem;
	box-sizing: border-box;
	padding: 1.25rem;
}

.cmd-docs-nav__heading {
	color: var(--wp--preset--color--contrast);
	font-size: 0.8125rem;
	font-weight: 700;
	letter-spacing: 0.08em;
	margin: 0 0 0.75rem;
	text-transform: uppercase;
}

.cmd-docs-nav__list {
	list-style: none;
	margin: 0;
	padding: 0;
}

.cmd-docs-nav__list .cmd-docs-nav__list {
	border-left: 1px solid var(--wp--preset--color--border);
	margin: 0.25rem 0 0.25rem 0.5rem;
	padding-left: 0.75rem;
}

.cmd-docs-nav__item {
	margin: 0;
}

.cmd-docs-nav__link {
	border-radius: 0.25rem;
	color: var(--wp--preset--color--subtle-contrast);
	display: block;
	line-height: 1.4;
	padding: 0.4rem 0.5rem;
	text-decoration: none;
}

.cmd-docs-nav__link:hover,
.cmd-docs-nav__link:focus {
	background: var(--wp--preset--color--base-alt);
	color: var(--wp--preset--color--accent);
}

.cmd-docs-nav__item.is-current > .cmd-docs-nav__link {
	background: var(--wp--preset--color--base-alt);
	border-left: 3px solid var(--wp--preset--color--accent);
	color: var(--wp--preset--color--contrast);
	font-weight: 700;
	padding-left: calc(0.5rem - 3px);
}

.cmd-docs-nav__search {
	border-top: 1px solid var(--wp--preset--color--border);
	margin-top: 1rem;
	padding-top: 1rem;
}

/* -------------------------------------------------------------------------
 * Documentation-scoped search form
 * ------------------------------------------------------------------------- */

/*
 * Block themes load core block styles per block, so the block library's
 * .screen-reader-text rule is not guaranteed to be present. Define it here so
 * the search form's label is always hidden visually but read by screen readers.
 */
.cmd-docs .screen-reader-text {
	border: 0;
	clip-path: inset(50%);
	height: 1px;
	margin: -1px;
	overflow: hidden;
	padding: 0;
	position: absolute;
	white-space: nowrap;
	width: 1px;
}

.cmd-docs-search {
	display: flex;
	gap: 0.5rem;
}

.cmd-docs-search__input {
	background: var(--wp--preset--color--base);
	border: 1px solid var(--wp--preset--color--border);
	border-radius: 0.25rem;
	box-sizing: border-box;
	color: var(--wp--preset--color--contrast);
	flex: 1 1 auto;
	font-family: inherit;
	font-size: 1rem;
	line-height: 1.5;
	min-width: 0;
	padding: 0.6rem 0.75rem;
}

.cmd-docs-search__input:focus {
	border-color: var(--wp--preset--color--accent);
	outline: 2px solid color-mix(in srgb, var(--wp--preset--color--accent) 28%, transparent);
	outline-offset: 0;
}

.cmd-docs-search__submit {
	background: var(--wp--preset--color--accent);
	border: 1px solid var(--wp--preset--color--accent-dark);
	border-radius: 0.25rem;
	color: var(--wp--preset--color--base);
	cursor: pointer;
	flex: 0 0 auto;
	font-family: inherit;
	font-size: 1rem;
	font-weight: 700;
	line-height: 1;
	padding: 0.6rem 1.1rem;
}

.cmd-docs-search__submit:hover,
.cmd-docs-search__submit:focus {
	background: var(--wp--preset--color--accent-dark);
}

/* -------------------------------------------------------------------------
 * Landing page index and search results
 * ------------------------------------------------------------------------- */

.cmd-docs-index__list,
.cmd-docs-results__list {
	margin: 0;
	padding-left: 1.25rem;
}

.cmd-docs-index__item,
.cmd-docs-results__item {
	margin-bottom: 1.25rem;
}

.cmd-docs-index__item .cmd-docs-index__list {
	margin-top: 0.75rem;
}

/*
 * Sized in rem rather than with the `large` preset: theme.json enables fluid
 * typography, which scales that preset up past the h2 at desktop widths.
 */
.cmd-docs-index__link,
.cmd-docs-results__link {
	font-size: 1.25rem;
	font-weight: 700;
	line-height: 1.3;
	text-decoration: none;
}

.cmd-docs-index__link:hover,
.cmd-docs-index__link:focus,
.cmd-docs-results__link:hover,
.cmd-docs-results__link:focus {
	text-decoration: underline;
}

.cmd-docs-index__excerpt,
.cmd-docs-results__excerpt {
	margin: 0.25rem 0 0;
}

.cmd-docs-results__count {
	color: var(--wp--preset--color--subtle-contrast);
	margin-bottom: 1.5rem;
}

.cmd-docs-badge {
	background: var(--wp--preset--color--base);
	border: 1px solid var(--wp--preset--color--border);
	border-radius: 1rem;
	color: var(--wp--preset--color--subtle-contrast);
	font-size: 0.75rem;
	letter-spacing: 0.04em;
	padding: 0.1rem 0.6rem;
	text-transform: uppercase;
	vertical-align: 0.15em;
	white-space: nowrap;
}

/* -------------------------------------------------------------------------
 * Empty and no-results states
 * ------------------------------------------------------------------------- */

.cmd-docs-empty {
	background: var(--wp--preset--color--base);
	border: 1px solid var(--wp--preset--color--border);
	border-radius: 0.25rem;
	padding: clamp(1.5rem, 4vw, 2.5rem);
	text-align: center;
}

.cmd-docs-empty__title {
	color: var(--wp--preset--color--contrast);
	font-size: 1.25rem;
	font-weight: 700;
	line-height: 1.3;
	margin: 0 0 0.5rem;
}

.cmd-docs-empty p:last-child {
	margin-bottom: 0;
}

/* -------------------------------------------------------------------------
 * File-backed article body
 * ------------------------------------------------------------------------- */

/* A standfirst under the title, not a second heading. */
.cmd-docs-article__excerpt {
	color: var(--wp--preset--color--subtle-contrast);
	font-size: 1.125rem;
	line-height: 1.5;
	margin-bottom: 2rem;
}

.cmd-docs-article__content > * + * {
	margin-top: 1.25rem;
}

.cmd-docs-article__content h2 {
	margin-top: 2.5rem;
}

.cmd-docs-article__content h3 {
	margin-top: 2rem;
}

.cmd-docs-entry {
	border-top: 1px solid var(--wp--preset--color--border);
	padding-top: 1.25rem;
}

.cmd-docs-entry h3 {
	margin-top: 0;
	overflow-wrap: anywhere;
}

.cmd-docs-params {
	margin: 0;
}

.cmd-docs-params dt {
	color: var(--wp--preset--color--contrast);
	font-weight: 700;
	margin-top: 0.5rem;
}

.cmd-docs-params dd {
	margin: 0.15rem 0 0;
}

.cmd-docs-param-type {
	color: var(--wp--preset--color--muted);
	font-size: 0.875rem;
	font-weight: 400;
}

.cmd-docs-source {
	color: var(--wp--preset--color--muted);
	font-size: 0.875rem;
}

.cmd-docs-choices {
	margin: 0.4rem 0 0;
}

.cmd-docs-article__content code {
	background: var(--wp--preset--color--base);
	border: 1px solid var(--wp--preset--color--border);
	border-radius: 0.2rem;
	font-size: 0.875em;
	overflow-wrap: anywhere;
	padding: 0.1em 0.35em;
}

.cmd-docs-code {
	background: var(--wp--preset--color--base);
	border: 1px solid var(--wp--preset--color--border);
	border-radius: 0.25rem;
	overflow-x: auto;
	padding: 1rem;
}

.cmd-docs-code code {
	background: none;
	border: 0;
	padding: 0;
}

.cmd-docs-notice {
	background: var(--wp--preset--color--base);
	border-left: 3px solid var(--wp--preset--color--border);
	padding: 0.85rem 1rem;
}

.cmd-docs-notice--warning {
	border-left-color: var(--wp--preset--color--accent);
}

.cmd-docs-notice p {
	margin: 0;
}

/* -------------------------------------------------------------------------
 * Reference tables
 * ------------------------------------------------------------------------- */

.cmd-docs-table-wrap {
	overflow-x: auto;
}

.cmd-docs-table {
	border-collapse: collapse;
	min-width: 34rem;
	width: 100%;
}

.cmd-docs-table caption {
	caption-side: top;
	color: var(--wp--preset--color--subtle-contrast);
	font-size: 0.875rem;
	padding-bottom: 0.5rem;
	text-align: left;
}

.cmd-docs-table th,
.cmd-docs-table td {
	border: 1px solid var(--wp--preset--color--border);
	padding: 0.6rem 0.75rem;
	text-align: left;
	vertical-align: top;
}

.cmd-docs-table th {
	background: var(--wp--preset--color--base);
	color: var(--wp--preset--color--contrast);
	font-weight: 700;
}

/*
 * Column sizing for the options reference. Without explicit widths the long
 * option names starve the Type column, and the `overflow-wrap: anywhere` that
 * long names rely on then breaks short words like "password" mid-character.
 */
.cmd-docs-table--options th:nth-child(1) {
	width: 32%;
}

/* Option names run to 35+ characters; a tighter mono keeps most on one line. */
.cmd-docs-table--options td:nth-child(1) code {
	font-size: 0.8125em;
}

.cmd-docs-table--options th:nth-child(2) {
	width: 6.5rem;
}

.cmd-docs-table--options th:nth-child(3) {
	width: 18%;
}

/* The type is always a single short keyword; never break it. */
.cmd-docs-table--options td:nth-child(2) {
	white-space: nowrap;
}

.cmd-docs-table--options td:nth-child(2) code {
	overflow-wrap: normal;
}

.cmd-docs-option-title {
	color: var(--wp--preset--color--muted);
	font-size: 0.8125rem;
}

/* -------------------------------------------------------------------------
 * Desktop: sidebar beside the article.
 * ------------------------------------------------------------------------- */

@media (min-width: 782px) {
	.cmd-docs-layout {
		gap: 3rem;
		grid-template-columns: minmax(0, 16rem) minmax(0, 1fr);
	}

	.cmd-docs-nav {
		position: sticky;
		top: 2rem;
	}

	.cmd-docs-nav .cmd-docs-search {
		flex-wrap: wrap;
	}

	.cmd-docs-nav .cmd-docs-search__submit {
		width: 100%;
	}
}