/* ==========================================================================
   Page Body Adjustments
   ========================================================================== */

body.docs-page {
    /* Remove any default margins that might interfere */
}

body.docs-page main {
    display: flex;
    flex-direction: column;
}


/* ==========================================================================
   Main Layout Structure
   ========================================================================== */

.docs-wrapper {
    display: flex;
    min-height: calc(100vh - var(--docs-header-height));
    background-color: var(--white);
}


/* ==========================================================================
   Left Sidebar - Site Navigation
   ========================================================================== */

.docs-sidebar-left {
    display: flex;
    flex-direction: column;
    transition: width var(--docs-transition-speed) var(--docs-transition-timing),
                min-width var(--docs-transition-speed) var(--docs-transition-timing);
    overflow: hidden;
}

.docs-sidebar-left-expanded {
    display: flex;
    flex-direction: column;
    flex: 1;
    overflow: hidden;
    opacity: 1;
    transition: opacity var(--docs-transition-speed) var(--docs-transition-timing);
}

.docs-sidebar-left.collapsed .docs-sidebar-left-expanded {
    opacity: 0;
    pointer-events: none;
}

.docs-sidebar-left-collapsed {
    position: absolute;
    top: 50%;
    left: 50%;
    transform: translate(-50%, -50%) rotate(-90deg);
    white-space: nowrap;
    opacity: 0;
    pointer-events: none;
    transition: opacity var(--docs-transition-speed) var(--docs-transition-timing);
}

.docs-sidebar-left.collapsed .docs-sidebar-left-collapsed {
    opacity: 1;
}

.docs-sidebar-collapsed-text {
    font-size: var(--docs-font-size-xs);
    font-weight: 600;
    letter-spacing: 0.1em;
    color: var(--grey-black);
    text-transform: uppercase;
}


/* Sidebar Header with Search */
.docs-sidebar-header {
    padding: var(--docs-spacing-md);
    border-bottom: 1px solid var(--light-grey);
}

.docs-sidebar-search .form-control {
    font-size: var(--docs-font-size-sm);
    padding: var(--docs-spacing-sm) var(--docs-spacing-md);
    border-radius: 4px;
    border: 1px solid var(--light-grey);
    background-color: var(--grey-white);
}

.docs-sidebar-search .form-control:focus {
    background-color: var(--white);
    border-color: var(--blue);
    box-shadow: 0 0 0 2px var(--pale-blue);
}


/* Site Navigation Tree */
.docs-site-navigation {
    flex: 1;
    overflow-y: auto;
    overflow-x: hidden;
    padding: var(--docs-spacing-sm) 0;
}

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

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

.docs-nav-node {
    display: flex;
    align-items: center;
    padding: var(--docs-spacing-xs) var(--docs-spacing-md);
    padding-left: var(--docs-spacing-sm);
}

.docs-nav-toggle {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 20px;
    height: 20px;
    flex-shrink: 0;
    padding: 0;
    margin-right: var(--docs-spacing-xs);
    background: transparent;
    border: none;
    cursor: pointer;
    border-radius: 3px;
    color: var(--grey-black);
    transition: background-color var(--docs-transition-speed) ease;
}

.docs-nav-toggle:hover {
    background-color: var(--grey-white);
    color: var(--grey-black);
}

.docs-nav-toggle .docs-nav-icon {
    font-size: 10px;
    transition: transform 0.2s ease;
}

.docs-nav-toggle.expanded .docs-nav-icon {
    transform: rotate(90deg);
}

.docs-nav-toggle-spacer {
    width: 20px;
    height: 20px;
    flex-shrink: 0;
    margin-right: var(--docs-spacing-xs);
}

.docs-nav-link {
    font-size: var(--docs-font-size-sm);
    color: var(--grey-black);
    text-decoration: none;
    padding: var(--docs-spacing-xs) var(--docs-spacing-sm);
    border-radius: 4px;
    border-left: 2px solid transparent;
    transition: background-color 0.15s ease, color 0.15s ease;
    line-height: 1.4;
}

.docs-nav-link:hover {
    background-color: var(--grey-white);
    color: var(--blue);
    text-decoration: none;
}

.docs-nav-link--active {
    background-color: var(--pale-blue);
    color: var(--blue);
    font-weight: 500;
    border-left-color: var(--blue);
}

/* Nested children */
.docs-nav-children {
    list-style: none;
    margin: 0;
    padding: 0 0 0 var(--docs-spacing-lg);
    overflow: hidden;
    max-height: 0;
    transition: max-height var(--docs-transition-speed) var(--docs-transition-timing);
}

.docs-nav-children.expanded {
    max-height: 3000px;
    /* Large enough to fit content , but also affects transition speed when collapsing   */
}

.docs-nav-children.collapsed {
    max-height: 0;
}

/* Deeper nesting indentation */
.docs-nav-children .docs-nav-children {
    padding-left: var(--docs-spacing-md);
}

/* Sitemap last-updated date */
.sitemap-date {
    font-size: var(--docs-font-size-xs);
    color: var(--grey-black);
    margin-left: auto;
    white-space: nowrap;
}


/* ==========================================================================
   Main Content Area
   ========================================================================== */

.docs-content-main {
    flex: 1;
    min-width: 0; /* Prevent flex overflow */
    padding: var(--docs-spacing-lg) var(--docs-spacing-xl);
}

/* Breadcrumb */
.docs-breadcrumb {
    margin-bottom: var(--docs-spacing-md);
}

.docs-breadcrumb .breadcrumb {
    background: transparent;
    padding: 0;
    font-size: var(--docs-font-size-sm);
    margin-bottom: 0;
}

.docs-breadcrumb .breadcrumb-item a {
    color: var(--grey-black);
    text-decoration: none;
}

.docs-breadcrumb .breadcrumb-item a:hover {
    color: var(--blue);
}

.docs-breadcrumb .breadcrumb-item.active {
    color: var(--grey-black);
}

.docs-breadcrumb .breadcrumb-item + .breadcrumb-item::before {
    content: "›";
    color: var(--grey);
}


/* Blockquote */
.docs-content-main blockquote {
    border-left: 4px solid var(--blue);
    margin: 1rem 0;
    padding: 0.75rem 1.25rem;
    color: var(--grey-black);
    background-color: #f8f9fa;
}

/* Text Indentation */
.docs-content-main .indent-1 { padding-left: 2em; }
.docs-content-main .indent-2 { padding-left: 4em; }
.docs-content-main .indent-3 { padding-left: 6em; }

/* Text Sizes */
.docs-content-main .text-size-small { font-size: 0.875rem; }
.docs-content-main .text-size-large { font-size: 1.25rem; }


/* Page Header */
.docs-page-header {
    margin-bottom: var(--docs-spacing-xl);
    padding-bottom: var(--docs-spacing-lg);
    border-bottom: 1px solid var(--light-grey);
}

.docs-page-title {
    font-weight: 600;
    color: var(--dark-blue);
    margin: 0 0 var(--docs-spacing-sm) 0;
    line-height: 1.3;
}

.docs-page-meta {
    display: flex;
    align-items: center;
    gap: var(--docs-spacing-md);
    color: var(--grey-black);
    font-size: var(--docs-font-size-sm);
}

.docs-page-updated i {
    margin-right: var(--docs-spacing-xs);
}


/* Page Content */
.docs-page-content {
    font-size: var(--docs-font-size-base);
    line-height: var(--docs-line-height-base);
    color: var(--grey-black);
}

.docs-page-content h2,
.docs-page-content h3,
.docs-page-content h4,
.docs-page-content h5,
.docs-page-content h6 {
    scroll-margin-top: var(--docs-spacing-lg);
}


/* ==========================================================================
   Right Sidebar - Table of Contents
   ========================================================================== */

.docs-sidebar-right {
    display: flex;
    flex-direction: column;
    transition: width var(--docs-transition-speed) var(--docs-transition-timing),
                min-width var(--docs-transition-speed) var(--docs-transition-timing);
    overflow: hidden;
}

.docs-sidebar-right-expanded {
    display: flex;
    flex-direction: column;
    flex: 1;
    overflow: hidden;
    opacity: 1;
    padding: var(--docs-spacing-lg);
    transition: opacity var(--docs-transition-speed) var(--docs-transition-timing);
}

.docs-sidebar-right.collapsed .docs-sidebar-right-expanded {
    opacity: 0;
    pointer-events: none;
}

.docs-sidebar-right-collapsed {
    position: absolute;
    top: 50%;
    left: 50%;
    transform: translate(-50%, -50%) rotate(90deg);
    white-space: nowrap;
    opacity: 0;
    pointer-events: none;
    transition: opacity var(--docs-transition-speed) var(--docs-transition-timing);
}

.docs-sidebar-right.collapsed .docs-sidebar-right-collapsed {
    opacity: 1;
}


/* ToC Navigation */
.docs-toc-navigation {
    overflow-y: auto;
}

.docs-toc-title {
    padding: var(--docs-spacing-xs) var(--docs-spacing-sm);
    font-size: var(--docs-font-size-xs);
    font-weight: 600;
    letter-spacing: 0.05em;
    color: var(--grey-black);
    text-transform: uppercase;
    margin: 0 0 var(--docs-spacing-md) 0;
}

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

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

.docs-toc-link {
    display: inline-block;
    padding: var(--docs-spacing-xs) var(--docs-spacing-sm);
    font-size: var(--docs-font-size-sm);
    color: var(--grey-black);
    text-decoration: none;
    border-left: 2px solid transparent;
    margin-left: -2px;
    transition: color 0.15s ease, border-color 0.15s ease;
    line-height: 1.4;
}

.docs-toc-link:hover {
    color: var(--blue);
    text-decoration: none;
    background-color: var(--grey-white);
}

.docs-toc-link.active {
    color: var(--blue);
    border-left-color: var(--blue);
    font-weight: 500;
}

/* Nested ToC levels — consistent indentation via nested <ul> padding only */
.docs-toc-list .docs-toc-list {
    padding-left: var(--docs-spacing-md);
}


/* ==========================================================================
   Sidebar Toggle Buttons
   ========================================================================== */

.docs-sidebar-toggle {
    position: absolute;
    top: 6rem;
    transform: translateY(-50%);
    width: var(--docs-toggle-button-size);
    height: var(--docs-toggle-button-size);
    padding: 15px;
    background-color: var(--white);
    border: 1px solid var(--light-grey);
    border-radius: 50%;
    cursor: pointer;
    display: flex;
    align-items: center;
    justify-content: center;
    color: var(--grey-black);
    font-size: 20px;
    transition: background-color 0.15s ease,
                color 0.15s ease,
                box-shadow 0.15s ease;
    z-index: 101;
    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
}

.docs-sidebar-toggle:hover {
    background-color: var(--grey-white);
    color: var(--grey-black);
    box-shadow: 0 2px 6px rgba(0, 0, 0, 0.15);
}

.docs-sidebar-toggle-left {
    right: 2px;
}

.docs-sidebar-toggle-right {
    left: 2px;
}

.docs-sidebar-toggle i {
    line-height: 1;
}


/* ==========================================================================
   Filter Highlight
   ========================================================================== */

.docs-nav-link.filter-match {
    /*this will be changed once we nail down a colour*/
    background-color: #91cfc0;
}

.docs-nav-item.filter-hidden {
    display: none;
}


/* ==========================================================================
   Scrollbar Styling
   ========================================================================== */

.docs-site-navigation::-webkit-scrollbar,
.docs-toc-navigation::-webkit-scrollbar {
    width: 6px;
}

.docs-site-navigation::-webkit-scrollbar-track,
.docs-toc-navigation::-webkit-scrollbar-track {
    background: transparent;
}

.docs-site-navigation::-webkit-scrollbar-thumb,
.docs-toc-navigation::-webkit-scrollbar-thumb {
    background-color: var(--light-grey);
    border-radius: 3px;
}

.docs-site-navigation::-webkit-scrollbar-thumb:hover,
.docs-toc-navigation::-webkit-scrollbar-thumb:hover {
    background-color: var(--grey);
}


/* ==========================================================================
   Responsive Behaviour
   ========================================================================== */

/* Large tablets and below */
@media (max-width: 1200px) {
    :root {
        --docs-sidebar-left-width: 250px;
        --docs-sidebar-right-width: 220px;
    }

    .docs-content-main {
        padding: var(--docs-spacing-md) var(--docs-spacing-lg);
    }
}

/* ==========================================================================
   Desktop overrides for Bootstrap offcanvas-lg
   Bootstrap sets width/height/position/background/border to auto/static/transparent/0
   with !important at >=992px, so we must override with !important.
   ========================================================================== */

@media (min-width: 992px) {
    .docs-sidebar-left.offcanvas-lg {
        position: sticky !important;
        top: 0 !important;
        height: 100vh !important;
        width: var(--docs-sidebar-left-width) !important;
        min-width: var(--docs-sidebar-left-width) !important;
        background-color: var(--white) !important;
        border-right: 1px solid var(--light-grey) !important;
        z-index: 100 !important;
        overflow: hidden !important;
        flex-grow: 0 !important;
        visibility: visible !important;
        transform: none !important;
    }

    .docs-sidebar-left.offcanvas-lg.collapsed {
        width: var(--docs-sidebar-collapsed-width) !important;
        min-width: var(--docs-sidebar-collapsed-width) !important;
    }

    .docs-sidebar-right.offcanvas-lg {
        position: sticky !important;
        top: 0 !important;
        height: 100vh !important;
        width: var(--docs-sidebar-right-width) !important;
        min-width: var(--docs-sidebar-right-width) !important;
        background-color: var(--white) !important;
        border-left: 1px solid var(--light-grey) !important;
        z-index: 100 !important;
        overflow: hidden !important;
        flex-grow: 0 !important;
        visibility: visible !important;
        transform: none !important;
    }

    .docs-sidebar-right.offcanvas-lg.collapsed {
        width: var(--docs-sidebar-collapsed-width) !important;
        min-width: var(--docs-sidebar-collapsed-width) !important;
    }

    .docs-sidebar-left .offcanvas-body,
    .docs-sidebar-right .offcanvas-body {
        display: flex;
        flex-direction: column;
        flex: 1;
        overflow: hidden;
        padding: 0;
    }
}


/* ==========================================================================
   Mobile Offcanvas Overrides (<992px)
   ========================================================================== */

@media (max-width: 991.98px) {
    .docs-wrapper {
        flex-direction: column;
    }

    .docs-content-main {
        padding: var(--docs-spacing-md);
        max-width: 100%;
    }

    .docs-sidebar-left.offcanvas-lg {
        --bs-offcanvas-bg: #fff;
        width: 320px;
        max-width: 85vw;
    }

    .docs-sidebar-right.offcanvas-lg {
        --bs-offcanvas-bg: #fff;
        width: 300px;
        max-width: 85vw;
    }

    .docs-sidebar-left .offcanvas-body {
        display: flex;
        flex-direction: column;
        padding: 0;
    }

    .docs-sidebar-left .docs-sidebar-left-expanded {
        display: flex;
        flex-direction: column;
        flex: 1;
        overflow: hidden;
    }

    .docs-sidebar-right .offcanvas-body {
        padding: var(--docs-spacing-md);
    }

    /* Hide desktop-only collapsed labels and toggle buttons */
    .docs-sidebar-left-collapsed,
    .docs-sidebar-right-collapsed,
    .docs-sidebar-toggle {
        display: none;
    }

    .docs-page-title {
        font-size: 1.5rem;
    }

    .docs-breadcrumb .breadcrumb {
        font-size: var(--docs-font-size-xs);
    }
}


/* ==========================================================================
   Mobile Sidebar Trigger Buttons
   ========================================================================== */

.docs-mobile-triggers {
    display: flex;
    justify-content: space-between;
    align-items: center;
    padding: var(--docs-spacing-sm) 0;
    margin-bottom: var(--docs-spacing-md);
    border-bottom: 1px solid var(--light-grey);
    gap: var(--docs-spacing-sm);
    position: sticky;
    top: 0;
    z-index: 1020;
    background-color: var(--white);
}

.docs-mobile-trigger {
    -webkit-appearance: none;
    appearance: none;
    display: inline-flex;
    align-items: center;
    gap: var(--docs-spacing-xs);
    padding: var(--docs-spacing-sm) var(--docs-spacing-md);
    background-color: var(--grey-white);
    border: 1px solid var(--light-grey);
    border-radius: 6px;
    color: var(--dark-blue);
    font-size: var(--docs-font-size-sm);
    font-weight: 500;
    cursor: pointer;
    transition: background-color 0.15s ease, border-color 0.15s ease;
}

.docs-mobile-trigger:hover {
    background-color: var(--pale-blue);
    border-color: var(--blue);
}

.docs-mobile-trigger i {
    font-size: 1rem;
}