/* ============================================================================
   Carbon Design System Theme for MkDocs - Modern Layout
   ============================================================================ */

/* CSS Variables - Carbon Design Tokens */
:root {
    /* Colors - Carbon Design System */
    --link-color: #0f62fe;
    --link-hover-color: #0043ce;
    --text-primary: #161616;
    --text-secondary: #525252;
    --text-tertiary: #8d8d8d;
    --background: #ffffff;
    --background-hover: #e8e8e8;
    --border-subtle: #e0e0e0;
    --border-strong: #8d8d8d;
    --layer-01: #f4f4f4;
    --layer-02: #ffffff;
    --layer-03: #e0e0e0;
    --focus: #0f62fe;
    --interactive: #0f62fe;

    /* Spacing - Carbon spacing scale */
    --spacing-01: 0.125rem;  /* 2px */
    --spacing-02: 0.25rem;   /* 4px */
    --spacing-03: 0.5rem;    /* 8px */
    --spacing-04: 0.75rem;   /* 12px */
    --spacing-05: 1rem;      /* 16px */
    --spacing-06: 1.5rem;    /* 24px */
    --spacing-07: 2rem;      /* 32px */
    --spacing-08: 2.5rem;    /* 40px */
    --spacing-09: 3rem;      /* 48px */
    --spacing-10: 4rem;      /* 64px */

    /* Typography - Carbon type scale */
    --font-family-sans: "IBM Plex Sans Light", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
    --font-family-mono: "IBM Plex Mono Light", "Courier New", monospace;

    /* Font sizes */
    --font-size-01: 0.75rem;    /* 12px - caption */
    --font-size-02: 0.875rem;   /* 14px - body-short */
    --font-size-03: 1rem;       /* 16px - body-long */
    --font-size-04: 1.125rem;   /* 18px - heading-compact */
    --font-size-05: 1.25rem;    /* 20px - heading */
    --font-size-06: 1.5rem;     /* 24px - heading */
    --font-size-07: 2rem;       /* 32px - heading */
    --font-size-08: 2.625rem;   /* 42px - display */

    /* Line heights */
    --line-height-tight: 1.25;
    --line-height-normal: 1.5;
    --line-height-loose: 1.75;

    /* Font weights */
    --font-weight-light: 300;
    --font-weight-regular: 400;
    --font-weight-semibold: 600;

    /* Layout dimensions */
    --header-height: 48px;
    --sidebar-width: 256px;
    --content-max-width: 900px;
    --toc-width: 256px;

    /* Border radius */
    --radius-sm: 2px;
    --radius-md: 4px;
    --radius-lg: 8px;

    /* Shadows */
    --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.05);
    --shadow-md: 0 2px 8px rgba(0, 0, 0, 0.15);
    --shadow-lg: 0 4px 12px rgba(0, 0, 0, 0.2);

    /* Transitions */
    --transition-fast: 0.11s cubic-bezier(0.2, 0, 0.38, 0.9);
    --transition-medium: 0.24s cubic-bezier(0.2, 0, 0.38, 0.9);
    --transition-slow: 0.4s cubic-bezier(0.2, 0, 0.38, 0.9);

    /* Z-index scale */
    --z-header: 10000;
    --z-sidebar: 9000;
    --z-back-to-top: 9999;
    --z-overlay: 8000;
}

/* Theme-specific color overrides */
[data-carbon-theme="g10"] {
    --background: #f4f4f4;
    --layer-01: #ffffff;
    --layer-02: #f4f4f4;
}

[data-carbon-theme="g90"] {
    --text-primary: #f4f4f4;
    --text-secondary: #c6c6c6;
    --text-tertiary: #8d8d8d;
    --background: #262626;
    --layer-01: #393939;
    --layer-02: #525252;
    --border-subtle: #525252;
    /* Dark theme link colors - Carbon blue-40/30 for better contrast */
    --link-color: #78a9ff;        /* blue-40 - WCAG AAA: 9.54:1 */
    --link-hover-color: #a6c8ff;  /* blue-30 - WCAG AAA: 12.68:1 */
}

[data-carbon-theme="g100"] {
    --text-primary: #f4f4f4;
    --text-secondary: #c6c6c6;
    --text-tertiary: #8d8d8d;
    --background: #161616;
    --layer-01: #262626;
    --layer-02: #393939;
    --border-subtle: #393939;
    /* Dark theme link colors - Carbon blue-40/30 for better contrast */
    --link-color: #78a9ff;        /* blue-40 - WCAG AAA: 10.80:1 */
    --link-hover-color: #a6c8ff;  /* blue-30 - WCAG AAA: 14.36:1 */
}

/* ============================================================================
   Fonts
   ============================================================================ */
@font-face {
    font-family: "IBM Plex Sans Light";
    src: url(../fonts/ibmplexsans-light.ttf);
}

@font-face {
    font-family: "IBM Plex Mono Light";
    src: url(../fonts/ibmplexmono-light.ttf);
}

/* ============================================================================
   Base Styles
   ============================================================================ */
* {
    box-sizing: border-box;
}

html {
    height: 100%;
    scroll-behavior: smooth;
}

body {
    font-family: var(--font-family-sans);
    font-style: normal;
    font-size: var(--font-size-03);
    line-height: var(--line-height-normal);
    font-weight: var(--font-weight-light);
    color: var(--text-primary);
    background-color: var(--background);
    margin: 0;
    padding: 0;
    min-height: 100%;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
}

/* ============================================================================
   Layout Grid - Three Column Design
   ============================================================================ */
.md-grid {
    display: flex;
    flex-direction: column;
    min-height: 100vh;
}

.md-header {
    position: fixed;
    top: 0;
    left: 0;
    right: 0;
    height: var(--header-height);
    z-index: 10000;
}

.md-container {
    display: flex;
    flex: 1;
    margin-top: var(--header-height);
    position: relative;
}

/* Left Sidebar - Navigation */
.md-sidebar--primary {
    width: var(--sidebar-width);
    flex-shrink: 0;
    position: sticky;
    top: var(--header-height);
    max-height: calc(100vh - var(--header-height));
    align-self: flex-start;
    overflow-y: auto;
    overflow-x: hidden;
    border-right: 1px solid var(--border-subtle);
}

.md-sidebar__scrollwrap {
    height: 100%;
    overflow-y: auto;
    overflow-x: hidden;
}

.md-sidebar__inner {
    padding: var(--spacing-05) 0;
}

/* Main Content Area */
.md-content {
    flex: 1;
    min-width: 0;
    display: flex;
    justify-content: center;
}

.md-content__inner {
    width: 100%;
    max-width: var(--content-max-width);
    padding: var(--spacing-01) var(--spacing-06) var(--spacing-07) var(--spacing-06);
}

/* Right Sidebar - Table of Contents */
.md-sidebar--secondary {
    width: var(--toc-width);
    flex-shrink: 0;
    position: sticky;
    top: var(--header-height);
    max-height: calc(100vh - var(--header-height));
    align-self: flex-start;
    overflow-y: auto;
    overflow-x: hidden;
    border-left: 1px solid var(--border-subtle);
}

/* Full-width layout when widescreen is enabled */
.md-container[data-widescreen="true"] .md-content {
    justify-content: flex-start;
}

.md-container[data-widescreen="true"] .md-content__inner {
    max-width: 100%;
    padding: var(--spacing-01) var(--spacing-06) var(--spacing-07) var(--spacing-06);
}

/* ============================================================================
   Table of Contents Sidebar
   ============================================================================ */
.md-toc {
    padding: var(--spacing-01) var(--spacing-05);
}

.md-toc__title {
    font-size: 0.75rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--text-secondary);
    margin-bottom: var(--spacing-05);
}

.md-toc__list {
    list-style: none;
    padding: 0;
    margin: 0;
}

.md-toc__item {
    margin: 0;
    padding: 0;
}

.md-toc__link {
    display: block;
    padding: 0.375rem 0;
    color: var(--text-secondary);
    text-decoration: none;
    font-size: 0.875rem;
    line-height: 1.4;
    transition: color var(--transition-fast);
    border-left: 2px solid transparent;
    padding-left: var(--spacing-03);
    margin-left: -2px;
}

.md-toc__link:hover {
    color: var(--link-color);
}

.md-toc__link.active {
    color: var(--link-color);
    border-left-color: var(--link-color);
    font-weight: 500;
}

/* Nested TOC levels */
.md-toc__list .md-toc__list {
    padding-left: var(--spacing-05);
}

.md-toc__link[data-md-level="2"] {
    font-size: 0.8125rem;
}

.md-toc__link[data-md-level="3"] {
    font-size: 0.75rem;
}

/* ============================================================================
   Breadcrumbs
   ============================================================================ */
.md-breadcrumbs {
    margin-bottom: var(--spacing-06);
    padding: var(--spacing-04) 0;
    border-bottom: 1px solid var(--border-subtle);
}

/* Style Carbon breadcrumb component using CSS custom properties */
cds-breadcrumb {
    --cds-text-secondary: var(--text-secondary);
    --cds-link-primary: var(--link-color);
    --cds-link-primary-hover: var(--link-hover-color);
    --cds-text-primary: var(--text-primary);
}

/* Light themes - breadcrumb colors */
[data-carbon-theme="white"] cds-breadcrumb,
[data-carbon-theme="g10"] cds-breadcrumb {
    --cds-text-secondary: #525252;
    --cds-text-primary: #161616;
    --cds-link-primary: #0f62fe;
    --cds-link-primary-hover: #0043ce;
}

/* Dark themes - breadcrumb colors */
[data-carbon-theme="g90"] cds-breadcrumb,
[data-carbon-theme="g100"] cds-breadcrumb {
    --cds-text-secondary: #c6c6c6;
    --cds-text-primary: #f4f4f4;
    --cds-link-primary: #78a9ff;
    --cds-link-primary-hover: #a6c8ff;
}

/* Breadcrumb TOC select styling */
#breadcrumbs-toc {
    display: inline-block;
    min-width: 200px;
    vertical-align: middle;
}

/* Light themes - breadcrumb select */
[data-carbon-theme="white"] cds-breadcrumb-item cds-select,
[data-carbon-theme="g10"] cds-breadcrumb-item cds-select {
    --cds-background: #ffffff;
    --cds-layer: #f4f4f4;
    --cds-field: #ffffff;
    --cds-text-primary: #161616;
    --cds-text-secondary: #525252;
    --cds-border-subtle: #e0e0e0;
    --cds-border-strong: #8d8d8d;
}

/* Dark themes - breadcrumb select */
[data-carbon-theme="g90"] cds-breadcrumb-item cds-select,
[data-carbon-theme="g100"] cds-breadcrumb-item cds-select {
    --cds-background: #393939;
    --cds-layer: #525252;
    --cds-field: #393939;
    --cds-text-primary: #f4f4f4;
    --cds-text-secondary: #c6c6c6;
    --cds-border-subtle: #525252;
    --cds-border-strong: #8d8d8d;
    --cds-icon-primary: #f4f4f4;
    --cds-icon-secondary: #c6c6c6;
}

/* ============================================================================
   Content Styles
   ============================================================================ */
.rst-content {
    color: var(--text-primary);
}

.rst-content h1,
.rst-content h2,
.rst-content h3,
.rst-content h4,
.rst-content h5,
.rst-content h6 {
    font-weight: var(--font-weight-regular);
    line-height: var(--line-height-tight);
    margin-top: var(--spacing-07);
    margin-bottom: var(--spacing-05);
    scroll-margin-top: calc(var(--header-height) + var(--spacing-05));
    color: var(--text-primary);
}

.rst-content h1 {
    font-size: var(--font-size-08);
    margin-top: 0;
    font-weight: var(--font-weight-light);
}

.rst-content h2 {
    font-size: var(--font-size-07);
    padding-bottom: var(--spacing-03);
    border-bottom: 1px solid var(--border-subtle);
}

.rst-content h3 {
    font-size: var(--font-size-06);
}

.rst-content h4 {
    font-size: var(--font-size-05);
}

.rst-content h5 {
    font-size: var(--font-size-04);
}

.rst-content h6 {
    font-size: var(--font-size-03);
    font-weight: var(--font-weight-semibold);
}

.rst-content p {
    margin-bottom: 1em;
    line-height: 1.6;
}

.rst-content li {
    line-height: 1.6;
    margin-bottom: 0.5em;
}

.rst-content ul,
.rst-content ol {
    margin-bottom: var(--spacing-05);
}

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

a:hover {
    color: var(--link-hover-color);
    text-decoration: underline;
}

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

a.headerlink {
    margin-left: 0.5em;
    opacity: 0;
    transition: opacity var(--transition-fast);
    text-decoration: none;
    display: inline-block;
    width: 16px;
    height: 16px;
    vertical-align: middle;
}

a.headerlink::before {
    content: '';
    display: inline-block;
    width: 16px;
    height: 16px;
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32' fill='%230f62fe'%3E%3Cpath d='M29.25,6.76a6,6,0,0,0-8.5,0l1.42,1.42a4,4,0,1,1,5.67,5.67l-8,8a4,4,0,1,1-5.67-5.66l1.41-1.42-1.41-1.42-1.42,1.42a6,6,0,0,0,0,8.5A6,6,0,0,0,17,25a6,6,0,0,0,4.27-1.76l8-8A6,6,0,0,0,29.25,6.76Z'/%3E%3Cpath d='M4.19,24.82a4,4,0,0,1,0-5.67l8-8a4,4,0,0,1,5.67,0A3.94,3.94,0,0,1,19,14a4,4,0,0,1-1.17,2.85L15.71,19l1.42,1.42,2.12-2.12a6,6,0,0,0-8.51-8.51l-8,8a6,6,0,0,0,0,8.51A6,6,0,0,0,7,28a6.07,6.07,0,0,0,4.28-1.76L9.86,24.82A4,4,0,0,1,4.19,24.82Z'/%3E%3C/svg%3E");
    background-size: contain;
    background-repeat: no-repeat;
    background-position: center;
}

/* Hide the default ¶ symbol */
a.headerlink {
    font-size: 0;
}

/* Theme-adaptive link icon colors */
[data-carbon-theme="white"] a.headerlink::before,
[data-carbon-theme="g10"] a.headerlink::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32' fill='%230f62fe'%3E%3Cpath d='M29.25,6.76a6,6,0,0,0-8.5,0l1.42,1.42a4,4,0,1,1,5.67,5.67l-8,8a4,4,0,1,1-5.67-5.66l1.41-1.42-1.41-1.42-1.42,1.42a6,6,0,0,0,0,8.5A6,6,0,0,0,17,25a6,6,0,0,0,4.27-1.76l8-8A6,6,0,0,0,29.25,6.76Z'/%3E%3Cpath d='M4.19,24.82a4,4,0,0,1,0-5.67l8-8a4,4,0,0,1,5.67,0A3.94,3.94,0,0,1,19,14a4,4,0,0,1-1.17,2.85L15.71,19l1.42,1.42,2.12-2.12a6,6,0,0,0-8.51-8.51l-8,8a6,6,0,0,0,0,8.51A6,6,0,0,0,7,28a6.07,6.07,0,0,0,4.28-1.76L9.86,24.82A4,4,0,0,1,4.19,24.82Z'/%3E%3C/svg%3E");
}

[data-carbon-theme="g90"] a.headerlink::before,
[data-carbon-theme="g100"] a.headerlink::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32' fill='%2378a9ff'%3E%3Cpath d='M29.25,6.76a6,6,0,0,0-8.5,0l1.42,1.42a4,4,0,1,1,5.67,5.67l-8,8a4,4,0,1,1-5.67-5.66l1.41-1.42-1.41-1.42-1.42,1.42a6,6,0,0,0,0,8.5A6,6,0,0,0,17,25a6,6,0,0,0,4.27-1.76l8-8A6,6,0,0,0,29.25,6.76Z'/%3E%3Cpath d='M4.19,24.82a4,4,0,0,1,0-5.67l8-8a4,4,0,0,1,5.67,0A3.94,3.94,0,0,1,19,14a4,4,0,0,1-1.17,2.85L15.71,19l1.42,1.42,2.12-2.12a6,6,0,0,0-8.51-8.51l-8,8a6,6,0,0,0,0,8.51A6,6,0,0,0,7,28a6.07,6.07,0,0,0,4.28-1.76L9.86,24.82A4,4,0,0,1,4.19,24.82Z'/%3E%3C/svg%3E");
}

h1:hover a.headerlink,
h2:hover a.headerlink,
h3:hover a.headerlink,
h4:hover a.headerlink {
    opacity: 1;
}

/* Code - Theme Adaptive */
.rst-content pre,
.rst-content code {
    font-family: var(--font-family-mono);
    font-size: 0.875em;
}

.rst-content p code,
.rst-content li code {
    padding: 0.125rem 0.375rem;
    border-radius: var(--radius-sm);
    border: 1px solid var(--border-subtle);
    background-color: var(--layer-01);
    color: var(--text-primary);
}

/* Light theme inline code */
[data-carbon-theme="white"] .rst-content p code,
[data-carbon-theme="white"] .rst-content li code,
[data-carbon-theme="g10"] .rst-content p code,
[data-carbon-theme="g10"] .rst-content li code {
    color: #c7254e;
    background-color: #f9f2f4;
    border-color: #f2dede;
}

.rst-content pre {
    position: relative;
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-md);
    padding: var(--spacing-05);
    overflow-x: auto;
    line-height: 1.5;
    margin-bottom: var(--spacing-06);
    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.05);
}

/* Light theme code blocks - match HighlightJS github theme */
[data-carbon-theme="white"] .rst-content pre,
[data-carbon-theme="g10"] .rst-content pre {
    background-color: #f6f8fa;
    border-color: #d0d7de;
}

/* Dark theme code blocks - match HighlightJS github-dark theme */
[data-carbon-theme="g90"] .rst-content pre,
[data-carbon-theme="g100"] .rst-content pre {
    background-color: #0d1117;
    border-color: #30363d;
}

.rst-content pre code {
    background: none;
    border: none;
    padding: 0;
    color: inherit;
    font-size: 0.875rem;
    line-height: 1.5;
}

/* Images */
.rst-content img {
    display: block;
    margin: var(--spacing-06) auto;
    max-width: 100%;
    height: auto;
    border-radius: 4px;
}

/* Blockquotes - Theme Adaptive */
blockquote {
    position: relative;
    margin: var(--spacing-06) 0;
    padding: var(--spacing-03) var(--spacing-06) var(--spacing-05);
    border-left: 4px solid var(--interactive);
    background-color: var(--layer-01);
    border-radius: 0 var(--radius-md) var(--radius-md) 0;
    color: var(--text-primary);
}

/* Light theme blockquotes */
[data-carbon-theme="white"] blockquote,
[data-carbon-theme="g10"] blockquote {
    background-color: #edf5ff;
    border-left-color: #0f62fe;
}

blockquote p:first-child {
    margin-top: 0;
}

blockquote p:last-child {
    margin-bottom: 0;
}

/* Tables - Carbon Data Table Style */
.rst-content table {
    width: 100%;
    margin-bottom: var(--spacing-07);
    border-collapse: collapse;
    border-spacing: 0;
    background-color: var(--layer-01);
    border: 1px solid var(--border-subtle);
}

.rst-content table thead {
    background-color: var(--layer-02);
    border-bottom: 1px solid var(--border-strong);
}

.rst-content table tr th {
    padding: var(--spacing-05);
    color: var(--text-primary);
    font-weight: var(--font-weight-semibold);
    font-size: var(--font-size-02);
    text-align: left;
    border-bottom: 1px solid var(--border-subtle);
    text-transform: uppercase;
    letter-spacing: 0.05em;
}

.rst-content table tr th a {
    color: var(--text-primary);
    text-decoration: none;
}

.rst-content table tr th a:hover {
    color: var(--link-color);
    text-decoration: underline;
}

.rst-content table tbody tr {
    border-bottom: 1px solid var(--border-subtle);
    transition: background-color var(--transition-fast);
}

.rst-content table tbody tr:hover {
    background-color: var(--background-hover);
}

.rst-content table tr td {
    padding: var(--spacing-05);
    vertical-align: top;
    color: var(--text-primary);
    font-size: var(--font-size-02);
}

/* Remove alternating row colors, use hover instead */
.rst-content table tbody tr:nth-child(even),
.rst-content table tbody tr:nth-child(odd) {
    background-color: transparent;
}

/* Light theme specific enhancements */
[data-carbon-theme="white"] .rst-content table,
[data-carbon-theme="g10"] .rst-content table {
    background-color: #ffffff;
}

[data-carbon-theme="white"] .rst-content table thead,
[data-carbon-theme="g10"] .rst-content table thead {
    background-color: #f4f4f4;
}

/* Dark theme specific enhancements */
[data-carbon-theme="g90"] .rst-content table tbody tr:hover,
[data-carbon-theme="g100"] .rst-content table tbody tr:hover {
    background-color: var(--layer-02);
}

/* Table cell with spacer class (if used) */
.rst-content table tr td.spacer {
    width: 2px;
    padding: 0;
    margin: 0;
    background-color: var(--border-subtle);
}

/* Responsive tables */
@media (max-width: 767px) {
    .rst-content table {
        font-size: var(--font-size-01);
    }

    .rst-content table tr th,
    .rst-content table tr td {
        padding: var(--spacing-03) var(--spacing-04);
    }
}

/* ============================================================================
   Admonitions - Carbon Design System Notification Pattern
   ============================================================================ */

/* Base admonition styling */
.rst-content .admonition,
.rst-content .note,
.rst-content .warning,
.rst-content .tip,
.rst-content .important,
.rst-content .caution,
.rst-content .danger,
.rst-content .error,
.rst-content .bug {
    padding: var(--spacing-05);
    margin-bottom: var(--spacing-06);
    border-radius: 0;
    border-left: 3px solid;
    background-color: var(--layer-01);
    color: var(--text-primary);
}

.rst-content .admonition-title {
    font-weight: 600;
    margin: calc(-1 * var(--spacing-05)) calc(-1 * var(--spacing-05)) var(--spacing-04);
    padding: var(--spacing-04) var(--spacing-05);
    display: flex;
    align-items: center;
    gap: var(--spacing-03);
}

/* Note / Info / Bug - Blue (Informational) */
.rst-content .note,
.rst-content .admonition,
.rst-content .bug {
    border-left-color: #0f62fe;  /* blue-60 */
}

.rst-content .note .admonition-title,
.rst-content .admonition .admonition-title,
.rst-content .bug .admonition-title {
    color: #0f62fe;  /* blue-60 */
    background-color: transparent;
}

/* Light theme - subtle blue background */
[data-carbon-theme="white"] .rst-content .note,
[data-carbon-theme="white"] .rst-content .admonition,
[data-carbon-theme="white"] .rst-content .bug,
[data-carbon-theme="g10"] .rst-content .note,
[data-carbon-theme="g10"] .rst-content .admonition,
[data-carbon-theme="g10"] .rst-content .bug {
    background-color: #edf5ff;  /* blue-10 */
}

/* Dark theme - use layer with lighter border */
[data-carbon-theme="g90"] .rst-content .note,
[data-carbon-theme="g90"] .rst-content .admonition,
[data-carbon-theme="g90"] .rst-content .bug,
[data-carbon-theme="g100"] .rst-content .note,
[data-carbon-theme="g100"] .rst-content .admonition,
[data-carbon-theme="g100"] .rst-content .bug {
    background-color: var(--layer-02);
    border-left-color: #78a9ff;  /* blue-40 */
}

[data-carbon-theme="g90"] .rst-content .note .admonition-title,
[data-carbon-theme="g90"] .rst-content .admonition .admonition-title,
[data-carbon-theme="g90"] .rst-content .bug .admonition-title,
[data-carbon-theme="g100"] .rst-content .note .admonition-title,
[data-carbon-theme="g100"] .rst-content .admonition .admonition-title,
[data-carbon-theme="g100"] .rst-content .bug .admonition-title {
    color: #78a9ff;  /* blue-40 */
}

/* Tip / Important - Green (Success) */
.rst-content .tip,
.rst-content .important {
    border-left-color: #24a148;  /* green-50 */
}

.rst-content .tip .admonition-title,
.rst-content .important .admonition-title {
    color: #24a148;  /* green-50 */
    background-color: transparent;
}

/* Light theme - subtle green background */
[data-carbon-theme="white"] .rst-content .tip,
[data-carbon-theme="white"] .rst-content .important,
[data-carbon-theme="g10"] .rst-content .tip,
[data-carbon-theme="g10"] .rst-content .important {
    background-color: #defbe6;  /* green-10 */
}

/* Dark theme - use layer with lighter border */
[data-carbon-theme="g90"] .rst-content .tip,
[data-carbon-theme="g90"] .rst-content .important,
[data-carbon-theme="g100"] .rst-content .tip,
[data-carbon-theme="g100"] .rst-content .important {
    background-color: var(--layer-02);
    border-left-color: #42be65;  /* green-40 */
}

[data-carbon-theme="g90"] .rst-content .tip .admonition-title,
[data-carbon-theme="g90"] .rst-content .important .admonition-title,
[data-carbon-theme="g100"] .rst-content .tip .admonition-title,
[data-carbon-theme="g100"] .rst-content .important .admonition-title {
    color: #42be65;  /* green-40 */
}

/* Warning / Caution - Orange (Warning) */
.rst-content .warning,
.rst-content .caution {
    border-left-color: #ff832b;  /* orange-40 */
}

.rst-content .warning .admonition-title,
.rst-content .caution .admonition-title {
    color: #ff832b;  /* orange-40 */
    background-color: transparent;
}

/* Light theme - subtle orange background */
[data-carbon-theme="white"] .rst-content .warning,
[data-carbon-theme="white"] .rst-content .caution,
[data-carbon-theme="g10"] .rst-content .warning,
[data-carbon-theme="g10"] .rst-content .caution {
    background-color: #fff2e8;  /* orange-10 */
}

/* Dark theme - use layer with lighter border */
[data-carbon-theme="g90"] .rst-content .warning,
[data-carbon-theme="g90"] .rst-content .caution,
[data-carbon-theme="g100"] .rst-content .warning,
[data-carbon-theme="g100"] .rst-content .caution {
    background-color: var(--layer-02);
    border-left-color: #ff832b;  /* orange-40 */
}

[data-carbon-theme="g90"] .rst-content .warning .admonition-title,
[data-carbon-theme="g90"] .rst-content .caution .admonition-title,
[data-carbon-theme="g100"] .rst-content .warning .admonition-title,
[data-carbon-theme="g100"] .rst-content .caution .admonition-title {
    color: #ff832b;  /* orange-40 */
}

/* Danger / Error - Red (Error) */
.rst-content .danger,
.rst-content .error {
    border-left-color: #da1e28;  /* red-60 */
}

.rst-content .danger .admonition-title,
.rst-content .error .admonition-title {
    color: #da1e28;  /* red-60 */
    background-color: transparent;
}

/* Light theme - subtle red background */
[data-carbon-theme="white"] .rst-content .danger,
[data-carbon-theme="white"] .rst-content .error,
[data-carbon-theme="g10"] .rst-content .danger,
[data-carbon-theme="g10"] .rst-content .error {
    background-color: #fff1f1;  /* red-10 */
}

/* Dark theme - use layer with lighter border */
[data-carbon-theme="g90"] .rst-content .danger,
[data-carbon-theme="g90"] .rst-content .error,
[data-carbon-theme="g100"] .rst-content .danger,
[data-carbon-theme="g100"] .rst-content .error {
    background-color: var(--layer-02);
    border-left-color: #fa4d56;  /* red-50 */
}

[data-carbon-theme="g90"] .rst-content .danger .admonition-title,
[data-carbon-theme="g90"] .rst-content .error .admonition-title,
[data-carbon-theme="g100"] .rst-content .danger .admonition-title,
[data-carbon-theme="g100"] .rst-content .error .admonition-title {
    color: #fa4d56;  /* red-50 */
}

.rst-content .admonition p:last-child {
    margin-bottom: 0;
}

/* Ensure text is readable in all themes */
.rst-content .admonition p,
.rst-content .admonition li {
    color: var(--text-primary);
}

/* ============================================================================
   Navigation Footer (Previous/Next)
   ============================================================================ */
.md-footer-nav {
    margin-top: var(--spacing-09);
    padding-top: var(--spacing-06);
    border-top: 1px solid var(--border-subtle);
}

.md-footer-nav__inner {
    display: flex;
    justify-content: space-between;
    gap: var(--spacing-05);
}

.md-footer-nav__link {
    display: flex;
    flex-direction: column;
    padding: var(--spacing-05);
    border-radius: 4px;
    border: 1px solid var(--border-subtle);
    text-decoration: none;
    color: var(--text-primary);
    transition: all var(--transition-fast);
    flex: 1;
    max-width: 48%;
}

.md-footer-nav__link:hover {
    background-color: var(--layer-01);
    border-color: var(--link-color);
    text-decoration: none;
}

.md-footer-nav__link--prev {
    align-items: flex-start;
}

.md-footer-nav__link--next {
    align-items: flex-end;
    text-align: right;
}

.md-footer-nav__direction {
    display: flex;
    align-items: center;
    gap: 0.5rem;
    font-size: 0.75rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--text-secondary);
    margin-bottom: 0.25rem;
}

.md-footer-nav__icon {
    width: 20px;
    height: 20px;
    fill: currentColor;
}

.md-footer-nav__title-text {
    font-size: 1rem;
    font-weight: 400;
    color: var(--text-primary);
}

/* ============================================================================
   Footer
   ============================================================================ */
.md-footer {
    width: 100%;
    background-color: var(--layer-01);
    border-top: 1px solid var(--border-subtle);
    margin-top: auto;
    padding: var(--spacing-06) var(--spacing-05);
    text-align: center;
    font-size: 0.875rem;
    color: var(--text-secondary);
    position: relative;
    z-index: 1;
}

.md-footer a {
    color: var(--link-color);
    text-decoration: none;
}

.md-footer a:hover {
    text-decoration: underline;
}

/* ============================================================================
   Carbon Components Adjustments
   ============================================================================ */
cds-header {
    z-index: 10000;
    padding-right: var(--spacing-06);
}

/* Header theme adaptation */
[data-carbon-theme="white"] cds-header,
[data-carbon-theme="g10"] cds-header {
    --cds-background: #ffffff;
    --cds-layer: #f4f4f4;
    --cds-text-primary: #161616;
    --cds-text-secondary: #525252;
    --cds-link-primary: #0f62fe;
    --cds-border-subtle: #e0e0e0;
}

[data-carbon-theme="g90"] cds-header,
[data-carbon-theme="g100"] cds-header {
    --cds-background: #161616;
    --cds-layer: #262626;
    --cds-text-primary: #f4f4f4;
    --cds-text-secondary: #c6c6c6;
    --cds-link-primary: #78a9ff;
    --cds-border-subtle: #393939;
}

cds-side-nav {
    display: block;
}

/* Side navigation theme adaptation */
[data-carbon-theme="white"] cds-side-nav,
[data-carbon-theme="g10"] cds-side-nav {
    --cds-background: #f4f4f4;
    --cds-layer: #ffffff;
    --cds-text-primary: #161616;
    --cds-text-secondary: #525252;
    --cds-link-primary: #0f62fe;
    --cds-border-subtle: #e0e0e0;
}

[data-carbon-theme="g90"] cds-side-nav,
[data-carbon-theme="g100"] cds-side-nav {
    --cds-background: #393939;
    --cds-layer: #525252;
    --cds-text-primary: #f4f4f4;
    --cds-text-secondary: #c6c6c6;
    --cds-link-primary: #78a9ff;
    --cds-border-subtle: #525252;
}

/* Make side-nav fill container width and height in mobile mode */
@media (max-width: 1023px) {
    cds-side-nav {
        width: 100% !important;
        height: 100% !important;
        display: flex !important;
        flex-direction: column !important;
        border-right: none !important;
        --cds-border-subtle: transparent !important;
        --cds-border-subtle-00: transparent !important;
        --cds-border-strong: transparent !important;
    }

    /* Make side-nav-items fill full width and height */
    cds-side-nav-items {
        width: 100% !important;
        flex: 1 !important;
        display: block !important;
    }

    /* Also target the sidebar container */
    .md-sidebar--primary.active cds-side-nav {
        border: none !important;
        box-shadow: none;
    }
}

/* ============================================================================
   Carbon Accordion - Enhanced Styling
   ============================================================================ */
cds-accordion {
    display: block;
    margin-bottom: var(--spacing-06);
    width: 100%;
}

/* Light themes - accordion styling */
[data-carbon-theme="white"] cds-accordion,
[data-carbon-theme="g10"] cds-accordion {
    --cds-background: #f4f4f4;
    --cds-layer: #ffffff;
    --cds-layer-accent: #e0e0e0;
    --cds-field: #ffffff;
    --cds-border-subtle: #e0e0e0;
    --cds-border-strong: #8d8d8d;
    --cds-text-primary: #161616;
    --cds-text-secondary: #525252;
    --cds-link-primary: #0f62fe;
    --cds-focus: #0f62fe;
}

/* Dark themes - accordion styling */
[data-carbon-theme="g90"] cds-accordion,
[data-carbon-theme="g100"] cds-accordion {
    --cds-background: #262626;
    --cds-layer: #393939;
    --cds-layer-accent: #525252;
    --cds-field: #393939;
    --cds-border-subtle: #525252;
    --cds-border-strong: #8d8d8d;
    --cds-text-primary: #f4f4f4;
    --cds-text-secondary: #c6c6c6;
    --cds-link-primary: #78a9ff;
    --cds-focus: #78a9ff;
}

/* Accordion spacing and borders */
cds-accordion-item {
    margin-bottom: var(--spacing-03) !important;
    border: 1px solid var(--border-subtle) !important;
    width: 100%;
    box-sizing: border-box;
}

/* Ensure accordion content is properly constrained with padding */
cds-accordion-item::part(content) {
    width: 100%;
    max-width: 100%;
    box-sizing: border-box;
    padding: var(--spacing-05);
    overflow: hidden;
}

/* Ensure content inside accordion doesn't overflow */
cds-accordion-item * {
    box-sizing: border-box;
    max-width: 100%;
}
/* ============================================================================
   Carbon Tabs - Theme Adaptive
   ============================================================================ */

/* Apply theme zone to tabs for proper styling */
cds-tabs {
    margin-bottom: var(--spacing-06);
}

/* Light themes - use g10 zone for tabs */
[data-carbon-theme="white"] cds-tabs,
[data-carbon-theme="g10"] cds-tabs {
    --cds-background: #f4f4f4;
    --cds-layer: #ffffff;
    --cds-layer-accent: #e0e0e0;
    --cds-field: #ffffff;
    --cds-border-subtle: #e0e0e0;
    --cds-border-strong: #8d8d8d;
    --cds-text-primary: #161616;
    --cds-text-secondary: #525252;
    --cds-link-primary: #0f62fe;
}

/* Dark themes - use g90/g100 zone for tabs */
[data-carbon-theme="g90"] cds-tabs,
[data-carbon-theme="g100"] cds-tabs {
    --cds-background: #262626;
    --cds-layer: #393939;
    --cds-layer-accent: #525252;
    --cds-field: #393939;
    --cds-border-subtle: #525252;
    --cds-border-strong: #8d8d8d;
    --cds-text-primary: #f4f4f4;
    --cds-text-secondary: #c6c6c6;
    --cds-link-primary: #78a9ff;
}

/* Tab panels */
.tab-panel {
    margin: var(--spacing-05) 0;
    padding: var(--spacing-05);
    background-color: var(--layer-01);
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-md);
    color: var(--text-primary);
}

.tab-panel [role="tabpanel"] {
    padding: var(--spacing-05);
}

/* Light theme tab panels */
[data-carbon-theme="white"] .tab-panel,
[data-carbon-theme="g10"] .tab-panel {
    background-color: #ffffff;
    border-color: #e0e0e0;
}

/* Dark theme tab panels */
[data-carbon-theme="g90"] .tab-panel,
[data-carbon-theme="g100"] .tab-panel {
    background-color: #393939;
    border-color: #525252;
}

/* Ensure tab panel content is readable */
.tab-panel p,
.tab-panel li,
.tab-panel h1,
.tab-panel h2,
.tab-panel h3,
.tab-panel h4 {
    color: var(--text-primary);
}

/* Make sure hidden panels stay hidden */
.tab-panel [role="tabpanel"][hidden] {
    display: none;
}

/* ============================================================================
   Theme Toggle
   ============================================================================ */
.md-theme-toggle {
    position: relative;
    display: inline-flex;
    align-items: center;
    margin-right: var(--spacing-03);
}

.md-theme-toggle__button {
    width: 40px;
    height: 40px;
    padding: 0;
    border: none;
    background: transparent;
    cursor: pointer;
    border-radius: 50%;
    display: flex;
    align-items: center;
    justify-content: center;
    transition: background-color var(--transition-fast);
    color: inherit;
}

.md-theme-toggle__button:hover {
    background-color: rgba(255, 255, 255, 0.1);
}

.md-theme-toggle__icon {
    width: 20px;
    height: 20px;
    fill: currentColor;
}

.md-theme-toggle__menu {
    position: absolute;
    top: calc(100% + var(--spacing-02));
    right: 0;
    background-color: var(--layer-02);
    border: 1px solid var(--border-subtle);
    border-radius: var(--radius-md);
    box-shadow: var(--shadow-md);
    padding: var(--spacing-02);
    min-width: 180px;
    z-index: 10001;
}

.md-theme-toggle__menu[hidden] {
    display: none;
}

.md-theme-toggle__option {
    display: flex;
    align-items: center;
    justify-content: space-between;
    width: 100%;
    padding: var(--spacing-03) var(--spacing-04);
    border: none;
    background: transparent;
    cursor: pointer;
    border-radius: var(--radius-sm);
    transition: background-color var(--transition-fast);
    color: var(--text-primary);
    font-family: var(--font-family-sans);
    font-size: var(--font-size-02);
    text-align: left;
}

.md-theme-toggle__option:hover {
    background-color: var(--background-hover);
}

.md-theme-toggle__option.active {
    background-color: var(--interactive);
    color: #ffffff;
}

.md-theme-toggle__option.active .md-theme-toggle__preview {
    border-color: #ffffff;
}

.md-theme-toggle__label {
    flex: 1;
}

.md-theme-toggle__preview {
    width: 24px;
    height: 24px;
    border-radius: 50%;
    border: 2px solid var(--border-subtle);
    margin-left: var(--spacing-03);
}

.md-theme-toggle__preview--white {
    background: linear-gradient(135deg, #ffffff 50%, #f4f4f4 50%);
}

.md-theme-toggle__preview--g10 {
    background: linear-gradient(135deg, #f4f4f4 50%, #e0e0e0 50%);
}

.md-theme-toggle__preview--g90 {
    background: linear-gradient(135deg, #393939 50%, #262626 50%);
}

.md-theme-toggle__preview--g100 {
    background: linear-gradient(135deg, #262626 50%, #161616 50%);
}

/* Theme-specific adjustments for toggle in header */
.cds-theme-zone-g100 .md-theme-toggle__button,
.cds-theme-zone-g90 .md-theme-toggle__button {
    color: #f4f4f4;
}

.cds-theme-zone-g100 .md-theme-toggle__button:hover,
.cds-theme-zone-g90 .md-theme-toggle__button:hover {
    background-color: rgba(255, 255, 255, 0.1);
}

/* Dark theme menu styling */
[data-carbon-theme="g90"] .md-theme-toggle__menu,
[data-carbon-theme="g100"] .md-theme-toggle__menu {
    background-color: var(--layer-01);
    border-color: var(--border-subtle);
}

[data-carbon-theme="g90"] .md-theme-toggle__option,
[data-carbon-theme="g100"] .md-theme-toggle__option {
    color: var(--text-primary);
}

[data-carbon-theme="g90"] .md-theme-toggle__option:hover,
[data-carbon-theme="g100"] .md-theme-toggle__option:hover {
    background-color: var(--layer-02);
}


/* ============================================================================
   Responsive Design
   ============================================================================ */

/* Tablet (768px - 1279px) - Hide TOC sidebar */
@media (max-width: 1279px) {
    :root {
        --content-max-width: 100%;
    }

    .md-sidebar--secondary {
        display: none;
    }

    .md-content__inner {
        max-width: 800px;
    }
}

/* Medium screens (768px - 1023px) - Hide primary nav, show mobile menu */
@media (max-width: 1023px) {
    .md-sidebar--primary {
        display: none;
        position: fixed;
        top: var(--header-height);
        left: 0;
        width: auto;
        max-width: 300px;
        height: calc(100vh - var(--header-height));
        max-height: calc(100vh - var(--header-height));
        background-color: var(--layer-01);
        z-index: 9000;
        box-shadow: 2px 0 8px rgba(0, 0, 0, 0.1);
        border-right: none;
    }

    .md-sidebar--primary.active {
        display: block;
    }

    /* Ensure content takes full available width */
    .md-content {
        width: 100%;
        max-width: 100%;
    }
}

/* Mobile (<768px) */
@media (max-width: 767px) {
    .md-sidebar--primary {
        position: fixed;
        top: var(--header-height);
        left: -100%;
        width: auto;
        max-width: 300px;
        height: calc(100vh - var(--header-height));
        background-color: var(--layer-01);
        z-index: 9000;
        transition: left var(--transition-medium);
        box-shadow: 2px 0 8px rgba(0, 0, 0, 0.1);
    }

    .md-sidebar--primary.active {
        left: 0;
    }

    .md-content__inner {
        padding: var(--spacing-05);
    }

    .md-breadcrumbs {
        font-size: 0.875rem;
    }

    .rst-content h1 {
        font-size: 2rem;
    }

    .rst-content h2 {
        font-size: 1.5rem;
    }

    .rst-content h3 {
        font-size: 1.25rem;
    }

    .md-footer-nav__inner {
        flex-direction: column;
    }

    .md-footer-nav__link {
        max-width: 100%;
    }

    .md-footer-nav__link--next {
        align-items: flex-start;
        text-align: left;
    }
}

/* Small mobile (<480px) */
@media (max-width: 479px) {
    .rst-content h1 {
        font-size: 1.75rem;
    }

    .rst-content h2 {
        font-size: 1.375rem;
    }

    .md-content__inner {
        padding: var(--spacing-03);
    }
}

/* ============================================================================
   Back to Top Button
   ============================================================================ */
.md-back-to-top {
    position: fixed;
    bottom: var(--spacing-06);
    right: var(--spacing-06);
    width: 48px;
    height: 48px;
    border-radius: 50%;
    background-color: var(--link-color);
    color: #ffffff;
    border: none;
    cursor: pointer;
    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
    opacity: 0;
    visibility: hidden;
    transform: translateY(20px);
    transition: all var(--transition-medium);
    z-index: 9999;
    display: flex;
    align-items: center;
    justify-content: center;
}

.md-back-to-top svg {
    width: 24px;
    height: 24px;
    fill: currentColor;
}

.md-back-to-top.visible {
    opacity: 1;
    visibility: visible;
    transform: translateY(0);
}

.md-back-to-top:hover {
    background-color: var(--link-hover-color);
    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
}

.md-back-to-top:active {
    transform: scale(0.95);
}

/* ============================================================================
   Copy to Clipboard Button
   ============================================================================ */
.md-code-copy {
    position: absolute;
    top: var(--spacing-03);
    right: var(--spacing-03);
    width: 32px;
    height: 32px;
    padding: 0;
    border: none;
    background-color: rgba(255, 255, 255, 0.9);
    border-radius: 4px;
    cursor: pointer;
    opacity: 0;
    transition: all var(--transition-fast);
    display: flex;
    align-items: center;
    justify-content: center;
    z-index: 10;
}

/* Dark theme copy button */
[data-carbon-theme="g90"] .md-code-copy,
[data-carbon-theme="g100"] .md-code-copy {
    background-color: rgba(57, 57, 57, 0.9);
}

[data-carbon-theme="g90"] .md-code-copy:hover,
[data-carbon-theme="g100"] .md-code-copy:hover {
    background-color: rgba(82, 82, 82, 1);
}

.md-code-copy svg {
    width: 18px;
    height: 18px;
    fill: var(--text-secondary);
}

.rst-content pre:hover .md-code-copy {
    opacity: 1;
}

.md-code-copy:hover {
    background-color: #ffffff;
    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
}

.md-code-copy:hover svg {
    fill: var(--link-color);
}

.md-code-copy.copied {
    background-color: #24a148;
}

.md-code-copy.copied svg {
    fill: #ffffff;
}

/* ============================================================================
   Enhanced Admonitions with Icons
   ============================================================================ */
.rst-content .admonition-title::before,
.rst-content .note .admonition-title::before,
.rst-content .tip .admonition-title::before,
.rst-content .important .admonition-title::before,
.rst-content .warning .admonition-title::before,
.rst-content .caution .admonition-title::before,
.rst-content .danger .admonition-title::before,
.rst-content .error .admonition-title::before,
.rst-content .bug .admonition-title::before {
    content: '';
    display: inline-block;
    width: 20px;
    height: 20px;
    margin-right: var(--spacing-03);
    vertical-align: text-bottom;
    background-size: contain;
    background-repeat: no-repeat;
    background-position: center;
}

/* Note / Info - Blue icons (light themes) - Default for generic .admonition */
.rst-content .admonition .admonition-title::before,
.rst-content .note .admonition-title::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%230f62fe'%3E%3Cpath d='M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1 15h-2v-6h2v6zm0-8h-2V7h2v2z'/%3E%3C/svg%3E");
}

/* Note / Info - Blue icons (dark themes) */
[data-carbon-theme="g90"] .rst-content .admonition .admonition-title::before,
[data-carbon-theme="g90"] .rst-content .note .admonition-title::before,
[data-carbon-theme="g100"] .rst-content .admonition .admonition-title::before,
[data-carbon-theme="g100"] .rst-content .note .admonition-title::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2378a9ff'%3E%3Cpath d='M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1 15h-2v-6h2v6zm0-8h-2V7h2v2z'/%3E%3C/svg%3E");
}

/* Tip / Important - Green icons (light themes) */
.rst-content .tip .admonition-title::before,
.rst-content .important .admonition-title::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2324a148'%3E%3Cpath d='M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z'/%3E%3C/svg%3E");
}

/* Tip / Important - Green icons (dark themes) */
[data-carbon-theme="g90"] .rst-content .tip .admonition-title::before,
[data-carbon-theme="g90"] .rst-content .important .admonition-title::before,
[data-carbon-theme="g100"] .rst-content .tip .admonition-title::before,
[data-carbon-theme="g100"] .rst-content .important .admonition-title::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2342be65'%3E%3Cpath d='M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z'/%3E%3C/svg%3E");
}

/* Warning / Caution - Orange icons (all themes) - Must come after generic .admonition */
.rst-content .admonition.warning .admonition-title::before,
.rst-content .warning .admonition-title::before,
.rst-content .admonition.caution .admonition-title::before,
.rst-content .caution .admonition-title::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%23ff832b'%3E%3Cpath d='M1 21h22L12 2 1 21zm12-3h-2v-2h2v2zm0-4h-2v-4h2v4z'/%3E%3C/svg%3E") !important;
}

/* Danger / Error - Red icons (light themes) - Must come after generic .admonition */
.rst-content .admonition.danger .admonition-title::before,
.rst-content .danger .admonition-title::before,
.rst-content .admonition.error .admonition-title::before,
.rst-content .error .admonition-title::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%23da1e28'%3E%3Cpath d='M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1 15h-2v-2h2v2zm0-4h-2V7h2v6z'/%3E%3C/svg%3E") !important;
}

/* Danger / Error - Red icons (dark themes) */
[data-carbon-theme="g90"] .rst-content .admonition.danger .admonition-title::before,
[data-carbon-theme="g90"] .rst-content .danger .admonition-title::before,
[data-carbon-theme="g90"] .rst-content .admonition.error .admonition-title::before,
[data-carbon-theme="g90"] .rst-content .error .admonition-title::before,
[data-carbon-theme="g100"] .rst-content .admonition.danger .admonition-title::before,
[data-carbon-theme="g100"] .rst-content .danger .admonition-title::before,
[data-carbon-theme="g100"] .rst-content .admonition.error .admonition-title::before,
[data-carbon-theme="g100"] .rst-content .error .admonition-title::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%23fa4d56'%3E%3Cpath d='M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1 15h-2v-2h2v2zm0-4h-2V7h2v6z'/%3E%3C/svg%3E") !important;
}

/* Bug - Blue icons (light themes) - Must come after generic .admonition */
.rst-content .admonition.bug .admonition-title::before,
.rst-content .bug .admonition-title::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%230f62fe'%3E%3Cpath d='M20 8h-2.81c-.45-.78-1.07-1.45-1.82-1.96L17 4.41 15.59 3l-2.17 2.17C12.96 5.06 12.49 5 12 5c-.49 0-.96.06-1.41.17L8.41 3 7 4.41l1.62 1.63C7.88 6.55 7.26 7.22 6.81 8H4v2h2.09c-.05.33-.09.66-.09 1v1H4v2h2v1c0 .34.04.67.09 1H4v2h2.81c1.04 1.79 2.97 3 5.19 3s4.15-1.21 5.19-3H20v-2h-2.09c.05-.33.09-.66.09-1v-1h2v-2h-2v-1c0-.34-.04-.67-.09-1H20V8zm-6 8h-4v-2h4v2zm0-4h-4v-2h4v2z'/%3E%3C/svg%3E") !important;
}

/* Bug - Blue icons (dark themes) */
[data-carbon-theme="g90"] .rst-content .admonition.bug .admonition-title::before,
[data-carbon-theme="g90"] .rst-content .bug .admonition-title::before,
[data-carbon-theme="g100"] .rst-content .admonition.bug .admonition-title::before,
[data-carbon-theme="g100"] .rst-content .bug .admonition-title::before {
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='%2378a9ff'%3E%3Cpath d='M20 8h-2.81c-.45-.78-1.07-1.45-1.82-1.96L17 4.41 15.59 3l-2.17 2.17C12.96 5.06 12.49 5 12 5c-.49 0-.96.06-1.41.17L8.41 3 7 4.41l1.62 1.63C7.88 6.55 7.26 7.22 6.81 8H4v2h2.09c-.05.33-.09.66-.09 1v1H4v2h2v1c0 .34.04.67.09 1H4v2h2.81c1.04 1.79 2.97 3 5.19 3s4.15-1.21 5.19-3H20v-2h-2.09c.05-.33.09-.66.09-1v-1h2v-2h-2v-1c0-.34-.04-.67-.09-1H20V8zm-6 8h-4v-2h4v2zm0-4h-4v-2h4v2z'/%3E%3C/svg%3E") !important;
}

/* ============================================================================
   Animation Preferences
   ============================================================================ */
@media (prefers-reduced-motion: reduce) {
    *,
    *::before,
    *::after {
        animation-duration: 0.01ms !important;
        animation-iteration-count: 1 !important;
        transition-duration: 0.01ms !important;
        scroll-behavior: auto !important;
    }

    .md-back-to-top {
        transition: opacity 0.01ms, visibility 0.01ms;
    }
}

/* ============================================================================
   Dark Mode Support (for future implementation)
   ============================================================================ */
@media (prefers-color-scheme: dark) {
    /* Dark mode styles can be added here in future updates */
    /* Currently respecting Carbon theme zones (g90, g100) */
}

/* ============================================================================
   Print Styles
   ============================================================================ */
@media print {
    .md-header,
    .md-sidebar--primary,
    .md-sidebar--secondary,
    .md-footer-nav,
    .md-footer,
    .md-back-to-top,
    .md-code-copy {
        display: none !important;
    }

    .md-container {
        margin-top: 0;
    }

    .md-content__inner {
        max-width: 100%;
        padding: 0;
    }

    a {
        text-decoration: underline;
    }

    a[href]:after {
        content: " (" attr(href) ")";
        font-size: 0.8em;
    }

    .rst-content pre {
        border: 1px solid #000;
        page-break-inside: avoid;
    }
}

/* Made with Bob */