/**
 * Core concepts — docs shell (Resources / Core concepts).
 *
 * Reference register: narrow measure, left section nav, prev/next, no hero, no CTA.
 * Type recipes reuse product-overview: eyebrow (Label) · h2 (category name) ·
 * h3 (feature name) · body (proof paragraph) · lead (Body large). Tokens only.
 *
 * Load after styles-v2.css. Shared by every core-concepts/<slug>/index.html.
 * Page-specific figures use the .fig-* recipes below; add new ones here, not inline.
 *
 * Headings on these pages are complete sentences with a named doer (owner ruling, 2026-09-05).
 *
 * SSOT §4.39. Layout widths that are not a --space-* step live as recipe
 * vars on .page-docs — do not add a fifth space token for them.
 */

/* Docs shell — Resources / Core concepts. Reference register: narrow measure,
   left section nav, prev/next, no hero, no CTA. Type recipes reuse the
   product-overview page: eyebrow (Label), h2 (category name), h3 (feature name),
   body (proof paragraph), lead (Body large). Tokens only. */
.page-docs {
    --docs-shell-max: 1240px;
    --docs-rail: 220px;
    --docs-measure: 720px;
    --docs-term-col: 180px;
    --docs-nav-pad-y: 5px;
    --docs-def-rule: 3px;
    --docs-fig-project-border: 1.5px;
    --docs-fig-label-offset: 10px;
    --docs-fig-label-pad-y: 2px;
    --docs-fig-tight: 6px;
    --docs-fig-icon: 12px;
    --docs-chain-pad-x: 10px;
    --docs-region-min-height: 96px;
    background: var(--white);
    color: var(--marketing-body-color);
}
.docs-shell {
    max-width: var(--docs-shell-max);
    margin: 0 auto;
    padding: calc(var(--space-16) + var(--space-6)) var(--space-6) var(--space-16);
    display: grid;
    grid-template-columns: var(--docs-rail) minmax(0, 1fr);
    gap: var(--space-12);
    align-items: start;
}
/* Same measure as .docs-shell — global .container is 1200px and would shift the logo off the rail. */
.page-docs .navbar .container {
    max-width: var(--docs-shell-max);
}
/* Label recipe — .m-eyebrow (marketing-subpage.css:31) */
.docs-label {
    font-size: var(--font-size-label);
    font-weight: var(--font-weight-semibold);
    line-height: 1.4;
    letter-spacing: var(--letter-spacing-overline-wide);
    text-transform: uppercase;
}
.docs-nav { position: sticky; top: calc(var(--space-16) + var(--space-4)); font-size: var(--font-size-body-sm); }
.docs-nav__section { margin: 0 0 var(--space-3); color: var(--cyan-600); }
.docs-nav__group { margin: var(--space-5) 0 var(--space-2); color: var(--marketing-text-muted); }
.docs-nav__list { list-style: none; margin: 0; padding: 0; border-left: 1px solid var(--marketing-border-color); }
.docs-nav__link { display: block; padding: var(--docs-nav-pad-y) var(--space-3); margin-left: -1px; border-left: 2px solid transparent; color: var(--marketing-text-secondary); text-decoration: none; line-height: 1.35; }
a.docs-nav__link:hover { color: var(--marketing-text-primary); border-left-color: var(--slate-300); }
.docs-nav__link.is-current { color: var(--marketing-text-primary); font-weight: var(--font-weight-semibold); border-left-color: var(--cyan-500); }
.docs-nav__link.is-unpublished { color: var(--slate-400); }

/* Body — product-overview proof paragraph (font-size-body, regular, 1.7) */
.docs-main { max-width: var(--docs-measure); min-width: 0; font-size: var(--font-size-body); font-weight: var(--font-weight-regular); line-height: 1.7; color: var(--marketing-body-color); }
.docs-crumbs { margin: 0 0 var(--space-4); font-size: var(--font-size-caption); color: var(--marketing-text-muted); }
.docs-main .docs-crumbs a { color: var(--marketing-text-muted); text-decoration: none; }
.docs-main .docs-crumbs a:hover { color: var(--marketing-text-primary); text-decoration: underline; }
.docs-crumbs span { margin: 0 var(--space-2); color: var(--slate-300); }
/* H1 — hero weight and tracking at the h1 token size */
.docs-main h1 { margin: 0 0 var(--space-3); font-family: var(--font-display); font-size: var(--font-size-h1); font-weight: var(--marketing-hero-font-weight); letter-spacing: var(--marketing-hero-letter-spacing); line-height: var(--marketing-hero-line-height); color: var(--marketing-hero-color); }
/* Lead — .m-lead (Body large) */
.docs-def { margin: var(--space-2) 0 var(--space-6); padding: var(--space-4) var(--space-5); border-left: var(--docs-def-rule) solid var(--cyan-500); background: var(--slate-50); border-radius: 0 var(--radius-sm) var(--radius-sm) 0; }
.docs-def p { margin: 0; font-size: var(--font-size-body-lg); font-weight: var(--font-weight-regular); line-height: 1.6; color: var(--slate-700); }
.docs-def dfn { font-style: normal; font-weight: var(--font-weight-semibold); color: var(--marketing-text-primary); }
.docs-meta { display: flex; flex-wrap: wrap; gap: var(--space-2) var(--space-6); margin: var(--space-3) 0 0; padding-top: var(--space-3); border-top: 1px solid var(--marketing-border-color); font-size: var(--font-size-caption); color: var(--marketing-text-muted); }
.docs-meta strong { font-weight: var(--font-weight-semibold); color: var(--marketing-text-secondary); }
/* H2 — .m-af-category-name token match (class stays page-local on product-overview) */
.docs-main h2 { margin: var(--space-10) 0 var(--space-3); padding-top: var(--space-2); font-size: var(--font-size-h2); font-weight: var(--font-weight-semibold); line-height: 1.3; letter-spacing: var(--letter-spacing-tight); color: var(--marketing-text-primary); }
/* H3 — .m-af-feature-name scale only (that class is white on dark cards) */
.docs-main h3 { margin: var(--space-6) 0 var(--space-2); font-size: var(--font-size-h4); font-weight: var(--font-weight-semibold); line-height: 1.45; color: var(--marketing-text-primary); }
.docs-main p { margin: 0 0 var(--space-4); }
.docs-main a { color: var(--cyan-600); text-decoration: none; }
.docs-main a:hover { text-decoration: underline; }
.docs-note { margin: var(--space-4) 0; padding: var(--space-3) var(--space-4); border: 1px solid var(--marketing-border-color); border-radius: var(--radius-sm); font-size: var(--font-size-body-sm); line-height: 1.6; color: var(--marketing-text-secondary); }
.docs-note strong { color: var(--marketing-text-primary); font-weight: var(--font-weight-semibold); }

.docs-table { width: 100%; border-collapse: collapse; margin: var(--space-3) 0 var(--space-6); font-size: var(--font-size-body-sm); line-height: 1.5; }
.docs-table th, .docs-table td { text-align: left; vertical-align: top; padding: var(--space-2) var(--space-3); border-bottom: 1px solid var(--marketing-border-color); }
.docs-table th { font-size: var(--font-size-label); font-weight: var(--font-weight-semibold); letter-spacing: var(--letter-spacing-overline-wide); text-transform: uppercase; color: var(--marketing-text-muted); border-bottom: 1px solid var(--slate-300); }
.docs-table td:first-child { font-weight: var(--font-weight-semibold); color: var(--marketing-text-primary); }

.docs-dl { margin: 0 0 var(--space-6); }
.docs-dl div { display: grid; grid-template-columns: var(--docs-term-col) 1fr; gap: var(--space-4); padding: var(--space-3) 0; border-bottom: 1px solid var(--marketing-border-color); }
.docs-dl dt { font-weight: var(--font-weight-semibold); color: var(--marketing-text-primary); font-size: var(--font-size-body-sm); }
.docs-dl dd { margin: 0; font-size: var(--font-size-body-sm); line-height: 1.5; }

.docs-prevnext { display: flex; justify-content: space-between; gap: var(--space-4); margin-top: var(--space-12); padding-top: var(--space-6); border-top: 1px solid var(--marketing-border-color); font-size: var(--font-size-body-sm); }
.docs-prevnext a { color: var(--cyan-600); text-decoration: none; }
.docs-prevnext a:hover { text-decoration: underline; }
.docs-prevnext span { color: var(--slate-400); }
.docs-prevnext small { display: block; font-size: var(--font-size-caption); color: var(--marketing-text-muted); }

/* Figure 1 — structure, not a screen. Monochrome; the project boundary is the only accent. */
.docs-figure { margin: var(--space-4) 0 var(--space-8); }
.fig-canvas {
    padding: var(--space-6);
    background-color: var(--slate-50);
    background-image: radial-gradient(var(--slate-200) 1px, transparent 1px);
    background-size: var(--space-4) var(--space-4);
    border: 1px solid var(--slate-200);
    border-radius: var(--radius-md);
}
.fig-project { position: relative; background: var(--white); border: var(--docs-fig-project-border) solid var(--cyan-500); border-radius: var(--radius-sm); padding: var(--space-6) var(--space-4) var(--space-4); }
.fig-project__label { position: absolute; top: calc(var(--docs-fig-label-offset) * -1); left: var(--space-4); padding: var(--docs-fig-label-pad-y) var(--space-2); background: var(--white); font-size: var(--font-size-label); font-weight: var(--font-weight-semibold); letter-spacing: var(--letter-spacing-overline-wide); text-transform: uppercase; color: var(--cyan-600); }
.fig-project__label span { text-transform: none; letter-spacing: 0; font-size: var(--font-size-caption); font-weight: var(--font-weight-medium); color: var(--marketing-text-secondary); }
.fig-cols { display: grid; grid-template-columns: 1fr 1fr; gap: var(--space-4); }
.fig-group { border: 1px solid var(--slate-300); border-radius: var(--radius-xs); padding: var(--space-3); background: var(--white); }
.fig-group--wide { margin-top: var(--space-4); }
.fig-group__title { margin: 0 0 var(--space-2); font-size: var(--font-size-label); font-weight: var(--font-weight-semibold); letter-spacing: var(--letter-spacing-overline-wide); text-transform: uppercase; color: var(--marketing-text-secondary); }
.fig-row { display: flex; align-items: center; justify-content: space-between; gap: var(--space-3); padding: var(--docs-fig-tight) var(--space-2); border: 1px solid var(--slate-200); border-radius: var(--radius-2xs); background: var(--slate-50); }
.fig-row + .fig-row { margin-top: var(--docs-fig-tight); }
.fig-row__main { min-width: 0; display: flex; flex-direction: column; }
.fig-row__name { font-size: var(--font-size-caption); font-weight: var(--font-weight-semibold); color: var(--marketing-text-primary); }
.fig-row__meta { font-size: var(--font-size-label); color: var(--slate-500); line-height: 1.3; }
.fig-row__carried { display: inline-flex; gap: var(--docs-fig-tight); flex-shrink: 0; color: var(--slate-400); }
.fig-row__carried svg { width: var(--docs-fig-icon); height: var(--docs-fig-icon); }
.fig-row__ref { flex-shrink: 0; font-size: var(--font-size-label); color: var(--slate-500); }
.fig-key { display: flex; flex-wrap: wrap; gap: var(--space-2) var(--space-5); margin: var(--space-3) 0 0; font-size: var(--font-size-caption); color: var(--slate-500); }
.fig-key span { display: inline-flex; align-items: center; gap: var(--docs-nav-pad-y); }
.fig-key svg { width: var(--docs-fig-icon); height: var(--docs-fig-icon); color: var(--slate-400); }
.docs-figure figcaption { margin-top: var(--space-2); font-size: var(--font-size-caption); color: var(--slate-500); }
.docs-figure figcaption strong { font-weight: var(--font-weight-semibold); color: var(--slate-600); }

.docs-footer { border-top: 1px solid var(--slate-200); padding: var(--space-6); font-size: var(--font-size-caption); color: var(--slate-500); }
.docs-footer .container { display: flex; flex-wrap: wrap; justify-content: space-between; gap: var(--space-3); }
.docs-footer a { color: var(--slate-500); text-decoration: none; margin-left: var(--space-4); }
.docs-footer a:hover { color: var(--slate-900); text-decoration: underline; }

.docs-nav__section { list-style: none; cursor: default; }
.docs-nav__section::-webkit-details-marker { display: none; }
@media (max-width: 760px) {
    .docs-shell { grid-template-columns: minmax(0, 1fr); gap: var(--space-6); padding-top: var(--space-16); }
    .docs-main { min-width: 0; max-width: 100%; }
    .docs-nav { min-width: 0; }
    .docs-table { display: block; overflow-x: auto; }
    .docs-table thead, .docs-table tbody, .docs-table tr { display: table; width: 100%; table-layout: fixed; }
    .docs-nav { position: static; padding: var(--space-3) var(--space-4); border: 1px solid var(--slate-200); border-radius: var(--radius-sm); }
    .docs-nav__section { cursor: pointer; margin: 0; }
    .docs-nav__section::after { content: "Show"; float: right; font-weight: var(--font-weight-medium); letter-spacing: 0; text-transform: none; color: var(--cyan-600); }
    .docs-nav__details[open] .docs-nav__section::after { content: "Hide"; }
    .docs-dl div { grid-template-columns: 1fr; gap: var(--space-1); }
    .fig-cols { grid-template-columns: 1fr; }
}

/* Figure — status chain. One row per chain; states in order; dashed = terminal. */
.fig-lane { margin: 0 0 var(--space-4); }
.fig-lane:last-child { margin-bottom: 0; }
.fig-lane__title { margin: 0 0 var(--space-2); font-size: var(--font-size-label); font-weight: var(--font-weight-semibold); letter-spacing: var(--letter-spacing-overline-wide); text-transform: uppercase; color: var(--marketing-text-secondary); }
.fig-chain { display: flex; flex-wrap: wrap; align-items: center; gap: var(--docs-fig-tight); margin: 0; padding: 0; list-style: none; }
.fig-chain__state { display: inline-block; padding: var(--space-1) var(--docs-chain-pad-x); border: 1px solid var(--slate-300); border-radius: var(--radius-2xs); background: var(--white); font-size: var(--font-size-caption); font-weight: var(--font-weight-semibold); color: var(--marketing-text-primary); white-space: nowrap; }
.fig-chain__state--end { border-style: dashed; color: var(--marketing-text-secondary); }
.fig-chain__state--accent { border-color: var(--cyan-500); }
.fig-chain__arrow { color: var(--slate-400); font-size: var(--font-size-caption); }
.fig-chain__branch { flex-basis: 100%; height: 0; }
.fig-chain__note { margin: var(--space-2) 0 0; font-size: var(--font-size-caption); color: var(--marketing-text-muted); }

/* Figure — labelled regions (a screen's regions as boxes, not a screenshot). */
.fig-regions { display: grid; grid-template-columns: 1fr 1fr 1fr; gap: var(--space-3); }
.fig-region { border: 1px solid var(--slate-300); border-radius: var(--radius-xs); background: var(--white); padding: var(--space-3); min-height: var(--docs-region-min-height); }
.fig-region--wide { grid-column: 1 / -1; }
.fig-region__title { margin: 0 0 var(--space-1); font-size: var(--font-size-label); font-weight: var(--font-weight-semibold); letter-spacing: var(--letter-spacing-overline-wide); text-transform: uppercase; color: var(--marketing-text-secondary); }
.fig-region__body { margin: 0; font-size: var(--font-size-caption); line-height: 1.4; color: var(--marketing-text-secondary); }
@media (max-width: 720px) { .fig-regions { grid-template-columns: 1fr; } }

/* Tour invite — Home landing only. Layout from .docs-note; CTA is .btn-primary from styles-v2.css. */
.cc-tour-banner {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    justify-content: space-between;
    gap: var(--space-3) var(--space-4);
    margin: 0 0 var(--space-4);
    padding: var(--space-3) var(--space-4);
    border: 1px solid var(--marketing-border-color);
    border-radius: var(--radius-sm);
    background: var(--slate-50);
    font-size: var(--font-size-body-sm);
    line-height: 1.6;
    color: var(--marketing-text-secondary);
}
.cc-tour-banner p { margin: 0; flex: 1; min-width: 0; }
.cc-tour-banner a.btn-primary {
    flex-shrink: 0;
    color: var(--white);
    text-decoration: none;
}
.cc-tour-banner a.btn-primary:hover {
    color: var(--white);
    text-decoration: none;
}

/* UI snippet (DSE spec 885-core-concepts-ui-snippet): one real app screen, drawn with the app's shared recipes
   (.side-nav, .tabs/.tab, .btn, .card, .data-table, .kebab-btn from kuhlman-components.css via styles-v2.css).
   This frame sets layout only, from tokens, and never restyles a recipe class (design-overrides gate): tabs,
   table cells and buttons paint as board J1b-profile-tasks.html draws them (.kb-table cells). The figure is narrower than the app's 900px rail breakpoint, so the
   rail sits on top, as the app draws it (kuhlman-components.css .side-nav @media max-width 900px). */
.fig-ui { position: relative; margin: 0; border: 1px solid var(--border-color); border-radius: var(--radius-md); background: var(--white); overflow: hidden; font-size: var(--font-size-body-sm); line-height: 1.5; text-align: left; }
.fig-ui .side-nav { border-right: 0; border-bottom: 1px solid var(--border-color); padding: var(--space-2) 0; }
.fig-ui__main { min-width: 0; padding: var(--space-5); }
.fig-ui__head { display: flex; align-items: flex-start; justify-content: space-between; gap: var(--space-4); margin: 0 0 var(--space-3); }
.fig-ui .fig-ui__title { margin: 0 0 var(--space-1); font-size: var(--font-size-h3); font-weight: var(--font-weight-bold); line-height: 1.3; color: var(--text-primary); }
.fig-ui .fig-ui__sub { margin: 0; font-size: var(--font-size-body-sm); line-height: 1.5; color: var(--text-secondary); }
.fig-ui__actions { display: flex; flex-shrink: 0; gap: var(--space-3); white-space: nowrap; }
.fig-ui .data-table-wrapper { overflow-x: auto; white-space: nowrap; }
@media (max-width: 760px) {
    .fig-ui__main { padding: var(--space-4); }
    .fig-ui__head { flex-direction: column; }
}
