/* Documentation hub & article layout */

.docs-shell {
    padding-bottom: var(--space-16);
}

/* Top search bar */
.docs-topbar {
    background: var(--color-surface);
    border-bottom: 1px solid var(--color-border);
    padding-block: var(--space-4);
    position: sticky;
    top: var(--header-height, 72px);
    z-index: 40;
}

.docs-topbar__inner {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    justify-content: space-between;
    gap: var(--space-4);
}

.docs-topbar .breadcrumbs {
    margin: 0;
}

.docs-search {
    position: relative;
    flex: 1;
    max-width: 28rem;
    min-width: 200px;
}

.docs-search--bar {
    margin-left: auto;
}

.docs-search__input {
    width: 100%;
    padding: var(--space-3) var(--space-4);
    font-size: 0.9375rem;
    border: 1px solid var(--color-border-strong);
    border-radius: var(--radius-lg);
    background: var(--color-bg);
}

.docs-search__input:focus {
    outline: none;
    border-color: var(--color-primary);
    box-shadow: 0 0 0 3px rgb(3 40 106 / 0.12);
}

.docs-search__results {
    position: absolute;
    top: calc(100% + var(--space-2));
    left: 0;
    right: 0;
    max-height: 320px;
    overflow-y: auto;
    background: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    box-shadow: var(--shadow-lg);
    z-index: 50;
}

.docs-search__result {
    display: block;
    padding: var(--space-3) var(--space-4);
    text-decoration: none;
    color: inherit;
    border-bottom: 1px solid var(--color-border);
}

.docs-search__result:last-child {
    border-bottom: none;
}

.docs-search__result:hover,
.docs-search__result.is-active {
    background: var(--color-primary-light);
}

.docs-search__result-title {
    display: block;
    font-weight: 600;
    font-size: 0.875rem;
}

.docs-search__result-meta {
    display: block;
    font-size: 0.75rem;
    color: var(--color-text-muted);
    margin-top: var(--space-1);
}

.docs-search__empty {
    padding: var(--space-4);
    font-size: 0.875rem;
    color: var(--color-text-muted);
}

/* Mobile drawer toggle */
.docs-drawer-toggle {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    width: 100%;
    margin-bottom: var(--space-4);
    padding: var(--space-3) var(--space-4);
    font-size: 0.9375rem;
    font-weight: 500;
    background: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    cursor: pointer;
}

@media (min-width: 1024px) {
    .docs-drawer-toggle {
        display: none;
    }
}

/* Three-column layout */
.doc-layout {
    display: grid;
    gap: var(--space-8);
    padding-block: var(--space-6) var(--space-10);
}

@media (min-width: 1024px) {
    .doc-layout {
        grid-template-columns: var(--doc-sidebar-width) 1fr;
        gap: var(--space-10);
        align-items: start;
    }
}

.doc-layout__main {
    display: grid;
    gap: var(--space-8);
    min-width: 0;
}

@media (min-width: 1280px) {
    .doc-layout__main {
        grid-template-columns: 1fr 13rem;
        gap: var(--space-10);
    }
}

/* Sidebar / mobile drawer */
.doc-layout__sidebar {
    position: relative;
}

@media (min-width: 1024px) {
    .doc-layout__sidebar {
        position: sticky;
        top: calc(var(--header-height, 72px) + 4.5rem);
        max-height: calc(100vh - var(--header-height, 72px) - 6rem);
        overflow-y: auto;
    }

    .doc-drawer__backdrop,
    .doc-drawer__header {
        display: none;
    }

    .doc-drawer__panel {
        display: block;
    }
}

@media (max-width: 1023px) {
    .doc-drawer__backdrop {
        position: fixed;
        inset: 0;
        background: rgb(2 22 58 / 0.5);
        z-index: 90;
    }

    .doc-drawer__panel {
        position: fixed;
        top: 0;
        left: 0;
        bottom: 0;
        width: min(320px, 88vw);
        background: var(--color-surface);
        z-index: 100;
        overflow-y: auto;
        transform: translateX(-100%);
        transition: transform 0.25s ease;
        box-shadow: var(--shadow-xl);
    }

    .doc-layout__sidebar.is-open .doc-drawer__panel {
        transform: translateX(0);
    }

    .doc-drawer__header {
        display: flex;
        align-items: center;
        justify-content: space-between;
        padding: var(--space-4) var(--space-5);
        border-bottom: 1px solid var(--color-border);
    }

    .doc-drawer__title {
        font-weight: 600;
    }

    .doc-drawer__close {
        font-size: 1.5rem;
        line-height: 1;
        background: none;
        border: none;
        cursor: pointer;
        color: var(--color-text-muted);
    }

    .doc-sidebar {
        padding: var(--space-4);
    }
}

.doc-sidebar__section {
    font-size: 0.6875rem;
    font-weight: 600;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    color: var(--color-text-subtle);
    margin: var(--space-5) 0 var(--space-2);
}

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

.doc-sidebar__link {
    display: block;
    padding: var(--space-2) var(--space-3);
    font-size: 0.875rem;
    color: var(--color-text-muted);
    text-decoration: none;
    border-radius: var(--radius-sm);
    border-left: 2px solid transparent;
}

.doc-sidebar__link:hover {
    color: var(--color-text);
    background: var(--color-bg);
}

.doc-sidebar__link.is-active {
    color: var(--color-primary);
    background: var(--color-primary-light);
    border-left-color: var(--color-primary);
    font-weight: 500;
}

/* Article */
.doc-layout__content {
    min-width: 0;
}

.doc-layout__title {
    font-size: clamp(1.75rem, 3vw, 2.25rem);
    font-weight: 700;
    letter-spacing: -0.02em;
    margin-bottom: var(--space-3);
}

.doc-layout__summary {
    font-size: 1.0625rem;
    line-height: 1.65;
    color: var(--color-text-muted);
    margin-bottom: var(--space-4);
}

.doc-layout__updated {
    font-size: 0.8125rem;
    color: var(--color-text-subtle);
    margin-bottom: var(--space-8);
}

/* Right TOC */
.doc-layout__toc {
    display: none;
}

@media (min-width: 1280px) {
    .doc-layout__toc {
        display: block;
        position: sticky;
        top: calc(var(--header-height, 72px) + 4.5rem);
        max-height: calc(100vh - var(--header-height, 72px) - 6rem);
        overflow-y: auto;
    }
}

.doc-toc__heading {
    font-size: 0.6875rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.06em;
    color: var(--color-text-subtle);
    margin-bottom: var(--space-3);
}

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

.doc-toc__item a {
    display: block;
    padding: var(--space-2) var(--space-3);
    font-size: 0.8125rem;
    color: var(--color-text-muted);
    text-decoration: none;
    border-left: 2px solid transparent;
    margin-left: -1px;
}

.doc-toc__item a:hover,
.doc-toc__item a.is-active {
    color: var(--color-primary);
    border-left-color: var(--color-primary);
}

.doc-toc__item--level-3 a {
    padding-left: var(--space-5);
    font-size: 0.75rem;
}

/* Doc media figures */
.doc-figure {
    margin: var(--space-8) 0;
    border: 1px solid var(--color-border);
    border-radius: var(--radius-xl);
    overflow: hidden;
    background: var(--color-surface);
    box-shadow: var(--shadow-sm);
}

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

.doc-figure--crop img {
    max-height: none;
    object-fit: contain;
    object-position: top center;
}

.doc-figure--crop figcaption::before {
    content: 'Screenshot - ';
    color: var(--color-text-subtle);
}

.doc-figure--video img {
    width: 100%;
    height: auto;
    object-fit: contain;
    object-position: center;
}

.doc-figure--annotated {
    position: relative;
}

.doc-figure figcaption {
    padding: var(--space-3) var(--space-4);
    font-size: 0.8125rem;
    color: var(--color-text-muted);
    border-top: 1px solid var(--color-border);
    line-height: 1.5;
}

/* Related articles */
.doc-related {
    margin-top: var(--space-10);
    padding: var(--space-6);
    background: var(--color-bg);
    border-radius: var(--radius-lg);
    border: 1px solid var(--color-border);
}

.doc-related__title {
    font-size: 0.875rem;
    font-weight: 600;
    margin-bottom: var(--space-3);
}

.doc-related__list {
    list-style: none;
    padding: 0;
    margin: 0;
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-2) var(--space-4);
}

.doc-related__list a {
    font-size: 0.875rem;
    color: var(--color-primary);
    font-weight: 500;
}

/* Pager */
.doc-layout__pager {
    display: grid;
    gap: var(--space-4);
    margin-top: var(--space-10);
    padding-top: var(--space-8);
    border-top: 1px solid var(--color-border);
}

@media (min-width: 768px) {
    .doc-layout__pager {
        grid-template-columns: 1fr 1fr;
    }
}

.doc-layout__pager-link {
    display: block;
    padding: var(--space-5);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    text-decoration: none;
    transition: border-color 0.2s;
}

.doc-layout__pager-link:hover {
    border-color: var(--color-primary);
}

.doc-layout__pager-link--next {
    text-align: right;
}

.doc-layout__pager-label {
    display: block;
    font-size: 0.75rem;
    color: var(--color-text-subtle);
    margin-bottom: var(--space-1);
}

.doc-layout__pager-title {
    font-weight: 500;
    color: var(--color-text);
}

/* ── Docs hub ── */
.docs-hub-hero {
    background: var(--gradient-hero);
    color: var(--color-text-inverse);
    padding-block: clamp(2.5rem, 6vw, 4rem);
}

.docs-hub-hero .breadcrumbs a,
.docs-hub-hero .breadcrumbs span {
    color: rgb(242 244 247 / 0.72);
}

.docs-hub-hero__title {
    font-size: clamp(2rem, 4vw, 2.75rem);
    font-weight: 700;
    margin-bottom: var(--space-4);
    color: #fff;
}

.docs-hub-hero__desc {
    font-size: 1.0625rem;
    color: rgb(242 244 247 / 0.78);
    max-width: 52ch;
    margin-bottom: var(--space-8);
}

.docs-hub-hero .docs-search__input {
    background: var(--color-surface);
    max-width: 32rem;
}

.docs-hub-featured {
    display: grid;
    gap: var(--space-8);
    margin-bottom: var(--space-12);
}

@media (min-width: 960px) {
    .docs-hub-featured {
        grid-template-columns: 1fr 1.1fr;
        align-items: start;
    }
}

.docs-hub-start {
    padding: var(--space-8);
    background: var(--color-primary-light);
    border: 1px solid rgb(3 40 106 / 0.2);
    border-radius: var(--radius-xl);
}

.docs-hub-start__title {
    font-size: 1.375rem;
    font-weight: 700;
    margin-bottom: var(--space-3);
}

.docs-hub-start__desc {
    color: var(--color-text-muted);
    line-height: 1.6;
    margin-bottom: var(--space-5);
}

.docs-hub-media .doc-figure {
    margin: 0;
}

.docs-hub-popular__title,
.docs-hub-areas__title {
    font-size: 1.125rem;
    font-weight: 700;
    margin-bottom: var(--space-5);
}

.docs-hub-popular__grid {
    display: grid;
    gap: var(--space-3);
}

@media (min-width: 640px) {
    .docs-hub-popular__grid {
        grid-template-columns: repeat(2, 1fr);
    }
}

@media (min-width: 960px) {
    .docs-hub-popular__grid {
        grid-template-columns: repeat(3, 1fr);
    }
}

.docs-hub-popular-card {
    display: block;
    padding: var(--space-4) var(--space-5);
    background: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    text-decoration: none;
    color: inherit;
    transition: border-color 0.2s, box-shadow 0.2s;
}

.docs-hub-popular-card:hover {
    border-color: var(--color-primary-muted);
    box-shadow: var(--shadow-sm);
}

.docs-hub-popular-card__title {
    font-weight: 600;
    font-size: 0.9375rem;
    margin-bottom: var(--space-1);
}

.docs-hub-popular-card__desc {
    font-size: 0.8125rem;
    color: var(--color-text-muted);
}

.docs-hub-areas {
    display: grid;
    gap: var(--space-8);
}

@media (min-width: 768px) {
    .docs-hub-areas {
        grid-template-columns: repeat(2, 1fr);
    }
}

@media (min-width: 1024px) {
    .docs-hub-areas {
        grid-template-columns: repeat(4, 1fr);
    }
}

.docs-hub-area__title {
    font-size: 0.8125rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--color-primary);
    margin-bottom: var(--space-3);
}

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

.docs-hub-area__list li {
    margin-bottom: var(--space-2);
}

.docs-hub-area__list a {
    font-size: 0.875rem;
    font-weight: 500;
    color: var(--color-text);
    text-decoration: none;
}

.docs-hub-area__list a:hover {
    color: var(--color-primary);
}

.docs-hub-area__list span {
    display: block;
    font-size: 0.75rem;
    color: var(--color-text-muted);
    font-weight: 400;
}

.docs-hub-all__grid {
    display: grid;
    gap: var(--space-4);
}

@media (min-width: 768px) {
    .docs-hub-all__grid {
        grid-template-columns: repeat(2, 1fr);
    }
}

@media (min-width: 1280px) {
    .docs-hub-all__grid {
        grid-template-columns: repeat(3, 1fr);
    }
}

.docs-card {
    padding: var(--space-5);
    background: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    text-decoration: none;
    color: inherit;
    transition: box-shadow 0.2s, border-color 0.2s;
}

.docs-card:hover {
    box-shadow: var(--shadow-md);
    border-color: var(--color-primary-muted);
}

.docs-card__category {
    font-size: 0.6875rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--color-text-subtle);
    margin-bottom: var(--space-2);
}

.docs-card__title {
    font-size: 1rem;
    font-weight: 600;
    margin-bottom: var(--space-2);
}

.docs-card__description {
    font-size: 0.875rem;
    color: var(--color-text-muted);
    margin: 0;
    line-height: 1.5;
}

.docs-card[hidden] {
    display: none;
}