/* =========================================================
   Accessible Patterns – Clean Base (Light + Dark support)
   Priorities:
   - WCAG 2.2 AA text contrast (≥ 4.5:1) and non-text (≥ 3:1)
   - Minimal, predictable tokens
   - No opacity-based dimming for text
   - Remove duplicates / conflicts
   ========================================================= */

/* ---------- Tokens: Light mode (default) ---------- */
:root {
    /* Surfaces */
    --bg: #ffffff;
    --surface: #f8fafc;
    --surface-2: #eef2f7;

    /* Text */
    --text: #111827;
    /* body text (~12:1 on white) */
    --text-muted: #374151;
    /* captions/help (~7.8:1 on white) */

    /* Links */
    --link: #0b57d0;
    /* AA on white */
    --link-visited: #6b39c3;
    /* distinguishable + AA */

    /* UI lines, focus */
    --border: #4b5563;
    /* ≥3:1 vs white for inputs/dividers */
    --focus: #1d4ed8;
    /* visible focus ring */

    /* Brand accents */
    --accent: #60a5fa;
    --accent-strong: #3b82f6;

    /* Skip link offset (updated by JS/inline if header height changes) */
    --skip-offset: 0px;
}

/* ---------- Tokens: Dark mode (system-pref) ---------- */
@media (prefers-color-scheme: dark) {
    :root {
        --bg: #0b0f14;
        --surface: #111827;
        --surface-2: #1f2937;

        --text: #e8eef6;
        --text-muted: #e2e8f0;
        /* brighter to keep ≥4.5:1 on dark */

        --link: #93c5fd;
        --link-visited: #c4b5fd;

        --border: #2a3648;
        /* subtle but ≥3:1 vs surfaces */
        --focus: #38bdf8;

        --accent: #60a5fa;
        --accent-strong: #3b82f6;
    }
}

/* ---------- Global Resets & Base ---------- */
*,
*::before,
*::after {
    box-sizing: border-box;
}

html {
    font-size: 100%;
    -webkit-text-size-adjust: 100%;
}

html,
body {
    height: 100%;
}

body {
    margin: 0;
    background: var(--bg);
    color: var(--text);
    font: 400 1rem/1.5 system-ui, -apple-system, Segoe UI, Roboto, Ubuntu, Cantarell,
        Noto Sans, "Helvetica Neue", Arial, "Apple Color Emoji", "Segoe UI Emoji";
}

/* Ensure headings/targets don’t hide under sticky header */
:where(h1, h2, h3, h4, h5, h6, [role="heading"], #main) {
    scroll-margin-top: calc(var(--skip-offset) + 8px);
}

/* Links */
a {
    color: var(--link);
}

a:visited {
    color: var(--link-visited);
}

a:hover {
    text-decoration-thickness: .12em;
}

/* Text roles */
figcaption,
.small,
.help,
.meta {
    color: var(--text-muted);
}

/* NEVER dim text with opacity */
figcaption,
.muted,
.meta,
[disabled] {
    opacity: 1;
}

/* Rules/inputs/cards (non-text contrast ≥3:1) */
hr,
.divider,
[role="separator"] {
    border-color: var(--border);
}

input,
textarea,
select,
.card {
    border: 1px solid var(--border);
    background: var(--bg);
    color: var(--text);
}

/* Focus visibility */
:focus-visible {
    outline: 3px solid var(--focus);
    outline-offset: 2px;
}

/* Motion safety */
@media (prefers-reduced-motion: reduce) {
    * {
        transition: none !important;
    }
}

/* Smooth transitions for interactive elements (not essential) */
a,
button {
    transition: background-color .2s ease, color .2s ease, border-color .2s ease;
}

/* ---------- Layout: site shell ---------- */
.pattern[data-pattern="site-shell"] * {
    box-sizing: border-box;
}

.site-header,
.site-footer {
    background: var(--surface);
    color: var(--text);
}

.site-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: .5rem;
    padding: .75rem 1rem;
    position: sticky;
    top: 0;
    z-index: 10;
    border-bottom: 1px solid var(--border);
}

.site-logo {
    display: flex;
    align-items: center;
    gap: .5rem;
    text-decoration: none;
    color: var(--text);
    font-weight: 600;
}

.logo-box {
    width: 28px;
    height: 28px;
    background: linear-gradient(135deg, var(--accent), var(--accent-strong));
    border-radius: .5rem;
    display: inline-block;
}

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

.site-nav a {
    display: block;
    padding: .6rem .75rem;
    border-radius: .5rem;
    text-decoration: none;
    color: var(--text);
}

.site-nav a:hover {
    background: var(--surface-2);
}

.site-nav a[aria-current="page"] {
    color: var(--link);
    font-weight: 600;
}

.site-main {
    background: var(--bg);
    color: var(--text);
}

.container {
    padding: 1.25rem;
    max-width: 1100px;
    margin: 0 auto;
}

.cards {
    list-style: none;
    padding: 0;
    margin: 1rem 0 0;
    display: grid;
    grid-template-columns: repeat(12, 1fr);
    gap: 1rem;
}

.cards,
.cards>li,
.featured-patterns,
.featured-patterns>li {
    list-style: none !important;
}

.card {
    grid-column: span 12;
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: 1rem;
    padding: 1rem;
    box-shadow: 0 6px 16px rgba(0, 0, 0, .15);
}

.card h3 {
    margin-top: 0;
}

.button {
    display: inline-block;
    margin-top: .5rem;
    background: var(--accent);
    color: #0b0f14;
    /* dark text on blue for contrast */
    padding: .5rem .75rem;
    border-radius: .6rem;
    text-decoration: none;
    font-weight: 600;
}

.button:hover {
    background: var(--accent-strong);
    color: #0b0f14;
}

.site-footer {
    padding: 1rem;
    border-top: 1px solid var(--border);
}

.footer-links {
    display: flex;
    gap: .75rem;
    list-style: none;
    padding: 0;
    margin: 0 0 .5rem;
    flex-wrap: wrap;
}

.footer-links a {
    color: var(--text-muted);
    text-decoration: none;
}

.footer-links a:hover {
    color: var(--text);
    text-decoration: underline;
}

/* ---------- Skip link (first focusable) ---------- */
.skip-link {
    position: absolute;
    left: -9999px;
    top: auto;
    width: 1px;
    height: 1px;
    overflow: hidden;
}

.skip-link:focus {
    position: static;
    width: auto;
    height: auto;
    padding: .5rem .75rem;
    background: var(--focus);
    color: #002b36;
    border-radius: .5rem;
    margin: .5rem;
    display: inline-block;
}

/* ---------- Responsive nav visibility ---------- */
.site-nav {
    position: relative;
}

@media (min-width: 768px) {
    .menu-toggle {
        display: none;
    }

    .site-nav .nav-list {
        display: flex !important;
        gap: .25rem;
    }
}

@media (max-width: 767.98px) {
    .site-nav {
        display: none;
    }

    .site-nav .nav-list {
        margin-top: .5rem;
        border-top: 1px solid var(--border);
    }
}

/* Keep toggle above content */
.menu-toggle {
    position: relative;
    z-index: 2;
    background: transparent;
    color: var(--text);
    border: 1px solid var(--border);
    padding: .5rem .75rem;
    border-radius: .75rem;
}

.menu-toggle:hover {
    background: var(--surface-2);
}

/* ---------- Mobile flyout nav ---------- */
body.nav-open {
    overflow: hidden;
}

.mobile-nav[hidden] {
    display: none;
}

.mobile-nav {
    position: fixed;
    inset: 0;
    z-index: 100;
}

.mobile-nav__backdrop {
    position: absolute;
    inset: 0;
    background: rgba(0, 0, 0, .55);
    opacity: 0;
    transition: opacity .22s ease;
}

.mobile-nav__panel {
    position: absolute;
    top: 0;
    right: 0;
    height: 100%;
    width: min(86vw, 360px);
    background: var(--surface);
    color: var(--text);
    border-left: 1px solid var(--border);
    box-shadow: -8px 0 20px rgba(0, 0, 0, .4);
    transform: translateX(100%);
    transition: transform .22s ease;
    display: flex;
    flex-direction: column;
}

.mobile-nav__header {
    display: flex;
    justify-content: flex-end;
    padding: .5rem;
}

.mobile-nav__close {
    background: transparent;
    color: var(--text);
    border: 1px solid var(--border);
    padding: .5rem .75rem;
    border-radius: .5rem;
}

.mobile-nav__close:hover {
    background: var(--surface-2);
}

.mobile-nav__close:focus-visible {
    outline: 3px solid var(--focus);
    outline-offset: 2px;
}

.mobile-nav__list {
    list-style: none;
    margin: 0;
    padding: 1rem;
    display: flex;
    flex-direction: column;
    gap: .25rem;
}

.mobile-nav__list a {
    display: block;
    padding: .9rem 1rem;
    border-radius: .5rem;
    color: var(--text);
    text-decoration: none;
}

.mobile-nav__list a:hover,
.mobile-nav__list a:focus-visible {
    background: var(--surface-2);
}

.mobile-nav.is-open .mobile-nav__panel {
    transform: translateX(0);
}

.mobile-nav.is-open .mobile-nav__backdrop {
    opacity: 1;
}

@media (prefers-reduced-motion: reduce) {

    .mobile-nav__panel,
    .mobile-nav__backdrop {
        transition: none !important;
    }
}

@media (min-width: 768px) {
    #mobile-nav {
        display: none !important;
    }

    .site-nav {
        display: block;
    }
}

/* ---------- Accordion ---------- */
.accordion {
    display: grid;
    gap: .75rem;
}

.accordion-item {
    border: 1px solid var(--border);
    border-radius: .75rem;
    background: var(--surface);
}

.accordion-heading {
    margin: 0;
}

.accordion-trigger {
    all: unset;
    display: flex;
    width: 100%;
    align-items: center;
    justify-content: space-between;
    gap: .75rem;
    padding: .9rem 1rem;
    cursor: pointer;
    color: var(--text);
    border-radius: .75rem;
}

.accordion-trigger:hover {
    background: var(--surface-2);
}

.accordion-trigger:focus-visible {
    outline: 3px solid var(--focus);
    outline-offset: 2px;
}

.accordion-trigger::after {
    content: '+';
    font-weight: 700;
    line-height: 1;
    transform: translateY(1px);
}

.accordion-trigger[aria-expanded="true"]::after {
    content: '–';
}

.accordion-panel {
    padding: .75rem 1rem 1rem;
    border-top: 1px solid var(--border);
    background: var(--surface-2);
    border-radius: 0 0 .75rem .75rem;
}

/* ✅ Animation+clipping so closed panels don’t leak content */
.accordion-panel.__anim {
    overflow: hidden;
    /* clip children while collapsing */
    max-height: 0;
    /* closed state */
    padding-top: 0;
    padding-bottom: 0;
    transition: max-height .22s ease, padding-top .22s ease, padding-bottom .22s ease;
}

/* Optional image block inside panel */
.accordion-media {
    margin: 0 0 .75rem 0;
    width: 100%;
}

.accordion-media img {
    display: block;
    max-width: 100%;
    height: auto;
    max-height: clamp(240px, 65vh, 800px);
    margin: 0 auto;
    object-fit: contain;
}

/* Caption & code with guaranteed contrast */
.accordion-panel figcaption:not(.visually-hidden) {
    color: var(--text-muted);
    font-size: 0.9375rem;
    line-height: 1.4;
    margin-top: .5rem;
}

.accordion-panel code {
    color: var(--text);
    background: color-mix(in oklab, var(--bg) 85%, black);
    /* darken enough */
    border: 1px solid var(--border);
    padding: .1em .4em;
    border-radius: .35rem;
    font: 500 .9em/1 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

.accordion-panel pre {
    color: var(--text);
    background: color-mix(in oklab, var(--bg) 85%, black);
    border: 1px solid var(--border);
    padding: .75rem 1rem;
    border-radius: .5rem;
    overflow: auto;
}

.accordion-panel pre code {
    background: transparent;
    border: 0;
    padding: 0;
}

/* Toggle all actions row */
.actions,
.accordion-actions {
    display: flex;
    gap: .5rem;
    justify-content: flex-end;
    margin: 0 0 .5rem 0;
}

/* ---------- Utilities ---------- */
.visually-hidden,
.sr-only {
    position: absolute !important;
    width: 1px !important;
    height: 1px !important;
    padding: 0 !important;
    margin: -1px !important;
    overflow: hidden !important;
    clip: rect(0, 0, 1px, 1px) !important;
    white-space: nowrap !important;
    border: 0 !important;
}

/* ---------- Media Queries: grid scaling ---------- */
@media (min-width: 600px) {
    .card {
        grid-column: span 6;
    }
}

@media (min-width: 900px) {
    .card {
        grid-column: span 4;
    }
}

/* ---------- Media basics ---------- */
img {
    display: block;
    max-width: 100%;
    height: auto;
}

figure {
    margin: 0;
    inline-size: 100%;
}

figure,
.card,
.media,
.content {
    min-width: 0;
}

/* ===============================
   Pattern visuals (accessible)
   =============================== */

/* Tokens for pattern blocks */
:root {
    /* Light mode pattern surfaces */
    --pattern-bg: #f3f6fb;
    /* very light blue-gray */
    --pattern-border: #c7d2e1;
    /* border vs pattern-bg ≈ 3.2:1 */
    --pattern-accent: #1d4ed8;
    /* default accent (≥3:1 vs pattern-bg) */

    /* Optional accent variants (all meet ≥3:1 vs pattern-bg) */
    --pattern-accent-info: #1d4ed8;
    /* blue  */
    --pattern-accent-success: #065f46;
    /* teal  */
    --pattern-accent-warning: #b45309;
    /* amber */
    --pattern-accent-neutral: #4b5563;
    /* slate */
}

/* Dark-mode overrides for pattern blocks */
@media (prefers-color-scheme: dark) {
    :root {
        --pattern-bg: #0f172a;
        /* deep slate */
        --pattern-border: #2a3648;
        /* visible edge on dark */
        --pattern-accent: #60a5fa;
        /* bright blue, ≥3:1 on --pattern-bg */
        --pattern-accent-info: #60a5fa;
        --pattern-accent-success: #34d399;
        /* green on dark passes non-text */
        --pattern-accent-warning: #f59e0b;
        /* amber on dark passes non-text */
        --pattern-accent-neutral: #9ca3af;
        /* gray on dark passes non-text */
    }
}

/* Generic “pattern card” wrapper for any component section */
section.pattern {
    background: var(--pattern-bg);
    border: 1px solid var(--pattern-border);
    border-left: 6px solid var(--pattern-accent);
    border-radius: 1rem;
    padding: 1rem;
    margin: 1rem 0;
}

/* Headings and helper text render clearly on the pattern surface */
section.pattern h2,
section.pattern h3,
section.pattern h4 {
    color: var(--text);
    margin-top: .25rem;
}

section.pattern .help,
section.pattern .meta {
    color: var(--text-muted);
}

/* Optional accent variants (pick one per component) */
section.pattern.is-info {
    --pattern-accent: var(--pattern-accent-info);
}

section.pattern.is-success {
    --pattern-accent: var(--pattern-accent-success);
}

section.pattern.is-warning {
    --pattern-accent: var(--pattern-accent-warning);
}

section.pattern.is-neutral {
    --pattern-accent: var(--pattern-accent-neutral);
}

/* Keep inner component bits readable on the pattern background */
section.pattern .container,
section.pattern .content,
section.pattern .example {
    background: var(--surface);
    border-radius: .5rem;
}

/* Give pattern sections a little extra separation when stacked */
section.pattern+section.pattern {
    margin-top: 1.25rem;
}


/* Pattern wrapper: each pattern section gets a light/dark card look */
section.accordion {
    background: var(--pattern-bg);
    border: 1px solid var(--pattern-border);
    border-left: 6px solid var(--pattern-accent);
    border-radius: 1rem;
    padding: 1rem;
    margin: 1rem 0;
}

/* Give a little extra separation between multiple patterns in a list */
section.accordion+section.accordion {
    margin-top: 1.25rem;
}

/* Headings read clearly on pattern background */
section.accordion h2,
section.accordion h3,
section.accordion h4 {
    color: var(--text);
    /* already AA vs both page bg and pattern bg */
    margin-top: 0.25rem;
}

/* Caption/help text still passes on pattern background */
section.accordion figcaption,
section.accordion .help,
section.accordion .meta {
    color: var(--text-muted);
    /* AA on both light/dark pattern bg */
}

/* Ensure the inner accordion panels still look right on pattern bg */
section.accordion .accordion-item {
    background: var(--surface);
}

/* Optional accent variants (use one per pattern section) */
section.accordion.is-info {
    --pattern-accent: var(--pattern-accent-info);
}

section.accordion.is-success {
    --pattern-accent: var(--pattern-accent-success);
}

section.accordion.is-warning {
    --pattern-accent: var(--pattern-accent-warning);
}

section.accordion.is-neutral {
    --pattern-accent: var(--pattern-accent-neutral);
}

/* Non-text contrast for borders/accents: ≥3:1 (meets 1.4.11)
   Text colors already come from --text / --text-muted which meet ≥4.5:1. */

/* ===============================
   Pattern visuals (accessible)
   =============================== */

/* Tokens for pattern blocks */
:root {
    /* Light mode pattern surfaces */
    --pattern-bg: #f3f6fb;
    /* very light blue-gray */
    --pattern-border: #c7d2e1;
    /* border vs pattern-bg ≈ 3.2:1 */
    --pattern-accent: #1d4ed8;
    /* default accent (≥3:1 vs pattern-bg) */

    /* Optional accent variants (all meet ≥3:1 vs pattern-bg) */
    --pattern-accent-info: #1d4ed8;
    /* blue  */
    --pattern-accent-success: #065f46;
    /* teal  */
    --pattern-accent-warning: #b45309;
    /* amber */
    --pattern-accent-neutral: #4b5563;
    /* slate */
}

/* Dark-mode overrides for pattern blocks */
@media (prefers-color-scheme: dark) {
    :root {
        --pattern-bg: #0f172a;
        /* deep slate */
        --pattern-border: #2a3648;
        /* visible edge on dark */
        --pattern-accent: #60a5fa;
        /* bright blue, ≥3:1 on --pattern-bg */
        --pattern-accent-info: #60a5fa;
        --pattern-accent-success: #34d399;
        /* green on dark passes non-text */
        --pattern-accent-warning: #f59e0b;
        /* amber on dark passes non-text */
        --pattern-accent-neutral: #9ca3af;
        /* gray on dark passes non-text */
    }
}

/* Pattern wrapper: each pattern section gets a light/dark card look */
section.accordion {
    background: var(--pattern-bg);
    border: 1px solid var(--pattern-border);
    border-left: 6px solid var(--pattern-accent);
    border-radius: 1rem;
    padding: 1rem;
    margin: 1rem 0;
}

/* Extra separation between patterns */
section.accordion+section.accordion {
    margin-top: 1.25rem;
}

/* Headings read clearly on pattern background */
section.accordion h2,
section.accordion h3,
section.accordion h4 {
    color: var(--text);
    /* AA on both page bg and pattern bg */
    margin-top: 0.25rem;
}

/* Caption/help text still passes on pattern background */
section.accordion figcaption,
section.accordion .help,
section.accordion .meta {
    color: var(--text-muted);
    /* AA on both light/dark pattern bg */
}

/* Keep inner accordion items readable on pattern bg */
section.accordion .accordion-item {
    background: var(--surface);
}

/* Accent variants (use one on the section, optional) */
section.accordion.is-info {
    --pattern-accent: var(--pattern-accent-info);
}

section.accordion.is-success {
    --pattern-accent: var(--pattern-accent-success);
}

section.accordion.is-warning {
    --pattern-accent: var(--pattern-accent-warning);
}

section.accordion.is-neutral {
    --pattern-accent: var(--pattern-accent-neutral);
}

/* Breadcrumbs  */
/* ===============================
   Component: Breadcrumb
   =============================== */

.breadcrumb {
    background: var(--surface);
    color: var(--text);
    border: 1px solid var(--border);
    border-radius: .75rem;
    padding: .5rem .75rem;
    margin: 1rem 0;
}

.breadcrumb ol {
    list-style: none;
    margin: 0;
    padding: 0;
    display: flex;
    flex-wrap: wrap;
    gap: .25rem .5rem;
    /* row-gap, column-gap */
}

.breadcrumb li {
    display: inline-flex;
    align-items: center;
    min-width: 0;
}

/* Links */
.breadcrumb a {
    color: var(--link);
    text-decoration: none;
}

.breadcrumb a:hover {
    text-decoration: underline;
}

/* Current page (not a link) */
.breadcrumb [aria-current="page"] {
    color: var(--text);
    /* ≥4.5:1 on var(--surface) */
    font-weight: 600;
    text-decoration: none;
}

/* Visual separator (›) via CSS so ATs don’t announce it */
.breadcrumb li+li::before {
    content: "›";
    margin: 0 .25rem 0 .125rem;
    line-height: 1;
    color: var(--text-muted);
    /* ≥4.5:1 on var(--surface) */
}

/* Long labels: don’t break layouts */
.breadcrumb li a,
.breadcrumb [aria-current="page"] {
    display: inline-block;
    max-width: 30ch;
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
}

/* Dark mode keeps contrast passing */
@media (prefers-color-scheme: dark) {
    .breadcrumb {
        background: var(--surface);
        border-color: var(--border);
    }

    .breadcrumb a {
        color: var(--link);
    }

    .breadcrumb [aria-current="page"] {
        color: var(--text);
    }

    .breadcrumb li+li::before {
        color: var(--text-muted);
    }
}


/* ===============================
   Generic Section Visuals (for any component section)
   Your breadcrumb section already has: class="pattern is-neutral"
   =============================== */

section.pattern {
    background: var(--pattern-bg, var(--surface));
    border: 1px solid var(--pattern-border, var(--border));
    border-left: 6px solid var(--pattern-accent, var(--border));
    border-radius: 1rem;
    padding: 1rem;
    margin: 1rem 0;
}

/* Optional accent variants */
section.pattern.is-info {
    --pattern-accent: var(--pattern-accent-info, #1d4ed8);
}

section.pattern.is-success {
    --pattern-accent: var(--pattern-accent-success, #065f46);
}

section.pattern.is-warning {
    --pattern-accent: var(--pattern-accent-warning, #b45309);
}

section.pattern.is-neutral {
    --pattern-accent: var(--pattern-accent-neutral, #4b5563);
}

/* Headings and hints stay readable on the section background */
section.pattern h2,
section.pattern h3,
section.pattern h4 {
    color: var(--text);
    margin-top: .25rem;
}

section.pattern .help,
section.pattern .meta,
section.pattern figcaption {
    color: var(--text-muted);
}


/* ===============================
   Utilities (replacing prior inline styles)
   =============================== */

/* Section headers used inside component sections */
.section-header {
    padding: 0;
    margin-bottom: .25rem;
}

/* Remove container padding for “live example” and “how to use” blocks */
.container--flush {
    padding: 0;
}

/* Spacing for headings/lists inside components */
.mt-050 {
    margin-top: .5rem;
}

.mt-075 {
    margin-top: .75rem;
}

.list-compact {
    margin: .25rem 0 0;
}


/* ===============================
   Component: Button (variants)
   =============================== */

/* Ensure touch target & readable line-height */
.button {
    min-height: 2.75rem;
    /* ~44px target */
    line-height: 1.2;
}

/* Variants */
.button--primary {
    background: var(--accent);
    color: #0b0f14;
}

.button--primary:hover {
    background: var(--accent-strong);
    color: #0b0f14;
}

.button--secondary {
    background: var(--surface);
    color: var(--text);
    border: 1px solid var(--border);
}

.button--secondary:hover {
    background: var(--surface-2);
}

.button--ghost {
    background: transparent;
    color: var(--text);
    border: 1px solid var(--border);
}

.button--ghost:hover {
    background: var(--surface-2);
}

/* Danger tokens (AA with on-color) */
:root {
    --danger: #dc2626;
    /* red-600-ish */
    --danger-strong: #b91c1c;
    /* darker on hover */
    --on-danger: #0b0f14;
    /* dark text for strong contrast */
}

@media (prefers-color-scheme: dark) {
    :root {
        --danger: #ef4444;
        /* brighter red on dark */
        --danger-strong: #dc2626;
        --on-danger: #0b0f14;
    }
}

.button--danger {
    background: var(--danger);
    color: var(--on-danger);
    border: 1px solid var(--border);
}

.button--danger:hover {
    background: var(--danger-strong);
    color: var(--on-danger);
}

/* Full-width option */
.button--block {
    display: block;
    width: 100%;
    text-align: center;
}

/* Disabled (no opacity dimming to keep legibility) */
.button[disabled],
.button[aria-disabled="true"] {
    background: var(--surface-2);
    color: var(--text-muted);
    border: 1px solid var(--border);
    cursor: not-allowed;
    box-shadow: none;
}

/* Demo layout */
.button-demo {
    display: flex;
    flex-wrap: wrap;
    gap: .5rem;
    align-items: center;
}

.button-demo .button--block {
    flex-basis: 100%;
}

/* Button component end  */

/* Figure-free carousel image rules (reuse accordion sizing) */
.carousel-img {
    display: block;
    max-width: 100%;
    height: auto;
    /* viewport-aware height cap: min 240px, prefer ~65vh, never above 800px */
    max-height: clamp(240px, 65vh, 800px);
    margin: 0 auto;
    object-fit: contain;
}

/* Visible caption text (AA contrast on dark surfaces) */
.carousel-caption {
    color: var(--muted, #e2e8f0);
    font-size: 0.9375rem;
    line-height: 1.4;
    margin: .5rem 0 0 0;
}

/* Optional: slide layout + transitions (unchanged) */
.carousel {
    margin-block: 1.25rem;
}

.carousel .actions {
    display: flex;
    gap: .5rem;
    justify-content: flex-end;
    margin-bottom: .5rem;
}

.carousel-viewport {
    position: relative;
}

.carousel-slide {
    display: grid;
    gap: .5rem;
}

.carousel-slide[hidden] {
    display: none;
}

@media (prefers-reduced-motion: no-preference) {
    .carousel-viewport {
        overflow: hidden;
    }

    .carousel-slide {
        transition: opacity .24s ease;
    }
}

.carousel .actions {
    display: flex;
    gap: .5rem;
    justify-content: flex-end;
    margin-top: .5rem;
    /* moved below the image */
    margin-bottom: 0;
}


/* Carousel end  */

/* ===== Modal (APG-style) ===== */
body.modal-open {
    overflow: hidden;
}

.modal-root[hidden] {
    display: none;
}

.modal-root {
    position: fixed;
    inset: 0;
    z-index: 1000;
}

.modal-backdrop {
    position: absolute;
    inset: 0;
    background: rgba(0, 0, 0, .55);
    opacity: 0;
    transition: opacity .2s ease;
}

.modal-dialog {
    position: absolute;
    top: 50%;
    left: 50%;
    width: min(92vw, 720px);
    max-height: min(85vh, 1000px);
    transform: translate(-50%, -50%) scale(.98);
    background: var(--surface, #111827);
    color: var(--text, #e8eef6);
    border: 1px solid var(--border, #2a3648);
    border-radius: 1rem;
    box-shadow: 0 20px 60px rgba(0, 0, 0, .6);
    display: grid;
    grid-template-rows: auto 1fr auto;
    outline: none;
    overflow: hidden;
    /* contain inner scroll */
    opacity: 0;
    transition: transform .2s ease, opacity .2s ease;
}

.modal-header,
.modal-footer {
    padding: .75rem 1rem;
}

.modal-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    border-bottom: 1px solid var(--border, #2a3648);
}

.modal-footer {
    border-top: 1px solid var(--border, #2a3648);
}

.modal-close {
    background: transparent;
    color: inherit;
    border: 1px solid var(--border, #2a3648);
    padding: .35rem .6rem;
    border-radius: .5rem;
}

.modal-close:hover {
    background: var(--surface-2, #1f2937);
}

.modal-close:focus-visible {
    outline: 3px solid var(--focus, #38bdf8);
    outline-offset: 2px;
}

.modal-body {
    padding: .75rem 1rem;
    overflow: auto;
    /* scroll long content within the dialog */
}

/* Image sizing (no <figure>): fit viewport, keep aspect ratio */
.modal-img {
    display: block;
    width: 100%;
    height: auto;
    max-height: clamp(240px, 60vh, 800px);
    margin: 0 auto .75rem auto;
    object-fit: contain;
}

/* Open state (added via JS) */
.modal-root.is-open .modal-backdrop {
    opacity: 1;
}

.modal-root.is-open .modal-dialog {
    opacity: 1;
    transform: translate(-50%, -50%) scale(1);
}

/* Respect reduced motion */
@media (prefers-reduced-motion: reduce) {

    .modal-backdrop,
    .modal-dialog {
        transition: none !important;
    }
}

/* Modal End  */

/* --- Link pattern styles --- */
.link-examples {
    list-style: none;
    margin: 0;
    padding: 0;
    display: grid;
    gap: .5rem;
}

.link-examples>li {
    min-height: 44px;
    /* touch target */
    display: flex;
    align-items: center;
}

/* Base link: high-contrast, always underlined */
a {
    color: var(--link, #93c5fd);
    text-decoration: underline;
    text-underline-offset: 3px;
    text-decoration-thickness: 2px;
}

a:hover {
    text-decoration-thickness: 3px;
}

a:focus-visible {
    outline: 3px solid var(--focus, #38bdf8);
    outline-offset: 2px;
    border-radius: .25rem;
}

a:visited {
    color: var(--link-visited, #c4b5fd);
    /* AA on dark backgrounds */
}

/* External link icon + SR note */
.link-external .ext-icon {
    margin-left: .35em;
    transform: translateY(.08em);
}

/* Download/in-page variants just inherit; add subtle affordance if desired */
.link-download::before {
    content: "⬇";
    font-size: .95em;
    margin-right: .4em;
    aria-hidden: true;
}

.link-inline::before {
    content: "↘";
    font-size: .95em;
    margin-right: .4em;
    aria-hidden: true;
}

/* Button-styled anchor for CTAs (still a link) */
a.button-link {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    gap: .5rem;
    min-height: 44px;
    padding: .5rem .9rem;
    background: var(--accent, #60a5fa);
    color: #0b0f14;
    /* dark text on light button */
    border-radius: .75rem;
    text-decoration: none;
    /* intentional for button look */
    border: 1px solid transparent;
    box-shadow: 0 4px 12px rgba(0, 0, 0, .25);
}

a.button-link:hover {
    background: var(--accent-strong, #3b82f6);
}

a.button-link:focus-visible {
    outline: 3px solid var(--focus, #38bdf8);
    outline-offset: 2px;
}

/* SR-only helper (if not already present) */
.sr-only {
    position: absolute !important;
    width: 1px !important;
    height: 1px !important;
    padding: 0 !important;
    margin: -1px !important;
    overflow: hidden !important;
    clip: rect(0 0 1px 1px) !important;
    white-space: nowrap !important;
    border: 0 !important;
}

/* Link end  */

/* ===== Sortable table ===== */
.sortable-table {
    width: 100%;
    border-collapse: collapse;
    background: var(--surface, #111827);
    color: var(--text, #e8eef6);
    border: 1px solid var(--border, #2a3648);
    border-radius: .75rem;
    overflow: hidden;
}

/* Cell spacing and borders */
.sortable-table th,
.sortable-table td {
    padding: .6rem .8rem;
    border-bottom: 1px solid var(--border, #2a3648);
    vertical-align: top;
}

/* Header buttons */
.sortable-table thead th {
    text-align: left;
    background: var(--surface-2, #1f2937);
}

.sortable-table thead th button {
    all: unset;
    display: inline-flex;
    align-items: center;
    gap: .35rem;
    cursor: pointer;
    color: inherit;
    padding: .25rem .25rem;
    border-radius: .35rem;
}

.sortable-table thead th button:hover {
    background: rgba(255, 255, 255, .06);
}

.sortable-table thead th button:focus-visible {
    outline: 3px solid var(--focus, #38bdf8);
    outline-offset: 2px;
}

/* Sort indicators using aria-sort on TH */
.sortable-table thead th[aria-sort="ascending"] button::after {
    content: "▲";
    font-size: .85em;
}

.sortable-table thead th[aria-sort="descending"] button::after {
    content: "▼";
    font-size: .85em;
}

.sortable-table thead th[aria-sort="none"] button::after {
    content: "↕";
    font-size: .85em;
    opacity: .7;
}

/* Zebra rows for readability */
.sortable-table tbody tr:nth-child(odd) {
    background: rgba(255, 255, 255, 0.02);
}

/* Make sure Reset button aligns nicely in actions row */
.table.actions {
    display: flex;
    justify-content: flex-end;
    gap: .5rem;
}

/* Table end  */

/* === AA contrast for code elements (global) === */
/* Tokens (override any earlier values) */
:root {
    --code-bg: #0f172a;
    /* very dark slate */
    --code-text: #e8eef6;
    /* light text */
    --code-bd: #334155;
    /* subtle border */
}

/* Inline code chips */
code:not(pre code) {
    color: var(--code-text) !important;
    background: var(--code-bg) !important;
    border: 1px solid var(--code-bd);
    padding: .1em .4em;
    border-radius: .35rem;
    font: 500 .9em/1 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
    opacity: 1 !important;
    /* defeat low-opacity defaults */
    white-space: break-spaces;
    /* wrap long tokens on small screens */
}

/* Code blocks */
pre {
    color: var(--code-text) !important;
    background: var(--code-bg) !important;
    border: 1px solid var(--code-bd);
    padding: .75rem 1rem;
    border-radius: .5rem;
    overflow: auto;
    /* scroll if needed */
    margin: .75rem 0;
}

pre code {
    background: transparent !important;
    /* avoid double bg */
    color: inherit;
    border: 0;
    padding: 0;
    white-space: pre;
    /* keep block formatting */
}

/* Optional: code inside links keeps the link action but uses the AA chip */
a>code {
    text-decoration: none;
}

a:hover>code {
    box-shadow: 0 0 0 2px rgba(255, 255, 255, .08) inset;
}

/* Code contrast update end  */


/* ===== Tooltips ===== */
.tooltip-examples p {
    display: flex;
    align-items: center;
    gap: .5rem;
    flex-wrap: wrap;
}

.tooltip-wrapper {
    position: relative;
    display: inline-flex;
    align-items: center;
}

/* Trigger styles */
.tooltip-trigger {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    min-width: 2rem;
    min-height: 2rem;
    padding: 0 .5rem;
    border: 1px solid var(--border, #2a3648);
    border-radius: .5rem;
    background: var(--surface, #111827);
    color: var(--text, #e8eef6);
    cursor: pointer;
}

.tooltip-trigger.icon-help {
    width: 2rem;
    padding: 0;
    font-weight: 700;
}

.tooltip-trigger:hover {
    background: var(--surface-2, #1f2937);
}

.tooltip-trigger:focus-visible {
    outline: 3px solid var(--focus, #38bdf8);
    outline-offset: 2px;
}

/* Bubble */
.tooltip-bubble {
    position: absolute;
    z-index: 20;
    max-width: min(36ch, 80vw);
    padding: .45rem .6rem;
    border-radius: .5rem;
    border: 1px solid var(--border, #2a3648);
    background: var(--surface-2, #1f2937);
    color: var(--text, #e8eef6);
    box-shadow: 0 8px 24px rgba(0, 0, 0, .45);
    font-size: .9375rem;
    line-height: 1.35;
    pointer-events: none;
    /* not interactive */
    opacity: 0;
    transform: translateY(-4px);
}

/* Placement (top / right / bottom / left) */
.tooltip-wrapper[data-placement="top"] .tooltip-bubble {
    bottom: calc(100% + 8px);
    left: 50%;
    transform: translate(-50%, -4px);
}

.tooltip-wrapper[data-placement="right"] .tooltip-bubble {
    top: 50%;
    left: calc(100% + 8px);
    transform: translate(4px, -50%);
}

.tooltip-wrapper[data-placement="bottom"] .tooltip-bubble {
    top: calc(100% + 8px);
    left: 50%;
    transform: translate(-50%, 4px);
}

.tooltip-wrapper[data-placement="left"] .tooltip-bubble {
    top: 50%;
    right: calc(100% + 8px);
    transform: translate(-4px, -50%);
}

/* Visible state (we toggle [hidden]) */
.tooltip-bubble:not([hidden]) {
    opacity: 1;
    transform: translate(0, 0);
}

/* Arrow */
.tooltip-bubble::after {
    content: "";
    position: absolute;
    width: 8px;
    height: 8px;
    background: var(--surface-2, #1f2937);
    border-left: 1px solid var(--border, #2a3648);
    border-top: 1px solid var(--border, #2a3648);
    transform: rotate(45deg);
}

.tooltip-wrapper[data-placement="top"] .tooltip-bubble::after {
    bottom: -5px;
    left: calc(50% - 4px);
    transform: rotate(45deg);
}

.tooltip-wrapper[data-placement="right"] .tooltip-bubble::after {
    left: -5px;
    top: calc(50% - 4px);
    transform: rotate(45deg);
}

.tooltip-wrapper[data-placement="bottom"] .tooltip-bubble::after {
    top: -5px;
    left: calc(50% - 4px);
    transform: rotate(45deg);
}

.tooltip-wrapper[data-placement="left"] .tooltip-bubble::after {
    right: -5px;
    top: calc(50% - 4px);
    transform: rotate(45deg);
}

/* Reduced motion */
@media (prefers-reduced-motion: reduce) {
    .tooltip-bubble {
        transition: none !important;
    }
}

/* Tooltips end  */