/* =============================================================================
   BlackKitt documentation.
   The control panel's tokens — canvas, hairlines, navy, flat cards with a grey
   title band — so the manual reads like the admin it describes.
   ============================================================================= */

:root {
    --canvas: #eceef2;
    --surface: #ffffff;
    --sunken: #f4f5f7;
    --hover: #e5e8ee;
    --line: #d8dce3;
    --line-strong: #c3cad4;
    --fg: #1a2030;
    --fg-muted: #4d586b;
    --fg-subtle: #8792a4;
    --primary: #1e3a5f;
    --primary-fg: #1e3a5f;
    --primary-soft: #e3e8ef;
    --active-bg: #dfe4ec;
    --active-fg: #172d4a;
    --success: #15803d;
    --success-soft: #e5f0e8;
    --warning: #8a4508;
    --warning-soft: #fbf1e4;
    --danger: #be123c;
    --danger-soft: #f9e6eb;
    --radius-control: 3px;
    --radius-card: 4px;
    --topbar: 52px;
    --side: 248px;
    --font: 'Inter', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', sans-serif;
    --mono: 'JetBrains Mono', ui-monospace, 'SFMono-Regular', Consolas, monospace;
    color-scheme: light;
}

*, *::before, *::after { box-sizing: border-box; }

html { scroll-padding-top: calc(var(--topbar) + 16px); -webkit-text-size-adjust: 100%; }

body {
    margin: 0;
    background: var(--canvas);
    color: var(--fg);
    font-family: var(--font);
    font-size: 14px;
    line-height: 1.6;
    -webkit-font-smoothing: antialiased;
}

a { color: var(--primary-fg); text-underline-offset: 2px; }
p { margin: 0 0 10px; }
p:last-child { margin-bottom: 0; }
strong { font-weight: 600; }
[hidden] { display: none !important; }

.icon {
    width: 16px;
    height: 16px;
    flex-shrink: 0;
    fill: none;
    stroke: currentColor;
    stroke-width: 2;
    stroke-linecap: round;
    stroke-linejoin: round;
}

/* ---- Top bar ------------------------------------------------------------ */

.topbar {
    position: sticky;
    top: 0;
    z-index: 30;
    display: flex;
    align-items: center;
    gap: 12px;
    height: var(--topbar);
    padding: 0 16px;
    border-bottom: 1px solid var(--line);
    background: var(--surface);
}

.brand { display: flex; align-items: center; gap: 10px; color: var(--fg); text-decoration: none; }
.brand img { height: 24px; width: auto; display: block; }
.brand span { padding-left: 10px; border-left: 1px solid var(--line); color: var(--fg-muted); font-size: 13px; font-weight: 500; }

.search { position: relative; flex: 1; max-width: 320px; margin-left: 20px; }
.search .icon { position: absolute; top: 50%; left: 10px; width: 15px; height: 15px; color: var(--fg-subtle); transform: translateY(-50%); pointer-events: none; }

.search input {
    width: 100%;
    height: 32px;
    padding: 0 10px 0 32px;
    border: 1px solid var(--line);
    border-radius: var(--radius-control);
    background: var(--sunken);
    color: var(--fg);
    font: inherit;
    font-size: 13px;
}

.search input::placeholder { color: var(--fg-subtle); }
.search input:focus { outline: none; border-color: var(--primary-fg); background: var(--surface); }

.topbar-side { display: flex; align-items: center; gap: 6px; margin-left: auto; }

.version {
    padding: 2px 8px;
    border: 1px solid var(--line);
    border-radius: var(--radius-control);
    color: var(--fg-muted);
    font-size: 12px;
    font-weight: 500;
}

.icon-btn {
    display: inline-grid;
    place-items: center;
    width: 32px;
    height: 32px;
    border: 0;
    border-radius: var(--radius-control);
    background: transparent;
    color: var(--fg-muted);
    cursor: pointer;
}

.icon-btn:hover { background: var(--hover); color: var(--fg); }
.menu-btn { display: none; margin-left: -6px; }

/* ---- Layout ------------------------------------------------------------- */

.layout { display: flex; min-height: calc(100vh - var(--topbar)); }

.side {
    position: sticky;
    top: var(--topbar);
    flex-shrink: 0;
    width: var(--side);
    height: calc(100vh - var(--topbar));
    overflow-y: auto;
    padding: 12px 10px 24px;
    border-right: 1px solid var(--line);
    background: var(--sunken);
}

.side-group { padding: 14px 10px 5px; color: var(--fg-subtle); font-size: 11.5px; font-weight: 500; }
.side-group:first-child { padding-top: 4px; }

.side-link {
    display: flex;
    align-items: center;
    gap: 9px;
    padding: 6px 10px;
    border-radius: var(--radius-control);
    color: var(--fg-muted);
    font-size: 13px;
    text-decoration: none;
}

.side-link:hover { background: var(--hover); color: var(--fg); }
.side-link.is-active { background: var(--active-bg); color: var(--active-fg); font-weight: 500; }
.side-link .icon { width: 15px; height: 15px; }

.side-empty { padding: 10px; color: var(--fg-subtle); font-size: 13px; }

.side-foot { margin: 20px 10px 0; padding-top: 14px; border-top: 1px solid var(--line); font-size: 12px; color: var(--fg-muted); }
.side-foot a { display: block; margin-top: 2px; color: var(--fg-muted); text-decoration: none; }
.side-foot a:hover { color: var(--fg); }

.main { flex: 1; min-width: 0; display: flex; justify-content: center; gap: 32px; padding: 24px 28px 48px; }
.page-wrap { flex: 1; min-width: 0; max-width: 780px; }

/* ---- Page --------------------------------------------------------------- */

.crumb { display: flex; align-items: center; gap: 4px; color: var(--fg-subtle); font-size: 12px; }
.crumb .icon { width: 12px; height: 12px; }
.crumb span:last-child { color: var(--fg-muted); }

.page h1 { margin: 2px 0 2px; font-size: 22px; font-weight: 600; letter-spacing: -0.01em; line-height: 1.3; }
.lede { margin: 0 0 20px; color: var(--fg-muted); font-size: 14.5px; }

.card {
    margin-bottom: 14px;
    overflow: hidden;
    border: 1px solid var(--line);
    border-radius: var(--radius-card);
    background: var(--surface);
}

.card > h2 {
    display: flex;
    align-items: center;
    gap: 10px;
    margin: 0;
    padding: 9px 14px;
    border-bottom: 1px solid var(--line);
    background: var(--sunken);
    font-size: 13.5px;
    font-weight: 600;
}

.card > h2 .meta { margin-left: auto; color: var(--fg-muted); font-size: 12px; font-weight: 400; }

.card-body { padding: 14px; }
.card-body > * + .code, .card-body > .code + * { margin-top: 10px; }
.card-body > .table, .card-body > .kv { margin: -4px 0; }
.card-body--flush { padding: 0; }

/* ---- Steps -------------------------------------------------------------- */

.steps { margin: 0; padding: 0; list-style: none; counter-reset: step; }

.steps > li {
    position: relative;
    padding: 5px 0 5px 34px;
    counter-increment: step;
}

.steps > li::before {
    content: counter(step);
    position: absolute;
    top: 5px;
    left: 0;
    display: grid;
    place-items: center;
    width: 22px;
    height: 22px;
    border-radius: 50%;
    background: var(--primary-soft);
    color: var(--primary-fg);
    font-size: 11.5px;
    font-weight: 600;
}

.steps > li .code { margin: 8px 0 4px; }

.list { margin: 0; padding-left: 18px; }
.list li { padding: 2px 0; }
.list li::marker { color: var(--fg-subtle); }

/* ---- Code --------------------------------------------------------------- */

code {
    padding: 1px 5px;
    border: 1px solid var(--line);
    border-radius: var(--radius-control);
    background: var(--sunken);
    font-family: var(--mono);
    font-size: 12.5px;
    overflow-wrap: anywhere;
}

.code { position: relative; }

.code pre {
    margin: 0;
    padding: 10px 44px 10px 12px;
    overflow-x: auto;
    border: 1px solid var(--line);
    border-radius: var(--radius-control);
    background: var(--sunken);
    font-family: var(--mono);
    font-size: 12.5px;
    line-height: 1.65;
}

.code .copy { position: absolute; top: 5px; right: 5px; }
.code .copy.is-done { color: var(--success); }

/* ---- Notes -------------------------------------------------------------- */

.note {
    display: flex;
    align-items: flex-start;
    gap: 9px;
    margin: 0 0 14px;
    padding: 10px 12px;
    border-radius: var(--radius-card);
    background: var(--primary-soft);
    color: var(--primary-fg);
    font-size: 13.5px;
}

.note .icon { margin-top: 3px; }
.note code { background: var(--surface); }
.note--warn { background: var(--warning-soft); color: var(--warning); }
.note--ok { background: var(--success-soft); color: var(--success); }
.note--danger { background: var(--danger-soft); color: var(--danger); }
.card-body .note { margin: 12px 0 0; }

/* An admin screen's address, written the way the sidebar reads. */
.path {
    display: inline-flex;
    align-items: center;
    gap: 3px;
    padding: 0 6px;
    border-radius: var(--radius-control);
    background: var(--primary-soft);
    color: var(--primary-fg);
    font-size: 12.5px;
    font-weight: 500;
    white-space: nowrap;
}

/* ---- Tables ------------------------------------------------------------- */

.table { width: 100%; border-collapse: collapse; font-size: 13.5px; }
.table th, .table td { padding: 7px 0; border-top: 1px solid var(--line); text-align: left; vertical-align: top; }
.table th + th, .table td + td { padding-left: 16px; }
.table thead th { border-top: 0; color: var(--fg-subtle); font-size: 12px; font-weight: 500; }
.table tbody tr:first-child td { border-top-color: var(--line); }
.table td:first-child { white-space: nowrap; }
.table .muted, .muted { color: var(--fg-muted); }

.kv { display: grid; grid-template-columns: minmax(120px, 30%) minmax(0, 1fr); font-size: 13.5px; }
.kv > dt, .kv > dd { margin: 0; padding: 7px 0; border-top: 1px solid var(--line); }
.kv > dt { color: var(--fg-muted); padding-right: 16px; }
.kv > dt:first-of-type, .kv > dt:first-of-type + dd { border-top: 0; }

/* ---- Tiles -------------------------------------------------------------- */

.tiles { display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 10px; }

.tile { padding: 12px; border: 1px solid var(--line); border-radius: var(--radius-card); background: var(--surface); }
.tile h3 { display: flex; align-items: center; gap: 8px; margin: 0 0 4px; font-size: 13.5px; font-weight: 600; }
.tile h3 .icon { color: var(--primary-fg); }
.tile p { margin: 0; color: var(--fg-muted); font-size: 13px; line-height: 1.5; }

.chips { display: flex; flex-wrap: wrap; gap: 6px; }
.chip { padding: 1px 8px; border: 1px solid var(--line); border-radius: var(--radius-control); background: var(--surface); color: var(--fg-muted); font-size: 12.5px; }

/* ---- Pager and contents ------------------------------------------------- */

.pager { display: grid; grid-template-columns: 1fr 1fr; gap: 10px; margin-top: 22px; }

.pager a {
    display: block;
    padding: 9px 12px;
    border: 1px solid var(--line);
    border-radius: var(--radius-card);
    background: var(--surface);
    color: var(--fg);
    font-weight: 500;
    text-decoration: none;
}

.pager a:hover { border-color: var(--line-strong); }
.pager small { display: block; color: var(--fg-subtle); font-size: 11.5px; font-weight: 400; }
.pager .next { grid-column: 2; text-align: right; }

.toc { position: sticky; top: calc(var(--topbar) + 24px); align-self: flex-start; width: 190px; flex-shrink: 0; }
.toc p { margin: 0 0 6px; padding-left: 12px; color: var(--fg-subtle); font-size: 11.5px; }

.toc a {
    display: block;
    padding: 5px 8px 5px 12px;
    border-left: 2px solid var(--line);
    color: var(--fg-muted);
    font-size: 13px;
    text-decoration: none;
}

.toc a:hover { color: var(--fg); }
.toc a.is-active { border-left-color: var(--primary-fg); color: var(--fg); font-weight: 500; }

.foot { margin-top: 32px; color: var(--fg-subtle); font-size: 12px; text-align: center; }
.foot a { color: inherit; }

/* ---- Narrow screens ----------------------------------------------------- */

@media (max-width: 1180px) {
    .toc { display: none; }
}

@media (max-width: 860px) {
    .menu-btn { display: inline-grid; }
    .search { margin-left: 0; }
    .brand span, .version { display: none; }

    .side {
        position: fixed;
        top: var(--topbar);
        left: 0;
        z-index: 25;
        transform: translateX(-100%);
        transition: transform .18s ease;
        box-shadow: 0 10px 32px -10px rgb(26 32 48 / .28);
    }

    body.nav-open .side { transform: none; }
    .main { padding: 18px 16px 40px; }
    .kv { grid-template-columns: minmax(0, 1fr); }
    .kv > dt { padding-bottom: 0; }
    .kv > dd { border-top: 0; padding-top: 2px; }
    .table td:first-child { white-space: normal; }
}