/* ============================================================
   Microsoft Agentic Harness — Developer Onboarding Guide
   Design system: Stripe/Linear-inspired docs aesthetic
   ============================================================ */

/* ---------- Reset & base ---------- */
*,
*::before,
*::after {
    box-sizing: border-box;
}

html {
    -webkit-text-size-adjust: 100%;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
    text-rendering: optimizeLegibility;
    scroll-behavior: smooth;
}

body {
    margin: 0;
    font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, 'Helvetica Neue', sans-serif;
    font-size: 16px;
    line-height: 1.6;
    color: var(--color-text);
    background: var(--color-bg);
}

/* ---------- Design tokens ---------- */
:root {
    /* Color palette */
    --color-bg: #ffffff;
    --color-bg-subtle: #fafafa;
    --color-bg-muted: #f5f5f7;
    --color-bg-code: #f6f8fa;
    --color-bg-code-inline: #f1f3f5;
    --color-text: #0a0a0a;
    --color-text-muted: #525866;
    --color-text-subtle: #6b7280;
    --color-text-inverse: #ffffff;
    --color-border: #e5e7eb;
    --color-border-strong: #d1d5db;
    --color-accent: #2563eb;
    --color-accent-hover: #1d4ed8;
    --color-accent-subtle: #eff6ff;
    --color-success: #059669;
    --color-success-subtle: #ecfdf5;
    --color-warning: #d97706;
    --color-warning-subtle: #fffbeb;
    --color-danger: #dc2626;
    --color-danger-subtle: #fef2f2;
    --color-info: #0891b2;
    --color-info-subtle: #ecfeff;

    /* Sidebar */
    --sidebar-width: 280px;
    --sidebar-bg: #fbfbfc;
    --toc-width: 240px;

    /* Type */
    --font-mono: 'JetBrains Mono', 'SF Mono', Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace;

    /* Spacing scale */
    --space-1: 4px;
    --space-2: 8px;
    --space-3: 12px;
    --space-4: 16px;
    --space-5: 20px;
    --space-6: 24px;
    --space-8: 32px;
    --space-10: 40px;
    --space-12: 48px;
    --space-16: 64px;
    --space-20: 80px;

    /* Radius */
    --radius-sm: 4px;
    --radius-md: 6px;
    --radius-lg: 8px;
    --radius-xl: 12px;

    /* Shadow */
    --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.04);
    --shadow-md: 0 4px 12px rgba(0, 0, 0, 0.06);
    --shadow-lg: 0 12px 32px rgba(0, 0, 0, 0.08);

    /* Type scale */
    --text-xs: 12px;
    --text-sm: 14px;
    --text-base: 16px;
    --text-lg: 18px;
    --text-xl: 20px;
    --text-2xl: 24px;
    --text-3xl: 30px;
    --text-4xl: 38px;
    --text-5xl: 48px;
}

/* ---------- Layout ---------- */
.app {
    display: grid;
    grid-template-columns: var(--sidebar-width) 1fr;
    min-height: 100vh;
}

/* ---------- Sidebar ---------- */
.sidebar {
    position: sticky;
    top: 0;
    height: 100vh;
    overflow-y: auto;
    background: var(--sidebar-bg);
    border-right: 1px solid var(--color-border);
    padding: var(--space-6) 0;
}

.sidebar-header {
    padding: 0 var(--space-6) var(--space-6);
    border-bottom: 1px solid var(--color-border);
    margin-bottom: var(--space-4);
}

.sidebar-brand {
    display: flex;
    align-items: center;
    gap: var(--space-3);
    text-decoration: none;
    color: var(--color-text);
}

.sidebar-brand-mark {
    width: 32px;
    height: 32px;
    background: linear-gradient(135deg, #2563eb 0%, #7c3aed 100%);
    border-radius: var(--radius-md);
    display: flex;
    align-items: center;
    justify-content: center;
    color: white;
    font-weight: 700;
    font-size: 14px;
}

.sidebar-brand-text {
    font-size: var(--text-sm);
    font-weight: 600;
    letter-spacing: -0.01em;
    line-height: 1.2;
}

.sidebar-brand-sub {
    font-size: 11px;
    color: var(--color-text-subtle);
    font-weight: 500;
}

.sidebar-nav {
    padding: 0 var(--space-3);
}

.sidebar-group {
    margin-bottom: var(--space-5);
}

.sidebar-group-title {
    font-size: 11px;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.06em;
    color: var(--color-text-subtle);
    padding: var(--space-2) var(--space-3);
    margin-bottom: var(--space-1);
}

.sidebar-link {
    display: flex;
    align-items: center;
    gap: var(--space-2);
    padding: 6px var(--space-3);
    font-size: var(--text-sm);
    color: var(--color-text-muted);
    text-decoration: none;
    border-radius: var(--radius-md);
    line-height: 1.4;
    margin-bottom: 1px;
    transition: background 0.1s ease, color 0.1s ease;
}

.sidebar-link:hover {
    background: rgba(0, 0, 0, 0.04);
    color: var(--color-text);
}

.sidebar-link.active {
    background: var(--color-accent-subtle);
    color: var(--color-accent);
    font-weight: 500;
}

.sidebar-link-num {
    display: inline-block;
    font-size: 11px;
    color: var(--color-text-subtle);
    font-variant-numeric: tabular-nums;
    min-width: 18px;
}

.sidebar-link.active .sidebar-link-num {
    color: var(--color-accent);
}

/* ---------- Main content ---------- */
.content-wrap {
    display: grid;
    grid-template-columns: 1fr var(--toc-width);
    max-width: 1280px;
    margin: 0 auto;
    padding: var(--space-12) var(--space-10) var(--space-20);
    gap: var(--space-10);
    width: 100%;
}

.content {
    min-width: 0;
    max-width: 760px;
}

/* ---------- TOC (right rail) ---------- */
.toc {
    position: sticky;
    top: var(--space-8);
    align-self: start;
    max-height: calc(100vh - var(--space-16));
    overflow-y: auto;
    font-size: var(--text-sm);
    padding-left: var(--space-4);
    border-left: 1px solid var(--color-border);
}

.toc-title {
    font-size: 11px;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.06em;
    color: var(--color-text-subtle);
    margin-bottom: var(--space-3);
}

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

.toc-list li {
    margin: 0;
}

.toc-list a {
    display: block;
    padding: 4px 0;
    color: var(--color-text-muted);
    text-decoration: none;
    line-height: 1.4;
    border-left: 2px solid transparent;
    margin-left: -16px;
    padding-left: 14px;
    transition: color 0.1s ease, border-color 0.1s ease;
}

.toc-list a:hover {
    color: var(--color-text);
}

.toc-list a.active {
    color: var(--color-accent);
    border-left-color: var(--color-accent);
}

.toc-list .toc-h3 {
    padding-left: 24px;
    font-size: 13px;
}

/* ---------- Typography ---------- */
.eyebrow {
    display: inline-block;
    font-size: var(--text-xs);
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--color-accent);
    margin-bottom: var(--space-3);
}

.page-title {
    font-size: var(--text-4xl);
    font-weight: 700;
    letter-spacing: -0.02em;
    line-height: 1.15;
    margin: 0 0 var(--space-4);
    color: var(--color-text);
}

.page-lead {
    font-size: var(--text-lg);
    line-height: 1.55;
    color: var(--color-text-muted);
    margin: 0 0 var(--space-10);
    max-width: 65ch;
}

h2 {
    font-size: var(--text-2xl);
    font-weight: 700;
    letter-spacing: -0.015em;
    line-height: 1.25;
    margin: var(--space-12) 0 var(--space-4);
    padding-top: var(--space-2);
    color: var(--color-text);
    scroll-margin-top: var(--space-6);
}

h3 {
    font-size: var(--text-lg);
    font-weight: 600;
    letter-spacing: -0.01em;
    line-height: 1.3;
    margin: var(--space-8) 0 var(--space-3);
    color: var(--color-text);
    scroll-margin-top: var(--space-6);
}

h4 {
    font-size: var(--text-base);
    font-weight: 600;
    margin: var(--space-6) 0 var(--space-2);
    color: var(--color-text);
}

p {
    margin: 0 0 var(--space-4);
    color: var(--color-text);
}

p.muted {
    color: var(--color-text-muted);
}

a {
    color: var(--color-accent);
    text-decoration: none;
    border-bottom: 1px solid transparent;
    transition: border-color 0.15s ease;
}

a:hover {
    border-bottom-color: var(--color-accent);
}

strong {
    font-weight: 600;
    color: var(--color-text);
}

ul,
ol {
    margin: 0 0 var(--space-4);
    padding-left: var(--space-6);
}

li {
    margin-bottom: var(--space-2);
}

li > ul,
li > ol {
    margin-top: var(--space-2);
}

hr {
    border: 0;
    border-top: 1px solid var(--color-border);
    margin: var(--space-12) 0;
}

/* ---------- Code ---------- */
code {
    font-family: var(--font-mono);
    font-size: 0.875em;
    background: var(--color-bg-code-inline);
    padding: 2px 6px;
    border-radius: var(--radius-sm);
    color: #be185d;
    border: 1px solid rgba(0, 0, 0, 0.04);
}

pre {
    background: var(--color-bg-code);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    padding: var(--space-4) var(--space-5);
    overflow-x: auto;
    margin: 0 0 var(--space-5);
    line-height: 1.55;
    font-size: 13.5px;
    position: relative;
}

pre code {
    background: transparent;
    padding: 0;
    border: 0;
    color: var(--color-text);
    font-size: inherit;
}

.code-block {
    position: relative;
    margin: 0 0 var(--space-5);
}

.code-block-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    background: var(--color-bg-muted);
    border: 1px solid var(--color-border);
    border-bottom: 0;
    border-radius: var(--radius-lg) var(--radius-lg) 0 0;
    padding: 8px var(--space-4);
    font-size: 12px;
    color: var(--color-text-muted);
    font-family: var(--font-mono);
}

.code-block-header + pre {
    border-radius: 0 0 var(--radius-lg) var(--radius-lg);
    margin-top: 0;
}

.code-block-lang {
    display: inline-block;
    font-size: 11px;
    text-transform: uppercase;
    letter-spacing: 0.06em;
    color: var(--color-text-subtle);
    font-family: var(--font-mono);
}

.copy-btn {
    background: transparent;
    border: 1px solid var(--color-border);
    border-radius: var(--radius-sm);
    padding: 2px 8px;
    font-size: 11px;
    color: var(--color-text-muted);
    cursor: pointer;
    font-family: var(--font-mono);
    transition: all 0.15s ease;
}

.copy-btn:hover {
    background: white;
    color: var(--color-text);
    border-color: var(--color-border-strong);
}

.copy-btn.copied {
    color: var(--color-success);
    border-color: var(--color-success);
}

/* ---------- Callouts ---------- */
.callout {
    border: 1px solid;
    border-left-width: 4px;
    border-radius: var(--radius-lg);
    padding: var(--space-4) var(--space-5);
    margin: var(--space-6) 0;
    display: grid;
    grid-template-columns: 24px 1fr;
    gap: var(--space-3);
    align-items: start;
}

.callout-icon {
    font-size: 16px;
    line-height: 1.5;
    font-weight: 700;
}

.callout-body > :last-child {
    margin-bottom: 0;
}

.callout-title {
    font-weight: 600;
    margin-bottom: var(--space-1);
    color: var(--color-text);
}

.callout-info {
    background: var(--color-info-subtle);
    border-color: var(--color-info);
}

.callout-info .callout-icon {
    color: var(--color-info);
}

.callout-tip {
    background: var(--color-success-subtle);
    border-color: var(--color-success);
}

.callout-tip .callout-icon {
    color: var(--color-success);
}

.callout-warn {
    background: var(--color-warning-subtle);
    border-color: var(--color-warning);
}

.callout-warn .callout-icon {
    color: var(--color-warning);
}

.callout-danger {
    background: var(--color-danger-subtle);
    border-color: var(--color-danger);
}

.callout-danger .callout-icon {
    color: var(--color-danger);
}

.callout-jargon {
    background: #faf5ff;
    border-color: #9333ea;
}

.callout-jargon .callout-icon {
    color: #9333ea;
}

/* ---------- Cards / grid ---------- */
.card-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
    gap: var(--space-4);
    margin: var(--space-6) 0;
}

.card {
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    padding: var(--space-5);
    background: var(--color-bg);
    transition: border-color 0.15s ease, box-shadow 0.15s ease, transform 0.15s ease;
    text-decoration: none;
    color: inherit;
    display: block;
}

a.card:hover {
    border-color: var(--color-accent);
    box-shadow: var(--shadow-md);
    border-bottom-color: var(--color-accent);
}

.card-num {
    font-family: var(--font-mono);
    font-size: var(--text-xs);
    color: var(--color-accent);
    font-weight: 600;
    letter-spacing: 0.04em;
    margin-bottom: var(--space-2);
    display: block;
}

.card-title {
    font-size: var(--text-base);
    font-weight: 600;
    color: var(--color-text);
    margin: 0 0 var(--space-2);
}

.card-desc {
    font-size: var(--text-sm);
    color: var(--color-text-muted);
    margin: 0;
    line-height: 1.5;
}

/* ---------- Step list (numbered guide) ---------- */
.steps {
    counter-reset: step-counter;
    list-style: none;
    padding: 0;
    margin: var(--space-6) 0;
}

.step {
    counter-increment: step-counter;
    position: relative;
    padding-left: var(--space-12);
    padding-bottom: var(--space-8);
    border-left: 2px solid var(--color-border);
    margin-left: 16px;
}

.step:last-child {
    border-left-color: transparent;
    padding-bottom: 0;
}

.step::before {
    content: counter(step-counter);
    position: absolute;
    left: -16px;
    top: -4px;
    width: 32px;
    height: 32px;
    border-radius: 50%;
    background: var(--color-accent);
    color: white;
    display: flex;
    align-items: center;
    justify-content: center;
    font-weight: 700;
    font-size: 13px;
    font-family: var(--font-mono);
}

.step-title {
    font-size: var(--text-lg);
    font-weight: 600;
    margin: 0 0 var(--space-3);
    color: var(--color-text);
}

.step-meta {
    font-size: var(--text-xs);
    color: var(--color-text-subtle);
    text-transform: uppercase;
    letter-spacing: 0.06em;
    margin-bottom: var(--space-2);
    font-weight: 600;
}

/* ---------- Tables ---------- */
table {
    width: 100%;
    border-collapse: collapse;
    margin: 0 0 var(--space-5);
    font-size: var(--text-sm);
}

th,
td {
    text-align: left;
    padding: var(--space-3) var(--space-4);
    border-bottom: 1px solid var(--color-border);
}

th {
    font-weight: 600;
    color: var(--color-text-muted);
    font-size: var(--text-xs);
    text-transform: uppercase;
    letter-spacing: 0.04em;
    background: var(--color-bg-subtle);
}

td code {
    font-size: 0.85em;
}

/* ---------- Pills / badges ---------- */
.pill {
    display: inline-block;
    padding: 2px 8px;
    border-radius: 12px;
    font-size: 11px;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.04em;
    font-family: var(--font-mono);
}

.pill-domain {
    background: #ddd6fe;
    color: #5b21b6;
}

.pill-app {
    background: #bfdbfe;
    color: #1e40af;
}

.pill-infra {
    background: #bbf7d0;
    color: #166534;
}

.pill-present {
    background: #fed7aa;
    color: #9a3412;
}

.pill-neutral {
    background: var(--color-bg-muted);
    color: var(--color-text-muted);
}

/* ---------- Hero (landing page) ---------- */
.hero {
    padding: var(--space-12) 0 var(--space-8);
    border-bottom: 1px solid var(--color-border);
    margin-bottom: var(--space-10);
}

.hero-title {
    font-size: var(--text-5xl);
    font-weight: 800;
    letter-spacing: -0.03em;
    line-height: 1.05;
    margin: 0 0 var(--space-5);
    color: var(--color-text);
    background: linear-gradient(135deg, #0a0a0a 0%, #3730a3 100%);
    -webkit-background-clip: text;
    background-clip: text;
    -webkit-text-fill-color: transparent;
}

.hero-lead {
    font-size: var(--text-xl);
    line-height: 1.55;
    color: var(--color-text-muted);
    margin: 0 0 var(--space-6);
    max-width: 65ch;
}

.hero-cta {
    display: flex;
    gap: var(--space-3);
    margin-top: var(--space-6);
}

.btn {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    padding: 10px 20px;
    border-radius: var(--radius-md);
    font-weight: 500;
    font-size: var(--text-sm);
    text-decoration: none;
    border: 1px solid transparent;
    transition: all 0.15s ease;
    cursor: pointer;
    font-family: inherit;
}

.btn-primary {
    background: var(--color-text);
    color: var(--color-text-inverse);
    border-color: var(--color-text);
}

.btn-primary:hover {
    background: #404040;
    border-color: #404040;
    border-bottom-color: #404040;
}

.btn-secondary {
    background: var(--color-bg);
    color: var(--color-text);
    border-color: var(--color-border-strong);
}

.btn-secondary:hover {
    background: var(--color-bg-muted);
    border-bottom-color: var(--color-border-strong);
}

.btn-arrow {
    font-family: var(--font-mono);
    font-size: 14px;
}

/* ---------- Architecture stack ---------- */
.arch-stack {
    margin: var(--space-6) 0;
    border-radius: var(--radius-lg);
    overflow: hidden;
    border: 1px solid var(--color-border);
}

.arch-layer {
    padding: var(--space-4) var(--space-5);
    border-bottom: 1px solid var(--color-border);
    display: grid;
    grid-template-columns: 140px 1fr;
    align-items: center;
    gap: var(--space-4);
}

.arch-layer:last-child {
    border-bottom: 0;
}

.arch-layer-name {
    font-weight: 600;
    font-size: var(--text-sm);
    display: flex;
    align-items: center;
    gap: var(--space-2);
}

.arch-layer-projects {
    font-family: var(--font-mono);
    font-size: 12.5px;
    color: var(--color-text-muted);
}

.arch-layer-domain {
    background: #faf5ff;
}

.arch-layer-app {
    background: #eff6ff;
}

.arch-layer-infra {
    background: #f0fdf4;
}

.arch-layer-present {
    background: #fff7ed;
}

/* ---------- File tree ---------- */
.file-tree {
    background: var(--color-bg-code);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    padding: var(--space-4) var(--space-5);
    font-family: var(--font-mono);
    font-size: 13px;
    line-height: 1.7;
    overflow-x: auto;
    color: var(--color-text);
    margin: 0 0 var(--space-5);
    white-space: pre;
    tab-size: 4;
}

.file-tree .ft-dir {
    color: var(--color-accent);
    font-weight: 500;
}

.file-tree .ft-file {
    color: var(--color-text);
}

.file-tree .ft-comment {
    color: var(--color-text-subtle);
    font-style: italic;
}

/* ---------- Annotated code (split view) ---------- */
.annotated {
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    overflow: hidden;
    margin: 0 0 var(--space-5);
}

.annotated-row {
    display: grid;
    grid-template-columns: 1fr 1fr;
    border-bottom: 1px solid var(--color-border);
}

.annotated-row:last-child {
    border-bottom: 0;
}

.annotated-code {
    background: var(--color-bg-code);
    padding: var(--space-3) var(--space-4);
    font-family: var(--font-mono);
    font-size: 13px;
    line-height: 1.6;
    border-right: 1px solid var(--color-border);
    white-space: pre;
    overflow-x: auto;
    color: var(--color-text);
}

.annotated-note {
    padding: var(--space-3) var(--space-4);
    font-size: var(--text-sm);
    line-height: 1.55;
    color: var(--color-text-muted);
    background: var(--color-bg);
}

.annotated-note strong {
    color: var(--color-text);
}

/* ---------- Page footer / next-prev nav ---------- */
.page-nav {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: var(--space-4);
    margin-top: var(--space-16);
    padding-top: var(--space-8);
    border-top: 1px solid var(--color-border);
}

.page-nav-link {
    display: block;
    padding: var(--space-4) var(--space-5);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-lg);
    text-decoration: none;
    color: var(--color-text);
    transition: border-color 0.15s ease, box-shadow 0.15s ease;
}

.page-nav-link:hover {
    border-color: var(--color-accent);
    box-shadow: var(--shadow-sm);
    border-bottom-color: var(--color-accent);
}

.page-nav-prev {
    text-align: left;
}

.page-nav-next {
    text-align: right;
    grid-column: 2;
}

.page-nav-label {
    font-size: var(--text-xs);
    color: var(--color-text-subtle);
    text-transform: uppercase;
    letter-spacing: 0.06em;
    margin-bottom: var(--space-1);
    font-weight: 600;
}

.page-nav-title {
    font-size: var(--text-base);
    font-weight: 600;
    color: var(--color-text);
}

/* ---------- Definition list ---------- */
.def {
    display: grid;
    grid-template-columns: 200px 1fr;
    gap: var(--space-4);
    padding: var(--space-3) 0;
    border-bottom: 1px solid var(--color-border);
}

.def:last-child {
    border-bottom: 0;
}

.def-term {
    font-weight: 600;
    font-size: var(--text-sm);
    color: var(--color-text);
}

.def-term code {
    background: transparent;
    padding: 0;
    border: 0;
    color: #be185d;
}

.def-desc {
    font-size: var(--text-sm);
    color: var(--color-text-muted);
    line-height: 1.55;
}

/* ---------- Responsive ---------- */
@media (max-width: 1200px) {
    .content-wrap {
        grid-template-columns: 1fr;
        max-width: 800px;
    }

    .toc {
        display: none;
    }
}

@media (max-width: 768px) {
    .app {
        grid-template-columns: 1fr;
    }

    .sidebar {
        position: relative;
        height: auto;
        max-height: none;
        border-right: 0;
        border-bottom: 1px solid var(--color-border);
    }

    .content-wrap {
        padding: var(--space-6) var(--space-4) var(--space-10);
    }

    .hero-title {
        font-size: var(--text-3xl);
    }

    .page-title {
        font-size: var(--text-3xl);
    }

    .annotated-row {
        grid-template-columns: 1fr;
    }

    .annotated-code {
        border-right: 0;
        border-bottom: 1px solid var(--color-border);
    }

    .arch-layer {
        grid-template-columns: 1fr;
    }

    .def {
        grid-template-columns: 1fr;
        gap: var(--space-1);
    }

    .page-nav {
        grid-template-columns: 1fr;
    }

    .page-nav-next {
        grid-column: auto;
    }
}

/* ---------- Skip link for accessibility ---------- */
.skip-link {
    position: absolute;
    top: -100px;
    left: 0;
    background: var(--color-accent);
    color: white;
    padding: var(--space-2) var(--space-4);
    text-decoration: none;
    border-radius: 0 0 var(--radius-md) 0;
}

.skip-link:focus {
    top: 0;
}