/**
 * FastMediaSorter v2 Documentation Design System
 * Based on SZA Web Kit (Pine + Gold palette)
 * Ticket: S2976
 */

/* ==========================================================================
   1. Design Tokens & Theme Palettes (Step 01.1)
   ========================================================================== */

/*
 * SITE-EXPERIENCE rule 2: a portal token with a kit meaning is a reference to the kit token, so a
 * kit revision reaches the portal without a second edit. Every portal page links ../styles.css
 * before this file, and styles.css carries the kit tokens (a copy, until the kit is vendored -
 * the PAGE-STYLE exception in the contracts registry). A value the kit has no token for stays
 * the layer's own and lives in the "layer-own" groups below.
 */
:root {
    /* Typography (kit) */
    --doc-font-heading: var(--font-heading);
    --doc-font-body: var(--font-body);
    --doc-font-mono: var(--font-mono);

    /* Radii (kit); the 6px corner of small controls has no kit token */
    --doc-radius: var(--radius-sm);
    --doc-radius-lg: var(--radius);
    --doc-radius-pill: var(--radius-pill);
    --doc-radius-sm: 6px;

    /* Layer-own metrics */
    --doc-max-content-width: 100%;
    --doc-sidebar-width: 280px;
    --doc-toc-width: 240px;
    --doc-transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);

    /* Surfaces and text (kit) */
    --doc-bg: var(--bg);
    --doc-bg-surface: var(--bg-2);
    --doc-bg-surface-elevated: var(--bg-3);
    --doc-text: var(--text);
    --doc-text-secondary: var(--text-2);
    --doc-text-muted: var(--muted);
    --doc-border: var(--border);
    --doc-border-subtle: color-mix(in srgb, var(--border) 55%, transparent);
    --doc-border-focus: var(--acc-strong);

    /* Accents (kit) - the dark theme draws the accent with --acc, the light one with --acc-strong */
    --doc-accent: var(--acc);
    --doc-accent-hover: var(--acc-strong);
    --doc-accent-bg: color-mix(in srgb, var(--doc-accent) 12%, transparent);
    --doc-accent-ink: var(--acc-ink);
    --doc-gold: var(--gold);
    --doc-gold-hover: var(--gold-strong);
    --doc-gold-bg: color-mix(in srgb, var(--gold) 12%, transparent);

    /* Callouts (kit semantic colours) */
    --doc-tip-border: var(--doc-accent);
    --doc-tip-bg: color-mix(in srgb, var(--doc-tip-border) 10%, transparent);
    --doc-tip-text: var(--text);
    --doc-warn-border: var(--warn);
    --doc-warn-bg: color-mix(in srgb, var(--doc-warn-border) 10%, transparent);
    --doc-warn-text: var(--text);
    --doc-danger-border: var(--danger);
    --doc-danger-bg: color-mix(in srgb, var(--danger) 10%, transparent);
    --doc-danger-text: var(--text);

    /* Shadows: the medium one is the kit's; the small and device shadows are the layer's own */
    --doc-shadow-md: var(--shadow);
    --doc-shadow-lg: var(--shadow);
    --doc-shadow-sm: 0 2px 8px rgba(0, 0, 0, 0.35);
    --doc-device-shadow: 0 16px 36px rgba(0, 0, 0, 0.6);

    /* Layer-own surface: a step between --bg-2 and --bg-3 for code and table stripes */
    --doc-bg-subtle: #1c271e;

    /* Layer-own: media type colours from app_v2/res/values-night/colors.xml */
    --doc-media-music: #80cbc4;
    --doc-media-music-bg: rgba(128, 203, 196, 0.15);
    --doc-media-video: #ce93d8;
    --doc-media-video-bg: rgba(206, 147, 216, 0.15);
    --doc-media-image: #90caf9;
    --doc-media-image-bg: rgba(144, 202, 249, 0.15);
    --doc-media-docs: #ffb74d;
    --doc-media-docs-bg: rgba(255, 183, 77, 0.15);
    --doc-media-other: #bdbdbd;
    --doc-media-other-bg: rgba(189, 189, 189, 0.15);

    /* Layer-own: program accents from app_v2/src/main/res/values/colors.xml */
    --doc-prog-red: #ef5350;
    --doc-prog-blue: #42a5f5;
    --doc-prog-green: #66bb6a;
    --doc-prog-amber: #ffa726;

    /* Layer-own: device edition hue (the product layer's VR accent) and the device frame */
    --doc-vr: var(--color-vr, #00e5ff);
    --doc-device-bezel: #1a221b;
    --doc-device-screen: #000;
}

html[data-theme="light"] {
    /* The kit's --acc is under 4.5 : 1 on a light surface, so text accents take --acc-strong */
    --doc-accent: var(--acc-strong);
    --doc-accent-hover: color-mix(in srgb, var(--acc-strong) 80%, black);
    /* The kit keeps --warn at its dark-theme value in the light theme, too pale for a border here */
    --doc-warn-border: var(--gold);

    --doc-bg-subtle: #e8ece2;

    --doc-media-music: #00796b;
    --doc-media-music-bg: rgba(0, 121, 107, 0.12);
    --doc-media-video: #7b1fa2;
    --doc-media-video-bg: rgba(123, 31, 162, 0.12);
    --doc-media-image: #1976d2;
    --doc-media-image-bg: rgba(25, 118, 210, 0.12);
    --doc-media-docs: #e65100;
    --doc-media-docs-bg: rgba(230, 81, 0, 0.12);
    --doc-media-other: #616161;
    --doc-media-other-bg: rgba(97, 97, 97, 0.12);

    --doc-prog-red: #c62828;
    --doc-prog-blue: #1565c0;
    --doc-prog-green: #2e7d32;
    --doc-prog-amber: #f57f17;

    --doc-shadow-sm: 0 2px 8px rgba(0, 0, 0, 0.06);
    --doc-device-shadow: 0 16px 36px rgba(0, 0, 0, 0.15);
}

/* ==========================================================================
   2. Layout Framework & Scaffolding (Step 01.2)
   ========================================================================== */

body.doc-body {
    margin: 0;
    padding: 0;
    background-color: var(--doc-bg);
    color: var(--doc-text);
    font-family: var(--doc-font-body);
    font-size: 16px;
    line-height: 1.65;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
}

/* Header */
header.doc-header {
    position: sticky;
    top: 0;
    z-index: 1000;
    background-color: var(--doc-bg-surface);
    border-bottom: 1px solid var(--doc-border);
    backdrop-filter: blur(12px);
    width: 100%;
    overflow: visible !important; /* Override header { overflow: hidden } in styles.css */
    padding: 0;
    text-align: left;
}

.doc-header-inner {
    display: flex;
    align-items: center;
    justify-content: space-between;
    height: 64px;
    max-width: 100%;
    margin: 0 auto;
    padding: 0 24px;
}

.doc-header-brand,
.doc-brand {
    display: flex;
    align-items: center;
    gap: 12px;
    text-decoration: none;
    color: var(--doc-text);
    font-family: var(--doc-font-heading);
    font-weight: 700;
    font-size: 1.15rem;
}

.doc-header-nav {
    display: flex;
    align-items: center;
    gap: 16px;
    position: relative;
    z-index: 1001;
}

.doc-header-link {
    color: var(--doc-text-secondary);
    text-decoration: none;
    font-size: 0.9rem;
    font-weight: 500;
    transition: var(--doc-transition);
}

.doc-header-link:hover,
.doc-header-link.active {
    color: var(--doc-accent);
}

.doc-theme-btn,
.doc-theme-toggle {
    background: var(--doc-bg-subtle);
    border: 1px solid var(--doc-border);
    color: var(--doc-text);
    padding: 6px 12px;
    border-radius: var(--doc-radius-sm);
    cursor: pointer;
    font-size: 0.85rem;
    font-weight: 600;
    transition: var(--doc-transition);
}

.doc-theme-btn {
    display: inline-flex;
    align-items: center;
    gap: 0.35em;
    white-space: nowrap;
}

/* ICON-RENDER rule 5: a glyph-only control is at least 28 CSS px under a fine pointer. */
.doc-theme-btn,
.doc-theme-toggle,
.doc-mobile-menu-btn {
    justify-content: center;
    min-width: 28px;
    min-height: 28px;
}

.doc-theme-btn:hover,
.doc-theme-toggle:hover {
    border-color: var(--doc-accent);
    color: var(--doc-accent);
}

/* Breadcrumbs */
.doc-breadcrumbs {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    gap: 8px;
    padding: 14px 24px;
    background-color: var(--doc-bg-surface);
    border-bottom: 1px solid var(--doc-border-subtle);
    font-size: 0.85rem;
    color: var(--doc-text-muted);
}

.doc-breadcrumbs a {
    color: var(--doc-text-secondary);
    text-decoration: none;
    transition: var(--doc-transition);
}

.doc-breadcrumbs a:hover {
    color: var(--doc-accent);
}

.doc-breadcrumb-separator {
    color: var(--doc-text-muted);
    user-select: none;
}

.doc-breadcrumb-current {
    color: var(--doc-text);
    font-weight: 600;
}

/* Canvas Background for Animated Waves & Particles */
#docCanvas {
    position: fixed;
    top: 0;
    left: 0;
    width: 100vw;
    height: 100vh;
    z-index: 0;
    pointer-events: none;
    opacity: 0.65;
}

/* Ensure all page content is elevated above background canvas */
.doc-header, .doc-container, .doc-footer {
    position: relative;
    z-index: 1;
}

/* Full-width responsive container & layout */
.doc-container {
    width: 100%;
    max-width: 100%;
    margin: 0;
    padding: 0 24px;
    box-sizing: border-box;
}

.doc-grid,
.doc-layout {
    display: grid;
    grid-template-columns: var(--doc-sidebar-width) minmax(0, 1fr) var(--doc-toc-width);
    gap: 36px;
    padding: 24px 0;
    min-height: calc(100vh - 160px);
    width: 100%;
}

/* Sidebar Navigation */
.doc-sidebar {
    position: sticky;
    top: 80px;
    height: calc(100vh - 100px);
    overflow-y: auto;
    padding-right: 16px;
    border-right: 1px solid var(--doc-border-subtle);
}

.doc-sidebar-section,
.doc-nav-section {
    margin-bottom: 24px;
}

.doc-sidebar-title,
.doc-nav-title {
    font-family: var(--doc-font-heading);
    font-size: 0.8rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--doc-text-muted);
    margin-bottom: 8px;
}

.doc-sidebar-list,
.doc-nav-list {
    list-style: none;
    padding: 0;
    margin: 0;
}

.doc-sidebar-list li,
.doc-nav-item {
    margin-bottom: 4px;
}

.doc-sidebar-link,
.doc-nav-link {
    display: block;
    padding: 6px 10px;
    border-radius: var(--doc-radius-sm);
    color: var(--doc-text-secondary);
    text-decoration: none;
    font-size: 0.9rem;
    transition: var(--doc-transition);
}

.doc-sidebar-link:hover,
.doc-nav-link:hover {
    background-color: var(--doc-bg-subtle);
    color: var(--doc-accent);
}

.doc-sidebar-link.active,
.doc-nav-link.active {
    background-color: var(--doc-accent-bg);
    color: var(--doc-accent);
    font-weight: 600;
}

/* Main Content Area */
.doc-content {
    max-width: var(--doc-max-content-width);
    margin: 0 auto;
    width: 100%;
}

.doc-content h1,
.doc-article h1 {
    font-family: var(--doc-font-heading);
    font-size: 2.25rem;
    font-weight: 800;
    line-height: 1.2;
    margin: 0 0 16px 0;
    color: var(--doc-text);
}

.doc-lead {
    font-size: 1.15rem;
    color: var(--doc-text-secondary);
    line-height: 1.6;
    margin-bottom: 28px;
}

.doc-content h2,
.doc-article h2 {
    font-family: var(--doc-font-heading);
    font-size: 1.625rem;
    font-weight: 700;
    margin: 36px 0 16px 0;
    border-bottom: 1px solid var(--doc-border-subtle);
    padding-bottom: 8px;
    color: var(--doc-text);
}

.doc-content h3,
.doc-article h3 {
    font-family: var(--doc-font-heading);
    font-size: 1.25rem;
    font-weight: 600;
    margin: 28px 0 12px 0;
    color: var(--doc-text);
}

.doc-content h4,
.doc-article h4 {
    font-family: var(--doc-font-heading);
    font-size: 1.0625rem;
    font-weight: 600;
    margin: 20px 0 8px 0;
    color: var(--doc-text);
}

.doc-content p {
    margin: 0 0 1rem 0;
    color: var(--doc-text-secondary);
}

.doc-content code {
    font-family: var(--doc-font-mono);
    font-size: 0.88em;
    padding: 2px 6px;
    border-radius: var(--doc-radius-sm);
    background-color: var(--doc-bg-subtle);
    color: var(--doc-accent);
    border: 1px solid var(--doc-border);
}

.doc-content a {
    color: var(--doc-accent);
    text-decoration: underline;
    text-underline-offset: 3px;
    transition: var(--doc-transition);
}

.doc-content a:hover {
    color: var(--doc-accent-hover);
}

/* In-Page TOC (Right Bar) */
.doc-toc-wrapper {
    position: sticky;
    top: 80px;
    height: calc(100vh - 100px);
    overflow-y: auto;
    padding-left: 16px;
    border-left: 1px solid var(--doc-border-subtle);
}

.doc-toc-title {
    font-family: var(--doc-font-heading);
    font-size: 0.8rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--doc-text-muted);
    margin-bottom: 12px;
}

.doc-toc-list {
    list-style: none;
    padding: 0;
    margin: 0;
    font-size: 0.85rem;
}

.doc-toc-list li {
    margin-bottom: 8px;
}

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

.doc-toc-link:hover {
    color: var(--doc-accent);
}

/* Footer */
.doc-footer {
    border-top: 1px solid var(--doc-border);
    background: var(--doc-bg-surface);
    padding: 24px 0;
    margin-top: 48px;
}

.doc-footer-inner {
    max-width: 100%;
    margin: 0 auto;
    padding: 0 24px;
    display: flex;
    justify-content: space-between;
    align-items: center;
    flex-wrap: wrap;
    gap: 16px;
    font-size: 0.85rem;
    color: var(--doc-text-muted);
}

.doc-footer-links {
    display: flex;
    gap: 16px;
}

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

.doc-footer-links a:hover {
    color: var(--doc-accent);
}

/* ==========================================================================
   3. Recipe Components & Device Frames (Step 02.1 & Step 02.2)
   ========================================================================== */

/* Prerequisite Checklist Card */
.doc-card-prereq {
    background-color: var(--doc-bg-surface-elevated);
    border: 1px solid var(--doc-border);
    border-left: 4px solid var(--doc-accent);
    border-radius: var(--doc-radius);
    padding: 20px;
    margin: 24px 0;
    box-shadow: var(--doc-shadow-sm);
}

.doc-card-prereq-title {
    display: flex;
    align-items: center;
    gap: 8px;
    font-family: var(--doc-font-heading);
    font-size: 1.05rem;
    font-weight: 700;
    color: var(--doc-text);
    margin: 0 0 12px 0;
}

.doc-card-prereq-icon {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    color: var(--doc-accent);
    font-size: 1.35rem;
}

.doc-prereq-list {
    list-style: none;
    margin: 0;
    padding: 0;
    color: var(--doc-text-secondary);
    font-size: 0.95rem;
}

.doc-prereq-list li {
    display: flex;
    align-items: baseline;
    gap: 8px;
    margin-bottom: 8px;
}

.doc-prereq-bullet {
    color: var(--doc-accent);
    font-weight: 700;
}

/* Numbered Step Card */
.doc-step {
    position: relative;
    padding: 24px;
    margin: 28px 0;
    background: var(--doc-bg-surface);
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius);
    box-shadow: var(--doc-shadow-sm);
}

.doc-step-header {
    display: flex;
    align-items: center;
    gap: 12px;
    margin-bottom: 14px;
}

.doc-step-badge,
.doc-step-num {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 32px;
    height: 32px;
    background: var(--doc-accent);
    color: var(--doc-accent-ink);
    font-family: var(--doc-font-heading);
    font-weight: 800;
    font-size: 0.95rem;
    border-radius: var(--doc-radius-pill);
    flex-shrink: 0;
}

.doc-step-title {
    font-family: var(--doc-font-heading);
    font-size: 1.25rem;
    font-weight: 700;
    color: var(--doc-text);
    margin: 0;
}

.doc-step-body {
    padding-left: 44px;
}

.doc-step-img-container {
    margin: 16px 0 8px 0;
    background: var(--doc-bg-subtle);
    border: 1px dashed var(--doc-border);
    border-radius: var(--doc-radius-sm);
    min-height: 180px;
    display: flex;
    align-items: center;
    justify-content: center;
    text-align: center;
    padding: 16px;
}

.doc-step-img-placeholder {
    color: var(--doc-text-muted);
    font-size: 0.85rem;
    font-style: italic;
}

.doc-step-img-caption {
    font-size: 0.825rem;
    color: var(--doc-text-muted);
    text-align: center;
    margin-bottom: 12px;
}

/* Callouts (Tip, Warning, Note) */
.doc-callout {
    padding: 16px 20px;
    border-radius: var(--doc-radius);
    margin: 20px 0;
    font-size: 0.925rem;
    line-height: 1.55;
}

.doc-callout-title {
    display: flex;
    align-items: center;
    gap: 8px;
    font-family: var(--doc-font-heading);
    font-weight: 700;
    font-size: 0.95rem;
    margin-bottom: 8px;
}

.doc-callout p {
    margin: 0;
}

.doc-callout-tip {
    background-color: var(--doc-tip-bg);
    border-left: 4px solid var(--doc-tip-border);
    color: var(--doc-tip-text);
}

.doc-callout-warning,
.doc-callout-warn {
    background-color: var(--doc-warn-bg);
    border-left: 4px solid var(--doc-warn-border);
    color: var(--doc-warn-text);
}

.doc-callout-note {
    background-color: var(--doc-bg-surface-elevated);
    border: 1px solid var(--doc-border);
    border-left: 4px solid var(--doc-accent);
    color: var(--doc-text);
}

/* Badges: Media & Editions */
.doc-badge {
    display: inline-block;
    padding: 3px 10px;
    font-size: 0.75rem;
    font-weight: 700;
    font-family: var(--doc-font-heading);
    border-radius: var(--doc-radius-pill);
    text-transform: uppercase;
    letter-spacing: 0.04em;
    vertical-align: middle;
}

.doc-badge-sm {
    font-size: 0.7rem;
    padding: 2px 7px;
}

/* Canonical Media Type Badges */
.doc-badge-music {
    background: var(--doc-media-music-bg);
    color: var(--doc-media-music);
    border: 1px solid var(--doc-media-music);
}

.doc-badge-video {
    background: var(--doc-media-video-bg);
    color: var(--doc-media-video);
    border: 1px solid var(--doc-media-video);
}

.doc-badge-image {
    background: var(--doc-media-image-bg);
    color: var(--doc-media-image);
    border: 1px solid var(--doc-media-image);
}

.doc-badge-docs {
    background: var(--doc-media-docs-bg);
    color: var(--doc-media-docs);
    border: 1px solid var(--doc-media-docs);
}

.doc-badge-other {
    background: var(--doc-media-other-bg);
    color: var(--doc-media-other);
    border: 1px solid var(--doc-media-other);
}

/* Edition Badges */
.doc-badge-standard {
    background: var(--doc-accent-bg);
    color: var(--doc-accent);
    border: 1px solid var(--doc-accent);
}

.doc-badge-nolegal {
    background: var(--doc-gold-bg);
    color: var(--doc-gold);
    border: 1px solid var(--doc-gold);
}

.doc-badge-vr {
    background: color-mix(in srgb, var(--doc-vr) 15%, transparent);
    color: var(--doc-vr);
    border: 1px solid var(--doc-vr);
}

.doc-badge-wear {
    background: color-mix(in srgb, var(--doc-prog-blue) 15%, transparent);
    color: var(--doc-prog-blue);
    border: 1px solid var(--doc-prog-blue);
}

.doc-badge-android-tv {
    background: color-mix(in srgb, var(--doc-prog-amber) 15%, transparent);
    color: var(--doc-prog-amber);
    border: 1px solid var(--doc-prog-amber);
}

/*
 * Light theme: a badge's small bold text sits on its own 12-15% tint, and the token colours fall
 * under 4.5 : 1 there on the palest portal surface (#e4ecdf). Only the text is darkened, so the
 * tint, the border and every other use of the token keep their hue. Each mix ratio is the lightest
 * that clears 4.5 : 1 over #ffffff, --bg, --bg-3 and --doc-bg-subtle.
 */
html[data-theme="light"] .doc-badge-music { color: color-mix(in srgb, var(--doc-media-music) 85%, black); }
html[data-theme="light"] .doc-badge-image { color: color-mix(in srgb, var(--doc-media-image) 80%, black); }
html[data-theme="light"] .doc-badge-docs { color: color-mix(in srgb, var(--doc-media-docs) 70%, black); }
html[data-theme="light"] .doc-badge-other { color: color-mix(in srgb, var(--doc-media-other) 90%, black); }
html[data-theme="light"] .doc-badge-standard { color: color-mix(in srgb, var(--doc-accent) 85%, black); }
html[data-theme="light"] .doc-badge-nolegal { color: color-mix(in srgb, var(--doc-gold) 80%, black); }
html[data-theme="light"] .doc-badge-vr { color: color-mix(in srgb, var(--doc-vr) 45%, black); }
html[data-theme="light"] .doc-badge-wear { color: color-mix(in srgb, var(--doc-prog-blue) 85%, black); }
html[data-theme="light"] .doc-badge-android-tv { color: color-mix(in srgb, var(--doc-prog-amber) 60%, black); }

/* Device Mockup Frames */
.doc-frame-phone {
    max-width: 240px;
    margin: 16px auto;
    border-radius: 28px;
    border: 8px solid var(--doc-device-bezel);
    background: var(--doc-device-screen);
    box-shadow: var(--doc-device-shadow);
    position: relative;
    overflow: hidden;
}

.doc-frame-notch {
    width: 60px;
    height: 10px;
    background: var(--doc-device-bezel);
    position: absolute;
    top: 0;
    left: 50%;
    transform: translateX(-50%);
    border-bottom-left-radius: 6px;
    border-bottom-right-radius: 6px;
    z-index: 2;
}

.doc-frame-watch-round {
    width: 180px;
    height: 180px;
    margin: 16px auto;
    border-radius: 50%;
    border: 10px solid var(--doc-device-bezel);
    background: var(--doc-device-screen);
    box-shadow: var(--doc-device-shadow);
    position: relative;
    overflow: hidden;
}

.doc-frame-watch-crown {
    position: absolute;
    right: -14px;
    top: 50%;
    transform: translateY(-50%);
    width: 8px;
    height: 24px;
    background: #333;
    border-radius: 3px;
}

.doc-frame-watch-square {
    width: 180px;
    height: 180px;
    margin: 16px auto;
    border-radius: 24%;
    border: 8px solid var(--doc-device-bezel);
    background: var(--doc-device-screen);
    box-shadow: var(--doc-device-shadow);
    position: relative;
    overflow: hidden;
}

.doc-frame-vr {
    max-width: 380px;
    height: 200px;
    margin: 16px auto;
    border-radius: 36px / 20px;
    border: 8px solid #151d24;
    background: var(--doc-device-screen);
    box-shadow: var(--doc-device-shadow);
    position: relative;
    overflow: hidden;
}

/* Semantic Links & Tooltips */
.doc-link-term {
    border-bottom: 1px dashed var(--doc-accent);
    color: var(--doc-text);
    cursor: help;
    position: relative;
}

.doc-link-term:hover::after {
    content: attr(data-term);
    position: absolute;
    bottom: 125%;
    left: 50%;
    transform: translateX(-50%);
    background: var(--doc-bg-surface-elevated);
    color: var(--doc-text);
    border: 1px solid var(--doc-border);
    padding: 4px 8px;
    border-radius: var(--doc-radius-sm);
    font-size: 0.75rem;
    white-space: nowrap;
    box-shadow: var(--doc-shadow-md);
    z-index: 10;
}

.doc-link-bookmark {
    color: var(--doc-gold);
    text-decoration: underline dashed;
}

.doc-link-external::after {
    content: ' ↗';
    font-size: 0.85em;
    opacity: 0.8;
}

/* Next Steps Cards */
.doc-next-section {
    margin-top: 48px;
    padding-top: 24px;
    border-top: 1px solid var(--doc-border);
}

.doc-next-title {
    font-family: var(--doc-font-heading);
    font-size: 1.2rem;
    font-weight: 700;
    color: var(--doc-text);
    margin-bottom: 16px;
}

.doc-next-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
    gap: 16px;
}

.doc-next-card {
    display: block;
    padding: 16px;
    background: var(--doc-bg-surface);
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius);
    text-decoration: none;
    transition: var(--doc-transition);
}

.doc-next-card:hover {
    border-color: var(--doc-accent);
    transform: translateY(-2px);
    box-shadow: var(--doc-shadow-sm);
}

.doc-next-card h3,
.doc-next-card h4 {
    margin: 8px 0 4px 0;
    color: var(--doc-text);
    font-family: var(--doc-font-heading);
    font-size: 1rem;
}

.doc-next-card p {
    margin: 0;
    font-size: 0.85rem;
    color: var(--doc-text-muted);
}

/* ==========================================================================
   4. Responsive Breakpoints & Print Styles
   ========================================================================== */

@media (max-width: 1100px) {
    .doc-grid,
    .doc-layout {
        grid-template-columns: var(--doc-sidebar-width) minmax(0, 1fr);
    }
    .doc-toc-wrapper,
    .doc-toc {
        display: none;
    }
}

/* Mobile Navigation Drawer Toggle & Backdrop */
.doc-mobile-menu-btn {
    display: none;
    background: transparent;
    border: 1px solid var(--doc-border);
    color: var(--doc-text);
    padding: 6px 10px;
    border-radius: var(--doc-radius-sm);
    cursor: pointer;
    font-size: 1.1rem;
    line-height: 1;
    align-items: center;
    justify-content: center;
    transition: var(--doc-transition);
}

.doc-mobile-menu-btn:hover {
    background: var(--doc-bg-subtle);
    border-color: var(--doc-border-focus);
}

.doc-sidebar-backdrop {
    display: none;
    position: fixed;
    top: 0;
    left: 0;
    width: 100vw;
    height: 100vh;
    background: rgba(0, 0, 0, 0.5);
    backdrop-filter: blur(4px);
    -webkit-backdrop-filter: blur(4px);
    z-index: 1050;
    opacity: 0;
    transition: opacity 0.25s ease;
}

.doc-sidebar-backdrop.active {
    display: block;
    opacity: 1;
}

@media (max-width: 768px) {
    .doc-mobile-menu-btn {
        display: inline-flex;
    }
    .doc-grid,
    .doc-layout {
        grid-template-columns: 1fr;
        padding: 16px;
    }
    .doc-sidebar {
        display: block;
        position: fixed;
        top: 0;
        left: -320px;
        width: 280px;
        height: 100vh;
        max-height: 100vh;
        overflow-y: auto;
        background: var(--doc-bg-surface);
        border-right: 1px solid var(--doc-border);
        padding: 24px 16px;
        z-index: 1100;
        box-shadow: var(--doc-shadow-md);
        transition: left 0.3s cubic-bezier(0.4, 0, 0.2, 1);
    }
    .doc-sidebar.active,
    .doc-sidebar.open {
        left: 0;
    }
    .doc-step-body {
        padding-left: 0;
    }
    .doc-header-inner {
        padding: 0 16px;
    }
    .doc-breadcrumbs {
        padding: 12px 16px;
    }
}

@media print {
    .doc-header,
    .doc-sidebar,
    .doc-toc-wrapper,
    .doc-toc,
    .doc-breadcrumbs,
    .doc-footer,
    .doc-theme-btn,
    .doc-theme-toggle {
        display: none !important;
    }
    body.doc-body {
        background: #fff !important;
        color: #000 !important;
    }
    .doc-grid,
    .doc-layout {
        display: block !important;
        padding: 0 !important;
    }
    .doc-content {
        max-width: 100% !important;
    }
    .doc-card-prereq,
    .doc-step,
    .doc-callout {
        border: 1px solid #ccc !important;
        box-shadow: none !important;
        background: #fff !important;
        color: #000 !important;
        page-break-inside: avoid;
    }
}


/* Language Picker Dropdown */
.doc-lang-picker {
    position: relative;
    display: inline-block;
}

.doc-lang-btn {
    display: inline-flex;
    align-items: center;
    gap: 6px;
    background: var(--doc-bg-subtle);
    border: 1px solid var(--doc-border);
    color: var(--doc-text);
    padding: 6px 12px;
    border-radius: var(--doc-radius-sm);
    cursor: pointer;
    font-size: 0.85rem;
    font-weight: 600;
    transition: var(--doc-transition);
}

.doc-lang-btn:hover {
    border-color: var(--doc-accent);
    color: var(--doc-accent);
}

.doc-lang-btn::after {
    content: '▾';
    font-size: 0.75rem;
    margin-left: 2px;
}

.doc-lang-menu {
    display: none;
    position: absolute;
    top: calc(100% + 6px);
    right: 0;
    background: var(--doc-bg-surface-elevated);
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius);
    box-shadow: var(--doc-shadow-md);
    min-width: 170px;
    max-height: 380px;
    overflow-y: auto;
    z-index: 9999;
    padding: 6px;
}

.doc-lang-menu.show {
    display: block;
}

.doc-lang-item {
    display: flex;
    align-items: center;
    justify-content: space-between;
    padding: 8px 12px;
    color: var(--doc-text-secondary);
    text-decoration: none;
    font-size: 0.875rem;
    border-radius: var(--doc-radius-sm);
    transition: var(--doc-transition);
    white-space: nowrap;
}

.doc-lang-item:hover {
    background-color: var(--doc-bg-subtle);
    color: var(--doc-accent);
}

.doc-lang-item.active {
    background-color: var(--doc-accent-bg);
    color: var(--doc-accent);
    font-weight: 700;
}

.doc-lang-item .lang-code {
    font-size: 0.75rem;
    color: var(--doc-text-muted);
    text-transform: uppercase;
    margin-left: 8px;
}




.doc-app-icon {
    width: 38px;
    height: 38px;
    flex-shrink: 0;
    border-radius: 50%;
    border: 1px solid var(--doc-border);
    padding: 2px;
    background: var(--doc-bg-surface-elevated);
    box-shadow: 0 0 14px var(--doc-accent-bg);
    transition: var(--doc-transition);
}

.doc-app-icon:hover {
    transform: scale(1.08) rotate(5deg);
    border-color: var(--doc-accent);
}

/* ==========================================================================
   5. In-Browser Client Search Modal (S2970)
   ========================================================================== */

.doc-search-trigger {
    display: inline-flex;
    align-items: center;
    gap: 8px;
    background: var(--doc-bg-subtle);
    border: 1px solid var(--doc-border);
    color: var(--doc-text-muted);
    padding: 6px 14px;
    border-radius: var(--doc-radius-sm);
    font-size: 0.875rem;
    cursor: pointer;
    transition: var(--doc-transition);
}

.doc-search-trigger:hover {
    border-color: var(--doc-accent);
    color: var(--doc-text);
}

.doc-search-trigger kbd {
    background: var(--doc-bg-surface);
    border: 1px solid var(--doc-border);
    border-radius: 4px;
    padding: 1px 5px;
    font-size: 0.75rem;
    font-family: var(--doc-font-mono);
    color: var(--doc-accent);
}

/* Modal Backdrop */
.doc-search-backdrop {
    display: none;
    position: fixed;
    top: 0;
    left: 0;
    width: 100vw;
    height: 100vh;
    background: rgba(0, 0, 0, 0.75);
    backdrop-filter: blur(4px);
    z-index: 10000;
    align-items: flex-start;
    justify-content: center;
    padding-top: 10vh;
}

.doc-search-backdrop.active {
    display: flex;
}

/* Modal Box */
.doc-search-modal {
    background: var(--doc-bg-surface-elevated);
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius);
    box-shadow: var(--doc-shadow-lg);
    width: 90%;
    max-width: 640px;
    max-height: 80vh;
    display: flex;
    flex-direction: column;
    overflow: hidden;
    animation: docModalFadeIn 0.15s ease-out;
}

@keyframes docModalFadeIn {
    from { opacity: 0; transform: scale(0.96); }
    to { opacity: 1; transform: scale(1); }
}

/* Search Header */
.doc-search-header {
    display: flex;
    align-items: center;
    gap: 12px;
    padding: 16px 20px;
    border-bottom: 1px solid var(--doc-border);
    background: var(--doc-bg-surface);
}

.doc-search-icon {
    font-size: 1.25rem;
    opacity: 0.7;
}

.doc-search-input {
    flex: 1;
    background: transparent;
    border: none;
    outline: none;
    color: var(--doc-text);
    font-size: 1.1rem;
    font-family: var(--doc-font-body);
}

.doc-search-input::placeholder {
    color: var(--doc-text-muted);
}

.doc-search-close {
    background: var(--doc-bg-subtle);
    border: 1px solid var(--doc-border);
    color: var(--doc-text-muted);
    padding: 2px 8px;
    border-radius: 4px;
    font-size: 0.75rem;
    cursor: pointer;
    font-family: var(--doc-font-mono);
}

.doc-search-close:hover {
    color: var(--doc-text);
    border-color: var(--doc-accent);
}

/* Search Results List */
.doc-search-results {
    padding: 12px;
    overflow-y: auto;
    flex: 1;
    display: flex;
    flex-direction: column;
    gap: 6px;
}

.doc-search-empty {
    padding: 32px 16px;
    text-align: center;
    color: var(--doc-text-muted);
    font-size: 0.95rem;
}

.doc-search-item {
    display: block;
    padding: 12px 16px;
    border-radius: var(--doc-radius-sm);
    text-decoration: none;
    border: 1px solid transparent;
    transition: var(--doc-transition);
}

.doc-search-item:hover,
.doc-search-item.selected {
    background: var(--doc-bg-subtle);
    border-color: var(--doc-accent);
}

.doc-search-item-title {
    display: flex;
    align-items: center;
    justify-content: space-between;
    font-family: var(--doc-font-heading);
    font-size: 1rem;
    font-weight: 700;
    color: var(--doc-text);
    margin-bottom: 4px;
}

.doc-search-item-desc {
    font-size: 0.85rem;
    color: var(--doc-text-secondary);
    line-height: 1.4;
    margin-bottom: 4px;
}

.doc-search-item-meta {
    font-size: 0.75rem;
    color: var(--doc-text-muted);
    text-transform: uppercase;
    letter-spacing: 0.04em;
}

.doc-search-highlight,
mark.doc-search-highlight {
    background: color-mix(in srgb, var(--acc) 25%, transparent);
    color: var(--doc-accent);
    font-weight: 700;
    border-radius: 2px;
    padding: 0 2px;
}

/* Search Footer */
.doc-search-footer {
    display: flex;
    align-items: center;
    gap: 16px;
    padding: 10px 20px;
    background: var(--doc-bg-surface);
    border-top: 1px solid var(--doc-border);
    font-size: 0.75rem;
    color: var(--doc-text-muted);
}

.doc-search-footer kbd {
    background: var(--doc-bg-subtle);
    border: 1px solid var(--doc-border);
    border-radius: 3px;
    padding: 1px 4px;
    font-family: var(--doc-font-mono);
}

/* Mobile viewport adjustments down to 400px */
@media (max-width: 480px) {
    .doc-search-backdrop {
        padding-top: 0;
    }
    .doc-search-modal {
        width: 100vw;
        height: 100vh;
        max-height: 100vh;
        border-radius: 0;
        border: none;
    }
    .doc-header-inner {
        flex-wrap: wrap;
        gap: 8px;
    }
    .doc-header-nav {
        gap: 8px;
    }
}


/* Keep core controls visible on phone-width screens rather than clipping overflow. */
.doc-header-inner > div { min-width: 0; }
.doc-footer-links { display: flex; flex-wrap: wrap; gap: 12px 16px; }
.doc-search-input { min-width: 0; }
.doc-search-item-title { overflow-wrap: anywhere; }
.doc-search-close { margin-top: 4px; }
.doc-body :is(a, button, input):focus-visible { outline: 2px solid var(--doc-accent); outline-offset: 3px; }
@media (max-width: 768px) {
    .doc-header-inner { height: auto; min-height: 64px; flex-wrap: wrap; gap: 8px; padding: 10px 16px; }
    .doc-header-inner > div { width: 100%; }
    .doc-header-nav { flex: 1; justify-content: flex-end; gap: 8px; min-width: 0; }
    .doc-header-nav .doc-header-link { display: none; }
    .doc-header-brand { font-size: 1rem; }
    .doc-header .doc-search-trigger { padding: 6px 8px; }
    .doc-header .doc-search-trigger kbd { display: none; }
    .doc-lang-btn { min-width: 44px; padding: 6px 10px; }
    .doc-footer-inner { flex-wrap: wrap; gap: 12px; }
    .doc-footer-links { min-width: 0; }
    .doc-search-footer { flex-wrap: wrap; gap: 8px; }
}
@media (prefers-reduced-motion: reduce) {
    .doc-search-modal { animation: none; }
    .doc-sidebar { transition: none; }
}
.doc-content { min-width: 0; overflow-wrap: anywhere; }
.doc-content .doc-search-trigger { max-width: 100%; white-space: normal; flex-wrap: wrap; text-align: left; }
.doc-content .doc-search-trigger > span { min-width: 0; }

/* ==========================================================================
   Subject index page (moved from the page, S4099: SITE-EXPERIENCE rules 2 and 4)
   ========================================================================== */

.doc-alpha-nav {
    display: flex;
    flex-wrap: wrap;
    gap: 6px;
    margin-bottom: 2rem;
    position: sticky;
    top: 70px;
    background: var(--doc-bg);
    padding: 10px 0;
    z-index: 10;
    border-bottom: 1px solid var(--doc-border);
}
.doc-alpha-btn {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 32px;
    height: 32px;
    border-radius: 6px;
    background: var(--doc-bg-surface);
    color: var(--doc-text);
    text-decoration: none;
    font-weight: 600;
    font-size: 0.9rem;
    border: 1px solid var(--doc-border);
    transition: all 0.15s ease;
}
.doc-alpha-btn:hover, .doc-alpha-btn.active {
    background: var(--doc-accent);
    color: var(--doc-accent-ink);
    border-color: var(--doc-accent);
}
.doc-alpha-btn.disabled {
    opacity: 0.3;
    pointer-events: none;
}
.doc-index-filter {
    width: 100%;
    max-width: 480px;
    padding: 10px 14px;
    font-size: 1rem;
    border-radius: 6px;
    border: 1px solid var(--doc-border);
    background: var(--doc-bg-surface);
    color: var(--doc-text);
    margin-bottom: 1.5rem;
}
.doc-index-filter:focus {
    outline: none;
    border-color: var(--doc-accent);
    box-shadow: 0 0 0 2px rgba(63, 185, 80, 0.2);
}
.doc-letter-section {
    margin-bottom: 3rem;
    scroll-margin-top: 130px;
}
/* An h2 since S4112; the .doc-content prefix outranks the generic .doc-content h2 rule */
.doc-letter-title,
.doc-content .doc-letter-title {
    font-size: 1.8rem;
    font-weight: 800;
    border-bottom: 2px solid var(--doc-border);
    padding-bottom: 0.5rem;
    margin: 0 0 1.25rem 0;
    color: var(--doc-accent);
    display: flex;
    align-items: center;
    justify-content: space-between;
}
.doc-index-item {
    background: var(--doc-bg-surface);
    border: 1px solid var(--doc-border);
    border-radius: 8px;
    padding: 1rem 1.25rem;
    margin-bottom: 0.75rem;
    transition: border-color 0.15s ease;
}
.doc-index-item:hover {
    border-color: rgba(63, 185, 80, 0.5);
}
.doc-index-item-head {
    display: flex;
    align-items: center;
    gap: 0.75rem;
    flex-wrap: wrap;
    margin-bottom: 0.35rem;
}
.doc-index-item-title {
    font-size: 1.15rem;
    font-weight: 700;
    margin: 0;
    color: var(--doc-text);
}
.doc-index-item-desc {
    font-size: 0.92rem;
    color: var(--doc-text-muted);
    margin: 0.25rem 0 0.5rem 0;
    line-height: 1.5;
}
.doc-index-item-links {
    display: flex;
    flex-wrap: wrap;
    gap: 0.5rem;
    margin-top: 0.5rem;
}
.doc-index-pill {
    display: inline-flex;
    align-items: center;
    gap: 4px;
    padding: 3px 8px;
    background: rgba(63, 185, 80, 0.1);
    color: var(--doc-accent);
    border: 1px solid rgba(63, 185, 80, 0.25);
    border-radius: 4px;
    font-size: 0.82rem;
    text-decoration: none;
    font-weight: 500;
    transition: all 0.15s ease;
}
.doc-index-pill:hover {
    background: var(--doc-accent);
    color: var(--doc-accent-ink);
}

/* ==========================================================================
   Glossary page (moved from the page, S4099: SITE-EXPERIENCE rules 2 and 4)
   ========================================================================== */

/* Glossary specific styling adhering to design system */
.doc-glossary-controls {
    display: flex;
    flex-direction: column;
    gap: 1rem;
    margin: 1.5rem 0 2rem 0;
    padding: 1.25rem;
    background: var(--doc-bg-surface);
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius);
}
.doc-glossary-search-box {
    display: flex;
    align-items: center;
    gap: 0.75rem;
    position: relative;
}
.doc-glossary-input {
    width: 100%;
    padding: 0.75rem 1rem 0.75rem 2.5rem;
    background: var(--doc-bg-subtle);
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius-sm);
    color: var(--doc-text);
    font-family: var(--doc-font-body);
    font-size: 0.95rem;
    outline: none;
    transition: var(--doc-transition);
}
.doc-glossary-input:focus {
    border-color: var(--doc-border-focus);
    box-shadow: 0 0 0 3px var(--doc-accent-bg);
}
.doc-glossary-search-icon {
    position: absolute;
    left: 0.85rem;
    color: var(--doc-text-muted);
    pointer-events: none;
}
.doc-filter-pills {
    display: flex;
    flex-wrap: wrap;
    gap: 0.5rem;
    align-items: center;
}
.doc-filter-pill {
    padding: 0.35rem 0.75rem;
    background: var(--doc-bg-subtle);
    border: 1px solid var(--doc-border-subtle);
    border-radius: var(--doc-radius-pill);
    color: var(--doc-text-secondary);
    font-size: 0.8rem;
    font-weight: 500;
    cursor: pointer;
    transition: var(--doc-transition);
    user-select: none;
}
.doc-filter-pill:hover, .doc-filter-pill.active {
    background: var(--doc-accent-bg);
    border-color: var(--doc-accent);
    color: var(--doc-text);
}
.doc-az-bar {
    display: flex;
    flex-wrap: wrap;
    gap: 0.25rem;
    padding: 0.75rem 1rem;
    margin-bottom: 2rem;
    background: var(--doc-bg-surface-elevated);
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius);
    justify-content: center;
    position: sticky;
    top: 70px;
    z-index: 10;
    backdrop-filter: blur(8px);
}
.doc-az-link {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 2rem;
    height: 2rem;
    border-radius: var(--doc-radius-sm);
    color: var(--doc-accent);
    font-weight: 700;
    text-decoration: none;
    font-size: 0.9rem;
    transition: var(--doc-transition);
}
.doc-az-link:hover {
    background: var(--doc-accent-bg);
    color: var(--doc-accent-hover);
}
.doc-az-link.disabled {
    color: var(--doc-text-muted);
    opacity: 0.35;
    pointer-events: none;
}
.doc-glossary-group {
    margin-bottom: 3rem;
    scroll-margin-top: 130px;
}
.doc-glossary-letter-heading {
    display: flex;
    align-items: baseline;
    gap: 0.75rem;
    font-size: 2rem;
    font-family: var(--doc-font-heading);
    color: var(--doc-accent);
    border-bottom: 2px solid var(--doc-border);
    padding-bottom: 0.5rem;
    margin-bottom: 1.5rem;
}
.doc-glossary-letter-count {
    font-size: 0.9rem;
    color: var(--doc-text-muted);
    font-weight: normal;
}
.doc-term-card {
    background: var(--doc-bg-surface);
    border: 1px solid var(--doc-border);
    border-left: 4px solid var(--doc-accent);
    border-radius: var(--doc-radius);
    padding: 1.25rem 1.5rem;
    margin-bottom: 1.25rem;
    scroll-margin-top: 140px;
    transition: var(--doc-transition);
}
.doc-term-card:hover {
    border-color: var(--doc-accent);
    box-shadow: var(--doc-shadow-sm);
}
.doc-term-header {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    align-items: center;
    gap: 0.75rem;
    margin-bottom: 0.75rem;
}
.doc-term-title-wrapper {
    display: flex;
    align-items: center;
    gap: 0.6rem;
}
.doc-term-icon {
    width: 24px;
    height: 24px;
    object-fit: contain;
    border-radius: 4px;
}
.doc-term-title {
    margin: 0;
    font-size: 1.3rem;
    font-family: var(--doc-font-heading);
    color: var(--doc-text);
    font-weight: 700;
}
.doc-term-anchor {
    color: var(--doc-text-muted);
    text-decoration: none;
    font-weight: 500;
    opacity: 0;
    transition: var(--doc-transition);
}
.doc-term-card:hover .doc-term-anchor {
    opacity: 0.8;
}
.doc-term-anchor:hover {
    opacity: 1;
    color: var(--doc-accent);
}
.doc-term-badges {
    display: flex;
    flex-wrap: wrap;
    gap: 0.4rem;
    align-items: center;
}
.doc-term-definition {
    font-size: 1rem;
    line-height: 1.6;
    color: var(--doc-text);
    margin: 0.5rem 0 0.75rem 0;
}
.doc-term-disambiguation {
    display: flex;
    gap: 0.6rem;
    align-items: flex-start;
    padding: 0.75rem 1rem;
    background: var(--doc-bg-subtle);
    border-left: 3px solid var(--doc-gold);
    border-radius: 0 var(--doc-radius-sm) var(--doc-radius-sm) 0;
    font-size: 0.9rem;
    color: var(--doc-text-secondary);
    margin-bottom: 0.75rem;
}
.doc-term-meta-row {
    display: flex;
    flex-wrap: wrap;
    gap: 1.25rem;
    align-items: center;
    margin-top: 0.75rem;
    padding-top: 0.75rem;
    border-top: 1px solid var(--doc-border-subtle);
    font-size: 0.85rem;
    color: var(--doc-text-muted);
}
.doc-term-locales {
    display: flex;
    gap: 0.5rem;
    align-items: center;
}
.doc-term-locale-tag {
    background: var(--doc-bg-subtle);
    padding: 0.15rem 0.5rem;
    border-radius: var(--doc-radius-sm);
    color: var(--doc-text-secondary);
    font-family: var(--doc-font-mono);
    font-size: 0.8rem;
}
.doc-term-related-list {
    display: flex;
    flex-wrap: wrap;
    gap: 0.4rem;
    align-items: center;
}
.doc-term-related-chip {
    color: var(--doc-accent);
    text-decoration: none;
    background: var(--doc-accent-bg);
    padding: 0.15rem 0.5rem;
    border-radius: var(--doc-radius-sm);
    font-size: 0.8rem;
    transition: var(--doc-transition);
}
.doc-term-related-chip:hover {
    background: var(--doc-accent);
    color: var(--doc-accent-ink);
}
.doc-term-synonyms {
    font-size: 0.85rem;
    color: var(--doc-gold);
    background: var(--doc-gold-bg);
    padding: 0.35rem 0.6rem;
    border-radius: var(--doc-radius-sm);
    margin-bottom: 0.5rem;
}
.doc-no-results {
    text-align: center;
    padding: 3rem 1rem;
    background: var(--doc-bg-surface);
    border: 1px dashed var(--doc-border);
    border-radius: var(--doc-radius);
    color: var(--doc-text-muted);
    font-size: 1.1rem;
}

/* ==========================================================================
   Design system page (moved from the page, S4099: SITE-EXPERIENCE rules 2 and 4)
   ========================================================================== */

/* Demo showcase helper styles */
.demo-section {
    margin-bottom: 3.5rem;
    padding-bottom: 2rem;
    border-bottom: 1px dashed var(--doc-border);
}
.demo-section:last-of-type {
    border-bottom: none;
}
.demo-title {
    font-family: var(--doc-font-heading);
    font-size: 1.5rem;
    font-weight: 700;
    color: var(--doc-text);
    margin-bottom: 0.5rem;
    display: flex;
    align-items: center;
    gap: 0.5rem;
}
.demo-desc {
    color: var(--doc-text-muted);
    font-size: 0.9375rem;
    margin-bottom: 1.25rem;
}
.demo-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
    gap: 1.25rem;
}
.demo-box {
    background: var(--doc-bg-surface);
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius);
    padding: 1.25rem;
}
.demo-label {
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--doc-text-muted);
    margin-bottom: 0.75rem;
}

/* ==========================================================================
   Portal components (S4099: SITE-EXPERIENCE rules 3, 4, 6 and 15)
   One class per meaning; a page never restates these values in a style attribute.
   ========================================================================== */

/* Skip link: the first focusable element of every page, shown only while focused */
.doc-skip-link {
    position: absolute;
    left: 12px;
    top: -100px;
    z-index: 2000;
    padding: 10px 16px;
    background: var(--doc-accent);
    color: var(--doc-accent-ink);
    border-radius: var(--doc-radius-sm);
    font-family: var(--doc-font-heading);
    font-weight: 700;
    text-decoration: none;
}

.doc-skip-link:focus,
.doc-skip-link:focus-visible {
    top: 12px;
}

/* An ICON-SET glyph drawn inline beside its text label, in the colour of the text */
.doc-glyph {
    display: inline-block;
    width: 1em;
    height: 1em;
    flex: none;
    vertical-align: -0.125em;
    fill: currentColor;
}

.doc-stamp {
    font-size: 11px;
    opacity: 0.6;
    margin: 0;
    padding: 2px 8px;
    text-align: right;
}

/* Header chrome */
.doc-header-start {
    display: flex;
    align-items: center;
    gap: 0.75rem;
}

.doc-header-brand-dot {
    color: var(--doc-accent);
}

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

.doc-header-home {
    display: flex;
    align-items: center;
}

/* Badge row above a page title: section, editions, page number */
.doc-meta-row {
    display: flex;
    flex-wrap: wrap;
    gap: 0.5rem;
    align-items: center;
    margin-bottom: 1.5rem;
}

/* The part of a function's availability the badge cannot say, right under the badge row */
.doc-availability-note {
    margin: -1rem 0 1.5rem;
    color: var(--doc-text-secondary);
    font-size: 0.85rem;
    line-height: 1.5;
}

/* Edition badge: which editions carry the function; device badge: which device class */
.doc-edition-badge,
.doc-device-badge {
    display: inline-flex;
    align-items: center;
    gap: 0.35em;
    max-width: 100%;
    padding: 3px 10px;
    border: 1px solid var(--doc-accent);
    border-radius: var(--doc-radius-pill);
    background: var(--doc-accent-bg);
    color: var(--doc-accent);
    font-family: var(--doc-font-heading);
    font-size: 0.75rem;
    font-weight: 700;
    line-height: 1.4;
    white-space: normal;
    vertical-align: middle;
}

.doc-device-badge {
    padding: 2px 7px;
    font-size: 0.7rem;
}

.doc-device-badge--wear {
    border-color: var(--doc-media-video);
    background: var(--doc-media-video-bg);
    color: var(--doc-media-video);
}

.doc-device-badge--vr {
    border-color: var(--doc-media-music);
    background: var(--doc-media-music-bg);
    color: var(--doc-media-music);
}

.doc-device-badge--tv {
    border-color: var(--doc-media-image);
    background: var(--doc-media-image-bg);
    color: var(--doc-media-image);
}

/* A control's name with its glyph in front, kept on one line */
.doc-glyph-label {
    white-space: nowrap;
}

.doc-glyph-label .doc-glyph {
    margin-right: 0.3em;
}

/* Menu path: the chain of menu entries that leads to a control */
.doc-menu-path-item {
    padding: 0 0.35em;
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius-sm);
    background: var(--doc-bg-subtle);
    color: var(--doc-text);
    font-weight: 600;
    -webkit-box-decoration-break: clone;
    box-decoration-break: clone;
}

.doc-menu-path-sep {
    margin: 0 0.3em;
    color: var(--doc-text-muted);
}

/* Snippet blocks */
.doc-snippet-section {
    margin-top: 2.5rem;
}

.doc-snippet-card {
    margin-bottom: 1.5rem;
}

.doc-snippet-header {
    display: flex;
    align-items: center;
    gap: 0.4rem;
    margin-bottom: 0.5rem;
    font-weight: 600;
}

.doc-snippet-card pre {
    padding: 1rem;
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius-sm);
    background: var(--code-bg);
    color: var(--code-ink);
    overflow-x: auto;
}

/* Subject index and glossary */
.doc-page-header {
    margin-bottom: 1.5rem;
}

.doc-page-header h1 {
    font-size: 2.3rem;
    margin-bottom: 0.5rem;
}

.doc-page-header .doc-lead {
    font-size: 1.15rem;
}

.doc-sidebar-note {
    margin: 0 0 0.5rem;
    color: var(--doc-text-muted);
    font-size: 0.85rem;
}

.doc-letter-count {
    color: var(--doc-text-muted);
    font-size: 0.9rem;
    font-weight: normal;
}

.doc-toc-count {
    color: var(--doc-text-muted);
    font-size: 0.8rem;
}

.doc-filter-label {
    margin-right: 0.25rem;
    color: var(--doc-text-muted);
    font-size: 0.8rem;
}

.doc-term-disambiguation .doc-glyph {
    margin-top: 0.15rem;
    color: var(--doc-gold);
    font-size: 1.1rem;
}

.doc-no-results[hidden] {
    display: none;
}

/* An app control's own picture shown inline beside its name in a recipe */
.doc-inline-icon {
    vertical-align: text-bottom;
}

.doc-filter-pill .doc-glyph {
    margin-right: 0.3em;
}

/* Hand-kept hubs: docs home and product overview */
.doc-hub-header {
    margin-bottom: 2.5rem;
}

.doc-hub-header h1 {
    font-size: 2.5rem;
    margin-bottom: 0.75rem;
}

.doc-hub-header .doc-lead {
    font-size: 1.2rem;
}

.doc-hub-badges {
    display: flex;
    flex-wrap: wrap;
    gap: 0.5rem;
    margin-bottom: 0.5rem;
}

.doc-hub-actions {
    display: flex;
    flex-wrap: wrap;
    gap: 0.75rem;
    margin-top: 1.25rem;
}

.doc-hub-search {
    margin-top: 1.5rem;
}

.doc-search-trigger-lg {
    padding: 10px 20px;
    font-size: 1rem;
}

.doc-search-trigger-lg kbd {
    margin-left: 8px;
}

.doc-hub-note,
.doc-hub-block {
    margin-top: 1rem;
}

.doc-hub-section {
    margin-top: 2.5rem;
    margin-bottom: 3rem;
}

.doc-next-grid-wide {
    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
}

.doc-next-grid-compact {
    grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
}

.doc-table-wrapper {
    overflow-x: auto;
    margin-top: 1rem;
}

.doc-table {
    width: 100%;
    border-collapse: collapse;
}

.doc-table tr {
    border-bottom: 1px solid var(--doc-border);
}

.doc-table thead tr {
    border-bottom-width: 2px;
    text-align: left;
}

.doc-table th,
.doc-table td {
    padding: 10px;
}

.doc-table-key {
    font-weight: 600;
}

.doc-table-key .doc-glyph {
    margin-right: 0.4em;
}

.doc-hub-steps {
    display: flex;
    flex-direction: column;
    gap: 1rem;
    margin-top: 1rem;
}

.doc-hub-step {
    padding: 1.25rem;
    border: 1px solid var(--doc-border);
    border-radius: var(--doc-radius-sm);
    background: var(--doc-bg-surface);
}

.doc-hub-step h3,
.doc-hub-step h4 {
    margin: 0 0 8px 0;
    font-size: 1.0625rem;
    color: var(--doc-accent);
}

.demo-intro {
    margin-bottom: 2rem;
}

.demo-row {
    display: flex;
    flex-wrap: wrap;
    gap: 0.5rem;
    margin-bottom: 1.5rem;
}

.demo-grid-top {
    align-items: start;
}

.demo-box-centered {
    text-align: center;
}

.demo-frame-phone {
    height: 380px;
}

.demo-screen {
    display: flex;
    align-items: center;
    justify-content: center;
    height: 100%;
    color: var(--doc-text-muted);
    font-size: 0.875rem;
}

.demo-screen-watch {
    padding: 1rem;
    font-size: 0.75rem;
    text-align: center;
}

.demo-screen-vr {
    font-size: 0.8125rem;
}

.demo-list {
    display: flex;
    flex-direction: column;
    gap: 0.75rem;
    padding: 0;
    list-style: none;
}

/*
 * SITE-EXPERIENCE rule 17: on a touch screen every interactive chrome target is at least 44 px.
 * Elements that a narrow-screen rule hides with display: none (header links, the menu button on
 * a wide screen) get only a minimum box here, never a display value, so they stay hidden.
 */
@media (pointer: coarse) {
    .doc-header-brand,
    .doc-header-home,
    .doc-header-link,
    .doc-header-docs-link,
    .doc-lang-item {
        min-height: 44px;
    }
    .doc-header-link,
    .doc-header-docs-link {
        align-content: center;
    }
    .doc-mobile-menu-btn,
    .doc-lang-btn,
    .doc-theme-btn,
    .doc-theme-toggle,
    .doc-search-trigger,
    .doc-header-home {
        min-width: 44px;
        min-height: 44px;
    }
    .doc-sidebar-link,
    .doc-nav-link,
    .doc-toc-link {
        display: flex;
        align-items: center;
        min-height: 44px;
    }
    .doc-toc-list li {
        margin-bottom: 0;
    }
    .doc-breadcrumbs a,
    .doc-footer-links a {
        display: inline-flex;
        align-items: center;
        min-height: 44px;
    }
}