/* ==========================================================================
   Cayuse Design System — Documentation site chrome
   --------------------------------------------------------------------------
   This file styles the DOCUMENTATION ONLY. It is not part of the component
   library and should never be shipped into a product. Product teams consume
   tokens.css + components.css.

   Structure borrowed deliberately:
   - IBM Carbon      — persistent left nav, dense spec tables, monospaced code,
                       square corners, a live example above its markup.
   - GOV.UK          — plain-language "When to use / When not to use", short
                       measure, strong contrast, guidance before ornament.
   ========================================================================== */

*, *::before, *::after { box-sizing: border-box; }

html { scroll-behavior: smooth; }

body {
  margin: 0;
  background-color: var(--color-white);
  color: var(--container-text);
  font-family: var(--font-family-primary);
  font-size: var(--font-size-16);
  line-height: 1.5;
  -webkit-font-smoothing: antialiased;
}

.docs-mono {
  font-family: "IBM Plex Mono", "SF Mono", Menlo, Consolas, monospace;
}


/* ==========================================================================
   LAYOUT
   ========================================================================== */

.docs-masthead {
  position: sticky;
  top: 0;
  z-index: 40;
  display: flex;
  align-items: center;
  gap: var(--spacing-16);
  height: 48px;
  padding: 0 var(--spacing-16);
  background-color: var(--color-blue-500);
  color: var(--color-white);
}
.docs-masthead__title {
  font-size: var(--font-size-16);
  font-weight: var(--font-weight-bold);
  letter-spacing: 0.01em;
  text-decoration: none;
  color: inherit;
  white-space: nowrap;
}
.docs-masthead__title span {
  font-weight: var(--font-weight-regular);
  opacity: 0.75;
}
.docs-masthead__spacer { flex: 1 1 auto; }
.docs-masthead__meta {
  font-size: var(--font-size-12);
  opacity: 0.75;
  white-space: nowrap;
}
.docs-masthead__figma {
  color: var(--color-white);
  font-size: var(--font-size-12);
  text-decoration: underline;
  text-underline-offset: 2px;
  white-space: nowrap;
}

.docs-navtoggle {
  display: none;
  appearance: none;
  border: var(--border-width-1) solid rgb(255 255 255 / 40%);
  background: transparent;
  color: inherit;
  border-radius: var(--radius-3);
  padding: var(--spacing-4) var(--spacing-8);
  font: inherit;
  font-size: var(--font-size-12);
  cursor: pointer;
}

.docs-shell {
  display: grid;
  grid-template-columns: 280px minmax(0, 1fr);
  align-items: start;
}


/* ==========================================================================
   SIDE NAVIGATION
   ========================================================================== */

.docs-sidenav {
  position: sticky;
  top: 48px;
  height: calc(100vh - 48px);
  overflow-y: auto;
  border-right: var(--border-width-1) solid var(--color-gray-300);
  background-color: var(--color-gray-100);
  padding: var(--spacing-16) 0 var(--spacing-48);
  scrollbar-width: thin;
  scrollbar-color: var(--color-gray-300) transparent;
}
.docs-sidenav__search {
  padding: 0 var(--spacing-16) var(--spacing-12);
}
.docs-sidenav__search input {
  width: 100%;
  height: 32px;
  padding: 0 var(--spacing-8);
  border: var(--border-width-1) solid var(--color-gray-400);
  border-radius: var(--radius-3);
  background-color: var(--color-white);
  font-family: inherit;
  font-size: var(--font-size-14);
  color: var(--container-text);
}
.docs-sidenav__search input:focus-visible {
  outline: var(--border-width-2) solid var(--focus-ring);
  outline-offset: 1px;
}
.docs-sidenav__group {
  margin-bottom: var(--spacing-8);
}
.docs-sidenav__grouptitle {
  margin: 0;
  padding: var(--spacing-12) var(--spacing-16) var(--spacing-4);
  font-size: var(--font-size-12);
  font-weight: var(--font-weight-bold);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--color-gray-500);
}
.docs-sidenav__list {
  list-style: none;
  margin: 0;
  padding: 0;
}
.docs-sidenav__link {
  display: block;
  padding: var(--spacing-6) var(--spacing-16);
  border-left: var(--border-width-3) solid transparent;
  color: var(--container-text);
  font-size: var(--font-size-14);
  line-height: var(--line-height-20);
  text-decoration: none;
}
.docs-sidenav__link:hover {
  background-color: var(--color-gray-200);
}
.docs-sidenav__link:focus-visible {
  outline: var(--border-width-2) solid var(--focus-ring);
  outline-offset: -2px;
}
.docs-sidenav__link[aria-current="page"] {
  background-color: var(--color-white);
  border-left-color: var(--primary-brand-color);
  color: var(--primary-brand-color);
  font-weight: var(--font-weight-bold);
}
.docs-sidenav__link.is-hidden { display: none; }
.docs-sidenav__group.is-hidden { display: none; }
.docs-sidenav__empty {
  display: none;
  padding: var(--spacing-12) var(--spacing-16);
  color: var(--color-gray-500);
  font-size: var(--font-size-14);
}
.docs-sidenav.is-empty .docs-sidenav__empty { display: block; }


/* ==========================================================================
   MAIN CONTENT
   ========================================================================== */

.docs-main {
  min-width: 0;
  padding: var(--spacing-32) var(--spacing-32) var(--spacing-48);
}
.docs-content { max-width: 900px; }

.docs-eyebrow {
  margin: 0 0 var(--spacing-4);
  font-size: var(--font-size-12);
  font-weight: var(--font-weight-bold);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--primary-brand-color);
}
.docs-title {
  margin: 0 0 var(--spacing-12);
  font-size: var(--font-size-42);
  line-height: 1.1;
  font-weight: var(--font-weight-bold);
  letter-spacing: -0.02em;
}
.docs-lede {
  margin: 0 0 var(--spacing-24);
  max-width: 68ch;
  font-size: var(--font-size-20);
  line-height: 1.5;
  color: var(--color-gray-500);
}
.docs-figma-link {
  display: inline-flex;
  align-items: center;
  gap: var(--spacing-8);
  margin-bottom: var(--spacing-32);
  padding: var(--spacing-6) var(--spacing-12);
  border: var(--border-width-1) solid var(--color-gray-300);
  border-radius: var(--radius-3);
  background-color: var(--color-gray-100);
  color: var(--container-text);
  font-size: var(--font-size-12);
  text-decoration: none;
}
.docs-figma-link:hover { border-color: var(--primary-brand-color); }
.docs-figma-link strong { color: var(--primary-brand-color); }

.docs-section {
  margin: 0 0 var(--spacing-48);
  padding-top: var(--spacing-8);
}
.docs-h2 {
  margin: 0 0 var(--spacing-12);
  padding-bottom: var(--spacing-8);
  border-bottom: var(--border-width-1) solid var(--color-gray-300);
  font-size: var(--font-size-24);
  line-height: 1.3;
  font-weight: var(--font-weight-bold);
}
.docs-h3 {
  margin: var(--spacing-32) 0 var(--spacing-8);
  font-size: var(--font-size-18);
  line-height: 1.4;
  font-weight: var(--font-weight-bold);
}
.docs-content p {
  margin: 0 0 var(--spacing-16);
  max-width: 72ch;
  font-size: var(--font-size-16);
  line-height: 1.6;
}
.docs-content ul, .docs-content ol {
  margin: 0 0 var(--spacing-16);
  padding-left: var(--spacing-24);
  max-width: 72ch;
}
.docs-content li { margin-bottom: var(--spacing-6); line-height: 1.6; }
.docs-content a { color: var(--link-default); text-underline-offset: 2px; }
.docs-content code:not(pre code) {
  padding: 1px var(--spacing-4);
  background-color: var(--color-gray-100);
  border: var(--border-width-1) solid var(--color-gray-200);
  border-radius: var(--radius-2);
  font-family: "IBM Plex Mono", "SF Mono", Menlo, Consolas, monospace;
  font-size: 0.875em;
}


/* ==========================================================================
   EXAMPLE BLOCK  (live canvas + markup)
   ========================================================================== */

.docs-example {
  margin: 0 0 var(--spacing-24);
  border: var(--border-width-1) solid var(--color-gray-300);
  border-radius: var(--radius-3);
  overflow: hidden;
  background-color: var(--color-white);
}
.docs-example__caption {
  padding: var(--spacing-8) var(--spacing-16);
  border-bottom: var(--border-width-1) solid var(--color-gray-200);
  background-color: var(--color-gray-100);
  font-size: var(--font-size-12);
  font-weight: var(--font-weight-bold);
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--color-gray-500);
}
.docs-example__canvas {
  padding: var(--spacing-24);
  background-color: var(--color-white);
  background-image:
    linear-gradient(var(--color-gray-100) 1px, transparent 1px),
    linear-gradient(90deg, var(--color-gray-100) 1px, transparent 1px);
  background-size: 4px 4px;   /* the 4pt grid, faintly */
  overflow-x: auto;
}
.docs-example__canvas--plain { background-image: none; }
.docs-example__row {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: var(--spacing-16);
}
.docs-example__col {
  display: flex;
  flex-direction: column;
  align-items: flex-start;   /* stop buttons stretching to full width */
  gap: var(--spacing-16);
}
/* Children that are genuinely full-width opt in */
.docs-example__col > .cds-field,
.docs-example__col > .cds-banner,
.docs-example__col > .docs-example__stage,
.docs-example__col > .docs-guidance,
.docs-example__col > .cds-dropzone { align-self: stretch; }

.docs-example__stage {
  position: relative;
  min-height: 360px;
  border: var(--border-width-1) dashed var(--color-gray-300);
  border-radius: var(--radius-3);
  overflow: hidden;
  background-color: var(--color-gray-100);
}

.docs-example__code {
  border-top: var(--border-width-1) solid var(--color-gray-200);
}
.docs-example__codebar {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--spacing-8);
  padding: var(--spacing-4) var(--spacing-8) var(--spacing-4) var(--spacing-16);
  background-color: var(--color-gray-100);
  border-bottom: var(--border-width-1) solid var(--color-gray-200);
}
.docs-example__codelabel {
  font-size: var(--font-size-12);
  color: var(--color-gray-500);
  font-family: "IBM Plex Mono", "SF Mono", Menlo, Consolas, monospace;
}
.docs-copy {
  appearance: none;
  border: var(--border-width-1) solid var(--color-gray-300);
  background-color: var(--color-white);
  border-radius: var(--radius-3);
  padding: var(--spacing-2) var(--spacing-8);
  font-family: inherit;
  font-size: var(--font-size-12);
  color: var(--container-text);
  cursor: pointer;
}
.docs-copy:hover { border-color: var(--primary-brand-color); color: var(--primary-brand-color); }
.docs-copy:focus-visible { outline: var(--border-width-2) solid var(--focus-ring); outline-offset: 1px; }
.docs-copy.is-copied { border-color: var(--success-border); color: var(--success-text); }

.docs-example pre {
  margin: 0;
  padding: var(--spacing-16);
  overflow-x: auto;
  background-color: #1b1b1b;
  color: #f2f2f2;
  font-family: "IBM Plex Mono", "SF Mono", Menlo, Consolas, monospace;
  font-size: var(--font-size-12);
  line-height: 1.7;
  tab-size: 2;
}
.docs-example pre .t { color: #8fd0ff; }   /* tag      */
.docs-example pre .a { color: #ffd479; }   /* attribute*/
.docs-example pre .s { color: #b8e6a0; }   /* string   */
.docs-example pre .c { color: #8a8a8a; }   /* comment  */


/* ==========================================================================
   GUIDANCE  (GOV.UK style)
   ========================================================================== */

.docs-guidance {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
  gap: var(--spacing-16);
  margin: 0 0 var(--spacing-24);
}
.docs-guidance__card {
  padding: var(--spacing-16);
  border-left: var(--border-width-3) solid var(--color-gray-300);
  background-color: var(--color-gray-100);
}
.docs-guidance__card h3 {
  margin: 0 0 var(--spacing-8);
  font-size: var(--font-size-16);
  font-weight: var(--font-weight-bold);
}
.docs-guidance__card ul { margin: 0; padding-left: var(--spacing-20); }
.docs-guidance__card li { font-size: var(--font-size-14); line-height: 1.6; }
.docs-guidance__card--do  { border-left-color: var(--success-border); background-color: var(--success-background); }
.docs-guidance__card--dont{ border-left-color: var(--error-border);   background-color: var(--error-background); }

.docs-callout {
  margin: 0 0 var(--spacing-24);
  padding: var(--spacing-16);
  border-left: var(--border-width-3) solid var(--primary-brand-color);
  background-color: var(--color-blue-100);
  font-size: var(--font-size-14);
  line-height: 1.6;
}
.docs-callout p:last-child { margin-bottom: 0; }
.docs-callout--warning {
  border-left-color: var(--color-yellow-300);
  background-color: var(--color-yellow-200);
}
.docs-callout--a11y {
  border-left-color: var(--color-green-500);
  background-color: var(--color-green-100);
}
.docs-callout__title {
  display: block;
  margin-bottom: var(--spacing-4);
  font-weight: var(--font-weight-bold);
  font-size: var(--font-size-12);
  letter-spacing: 0.06em;
  text-transform: uppercase;
}


/* ==========================================================================
   TABLES  (spec / props / tokens)
   ========================================================================== */

.docs-table-wrap { overflow-x: auto; margin: 0 0 var(--spacing-24); }
.docs-table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--font-size-14);
}
.docs-table th {
  padding: var(--spacing-8) var(--spacing-12);
  background-color: var(--color-gray-100);
  border-bottom: var(--border-width-2) solid var(--color-gray-300);
  text-align: left;
  font-weight: var(--font-weight-bold);
  white-space: nowrap;
}
.docs-table td {
  padding: var(--spacing-8) var(--spacing-12);
  border-bottom: var(--border-width-1) solid var(--color-gray-200);
  vertical-align: top;
  line-height: 1.5;
}
.docs-table code {
  font-family: "IBM Plex Mono", "SF Mono", Menlo, Consolas, monospace;
  font-size: var(--font-size-12);
  white-space: nowrap;
}
.docs-table tr:hover td { background-color: var(--color-gray-100); }


/* ==========================================================================
   TOKEN & SWATCH DISPLAY
   ========================================================================== */

.docs-swatch-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(180px, 1fr));
  gap: var(--spacing-12);
  margin: 0 0 var(--spacing-24);
}
.docs-swatch {
  border: var(--border-width-1) solid var(--color-gray-300);
  border-radius: var(--radius-3);
  overflow: hidden;
}
.docs-swatch__chip { height: 64px; }
.docs-swatch__meta { padding: var(--spacing-8); background-color: var(--color-white); }
.docs-swatch__name {
  display: block;
  font-family: "IBM Plex Mono", "SF Mono", Menlo, Consolas, monospace;
  font-size: var(--font-size-12);
  word-break: break-all;
}
.docs-swatch__hex {
  display: block;
  margin-top: var(--spacing-2);
  color: var(--color-gray-500);
  font-size: var(--font-size-12);
  text-transform: uppercase;
}
.docs-swatch__ratio {
  display: inline-block;
  margin-top: var(--spacing-4);
  padding: 0 var(--spacing-4);
  border-radius: var(--radius-2);
  font-size: var(--font-size-12);
  font-weight: var(--font-weight-bold);
}
.docs-swatch__ratio--pass { background-color: var(--success-background); color: var(--success-text); }
.docs-swatch__ratio--fail { background-color: var(--error-background);   color: var(--error-text); }

.docs-spacing-row {
  display: flex;
  align-items: center;
  gap: var(--spacing-16);
  padding: var(--spacing-4) 0;
}
.docs-spacing-row__bar {
  height: 16px;
  background-color: var(--primary-brand-color);
  border-radius: var(--radius-2);
}
.docs-spacing-row__label {
  font-family: "IBM Plex Mono", "SF Mono", Menlo, Consolas, monospace;
  font-size: var(--font-size-12);
  white-space: nowrap;
  min-width: 160px;
}


/* ==========================================================================
   STATE MATRIX  (interactive pinned-state display)
   ========================================================================== */

.docs-matrix {
  display: grid;
  gap: var(--spacing-16);
  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
}
.docs-matrix__cell {
  display: flex;
  flex-direction: column;
  align-items: flex-start;
  gap: var(--spacing-8);
  padding: var(--spacing-12);
  border: var(--border-width-1) solid var(--color-gray-200);
  border-radius: var(--radius-3);
  background-color: var(--color-white);
}
.docs-matrix__label {
  font-family: "IBM Plex Mono", "SF Mono", Menlo, Consolas, monospace;
  font-size: var(--font-size-12);
  color: var(--color-gray-500);
}

.docs-note {
  margin: calc(var(--spacing-8) * -1) 0 var(--spacing-16);
  font-size: var(--font-size-12);
  color: var(--color-gray-500);
}

/* Revision marker for descriptions rewritten from the original Figma text */
.docs-revised {
  margin: 0 0 var(--spacing-24);
  border: var(--border-width-1) solid var(--color-gray-300);
  border-radius: var(--radius-3);
  background-color: var(--color-white);
  font-size: var(--font-size-14);
}
.docs-revised > summary {
  padding: var(--spacing-8) var(--spacing-12);
  cursor: pointer;
  color: var(--color-gray-500);
  font-size: var(--font-size-12);
  list-style: none;
}
.docs-revised > summary::-webkit-details-marker { display: none; }
.docs-revised > summary::before { content: "▸ "; }
.docs-revised[open] > summary::before { content: "▾ "; }
.docs-revised > summary:hover { color: var(--primary-brand-color); }
.docs-revised__body {
  padding: 0 var(--spacing-12) var(--spacing-12);
  border-top: var(--border-width-1) solid var(--color-gray-200);
  padding-top: var(--spacing-12);
  color: var(--color-gray-500);
  line-height: 1.6;
}
.docs-revised__body em { color: var(--container-text); font-style: normal; }


/* ==========================================================================
   PAGE FOOTER NAV
   ========================================================================== */

.docs-pagenav {
  display: flex;
  justify-content: space-between;
  gap: var(--spacing-16);
  margin-top: var(--spacing-48);
  padding-top: var(--spacing-16);
  border-top: var(--border-width-1) solid var(--color-gray-300);
  font-size: var(--font-size-14);
}
.docs-pagenav a { color: var(--link-default); text-decoration: none; }
.docs-pagenav a:hover { text-decoration: underline; }
.docs-pagenav__dir { display: block; font-size: var(--font-size-12); color: var(--color-gray-500); }


/* ==========================================================================
   OVERVIEW CARDS (index page)
   ========================================================================== */

.docs-cardgrid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  gap: var(--spacing-16);
  margin: 0 0 var(--spacing-32);
}
.docs-card {
  display: flex;
  flex-direction: column;
  gap: var(--spacing-4);
  padding: var(--spacing-16);
  border: var(--border-width-1) solid var(--color-gray-300);
  border-radius: var(--radius-3);
  background-color: var(--color-white);
  color: inherit;
  text-decoration: none;
}
.docs-card:hover {
  border-color: var(--primary-brand-color);
  box-shadow: 0 2px 8px rgb(17 17 17 / 8%);
}
.docs-card__title { font-weight: var(--font-weight-bold); color: var(--primary-brand-color); }
.docs-card__desc { font-size: var(--font-size-14); color: var(--color-gray-500); line-height: 1.5; }

.docs-stat-row {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
  gap: var(--spacing-16);
  margin: 0 0 var(--spacing-32);
}
.docs-stat {
  padding: var(--spacing-16);
  border-left: var(--border-width-3) solid var(--primary-brand-color);
  background-color: var(--color-gray-100);
}
.docs-stat__value {
  display: block;
  font-size: var(--font-size-32);
  line-height: 1.1;
  font-weight: var(--font-weight-bold);
  color: var(--primary-brand-color);
}
.docs-stat__label {
  display: block;
  margin-top: var(--spacing-4);
  font-size: var(--font-size-12);
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--color-gray-500);
}


/* ==========================================================================
   RESPONSIVE
   ========================================================================== */

@media (max-width: 900px) {
  .docs-shell { grid-template-columns: minmax(0, 1fr); }
  .docs-navtoggle { display: inline-block; }
  .docs-sidenav {
    display: none;
    position: static;
    height: auto;
    max-height: 70vh;
    border-right: 0;
    border-bottom: var(--border-width-1) solid var(--color-gray-300);
  }
  .docs-sidenav.is-open { display: block; }
  .docs-main { padding: var(--spacing-24) var(--spacing-16) var(--spacing-48); }
  .docs-title { font-size: var(--font-size-32); }
  .docs-lede { font-size: var(--font-size-18); }
}

@media print {
  .docs-masthead, .docs-sidenav, .docs-copy, .docs-pagenav { display: none; }
  .docs-shell { grid-template-columns: 1fr; }
  .docs-example pre { background-color: #fff; color: #000; border: 1px solid #ccc; }
}