/* Breckly documentation skin for the UI Docs family (DocsShell, DocsNav, DocsPager, Markdown, Diagram).
   Same rail, top bar and tokens as the application shell; a wider reading measure (typography guide: "the documentation's
   reading surface may use a larger reading measure"). Diagrams take the product family's tints only: never Brick. */

/* ---------- Diagram tokens, read by Diagram.razor.js and handed to Mermaid ---------- */

:root, [data-theme="light"] {
  --diagram-bg: var(--surface);
  --diagram-node: color-mix(in srgb, var(--p-accent) 9%, var(--surface));
  --diagram-node-border: var(--p-accent);
  --diagram-node-2: color-mix(in srgb, var(--p-glow) 14%, var(--surface));
  --diagram-node-3: var(--surface-2);
  --diagram-ink: var(--ink);
  --diagram-line: var(--ink-3);
  --diagram-label-bg: var(--surface);
  --diagram-cluster: var(--surface-2);
  --diagram-cluster-border: var(--line-strong);
  --diagram-note: color-mix(in srgb, var(--wait-mark) 14%, var(--surface));
  --diagram-note-ink: var(--ink);
  --diagram-note-border: var(--wait-mark);
  --diagram-accent: var(--p-accent);
  --diagram-font: var(--font-ui);
  --diagram-font-size: 14px;
  --diagram-cluster-1: color-mix(in srgb, var(--p-mid) 6%, var(--surface));
  --diagram-cluster-2: color-mix(in srgb, var(--p-glow) 11%, var(--surface));
  --diagram-cluster-3: color-mix(in srgb, var(--p-deep) 6%, var(--surface));
  --diagram-cluster-4: var(--sunken);
  --diagram-cluster-5: color-mix(in srgb, var(--p-mid) 11%, var(--surface));
  --diagram-cluster-6: color-mix(in srgb, var(--p-glow) 18%, var(--surface));
}

[data-theme="dark"] {
  --diagram-node: color-mix(in srgb, var(--p-accent-dk) 18%, var(--surface));
  --diagram-node-border: var(--p-accent-dk);
  --diagram-node-2: color-mix(in srgb, var(--p-glow) 14%, var(--surface));
  --diagram-node-3: var(--surface-2);
  --diagram-line: var(--ink-2);
  --diagram-note: color-mix(in srgb, var(--wait-mark) 16%, var(--surface));
  --diagram-accent: var(--p-accent-dk);
  --diagram-cluster-1: color-mix(in srgb, var(--p-accent-dk) 9%, var(--surface));
  --diagram-cluster-2: color-mix(in srgb, var(--p-glow) 8%, var(--surface));
  --diagram-cluster-3: color-mix(in srgb, var(--p-deep) 40%, var(--surface));
  --diagram-cluster-4: var(--sunken);
  --diagram-cluster-5: color-mix(in srgb, var(--p-accent-dk) 15%, var(--surface));
  --diagram-cluster-6: color-mix(in srgb, var(--p-glow) 13%, var(--surface));
}

/* ---------- Shell ---------- */

.doc-shell {
  --doc-rail-w: 272px;
  --doc-measure: 860px;
  display: grid; grid-template-columns: var(--doc-rail-w) minmax(0, 1fr); min-height: 100vh;
  background: linear-gradient(90deg, var(--rail-bg) var(--doc-rail-w), var(--bg) var(--doc-rail-w));
}
.doc-rail {
  position: sticky; top: 0; height: 100vh; z-index: 40;
  display: flex; flex-direction: column; min-height: 0;
  background: var(--rail-bg); color: var(--rail-ink);
  --wm-color: #FFFFFF;
}
[data-theme="dark"] .doc-rail { border-right: 1px solid var(--line); }
.doc-rail-head { padding: 16px 16px 12px; border-bottom: 1px solid var(--rail-line); }
.doc-rail-body { flex: 1; min-height: 0; overflow-y: auto; padding: 10px 10px 16px; scrollbar-width: thin; scrollbar-color: rgba(255, 255, 255, 0.16) transparent; }
.doc-rail-foot { padding: 10px 16px 14px; border-top: 1px solid var(--rail-line); font-size: 11.5px; color: #8F9BBD; }

.doc-column { min-width: 0; display: flex; flex-direction: column; }
.doc-topbar {
  position: sticky; top: 0; z-index: 30;
  height: var(--top-h);
  display: flex; align-items: center; gap: 12px;
  padding: 0 24px;
  background: color-mix(in oklab, var(--bg) 82%, transparent);
  backdrop-filter: saturate(1.4) blur(12px);
  -webkit-backdrop-filter: saturate(1.4) blur(12px);
  border-bottom: 1px solid var(--line);
}
.doc-topbar .doc-menu { display: none; }
.doc-topbar-title { min-width: 0; flex: 1; font-size: 13px; font-weight: 600; color: var(--ink-2); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.doc-topbar-actions { display: flex; align-items: center; gap: 4px; margin-left: auto; }

.doc-body { flex: 1; display: grid; grid-template-columns: minmax(0, 1fr); gap: 40px; padding: 36px 48px 72px; }
.doc-shell.has-aside .doc-body { grid-template-columns: minmax(0, var(--doc-measure)) 220px; }
.doc-main { min-width: 0; max-width: var(--doc-measure); outline: none; }
.doc-aside { position: sticky; top: calc(var(--top-h) + 28px); align-self: start; max-height: calc(100vh - var(--top-h) - 56px); overflow-y: auto; font-size: 12.5px; }
.doc-footer { padding: 18px 48px 28px; border-top: 1px solid var(--line); font-size: 12px; color: var(--ink-3); display: flex; flex-wrap: wrap; gap: 6px 20px; justify-content: space-between; }

@media (max-width: 1239px) { .doc-shell.has-aside .doc-body { grid-template-columns: minmax(0, 1fr); } .doc-aside { display: none; } }

@media (max-width: 860px) {
  .doc-shell { grid-template-columns: minmax(0, 1fr); background: var(--bg); }
  .doc-rail {
    position: fixed; inset: 0 auto 0 0; width: min(86vw, 320px);
    transform: translateX(-102%); transition: transform 0.28s var(--ease-out); visibility: hidden;
    box-shadow: var(--shadow-pop);
  }
  .doc-shell.nav-open .doc-rail { transform: none; visibility: visible; }
  .doc-scrim { position: fixed; inset: 0; z-index: 35; background: rgba(6, 22, 65, 0.42); }
  .doc-topbar { padding: 0 12px 0 8px; gap: 6px; }
  .doc-topbar .doc-menu { display: inline-grid; }
  .doc-body { padding: 24px 16px 56px; }
  .doc-footer { padding: 16px; }
}
@media (prefers-reduced-motion: reduce) { .doc-rail { transition: none; } }

/* ---------- Brand block in the rail ---------- */

.doc-brand { display: flex; align-items: center; gap: 10px; color: #FFFFFF; text-decoration: none; }
.doc-brand:hover { color: #FFFFFF; }
.doc-brand-text { display: flex; flex-direction: column; min-width: 0; line-height: 1.15; }
.doc-brand-text strong { font-size: 14.5px; font-weight: 700; letter-spacing: -0.01em; }
.doc-rail .app-title .pname { color: color-mix(in oklab, var(--p-accent-dk) 70%, #FFFFFF); }
.doc-brand-text small { font-size: 11.5px; font-weight: 500; color: var(--rail-ink); }

/* ---------- Navigation ---------- */

.doc-nav-group { margin: 16px 10px 6px; font-size: 11px; font-weight: 700; letter-spacing: 0.04em; text-transform: uppercase; color: #8F9BBD; }
.doc-nav-group:first-child { margin-top: 4px; }
.doc-nav-list, .doc-nav-sections { list-style: none; margin: 0; padding: 0; }
.doc-nav-list { display: flex; flex-direction: column; gap: 2px; }
.doc-nav-link {
  display: flex; align-items: baseline; gap: 9px;
  padding: 7.5px 10px; border-radius: var(--r-sm);
  font-size: 13px; font-weight: 500; line-height: 1.35; color: var(--rail-ink); text-decoration: none;
  transition: background 0.15s, color 0.15s;
}
.doc-nav-link:hover { background: var(--rail-hover); color: #FFFFFF; }
.doc-nav-link[aria-current="page"] { background: var(--rail-active); color: #FFFFFF; font-weight: 600; }
.doc-nav-prefix { flex: none; min-width: 1.3em; font-size: 12px; font-weight: 600; color: #8F9BBD; }
.doc-nav-link[aria-current="page"] .doc-nav-prefix { color: color-mix(in oklab, var(--p-glow) 75%, #FFFFFF); }
.doc-nav-sections { margin: 4px 0 8px 21px; padding-left: 10px; border-left: 1px solid var(--rail-line); display: flex; flex-direction: column; gap: 1px; }
.doc-nav-section {
  display: block; padding: 4.5px 8px; border-radius: var(--r-xs);
  font-size: 12px; line-height: 1.4; color: #96A2C2; text-decoration: none;
}
.doc-nav-section.level-3 { padding-left: 18px; font-size: 11.5px; }
.doc-nav-section:hover { color: #FFFFFF; background: var(--rail-hover); }
.doc-nav-section.active { color: #FFFFFF; font-weight: 600; box-shadow: inset 2px 0 0 color-mix(in oklab, var(--p-glow) 75%, #FFFFFF); border-radius: 0 var(--r-xs) var(--r-xs) 0; }
.doc-rail :focus-visible { outline-color: var(--p-glow); }

/* ---------- Reading surface (Markdown) ---------- */

.markdown { font-size: 14.5px; line-height: 1.65; color: var(--ink); overflow-wrap: break-word; }
.markdown > :first-child { margin-top: 0; }
.markdown h1, .markdown h2, .markdown h3, .markdown h4 { position: relative; color: var(--ink); letter-spacing: -0.015em; line-height: 1.25; scroll-margin-top: calc(var(--top-h) + 20px); }
.markdown h1 { font-size: 27px; font-weight: 700; margin: 0 0 14px; }
.markdown h2 { font-size: 20px; font-weight: 700; margin: 44px 0 12px; padding-top: 22px; border-top: 1px solid var(--line); }
.markdown h3 { font-size: 16px; font-weight: 700; margin: 30px 0 8px; }
.markdown h4 { font-size: 14.5px; font-weight: 700; margin: 22px 0 6px; }
.markdown p, .markdown ul, .markdown ol, .markdown blockquote { margin: 0 0 14px; }
.markdown ul, .markdown ol { padding-left: 22px; }
.markdown li { margin: 3px 0; }
.markdown li::marker { color: var(--ink-3); }
.markdown strong { font-weight: 700; }
.markdown a { color: var(--accent); text-decoration: underline; text-decoration-color: var(--accent-line); text-underline-offset: 2px; }
.markdown a:hover { text-decoration-color: currentColor; }
.markdown hr { border: 0; border-top: 1px solid var(--line); margin: 28px 0; }
.markdown blockquote { padding: 10px 16px; border-left: 3px solid var(--accent-line); background: var(--surface-2); border-radius: 0 var(--r-sm) var(--r-sm) 0; color: var(--ink-2); }
.markdown blockquote > :last-child { margin-bottom: 0; }
.markdown :not(pre) > code { font-family: var(--font-data); font-size: 0.84em; padding: 1.5px 5px; border-radius: var(--r-xs); background: var(--sunken); border: 1px solid var(--line); }
.markdown .heading-anchor { margin-left: 8px; font-weight: 500; color: var(--ink-3); text-decoration: none; opacity: 0; transition: opacity 0.15s; }
.markdown :is(h1, h2, h3, h4):hover .heading-anchor, .markdown .heading-anchor:focus-visible { opacity: 1; }
.markdown .heading-anchor:hover { color: var(--accent); }
.markdown input[type="checkbox"] { accent-color: var(--btn); margin-right: 6px; }

.md-table { margin: 16px 0 20px; border: 1px solid var(--line); border-radius: var(--r-md); background: var(--surface); box-shadow: var(--shadow-1); }
.md-table:focus-visible { outline-offset: 2px; }
.md-table table { width: 100%; border-collapse: collapse; font-size: 13px; line-height: 1.5; }
.md-table th, .md-table td { padding: 9px 12px; text-align: left; vertical-align: top; border-bottom: 1px solid var(--line); }
.md-table th { font-size: 12px; font-weight: 700; color: var(--ink-2); background: var(--surface-2); white-space: nowrap; }
.md-table tr:last-child td { border-bottom: 0; }
.md-table td + td, .md-table th + th { border-left: 1px solid var(--line); }

.md-code { position: relative; margin: 16px 0 20px; border: 1px solid var(--line); border-radius: var(--r-md); background: var(--sunken); }
.md-code pre { margin: 0; padding: 14px 16px; overflow-x: auto; font-family: var(--font-data); font-size: 12.5px; line-height: 1.6; color: var(--ink); }
.md-code[data-lang] pre { padding-top: 30px; }
.md-code-lang { position: absolute; top: 8px; left: 14px; font-family: var(--font-data); font-size: 10.5px; color: var(--ink-3); }
.md-code-copy { position: absolute; top: 6px; right: 6px; opacity: 0; transition: opacity 0.15s; }
.md-code:hover .md-code-copy, .md-code-copy:focus-visible, .md-code-copy[data-copy-state="copied"] { opacity: 1; }
@media (hover: none) { .md-code-copy { opacity: 1; } }

/* ---------- Diagram ---------- */

.diagram { position: relative; margin: 18px 0 24px; padding: 18px; border: 1px solid var(--line); border-radius: var(--r-lg); background: var(--diagram-bg); box-shadow: var(--shadow-1); }
.diagram-canvas { min-height: 48px; border-radius: var(--r-sm); cursor: zoom-in; }
.diagram[data-state="error"] .diagram-canvas { display: none; }
.diagram-canvas:focus-visible { outline-offset: 6px; }
.diagram-canvas svg foreignObject { overflow: visible; }
.diagram-canvas svg :is(.nodeLabel, .edgeLabel, .cluster-label) { white-space: nowrap; }
.diagram-toolbar {
  position: absolute; top: 8px; right: 8px; z-index: 2;
  display: flex; gap: 2px; padding: 3px;
  border: 1px solid var(--line); border-radius: var(--r-md); background: var(--surface); box-shadow: var(--shadow-1);
  opacity: 0; transform: translateY(-2px); transition: opacity 0.15s, transform 0.15s;
}
.diagram:hover .diagram-toolbar, .diagram:focus-within .diagram-toolbar { opacity: 1; transform: none; }
@media (hover: none) { .diagram-toolbar { opacity: 1; transform: none; } }
.diagram-toolbar .icon-btn { width: 30px; height: 30px; }
.diagram .diagram-status { margin: 0; padding: 18px 0; text-align: center; font-size: 12.5px; color: var(--ink-3); }
.diagram .diagram-error { margin: 0 0 10px; font-size: 13px; font-weight: 600; color: var(--wait); }
.diagram-source { margin: 0; padding: 12px 14px; overflow-x: auto; border-radius: var(--r-sm); background: var(--sunken); font-family: var(--font-data); font-size: 12px; line-height: 1.55; }
.diagram figcaption { margin-top: 10px; font-size: 12.5px; color: var(--ink-2); text-align: center; }

.diagram-viewer { background: var(--bg); color: var(--ink); font-size: 13px; line-height: 1.4; outline: none; animation: diagram-in 0.18s var(--ease-out); }
/* The viewer renders where its diagram is, often inside .markdown: the reading styles must not reach it. */
.diagram-viewer .diagram-viewer-title { margin: 0; padding: 0; border: 0; font-size: 14.5px; line-height: 1.3; }
.diagram-viewer .diagram-viewer-hint { margin: 0; }
@keyframes diagram-in { from { opacity: 0; } }
@media (prefers-reduced-motion: reduce) { .diagram-viewer { animation: none; } }
.diagram-viewer-bar { display: flex; align-items: center; gap: 12px; min-height: var(--top-h); padding: 6px 12px 6px 20px; border-bottom: 1px solid var(--line); background: var(--surface); }
.diagram-viewer-title { flex: 1; min-width: 0; margin: 0; font-size: 14.5px; font-weight: 700; letter-spacing: -0.01em; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.diagram-viewer-tools { display: flex; align-items: center; gap: 2px; }
.diagram-zoom { min-width: 52px; text-align: center; font-size: 12px; font-weight: 600; color: var(--ink-2); }
.diagram-viewer-sep { width: 1px; height: 20px; margin: 0 6px; background: var(--line); }
.diagram-stage { background: var(--diagram-bg); background-image: radial-gradient(var(--line) 1px, transparent 1px); background-size: 22px 22px; }
.diagram-viewer-hint { margin: 0; padding: 8px 20px; font-size: 12px; color: var(--ink-3); border-top: 1px solid var(--line); background: var(--surface); }
@media (max-width: 640px) {
  .diagram { padding: 12px; }
  .diagram-viewer-bar { flex-wrap: wrap; padding: 8px 10px; }
  .diagram-viewer-title { flex-basis: 100%; }
  .diagram-viewer-hint { display: none; }
}

/* ---------- Previous / next ---------- */

.doc-pager { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin-top: 48px; padding-top: 24px; border-top: 1px solid var(--line); }
.doc-pager-link {
  display: flex; flex-direction: column; gap: 4px; padding: 14px 16px;
  border: 1px solid var(--line); border-radius: var(--r-md); background: var(--surface); color: var(--ink); text-decoration: none;
  transition: border-color 0.15s, box-shadow 0.15s;
}
.doc-pager-link:hover { border-color: var(--accent-line); box-shadow: var(--shadow-1); }
.doc-pager-link.next { grid-column: 2; text-align: right; align-items: flex-end; }
.doc-pager-dir { display: inline-flex; align-items: center; gap: 5px; font-size: 12px; font-weight: 600; color: var(--ink-3); }
.doc-pager-label { font-size: 14px; font-weight: 700; color: var(--accent); }
.doc-pager-label .num { margin-right: 6px; color: var(--ink-3); }
@media (max-width: 560px) { .doc-pager { grid-template-columns: 1fr; } .doc-pager-link.next { grid-column: 1; } }

/* ---------- Print: the reading column only, diagrams kept ---------- */

@media print {
  .doc-rail, .doc-topbar, .doc-aside, .doc-pager, .diagram-toolbar, .md-code-copy, .heading-anchor, .skip { display: none !important; }
  .doc-shell { display: block; background: none; }
  .doc-body { padding: 0; display: block; }
  .doc-main { max-width: none; }
  .diagram, .md-table, .md-code { box-shadow: none; break-inside: avoid; }
}
