/* Reader experience styles (Bootstrap-based). Admin uses MudBlazor.
   All colors come from the design tokens below so light/dark mode and future
   re-theming are a single edit. Dark mode is driven by [data-theme] on <html>
   (set before paint by the inline script in App.razor) and scoped to .docs-root
   so it never bleeds into the MudBlazor admin. */

:root {
    --docs-sidebar-width: 280px;
    --docs-toc-width: 240px;

    --docs-font-sans: "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
    --docs-font-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;

    --docs-radius: 0.5rem;
    --docs-radius-lg: 0.75rem;

    --docs-bg: #eef2f6;               /* tinted page canvas; content sits on white cards */
    --docs-canvas-tint: rgba(37, 99, 235, 0.05);
    --docs-surface: #ffffff;
    --docs-surface-2: #f8fafc;
    --docs-surface-3: #f1f5f9;

    /* Code: dark panel in BOTH themes (terminal-like), blue-tinted inline code. */
    --docs-code-bg: #0f172a;
    --docs-code-border: #1e293b;
    --docs-code-text: #e2e8f0;
    --docs-inline-code-bg: #eff6ff;
    --docs-inline-code-border: #bfdbfe;
    --docs-inline-code-text: #1e40af;

    --docs-text: #1f2937;
    --docs-text-strong: #0f172a;
    --docs-text-muted: #64748b;
    --docs-text-faint: #94a3b8;

    --docs-border: #e2e8f0;
    --docs-border-strong: #cbd5e1;

    --docs-accent: #2563eb;
    --docs-accent-strong: #1d4ed8;
    --docs-accent-contrast: #ffffff;
    --docs-accent-bg: #e0ecff;
    --docs-focus: rgba(37, 99, 235, 0.25);

    --docs-mark-bg: #fef08a;
    --docs-mark-text: #422006;

    /* Callouts (admonitions): tinted bg, accent border, title color per type. */
    --docs-note-bg: #eff6ff;      --docs-note-border: #bfdbfe;      --docs-note-title: #1d4ed8;
    --docs-tip-bg: #f0fdf4;       --docs-tip-border: #bbf7d0;       --docs-tip-title: #15803d;
    --docs-warning-bg: #fffbeb;   --docs-warning-border: #fde68a;   --docs-warning-title: #b45309;
    --docs-danger-bg: #fef2f2;    --docs-danger-border: #fecaca;    --docs-danger-title: #b91c1c;
    --docs-important-bg: #f5f3ff; --docs-important-border: #ddd6fe; --docs-important-title: #6d28d9;

    --docs-shadow: 0 1px 2px rgba(2, 6, 23, 0.04), 0 8px 24px rgba(2, 6, 23, 0.06);
}

[data-theme="dark"] {
    --docs-bg: #0b1120;
    --docs-canvas-tint: rgba(96, 165, 250, 0.04);
    --docs-surface: #0f172a;
    --docs-surface-2: #111c30;
    --docs-surface-3: #1e293b;

    --docs-code-bg: #0b1424;
    --docs-code-border: #1e293b;
    --docs-code-text: #e2e8f0;
    --docs-inline-code-bg: #172947;
    --docs-inline-code-border: #1e3a5f;
    --docs-inline-code-text: #93c5fd;

    --docs-text: #cbd5e1;
    --docs-text-strong: #f1f5f9;
    --docs-text-muted: #94a3b8;
    --docs-text-faint: #64748b;

    --docs-border: #1e293b;
    --docs-border-strong: #334155;

    --docs-accent: #60a5fa;
    --docs-accent-strong: #93c5fd;
    --docs-accent-contrast: #06122b;
    --docs-accent-bg: #172947;
    --docs-focus: rgba(96, 165, 250, 0.35);

    --docs-mark-bg: #a16207;
    --docs-mark-text: #fef9c3;

    --docs-note-bg: #172947;      --docs-note-border: #1e3a5f;      --docs-note-title: #93c5fd;
    --docs-tip-bg: #0f2a1d;       --docs-tip-border: #14532d;       --docs-tip-title: #86efac;
    --docs-warning-bg: #2a2210;   --docs-warning-border: #4d3a10;   --docs-warning-title: #fcd34d;
    --docs-danger-bg: #2a1416;    --docs-danger-border: #4c1d1d;    --docs-danger-title: #fca5a5;
    --docs-important-bg: #1f1a33; --docs-important-border: #3b2f63; --docs-important-title: #c4b5fd;

    --docs-shadow: 0 1px 2px rgba(0, 0, 0, 0.3), 0 8px 24px rgba(0, 0, 0, 0.4);
}

html {
    scroll-behavior: smooth;
    scroll-padding-top: 5rem; /* keep anchored headings clear of the sticky top bar */
}

/* Reader root — owns the page canvas + base type so the admin app is untouched. */
.docs-root {
    min-height: 100vh;
    /* Subtle accent wash at the top of the tinted canvas (fades out by ~280px). */
    background: linear-gradient(180deg, var(--docs-canvas-tint), rgba(0, 0, 0, 0) 280px), var(--docs-bg);
    color: var(--docs-text);
    font-family: var(--docs-font-sans);
    -webkit-font-smoothing: antialiased;
}

[data-theme="dark"] .docs-root {
    color-scheme: dark;
}

.docs-icon {
    flex: none;
    vertical-align: middle;
}

/* ---- Top bar ---- */
.docs-topbar {
    display: flex;
    align-items: center;
    gap: 1.25rem;
    padding: 0.6rem 1.5rem;
    border-bottom: 1px solid var(--docs-border);
    background: var(--docs-surface);
    position: sticky;
    top: 0;
    z-index: 1000;
}

.docs-brand {
    display: inline-flex;
    align-items: center;
    gap: 0.5rem;
    font-weight: 700;
    font-size: 1.05rem;
    color: var(--docs-text-strong);
    text-decoration: none;
    white-space: nowrap;
}

.docs-brand-icon {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 30px;
    height: 30px;
    border-radius: 8px;
    background: var(--docs-accent);
    color: var(--docs-accent-contrast);
}

.docs-search {
    flex: 1;
    max-width: 520px;
    position: relative;
    display: flex;
    align-items: center;
}

.docs-search-icon {
    position: absolute;
    left: 0.75rem;
    display: inline-flex;
    color: var(--docs-text-faint);
    pointer-events: none;
}

.docs-search input {
    -webkit-appearance: none; /* stop WebKit painting native search-field chrome over the dark theme */
    appearance: none;
    width: 100%;
    padding: 0.5rem 0.9rem 0.5rem 2.15rem;
    border: 1px solid var(--docs-border-strong);
    border-radius: 999px;
    font-size: 0.9rem;
    background: var(--docs-surface-2);
    color: var(--docs-text);
    transition: border-color 0.15s ease, box-shadow 0.15s ease, background-color 0.15s ease;
}

.docs-search input::placeholder {
    color: var(--docs-text-faint);
}

.docs-search input:focus {
    outline: none;
    border-color: var(--docs-accent);
    background: var(--docs-surface);
    box-shadow: 0 0 0 3px var(--docs-focus);
}

.docs-topbar-actions {
    display: flex;
    align-items: center;
    gap: 1rem;
    margin-left: auto;
}

.docs-topbar-link {
    color: var(--docs-text-muted);
    text-decoration: none;
    font-size: 0.9rem;
}

.docs-topbar-link:hover {
    color: var(--docs-accent);
}

.docs-logout-form {
    display: inline;
}

.docs-link-btn {
    background: none;
    border: none;
    padding: 0;
    cursor: pointer;
    font: inherit;
}

/* Light/dark switch. Sun shows in dark mode (to go light) and vice-versa. */
.docs-theme-toggle {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 34px;
    height: 34px;
    border-radius: var(--docs-radius);
    border: 1px solid var(--docs-border);
    background: var(--docs-surface);
    color: var(--docs-text-muted);
    cursor: pointer;
    transition: background-color 0.15s ease, color 0.15s ease;
}

.docs-theme-toggle:hover {
    background: var(--docs-surface-2);
    color: var(--docs-text);
}

.icon-sun {
    display: none;
}

.icon-moon {
    display: inline-flex;
}

[data-theme="dark"] .icon-sun {
    display: inline-flex;
}

[data-theme="dark"] .icon-moon {
    display: none;
}

/* ---- Shell ---- */
.docs-shell {
    display: grid;
    grid-template-columns: var(--docs-sidebar-width) minmax(0, 1fr);
    gap: 2rem;
    align-items: start;
    max-width: 1400px;
    margin: 0 auto;
    padding: 1.5rem;
}

.docs-sidebar {
    position: sticky;
    top: 4rem;
    max-height: calc(100vh - 5rem);
    overflow-y: auto;
}

.docs-sidebar-empty {
    color: var(--docs-text-faint);
    font-size: 0.85rem;
}

/* ---- Sidebar navigation (collapsible areas via <details>) ---- */
.area-block {
    margin-bottom: 0.15rem;
}

.area-summary {
    display: flex;
    align-items: center;
    gap: 0.4rem;
    padding: 0.4rem 0.5rem;
    border-radius: var(--docs-radius);
    cursor: pointer;
    list-style: none;
    user-select: none;
}

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

.area-summary:hover {
    background: var(--docs-surface-2);
}

.area-chevron {
    color: var(--docs-text-faint);
    transition: transform 0.15s ease;
}

details[open] > .area-summary .area-chevron {
    transform: rotate(90deg);
}

.area-icon {
    color: var(--docs-text-muted);
}

.area-title {
    font-weight: 600;
    font-size: 0.9rem;
    color: var(--docs-text-strong);
    text-decoration: none;
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
}

.area-title:hover {
    color: var(--docs-accent);
}

.area-links {
    display: flex;
    flex-direction: column;
    padding: 0.1rem 0 0.5rem 1.4rem;
}

.area-links a {
    display: block;
    padding: 0.3rem 0.6rem;
    border-radius: var(--docs-radius);
    color: var(--docs-text-muted);
    text-decoration: none;
    font-size: 0.875rem;
}

.area-links a:hover {
    background: var(--docs-surface-2);
    color: var(--docs-text);
}

.area-links a.active {
    background: var(--docs-accent-bg);
    color: var(--docs-accent-strong);
    font-weight: 600;
}

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

/* ---- Article (content + TOC) ---- */
.docs-article {
    display: grid;
    grid-template-columns: minmax(0, 1fr) var(--docs-toc-width);
    gap: 2.5rem;
    align-items: start;
}

/* The article itself is a raised card on the tinted canvas. */
.docs-article > article {
    min-width: 0;
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: var(--docs-radius-lg);
    padding: 2rem 2.5rem 2.25rem;
    box-shadow: var(--docs-shadow);
}

.docs-content {
    min-width: 0;
    max-width: 820px;
    line-height: 1.7;
    color: var(--docs-text);
}

.docs-content h1,
.docs-article > article > h1 {
    font-size: 2rem;
    margin-bottom: 0.5rem;
    color: var(--docs-text-strong);
    letter-spacing: -0.01em;
}

.docs-content h2 {
    display: flex;
    align-items: baseline;
    gap: 0.6rem;
    font-size: 1.45rem;
    margin-top: 2.25rem;
    color: var(--docs-text-strong);
}

/* Accent bar in front of section headings (replaces the old underline). */
.docs-content h2::before {
    content: "";
    align-self: stretch;
    width: 6px;
    border-radius: 4px;
    background: var(--docs-accent);
    flex: none;
}

.docs-content h3 {
    font-size: 1.2rem;
    margin-top: 1.5rem;
    color: var(--docs-text-strong);
}

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

/* Ordered lists render as numbered steps (most docs are procedures). Each list
   resets its own counter, so nested lists number independently. */
.docs-content ol {
    list-style: none;
    counter-reset: docs-step;
    padding-left: 0;
    margin: 1rem 0;
}

.docs-content ol > li {
    counter-increment: docs-step;
    position: relative;
    padding-left: 2.4rem;
    margin: 0.65rem 0;
}

.docs-content ol > li::before {
    content: counter(docs-step);
    position: absolute;
    left: 0;
    top: 0.1em;
    width: 1.55rem;
    height: 1.55rem;
    display: flex;
    align-items: center;
    justify-content: center;
    border-radius: 50%;
    background: var(--docs-accent-bg);
    color: var(--docs-accent-strong);
    font-size: 0.78rem;
    font-weight: 600;
}

.docs-content ul {
    padding-left: 1.4rem;
}

.docs-content ul > li {
    margin: 0.4rem 0;
}

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

/* Screenshots get a frame so they read as figures, not floating pixels. */
.docs-content img {
    display: block;
    max-width: 100%;
    height: auto;
    border: 1px solid var(--docs-border);
    border-radius: var(--docs-radius);
    background: var(--docs-surface);
    box-shadow: var(--docs-shadow);
    margin: 1.25rem 0;
}

.docs-content figure {
    margin: 1.5rem 0;
    padding: 0.75rem;
    border: 1px solid var(--docs-border);
    border-radius: var(--docs-radius-lg);
    background: var(--docs-surface-2);
}

.docs-content figure img {
    margin: 0;
    box-shadow: none;
}

.docs-content figcaption {
    margin-top: 0.5rem;
    font-size: 0.85rem;
    color: var(--docs-text-muted);
    text-align: center;
}

.docs-content pre {
    background: var(--docs-code-bg);
    color: var(--docs-code-text);
    border: 1px solid var(--docs-code-border);
    border-radius: var(--docs-radius);
    padding: 1rem;
    overflow-x: auto;
}

.docs-content :not(pre) > code {
    background: var(--docs-inline-code-bg);
    color: var(--docs-inline-code-text);
    border: 1px solid var(--docs-inline-code-border);
    padding: 0.1rem 0.4rem;
    border-radius: 0.3rem;
    font-family: var(--docs-font-mono);
    font-size: 0.875em;
    font-weight: 500;
}

.docs-content table {
    border-collapse: collapse;
    width: 100%;
    margin: 1rem 0;
}

.docs-content table th,
.docs-content table td {
    border: 1px solid var(--docs-border);
    padding: 0.5rem 0.75rem;
}

.docs-content table th {
    background: var(--docs-surface-2);
    text-align: left;
}

.docs-content table tbody tr:nth-child(even) {
    background: var(--docs-surface-2);
}

.docs-content blockquote {
    border: 1px solid var(--docs-border);
    border-left: 4px solid var(--docs-border-strong);
    border-radius: 0 var(--docs-radius) var(--docs-radius) 0;
    background: var(--docs-surface-2);
    margin: 1rem 0;
    padding: 0.6rem 1rem;
    color: var(--docs-text-muted);
}

/* ---- Admonitions / callouts (:::note, :::tip, :::warning, :::danger, :::important) ---- */
.admonition {
    margin: 1.25rem 0;
    padding: 0.85rem 1rem 0.7rem;
    border: 1px solid var(--docs-adm-border, var(--docs-border));
    border-left: 4px solid var(--docs-adm-color, var(--docs-border-strong));
    border-radius: var(--docs-radius);
    background: var(--docs-adm-bg, var(--docs-surface-2));
}

.admonition > :last-child {
    margin-bottom: 0;
}

.admonition-title {
    display: flex;
    align-items: center;
    margin: 0 0 0.35rem;
    font-weight: 600;
    font-size: 0.9rem;
    color: var(--docs-adm-color, var(--docs-text-strong));
}

.admonition-title::before {
    content: "";
    width: 1.05em;
    height: 1.05em;
    margin-right: 0.45rem;
    flex: none;
    background-color: currentColor;
    -webkit-mask: var(--docs-adm-icon) center / contain no-repeat;
    mask: var(--docs-adm-icon) center / contain no-repeat;
}

.admonition-note {
    --docs-adm-bg: var(--docs-note-bg);
    --docs-adm-border: var(--docs-note-border);
    --docs-adm-color: var(--docs-note-title);
    --docs-adm-icon: url("data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%2024%2024'%20fill='none'%20stroke='black'%20stroke-width='2'%20stroke-linecap='round'%20stroke-linejoin='round'%3E%3Ccircle%20cx='12'%20cy='12'%20r='10'/%3E%3Cpath%20d='M12%2016v-4M12%208h.01'/%3E%3C/svg%3E");
}

.admonition-tip {
    --docs-adm-bg: var(--docs-tip-bg);
    --docs-adm-border: var(--docs-tip-border);
    --docs-adm-color: var(--docs-tip-title);
    --docs-adm-icon: url("data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%2024%2024'%20fill='none'%20stroke='black'%20stroke-width='2'%20stroke-linecap='round'%20stroke-linejoin='round'%3E%3Cpath%20d='M9%2018h6M10%2022h4'/%3E%3Cpath%20d='M12%202a7%207%200%200%200-4%2012.7c.6.5%201%201.3%201%202.1h6c0-.8.4-1.6%201-2.1A7%207%200%200%200%2012%202Z'/%3E%3C/svg%3E");
}

.admonition-warning {
    --docs-adm-bg: var(--docs-warning-bg);
    --docs-adm-border: var(--docs-warning-border);
    --docs-adm-color: var(--docs-warning-title);
    --docs-adm-icon: url("data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%2024%2024'%20fill='none'%20stroke='black'%20stroke-width='2'%20stroke-linecap='round'%20stroke-linejoin='round'%3E%3Cpath%20d='M12%203%202%2020h20L12%203Z'/%3E%3Cpath%20d='M12%209v5M12%2017h.01'/%3E%3C/svg%3E");
}

.admonition-danger {
    --docs-adm-bg: var(--docs-danger-bg);
    --docs-adm-border: var(--docs-danger-border);
    --docs-adm-color: var(--docs-danger-title);
    --docs-adm-icon: url("data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%2024%2024'%20fill='none'%20stroke='black'%20stroke-width='2'%20stroke-linecap='round'%20stroke-linejoin='round'%3E%3Cpath%20d='M8.7%202h6.6L22%208.7v6.6L15.3%2022H8.7L2%2015.3V8.7z'/%3E%3Cpath%20d='M12%208v4M12%2016h.01'/%3E%3C/svg%3E");
}

.admonition-important {
    --docs-adm-bg: var(--docs-important-bg);
    --docs-adm-border: var(--docs-important-border);
    --docs-adm-color: var(--docs-important-title);
    --docs-adm-icon: url("data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%2024%2024'%20fill='none'%20stroke='black'%20stroke-width='2'%20stroke-linecap='round'%20stroke-linejoin='round'%3E%3Cpath%20d='M12%202l3%206.5%207%20.9-5%204.8%201.3%207-6.6-3.5L5.7%2021l1.3-7-5-4.8%207-.9z'/%3E%3C/svg%3E");
}

/* ---- Code blocks: copy-to-clipboard button (wrapper added by docs.js) ---- */
.docs-content .docs-code {
    position: relative;
    margin: 1rem 0;
}

.docs-content .docs-code > pre {
    margin: 0;
}

.docs-copy-btn {
    position: absolute;
    top: 0.45rem;
    right: 0.45rem;
    display: inline-flex;
    align-items: center;
    gap: 0.3rem;
    padding: 0.25rem 0.55rem;
    font-family: var(--docs-font-sans);
    font-size: 0.75rem;
    line-height: 1;
    color: var(--docs-text-muted);
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 0.375rem;
    cursor: pointer;
    opacity: 0.7;
    transition: opacity 0.15s ease, color 0.15s ease, border-color 0.15s ease;
}

.docs-code:hover .docs-copy-btn,
.docs-copy-btn:focus-visible {
    opacity: 1;
}

.docs-copy-btn:hover {
    color: var(--docs-accent);
    border-color: var(--docs-accent);
}

.docs-copy-btn.copied {
    color: var(--docs-tip-title);
    border-color: var(--docs-tip-title);
    opacity: 1;
}

.docs-meta {
    color: var(--docs-text-faint);
    font-size: 0.8rem;
    margin-bottom: 1.5rem;
}

/* Admin-only "Edit" shortcut shown on reader pages (top-right of the title). */
.docs-edit-btn {
    float: right;
    margin: 0.2rem 0 0.5rem 1rem;
    display: inline-flex;
    align-items: center;
    gap: 0.35rem;
    font-size: 0.85rem;
    font-weight: 500;
    line-height: 1;
    color: var(--docs-accent);
    background: var(--docs-surface);
    border: 1px solid var(--docs-accent);
    border-radius: 0.375rem;
    padding: 0.35rem 0.7rem;
    text-decoration: none;
    transition: background-color 0.15s ease, color 0.15s ease;
}

.docs-edit-btn:hover {
    background: var(--docs-accent);
    color: var(--docs-accent-contrast);
}

/* ---- Prev / next section pager ---- */
.docs-pager {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 1rem;
    margin-top: 2.5rem;
    padding-top: 1.5rem;
    border-top: 1px solid var(--docs-border);
}

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

.docs-pager-link:hover {
    border-color: var(--docs-accent);
    box-shadow: var(--docs-shadow);
}

.docs-pager-next {
    text-align: right;
}

.docs-pager-dir {
    display: inline-flex;
    align-items: center;
    gap: 0.35rem;
    font-size: 0.72rem;
    color: var(--docs-text-muted);
    text-transform: uppercase;
    letter-spacing: 0.05em;
}

.docs-pager-next .docs-pager-dir {
    justify-content: flex-end;
}

.docs-pager-title {
    font-size: 0.95rem;
    font-weight: 600;
    color: var(--docs-accent-strong);
}

/* ---- TOC ---- */
.docs-toc {
    position: sticky;
    top: 4rem;
    font-size: 0.85rem;
}

.docs-toc .toc-title {
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--docs-text-muted);
    font-size: 0.7rem;
    margin-bottom: 0.5rem;
}

.docs-toc a {
    display: -webkit-box;
    -webkit-line-clamp: 2; /* long sentence-headings truncate instead of bloating the TOC */
    -webkit-box-orient: vertical;
    overflow: hidden;
    padding: 0.15rem 0;
    color: var(--docs-text-muted);
    text-decoration: none;
    border-left: 2px solid transparent;
    padding-left: 0.6rem;
}

.docs-toc a.toc-h3 {
    padding-left: 1.5rem;
    font-size: 0.8rem;
}

.docs-toc a:hover,
.docs-toc a.active {
    color: var(--docs-accent);
    border-left-color: var(--docs-accent);
}

/* ---- Breadcrumbs ---- */
.docs-breadcrumbs {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    gap: 0.15rem;
    font-size: 0.85rem;
    color: var(--docs-text-faint);
    margin-bottom: 1rem;
}

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

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

.docs-breadcrumbs .sep {
    display: inline-flex;
    margin: 0 0.15rem;
    color: var(--docs-text-faint);
}

/* ---- Area cards (home) ---- */
.area-cards {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
    gap: 1rem;
    margin-top: 1.5rem;
}

.area-card {
    display: block;
    border: 1px solid var(--docs-border);
    border-radius: var(--docs-radius);
    padding: 1.25rem;
    text-decoration: none;
    color: inherit;
    background: var(--docs-surface);
    transition: border-color 0.15s ease, box-shadow 0.15s ease;
}

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

.area-card h3 {
    margin: 0 0 0.4rem;
    font-size: 1.1rem;
    color: var(--docs-text-strong);
}

.area-card p {
    color: var(--docs-text-muted);
    font-size: 0.9rem;
    margin: 0 0 0.6rem;
}

.area-card-count {
    font-size: 0.78rem;
    color: var(--docs-text-faint);
}

.section-list {
    list-style: none;
    padding: 0;
    margin-top: 1rem;
}

.section-list li {
    border-bottom: 1px solid var(--docs-border);
}

.section-list a {
    display: block;
    padding: 0.6rem 0;
    color: var(--docs-accent);
    text-decoration: none;
}

/* ---- Search ---- */
.docs-search-input {
    -webkit-appearance: none;
    appearance: none;
    width: 100%;
    max-width: 520px;
    padding: 0.5rem 0.85rem;
    border: 1px solid var(--docs-border-strong);
    border-radius: var(--docs-radius);
    font-size: 0.95rem;
    background: var(--docs-surface-2);
    color: var(--docs-text);
}

.docs-search-input:focus {
    outline: none;
    border-color: var(--docs-accent);
    box-shadow: 0 0 0 3px var(--docs-focus);
}

.search-results {
    list-style: none;
    padding: 0;
}

.search-results li {
    padding: 1rem 0;
    border-bottom: 1px solid var(--docs-border);
}

.search-result-title {
    font-size: 1.1rem;
    font-weight: 600;
    color: var(--docs-accent);
    text-decoration: none;
}

.search-result-area {
    font-size: 0.78rem;
    color: var(--docs-text-faint);
    margin: 0.15rem 0;
}

.search-result-snippet {
    color: var(--docs-text-muted);
    font-size: 0.9rem;
}

.search-result-snippet mark {
    background: var(--docs-mark-bg);
    color: var(--docs-mark-text);
    padding: 0 0.1rem;
}

/* ---- Feedback widget ---- */
.docs-feedback {
    margin-top: 3rem;
    padding-top: 1.5rem;
    border-top: 1px solid var(--docs-border);
}

.docs-feedback button {
    margin-right: 0.5rem;
}

/* ---- Mobile navigation (hamburger + off-canvas sidebar) ---- */
.nav-toggle {
    display: none; /* shown on small screens via the media query below */
    flex-direction: column;
    justify-content: center;
    gap: 4px;
    width: 40px;
    height: 40px;
    padding: 9px 8px;
    background: none;
    border: none;
    border-radius: 6px;
    cursor: pointer;
}

.nav-toggle span {
    display: block;
    width: 100%;
    height: 2px;
    background: var(--docs-text-strong);
    border-radius: 2px;
}

.nav-backdrop {
    display: none;
}

/* Admin SectionEditor: editor + live-preview split. */
.editor-split {
    grid-template-columns: 1fr 1fr;
    gap: 1rem;
}

/* Code-block syntax colors. Panels are dark in BOTH themes, so these override the
   light Prism CDN theme everywhere inside reader content. */
.docs-content pre[class*="language-"] {
    background: var(--docs-code-bg);
    color: var(--docs-code-text);
}

.docs-content code[class*="language-"],
.docs-content pre[class*="language-"] code {
    color: var(--docs-code-text);
    text-shadow: none;
}

.docs-content .token.comment,
.docs-content .token.prolog,
.docs-content .token.doctype,
.docs-content .token.cdata {
    color: #64748b;
}

.docs-content .token.punctuation {
    color: #94a3b8;
}

.docs-content .token.property,
.docs-content .token.tag,
.docs-content .token.boolean,
.docs-content .token.number,
.docs-content .token.constant,
.docs-content .token.symbol {
    color: #f0abfc;
}

.docs-content .token.selector,
.docs-content .token.attr-name,
.docs-content .token.string,
.docs-content .token.char,
.docs-content .token.builtin {
    color: #86efac;
}

.docs-content .token.operator,
.docs-content .token.entity,
.docs-content .token.url,
.docs-content .token.keyword {
    color: #93c5fd;
}

.docs-content .token.function,
.docs-content .token.class-name {
    color: #fca5a5;
}

/* ---- Responsive ---- */
/* Laptops: drop the on-page TOC so the article gets the full width. */
@media (max-width: 1200px) {
    .docs-article {
        grid-template-columns: 1fr;
    }

    .docs-toc {
        display: none;
    }
}

/* Tablets & phones: off-canvas sidebar, single-column content. */
@media (max-width: 992px) {
    .docs-shell {
        grid-template-columns: 1fr;
        padding: 1rem;
        gap: 0;
    }

    .nav-toggle {
        display: inline-flex;
    }

    .docs-sidebar {
        position: fixed;
        top: 0;
        left: 0;
        bottom: 0;
        width: min(82vw, 300px);
        max-height: 100vh;
        margin: 0;
        padding: 1rem 1rem 2rem;
        background: var(--docs-surface);
        box-shadow: 2px 0 18px rgba(15, 23, 42, 0.18);
        transform: translateX(-100%);
        transition: transform 0.25s ease;
        z-index: 1100;
    }

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

    body.nav-open .nav-backdrop {
        display: block;
        position: fixed;
        inset: 0;
        background: rgba(15, 23, 42, 0.45);
        z-index: 1050;
    }

    body.nav-open {
        overflow: hidden; /* lock background scroll while the drawer is open */
    }

    .docs-topbar {
        gap: 0.75rem;
        padding: 0.55rem 0.9rem;
    }

    .docs-content h1,
    .docs-article > article > h1 {
        font-size: 1.6rem;
    }

    .docs-article > article {
        padding: 1.15rem 1.25rem;
    }

    /* Wide tables (e.g. settings grids) scroll instead of breaking the layout. */
    .docs-content table {
        display: block;
        max-width: 100%;
        overflow-x: auto;
        -webkit-overflow-scrolling: touch;
    }

    /* Comfortable touch targets in the nav drawer. */
    .area-links a {
        padding: 0.5rem 0.6rem;
    }

    /* Stack the editor + preview panes. */
    .editor-split {
        grid-template-columns: 1fr;
    }

    /* Let MudBlazor toolbars (admin app bar, editor actions) scroll if cramped. */
    .mud-toolbar {
        overflow-x: auto;
    }

    .admin-title {
        display: none;
    }
}

/* Small phones: reclaim top-bar space. */
@media (max-width: 576px) {
    .docs-brand-text {
        display: none; /* keep the brand mark as the home link */
    }

    .docs-hide-sm {
        display: none; /* hide the username link; Log out stays */
    }

    .docs-pager {
        grid-template-columns: 1fr;
    }

    .docs-pager-next {
        text-align: left;
    }

    .docs-pager-next .docs-pager-dir {
        justify-content: flex-start;
    }
}

/* ---- Admin media library grid ---- */
.media-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(190px, 1fr));
    gap: 1rem;
}

.text-truncate {
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
}

/* ---- Version diff view (admin, always light) ---- */
.diff-view {
    margin: 0;
    font-size: 0.85rem;
    line-height: 1.45;
    white-space: pre-wrap;
    word-break: break-word;
}

.diff-view .diff-ins { background: #e6ffed; color: #22863a; display: block; }
.diff-view .diff-del { background: #ffeef0; color: #b31d28; display: block; }
.diff-view .diff-mod { background: #fff5b1; display: block; }
.diff-view .diff-eq { color: #57606a; display: block; }
