/* =============================================================
* Josh — Documentation prose stylesheet
* Layered on top of /design/josh-design-system/project/colors_and_type.css.
* Used by every per-doc HTML page under /docs/.
* =============================================================
*
* Authoring guide:
* - Page shell:
*
*
* - Asset paths are depth-relative per file (e.g., ../../design/... and
* ../_assets/docs.css for files at depth 1). Sidebar paths in each file's
* NAV block are also depth-relative; bin/sync-nav.py rewrites them per
* peer when propagating from the canonical (docs/index.html). This means
* the docs work via file://, the editor preview, and any HTTP server —
* no fixed serve-root assumption.
*/
html, body { margin: 0; padding: 0; }
*, *::before, *::after { box-sizing: border-box; }
body.docs-page {
background: var(--josh-bg);
color: var(--josh-body);
font-family: var(--josh-ui);
}
/* ---------- layout ---------- */
.docs-layout {
display: grid;
grid-template-columns: 280px minmax(0, 1fr);
max-width: 1280px;
margin: 0 auto;
}
/* ---------- sidebar ---------- */
aside.docs-nav {
position: sticky;
top: 0;
align-self: start;
height: 100vh;
overflow-y: auto;
padding: var(--josh-s-7) var(--josh-s-5) var(--josh-s-7) var(--josh-s-6);
border-right: 1px solid var(--josh-line);
background: var(--josh-bg);
}
.docs-nav .nav-brand {
display: flex;
align-items: center;
gap: var(--josh-s-3);
margin-bottom: var(--josh-s-6);
text-decoration: none;
}
.docs-nav .nav-brand .mark {
width: 36px; height: 36px;
border-radius: var(--josh-r-card);
display: block;
}
.docs-nav .nav-brand .name {
font-family: var(--josh-serif);
font-size: 22px;
font-weight: 600;
color: var(--josh-ink);
letter-spacing: -0.3px;
}
.docs-nav .nav-brand .name em {
font-style: normal;
color: var(--josh-muted);
font-weight: 400;
font-family: var(--josh-ui);
font-size: 13px;
margin-left: 8px;
}
.docs-nav .nav-group { margin-bottom: var(--josh-s-5); }
.docs-nav .nav-group .label {
font-family: var(--josh-mono);
font-size: 10.5px;
font-weight: 500;
letter-spacing: 1.4px;
text-transform: uppercase;
color: var(--josh-muted-2);
margin: 0 0 var(--josh-s-3) 4px;
}
.docs-nav .nav-group ul { list-style: none; margin: 0; padding: 0; }
.docs-nav .nav-group li { margin: 0; }
.docs-nav .nav-group a {
display: block;
padding: 6px 10px;
border-radius: var(--josh-r-default);
color: var(--josh-body);
text-decoration: none;
font-size: 13.5px;
line-height: 18px;
transition: background 80ms ease, color 80ms ease;
}
.docs-nav .nav-group a:hover {
background: var(--josh-wash);
color: var(--josh-ink);
}
.docs-nav .nav-group a[aria-current="page"] {
background: var(--josh-tint);
color: var(--josh-ink);
font-weight: 500;
}
/* ---------- main / prose ---------- */
main.docs-prose {
padding: var(--josh-s-9) var(--josh-s-8) var(--josh-s-9);
max-width: 820px;
}
/* Wider variant for diagram-heavy technical docs (query-flows, query-coverage).
* Apply with: . */
main.docs-prose.is-wide {
max-width: 1100px;
}
main.docs-prose .breadcrumb {
font-family: var(--josh-mono);
font-size: 11px;
font-weight: 500;
letter-spacing: 1.4px;
text-transform: uppercase;
color: var(--josh-muted);
margin: 0 0 var(--josh-s-4) 0;
}
main.docs-prose .breadcrumb a {
color: var(--josh-muted);
text-decoration: none;
}
main.docs-prose .breadcrumb a:hover { color: var(--josh-ink); }
main.docs-prose .breadcrumb .sep { margin: 0 8px; color: var(--josh-muted-2); }
main.docs-prose h1 {
font-family: var(--josh-serif);
font-size: 44px;
line-height: 50px;
font-weight: 500;
letter-spacing: -0.5px;
color: var(--josh-ink);
margin: 0 0 var(--josh-s-5) 0;
}
main.docs-prose .lede {
font-family: var(--josh-serif);
font-size: 19px;
line-height: 30px;
color: var(--josh-body);
max-width: 640px;
margin: 0 0 var(--josh-s-7) 0;
}
main.docs-prose h2 {
font-family: var(--josh-serif);
font-size: 28px;
line-height: 34px;
font-weight: 500;
letter-spacing: -0.3px;
color: var(--josh-ink);
margin: var(--josh-s-8) 0 var(--josh-s-4) 0;
padding-top: var(--josh-s-2);
border-top: 1px solid var(--josh-line-2);
}
main.docs-prose h2:first-of-type { border-top: none; padding-top: 0; margin-top: 0; }
main.docs-prose h3 {
font-family: var(--josh-ui);
font-size: 17px;
line-height: 24px;
font-weight: 600;
color: var(--josh-ink);
margin: var(--josh-s-7) 0 var(--josh-s-3) 0;
letter-spacing: -0.1px;
}
main.docs-prose h4 {
font-family: var(--josh-ui);
font-size: 13.5px;
line-height: 20px;
font-weight: 600;
color: var(--josh-ink);
margin: var(--josh-s-5) 0 var(--josh-s-2) 0;
}
main.docs-prose p,
main.docs-prose li {
font-family: var(--josh-ui);
font-size: 14.5px;
line-height: 23px;
color: var(--josh-body);
}
main.docs-prose p { margin: 0 0 var(--josh-s-4) 0; }
main.docs-prose ul,
main.docs-prose ol { padding-left: 22px; margin: 0 0 var(--josh-s-4) 0; }
main.docs-prose li { margin-bottom: 4px; }
main.docs-prose li > ul,
main.docs-prose li > ol { margin-top: 4px; margin-bottom: 4px; }
main.docs-prose strong { color: var(--josh-ink); font-weight: 600; }
main.docs-prose em { font-style: italic; }
main.docs-prose a {
color: var(--josh-ink);
text-decoration: underline;
text-decoration-color: var(--josh-line);
text-underline-offset: 3px;
}
main.docs-prose a:hover { text-decoration-color: var(--josh-muted-2); }
/* ---------- inline / block code ---------- */
main.docs-prose code {
font-family: var(--josh-mono);
font-size: 12.5px;
color: var(--josh-ink-2);
background: var(--josh-wash);
padding: 1px 5px;
border-radius: 3px;
}
main.docs-prose pre {
font-family: var(--josh-mono);
font-size: 12.5px;
line-height: 19px;
color: var(--josh-ink-2);
background: var(--josh-wash);
border: 1px solid var(--josh-line);
border-radius: var(--josh-r-card);
padding: var(--josh-s-4);
margin: 0 0 var(--josh-s-5) 0;
overflow-x: auto;
}
main.docs-prose pre code {
padding: 0;
background: transparent;
font-size: inherit;
color: inherit;
}
/* ---------- callouts (blockquote-style notes) ---------- */
main.docs-prose blockquote {
font-family: var(--josh-ui);
font-size: 14px;
line-height: 22px;
color: var(--josh-body);
background: var(--josh-wash);
border-left: 3px solid var(--josh-muted-2);
border-radius: 0 var(--josh-r-card) var(--josh-r-card) 0;
padding: var(--josh-s-3) var(--josh-s-4);
margin: 0 0 var(--josh-s-5) 0;
}
main.docs-prose blockquote p:last-child { margin-bottom: 0; }
main.docs-prose blockquote strong:first-child { color: var(--josh-ink); }
/* ---------- tables ---------- */
main.docs-prose .table-wrap {
overflow-x: auto;
margin: 0 0 var(--josh-s-5) 0;
border: 1px solid var(--josh-line);
border-radius: var(--josh-r-card);
}
main.docs-prose table {
width: 100%;
border-collapse: collapse;
font-family: var(--josh-ui);
font-size: 13.5px;
}
main.docs-prose table th,
main.docs-prose table td {
text-align: left;
padding: 10px 14px;
border-bottom: 1px solid var(--josh-line-2);
color: var(--josh-body);
vertical-align: top;
}
main.docs-prose table th {
font-weight: 600;
color: var(--josh-ink);
background: var(--josh-wash);
font-size: 12.5px;
letter-spacing: 0.1px;
}
main.docs-prose table tr:last-child td { border-bottom: none; }
main.docs-prose table td code,
main.docs-prose table th code {
font-size: 12px;
background: transparent;
padding: 0;
}
/* ---------- horizontal rule ---------- */
main.docs-prose hr {
border: none;
border-top: 1px solid var(--josh-line);
margin: var(--josh-s-7) 0;
}
/* ---------- footer / meta line ---------- */
main.docs-prose .doc-meta {
color: var(--josh-muted);
font-size: 12.5px;
font-family: var(--josh-mono);
margin-top: var(--josh-s-9);
padding-top: var(--josh-s-4);
border-top: 1px solid var(--josh-line-2);
}
/* ---------- internal banner ---------- */
.private-banner {
font-family: var(--josh-mono);
font-size: 11px;
font-weight: 500;
letter-spacing: 1.2px;
text-transform: uppercase;
color: oklch(0.55 0.18 25);
background: oklch(0.97 0.03 25);
border-bottom: 1px solid oklch(0.85 0.06 25);
padding: 8px var(--josh-s-6);
text-align: center;
}
/* ---------- mobile / narrow-pane layer ---------- */
/* Off-canvas sidebar with hamburger toggle. Engages at ≤720px (covers
* narrow editor preview panes ~400–600px and small phones). The toggle
* button + overlay are injected by docs-nav.js into . Placed at
* the end of the file so its rules win the cascade over the desktop
* sidebar/prose blocks above (same selector specificity, later wins). */
.docs-nav-toggle { display: none; }
@media (max-width: 720px) {
.docs-layout { grid-template-columns: 1fr; }
aside.docs-nav {
position: fixed;
top: 0;
left: 0;
height: 100vh;
width: min(85vw, 320px);
transform: translateX(-100%);
transition: transform 200ms ease;
z-index: 30;
box-shadow: 0 0 24px rgba(15, 17, 21, 0.06);
}
body.nav-open aside.docs-nav { transform: translateX(0); }
.docs-nav-overlay {
position: fixed;
inset: 0;
background: rgba(15, 17, 21, 0.32);
opacity: 0;
pointer-events: none;
transition: opacity 160ms ease;
z-index: 20;
}
body.nav-open .docs-nav-overlay {
opacity: 1;
pointer-events: auto;
}
body.nav-open { overflow: hidden; }
.docs-nav-toggle {
position: fixed;
top: 12px;
left: 12px;
z-index: 40;
width: 40px;
height: 40px;
border-radius: var(--josh-r-default);
background: var(--josh-surface);
border: 1px solid var(--josh-line);
display: grid;
place-items: center;
cursor: pointer;
padding: 0;
color: var(--josh-ink);
box-shadow: 0 1px 2px rgba(15, 17, 21, 0.04);
}
.docs-nav-toggle:hover { background: var(--josh-wash); }
.docs-nav-toggle:focus-visible {
outline: 2px solid var(--josh-ink);
outline-offset: 2px;
}
.docs-nav-toggle svg { display: block; }
.docs-nav-toggle .icon-close { display: none; }
body.nav-open .docs-nav-toggle .icon-open { display: none; }
body.nav-open .docs-nav-toggle .icon-close { display: block; }
/* Tighten prose so it doesn't crash into edges */
main.docs-prose {
padding: calc(var(--josh-s-7) + 40px) var(--josh-s-5) var(--josh-s-7);
}
main.docs-prose h1 { font-size: 32px; line-height: 38px; }
main.docs-prose .lede { font-size: 17px; line-height: 26px; }
main.docs-prose pre { font-size: 11.5px; line-height: 17px; }
}