/* HIDDEN CRUCIALS - PERFECTED DESIGN SYSTEM */
/* Swiss Precision meets Digital Perfection */
/* ===== CUSTOM FONTS ===== */
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800;900&family=JetBrains+Mono:ital,wght@0,300;0,400;0,500;0,600;1,400&family=Playfair+Display:ital,wght@0,400;0,500;0,600;0,700;0,800;1,400;1,500&display=swap');
/* ===== CSS RESET & BASE ===== */
*,
*::before,
*::after {
box-sizing: border-box;
margin: 0;
padding: 0;
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
}
/* ===== ROOT VARIABLES ===== */
:root {
/* PREMIUM COLOR PALETTE */
--stone-50: #fafaf9;
--stone-75: #f7f7f6;
--stone-100: #f5f5f4;
--stone-150: #f0f0ef;
--stone-200: #e7e5e4;
--stone-250: #ddd9d7;
--stone-300: #d6d3d1;
--stone-350: #cac6c3;
--stone-400: #a8a29e;
--stone-450: #9c948f;
--stone-500: #78716c;
--stone-550: #6b635e;
--stone-600: #57534e;
--stone-650: #4d4944;
--stone-700: #44403c;
--stone-750: #3a3530;
--stone-800: #292524;
--stone-850: #1f1e1d;
--stone-900: #1c1917;
--stone-950: #0c0a09;
/* ACCENT COLORS */
--indigo-50: #eef2ff;
--indigo-100: #e0e7ff;
--indigo-200: #c7d2fe;
--indigo-300: #a5b4fc;
--indigo-400: #818cf8;
--indigo-500: #6366f1;
--indigo-600: #4f46e5;
--indigo-700: #4338ca;
--indigo-800: #3730a3;
--indigo-900: #312e81;
/* SEMANTIC COLORS */
--text-primary: var(--stone-900);
--text-secondary: var(--stone-650);
--text-muted: var(--stone-500);
--text-subtle: var(--stone-400);
--border-default: var(--stone-200);
--border-subtle: var(--stone-150);
--border-muted: var(--stone-100);
--surface-primary: #ffffff;
--surface-secondary: var(--stone-50);
--surface-tertiary: var(--stone-100);
--surface-elevated: var(--stone-75);
--accent-primary: var(--indigo-600);
--accent-secondary: var(--indigo-500);
--accent-subtle: var(--indigo-50);
--accent-muted: var(--indigo-100);
/* TYPOGRAPHY SYSTEM */
--font-display: 'Playfair Display', 'Times New Roman', serif;
--font-body: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
--font-mono: 'JetBrains Mono', 'SF Mono', 'Monaco', 'Cascadia Code', monospace;
/* PRECISE TYPOGRAPHY SCALE */
--text-2xs: 0.625rem; /* 10px */
--text-xs: 0.75rem; /* 12px */
--text-sm: 0.875rem; /* 14px */
--text-base: 1rem; /* 16px */
--text-lg: 1.125rem; /* 18px */
--text-xl: 1.25rem; /* 20px */
--text-2xl: 1.5rem; /* 24px */
--text-3xl: 1.875rem; /* 30px */
--text-4xl: 2.25rem; /* 36px */
--text-5xl: 3rem; /* 48px */
--text-6xl: 3.75rem; /* 60px */
--text-7xl: 4.5rem; /* 72px */
/* LINE HEIGHTS */
--leading-none: 1;
--leading-tight: 1.25;
--leading-snug: 1.375;
--leading-normal: 1.5;
--leading-relaxed: 1.625;
--leading-loose: 2;
/* LETTER SPACING */
--tracking-tighter: -0.05em;
--tracking-tight: -0.025em;
--tracking-normal: 0em;
--tracking-wide: 0.025em;
--tracking-wider: 0.05em;
--tracking-widest: 0.1em;
/* MATHEMATICAL SPACING SYSTEM (Golden Ratio) */
--space-px: 1px;
--space-0: 0rem;
--space-0-5: 0.125rem; /* 2px */
--space-1: 0.25rem; /* 4px */
--space-1-5: 0.375rem; /* 6px */
--space-2: 0.5rem; /* 8px */
--space-2-5: 0.625rem; /* 10px */
--space-3: 0.75rem; /* 12px */
--space-3-5: 0.875rem; /* 14px */
--space-4: 1rem; /* 16px */
--space-5: 1.25rem; /* 20px */
--space-6: 1.5rem; /* 24px */
--space-7: 1.75rem; /* 28px */
--space-8: 2rem; /* 32px */
--space-9: 2.25rem; /* 36px */
--space-10: 2.5rem; /* 40px */
--space-11: 2.75rem; /* 44px */
--space-12: 3rem; /* 48px */
--space-14: 3.5rem; /* 56px */
--space-16: 4rem; /* 64px */
--space-20: 5rem; /* 80px */
--space-24: 6rem; /* 96px */
--space-28: 7rem; /* 112px */
--space-32: 8rem; /* 128px */
--space-36: 9rem; /* 144px */
--space-40: 10rem; /* 160px */
--space-44: 11rem; /* 176px */
--space-48: 12rem; /* 192px */
--space-52: 13rem; /* 208px */
--space-56: 14rem; /* 224px */
--space-60: 15rem; /* 240px */
--space-64: 16rem; /* 256px */
--space-72: 18rem; /* 288px */
--space-80: 20rem; /* 320px */
--space-96: 24rem; /* 384px */
/* LAYOUT DIMENSIONS */
--sidebar-width: 280px;
--toc-width: 240px;
--header-height: 72px;
--content-max-width: 768px;
--page-max-width: 1400px;
--reading-width: 680px;
/* BORDER RADIUS */
--radius-none: 0px;
--radius-sm: 0.125rem;
--radius-base: 0.25rem;
--radius-md: 0.375rem;
--radius-lg: 0.5rem;
--radius-xl: 0.75rem;
--radius-2xl: 1rem;
--radius-3xl: 1.5rem;
--radius-full: 9999px;
/* SHADOWS */
--shadow-xs: 0 1px 2px 0 rgb(0 0 0 / 0.05);
--shadow-sm: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
--shadow-base: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
--shadow-md: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
--shadow-lg: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);
--shadow-xl: 0 25px 50px -12px rgb(0 0 0 / 0.25);
--shadow-2xl: 0 50px 100px -20px rgb(0 0 0 / 0.25);
--shadow-inner: inset 0 2px 4px 0 rgb(0 0 0 / 0.05);
/* TRANSITIONS */
--duration-75: 75ms;
--duration-100: 100ms;
--duration-150: 150ms;
--duration-200: 200ms;
--duration-300: 300ms;
--duration-500: 500ms;
--duration-700: 700ms;
--duration-1000: 1000ms;
--ease-linear: linear;
--ease-in: cubic-bezier(0.4, 0, 1, 1);
--ease-out: cubic-bezier(0, 0, 0.2, 1);
--ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
/* Z-INDEX SCALE */
--z-0: 0;
--z-10: 10;
--z-20: 20;
--z-30: 30;
--z-40: 40;
--z-50: 50;
--z-auto: auto;
}
/* ===== DARK THEME ===== */
[data-theme="dark"] {
--text-primary: var(--stone-100);
--text-secondary: var(--stone-350);
--text-muted: var(--stone-450);
--text-subtle: var(--stone-500);
--border-default: var(--stone-700);
--border-subtle: var(--stone-750);
--border-muted: var(--stone-800);
--surface-primary: var(--stone-900);
--surface-secondary: var(--stone-850);
--surface-tertiary: var(--stone-800);
--surface-elevated: var(--stone-750);
--accent-primary: var(--indigo-400);
--accent-secondary: var(--indigo-300);
--accent-subtle: var(--indigo-900);
--accent-muted: var(--indigo-800);
}
/* ===== READING THEME ===== */
[data-theme="reading"] {
--stone-50: #fffef7;
--stone-100: #fefce8;
--stone-200: #fef3c7;
--stone-300: #fde68a;
--text-primary: #451a03;
--text-secondary: #78350f;
--text-muted: #92400e;
--surface-primary: #fffef7;
--surface-secondary: #fefce8;
--accent-primary: #d97706;
--accent-secondary: #f59e0b;
--accent-subtle: #fef3c7;
}
/* ===== BASE STYLES ===== */
html {
font-size: 16px;
line-height: var(--leading-normal);
scroll-behavior: smooth;
text-rendering: optimizeLegibility;
-webkit-text-size-adjust: 100%;
-moz-text-size-adjust: 100%;
text-size-adjust: 100%;
}
body {
font-family: var(--font-body);
font-size: var(--text-base);
font-weight: 400;
line-height: var(--leading-relaxed);
color: var(--text-primary);
background-color: var(--surface-primary);
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
text-rendering: optimizeLegibility;
font-feature-settings: "kern" 1, "liga" 1, "calt" 1, "pnum" 1, "tnum" 0, "onum" 1, "lnum" 0, "dlig" 0;
}
/* ===== CUSTOM SCROLLBARS ===== */
::-webkit-scrollbar {
width: 8px;
height: 8px;
}
::-webkit-scrollbar-track {
background: var(--surface-secondary);
border-radius: var(--radius-full);
}
::-webkit-scrollbar-thumb {
background: var(--border-default);
border-radius: var(--radius-full);
transition: background-color var(--duration-200) var(--ease-out);
}
::-webkit-scrollbar-thumb:hover {
background: var(--accent-primary);
}
/* Firefox scrollbars */
* {
scrollbar-width: thin;
scrollbar-color: var(--border-default) var(--surface-secondary);
}
/* ===== CUSTOM CURSOR STYLES ===== */
html {
cursor: default;
}
a,
button,
[role="button"],
input[type="submit"],
input[type="button"],
input[type="checkbox"],
input[type="radio"],
select,
.cursor-pointer {
cursor: pointer;
}
input[type="text"],
input[type="email"],
input[type="password"],
input[type="search"],
textarea,
.cursor-text {
cursor: text;
}
.cursor-not-allowed {
cursor: not-allowed;
}
.cursor-wait {
cursor: wait;
}
.cursor-move {
cursor: move;
}
.cursor-help {
cursor: help;
}
/* ===== SELECTION STYLES ===== */
::selection {
background: var(--accent-subtle);
color: var(--accent-primary);
text-shadow: none;
}
::-moz-selection {
background: var(--accent-subtle);
color: var(--accent-primary);
text-shadow: none;
}
/* ===== FOCUS STYLES ===== */
:focus {
outline: 2px solid var(--accent-primary);
outline-offset: 2px;
}
:focus:not(:focus-visible) {
outline: none;
}
:focus-visible {
outline: 2px solid var(--accent-primary);
outline-offset: 2px;
}
/* ===== HEADER PERFECTION ===== */
.docs-header {
position: sticky;
top: 0;
z-index: var(--z-50);
height: var(--header-height);
background-color: var(--surface-primary);
backdrop-filter: blur(20px) saturate(180%);
-webkit-backdrop-filter: blur(20px) saturate(180%);
border-bottom: 1px solid var(--border-subtle);
transition: all var(--duration-200) var(--ease-out);
}
.docs-header-content {
display: flex;
align-items: center;
justify-content: space-between;
height: 100%;
max-width: var(--page-max-width);
margin: 0 auto;
padding: 0 var(--space-8);
}
/* ===== LOGO PERFECTION ===== */
.docs-logo {
display: flex;
align-items: center;
gap: var(--space-3);
text-decoration: none;
color: var(--text-primary);
transition: all var(--duration-200) var(--ease-out);
}
.docs-logo:hover {
transform: translateY(-1px);
}
.docs-logo-icon {
width: 36px;
height: 36px;
background: linear-gradient(135deg, var(--accent-primary), var(--accent-secondary));
border-radius: var(--radius-xl);
display: flex;
align-items: center;
justify-content: center;
box-shadow: var(--shadow-sm);
transition: all var(--duration-200) var(--ease-out);
}
.docs-logo:hover .docs-logo-icon {
box-shadow: var(--shadow-md);
transform: scale(1.05);
}
.docs-logo-icon svg {
width: 20px;
height: 20px;
color: white;
filter: drop-shadow(0 1px 2px rgb(0 0 0 / 0.1));
}
.docs-logo-text {
font-family: var(--font-display);
font-size: var(--text-xl);
font-weight: 600;
letter-spacing: var(--tracking-tight);
background: linear-gradient(135deg, var(--text-primary), var(--accent-primary));
background-clip: text;
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
font-feature-settings: "kern" 1, "liga" 1, "calt" 1;
}
/* ===== HEADER ACTIONS ===== */
.docs-header-actions {
display: flex;
align-items: center;
gap: var(--space-4);
}
/* ===== SEARCH PERFECTION ===== */
.search-container {
position: relative;
}
.docs-search {
width: 320px;
height: 40px;
padding: var(--space-3) var(--space-4) var(--space-3) var(--space-10);
background-color: var(--surface-secondary);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-xl);
font-family: var(--font-body);
font-size: var(--text-sm);
font-weight: 400;
color: var(--text-primary);
transition: all var(--duration-200) var(--ease-out);
box-shadow: var(--shadow-xs);
}
.docs-search:focus {
outline: none;
border-color: var(--accent-primary);
background-color: var(--surface-primary);
box-shadow: 0 0 0 3px var(--accent-subtle), var(--shadow-sm);
}
.docs-search::placeholder {
color: var(--text-muted);
font-weight: 400;
}
.search-icon {
position: absolute;
left: var(--space-3);
top: 50%;
transform: translateY(-50%);
width: 18px;
height: 18px;
color: var(--text-muted);
pointer-events: none;
}
/* ===== THEME TOGGLE PERFECTION ===== */
.theme-toggle {
display: flex;
align-items: center;
justify-content: center;
width: 40px;
height: 40px;
background: var(--surface-secondary);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-xl);
color: var(--text-secondary);
cursor: pointer;
transition: all var(--duration-200) var(--ease-out);
box-shadow: var(--shadow-xs);
}
.theme-toggle:hover {
background: var(--surface-tertiary);
border-color: var(--border-default);
color: var(--text-primary);
transform: translateY(-1px);
box-shadow: var(--shadow-sm);
}
.theme-toggle:active {
transform: translateY(0);
box-shadow: var(--shadow-xs);
}
/* ===== MOBILE MENU TOGGLE ===== */
.mobile-menu-toggle {
display: none;
align-items: center;
justify-content: center;
width: 40px;
height: 40px;
background: none;
border: none;
border-radius: var(--radius-lg);
color: var(--text-secondary);
cursor: pointer;
transition: all var(--duration-200) var(--ease-out);
}
.mobile-menu-toggle:hover {
background: var(--surface-secondary);
color: var(--text-primary);
}
/* ===== LAYOUT PERFECTION ===== */
.docs-container {
display: grid;
grid-template-columns: var(--sidebar-width) 1fr var(--toc-width);
max-width: var(--page-max-width);
margin: 0 auto;
min-height: calc(100vh - var(--header-height));
gap: 0;
}
/* ===== SIDEBAR PERFECTION ===== */
.docs-sidebar {
background-color: var(--surface-secondary);
border-right: 1px solid var(--border-subtle);
position: sticky;
top: var(--header-height);
height: calc(100vh - var(--header-height));
overflow-y: auto;
overflow-x: hidden;
}
.docs-sidebar-content {
padding: var(--space-8) 0;
}
.nav-section {
margin-bottom: var(--space-8);
padding: 0 var(--space-6);
}
.nav-section-title {
font-size: var(--text-xs);
font-weight: 600;
color: var(--text-muted);
text-transform: uppercase;
letter-spacing: var(--tracking-wider);
margin-bottom: var(--space-4);
}
.nav-section-title a {
color: inherit;
text-decoration: none;
transition: color var(--duration-150) var(--ease-out);
}
.nav-section-title a:hover {
color: var(--accent-primary);
}
.nav-section-items {
list-style: none;
display: flex;
flex-direction: column;
gap: var(--space-1);
}
.nav-link {
display: flex;
align-items: center;
padding: var(--space-2-5) var(--space-3);
color: var(--text-secondary);
text-decoration: none;
font-size: var(--text-sm);
font-weight: 500;
border-radius: var(--radius-lg);
transition: all var(--duration-150) var(--ease-out);
position: relative;
line-height: var(--leading-snug);
}
.nav-link:hover {
background-color: var(--surface-tertiary);
color: var(--text-primary);
transform: translateX(2px);
}
.nav-link.active {
background-color: var(--accent-subtle);
color: var(--accent-primary);
font-weight: 600;
}
.nav-link.active::before {
content: '';
position: absolute;
left: -var(--space-6);
top: 50%;
transform: translateY(-50%);
width: 3px;
height: 20px;
background-color: var(--accent-primary);
border-radius: 0 var(--radius-base) var(--radius-base) 0;
}
/* ===== MAIN CONTENT PERFECTION ===== */
.docs-main {
padding: var(--space-8);
max-width: var(--content-max-width);
margin: 0 auto;
overflow-x: hidden;
}
/* ===== BREADCRUMB PERFECTION ===== */
.breadcrumb {
margin-bottom: var(--space-8);
}
.breadcrumb-list {
display: flex;
align-items: center;
gap: var(--space-2);
list-style: none;
font-size: var(--text-sm);
color: var(--text-muted);
font-weight: 400;
}
.breadcrumb-item {
display: flex;
align-items: center;
}
.breadcrumb-item:not(:last-child)::after {
content: '/';
margin-left: var(--space-2);
color: var(--text-subtle);
font-weight: 300;
}
.breadcrumb-item a {
color: var(--text-muted);
text-decoration: none;
transition: color var(--duration-150) var(--ease-out);
}
.breadcrumb-item a:hover {
color: var(--accent-primary);
}
.breadcrumb-item.active {
color: var(--text-secondary);
font-weight: 500;
}
/* ===== ARTICLE HEADER PERFECTION ===== */
.docs-article-header {
margin-bottom: var(--space-12);
padding-bottom: var(--space-8);
border-bottom: 1px solid var(--border-subtle);
position: relative;
}
.docs-article-title {
font-family: var(--font-display);
font-size: var(--text-4xl);
font-weight: 700;
color: var(--text-primary);
line-height: var(--leading-tight);
margin-bottom: var(--space-4);
letter-spacing: var(--tracking-tight);
font-feature-settings: "kern" 1, "liga" 1, "calt" 1, "dlig" 1;
}
.docs-article-description {
font-size: var(--text-xl);
font-weight: 400;
line-height: var(--leading-relaxed);
color: var(--text-secondary);
max-width: 600px;
margin-bottom: var(--space-6);
}
.docs-article-meta {
display: flex;
align-items: center;
gap: var(--space-4);
font-size: var(--text-sm);
color: var(--text-muted);
}
.docs-article-meta time {
font-weight: 500;
}
/* ===== CONTENT TYPOGRAPHY PERFECTION ===== */
.docs-content {
max-width: var(--reading-width);
line-height: var(--leading-relaxed);
font-feature-settings: "kern" 1, "liga" 1, "calt" 1, "pnum" 1, "tnum" 0, "onum" 1, "lnum" 0;
}
.docs-content > * + * {
margin-top: var(--space-6);
}
.docs-content h1,
.docs-content h2,
.docs-content h3,
.docs-content h4,
.docs-content h5,
.docs-content h6 {
font-family: var(--font-display);
color: var(--text-primary);
font-weight: 700;
line-height: var(--leading-tight);
letter-spacing: var(--tracking-tight);
scroll-margin-top: calc(var(--header-height) + var(--space-4));
font-feature-settings: "kern" 1, "liga" 1, "calt" 1, "dlig" 1;
}
.docs-content h1 {
font-size: var(--text-4xl);
margin-top: var(--space-16);
margin-bottom: var(--space-8);
}
.docs-content h2 {
font-size: var(--text-3xl);
margin-top: var(--space-12);
margin-bottom: var(--space-6);
padding-bottom: var(--space-3);
border-bottom: 1px solid var(--border-subtle);
}
.docs-content h3 {
font-size: var(--text-2xl);
color: var(--accent-primary);
margin-top: var(--space-10);
margin-bottom: var(--space-4);
}
.docs-content h4 {
font-size: var(--text-xl);
margin-top: var(--space-8);
margin-bottom: var(--space-3);
}
.docs-content h5,
.docs-content h6 {
font-size: var(--text-lg);
margin-top: var(--space-6);
margin-bottom: var(--space-3);
}
.docs-content h1:first-child,
.docs-content h2:first-child,
.docs-content h3:first-child {
margin-top: 0;
}
.docs-content p {
font-size: var(--text-base);
line-height: var(--leading-relaxed);
color: var(--text-secondary);
max-width: 100%;
margin: var(--space-6) 0;
}
.docs-content p:first-child {
font-size: var(--text-lg);
font-weight: 500;
color: var(--text-primary);
}
.docs-content strong {
color: var(--text-primary);
font-weight: 600;
}
.docs-content em {
font-style: italic;
color: var(--text-primary);
}
.docs-content a {
color: var(--accent-primary);
text-decoration: none;
font-weight: 500;
border-bottom: 1px solid transparent;
transition: all var(--duration-150) var(--ease-out);
}
.docs-content a:hover {
color: var(--accent-secondary);
border-bottom-color: var(--accent-secondary);
}
/* ===== LISTS PERFECTION ===== */
.docs-content ul,
.docs-content ol {
margin: var(--space-6) 0;
padding-left: var(--space-6);
}
.docs-content li {
margin-bottom: var(--space-2);
color: var(--text-secondary);
line-height: var(--leading-relaxed);
}
.docs-content li > ul,
.docs-content li > ol {
margin: var(--space-3) 0;
}
.docs-content li::marker {
color: var(--accent-primary);
font-weight: 600;
}
/* ===== CODE PERFECTION ===== */
.docs-content code {
font-family: var(--font-mono);
font-size: 0.9em;
font-weight: 500;
color: var(--accent-primary);
background-color: var(--surface-secondary);
padding: var(--space-1) var(--space-2);
border-radius: var(--radius-base);
border: 1px solid var(--border-subtle);
font-feature-settings: "calt" 1, "liga" 1;
}
.docs-content pre {
background-color: var(--surface-secondary);
border: 1px solid var(--border-default);
border-radius: var(--radius-xl);
padding: var(--space-6);
margin: var(--space-8) 0;
overflow-x: auto;
font-size: var(--text-sm);
line-height: var(--leading-relaxed);
box-shadow: var(--shadow-xs);
}
.docs-content pre code {
background: none;
border: none;
padding: 0;
color: var(--text-primary);
font-size: inherit;
font-weight: 400;
}
/* ===== BLOCKQUOTES PERFECTION ===== */
.docs-content blockquote {
margin: var(--space-8) 0;
padding: var(--space-6) var(--space-8);
background-color: var(--surface-secondary);
border-left: 4px solid var(--accent-primary);
border-radius: 0 var(--radius-xl) var(--radius-xl) 0;
font-style: italic;
font-size: var(--text-lg);
color: var(--text-secondary);
position: relative;
box-shadow: var(--shadow-xs);
}
.docs-content blockquote p:last-child {
margin-bottom: 0;
}
.docs-content blockquote::before {
content: '"';
position: absolute;
left: var(--space-4);
top: var(--space-2);
font-size: var(--text-4xl);
color: var(--accent-primary);
font-family: var(--font-display);
line-height: 1;
opacity: 0.3;
}
/* ===== TABLE PERFECTION ===== */
.docs-content table {
width: 100%;
border-collapse: separate;
border-spacing: 0;
margin: var(--space-8) 0;
border: 1px solid var(--border-default);
border-radius: var(--radius-xl);
overflow: hidden;
box-shadow: var(--shadow-xs);
font-size: var(--text-sm);
}
.docs-content th,
.docs-content td {
padding: var(--space-3) var(--space-4);
text-align: left;
border-bottom: 1px solid var(--border-subtle);
line-height: var(--leading-snug);
}
.docs-content th {
background-color: var(--surface-secondary);
font-weight: 600;
font-size: var(--text-xs);
color: var(--text-primary);
text-transform: uppercase;
letter-spacing: var(--tracking-wide);
}
.docs-content td {
color: var(--text-secondary);
}
.docs-content tr:last-child td {
border-bottom: none;
}
/* ===== TABLE OF CONTENTS PERFECTION ===== */
.docs-toc {
padding: var(--space-8) var(--space-6);
position: sticky;
top: var(--header-height);
height: calc(100vh - var(--header-height));
overflow-y: auto;
border-left: 1px solid var(--border-subtle);
}
.docs-toc-title {
font-size: var(--text-xs);
font-weight: 600;
color: var(--text-muted);
text-transform: uppercase;
letter-spacing: var(--tracking-wider);
margin-bottom: var(--space-4);
}
.toc-list {
list-style: none;
display: flex;
flex-direction: column;
gap: var(--space-1);
}
.toc-link {
display: block;
padding: var(--space-2) var(--space-3);
font-size: var(--text-sm);
font-weight: 400;
color: var(--text-secondary);
text-decoration: none;
border-radius: var(--radius-lg);
transition: all var(--duration-150) var(--ease-out);
line-height: var(--leading-snug);
border-left: 2px solid transparent;
}
.toc-link:hover {
background-color: var(--surface-secondary);
color: var(--text-primary);
}
.toc-link.active {
background-color: var(--accent-subtle);
color: var(--accent-primary);
font-weight: 500;
border-left-color: var(--accent-primary);
}
.toc-level-3 .toc-link {
padding-left: var(--space-6);
font-size: var(--text-xs);
}
.toc-level-4 .toc-link {
padding-left: var(--space-8);
font-size: var(--text-xs);
}
/* ===== ADVANCED MARKDOWN FEATURES ===== */
.text-left {
text-align: left;
}
.text-center {
text-align: center;
}
.text-right {
text-align: right;
}
.callout {
padding: var(--space-5);
margin: var(--space-8) 0;
border-radius: var(--radius-xl);
border-left: 4px solid var(--border-default);
background-color: var(--surface-secondary);
box-shadow: var(--shadow-xs);
position: relative;
}
.callout strong:first-child {
display: block;
font-weight: 600;
margin-bottom: var(--space-2);
color: inherit;
}
.callout-info {
border-left-color: var(--indigo-500);
background-color: var(--indigo-50);
color: var(--indigo-900);
}
.callout-warning {
border-left-color: #f59e0b;
background-color: #fef3c7;
color: #92400e;
}
.callout-success {
border-left-color: #10b981;
background-color: #d1fae5;
color: #047857;
}
.callout-error {
border-left-color: #ef4444;
background-color: #fef2f2;
color: #dc2626;
}
[data-theme="dark"] .callout-info {
background-color: var(--indigo-900);
color: var(--indigo-100);
}
[data-theme="dark"] .callout-warning {
background-color: #92400e;
color: #fcd34d;
}
[data-theme="dark"] .callout-success {
background-color: #064e3b;
color: #a7f3d0;
}
[data-theme="dark"] .callout-error {
background-color: #7f1d1d;
color: #fca5a5;
}
.image-container {
margin: var(--space-8) 0;
text-align: center;
}
.image-container img {
max-width: 100%;
height: auto;
border-radius: var(--radius-xl);
box-shadow: var(--shadow-md);
transition: transform var(--duration-300) var(--ease-out);
}
.image-container img:hover {
transform: scale(1.02);
}
.image-container + em {
display: block;
font-style: italic;
color: var(--text-muted);
font-size: var(--text-sm);
margin-top: var(--space-3);
text-align: center;
}
.image-center {
text-align: center;
margin: var(--space-8) 0;
}
.image-center img {
max-width: 300px;
height: auto;
border-radius: var(--radius-xl);
box-shadow: var(--shadow-sm);
}
.video-container {
position: relative;
padding-bottom: 56.25%;
height: 0;
margin: var(--space-8) 0;
border-radius: var(--radius-xl);
overflow: hidden;
box-shadow: var(--shadow-md);
}
.video-container iframe {
position: absolute;
top: 0;
left: 0;
width: 100%;
height: 100%;
border: none;
}
.quote-highlight {
border-left: 4px solid var(--accent-primary);
background: linear-gradient(90deg, var(--accent-subtle), transparent);
padding: var(--space-6);
margin: var(--space-8) 0;
border-radius: 0 var(--radius-xl) var(--radius-xl) 0;
font-size: var(--text-lg);
font-style: italic;
color: var(--text-primary);
box-shadow: var(--shadow-xs);
}
/* ===== FOOTER PERFECTION ===== */
.docs-footer {
background-color: var(--surface-secondary);
border-top: 1px solid var(--border-subtle);
margin-top: var(--space-20);
padding: var(--space-16) 0;
}
.docs-footer-content {
max-width: var(--page-max-width);
margin: 0 auto;
padding: 0 var(--space-8);
display: grid;
grid-template-columns: 1fr auto;
gap: var(--space-16);
align-items: start;
}
.docs-footer-info {
display: flex;
flex-direction: column;
gap: var(--space-4);
}
.docs-footer-logo {
display: flex;
align-items: center;
gap: var(--space-3);
margin-bottom: var(--space-2);
}
.docs-footer-title {
font-family: var(--font-display);
font-weight: 600;
color: var(--text-primary);
font-size: var(--text-lg);
}
.docs-footer-description {
color: var(--text-secondary);
line-height: var(--leading-relaxed);
max-width: 400px;
margin: 0;
font-size: var(--text-base);
}
.docs-footer-credits {
text-align: right;
display: flex;
flex-direction: column;
gap: var(--space-2);
}
.docs-footer-credit {
font-size: var(--text-sm);
color: var(--text-muted);
margin: 0;
line-height: var(--leading-relaxed);
}
.docs-footer-credit a {
color: var(--accent-primary);
text-decoration: none;
font-weight: 500;
transition: color var(--duration-150) var(--ease-out);
}
.docs-footer-credit a:hover {
color: var(--accent-secondary);
}
.docs-footer-copyright {
font-size: var(--text-sm);
color: var(--text-muted);
font-weight: 500;
margin: var(--space-4) 0 0 0;
}
/* ===== RESPONSIVE DESIGN PERFECTION ===== */
@media (max-width: 1200px) {
.docs-container {
grid-template-columns: var(--sidebar-width) 1fr;
}
.docs-toc {
display: none;
}
}
@media (max-width: 768px) {
.mobile-menu-toggle {
display: flex;
}
.docs-header-content {
padding: 0 var(--space-4);
}
.docs-search {
width: 240px;
}
.docs-container {
grid-template-columns: 1fr;
}
.docs-sidebar {
position: fixed;
top: var(--header-height);
left: -100%;
width: var(--sidebar-width);
z-index: var(--z-40);
transition: left var(--duration-300) var(--ease-out);
box-shadow: var(--shadow-xl);
}
.docs-sidebar.open {
left: 0;
}
.docs-main {
padding: var(--space-6) var(--space-4);
}
.docs-article-title {
font-size: var(--text-3xl);
}
.docs-article-description {
font-size: var(--text-lg);
}
.docs-footer-content {
grid-template-columns: 1fr;
gap: var(--space-8);
text-align: left;
}
.docs-footer-credits {
text-align: left;
}
}
@media (max-width: 480px) {
.docs-search {
display: none;
}
.docs-header-actions {
gap: var(--space-2);
}
.docs-main {
padding: var(--space-4) var(--space-3);
}
.docs-article-title {
font-size: var(--text-2xl);
}
.docs-article-description {
font-size: var(--text-base);
}
.callout {
padding: var(--space-4);
margin: var(--space-6) 0;
}
}
/* ===== PRINT STYLES ===== */
@media print {
.docs-header,
.docs-sidebar,
.docs-toc,
.docs-footer {
display: none !important;
}
.docs-container {
grid-template-columns: 1fr !important;
}
.docs-main {
padding: 0 !important;
max-width: none !important;
}
.docs-content {
max-width: none !important;
}
* {
color: black !important;
background: white !important;
}
}
/* ===== ACCESSIBILITY IMPROVEMENTS ===== */
@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;
}
}
@media (prefers-color-scheme: dark) {
:root:not([data-theme]) {
--text-primary: var(--stone-100);
--text-secondary: var(--stone-350);
--text-muted: var(--stone-450);
--text-subtle: var(--stone-500);
--border-default: var(--stone-700);
--border-subtle: var(--stone-750);
--border-muted: var(--stone-800);
--surface-primary: var(--stone-900);
--surface-secondary: var(--stone-850);
--surface-tertiary: var(--stone-800);
--surface-elevated: var(--stone-750);
--accent-primary: var(--indigo-400);
--accent-secondary: var(--indigo-300);
--accent-subtle: var(--indigo-900);
--accent-muted: var(--indigo-800);
}
}
/* High contrast mode support */
@media (prefers-contrast: high) {
:root {
--border-default: var(--stone-400);
--border-subtle: var(--stone-300);
--text-muted: var(--stone-600);
}
}
/* ===== PERFORMANCE OPTIMIZATIONS ===== */
.docs-content img,
.image-container img,
.image-center img {
content-visibility: auto;
contain-intrinsic-size: 300px;
}
.docs-sidebar,
.docs-toc {
contain: layout style paint;
}
/* ===== FINAL TOUCHES ===== */
/* Smooth scrolling for anchor links */
html {
scroll-padding-top: calc(var(--header-height) + var(--space-4));
}
/* Better text selection */
.docs-logo-text,
.docs-article-title {
user-select: none;
-webkit-user-select: none;
-moz-user-select: none;
-ms-user-select: none;
}
/* Prevent layout shift during font loading */
.docs-logo-text,
.docs-article-title,
.docs-content h1,
.docs-content h2,
.docs-content h3,
.docs-content h4,
.docs-content h5,
.docs-content h6 {
font-display: swap;
}
/* Optimize rendering */
.docs-header {
will-change: backdrop-filter;
}
.docs-logo:hover .docs-logo-icon,
.theme-toggle:hover,
.nav-link:hover {
will-change: transform;
}