/* ============================================================
   docs.css  –  MSDN-style documentation layout
   All colours use CSS custom properties defined in themes.css
   so dark / light mode is automatic with no extra overrides.
   ============================================================ */

/* ── Shell (3-column grid) ────────────────────────────────── */
.docs-shell {
    display: grid;
    grid-template-columns: 260px 1fr 220px;
    min-height: calc(100vh - 56px);
    background: var(--bg);
    color: var(--text);
}

/* ── Sidebar ──────────────────────────────────────────────── */
.docs-sidebar {
    grid-column: 1;
    position: sticky;
    top: 56px;
    height: calc(100vh - 56px);
    overflow: hidden;
    border-right: 1px solid var(--border);
    background: var(--surface);
    display: flex;
    flex-direction: column;
    z-index: 10;
}

.docs-sidebar-header {
    padding: 1rem 1.25rem 0.75rem;
    border-bottom: 1px solid var(--border);
    flex-shrink: 0;
}

.docs-brand {
    font-weight: 600;
    font-size: 0.95rem;
    color: var(--text);
    text-decoration: none;
    display: flex;
    align-items: center;
}
.docs-brand:hover { color: var(--accent); }

.docs-sidebar-scroll {
    overflow-y: auto;
    flex: 1;
    padding: 0.5rem 0 2rem;
    scrollbar-width: thin;
    scrollbar-color: var(--border) transparent;
}
.docs-sidebar-scroll::-webkit-scrollbar       { width: 4px; }
.docs-sidebar-scroll::-webkit-scrollbar-track { background: transparent; }
.docs-sidebar-scroll::-webkit-scrollbar-thumb { background: var(--border); border-radius: 2px; }

/* ── Nav list ─────────────────────────────────────────────── */
.docs-nav-list {
    list-style: none;
    margin: 0;
    padding: 0;
}

.docs-nav-list.nested {
    padding-left: 0.5rem;
    border-left: 1px solid var(--border);
    margin-left: 1.25rem;
    margin-top: 0.15rem;
    margin-bottom: 0.15rem;
}

.docs-nav-item { margin: 0; }

.docs-nav-link,
.docs-nav-group {
    display: flex;
    align-items: center;
    gap: 0.35rem;
    width: 100%;
    padding: 0.38rem 1.25rem;
    font-size: 0.855rem;
    line-height: 1.4;
    color: var(--text-muted, color-mix(in srgb, var(--text) 70%, transparent));
    text-decoration: none;
    background: none;
    border: none;
    cursor: pointer;
    text-align: left;
    transition: color 0.12s, background 0.12s;
}
.docs-nav-link:hover,
.docs-nav-group:hover {
    color: var(--text);
    background: color-mix(in srgb, var(--accent) 8%, transparent);
}
.docs-nav-link.active {
    color: var(--accent);
    font-weight: 600;
    background: color-mix(in srgb, var(--accent) 12%, transparent);
    border-right: 2px solid var(--accent);
}

.docs-chevron {
    font-size: 0.65rem;
    transition: transform 0.18s ease;
    opacity: 0.5;
    flex-shrink: 0;
}
.docs-chevron.expanded { transform: rotate(90deg); }

/* ── Main content area ────────────────────────────────────── */
.docs-main {
    grid-column: 2;
    min-width: 0;
}

.docs-content {
    max-width: 820px;
    margin: 0 auto;
    padding: 2rem 2.5rem 5rem;
}

/* ── Article typography ───────────────────────────────────── */
.docs-article {
    font-size: 0.975rem;
    line-height: 1.78;
    color: var(--text);
}

.docs-article h1 {
    font-size: 2rem;
    font-weight: 700;
    border-bottom: 1px solid var(--border);
    padding-bottom: 0.5rem;
    margin-top: 0;
    margin-bottom: 1.5rem;
    color: var(--text);
}
.docs-article h2 {
    font-size: 1.4rem;
    font-weight: 600;
    margin-top: 2.5rem;
    margin-bottom: 0.75rem;
    padding-bottom: 0.3rem;
    border-bottom: 1px solid var(--border);
    color: var(--text);
}
.docs-article h3 {
    font-size: 1.15rem;
    font-weight: 600;
    margin-top: 1.75rem;
    margin-bottom: 0.5rem;
    color: var(--text);
}
.docs-article h4,
.docs-article h5 {
    font-size: 1rem;
    font-weight: 600;
    margin-top: 1.25rem;
    margin-bottom: 0.4rem;
}

/* Auto-link anchors added by Markdig */
.docs-article .header-anchor {
    opacity: 0;
    text-decoration: none;
    color: var(--accent);
    margin-left: 0.4rem;
    font-size: 0.8em;
    transition: opacity 0.15s;
}
.docs-article h1:hover .header-anchor,
.docs-article h2:hover .header-anchor,
.docs-article h3:hover .header-anchor { opacity: 1; }

.docs-article p { margin-bottom: 1rem; }
.docs-article a { color: var(--accent); text-decoration: none; }
.docs-article a:hover { text-decoration: underline; }

/* Tables */
.docs-article table {
    width: 100%;
    border-collapse: collapse;
    margin: 1.25rem 0;
    font-size: 0.9rem;
    display: block;
    overflow-x: auto;
}
.docs-article th {
    background: color-mix(in srgb, var(--accent) 10%, var(--surface));
    color: var(--text);
    font-weight: 600;
    padding: 0.6rem 0.85rem;
    border: 1px solid var(--border);
    text-align: left;
    white-space: nowrap;
}
.docs-article td {
    padding: 0.55rem 0.85rem;
    border: 1px solid var(--border);
    vertical-align: top;
}
.docs-article tr:nth-child(even) td {
    background: color-mix(in srgb, var(--surface) 50%, var(--bg));
}

/* Blockquotes */
.docs-article blockquote {
    border-left: 4px solid var(--accent);
    margin: 1.25rem 0;
    padding: 0.75rem 1rem;
    background: color-mix(in srgb, var(--accent) 7%, var(--surface));
    border-radius: 0 4px 4px 0;
    color: var(--text-muted, color-mix(in srgb, var(--text) 75%, transparent));
}
.docs-article blockquote p:last-child { margin-bottom: 0; }

/* Lists */
.docs-article ul,
.docs-article ol {
    padding-left: 1.5rem;
    margin-bottom: 1rem;
}
.docs-article li { margin-bottom: 0.25rem; }
.docs-article li > ul,
.docs-article li > ol { margin-top: 0.25rem; margin-bottom: 0; }

/* Inline code */
.docs-article code:not(pre code) {
    font-family: 'Cascadia Code', 'Consolas', 'Courier New', monospace;
    font-size: 0.88em;
    background: color-mix(in srgb, var(--accent) 10%, var(--surface));
    color: var(--accent);
    padding: 0.1em 0.4em;
    border-radius: 3px;
    border: 1px solid var(--border);
}

/* Code blocks */
.docs-article pre {
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: 6px;
    padding: 1rem 1.25rem;
    overflow-x: auto;
    margin: 1.25rem 0;
    position: relative;
}
.docs-article pre code {
    font-family: 'Cascadia Code', 'Consolas', 'Courier New', monospace;
    font-size: 0.875rem;
    line-height: 1.65;
    background: none;
    border: none;
    padding: 0;
    color: inherit;
}

/* Task lists */
.docs-article .task-list-item { list-style: none; margin-left: -1.5rem; }
.docs-article .task-list-item input[type="checkbox"] { margin-right: 0.5rem; }

/* Horizontal rule */
.docs-article hr {
    border: none;
    border-top: 1px solid var(--border);
    margin: 2rem 0;
}

/* ── Action bar (breadcrumb + edit button row) ────────────── */
.docs-action-bar {
    display: flex;
    align-items: flex-start;
    justify-content: space-between;
    gap: 0.75rem;
    margin-bottom: 1.25rem;
    flex-wrap: wrap;
}

.docs-action-bar .docs-breadcrumb {
    margin-bottom: 0;
    flex: 1 1 auto;
}

/* Edit button */
.docs-btn-edit {
    display: inline-flex;
    align-items: center;
    gap: 0.3rem;
    padding: 0.3rem 0.85rem;
    font-size: 0.82rem;
    font-weight: 500;
    color: var(--accent);
    background: color-mix(in srgb, var(--accent) 10%, transparent);
    border: 1px solid color-mix(in srgb, var(--accent) 30%, transparent);
    border-radius: 5px;
    cursor: pointer;
    white-space: nowrap;
    transition: background 0.14s, border-color 0.14s;
    flex-shrink: 0;
}
.docs-btn-edit:hover {
    background: color-mix(in srgb, var(--accent) 18%, transparent);
    border-color: var(--accent);
}

/* Edit mode actions (save / cancel / label) */
.docs-edit-actions {
    display: flex;
    align-items: center;
    gap: 0.5rem;
    flex-wrap: wrap;
}

.docs-editing-label {
    font-size: 0.78rem;
    color: color-mix(in srgb, var(--text) 60%, transparent);
}
.docs-editing-label code {
    font-size: 0.78rem;
    color: var(--accent);
    background: color-mix(in srgb, var(--accent) 10%, var(--surface));
    padding: 0.1em 0.35em;
    border-radius: 3px;
    border: 1px solid var(--border);
}

.docs-btn-save,
.docs-btn-cancel {
    display: inline-flex;
    align-items: center;
    gap: 0.3rem;
    padding: 0.3rem 0.9rem;
    font-size: 0.82rem;
    font-weight: 500;
    border-radius: 5px;
    border: 1px solid;
    cursor: pointer;
    white-space: nowrap;
    transition: background 0.14s, border-color 0.14s;
}

.docs-btn-save {
    color: #fff;
    background: var(--accent);
    border-color: var(--accent);
}
.docs-btn-save:hover:not(:disabled) {
    background: color-mix(in srgb, var(--accent) 85%, #000);
}
.docs-btn-save:disabled { opacity: 0.65; cursor: not-allowed; }

.docs-btn-cancel {
    color: var(--text);
    background: var(--surface);
    border-color: var(--border);
}
.docs-btn-cancel:hover:not(:disabled) {
    background: color-mix(in srgb, var(--surface) 70%, var(--border));
}
.docs-btn-cancel:disabled { opacity: 0.65; cursor: not-allowed; }

/* ── Save feedback alerts ─────────────────────────────────── */
.docs-alert {
    display: flex;
    align-items: center;
    padding: 0.65rem 1rem;
    border-radius: 6px;
    font-size: 0.875rem;
    margin-bottom: 1rem;
    border: 1px solid;
}
.docs-alert-success {
    color: #166534;
    background: #dcfce7;
    border-color: #86efac;
}
.docs-alert-error {
    color: #991b1b;
    background: #fee2e2;
    border-color: #fca5a5;
}
html[data-theme="dark"] .docs-alert-success {
    color: #86efac;
    background: color-mix(in srgb, #166534 25%, var(--surface));
    border-color: #166534;
}
html[data-theme="dark"] .docs-alert-error {
    color: #fca5a5;
    background: color-mix(in srgb, #991b1b 25%, var(--surface));
    border-color: #991b1b;
}

/* ── Edit mode shell ──────────────────────────────────────── */

/* When editing, collapse the TOC column (nothing to spy on) */
.docs-editing ~ aside.docs-toc,
.docs-shell:has(.docs-editing) .docs-toc {
    display: none;
}

.docs-editor-shell {
    border: 1px solid var(--border);
    border-radius: 8px;
    overflow: hidden;
    background: var(--surface);
}

/* EasyMDE overrides — bind to theme variables */
.docs-editor-shell .EasyMDEContainer .CodeMirror {
    background: var(--surface);
    color: var(--text);
    border-color: var(--border);
    font-family: 'Cascadia Code', 'Consolas', monospace;
    font-size: 0.9rem;
    line-height: 1.65;
}

.docs-editor-shell .editor-toolbar {
    background: color-mix(in srgb, var(--surface) 80%, var(--bg));
    border-bottom: 1px solid var(--border);
}
.docs-editor-shell .editor-toolbar button {
    color: var(--text) !important;
}
.docs-editor-shell .editor-toolbar button:hover,
.docs-editor-shell .editor-toolbar button.active {
    background: color-mix(in srgb, var(--accent) 12%, transparent);
    border-color: var(--border);
}
.docs-editor-shell .editor-toolbar i.separator {
    border-left-color: var(--border);
}

.docs-editor-shell .editor-preview,
.docs-editor-shell .editor-preview-side {
    background: var(--bg);
    color: var(--text);
    border-color: var(--border);
}

.docs-editor-shell .CodeMirror-scroll {
    min-height: 580px;
}

/* ── Breadcrumb ───────────────────────────────────────────── */
.docs-breadcrumb { margin-bottom: 1.25rem; }
.docs-breadcrumb .breadcrumb {
    font-size: 0.82rem;
    margin-bottom: 0;
    --bs-breadcrumb-divider-color: color-mix(in srgb, var(--text) 40%, transparent);
    --bs-breadcrumb-item-active-color: var(--text);
}
.docs-breadcrumb a { color: var(--accent); text-decoration: none; }
.docs-breadcrumb a:hover { text-decoration: underline; }

/* ── Right-side TOC ───────────────────────────────────────── */
.docs-toc {
    grid-column: 3;
    position: sticky;
    top: 72px;
    height: fit-content;
    max-height: calc(100vh - 90px);
    overflow-y: auto;
    padding: 1.5rem 0.75rem 1.5rem 0.5rem;
    font-size: 0.82rem;
    border-left: 1px solid var(--border);
    scrollbar-width: thin;
}

.docs-toc-title {
    font-size: 0.72rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: color-mix(in srgb, var(--text) 55%, transparent);
    margin-bottom: 0.5rem;
    padding-left: 0.5rem;
}

.docs-toc-list {
    list-style: none;
    margin: 0;
    padding: 0;
}
.docs-toc-list li a {
    display: block;
    padding: 0.22rem 0.5rem;
    color: color-mix(in srgb, var(--text) 65%, transparent);
    text-decoration: none;
    border-left: 2px solid transparent;
    transition: color 0.12s, border-color 0.12s;
    border-radius: 0 3px 3px 0;
    line-height: 1.4;
}
.docs-toc-list li a:hover { color: var(--text); }
.docs-toc-list li a.toc-active {
    color: var(--accent);
    border-left-color: var(--accent);
    background: color-mix(in srgb, var(--accent) 8%, transparent);
}
.docs-toc-list li.toc-h3 a {
    padding-left: 1.1rem;
    font-size: 0.79rem;
}

/* ── Not-found state ──────────────────────────────────────── */
.docs-not-found {
    display: flex;
    flex-direction: column;
    align-items: flex-start;
    gap: 0.5rem;
    padding: 3rem 0;
    color: color-mix(in srgb, var(--text) 55%, transparent);
}
.docs-not-found h2 { color: var(--text); margin: 0; }

/* ── Skeleton loader ──────────────────────────────────────── */
.docs-skeleton { padding: 0.5rem 0; }
.skeleton-line {
    height: 14px;
    background: linear-gradient(
        90deg,
        var(--border) 25%,
        color-mix(in srgb, var(--surface) 60%, var(--border)) 50%,
        var(--border) 75%
    );
    background-size: 200% 100%;
    animation: docs-shimmer 1.4s infinite;
    border-radius: 4px;
    margin-bottom: 0.75rem;
}
.skeleton-line.w-60  { width: 60%; height: 28px; }
.skeleton-line.w-80  { width: 80%; }
.skeleton-line.w-90  { width: 90%; }
.skeleton-line.w-100 { width: 100%; }
.skeleton-line.mt-3  { margin-top: 1.25rem; }
@keyframes docs-shimmer {
    0%   { background-position: 200% 0; }
    100% { background-position: -200% 0; }
}

/* ── highlight.js token colours (theme-neutral) ───────────── */
.hljs-keyword,
.hljs-selector-tag    { color: #c792ea; }
.hljs-string,
.hljs-attr            { color: #a5d6a7; }
.hljs-number,
.hljs-literal         { color: #f78c6c; }
.hljs-comment         { color: color-mix(in srgb, var(--text) 50%, transparent); font-style: italic; }
.hljs-type,
.hljs-class           { color: #80cbc4; }
.hljs-built_in,
.hljs-function        { color: #82aaff; }
.hljs-variable        { color: var(--text); }
.hljs-tag .hljs-name  { color: #f07178; }
.hljs-tag .hljs-attr  { color: #ffcb6b; }

/* ── Responsive breakpoints ───────────────────────────────── */
@media (max-width: 1200px) {
    .docs-shell { grid-template-columns: 240px 1fr; }
    .docs-toc   { display: none; }
}

@media (max-width: 768px) {
    .docs-shell { grid-template-columns: 1fr; display: block; }
    .docs-sidebar {
        position: static;
        height: auto;
        border-right: none;
        border-bottom: 1px solid var(--border);
        max-height: 50vh;
    }
    .docs-content { padding: 1.25rem 1rem 3rem; }
}