/* SPDX-FileCopyrightText: 2026 American River Labs, LLC. */
/* SPDX-License-Identifier: LicenseRef-Company-Proprietary */

@font-face {
	font-family: "Source Sans 3";
	src: url("/static/fonts/source-sans-3/SourceSans3-Regular.woff2") format("woff2");
	font-style: normal;
	font-weight: 400;
	font-display: swap;
}

@font-face {
	font-family: "Source Sans 3";
	src: url("/static/fonts/source-sans-3/SourceSans3-SemiBold.woff2") format("woff2");
	font-style: normal;
	font-weight: 600;
	font-display: swap;
}

/* design tokens — matches DESIGN.md YAML */
:root {
	/* canvas / backgrounds */
	--color-canvas:          #F6F4EE;
	--color-canvas-clean:    #FBFAF7;
	--color-surface:         #FFFFFF;
	--color-surface-subtle:  #F1F5F1;
	--color-surface-warm:    #FAF7F0;
	--color-surface-markup:  #F7EFD8;
	--color-surface-info:    #E7EFF1;
	--color-surface-success: #E3EEE5;
	--color-surface-warning: #F7E9CF;
	--color-surface-danger:  #F3DEDA;

	/* borders */
	--color-border:          #D8DDD6;
	--color-border-strong:   #B8C2B9;

	/* text */
	--color-text:            #202421;
	--color-text-muted:      #59645E;
	--color-text-soft:       #737D76;

	/* brand / action */
	--color-primary:         #145F55;
	--color-primary-hover:   #0F4A42;
	--color-primary-soft:    #DCEAE6;
	--color-accent:          #A96538;
	--color-accent-soft:     #F2E3D6;

	/* semantic status */
	--color-info:            #315F73;
	--color-success:         #2F684C;
	--color-warning:         #8B611A;
	--color-danger:          #983B2E;

	/* focus */
	--color-focus:           #2563EB;

	/* typography */
	--font-family-base: "Source Sans 3", ui-sans-serif, system-ui, -apple-system,
	                    BlinkMacSystemFont, "Segoe UI", sans-serif;

	/* spacing / shape */
	--rounded-xs: 2px;
	--rounded-sm: 4px;
	--rounded-md: 8px;
	--rounded-lg: 12px;
	--rounded-full: 9999px;

	/* legacy aliases — keeps existing utility classes working */
	--body-fgcolor:            var(--color-text);
	--body-bgcolor:            var(--color-canvas);
	--muted-fgcolor:           var(--color-text-muted);
	--success-fgcolor:         var(--color-success);
	--success-bgcolor:         var(--color-surface-success);
	--success-border-color:    var(--color-border-strong);
	--error-fgcolor:           var(--color-danger);
	--error-bgcolor:           var(--color-surface-danger);
	--error-border-color:      var(--color-border-strong);
	--info-fgcolor:            var(--color-info);
	--info-bgcolor:            var(--color-surface-info);
	--info-border-color:       var(--color-border-strong);
	--warning-fgcolor:         var(--color-warning);
	--warning-bgcolor:         var(--color-surface-warning);
	--warning-border-color:    var(--color-border-strong);
	--required-indicator-color: var(--color-danger);
	--theme-title-font:        var(--font-family-base);
	--theme-heading-font:      var(--font-family-base);
	--theme-text-font:         var(--font-family-base);
	--theme-button-font:       var(--font-family-base);
	--theme-topbar-fgcolor:    var(--color-text);
	--theme-topbar-bgcolor:    var(--color-primary);
	--theme-main-fgcolor:      var(--color-text);
	--theme-main-bgcolor:      var(--color-canvas);
	--theme-section-fgcolor:   var(--color-text);
	--theme-section-bgcolor:   var(--color-surface-subtle);
	--theme-button-fgcolor:    var(--color-surface);
	--theme-button-bgcolor:    var(--color-primary);
	--theme-border-color:      var(--color-border);
	--theme-hover-color:       var(--color-primary-soft);
	--theme-active-color:      var(--color-primary);
}

/* Enforce [hidden] attribute - prevents author display rules from overriding it. */
[hidden] { display: none !important; }

body {
	margin: 0;
	color: var(--color-text);
	background-color: var(--color-canvas);
	font-family: var(--font-family-base);
}
body > footer {
	margin-top: 4em;
	font-size: 0.75em;
	text-align: center;
}

a {
	color: var(--color-primary);
	text-decoration: underline;
}
a:hover {
	color: var(--color-primary-hover);
}

main {
	color: var(--color-text);
	background-color: var(--color-canvas);
	margin-left: 0;
	margin-right: 0;
}

article {
	margin: 1rem;
	text-align: left;
	text-justify: inter-word;
	font-family: var(--theme-text-font);
	overflow: clip;
}

article section {
	color: var(--color-text);
	background-color: var(--color-surface-subtle);
	border: 1px solid var(--color-border);
	border-radius: var(--rounded-md);
	padding: 1rem;
	margin-top: 1rem;
	margin-bottom: 1rem;
}
article h1 {
	text-align: left;
}
article h2 {
	margin-top: 0;
	font-family: var(--theme-heading-font);
	text-align: left;
}

/* topbar area */
.topbar {
	position: sticky;
	top: 0;
	z-index: 10;
	color: var(--color-text);
	background-color: var(--color-canvas-clean);
	border-bottom: 1px solid var(--color-border);
	display: grid;
	grid-template-columns: auto minmax(0, 1fr);
	grid-template-rows: auto;
	grid-gap: 0.5em;
	padding: 0 1rem;
	width: 100%;
	box-sizing: border-box;
	align-items: center;
	height: 64px;
}
.topbar .logo {
	grid-column: 2;
	grid-row: 1;
	display: flex;
	align-items: center;
	justify-content: flex-start;
	overflow: hidden;
	flex-shrink: 0;
	text-decoration: none;
}
.topbar .logo .site-lockup {
	width: 220px;
	height: auto;
	display: block;
}

/* mobile side panel overlay */
.menu-overlay {
	position: fixed;
	top: 0;
	left: 0;
	width: 100%;
	height: 100%;
	background-color: rgba(0, 0, 0, 0.5);
	z-index: 998;
	display: none;
	opacity: 0;
	transition: opacity 0.3s ease;
	border: none;
	padding: 0;
	border-radius: 0;
	cursor: default;
}
.menu-overlay.active {
	display: block;
	opacity: 1;
}

/* menu bar - mobile side panel */
.menubar {
	position: fixed;
	top: 0;
	left: 0;
	width: 20rem;
	height: 100vh;
	background-color: var(--color-primary);
	z-index: 999;
	display: flex;
	flex-direction: column;
	padding: 1rem;
	box-sizing: border-box;
	transform: translateX(-100%);
	transition: transform 0.3s ease;
	overflow-y: auto;
	font-size: 1.5em;
}
.menubar.mobile {
	transform: translateX(0);
}
.menubar .sidepanel-close {
	align-self: flex-end;
	cursor: pointer;
	color: var(--color-surface);
	width: 2rem;
	height: 2rem;
	display: flex;
	align-items: center;
	justify-content: center;
	margin-bottom: 1rem;
	padding: 0.25rem;
	background: transparent;
	border: none;
}
.menubar .sidepanel-close:hover {
	opacity: 0.7;
}
.menubar .sidepanel-close:focus-visible {
	outline: 2px solid var(--color-focus);
	outline-offset: 2px;
	border-radius: 0.25rem;
}
.menubar ul {
	list-style: none;
	margin: 0;
	padding: 0;
	flex: 1;
	display: flex;
	flex-direction: column;
	gap: 0.5rem;
}
.menubar li {
	text-decoration: none;
	display: block;
}
.menubar a {
	color: var(--color-surface);
	font-family: var(--font-family-base);
	text-decoration: none;
	display: block;
	padding: 0.75rem 1rem;
	width: 100%;
	box-sizing: border-box;
	border: 1px solid transparent;
	border-radius: 0.25rem;
}
.menubar a:hover {
	border: 1px solid rgba(255, 255, 255, 0.4);
}
.menubar a:focus-visible {
	outline: 2px solid var(--color-focus);
	outline-offset: 2px;
}
.menubar a.active {
	color: var(--color-surface);
	background-color: rgba(255, 255, 255, 0.18);
}

/* submenu in mobile side panel */
.menubar .submenu-header {
	display: flex;
	align-items: stretch;
}
.menubar .submenu-header > a {
	flex: 1;
}
.menubar .submenu-toggle {
	background: transparent;
	border: none;
	cursor: pointer;
	color: var(--color-surface);
	padding: 0.5rem;
	display: flex;
	align-items: center;
	justify-content: center;
	flex-shrink: 0;
	transition: transform 0.2s ease;
}
.menubar .submenu-toggle:focus-visible {
	outline: 2px solid var(--color-focus);
	outline-offset: 2px;
	border-radius: 0.25rem;
}
.menubar .has-submenu.open .submenu-toggle {
	transform: rotate(180deg);
}
.menubar .submenu {
	display: none;
	flex: 0 !important;
	padding-left: 1rem;
	margin-top: 0.25rem;
}
.menubar .has-submenu.open .submenu {
	display: flex;
}
.menubar .submenu a {
	font-size: 0.875em;
	padding: 0.5rem 0.75rem;
}

/* menu icon - always displayed at top left */
.menuicon {
	grid-column: 1;
	grid-row: 1;
	display: inline-flex;
	align-items: center;
	justify-content: center;
	cursor: pointer;
	width: 2.5rem;
	height: 2.5rem;
	fill: var(--color-text);
	padding: 0.25em;
	align-self: center;
	background: transparent;
	border: none;
}
.menuicon:focus-visible {
	outline: 2px solid var(--color-focus);
	outline-offset: 2px;
	border-radius: 0.25rem;
}

/* for centering elements */
.center {
	margin-left: auto;
	margin-right: auto;
	width: fit-content;
}

/* italic inline note for content authors */
.note {
	font-style: italic;
	font-size: 0.8em;
}

a:focus-visible,
button:focus-visible,
.btn:focus-visible,
input:focus-visible,
select:focus-visible,
textarea:focus-visible,
summary:focus-visible {
	outline: 3px solid var(--color-focus);
	outline-offset: 2px;
}

/* --- buttons ---
 * Use .btn with a variant class: .btn-primary, .btn-secondary, .btn-danger
 * Works on both <button> and <a> elements.
 */
.btn {
	font-family: var(--font-family-base);
	font-size: 1rem;
	font-weight: 600;
	padding: 10px 14px;
	border-radius: var(--rounded-md);
	border: 1px solid transparent;
	cursor: pointer;
	text-decoration: none;
	display: inline-block;
	line-height: 1.4;
	box-sizing: border-box;
}
.btn-primary {
	color: var(--color-surface);
	background-color: var(--color-primary);
	border-color: var(--color-primary);
}
.btn-primary:hover {
	background-color: var(--color-primary-hover);
	border-color: var(--color-primary-hover);
}
.btn-secondary {
	color: var(--color-primary);
	background-color: var(--color-surface);
	border-color: var(--color-border-strong);
}
.btn-secondary:hover {
	background-color: var(--color-surface-subtle);
}
.btn-danger {
	color: var(--color-danger);
	background-color: var(--color-surface);
	border-color: var(--color-danger);
}
.btn-danger:hover {
	background-color: var(--color-surface-danger);
}

/* --- flash messages ---
 * Kinds: success, error, info, warning
 */
.flash-list {
	display: flex;
	flex-direction: column;
	gap: 0.5rem;
	margin-bottom: 1rem;
}
.flash {
	display: flex;
	align-items: center;
	justify-content: space-between;
	padding: 0.75rem 1rem;
	border-radius: 0.4rem;
	border: 1px solid transparent;
	font-size: 0.95rem;
}
.flash-success {
	background-color: var(--color-surface-success);
	border-color: var(--color-border-strong);
	color: var(--color-success);
}
.flash-error {
	background-color: var(--color-surface-danger);
	border-color: var(--color-border-strong);
	color: var(--color-danger);
}
.flash-info {
	background-color: var(--color-surface-info);
	border-color: var(--color-border-strong);
	color: var(--color-info);
}
.flash-warning {
	background-color: var(--color-surface-warning);
	border-color: var(--color-border-strong);
	color: var(--color-warning);
}
.flash-dismiss {
	background: none;
	border: none;
	cursor: pointer;
	font-size: 1rem;
	color: inherit;
	opacity: 0.6;
	padding: 0 0 0 1rem;
	flex-shrink: 0;
	line-height: 1;
}
.flash-dismiss:hover {
	opacity: 1;
}
.flash-hiding {
	opacity: 0;
	transition: opacity 0.3s ease;
}

/* --- callouts ---
 * Inline non-dismissible notices. Same colour tokens as flash messages.
 * Variants: callout-success, callout-error, callout-info, callout-warning.
 */
.callout {
	padding: 0.75rem 1rem;
	border-radius: 0.4rem;
	border: 1px solid transparent;
	font-size: 0.95rem;
	margin-bottom: 0.75rem;
}
.callout-success {
	background-color: var(--color-surface-success);
	border-color: var(--color-border-strong);
	color: var(--color-success);
}
.callout-error {
	background-color: var(--color-surface-danger);
	border-color: var(--color-border-strong);
	color: var(--color-danger);
}
.callout-info {
	background-color: var(--color-surface-info);
	border-color: var(--color-border-strong);
	color: var(--color-info);
}
.callout-warning {
	background-color: var(--color-surface-warning);
	border-color: var(--color-border-strong);
	color: var(--color-warning);
}

/* --- breadcrumbs ---
 * Separator injected via CSS; hidden on mobile.
 */
.breadcrumbs {
	padding: 0.4rem 1rem;
	font-size: 0.85rem;
	display: none; /* hidden on mobile */
}
.breadcrumbs ol {
	list-style: none;
	padding: 0;
	margin: 0;
	display: flex;
	flex-wrap: wrap;
	gap: 0.25rem;
	align-items: center;
}
.breadcrumbs li {
	display: flex;
	align-items: center;
}
.breadcrumbs li + li::before {
	content: "›";
	margin-right: 0.25rem;
	color: var(--body-fgcolor);
	opacity: 0.4;
}
.breadcrumbs a {
	color: var(--body-fgcolor);
	text-decoration: none;
	opacity: 0.7;
}
.breadcrumbs a:hover {
	opacity: 1;
	text-decoration: underline;
}
.breadcrumbs [aria-current="page"] {
	font-weight: 600;
}

/* --- tables ---
 * article table targets Markdown-generated tables inside article content.
 * Wrap with .table-scroll for horizontal scrolling on wide HTML-authored tables.
 */
.table-scroll {
	overflow-x: auto;
	-webkit-overflow-scrolling: touch;
}
article table {
	width: 100%;
	border-collapse: collapse;
	font-size: 0.95rem;
	margin: 1rem 0;
}
article table th,
article table td {
	text-align: left;
	padding: 0.5rem 0.75rem;
	border-bottom: 1px solid var(--theme-border-color);
}
article table thead th {
	font-weight: 700;
	border-bottom: 2px solid var(--theme-border-color);
}
article table tbody tr:hover {
	background-color: rgba(0, 0, 0, 0.03);
}

/* --- utility ---
 * General-purpose layout helpers.
 */
.text-right {
	text-align: right;
}

/* --- badge ---
 * Small inline label for status or category display.
 */
.badge {
	display: inline-block;
	padding: 0.15em 0.55em;
	border-radius: 3px;
	font-size: 0.8rem;
	font-weight: 600;
	letter-spacing: 0.02em;
	white-space: nowrap;
}

/* --- footer-nav ---
 * Navigation links in the page footer.
 */
.footer-nav {
	margin-top: 0.5rem;
	display: flex;
	gap: 1.25rem;
	justify-content: center;
}
.footer-nav a {
	color: inherit;
	text-decoration: none;
	opacity: 0.7;
}
.footer-nav a:hover {
	opacity: 1;
	text-decoration: underline;
}

/* mobile first responsive design */

/* responsive: 640- (mobile overrides) */
@media screen and (max-width: 639px) {
	.topbar .logo .site-lockup {
		width: 180px;
	}
	.menubar a {
		padding: 0.5rem 0.75rem;
	}
	article section {
		padding: 0.5rem;
	}
}

/* responsive: 640+ */
@media screen and (min-width: 640px) {
	/* menubar always stays as side panel - no horizontal menu */
	/* hide overlay on desktop when menu is closed */
	.menu-overlay:not(.active) {
		display: none !important;
	}
	.breadcrumbs {
		display: block;
	}
}

/* --- print styles --- */
@media print {
	.topbar,
	.menubar,
	.menu-overlay,
	.breadcrumbs,
	footer,
	button,
	input,
	select,
	textarea,
	.btn {
		display: none !important;
	}

	html,
	body,
	main,
	article,
	article section {
		background: white !important;
		color: black !important;
		box-shadow: none !important;
	}

	body {
		background: white;
		color: black;
	}

	article {
		margin: 0;
		overflow: visible;
	}

	article section {
		border: 1px solid #999;
		border-radius: 0;
		padding: 0.75rem;
		page-break-inside: avoid;
		break-inside: avoid;
	}

	a,
	a:visited {
		color: inherit;
	}

	.badge {
		background: white !important;
		border: 1px solid #999;
		color: black !important;
	}

	.table-scroll {
		overflow: visible;
	}

	article table {
		border-collapse: collapse;
		width: 100%;
		page-break-inside: auto;
		break-inside: auto;
	}

	article table th,
	article table td {
		border: 1px solid #999;
		padding: 4px 8px;
	}

	article table thead {
		display: table-header-group;
	}

	article table tr {
		page-break-inside: avoid;
		break-inside: avoid;
	}
}

/*EOF*/