/* ============================================
   CODE BLOCKS — proposed canonical (.code-block-next + .code-inline)
   Replaces .code-block + .code-header from docs.css and the
   .docs-section code namespaced inline-code rule. Adds an
   optional copy-button slot, a terminal variant for shell
   examples, a compact size, and an explicit class for inline
   code so it can live outside docs prose without leaning on
   ancestor selectors.
   ============================================ */

/* ============================================
   Block — wrapper + header + body
   ============================================ */
.code-block-next {
    position: relative;
    margin: var(--space-xl) 0;
    background: var(--color-bg-card);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    overflow: hidden;
    transition: border-color var(--transition-fast);
}

.code-block-next:hover {
    border-color: rgba(var(--color-primary-rgb), 0.3);
}

/* Header — left-aligned filename + right-aligned lang slot */
.code-block-next-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--space-md);
    padding: var(--space-sm) var(--space-md);
    background: rgba(0, 0, 0, 0.3);
    border-bottom: 1px solid var(--color-border);
    color: var(--color-text-muted);
    font-family: var(--font-mono);
    font-size: var(--font-sm);
    line-height: var(--line-normal);
}

.code-block-next-filename {
    flex: 1 1 auto;
    min-width: 0;
    overflow: hidden;
    text-overflow: ellipsis;
    white-space: nowrap;
    color: var(--color-text-secondary);
}

.code-block-next-lang {
    flex-shrink: 0;
    color: var(--color-text-muted);
    text-transform: uppercase;
    letter-spacing: 0.04em;
    font-size: var(--font-xs);
}

/* Body — the actual <pre><code> wrapper */
.code-block-next-body {
    margin: 0;
    padding: var(--space-lg);
    overflow-x: auto;
    font-family: var(--font-mono);
    font-size: var(--font-md);
    line-height: 1.6;
    color: var(--color-text-secondary);
}

.code-block-next-body code {
    font-family: inherit;
    font-size: inherit;
    color: inherit;
    background: none;
    border: 0;
    padding: 0;
}

/* When a header sits above the body, tighten the gap a touch */
.code-block-next-header + .code-block-next-body {
    padding-top: var(--space-md);
}

/* ============================================
   Copy-to-clipboard button — anchored top-right
   Visible on hover (or always on small screens). The matching
   click handler in public/js/code-block.js writes the body's
   textContent to navigator.clipboard.
   ============================================ */
.code-block-next-copy {
    position: absolute;
    top: var(--space-sm);
    right: var(--space-sm);
    z-index: 1;
    padding: 4px 10px;
    background: rgba(255, 255, 255, 0.04);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    color: var(--color-text-muted);
    font-family: var(--font-mono);
    font-size: var(--font-xs);
    font-weight: 500;
    line-height: 1.4;
    cursor: pointer;
    opacity: 0;
    transition: opacity var(--transition-fast),
                background-color var(--transition-fast),
                color var(--transition-fast),
                border-color var(--transition-fast);
}

.code-block-next:hover .code-block-next-copy,
.code-block-next:focus-within .code-block-next-copy,
.code-block-next-copy:focus-visible {
    opacity: 1;
}

.code-block-next-copy:hover {
    background: rgba(var(--color-primary-rgb), 0.1);
    border-color: rgba(var(--color-primary-rgb), 0.5);
    color: var(--color-primary);
}

.code-block-next-copy:focus-visible {
    outline: 2px solid var(--color-primary);
    outline-offset: 2px;
}

.code-block-next-copy.is-copied {
    background: rgba(var(--color-success-rgb), 0.18);
    border-color: rgba(var(--color-success-rgb), 0.5);
    color: var(--color-success);
}

/* When the block has both a header and a copy button, push the
   copy button down so it doesn't overlap the header. */
.code-block-next:has(.code-block-next-header) .code-block-next-copy {
    top: calc(var(--space-sm) + 32px);
}

/* On touch devices the hover-to-reveal pattern doesn't work — keep
   the button visible at all times. */
@media (hover: none) {
    .code-block-next-copy { opacity: 1; }
}

/* ============================================
   --sm — compact size for tight slots
   ============================================ */
.code-block-next--sm .code-block-next-body {
    padding: var(--space-md);
    font-size: var(--font-sm);
}

.code-block-next--sm .code-block-next-header {
    padding: 4px var(--space-md);
    font-size: var(--font-xs);
}

/* ============================================
   --terminal — shell-flavored variant
   Modern terminal palette (clean dark bg, neutral text,
   primary-tinted prompt + lang pill). Reads as "this is what
   the user types" without the retro-CRT green cliché.
   ============================================ */
.code-block-next--terminal {
    background: #0b1117;
    border-color: var(--color-border);
}

.code-block-next--terminal .code-block-next-header {
    background: rgba(255, 255, 255, 0.025);
    border-bottom-color: var(--color-border);
    color: var(--color-text-muted);
}

.code-block-next--terminal .code-block-next-lang {
    color: var(--color-primary-light);
    border-color: rgba(var(--color-primary-rgb), 0.2);
}

.code-block-next--terminal .code-block-next-body {
    color: var(--color-text);
}

/* Prompt prefix — paint the leading $ / # in primary so the
   typed command stands out against the response output. Use
   .code-block-next-prompt around the prompt char. */
.code-block-next-prompt {
    color: var(--color-primary-light);
    user-select: none;
    margin-right: 0.5ch;
}

.code-block-next--terminal .code-block-next-prompt {
    color: var(--color-primary-light);
}

/* ============================================
   .code-inline — explicit inline-code class
   Replaces the namespaced .docs-section code rule so consumers
   can use inline code anywhere (alerts, form-notes, leads…)
   without relying on an ancestor selector.
   ============================================ */
.code-inline {
    display: inline-block;
    padding: 1px 6px;
    background: var(--color-bg-card);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-sm);
    color: var(--color-primary-light);
    font-family: var(--font-mono);
    font-size: 0.875em;
    line-height: 1.4;
    vertical-align: baseline;
    white-space: nowrap;
}

.code-inline--muted {
    color: var(--color-text-secondary);
    border-color: rgba(255, 255, 255, 0.08);
}

.code-inline--success { color: var(--color-success); border-color: rgba(var(--color-success-rgb), 0.3); }
.code-inline--warning { color: var(--color-warning); border-color: rgba(var(--color-warning-rgb), 0.3); }
.code-inline--error { color: var(--color-error); border-color: rgba(var(--color-error-rgb), 0.3); }