/* ==========================================================================
   JM · Guidelines page — documentation layout & specimen components
   ========================================================================== */
.doc { display: grid; grid-template-columns: 240px minmax(0, 1fr); gap: var(--sp-8); padding-block: var(--sp-7) var(--sp-9); }
.doc__nav { position: sticky; top: calc(var(--nav-height) + var(--sp-5)); align-self: start; max-height: calc(100vh - var(--nav-height) - var(--sp-7)); overflow: auto; }
.doc__nav p { font-family: var(--font-mono); font-size: 10px; letter-spacing: .1em; text-transform: uppercase; color: var(--color-text-subtle); margin: var(--sp-4) 0 var(--sp-2); font-weight: 500; }
.doc__nav p:first-child { margin-top: 0; }
.doc__nav a { display: block; text-decoration: none; font-size: var(--fs-14); color: var(--color-text-muted); padding: 5px 10px; border-left: 1px solid var(--color-border); transition: all var(--dur-2); }
.doc__nav a:hover { color: var(--color-text); border-color: var(--color-border-strong); }
.doc__nav a[aria-current="true"] { color: var(--color-brand-text); border-color: var(--color-brand); background: var(--color-brand-subtle); }
.doc__body > section { padding-block: var(--sp-7); border-top: var(--bw-hair) dashed var(--color-border); scroll-margin-top: calc(var(--nav-height) + var(--sp-5)); }
.doc__body > section:first-child { border-top: 0; padding-top: 0; }
.doc__body h1, .doc__body h2 { margin-bottom: var(--sp-2); }
.doc__body h3 { font-size: var(--fs-20); font-weight: 500; margin: var(--sp-6) 0 var(--sp-3); line-height: 1.3; }
.doc__body h4, .doc__body .doc__kicker { font-family: var(--font-mono); font-size: var(--fs-12); letter-spacing: .08em; text-transform: uppercase; color: var(--color-text-subtle); font-weight: 500; line-height: var(--lh-relaxed); margin: var(--sp-5) 0 var(--sp-2); }
.doc__body p { max-width: 68ch; margin-bottom: var(--sp-3); }
.doc__body ul.list, .doc__body ol.list { max-width: 68ch; margin-bottom: var(--sp-4); padding-left: 1.2em; list-style: disc; }
.doc__body ol.list { list-style: decimal; }
.doc__body .list li { margin-bottom: 6px; }
.doc__body .list li::marker { color: var(--color-brand); }
.doc__body code { font-family: var(--font-mono); font-size: .85em; background: var(--color-bg-sunken); border: 1px solid var(--color-border-subtle); padding: 1px 5px; border-radius: 3px; }
.doc__body pre { background: var(--color-bg-inverse); color: var(--color-text-inverse); padding: var(--sp-4); border-radius: var(--radius-2); overflow: auto; font-family: var(--font-mono); font-size: var(--fs-13); line-height: 1.55; margin: var(--sp-3) 0 var(--sp-5); }
.doc__body pre code { background: transparent; border: 0; padding: 0; color: inherit; font-size: inherit; }
.doc__intro { display: flex; flex-wrap: wrap; gap: var(--sp-3); align-items: center; margin: var(--sp-3) 0 var(--sp-5); }
.eyebrow { font-family: var(--font-mono); font-size: var(--fs-12); letter-spacing: .08em; text-transform: uppercase; color: var(--color-brand-text); margin-bottom: var(--sp-2); display: block; }

/* Tables */
.table { width: 100%; border-collapse: collapse; font-size: var(--fs-14); margin: var(--sp-3) 0 var(--sp-5); }
.table th, .table td { text-align: left; padding: 10px 12px; border-bottom: 1px solid var(--color-border-subtle); vertical-align: top; }
.table th { font-family: var(--font-mono); font-size: 11px; letter-spacing: .06em; text-transform: uppercase; color: var(--color-text-subtle); font-weight: 500; border-bottom: 1px solid var(--color-border-strong); }
.table td code { white-space: nowrap; }
.table--wrap { display: block; overflow-x: auto; }
.table .ok { color: var(--color-success-text); font-family: var(--font-mono); font-size: 12px; }
.table .warn { color: var(--color-warning-text); font-family: var(--font-mono); font-size: 12px; }

/* Swatches */
.swatches { display: grid; grid-template-columns: repeat(11, 1fr); gap: 4px; margin: var(--sp-3) 0 var(--sp-5); }
.swatch { aspect-ratio: 1 / 1.35; border: 1px solid var(--color-border-subtle); display: flex; flex-direction: column; justify-content: flex-end; padding: 6px; font-family: var(--font-mono); font-size: 9px; line-height: 1.3; letter-spacing: .02em; }
.swatch--light { color: rgba(0,0,0,.72); } .swatch--dark { color: rgba(255,255,255,.85); }
.swatch b { font-weight: 600; display: block; }
.swatches--4 { grid-template-columns: repeat(4, 1fr); }
.swatches--5 { grid-template-columns: repeat(5, 1fr); }
.swatch-big { display: grid; grid-template-columns: 96px 1fr; gap: var(--sp-3); align-items: center; padding: var(--sp-3); border: 1px solid var(--color-border); margin-bottom: var(--sp-2); }
.swatch-big i { display: block; width: 96px; height: 64px; border: 1px solid var(--color-border-subtle); }
.swatch-big small { font-family: var(--font-mono); font-size: 11px; color: var(--color-text-subtle); display: block; }
.semantic-grid { display: grid; grid-template-columns: repeat(2, 1fr); gap: var(--sp-2); margin: var(--sp-3) 0 var(--sp-5); }

/* Type specimens */
.specimen { border-top: 1px solid var(--color-border-subtle); padding: var(--sp-4) 0; display: grid; grid-template-columns: 180px 1fr; gap: var(--sp-4); align-items: baseline; }
.specimen small { font-family: var(--font-mono); font-size: 11px; color: var(--color-text-subtle); line-height: 1.5; }
.specimen .sample { line-height: 1.15; overflow-wrap: anywhere; }

/* Spacing bars */
.space-scale { display: flex; flex-direction: column; gap: 8px; margin: var(--sp-3) 0 var(--sp-5); }
.space-scale div { display: grid; grid-template-columns: 90px 1fr; gap: var(--sp-3); align-items: center; font-family: var(--font-mono); font-size: 11px; color: var(--color-text-subtle); }
.space-scale i { display: block; height: 14px; background: var(--color-brand); opacity: .85; }

/* Radius / motion demos */
.demo-row { display: flex; flex-wrap: wrap; gap: var(--sp-4); align-items: center; margin: var(--sp-3) 0 var(--sp-5); }
.radius-demo { width: 72px; height: 72px; border: 1px solid var(--color-border-strong); background: var(--color-bg-elevated); display: grid; place-items: center; font-family: var(--font-mono); font-size: 10px; color: var(--color-text-subtle); }
.motion-demo { width: 160px; height: 72px; border: 1px dashed var(--color-border); position: relative; overflow: hidden; }
.motion-demo i { position: absolute; left: 8px; top: 24px; width: 24px; height: 24px; background: var(--color-brand); animation: slide 2.4s infinite; }
.motion-demo[data-ease="standard"] i { animation-timing-function: var(--ease-standard); }
.motion-demo[data-ease="emphasized"] i { animation-timing-function: var(--ease-emphasized); }
.motion-demo[data-ease="exit"] i { animation-timing-function: var(--ease-exit); }
.motion-demo small { position: absolute; left: 8px; bottom: 4px; font-family: var(--font-mono); font-size: 10px; color: var(--color-text-subtle); }
@keyframes slide { 0%, 15% { transform: translateX(0); } 60%, 100% { transform: translateX(120px); } }

/* Component showcase */
.showcase { border: 1px solid var(--color-border); background: var(--color-bg-elevated); background-image: radial-gradient(var(--grid-dot) 1px, transparent 1px); background-size: 16px 16px; padding: var(--sp-6) var(--sp-5); margin: var(--sp-3) 0 var(--sp-4); position: relative; }
.showcase__row { display: flex; flex-wrap: wrap; gap: var(--sp-4); align-items: center; }
.showcase__row + .showcase__row { margin-top: var(--sp-4); }
.showcase .lbl { font-family: var(--font-mono); font-size: 10px; letter-spacing: .06em; text-transform: uppercase; color: var(--color-text-subtle); width: 100%; }
.anatomy { position: relative; display: inline-block; margin: var(--sp-5) var(--sp-8) var(--sp-5) 0; }
.anatomy .pin { animation: none; }
.dodont { display: grid; grid-template-columns: repeat(2, 1fr); gap: var(--sp-4); margin: var(--sp-3) 0 var(--sp-5); }
.dodont > div { border: 1px solid var(--color-border); padding: var(--sp-4); border-top-width: 3px; }
.dodont .do { border-top-color: var(--color-success); }
.dodont .dont { border-top-color: var(--color-danger); }
.dodont b { font-family: var(--font-mono); font-size: 11px; letter-spacing: .08em; text-transform: uppercase; display: block; margin-bottom: var(--sp-2); }
.dodont .do b { color: var(--color-success-text); } .dodont .dont b { color: var(--color-danger-text); }
.dodont p { font-size: var(--fs-14); margin: 0; }
.dodont ul { padding-left: 1.1em; list-style: disc; font-size: var(--fs-14); }
.dodont li { margin-bottom: 4px; }
.state-list { display: grid; grid-template-columns: repeat(auto-fill, minmax(150px, 1fr)); gap: var(--sp-3); margin: var(--sp-3) 0 var(--sp-4); }
.state-list > div { display: flex; flex-direction: column; gap: 8px; align-items: flex-start; }
.state-list small { font-family: var(--font-mono); font-size: 10px; color: var(--color-text-subtle); letter-spacing: .04em; text-transform: uppercase; }

/* Form input demo */
.field { display: flex; flex-direction: column; gap: 6px; min-width: 240px; }
.field label { font-size: var(--fs-14); font-weight: 500; }
.field input, .field textarea { height: var(--input-height); padding: 0 var(--sp-3); border: 1px solid var(--color-border-strong); background: var(--color-bg-elevated); color: var(--color-text); border-radius: var(--radius-1); font: inherit; font-size: var(--fs-14); }
.field textarea { height: auto; padding: var(--sp-3); min-height: 96px; }
.field input:focus-visible { outline: 2px solid var(--color-focus); outline-offset: 2px; }
.field .help { font-size: var(--fs-13); color: var(--color-text-subtle); }
.field.is-invalid input { border-color: var(--color-danger); }
.field.is-invalid .help { color: var(--color-danger); }

/* Process phase cards */
.phase { border: 1px solid var(--color-border); background: var(--color-bg-elevated); padding: var(--sp-5); margin: var(--sp-4) 0; display: grid; grid-template-columns: 1fr 1fr; gap: var(--sp-5); position: relative; }
.phase__head { grid-column: 1 / -1; display: flex; gap: var(--sp-3); align-items: baseline; flex-wrap: wrap; }
.phase__head .n { font-family: var(--font-mono); font-size: var(--fs-12); color: var(--color-brand-text); letter-spacing: .08em; border: 1px solid var(--color-brand-muted); padding: 2px 8px; }
.phase__head h3 { margin: 0; font-size: var(--fs-24); font-weight: 500; }
.phase__head .goal { width: 100%; color: var(--color-text-muted); max-width: 70ch; }
.phase h4 { margin: 0 0 var(--sp-2); }
.phase ul { padding-left: 1.1em; list-style: disc; font-size: var(--fs-14); }
.phase li { margin-bottom: 4px; }
.phase li::marker { color: var(--color-brand); }
.phase .exit { grid-column: 1 / -1; border-top: 1px dashed var(--color-border); padding-top: var(--sp-3); font-size: var(--fs-14); }
.phase .exit b { font-family: var(--font-mono); font-size: 11px; letter-spacing: .06em; text-transform: uppercase; color: var(--color-proto-text); margin-right: var(--sp-2); }

/* Checklist */
.check { list-style: none; padding: 0; max-width: 72ch; margin: var(--sp-3) 0 var(--sp-5); }
.check li { display: grid; grid-template-columns: 20px 1fr; gap: var(--sp-3); padding: 8px 0; border-bottom: 1px dashed var(--color-border-subtle); font-size: var(--fs-14); }
.check li::before { content: ""; width: 14px; height: 14px; border: 1px solid var(--color-border-strong); margin-top: 4px; background: linear-gradient(135deg, transparent 45%, var(--color-brand) 45%, var(--color-brand) 55%, transparent 55%) no-repeat center / 0 0; }
.check li.done::before { background-size: 100% 100%; }
.check li b { font-weight: 500; }
.check li small { display: block; color: var(--color-text-subtle); font-family: var(--font-mono); font-size: 11px; margin-top: 2px; }

/* Callout */
.callout { border-left: 3px solid var(--color-brand); background: var(--color-brand-subtle); padding: var(--sp-3) var(--sp-4); margin: var(--sp-4) 0; font-size: var(--fs-14); max-width: 72ch; }
.callout b { font-family: var(--font-mono); font-size: 11px; letter-spacing: .06em; text-transform: uppercase; display: block; margin-bottom: 4px; color: var(--color-brand-text); }

/* Annotation language demo */
.anno-demo { position: relative; height: 220px; border: 1px solid var(--color-border-strong); background: var(--color-bg-elevated); margin: var(--sp-7) 0 var(--sp-5); }
.anno-demo .wf-box { position: absolute; }

@media (max-width: 960px) {
  .doc { grid-template-columns: 1fr; gap: var(--sp-5); }
  .doc__nav { position: static; max-height: none; display: flex; flex-wrap: wrap; gap: 4px; padding-bottom: var(--sp-4); border-bottom: 1px dashed var(--color-border); }
  .doc__nav p { width: 100%; margin: var(--sp-3) 0 4px; }
  .doc__nav a { border: 1px solid var(--color-border); border-radius: var(--radius-1); font-size: var(--fs-13); }
  .swatches { grid-template-columns: repeat(6, 1fr); }
  .semantic-grid, .phase, .dodont { grid-template-columns: 1fr; }
  .specimen { grid-template-columns: 1fr; gap: var(--sp-2); }
}
@media (max-width: 520px) { .swatches { grid-template-columns: repeat(4, 1fr); } }

/* Mobile safety: never let content widen the layout viewport */
.doc__body { min-width: 0; }
.doc__body pre { max-width: 100%; }
@media (max-width: 960px) {
  .doc { grid-template-columns: minmax(0, 1fr); }
  .doc__nav { min-width: 0; }
}
@media (max-width: 640px) {
  .table { display: block; overflow-x: auto; -webkit-overflow-scrolling: touch; }
  .table th, .table td { min-width: 120px; }
  .showcase { padding-inline: var(--sp-4); }
  .anatomy { margin-right: 0; max-width: 100%; }
}
@media (max-width: 960px) {
  .doc__body { overflow-x: clip; }
}
@media (max-width: 640px) {
  .anno-demo { overflow: hidden; }
}
