/* =====================================================================
 * /docs — product user guide.
 *
 * Layout archetype: server/docs/DESIGN.md §8.2 long-form. The page opts
 * out of the centered #wrapper-contents shell (flex + float would lean
 * the grid right — same trap documented in about.css) and renders a
 * three-column doc layout: sidebar · article · on-this-page TOC.
 *
 * Design rules enforced here:
 *   • One typeface — Pretendard inherited from :root. No @font-face.
 *   • No brand iridescence in chrome. Interaction states use the
 *     neutral state tokens (§2.5); links use --global-primary-color.
 *     Status badges (beta · soon) are a neutral two-tier tint of the
 *     text color — beta reads stronger (live), soon muted (future) —
 *     never an off-palette brand hue (DESIGN.md §0 principle 5).
 *   • Eyebrow spec §3.4 (13px · 500 · 0.16em · uppercase · muted).
 *   • Korean never breaks mid-word — `word-break: keep-all` on the root.
 *   • Single 640px chrome breakpoint; sidebar collapses to a drawer at
 *     768px (the long-form pages already use 768 for their inner grid).
 * ===================================================================== */

/* ---------- Shell opt-out (mirror about.css) ------------------------- */
#wrapper-contents:has(.docs-page) {
    padding: 0;
    margin: 0;
    display: block;
    float: none;
    align-items: initial;
    justify-content: initial;
    background-color: var(--global-body-background);
    overflow-x: clip;
}

.docs-page {
    --docs-sidebar-w: 248px;
    --docs-toc-w: 200px;
    --docs-gap: clamp(28px, 4vw, 64px);
    --docs-pad-x: clamp(20px, 5vw, 80px);
    --docs-pad-y: clamp(40px, 8vh, 88px);
    --docs-ease: cubic-bezier(0.22, 0.61, 0.36, 1);

    display: block;
    width: 100%;
    color: var(--global-text-color);
    word-break: keep-all;
    overflow-wrap: anywhere;
}

/* ---------- Three-column grid --------------------------------------- */
.docs-shell {
    width: calc(100% - var(--docs-pad-x) * 2);
    max-width: 1240px;
    margin: 0 auto;
    padding: var(--docs-pad-y) 0 clamp(64px, 12vh, 140px);
    display: grid;
    grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr);
    gap: var(--docs-gap);
    align-items: start;
}

@media (min-width: 1100px) {
    .docs-shell {
        grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr) var(--docs-toc-w);
    }
}

/* ---------- Eyebrow atom (shared) ----------------------------------- */
.docs-sidebar-eyebrow,
.docs-article-eyebrow {
    margin: 0;
    font-size: 13px;
    font-weight: 500;
    letter-spacing: 0.16em;
    text-transform: uppercase;
    color: var(--global-text-muted);
    line-height: 1;
}

/* ---------- 01 · Sidebar -------------------------------------------- */
.docs-sidebar {
    position: sticky;
    top: calc(55px + 24px); /* header height + breathing room */
    align-self: start;
    max-height: calc(100vh - 55px - 32px);
    overflow-y: auto;
    padding-right: 8px;
}

.docs-sidebar-eyebrow {
    margin-bottom: 18px;
    padding-left: 12px;
}

.docs-nav-group + .docs-nav-group {
    margin-top: 22px;
}

.docs-nav-group-title {
    margin: 0 0 8px;
    padding-left: 12px;
    font-size: 12px;
    font-weight: 600;
    letter-spacing: 0.04em;
    color: var(--global-text-muted);
}

.docs-nav-list {
    list-style: none;
    margin: 0;
    padding: 0;
}

.docs-nav-link {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 8px;
    padding: 8px 12px;
    border-radius: 8px;
    font-size: 14px;
    font-weight: 500;
    line-height: 1.4;
    color: var(--global-text-muted);
    text-decoration: none;
    transition: background-color 0.18s var(--docs-ease),
                color 0.18s var(--docs-ease);
}

.docs-nav-link:hover {
    background-color: var(--state-hover-bg);
    color: var(--global-text-color);
}

.docs-nav-link.is-active {
    background-color: var(--state-selected-bg);
    color: var(--global-text-color);
    font-weight: 600;
}

.docs-nav-link:focus-visible {
    outline: 2px solid var(--focus-outline-color);
    outline-offset: 2px;
}

/* ---------- Lifecycle badges ---------------------------------------- */
.docs-badge {
    flex: none;
    display: inline-flex;
    align-items: center;
    padding: 2px 7px;
    border-radius: 999px;
    font-size: 10px;
    font-weight: 600;
    letter-spacing: 0.04em;
    text-transform: uppercase;
    line-height: 1.4;
    border: 1px solid transparent;
}

.docs-badge.is-inline {
    margin-left: 10px;
    vertical-align: middle;
    font-size: 11px;
}

.docs-badge-beta {
    color: var(--global-text-color);
    background-color: rgba(var(--global-text-color-rgb), 0.06);
    border-color: rgba(var(--global-text-color-rgb), 0.16);
}

.docs-badge-soon {
    color: var(--global-text-muted);
    background-color: rgba(var(--global-text-color-rgb), 0.04);
    border-color: rgba(var(--global-text-color-rgb), 0.12);
}

/* ---------- 02 · Article -------------------------------------------- */
.docs-article {
    min-width: 0;
    max-width: 760px;
}

.docs-article-head {
    margin-bottom: clamp(28px, 4vh, 44px);
    padding-bottom: clamp(24px, 3vh, 36px);
    border-bottom: 1px solid var(--global-border-color);
}

.docs-article-eyebrow {
    margin-bottom: 14px;
}

.docs-article-title {
    margin: 0 0 16px;
    font-size: clamp(30px, 4.6vw, 46px);
    font-weight: 800;
    letter-spacing: -0.03em;
    line-height: 1.1;
}

.docs-article-lede {
    margin: 0;
    font-size: clamp(16px, 1.6vw, 19px);
    line-height: 1.6;
    color: var(--global-text-muted);
}

/* ---------- Article content atoms ----------------------------------- */
.doc-section {
    margin-top: clamp(32px, 5vh, 52px);
}

.doc-section:first-child {
    margin-top: 0;
}

.doc-h2 {
    margin: 0 0 16px;
    font-size: clamp(21px, 2.4vw, 27px);
    font-weight: 700;
    letter-spacing: -0.02em;
    line-height: 1.25;
    scroll-margin-top: 88px;
}

.doc-subhead {
    margin: 28px 0 12px;
    font-size: 14px;
    font-weight: 600;
    letter-spacing: 0.01em;
    color: var(--global-text-color);
}

.doc-p {
    margin: 0 0 16px;
    font-size: clamp(15px, 1.3vw, 16px);
    line-height: 1.72;
    color: var(--global-text-color);
}

.doc-list {
    margin: 0 0 16px;
    padding-left: 22px;
}

.doc-list li {
    margin-bottom: 8px;
    font-size: clamp(15px, 1.3vw, 16px);
    line-height: 1.68;
}

/* ---------- Numbered steps ------------------------------------------ */
.doc-steps {
    list-style: none;
    margin: 0;
    padding: 0;
    counter-reset: none;
}

.doc-step {
    display: flex;
    gap: 16px;
    padding: 16px 0;
    border-top: 1px solid var(--global-border-color);
}

.doc-step:last-child {
    border-bottom: 1px solid var(--global-border-color);
}

.doc-step-num {
    flex: none;
    display: grid;
    place-items: center;
    width: 28px;
    height: 28px;
    border-radius: 999px;
    background-color: var(--global-text-color);
    color: var(--global-button-text-color);
    font-size: 13px;
    font-weight: 600;
}

.doc-step-title {
    margin: 2px 0 4px;
    font-size: 16px;
    font-weight: 600;
    letter-spacing: -0.01em;
}

.doc-step-desc {
    margin: 0;
    font-size: 14px;
    line-height: 1.6;
    color: var(--global-text-muted);
}

/* ---------- Definition list ----------------------------------------- */
.doc-deflist {
    margin: 0;
}

.doc-deflist-row {
    padding: 16px 0;
    border-top: 1px solid var(--global-border-color);
    display: grid;
    grid-template-columns: minmax(120px, 200px) 1fr;
    gap: 20px;
}

.doc-deflist-row:last-child {
    border-bottom: 1px solid var(--global-border-color);
}

.doc-deflist-term {
    margin: 0;
    font-size: 15px;
    font-weight: 600;
    letter-spacing: -0.01em;
}

.doc-deflist-desc {
    margin: 0;
    font-size: 14px;
    line-height: 1.6;
    color: var(--global-text-muted);
}

@media (max-width: 640px) {
    .doc-deflist-row {
        grid-template-columns: 1fr;
        gap: 6px;
    }
}

/* ---------- Card grid ----------------------------------------------- */
.doc-card-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
    gap: 14px;
    margin: 4px 0 8px;
}

.doc-card {
    position: relative;
    display: flex;
    flex-direction: column;
    gap: 8px;
    padding: 18px;
    border-radius: 14px;
    background-color: var(--global-card-background);
    border: 1px solid var(--global-border-color);
    text-decoration: none;
    color: inherit;
    transition: transform 0.3s var(--docs-ease),
                border-color 0.18s var(--docs-ease);
}

a.doc-card:hover {
    transform: translateY(-2px);
    border-color: rgba(var(--global-text-color-rgb), 0.22);
}

a.doc-card:focus-visible {
    outline: 2px solid var(--focus-outline-color);
    outline-offset: 2px;
}

.doc-card.is-muted {
    opacity: 0.72;
}

.doc-card-head {
    display: flex;
    align-items: center;
    gap: 8px;
}

.doc-card-title {
    font-size: 15px;
    font-weight: 600;
    letter-spacing: -0.01em;
}

.doc-card-desc {
    font-size: 13.5px;
    line-height: 1.55;
    color: var(--global-text-muted);
}

.doc-card-arrow {
    margin-top: 2px;
    font-size: 15px;
    color: var(--global-text-muted);
    transition: transform 0.3s var(--docs-ease);
}

a.doc-card:hover .doc-card-arrow {
    transform: translateX(3px);
    color: var(--global-text-color);
}

/* ---------- Chips ---------------------------------------------------- */
.doc-chips {
    list-style: none;
    display: flex;
    flex-wrap: wrap;
    gap: 8px;
    margin: 0 0 8px;
    padding: 0;
}

.doc-chip {
    padding: 6px 12px;
    border-radius: 999px;
    font-size: 13px;
    font-weight: 500;
    color: var(--global-text-color);
    background-color: rgba(var(--global-text-color-rgb), 0.04);
    border: 1px solid var(--global-border-color);
}

/* ---------- Keyboard key -------------------------------------------- */
.doc-kbd {
    display: inline-block;
    padding: 2px 8px;
    border-radius: 6px;
    font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
    font-size: 12.5px;
    font-weight: 500;
    line-height: 1.5;
    color: var(--global-text-color);
    background-color: rgba(var(--global-text-color-rgb), 0.05);
    border: 1px solid var(--global-border-color);
    border-bottom-width: 2px;
    white-space: nowrap;
}

/* ---------- Tool list ----------------------------------------------- */
.doc-tool-list {
    list-style: none;
    margin: 0;
    padding: 0;
}

.doc-tool {
    padding: 16px 0;
    border-top: 1px solid var(--global-border-color);
}

.doc-tool:last-child {
    border-bottom: 1px solid var(--global-border-color);
}

.doc-tool-main {
    display: flex;
    align-items: center;
    gap: 10px;
    margin-bottom: 4px;
}

.doc-tool-name {
    font-size: 15px;
    font-weight: 600;
    letter-spacing: -0.01em;
}

.doc-tool-desc {
    margin: 0;
    font-size: 14px;
    line-height: 1.6;
    color: var(--global-text-muted);
}

/* ---------- Table --------------------------------------------------- */
.doc-table {
    width: 100%;
    border-collapse: collapse;
    margin: 4px 0 12px;
    font-size: 14px;
}

.doc-table th,
.doc-table td {
    padding: 11px 14px;
    text-align: left;
    border-bottom: 1px solid var(--global-border-color);
    vertical-align: middle;
}

.doc-table th {
    font-weight: 600;
    color: var(--global-text-muted);
    font-size: 12px;
    letter-spacing: 0.04em;
    text-transform: uppercase;
}

.doc-table tbody tr:hover {
    background-color: var(--state-hover-bg);
}

/* ---------- Callouts ------------------------------------------------- */
.doc-callout {
    margin: 18px 0 8px;
    padding: 14px 16px;
    border-radius: 12px;
    font-size: 14px;
    line-height: 1.6;
    background-color: rgba(var(--global-text-color-rgb), 0.03);
    border: 1px solid var(--global-border-color);
    border-left-width: 3px;
}

.doc-callout-tip {
    border-left-color: var(--global-success-color);
}

.doc-callout-note {
    border-left-color: var(--global-primary-color);
}

.doc-callout-label {
    display: inline-block;
    margin-right: 8px;
    font-size: 11px;
    font-weight: 700;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--global-text-muted);
}

/* ---------- Coming-soon / Beta banner ------------------------------- */
.doc-soon-banner {
    display: flex;
    align-items: center;
    gap: 14px;
    padding: 18px 20px;
    margin-bottom: 20px;
    border-radius: 14px;
    background-color: var(--global-card-background);
    border: 1px solid var(--global-border-color);
}

.doc-soon-banner .docs-badge.is-inline {
    margin-left: 0;
}

.doc-soon-text {
    margin: 0;
    font-size: 14px;
    line-height: 1.55;
    color: var(--global-text-muted);
}

/* ---------- CTA inline link ----------------------------------------- */
.doc-cta-link {
    display: inline-flex;
    align-items: center;
    gap: 8px;
    margin-top: 4px;
    font-size: 15px;
    font-weight: 600;
    color: var(--global-primary-color);
    text-decoration: none;
}

.doc-cta-link:hover {
    text-decoration: underline;
}

.doc-cta-link span {
    transition: transform 0.3s var(--docs-ease);
}

.doc-cta-link:hover span {
    transform: translateX(3px);
}

/* ---------- Prev / next paging -------------------------------------- */
.docs-paging {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 14px;
    margin-top: clamp(48px, 8vh, 80px);
    padding-top: clamp(24px, 3vh, 36px);
    border-top: 1px solid var(--global-border-color);
}

.docs-paging-link {
    display: flex;
    flex-direction: column;
    gap: 4px;
    padding: 16px 18px;
    border-radius: 14px;
    border: 1px solid var(--global-border-color);
    background-color: var(--global-card-background);
    text-decoration: none;
    color: inherit;
    transition: border-color 0.18s var(--docs-ease),
                transform 0.3s var(--docs-ease);
}

.docs-paging-link:hover {
    border-color: rgba(var(--global-text-color-rgb), 0.22);
    transform: translateY(-2px);
}

.docs-paging-link.is-next {
    text-align: right;
}

.docs-paging-dir {
    font-size: 12px;
    font-weight: 500;
    letter-spacing: 0.04em;
    color: var(--global-text-muted);
}

.docs-paging-title {
    font-size: 15px;
    font-weight: 600;
    letter-spacing: -0.01em;
}

/* ---------- 04 · On-this-page TOC ----------------------------------- */
.docs-toc {
    position: sticky;
    top: calc(55px + 24px);
    align-self: start;
    display: none;
}

@media (min-width: 1100px) {
    .docs-toc.has-items {
        display: block;
    }
}

.docs-toc-title {
    margin: 0 0 12px;
    font-size: 12px;
    font-weight: 600;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--global-text-muted);
}

.docs-toc-list {
    list-style: none;
    margin: 0;
    padding: 0;
    border-left: 1px solid var(--global-border-color);
}

.docs-toc-list a {
    display: block;
    padding: 5px 14px;
    margin-left: -1px;
    border-left: 1px solid transparent;
    font-size: 13px;
    line-height: 1.4;
    color: var(--global-text-muted);
    text-decoration: none;
    transition: color 0.18s var(--docs-ease),
                border-color 0.18s var(--docs-ease);
}

.docs-toc-list a:hover {
    color: var(--global-text-color);
}

.docs-toc-list a.is-active {
    color: var(--global-text-color);
    border-left-color: var(--global-text-color);
    font-weight: 500;
}

/* ---------- Mobile sidebar drawer ----------------------------------- */
.docs-nav-toggle {
    display: none;
    align-items: center;
    gap: 8px;
    margin: 16px var(--docs-pad-x) 0;
    padding: 10px 16px;
    border-radius: 999px;
    border: 1px solid var(--global-border-color);
    background-color: var(--global-card-background);
    color: var(--global-text-color);
    font-size: 14px;
    font-weight: 600;
    cursor: pointer;
}

@media (max-width: 768px) {
    .docs-shell {
        grid-template-columns: minmax(0, 1fr);
    }

    .docs-nav-toggle {
        display: inline-flex;
        /* The docs page opts out of the standard #wrapper-contents header
         * offset (see :has(.docs-page) reset above), so this toggle — which
         * sits above .docs-shell — would tuck under the fixed 55px header.
         * Clear the header here; the announcement banner is already handled
         * by body.has-announcement's padding-top on <body>. */
        margin-top: calc(var(--header-height) + 16px);
    }

    .docs-sidebar {
        position: static;
        max-height: none;
        overflow: visible;
        margin-bottom: 8px;
        padding: 16px;
        border-radius: 14px;
        background-color: var(--global-card-background);
        border: 1px solid var(--global-border-color);
        display: none;
    }

    .docs-sidebar.is-open {
        display: block;
    }

    .docs-article {
        max-width: none;
    }
}

/* ---------- Figures (real screenshots) ------------------------------ */
.doc-figure {
    margin: 8px 0 4px;
    padding: 0;
}

.doc-figure-frame {
    margin: 0;
    border-radius: 14px;
    overflow: hidden;
    border: 1px solid var(--global-border-color);
    background-color: var(--global-card-background);
    line-height: 0;
}

.doc-figure-img {
    display: block;
    width: 100%;
    height: auto;
}

.doc-figure.is-inset .doc-figure-frame {
    padding: 14px 16px;
    background-color: rgba(var(--global-text-color-rgb), 0.03);
}

.doc-figure-caption {
    margin: 10px 2px 0;
    font-size: 13px;
    line-height: 1.55;
    color: var(--global-text-muted);
    text-align: center;
}