/*  admin.css  ──────────────────────────────────────────────────────────────
 *  Styles for the admin nav dropdown and the internal documentation pages.
 *  Uses the existing StarTech design tokens from styles.css (--accent, --s-*,
 *  --r-*, --t-*, --shadow-*, --ease, etc.) so it inherits light/dark themes.
 * ───────────────────────────────────────────────────────────────────────── */

/* ============================================================ ADMIN GATING */
/* admin-only elements stay hidden until admin-gate.js removes [hidden] */
.admin-only[hidden] { display: none !important; }

/* ============================================================ NAV DROPDOWN */
.nav__dropdown-wrap { position: relative; }

.nav__dropdown-btn {
    display: inline-flex;
    align-items: center;
    gap: var(--s-1);
    border: none;
    background: transparent;
    cursor: pointer;
    font-family: inherit;
}
.nav__dropdown-btn .chevron {
    transition: transform var(--d-fast) var(--ease);
}
.nav__dropdown-wrap .nav__dropdown.is-open ~ .nav__dropdown-btn .chevron,
.nav__dropdown-btn[aria-expanded="true"] .chevron {
    transform: rotate(180deg);
}

/* The admin link gets a subtle accent so it's distinguishable internally */
.nav__link--admin {
    color: var(--accent);
    border: 1px dashed var(--border-strong);
}
.nav__link--admin:hover { background: var(--accent-soft); color: var(--accent); }

.nav__dropdown {
    position: absolute;
    top: calc(100% + 8px);
    right: 0;
    min-width: 248px;
    list-style: none;
    margin: 0;
    padding: var(--s-2);
    background: var(--bg-card);
    border: 1px solid var(--border);
    border-radius: var(--r-lg);
    box-shadow: var(--shadow-lg);
    opacity: 0;
    visibility: hidden;
    transform: translateY(-6px) scale(0.98);
    transform-origin: top right;
    transition: opacity var(--d-fast) var(--ease),
                transform var(--d-fast) var(--ease),
                visibility var(--d-fast);
    z-index: 1200;
}
.nav__dropdown.is-open {
    opacity: 1;
    visibility: visible;
    transform: translateY(0) scale(1);
}
.nav__dropdown li { margin: 0; }
.nav__dropdown a {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--s-3);
    padding: var(--s-3) var(--s-3);
    border-radius: var(--r-sm);
    font-size: var(--t-sm);
    font-weight: 500;
    color: var(--text);
    transition: background-color var(--d-fast), color var(--d-fast);
}
.nav__dropdown a:hover { background: var(--bg-soft); color: var(--text-strong); }
.nav__dropdown a[aria-disabled="true"] {
    color: var(--text-faint);
    cursor: not-allowed;
    pointer-events: none;
}
.nav__dropdown-sep {
    height: 1px;
    margin: var(--s-2) var(--s-1);
    background: var(--border);
}
.nav__dropdown-label {
    padding: var(--s-2) var(--s-3) var(--s-1);
    font-size: var(--t-xs);
    font-weight: 600;
    letter-spacing: 0.04em;
    text-transform: uppercase;
    color: var(--text-faint);
}

/* "Soon" badge for placeholder pages */
.nav__soon {
    font-size: 0.65rem;
    font-weight: 600;
    letter-spacing: 0.03em;
    text-transform: uppercase;
    padding: 2px 7px;
    border-radius: var(--r-pill);
    background: var(--navy-soft);
    color: var(--navy);
}
body.dark-mode .nav__soon { color: var(--link); }

/* Mobile drawer admin group */
.nav__drawer .admin-only .drawer-group-label {
    display: block;
    margin-top: var(--s-4);
    padding: var(--s-2) 0;
    font-size: var(--t-xs);
    font-weight: 600;
    letter-spacing: 0.04em;
    text-transform: uppercase;
    color: var(--accent);
    border-top: 1px solid var(--border);
}

/* ============================================================ DOC PAGE */
.doc-shell {
    display: grid;
    grid-template-columns: 1fr;
    gap: var(--s-10);
    padding-top: var(--s-12);
    padding-bottom: var(--s-24);
}
@media (min-width: 1000px) {
    .doc-shell { grid-template-columns: 260px minmax(0, 1fr); gap: var(--s-16); }
}

/* ---- Sidebar / TOC ---- */
.doc-toc {
    position: relative;
}
@media (min-width: 1000px) {
    .doc-toc {
        position: sticky;
        top: calc(var(--nav-h) + var(--s-6));
        align-self: start;
        max-height: calc(100vh - var(--nav-h) - var(--s-12));
        overflow-y: auto;
    }
}
.doc-toc__title {
    font-size: var(--t-xs);
    font-weight: 600;
    letter-spacing: 0.05em;
    text-transform: uppercase;
    color: var(--text-faint);
    margin-bottom: var(--s-4);
}
.doc-toc ol {
    list-style: none;
    margin: 0;
    padding: 0;
    counter-reset: toc;
    border-left: 2px solid var(--border);
}
.doc-toc li { margin: 0; }
.doc-toc a {
    display: block;
    padding: var(--s-2) var(--s-4);
    margin-left: -2px;
    border-left: 2px solid transparent;
    font-size: var(--t-sm);
    color: var(--text-muted);
    transition: color var(--d-fast), border-color var(--d-fast);
}
.doc-toc a:hover { color: var(--text-strong); }
.doc-toc a.is-active {
    color: var(--accent);
    border-left-color: var(--accent);
    font-weight: 600;
}

/* ---- Article ---- */
.doc-article { max-width: 820px; min-width: 0; }
.doc-article h2 {
    scroll-margin-top: calc(var(--nav-h) + var(--s-6));
    margin-top: var(--s-16);
    margin-bottom: var(--s-5);
    padding-bottom: var(--s-3);
    border-bottom: 1px solid var(--border);
    font-size: var(--t-3xl);
    letter-spacing: -0.02em;
}
.doc-article h2:first-of-type { margin-top: var(--s-6); }
.doc-article h3 {
    scroll-margin-top: calc(var(--nav-h) + var(--s-6));
    margin-top: var(--s-10);
    margin-bottom: var(--s-4);
    font-size: var(--t-xl);
}
.doc-article p { margin-bottom: var(--s-4); line-height: 1.7; color: var(--text); }
.doc-article ul, .doc-article ol { margin: 0 0 var(--s-5) var(--s-6); line-height: 1.7; }
.doc-article li { margin-bottom: var(--s-2); }
.doc-article a:not(.btn) { color: var(--link); text-decoration: underline; text-underline-offset: 2px; }
.doc-article a:not(.btn):hover { color: var(--link-hover); }
.doc-article strong { color: var(--text-strong); font-weight: 600; }

/* ---- Inline code + code blocks ---- */
.doc-article :not(pre) > code {
    font-family: ui-monospace, 'SF Mono', SFMono-Regular, Menlo, Consolas, monospace;
    font-size: 0.85em;
    padding: 2px 6px;
    border-radius: var(--r-xs);
    background: var(--accent-soft);
    color: var(--accent);
    word-break: break-word;
}
.code-block {
    position: relative;
    margin: 0 0 var(--s-6);
    border-radius: var(--r-lg);
    overflow: hidden;
    border: 1px solid var(--border);
    background: var(--navy-darker);
}
.code-block__head {
    display: flex;
    align-items: center;
    justify-content: space-between;
    padding: var(--s-2) var(--s-4);
    background: rgba(255,255,255,0.04);
    border-bottom: 1px solid rgba(255,255,255,0.08);
}
.code-block__label {
    font-size: var(--t-xs);
    font-weight: 600;
    letter-spacing: 0.03em;
    color: rgba(255,255,255,0.55);
    font-family: ui-monospace, monospace;
}
.code-copy {
    display: inline-flex;
    align-items: center;
    gap: 6px;
    border: none;
    background: transparent;
    color: rgba(255,255,255,0.6);
    font-size: var(--t-xs);
    font-family: inherit;
    cursor: pointer;
    padding: 4px 8px;
    border-radius: var(--r-xs);
    transition: color var(--d-fast), background-color var(--d-fast);
}
.code-copy:hover { color: #fff; background: rgba(255,255,255,0.08); }
.code-block pre {
    margin: 0;
    padding: var(--s-4) var(--s-5);
    overflow-x: auto;
}
.code-block code {
    font-family: ui-monospace, 'SF Mono', SFMono-Regular, Menlo, Consolas, monospace;
    font-size: 0.82rem;
    line-height: 1.65;
    color: #E6EDF6;
    white-space: pre;
}
.code-block .tok-com { color: #7E8AA0; }      /* comment */
.code-block .tok-str { color: #8DD6A0; }      /* string  */
.code-block .tok-kw  { color: #FF8590; }      /* keyword */
.code-block .tok-fn  { color: #7DA3E8; }      /* function/flag */

/* ---- Callouts ---- */
.callout {
    display: flex;
    gap: var(--s-3);
    margin: 0 0 var(--s-6);
    padding: var(--s-4) var(--s-5);
    border-radius: var(--r-md);
    border: 1px solid var(--border);
    background: var(--bg-soft);
}
.callout__icon { flex-shrink: 0; margin-top: 2px; }
.callout__body { font-size: var(--t-sm); line-height: 1.6; }
.callout__body p { margin: 0 0 var(--s-2); }
.callout__body p:last-child { margin-bottom: 0; }
.callout__title { font-weight: 600; color: var(--text-strong); display: block; margin-bottom: var(--s-1); }

.callout--info    { border-color: rgba(26,63,138,0.25);  background: var(--navy-soft); }
.callout--info    .callout__icon { color: var(--navy); }
.callout--warn    { border-color: rgba(214,153,42,0.30); background: rgba(214,153,42,0.08); }
.callout--warn    .callout__icon { color: #C8881F; }
.callout--danger  { border-color: rgba(213,42,61,0.30);  background: var(--accent-soft); }
.callout--danger  .callout__icon { color: var(--accent); }
.callout--success { border-color: rgba(34,150,83,0.30);  background: rgba(34,150,83,0.08); }
.callout--success .callout__icon { color: #2A9D5A; }
body.dark-mode .callout--info .callout__icon { color: var(--link); }

/* ---- Step list ---- */
.doc-steps { counter-reset: step; list-style: none; margin: 0; padding: 0; }
.doc-steps > li {
    position: relative;
    padding-left: var(--s-12);
    margin-bottom: var(--s-8);
}
.doc-steps > li::before {
    counter-increment: step;
    content: counter(step);
    position: absolute;
    left: 0; top: -2px;
    width: 32px; height: 32px;
    display: grid; place-items: center;
    border-radius: var(--r-pill);
    background: var(--accent);
    color: #fff;
    font-size: var(--t-sm);
    font-weight: 600;
}

/* ---- Tables ---- */
.doc-table-wrap { overflow-x: auto; margin: 0 0 var(--s-6); }
.doc-table {
    width: 100%;
    border-collapse: collapse;
    font-size: var(--t-sm);
    min-width: 520px;
}
.doc-table th, .doc-table td {
    text-align: left;
    padding: var(--s-3) var(--s-4);
    border-bottom: 1px solid var(--border);
    vertical-align: top;
}
.doc-table th {
    font-weight: 600;
    color: var(--text-strong);
    background: var(--bg-soft);
}
.doc-table td code { white-space: nowrap; }

/* ---- Doc hero ---- */
.doc-hero { padding-top: var(--s-12); }
.doc-hero .eyebrow { margin-bottom: var(--s-4); }
.doc-hero h1 { font-size: var(--t-4xl); letter-spacing: -0.03em; margin-bottom: var(--s-4); }
.doc-hero .lede { margin-bottom: var(--s-6); }
.doc-meta {
    display: flex;
    flex-wrap: wrap;
    gap: var(--s-3);
    font-size: var(--t-sm);
    color: var(--text-muted);
}
.doc-meta span {
    display: inline-flex;
    align-items: center;
    gap: 6px;
    padding: 4px 12px;
    border-radius: var(--r-pill);
    background: var(--bg-soft);
    border: 1px solid var(--border);
}