/* ==========================================================================
   Localtonet Docs - Article Content
   Styles arbitrary WYSIWYG (Froala) HTML rendered inside .doc-content,
   plus code blocks and the on-this-page table of contents.
   ========================================================================== */

.doc-content {
    font-size: var(--doc-font-size);
    line-height: 1.75;
    color: var(--doc-text);
}

/* --------------------------------------------------------------------------
   Headings
   -------------------------------------------------------------------------- */
.doc-content h2 {
    margin-top: var(--doc-sp-6);
    margin-bottom: var(--doc-sp-3);
    padding-bottom: var(--doc-sp-2);
    border-bottom: 1px solid var(--doc-border);
    font-size: 1.125rem;
    font-weight: 700;
    letter-spacing: -.01em;
}

.doc-content h3 {
    margin-top: var(--doc-sp-5);
    margin-bottom: var(--doc-sp-2);
    font-size: 1rem;
    font-weight: 600;
}

.doc-content h4 {
    margin-top: var(--doc-sp-4);
    margin-bottom: var(--doc-sp-2);
    font-size: .875rem;
    font-weight: 600;
}

.doc-content h2:first-child,
.doc-content h3:first-child,
.doc-content h4:first-child {
    margin-top: 0;
}

/* Anchor affordance on hover for headings that received a generated id */
.doc-content h2[id],
.doc-content h3[id] {
    scroll-margin-top: calc(var(--doc-header-h) + 1rem);
}

/* --------------------------------------------------------------------------
   Text, lists, media
   -------------------------------------------------------------------------- */
.doc-content p {
    margin-bottom: var(--doc-sp-4);
}

.doc-content ul,
.doc-content ol {
    padding-left: var(--doc-sp-5);
    margin-bottom: var(--doc-sp-4);
}

.doc-content li {
    margin-bottom: var(--doc-sp-2);
}

    .doc-content li::marker {
        color: var(--doc-gray-500);
    }

.doc-content img {
    max-width: 100%;
    height: auto;
    margin: var(--doc-sp-5) 0;
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius);
    box-shadow: var(--doc-shadow-sm);
}

.doc-content a {
    text-decoration: underline;
    text-underline-offset: 2px;
}

.doc-content strong {
    font-weight: 700;
}

/* --------------------------------------------------------------------------
   Tables
   -------------------------------------------------------------------------- */
.doc-content table {
    width: 100%;
    margin: var(--doc-sp-5) 0;
    border-collapse: collapse;
    border-radius: var(--doc-radius);
    overflow: hidden;
    box-shadow: var(--doc-shadow-sm);
    font-size: .8125rem;
    display: block;
    overflow-x: auto;
}

.doc-content th,
.doc-content td {
    padding: .5rem .75rem;
    border: 1px solid var(--doc-border);
    text-align: left;
    vertical-align: top;
}

.doc-content th {
    background: var(--doc-primary);
    border-color: var(--doc-primary);
    color: #fff;
    font-weight: 600;
    white-space: nowrap;
}

.doc-content tbody tr:nth-child(even) {
    background: var(--doc-gray-100);
}

.doc-content tbody tr:hover {
    background: var(--doc-gray-200);
}

/* --------------------------------------------------------------------------
   Blockquote
   -------------------------------------------------------------------------- */
.doc-content blockquote {
    margin: var(--doc-sp-5) 0;
    padding: var(--doc-sp-4) var(--doc-sp-5);
    border-left: 4px solid var(--doc-primary);
    border-radius: 0 var(--doc-radius) var(--doc-radius) 0;
    background: var(--doc-primary-soft);
}

    .doc-content blockquote p {
        margin: 0;
        color: var(--doc-gray-700);
    }

        .doc-content blockquote p + p {
            margin-top: var(--doc-sp-3);
        }

/* --------------------------------------------------------------------------
   Inline code
   -------------------------------------------------------------------------- */
.doc-content code:not(pre code) {
    padding: .15rem .4rem;
    border-radius: 4px;
    background: var(--doc-inline-code-bg);
    color: var(--doc-inline-code-color);
    font-family: var(--doc-font-code);
    font-size: .875em;
    font-weight: 500;
    word-break: break-word;
}

/* --------------------------------------------------------------------------
   Code blocks
   A dark terminal-style card. The top bar height is reserved via padding-top
   so that late-loading highlight.js cannot cause a layout shift.
   -------------------------------------------------------------------------- */
.doc-content pre,
.doc-content .highlight {
    position: relative;
    margin: var(--doc-sp-5) 0;
    background: var(--doc-code-bg);
    border: 1px solid var(--doc-code-border);
    border-radius: var(--doc-radius);
    overflow: hidden;
    box-shadow: var(--doc-shadow-lg);
}

    /* Terminal header bar */
    .doc-content pre::before,
    .doc-content .highlight::before {
        content: "";
        position: absolute;
        top: 0;
        left: 0;
        right: 0;
        height: var(--doc-code-header-h);
        background: var(--doc-code-header-bg);
        border-bottom: 1px solid #1a1a1a;
        z-index: 1;
    }

.doc-content pre code,
.doc-content .highlight code,
.doc-content pre:not(:has(code)) {
    display: block;
    padding: var(--doc-sp-4) var(--doc-sp-4) var(--doc-sp-4);
    padding-top: calc(var(--doc-code-header-h) + var(--doc-sp-3));
    background: transparent;
    color: var(--doc-code-text);
    font-family: var(--doc-font-code);
    font-size: .8125rem;
    line-height: 1.65;
    white-space: pre;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
    tab-size: 4;
}

/* --------------------------------------------------------------------------
   Editor "codeblk" wrapper

   Authored content wraps code in its own titled container:

       <div class="codeblk">
         <div class="head">Authenticate</div>
         <pre><code>...</code></pre>
       </div>

   The inner <pre> is styled by the rules above, which reserve space at the top
   for the generated terminal header bar. Inside a codeblk that bar is
   redundant - the .head element already provides the title - so the reserved
   space is removed and .head is styled as the header instead.
   -------------------------------------------------------------------------- */
.doc-content .codeblk {
    margin: var(--doc-sp-5) 0;
    background: var(--doc-code-bg);
    border: 1px solid var(--doc-code-border);
    border-radius: var(--doc-radius);
    overflow: hidden;
    box-shadow: var(--doc-shadow-lg);
}

.doc-content .codeblk .head {
    display: flex;
    align-items: center;
    height: var(--doc-code-header-h);
    padding: 0 var(--doc-sp-4);
    background: var(--doc-code-header-bg);
    border-bottom: 1px solid #1a1a1a;
    font-family: var(--doc-font-ui);
    font-size: 12px;
    font-weight: 500;
    letter-spacing: .3px;
    color: var(--doc-code-label);
}

/* The wrapper already draws the card and the header, so the nested <pre> must
   not repeat them, and must not reserve room for the generated header bar. */
.doc-content .codeblk pre {
    margin: 0;
    border: 0;
    border-radius: 0;
    box-shadow: none;
    background: transparent;
    /* Must not clip: the generated chrome is repositioned above this element,
       into the .head row. */
    overflow: visible;
}

    .doc-content .codeblk pre::before {
        content: none;
    }

.doc-content .codeblk pre code {
    padding: var(--doc-sp-4);
}

/* The generated chrome is appended to the <pre>, which sits below the .head
   row inside a codeblk. Pull those absolutely positioned pieces up into the
   header, and drop the duplicated language label. */
.doc-content .codeblk pre .code-header-title {
    display: none;
}

.doc-content .codeblk pre .code-terminal-icon {
    top: calc((var(--doc-code-header-h) * -1) + 8px);
}

.doc-content .codeblk pre .code-copy-btn {
    top: calc((var(--doc-code-header-h) * -1) + 6px);
}

/* The header sits above the <pre>, so the button only fades in when the whole
   card is hovered. */
.doc-content .codeblk:hover .code-copy-btn {
    opacity: 1;
    transform: translateY(0);
}

/* A .head with the terminal badge needs room so the two do not overlap. */
.doc-content .codeblk .head {
    padding-left: calc(var(--doc-sp-4) + 26px);
}

.doc-content pre code[class*="language-"] {
    margin: 0;
}

/* Language label in the header bar */
.code-header-title {
    position: absolute;
    top: 0;
    left: 0;
    right: 0;
    height: var(--doc-code-header-h);
    display: flex;
    align-items: center;
    justify-content: center;
    font-family: var(--doc-font-ui);
    font-size: 12px;
    font-weight: 500;
    letter-spacing: .3px;
    color: var(--doc-code-label);
    pointer-events: none;
    z-index: 5;
}

/* Terminal glyph badge */
.code-terminal-icon {
    position: absolute;
    top: 8px;
    left: 12px;
    width: 20px;
    height: 20px;
    display: flex;
    align-items: center;
    justify-content: center;
    border-radius: 4px;
    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
    z-index: 10;
}

    .code-terminal-icon svg {
        width: 12px;
        height: 12px;
        color: #fff;
    }

/* Copy button */
.code-copy-btn {
    position: absolute;
    top: 6px;
    right: 12px;
    z-index: 20;
    display: inline-flex;
    align-items: center;
    gap: 5px;
    padding: 5px 12px;
    border: 1px solid rgba(255, 255, 255, .15);
    border-radius: var(--doc-radius-sm);
    background: rgba(255, 255, 255, .1);
    color: #aaa;
    font-family: var(--doc-font-ui);
    font-size: 12px;
    font-weight: 500;
    opacity: 0;
    transform: translateY(-2px);
    transition: opacity var(--doc-transition), transform var(--doc-transition), background-color var(--doc-transition), color var(--doc-transition), border-color var(--doc-transition);
}

    .code-copy-btn svg {
        flex-shrink: 0;
    }

.doc-content pre:hover .code-copy-btn,
.doc-content .highlight:hover .code-copy-btn,
.code-copy-btn:focus-visible,
.code-copy-btn.copied {
    opacity: 1;
    transform: translateY(0);
}

.code-copy-btn:hover {
    background: rgba(255, 255, 255, .2);
    border-color: rgba(255, 255, 255, .3);
    color: #fff;
}

.code-copy-btn.copied {
    background: var(--doc-success);
    border-color: var(--doc-success);
    color: #fff;
}

/* Touch devices have no hover: keep the button permanently visible */
@media (hover: none) {
    .code-copy-btn {
        opacity: 1;
        transform: none;
    }
}

/* Code block scrollbars */
.doc-content pre code::-webkit-scrollbar,
.doc-content pre::-webkit-scrollbar {
    height: 8px;
    background: transparent;
}

.doc-content pre code::-webkit-scrollbar-thumb,
.doc-content pre::-webkit-scrollbar-thumb {
    background: var(--doc-code-scroll);
    border-radius: 4px;
}

    .doc-content pre code::-webkit-scrollbar-thumb:hover,
    .doc-content pre::-webkit-scrollbar-thumb:hover {
        background: var(--doc-code-scroll-hover);
    }

/* --------------------------------------------------------------------------
   On-this-page table of contents
   -------------------------------------------------------------------------- */
.docs-toc {
    flex: 0 0 220px;
    width: 220px;
    position: sticky;
    top: calc(var(--doc-header-h) + var(--doc-sp-5));
    max-height: calc(100vh - var(--doc-header-h) - var(--doc-sp-6));
    overflow-y: auto;
    overscroll-behavior: contain;
    padding-left: var(--doc-sp-4);
    border-left: 1px solid var(--doc-border);
}

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

.docs-toc-title {
    margin: 0 0 var(--doc-sp-3);
    font-size: .6875rem;
    font-weight: 700;
    letter-spacing: .08em;
    text-transform: uppercase;
    color: var(--doc-text-muted);
}

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

.docs-toc-link {
    display: block;
    padding: .25rem 0;
    color: var(--doc-text-muted);
    font-size: .8125rem;
    line-height: 1.5;
    text-decoration: none;
    border-left: 2px solid transparent;
    margin-left: -1px;
    padding-left: var(--doc-sp-3);
    transition: color var(--doc-transition), border-color var(--doc-transition);
}

    .docs-toc-link:hover {
        color: var(--doc-text);
        text-decoration: none;
    }

    .docs-toc-link.is-active {
        color: var(--doc-primary);
        border-left-color: var(--doc-primary);
        font-weight: 600;
    }

.docs-toc-item-h3 .docs-toc-link {
    padding-left: var(--doc-sp-5);
    font-size: .78125rem;
}

/* --------------------------------------------------------------------------
   Mobile refinements
   Tighter spacing and a smaller type scale so the article does not read as
   "zoomed in" on narrow viewports.
   -------------------------------------------------------------------------- */
@media (max-width: 767.98px) {
    .doc-content {
        line-height: 1.7;
    }

        .doc-content h2 {
            font-size: 1.125rem;
            margin-top: var(--doc-sp-5);
        }

        .doc-content h3 {
            font-size: 1rem;
            margin-top: var(--doc-sp-4);
        }

        .doc-content h4 {
            font-size: .9375rem;
        }

        .doc-content ul,
        .doc-content ol {
            padding-left: var(--doc-sp-4);
        }

        .doc-content img {
            margin: var(--doc-sp-4) 0;
        }

        .doc-content pre,
        .doc-content .highlight {
            margin: var(--doc-sp-4) calc(var(--doc-sp-4) * -1);
            border-radius: 0;
            border-left: 0;
            border-right: 0;
        }

        .doc-content pre code,
        .doc-content .highlight code,
        .doc-content pre:not(:has(code)) {
            padding-left: var(--doc-sp-3);
            padding-right: var(--doc-sp-3);
            font-size: .75rem;
        }

        .doc-content table {
            font-size: .75rem;
        }

        .doc-content blockquote {
            padding: var(--doc-sp-3) var(--doc-sp-4);
        }
}