/* ---------------------------------------------------------------
 * docs.css — buyer-package developer docs portal chrome.
 *
 * Three layers:
 *   1. /docs/  index view  → demo-docs-hero · demo-docs-index
 *   2. /docs/?doc=…       → demo-docs (3-col) · demo-docs__main · rails
 *   3. demo-doc-code primitive → fenced code blocks rendered by
 *      DocsRenderer.php (same shape every doc reuses)
 *
 * Tokens-only — no magic numbers in colors, spacings, radii, shadows.
 * Mobile-first; ≥ 1024px unlocks 2-col (TOC + main); ≥ 1280px unlocks
 * the right rail. Reduce-motion-safe; light + dark parity end-to-end.
 *
 * Variants of the buyer-package primitives (`demo-card`, `demo-pill`,
 * `demo-btn`) are reused as-is — this file only adds the docs-specific
 * containers.
 * ----------------------------------------------------------------- */

/* =========== INDEX VIEW (no ?doc=) =========== */

.demo-docs-hero {
    background:
        radial-gradient(900px 500px at 90% -20%, color-mix(in srgb, var(--demo-accent) 14%, transparent) 0%, transparent 60%),
        var(--demo-bg);
    border-bottom: 1px solid var(--demo-border-subtle);
    padding-block: var(--demo-space-9);
}

.demo-docs-hero__inner {
    max-width: 960px;
    margin: 0 auto;
    padding-inline: var(--demo-space-6);
}

.demo-docs-hero__title {
    font-size: clamp(2.25rem, 4vw, 3rem);
    line-height: 1.1;
    font-weight: 800;
    letter-spacing: -0.02em;
    margin: var(--demo-space-3) 0 var(--demo-space-2);
    color: var(--demo-fg);
}

.demo-docs-hero__lede {
    color: var(--demo-fg-muted);
    max-width: 680px;
    font-size: 1.125rem;
    line-height: 1.6;
    margin: 0 0 var(--demo-space-6);
}

.demo-docs-hero__cta {
    display: flex;
    flex-wrap: wrap;
    gap: var(--demo-space-3);
}

.demo-docs-index {
    background: var(--demo-bg-elevated);
    padding-block: var(--demo-space-9);
}

.demo-docs-index__inner {
    max-width: 1280px;
    margin: 0 auto;
    padding-inline: var(--demo-space-6);
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-9);
}

.demo-docs-index__track {
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-5);
}

.demo-docs-index__track-head {
    display: grid;
    grid-template-columns: auto 1fr auto;
    gap: var(--demo-space-4);
    align-items: center;
}

.demo-docs-index__track-icon {
    width: 56px;
    height: 56px;
    display: grid;
    place-items: center;
    border-radius: var(--demo-radius-lg);
    background: color-mix(in srgb, var(--demo-accent) 14%, transparent);
    color: var(--demo-accent);
}

.demo-docs-index__track-icon .material-symbols-outlined {
    font-size: 28px;
}

.demo-docs-index__track-meta {
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-2);
    min-width: 0;
}

.demo-docs-index__track-title {
    margin: 0;
    font-size: 1.5rem;
    line-height: 1.2;
    font-weight: 700;
    color: var(--demo-fg);
}

.demo-docs-index__track-lede {
    margin: 0;
    color: var(--demo-fg-muted);
    font-size: 0.95rem;
}

.demo-docs-index__track-count {
    display: flex;
    flex-direction: column;
    align-items: flex-end;
    line-height: 1;
    color: var(--demo-fg-muted);
}

.demo-docs-index__track-count strong {
    font-size: 1.75rem;
    font-weight: 800;
    color: var(--demo-fg);
}

.demo-docs-index__track-count span {
    font-size: 0.8125rem;
    text-transform: uppercase;
    letter-spacing: 0.08em;
}

.demo-docs-index__cards {
    list-style: none;
    margin: 0;
    padding: 0;
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(min(100%, 280px), 1fr));
    gap: var(--demo-space-4);
}

.demo-docs-index__card {
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-2);
    padding: var(--demo-space-5);
    text-decoration: none;
    color: inherit;
    height: 100%;
    min-width: 0;
}

.demo-docs-index__card--headline {
    border-color: color-mix(in srgb, var(--demo-accent) 35%, var(--demo-border-subtle));
    background:
        linear-gradient(180deg, color-mix(in srgb, var(--demo-accent) 6%, transparent) 0%, transparent 60%),
        var(--demo-bg);
}

.demo-docs-index__card-head {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--demo-space-2);
}

.demo-docs-index__card-position {
    font-family: var(--demo-font-mono, ui-monospace, SFMono-Regular, monospace);
    font-size: 0.75rem;
    font-weight: 600;
    color: var(--demo-fg-muted);
    background: var(--demo-bg-elevated);
    border: 1px solid var(--demo-border-subtle);
    padding: 0.125rem 0.4rem;
    border-radius: var(--demo-radius-sm);
}

.demo-docs-index__card-lockstep {
    font-size: 0.75rem;
    font-weight: 600;
    color: color-mix(in srgb, var(--demo-warn, var(--demo-accent)) 90%, var(--demo-fg));
    background: color-mix(in srgb, var(--demo-warn, var(--demo-accent)) 12%, transparent);
    padding: 0.125rem 0.5rem;
    border-radius: var(--demo-radius-pill);
}

.demo-docs-index__card-readtime {
    font-size: 0.75rem;
    color: var(--demo-fg-muted);
}

.demo-docs-index__card-title {
    margin: var(--demo-space-1) 0 0;
    font-size: 1.125rem;
    line-height: 1.3;
    font-weight: 700;
    color: var(--demo-fg);
}

.demo-docs-index__card-lede {
    margin: 0;
    color: var(--demo-fg-muted);
    font-size: 0.9rem;
    line-height: 1.5;
}

.demo-docs-index__card-xref {
    margin: var(--demo-space-1) 0 0;
    font-size: 0.8125rem;
    color: var(--demo-fg-muted);
    display: inline-flex;
    align-items: center;
    gap: var(--demo-space-1);
}

.demo-docs-index__card-xref .material-symbols-outlined {
    font-size: 16px;
}

.demo-docs-index__card-xref code {
    font-size: 0.75rem;
    background: var(--demo-bg-elevated);
    padding: 0.125rem 0.375rem;
    border-radius: var(--demo-radius-sm);
    border: 1px solid var(--demo-border-subtle);
}

/* =========== DOC VIEW =========== */

.demo-docs {
    --docs-rail-w-left: 260px;
    --docs-rail-w-right: 240px;
    --docs-content-max: 720px;
    display: grid;
    grid-template-columns: 1fr;
    gap: var(--demo-space-6);
    max-width: 1440px;
    margin: 0 auto;
    padding: var(--demo-space-6) var(--demo-space-5) var(--demo-space-9);
    color: var(--demo-fg);
}

.demo-docs__skip {
    position: absolute;
    inset-inline-start: var(--demo-space-3);
    inset-block-start: var(--demo-space-3);
    background: var(--demo-fg);
    color: var(--demo-bg);
    padding: 0.5rem 0.75rem;
    border-radius: var(--demo-radius-sm);
    text-decoration: none;
    transform: translateY(-200%);
    transition: transform 120ms ease-out;
    z-index: 50;
}

.demo-docs__skip:focus-visible {
    transform: translateY(0);
    outline: 2px solid var(--demo-accent);
    outline-offset: 2px;
}

@media (min-width: 1024px) {
    .demo-docs {
        grid-template-columns: var(--docs-rail-w-left) minmax(0, 1fr);
        gap: var(--demo-space-8);
    }
}

@media (min-width: 1280px) {
    .demo-docs {
        grid-template-columns: var(--docs-rail-w-left) minmax(0, 1fr) var(--docs-rail-w-right);
    }
}

/* ----- Left rail (TOC) ----- */

.demo-docs__rail--left {
    display: none;
}

@media (min-width: 1024px) {
    .demo-docs__rail--left {
        display: block;
    }
}

.demo-docs__rail-inner {
    position: sticky;
    top: var(--demo-space-6);
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-3);
    max-height: calc(100vh - 8rem);
    overflow-y: auto;
    padding-right: var(--demo-space-2);
}

.demo-docs__rail-home {
    display: inline-flex;
    align-items: center;
    gap: var(--demo-space-1);
    text-decoration: none;
    width: fit-content;
}

.demo-docs__rail-home .material-symbols-outlined {
    font-size: 18px;
}

.demo-docs__track {
    background: var(--demo-bg-elevated);
    border: 1px solid var(--demo-border-subtle);
    border-radius: var(--demo-radius-md);
    overflow: hidden;
}

.demo-docs__track[open] {
    background: var(--demo-bg);
}

.demo-docs__track-summary {
    list-style: none;
    cursor: pointer;
    padding: var(--demo-space-3) var(--demo-space-4);
    display: grid;
    grid-template-columns: auto 1fr auto auto;
    align-items: center;
    gap: var(--demo-space-2);
    color: var(--demo-fg);
    font-weight: 600;
    user-select: none;
}

.demo-docs__track-summary::-webkit-details-marker { display: none; }

.demo-docs__track-summary::after {
    content: 'expand_more';
    font-family: 'Material Symbols Outlined';
    font-size: 18px;
    color: var(--demo-fg-muted);
    transition: transform 160ms ease-out;
}

.demo-docs__track[open] > .demo-docs__track-summary::after {
    transform: rotate(180deg);
}

.demo-docs__track-icon {
    font-size: 18px;
    color: var(--demo-accent);
}

.demo-docs__track-count {
    background: var(--demo-bg-elevated);
    color: var(--demo-fg-muted);
    font-size: 0.75rem;
    font-weight: 600;
    padding: 0.125rem 0.5rem;
    border-radius: var(--demo-radius-pill);
}

.demo-docs__track-list {
    list-style: none;
    margin: 0;
    padding: 0 var(--demo-space-3) var(--demo-space-3);
    display: flex;
    flex-direction: column;
    gap: 2px;
}

.demo-docs__track-link {
    display: grid;
    grid-template-columns: auto 1fr auto;
    align-items: center;
    gap: var(--demo-space-2);
    padding: var(--demo-space-2) var(--demo-space-3);
    border-radius: var(--demo-radius-sm);
    text-decoration: none;
    color: var(--demo-fg-muted);
    font-size: 0.875rem;
    transition: background 120ms ease-out, color 120ms ease-out;
}

.demo-docs__track-link:hover {
    background: color-mix(in srgb, var(--demo-accent) 8%, transparent);
    color: var(--demo-fg);
}

.demo-docs__track-link.is-active {
    background: color-mix(in srgb, var(--demo-accent) 14%, transparent);
    color: var(--demo-accent);
    font-weight: 600;
}

.demo-docs__track-link-position {
    font-family: var(--demo-font-mono, ui-monospace, monospace);
    font-size: 0.6875rem;
    font-weight: 700;
    color: var(--demo-fg-muted);
    background: var(--demo-bg-elevated);
    padding: 0.125rem 0.3rem;
    border-radius: var(--demo-radius-sm);
}

.demo-docs__track-link.is-active .demo-docs__track-link-position {
    background: color-mix(in srgb, var(--demo-accent) 22%, transparent);
    color: var(--demo-accent);
}

.demo-docs__track-link-tag {
    font-size: 0.875rem;
    line-height: 1;
}

/* ----- Main column ----- */

.demo-docs__main {
    min-width: 0;
}

.demo-docs__main:focus-visible {
    outline: 2px solid var(--demo-accent);
    outline-offset: 4px;
}

.demo-docs__crumbs {
    margin-bottom: var(--demo-space-4);
}

.demo-docs__crumbs ol {
    list-style: none;
    margin: 0;
    padding: 0;
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: var(--demo-space-1);
    font-size: 0.875rem;
    color: var(--demo-fg-muted);
}

.demo-docs__crumbs li:not(:last-child)::after {
    content: '/';
    margin-inline-start: var(--demo-space-1);
    color: var(--demo-fg-muted);
}

.demo-docs__crumbs a {
    color: var(--demo-fg-muted);
    text-decoration: none;
}

.demo-docs__crumbs a:hover {
    color: var(--demo-fg);
    text-decoration: underline;
}

.demo-docs__crumbs li[aria-current='page'] {
    color: var(--demo-fg);
    font-weight: 600;
}

.demo-docs__head {
    border-bottom: 1px solid var(--demo-border-subtle);
    padding-bottom: var(--demo-space-5);
    margin-bottom: var(--demo-space-6);
}

.demo-docs__head-meta {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: var(--demo-space-2);
    margin-bottom: var(--demo-space-3);
    font-size: 0.8125rem;
}

.demo-docs__head-position {
    font-family: var(--demo-font-mono, ui-monospace, monospace);
    font-weight: 700;
    color: var(--demo-fg-muted);
    background: var(--demo-bg-elevated);
    padding: 0.125rem 0.5rem;
    border-radius: var(--demo-radius-sm);
}

.demo-docs__head-readtime,
.demo-docs__head-lens,
.demo-docs__head-lockstep {
    display: inline-flex;
    align-items: center;
    gap: 0.25rem;
    color: var(--demo-fg-muted);
}

.demo-docs__head-lockstep {
    color: color-mix(in srgb, var(--demo-warn, var(--demo-accent)) 90%, var(--demo-fg));
    font-weight: 600;
}

.demo-docs__head-readtime .material-symbols-outlined,
.demo-docs__head-lens     .material-symbols-outlined,
.demo-docs__head-lockstep .material-symbols-outlined { font-size: 16px; }

.demo-docs__title {
    margin: 0 0 var(--demo-space-2);
    font-size: clamp(1.875rem, 3vw, 2.5rem);
    line-height: 1.15;
    letter-spacing: -0.02em;
    font-weight: 800;
    color: var(--demo-fg);
}

.demo-docs__lede {
    margin: 0;
    font-size: 1.125rem;
    color: var(--demo-fg-muted);
    line-height: 1.55;
    max-width: var(--docs-content-max);
}

/* ----- Doc body (Parsedown output) ----- */

.demo-docs__body {
    max-width: var(--docs-content-max);
    color: var(--demo-fg);
}

.demo-docs__body > * + * { margin-top: var(--demo-space-4); }
.demo-docs__body > h2 + *,
.demo-docs__body > h3 + * { margin-top: var(--demo-space-3); }

.demo-docs__body h2 {
    margin-top: var(--demo-space-7);
    font-size: 1.5rem;
    font-weight: 700;
    line-height: 1.25;
    letter-spacing: -0.01em;
    color: var(--demo-fg);
    scroll-margin-top: var(--demo-space-7);
}

.demo-docs__body h3 {
    margin-top: var(--demo-space-5);
    font-size: 1.125rem;
    font-weight: 700;
    line-height: 1.3;
    color: var(--demo-fg);
    scroll-margin-top: var(--demo-space-7);
}

.demo-docs__body h4 {
    margin-top: var(--demo-space-4);
    font-size: 1rem;
    font-weight: 700;
    color: var(--demo-fg);
}

.demo-docs__body p,
.demo-docs__body li {
    line-height: 1.65;
    color: var(--demo-fg);
}

.demo-docs__body ul,
.demo-docs__body ol {
    padding-inline-start: 1.5rem;
}

.demo-docs__body li + li { margin-top: var(--demo-space-1); }

.demo-docs__body a {
    color: var(--demo-accent);
    text-decoration: underline;
    text-underline-offset: 3px;
    text-decoration-thickness: 1.5px;
    text-decoration-color: color-mix(in srgb, var(--demo-accent) 50%, transparent);
}

.demo-docs__body a:hover {
    text-decoration-color: var(--demo-accent);
}

.demo-docs__body code {
    font-family: var(--demo-font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);
    font-size: 0.9em;
    background: var(--demo-bg-elevated);
    color: var(--demo-fg);
    padding: 0.1em 0.35em;
    border-radius: var(--demo-radius-sm);
    border: 1px solid var(--demo-border-subtle);
}

.demo-docs__body blockquote {
    margin: var(--demo-space-4) 0;
    padding: var(--demo-space-3) var(--demo-space-4);
    border-left: 3px solid var(--demo-accent);
    background: color-mix(in srgb, var(--demo-accent) 5%, transparent);
    color: var(--demo-fg);
    border-radius: 0 var(--demo-radius-md) var(--demo-radius-md) 0;
}

.demo-docs__body blockquote > * + * { margin-top: var(--demo-space-2); }

.demo-docs__body table {
    border-collapse: collapse;
    border: 1px solid var(--demo-border-subtle);
    border-radius: var(--demo-radius-md);
    overflow: hidden;
    width: 100%;
    font-size: 0.875rem;
}

.demo-docs__body th,
.demo-docs__body td {
    padding: var(--demo-space-2) var(--demo-space-3);
    text-align: left;
    border-bottom: 1px solid var(--demo-border-subtle);
    vertical-align: top;
}

.demo-docs__body th {
    background: var(--demo-bg-elevated);
    font-weight: 600;
}

.demo-docs__body tr:last-child td { border-bottom: 0; }

.demo-docs__body hr {
    border: 0;
    border-top: 1px solid var(--demo-border-subtle);
    margin: var(--demo-space-6) 0;
}

.demo-docs__body img {
    max-width: 100%;
    height: auto;
    border-radius: var(--demo-radius-md);
    border: 1px solid var(--demo-border-subtle);
}

.demo-docs__body details {
    border: 1px solid var(--demo-border-subtle);
    border-radius: var(--demo-radius-md);
    background: var(--demo-bg-elevated);
    padding: var(--demo-space-3) var(--demo-space-4);
}

.demo-docs__body details > summary {
    cursor: pointer;
    font-weight: 600;
    color: var(--demo-fg);
}

.demo-docs__body details[open] > summary {
    margin-bottom: var(--demo-space-2);
}

/* ----- Doc code primitive (DocsRenderer output) ----- */

.demo-doc-code {
    margin-block: var(--demo-space-4);
    border: 1px solid var(--demo-border-subtle);
    border-radius: var(--demo-radius-md);
    overflow: hidden;
    background: var(--demo-bg-elevated);
}

.demo-doc-code__head {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--demo-space-2);
    padding: var(--demo-space-2) var(--demo-space-3);
    background: var(--demo-bg);
    border-bottom: 1px solid var(--demo-border-subtle);
}

.demo-doc-code__lang {
    text-transform: uppercase;
    font-size: 0.6875rem;
    letter-spacing: 0.06em;
}

.demo-doc-code__copy {
    display: inline-flex;
    align-items: center;
    gap: 0.25rem;
    border: 1px solid transparent;
    background: transparent;
    color: var(--demo-fg-muted);
    font-size: 0.8125rem;
    padding: 0.25rem 0.625rem;
    border-radius: var(--demo-radius-sm);
    cursor: pointer;
    transition: background 120ms ease-out, color 120ms ease-out, border-color 120ms ease-out;
}

.demo-doc-code__copy:hover {
    background: color-mix(in srgb, var(--demo-accent) 10%, transparent);
    color: var(--demo-fg);
    border-color: var(--demo-border-subtle);
}

.demo-doc-code__copy:focus-visible {
    outline: 2px solid var(--demo-accent);
    outline-offset: 2px;
}

.demo-doc-code__copy.is-copied {
    color: var(--demo-success, var(--demo-accent));
}

.demo-doc-code__copy .material-symbols-outlined { font-size: 16px; }

.demo-doc-code__pre {
    margin: 0;
    padding: var(--demo-space-3) var(--demo-space-4);
    overflow-x: auto;
    background: var(--demo-bg);
    color: var(--demo-fg);
    line-height: 1.55;
}

.demo-doc-code__pre code {
    background: transparent;
    border: 0;
    padding: 0;
    font-size: 0.85rem;
    color: inherit;
}

/* ----- Doc URL primitive (URL-only fenced block → "browser address bar")
 * Emitted by DocsRenderer::buildUrlBarElement() when a fenced code block
 * contains exactly one http(s) URL. Communicates "open this URL in a
 * browser" rather than "paste this snippet". The whole row is one anchor
 * — clicking anywhere on it navigates. The href is rewritten relative
 * when the URL points at localhost:8000 so click follows the current
 * origin. */
.demo-doc-url {
    display: flex;
    align-items: center;
    gap: var(--demo-space-3);
    margin-block: var(--demo-space-4);
    padding: var(--demo-space-2) var(--demo-space-3);
    background: var(--demo-bg-elevated);
    border: 1px solid var(--demo-border-subtle);
    border-radius: var(--demo-radius-md);
    color: var(--demo-fg);
    text-decoration: none;
    transition: background 120ms ease-out, border-color 120ms ease-out, transform 120ms ease-out;
}
.demo-doc-url:hover {
    background: color-mix(in srgb, var(--demo-accent) 6%, var(--demo-bg-elevated));
    border-color: color-mix(in srgb, var(--demo-accent) 40%, var(--demo-border-subtle));
}
.demo-doc-url:active { transform: translateY(1px); }
.demo-doc-url:focus-visible {
    outline: 2px solid var(--demo-accent);
    outline-offset: 2px;
}

.demo-doc-url__dots {
    flex: 0 0 36px;
    height: 8px;
    background-image:
        radial-gradient(circle at 4px 50%,  #ff5f57 0 4px, transparent 5px),
        radial-gradient(circle at 18px 50%, #febc2e 0 4px, transparent 5px),
        radial-gradient(circle at 32px 50%, #28c840 0 4px, transparent 5px);
    background-repeat: no-repeat;
}

.demo-doc-url__bar {
    flex: 1 1 auto;
    min-width: 0;
    background: var(--demo-bg);
    border: 1px solid var(--demo-border-subtle);
    border-radius: 999px;
    padding: 0.375rem 0.875rem;
    font-family: var(--demo-font-mono);
    font-size: 0.8125rem;
    color: var(--demo-fg);
    overflow: hidden;
    text-overflow: ellipsis;
    white-space: nowrap;
}
.demo-doc-url__text { color: inherit; }

.demo-doc-url__icon {
    flex: 0 0 auto;
    color: var(--demo-fg-muted);
    font-size: 18px;
    transition: color 120ms ease-out, transform 120ms ease-out;
}
.demo-doc-url:hover .demo-doc-url__icon {
    color: var(--demo-accent);
    transform: translate(1px, -1px);
}

@media (prefers-reduced-motion: reduce) {
    .demo-doc-url,
    .demo-doc-url__icon { transition: none; }
    .demo-doc-url:active { transform: none; }
    .demo-doc-url:hover .demo-doc-url__icon { transform: none; }
}

/* ----- Footer cards ----- */

.demo-docs__footer {
    margin-top: var(--demo-space-9);
    padding-top: var(--demo-space-6);
    border-top: 1px solid var(--demo-border-subtle);
}

.demo-docs__footer-cards {
    display: grid;
    grid-template-columns: 1fr;
    gap: var(--demo-space-3);
}

@media (min-width: 720px) {
    .demo-docs__footer-cards {
        grid-template-columns: repeat(3, minmax(0, 1fr));
    }
}

.demo-docs__footer-card {
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-1);
    padding: var(--demo-space-4);
    border-radius: var(--demo-radius-md);
    border: 1px solid var(--demo-border-subtle);
    background: var(--demo-bg-elevated);
    text-decoration: none;
    color: inherit;
    transition: border-color 120ms ease-out, transform 120ms ease-out, background 120ms ease-out;
    min-height: 96px;
}

.demo-docs__footer-card:hover {
    border-color: color-mix(in srgb, var(--demo-accent) 40%, var(--demo-border-subtle));
    background: color-mix(in srgb, var(--demo-accent) 4%, var(--demo-bg-elevated));
}

.demo-docs__footer-card--ghost {
    visibility: hidden;
}

.demo-docs__footer-card-eyebrow {
    display: inline-flex;
    align-items: center;
    gap: 0.25rem;
    color: var(--demo-fg-muted);
    font-size: 0.75rem;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    font-weight: 600;
}

.demo-docs__footer-card--prev .demo-docs__footer-card-eyebrow .material-symbols-outlined,
.demo-docs__footer-card--next .demo-docs__footer-card-eyebrow .material-symbols-outlined,
.demo-docs__footer-card--example .demo-docs__footer-card-eyebrow .material-symbols-outlined {
    font-size: 14px;
}

.demo-docs__footer-card--next .demo-docs__footer-card-eyebrow {
    justify-content: flex-end;
}

.demo-docs__footer-card-title {
    font-weight: 700;
    color: var(--demo-fg);
    font-size: 1rem;
}

.demo-docs__footer-card--example .demo-docs__footer-card-title code {
    background: transparent;
    border: 0;
    padding: 0;
    font-size: 0.95rem;
}

.demo-docs__footer-card-lede {
    color: var(--demo-fg-muted);
    font-size: 0.875rem;
    line-height: 1.5;
}

.demo-docs__footer-version {
    margin-top: var(--demo-space-5);
    color: var(--demo-fg-muted);
    font-size: 0.8125rem;
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: var(--demo-space-2);
}

.demo-docs__footer-version code {
    font-size: 0.8125rem;
}

.demo-docs__footer-version a {
    color: var(--demo-fg-muted);
    text-decoration: underline;
    text-decoration-color: var(--demo-border-subtle);
}

.demo-docs__footer-version a:hover {
    color: var(--demo-fg);
    text-decoration-color: var(--demo-accent);
}

/* Freshness chip (W8.P7 / Appendix K) — three states the footer renders
 * via the `data-freshness` attribute set by doc-shell.php. The chip
 * itself reuses the global `.demo-pill--{success,warn,error}` family so
 * the colour story stays consistent with the tier pills elsewhere. */
.demo-docs__footer-freshness {
    display: inline-flex;
    align-items: center;
    gap: var(--demo-space-1);
}

.demo-docs__footer-freshness .material-symbols-outlined {
    font-size: 1rem;
    line-height: 1;
}

.demo-docs__footer-version[data-freshness="stale"] .demo-docs__footer-hint,
.demo-docs__footer-version[data-freshness="mismatch"] .demo-docs__footer-hint {
    flex-basis: 100%;
    color: var(--demo-fg);
    background: color-mix(in srgb, var(--demo-warn) 8%, transparent);
    border-left: 3px solid var(--demo-warn);
    padding: var(--demo-space-2) var(--demo-space-3);
    border-radius: var(--demo-radius-sm);
    margin-top: var(--demo-space-2);
}

.demo-docs__footer-version[data-freshness="mismatch"] .demo-docs__footer-hint {
    background: color-mix(in srgb, var(--demo-error) 10%, transparent);
    border-left-color: var(--demo-error);
}

/* ----- Right rail (On this page + embed) ----- */

.demo-docs__rail--right {
    display: none;
}

@media (min-width: 1280px) {
    .demo-docs__rail--right {
        display: block;
    }
}

.demo-docs__rail--right > * + * {
    margin-top: var(--demo-space-5);
}

.demo-docs__onthispage,
.demo-docs__embed {
    position: sticky;
    top: var(--demo-space-6);
}

.demo-docs__onthispage-title {
    margin: 0 0 var(--demo-space-2);
    font-size: 0.8125rem;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--demo-fg-muted);
    font-weight: 600;
}

.demo-docs__onthispage-list {
    list-style: none;
    margin: 0;
    padding: 0;
    border-left: 2px solid var(--demo-border-subtle);
    display: flex;
    flex-direction: column;
    gap: 2px;
}

.demo-docs__onthispage-item a {
    display: block;
    padding: 0.25rem 0.625rem;
    text-decoration: none;
    color: var(--demo-fg-muted);
    font-size: 0.8125rem;
    line-height: 1.4;
    border-left: 2px solid transparent;
    margin-left: -2px;
    transition: color 120ms ease-out, border-color 120ms ease-out;
}

.demo-docs__onthispage-item--h3 a {
    padding-left: 1.25rem;
    font-size: 0.78125rem;
}

.demo-docs__onthispage-item a:hover {
    color: var(--demo-fg);
}

.demo-docs__onthispage-item a.is-active {
    color: var(--demo-accent);
    border-left-color: var(--demo-accent);
    font-weight: 600;
}

/* Sticky-canvas embed */

.demo-docs__embed {
    border: 1px solid var(--demo-border-subtle);
    border-radius: var(--demo-radius-md);
    background: var(--demo-bg-elevated);
    overflow: hidden;
    margin-top: var(--demo-space-5);
}

.demo-docs__embed-header {
    display: flex;
    align-items: center;
    gap: var(--demo-space-2);
    padding: var(--demo-space-2) var(--demo-space-3);
    border-bottom: 1px solid var(--demo-border-subtle);
    background: var(--demo-bg);
    font-size: 0.875rem;
    color: var(--demo-fg);
}

.demo-docs__embed-header .material-symbols-outlined {
    font-size: 18px;
    color: var(--demo-accent);
}

.demo-docs__embed-label {
    flex: 1;
    font-weight: 600;
}

.demo-docs__embed-open {
    display: inline-flex;
    align-items: center;
    color: var(--demo-fg-muted);
    text-decoration: none;
    padding: 0.25rem;
    border-radius: var(--demo-radius-sm);
}

.demo-docs__embed-open:hover {
    color: var(--demo-accent);
    background: color-mix(in srgb, var(--demo-accent) 10%, transparent);
}

.demo-docs__embed-open .material-symbols-outlined { font-size: 16px; }

.demo-docs__embed-frame {
    padding: var(--demo-space-4);
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-2);
    min-height: 220px;
    align-items: flex-start;
}

.demo-docs__embed-load {
    align-self: stretch;
    justify-content: center;
}

.demo-docs__embed-hint {
    margin: 0;
    color: var(--demo-fg-muted);
    font-size: 0.8125rem;
    line-height: 1.5;
}

.demo-docs__embed iframe {
    width: 100%;
    height: 480px;
    max-height: calc(100vh - 16rem);
    border: 0;
    background: var(--demo-bg);
    display: block;
}

/* W8 §3.P5 — three embed surface states, set by docs-toc.js as the
 * iframe boots + the example-anchor-listener.js receiver acks back.
 * Each state tints the header label so the buyer can see the iframe
 * actually responded — important for the novel-beat trust contract.
 *
 *   default (no attr) — hidden/idle, "▶ Load preview" button visible.
 *   "loading"          — iframe mounted, awaiting first ack.
 *   "synced"           — receiver acked; scroll-sync active.
 */
.demo-docs__embed[data-docs-embed-state='loading'] .demo-docs__embed-label::after,
.demo-docs__embed[data-docs-embed-state='synced']  .demo-docs__embed-label::after {
    content: '';
    display: inline-block;
    width: 8px;
    height: 8px;
    border-radius: 50%;
    margin-inline-start: var(--demo-space-2);
    vertical-align: middle;
    background: var(--demo-fg-muted);
    animation: demo-docs-embed-pulse 1.4s ease-in-out infinite;
}

.demo-docs__embed[data-docs-embed-state='synced'] .demo-docs__embed-label::after {
    background: var(--demo-success, #10b981);
    animation: none;
}

.demo-docs__embed[data-docs-embed-state='loading'] .demo-docs__embed-load,
.demo-docs__embed[data-docs-embed-state='synced'] .demo-docs__embed-load,
.demo-docs__embed[data-docs-embed-state='loading'] .demo-docs__embed-hint,
.demo-docs__embed[data-docs-embed-state='synced'] .demo-docs__embed-hint {
    display: none;
}

@keyframes demo-docs-embed-pulse {
    0%, 100% { opacity: 0.4; transform: scale(0.85); }
    50%      { opacity: 1;   transform: scale(1); }
}

@media (prefers-reduced-motion: reduce) {
    .demo-docs__skip,
    .demo-docs__track-summary::after,
    .demo-docs__track-link,
    .demo-docs__footer-card,
    .demo-doc-code__copy,
    .demo-docs__embed-open,
    .demo-docs__embed[data-docs-embed-state='loading'] .demo-docs__embed-label::after {
        transition: none;
        animation: none;
    }
}

/* =========== CMD-K SEARCH MODAL (Appendix H) =========== */

.demo-cmdk {
    position: fixed;
    inset: 0;
    z-index: 100;
    display: flex;
    align-items: flex-start;
    justify-content: center;
    padding-block: 12vh;
    padding-inline: var(--demo-space-4);
}

.demo-cmdk[hidden] { display: none; }

.demo-cmdk__backdrop {
    position: absolute;
    inset: 0;
    background: rgba(0, 0, 0, 0.5);
    backdrop-filter: blur(4px);
    cursor: pointer;
}

.demo-cmdk__dialog {
    position: relative;
    width: min(680px, 100%);
    background: var(--demo-bg-elevated);
    border: 1px solid var(--demo-border-subtle);
    border-radius: var(--demo-radius-lg);
    box-shadow: 0 24px 48px -12px rgba(0, 0, 0, 0.25);
    overflow: hidden;
    display: flex;
    flex-direction: column;
    max-height: 70vh;
}

.demo-cmdk__header {
    display: grid;
    grid-template-columns: auto 1fr auto;
    align-items: center;
    gap: var(--demo-space-2);
    padding: var(--demo-space-3) var(--demo-space-4);
    border-bottom: 1px solid var(--demo-border-subtle);
}

.demo-cmdk__header .material-symbols-outlined {
    font-size: 20px;
    color: var(--demo-fg-muted);
}

.demo-cmdk__input {
    border: 0;
    background: transparent;
    color: var(--demo-fg);
    font-size: 1rem;
    line-height: 1.4;
    outline: none;
    width: 100%;
    padding: 0.25rem 0;
}

.demo-cmdk__input::placeholder {
    color: var(--demo-fg-muted);
}

.demo-cmdk__esc {
    font-family: var(--demo-font-mono, ui-monospace, monospace);
    font-size: 0.6875rem;
    background: var(--demo-bg);
    border: 1px solid var(--demo-border-subtle);
    border-radius: var(--demo-radius-sm);
    padding: 0.125rem 0.4rem;
    color: var(--demo-fg-muted);
}

.demo-cmdk__list {
    list-style: none;
    margin: 0;
    padding: var(--demo-space-2);
    overflow-y: auto;
    flex: 1;
}

.demo-cmdk__item {
    display: grid;
    grid-template-columns: auto 1fr auto;
    align-items: center;
    gap: var(--demo-space-2);
    padding: var(--demo-space-2) var(--demo-space-3);
    border-radius: var(--demo-radius-sm);
    cursor: pointer;
    transition: background 80ms ease-out;
}

.demo-cmdk__item.is-active,
.demo-cmdk__item:hover {
    background: color-mix(in srgb, var(--demo-accent) 12%, transparent);
}

.demo-cmdk__type-pill {
    font-family: var(--demo-font-mono, ui-monospace, monospace);
    font-size: 0.625rem;
    font-weight: 700;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    background: var(--demo-bg);
    border: 1px solid var(--demo-border-subtle);
    border-radius: var(--demo-radius-sm);
    padding: 0.125rem 0.4rem;
    color: var(--demo-fg-muted);
    min-width: 36px;
    text-align: center;
}

.demo-cmdk__type-pill--doc          { color: color-mix(in srgb, var(--demo-accent) 80%, var(--demo-fg)); }
.demo-cmdk__type-pill--doc-section  { color: var(--demo-fg-muted); }
.demo-cmdk__type-pill--example      { color: color-mix(in srgb, var(--demo-warn, var(--demo-accent)) 90%, var(--demo-fg)); }
.demo-cmdk__type-pill--sample       { color: color-mix(in srgb, var(--demo-success, var(--demo-accent)) 90%, var(--demo-fg)); }

.demo-cmdk__item-title {
    color: var(--demo-fg);
    font-size: 0.95rem;
    font-weight: 500;
    overflow: hidden;
    text-overflow: ellipsis;
    white-space: nowrap;
}

.demo-cmdk__item-section {
    color: var(--demo-fg-muted);
    font-size: 0.75rem;
    text-align: right;
    white-space: nowrap;
}

.demo-cmdk__empty {
    color: var(--demo-fg-muted);
    padding: var(--demo-space-5);
    text-align: center;
    font-size: 0.875rem;
}

.demo-cmdk__footer {
    display: flex;
    gap: var(--demo-space-4);
    padding: var(--demo-space-2) var(--demo-space-4);
    border-top: 1px solid var(--demo-border-subtle);
    background: var(--demo-bg);
    color: var(--demo-fg-muted);
    font-size: 0.75rem;
}

.demo-cmdk__footer kbd {
    font-family: var(--demo-font-mono, ui-monospace, monospace);
    font-size: 0.6875rem;
    background: var(--demo-bg-elevated);
    border: 1px solid var(--demo-border-subtle);
    border-radius: 3px;
    padding: 0 0.3rem;
    margin-right: 0.25rem;
    color: var(--demo-fg);
}

@media (prefers-reduced-motion: reduce) {
    .demo-cmdk__item {
        transition: none;
    }
}

/* =========== /docs/paths/ — Buyer-journey path pages (W8.P6) ===========
 *
 * Two layouts share this section:
 *   1. /docs/paths/        — index card grid surfacing all four paths
 *   2. /docs/paths/<slug>/ — per-path stepper page (vertical numbered
 *                             timeline of doc cards + outcome strip +
 *                             sibling-paths grid)
 *
 * The vertical stepper itself reuses the `.demo-stepper` primitive
 * shipped by W6.F.B.2 (loaded as `$pageExtraStylesheets` on path
 * pages). Only the docs-specific layout chrome lives in this file.
 * ----------------------------------------------------------------- */

.demo-docs-paths {
    background: var(--demo-bg);
    min-height: 100vh;
}

.demo-docs-paths__hero,
.demo-docs-paths__index-hero {
    background:
        radial-gradient(900px 500px at 90% -20%, color-mix(in srgb, var(--demo-accent) 14%, transparent) 0%, transparent 60%),
        var(--demo-bg);
    border-bottom: 1px solid var(--demo-border-subtle);
    padding-block: var(--demo-space-9);
}

.demo-docs-paths__hero[data-path-tone="success"] {
    background:
        radial-gradient(900px 500px at 90% -20%, color-mix(in srgb, var(--demo-success) 14%, transparent) 0%, transparent 60%),
        var(--demo-bg);
}

.demo-docs-paths__hero[data-path-tone="warn"] {
    background:
        radial-gradient(900px 500px at 90% -20%, color-mix(in srgb, var(--demo-warn) 14%, transparent) 0%, transparent 60%),
        var(--demo-bg);
}

.demo-docs-paths__hero[data-path-tone="info"] {
    background:
        radial-gradient(900px 500px at 90% -20%, color-mix(in srgb, var(--demo-info, var(--demo-accent)) 14%, transparent) 0%, transparent 60%),
        var(--demo-bg);
}

.demo-docs-paths__hero-inner {
    max-width: 960px;
    margin: 0 auto;
    padding-inline: var(--demo-space-6);
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-4);
}

.demo-docs-paths__eyebrow-row {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: var(--demo-space-3);
    color: var(--demo-fg-muted);
    font-size: 0.875rem;
}

.demo-docs-paths__hero-time {
    display: inline-flex;
    align-items: center;
    gap: var(--demo-space-1);
}

.demo-docs-paths__hero-title {
    font-size: clamp(2.25rem, 4vw, 3rem);
    line-height: 1.1;
    font-weight: 800;
    letter-spacing: -0.02em;
    margin: 0;
    color: var(--demo-fg);
    display: flex;
    align-items: center;
    gap: var(--demo-space-3);
    flex-wrap: wrap;
}

.demo-docs-paths__hero-icon {
    color: var(--demo-accent);
    font-size: 2.25rem !important;
}

.demo-docs-paths__hero-lede {
    color: var(--demo-fg-muted);
    max-width: 720px;
    font-size: 1.0625rem;
    line-height: 1.65;
    margin: 0;
}

.demo-docs-paths__hero-lede a {
    color: var(--demo-fg);
    text-decoration: underline;
    text-decoration-color: var(--demo-accent);
}

.demo-docs-paths__main {
    max-width: 960px;
    margin: 0 auto;
    padding: var(--demo-space-9) var(--demo-space-6);
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-8);
}

/* ----- Index card grid ----- */

.demo-docs-paths__cards {
    list-style: none;
    margin: 0;
    padding: 0;
    display: grid;
    grid-template-columns: 1fr;
    gap: var(--demo-space-5);
}

@media (min-width: 880px) {
    .demo-docs-paths__cards {
        grid-template-columns: 1fr 1fr;
    }
}

.demo-docs-paths__card {
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-3);
    padding: var(--demo-space-6);
    text-decoration: none;
    color: inherit;
    height: 100%;
    min-width: 0;
}

.demo-docs-paths__card-head {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    justify-content: space-between;
    gap: var(--demo-space-2);
}

.demo-docs-paths__card-time {
    color: var(--demo-fg-muted);
    font-size: 0.8125rem;
    display: inline-flex;
    align-items: center;
    gap: var(--demo-space-1);
}

.demo-docs-paths__card-title {
    margin: 0;
    font-size: 1.5rem;
    line-height: 1.2;
    font-weight: 700;
    color: var(--demo-fg);
    display: flex;
    align-items: center;
    gap: var(--demo-space-2);
}

.demo-docs-paths__card-icon {
    color: var(--demo-accent);
    font-size: 1.75rem !important;
}

.demo-docs-paths__card-lede {
    color: var(--demo-fg-muted);
    font-size: 0.95rem;
    line-height: 1.55;
    margin: 0;
}

.demo-docs-paths__card-outcome {
    background: color-mix(in srgb, var(--demo-success) 8%, transparent);
    border-left: 3px solid var(--demo-success);
    padding: var(--demo-space-2) var(--demo-space-3);
    border-radius: var(--demo-radius-sm);
    font-size: 0.875rem;
    color: var(--demo-fg);
    margin: 0;
    display: flex;
    align-items: flex-start;
    gap: var(--demo-space-2);
}

.demo-docs-paths__card-outcome .material-symbols-outlined {
    color: var(--demo-success);
    font-size: 1rem;
    margin-top: 2px;
}

.demo-docs-paths__card-foot {
    display: flex;
    align-items: center;
    justify-content: space-between;
    margin-top: auto;
    padding-top: var(--demo-space-3);
    border-top: 1px solid var(--demo-border-subtle);
    font-size: 0.875rem;
    gap: var(--demo-space-3);
    flex-wrap: wrap;
}

.demo-docs-paths__card-stats {
    color: var(--demo-fg-muted);
}

.demo-docs-paths__card-cta {
    color: var(--demo-accent);
    font-weight: 600;
    display: inline-flex;
    align-items: center;
    gap: var(--demo-space-1);
}

.demo-docs-paths__index-foot {
    text-align: center;
    color: var(--demo-fg-muted);
    margin: 0;
    font-size: 0.95rem;
}

.demo-docs-paths__index-foot a {
    color: var(--demo-fg);
    text-decoration: underline;
    text-decoration-color: var(--demo-accent);
}

/* ----- Per-path stepper view ----- */

.demo-docs-paths__stepper {
    /* The .demo-stepper primitive ships with `gap: var(--demo-space-5)` already.
     * No override needed. */
}

.demo-stepper__card-meta {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: var(--demo-space-2);
    color: var(--demo-fg-muted);
    font-size: 0.8125rem;
}

.demo-stepper__card-meta .demo-stepper__card-pill {
    display: inline-flex;
    align-items: center;
    gap: var(--demo-space-1);
}

.demo-stepper__card-meta .demo-stepper__card-pill .material-symbols-outlined {
    font-size: 1rem;
}

.demo-stepper__card-position {
    font-family: var(--demo-font-mono, ui-monospace, SFMono-Regular, monospace);
    font-size: 0.75rem;
    font-weight: 600;
    color: var(--demo-fg-muted);
    background: var(--demo-bg-elevated);
    border: 1px solid var(--demo-border-subtle);
    padding: 0.125rem 0.4rem;
    border-radius: var(--demo-radius-sm);
}

.demo-stepper__card-lockstep {
    font-size: 0.75rem;
    font-weight: 600;
    color: color-mix(in srgb, var(--demo-warn) 90%, var(--demo-fg));
    background: color-mix(in srgb, var(--demo-warn) 12%, transparent);
    padding: 0.125rem 0.5rem;
    border-radius: var(--demo-radius-pill);
}

.demo-stepper__card-readtime {
    display: inline-flex;
    align-items: center;
    gap: var(--demo-space-1);
}

.demo-stepper__card-readtime .material-symbols-outlined {
    font-size: 1rem;
}

.demo-docs-paths__outcome {
    display: flex;
    align-items: center;
    gap: var(--demo-space-3);
    padding: var(--demo-space-5);
    background: color-mix(in srgb, var(--demo-success) 8%, transparent);
    border: 1px solid color-mix(in srgb, var(--demo-success) 30%, var(--demo-border-subtle));
    border-radius: var(--demo-radius-md);
    font-size: 1rem;
    color: var(--demo-fg);
    margin: 0;
    flex-wrap: wrap;
}

.demo-docs-paths__outcome-icon {
    color: var(--demo-success);
    font-size: 1.5rem !important;
}

.demo-docs-paths__outcome-eyebrow {
    font-size: 0.75rem;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--demo-fg-muted);
    font-weight: 600;
}

.demo-docs-paths__outcome-text {
    font-weight: 600;
}

.demo-docs-paths__siblings {
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-4);
    padding-top: var(--demo-space-6);
    border-top: 1px solid var(--demo-border-subtle);
}

.demo-docs-paths__siblings-title {
    margin: 0;
    font-size: 1.125rem;
    font-weight: 700;
    color: var(--demo-fg);
}

.demo-docs-paths__siblings-list {
    list-style: none;
    margin: 0;
    padding: 0;
    display: grid;
    grid-template-columns: 1fr;
    gap: var(--demo-space-3);
}

@media (min-width: 720px) {
    .demo-docs-paths__siblings-list {
        grid-template-columns: 1fr 1fr 1fr;
    }
}

.demo-docs-paths__siblings-card {
    display: flex;
    flex-direction: column;
    gap: var(--demo-space-2);
    padding: var(--demo-space-4);
    text-decoration: none;
    color: inherit;
    height: 100%;
}

.demo-docs-paths__siblings-card-title {
    margin: 0;
    font-size: 0.95rem;
    font-weight: 700;
    color: var(--demo-fg);
    display: flex;
    align-items: center;
    gap: var(--demo-space-1);
}

.demo-docs-paths__siblings-card-title .material-symbols-outlined {
    font-size: 1.125rem;
    color: var(--demo-accent);
}

.demo-docs-paths__siblings-card-lede {
    margin: 0;
    color: var(--demo-fg-muted);
    font-size: 0.8125rem;
    line-height: 1.5;
    /* Clamp to 3 lines so the three sibling cards stay grid-aligned. */
    display: -webkit-box;
    -webkit-line-clamp: 3;
    -webkit-box-orient: vertical;
    overflow: hidden;
}

.demo-docs-paths__siblings-card-meta {
    margin-top: auto;
    color: var(--demo-fg-muted);
    font-size: 0.75rem;
}