/* ==========================================================================
   Tomatico UI Style Guide — guide.css

   Chrome for the documentation site only: the shell, sidebar, example
   frames, swatches and code blocks. Nothing here is part of the Tomatico
   UI system — that lives in tomatico-ui.css.
   ========================================================================== */

:root {
  --guide-sidebar: 17.5rem;
  --guide-header: 4rem;
  --guide-toc: 14rem;
}

/* --------------------------------------------------------------------------
   Shell
   -------------------------------------------------------------------------- */
.guide {
  min-block-size: 100vh;
  display: flex;
  flex-direction: column;
}

.guide__header {
  position: sticky;
  inset-block-start: 0;
  z-index: var(--tmt-layer-nav);
}

.guide__header .tmt-masthead__inner {
  max-width: none;
  padding-inline: var(--tmt-space-4);
}

.guide__version {
  font-family: var(--tmt-font-mono);
  font-size: var(--tmt-size-caption);
  color: var(--tmt-grey-300);
  padding-inline: var(--tmt-space-2);
  padding-block: 0.125rem;
  border: var(--tmt-border-hairline) solid var(--tmt-grey-700);
  border-radius: var(--tmt-radius-sm);
}

.guide__body {
  display: flex;
  flex: 1;
  align-items: flex-start;
}

/* --------------------------------------------------------------------------
   Sidebar
   -------------------------------------------------------------------------- */
.guide__sidebar {
  flex: none;
  inline-size: var(--guide-sidebar);
  position: sticky;
  inset-block-start: var(--guide-header);
  block-size: calc(100vh - var(--guide-header));
  overflow-y: auto;
  padding-block: var(--tmt-space-5) var(--tmt-space-8);
  padding-inline: var(--tmt-space-4);
  border-inline-end: var(--tmt-border-hairline) solid var(--tmt-border);
  background-color: var(--tmt-surface);
}

.guide__sidebar-search {
  margin-block-end: var(--tmt-space-4);
}

.guide__nav-group + .guide__nav-group {
  margin-block-start: var(--tmt-space-2);
}

.guide__nav-list {
  list-style: none;
  margin: 0;
  padding: 0;
}

.guide__nav-link {
  display: block;
  padding-inline: var(--tmt-space-3);
  padding-block: var(--tmt-space-2);
  border-inline-start: var(--tmt-space-1) solid transparent;
  border-radius: 0 var(--tmt-radius-sm) var(--tmt-radius-sm) 0;
  color: var(--tmt-text-secondary);
  font-size: var(--tmt-size-small);
  line-height: var(--tmt-leading-small);
  text-decoration: none;
}

.guide__nav-link:hover {
  background-color: var(--tmt-interactive-subtle);
  color: var(--tmt-text);
  text-decoration: none;
}

.guide__nav-link[aria-current="page"] {
  background-color: var(--tmt-interactive-subtle);
  border-inline-start-color: var(--tmt-interactive);
  color: var(--tmt-text);
  font-weight: var(--tmt-weight-semibold);
}

.guide__nav-link[hidden] {
  display: none;
}

.guide__sidebar-toggle {
  display: none;
}

/* --------------------------------------------------------------------------
   Main + table of contents
   -------------------------------------------------------------------------- */
.guide__main {
  flex: 1;
  min-inline-size: 0;
  display: flex;
  gap: var(--tmt-space-6);
  align-items: flex-start;
  padding-inline: var(--tmt-space-6);
  padding-block: var(--tmt-space-7) var(--tmt-space-9);
}

.guide__article {
  flex: 1;
  min-inline-size: 0;
  max-inline-size: 56rem;
}

.guide__toc {
  flex: none;
  inline-size: var(--guide-toc);
  position: sticky;
  inset-block-start: calc(var(--guide-header) + var(--tmt-space-6));
  font-size: var(--tmt-size-small);
}

.guide__toc-title {
  font-size: var(--tmt-size-caption);
  font-weight: var(--tmt-weight-semibold);
  letter-spacing: var(--tmt-tracking-wide);
  text-transform: uppercase;
  color: var(--tmt-text-muted);
  margin-block-end: var(--tmt-space-3);
}

.guide__toc-list {
  list-style: none;
  margin: 0;
  padding: 0;
  border-inline-start: var(--tmt-border-hairline) solid var(--tmt-border);
}

.guide__toc-list a {
  display: block;
  padding-inline-start: var(--tmt-space-3);
  padding-block: var(--tmt-space-1);
  color: var(--tmt-text-muted);
  text-decoration: none;
  border-inline-start: var(--tmt-border-thick) solid transparent;
  margin-inline-start: -1px;
}

.guide__toc-list a:hover,
.guide__toc-list a.is-active {
  color: var(--tmt-text);
  border-inline-start-color: var(--tmt-interactive);
}

/* --------------------------------------------------------------------------
   Page furniture
   -------------------------------------------------------------------------- */
.guide__eyebrow {
  color: var(--tmt-text-muted);
}

.guide__title {
  margin-block: var(--tmt-space-2) var(--tmt-space-4);
}

.guide__summary {
  max-inline-size: var(--tmt-measure);
  margin-block-end: var(--tmt-space-7);
}

.guide-section {
  margin-block-start: var(--tmt-space-8);
  scroll-margin-block-start: calc(var(--guide-header) + var(--tmt-space-4));
}

.guide-section > :is(h2, h3) {
  margin-block-end: var(--tmt-space-3);
}

.guide-section p,
.guide-section ul,
.guide-section ol {
  max-inline-size: var(--tmt-measure);
}

.guide-section p {
  margin-block: 0 var(--tmt-space-4);
}

.guide-section ul,
.guide-section ol {
  margin-block: 0 var(--tmt-space-4);
  padding-inline-start: var(--tmt-space-5);
}

.guide-section li + li {
  margin-block-start: var(--tmt-space-2);
}

.guide-note {
  border-inline-start: var(--tmt-space-1) solid var(--tmt-border-strong);
  padding-inline-start: var(--tmt-space-4);
  padding-block: var(--tmt-space-1);
  margin-block: var(--tmt-space-5);
  color: var(--tmt-text-secondary);
  font-size: var(--tmt-size-small);
  line-height: var(--tmt-leading-small);
  max-inline-size: var(--tmt-measure);
}

.guide-note strong {
  color: var(--tmt-text);
}

/* --------------------------------------------------------------------------
   Example frames
   -------------------------------------------------------------------------- */
.guide-example {
  margin-block: var(--tmt-space-4) var(--tmt-space-6);
  border: var(--tmt-border-hairline) solid var(--tmt-border);
  border-radius: var(--tmt-radius-surface);
  overflow: hidden;
  background-color: var(--tmt-surface);
}

.guide-example__stage {
  padding: var(--tmt-space-6);
  background-color: var(--tmt-surface);
  background-image:
    linear-gradient(45deg, var(--tmt-surface-sunken) 25%, transparent 25%),
    linear-gradient(-45deg, var(--tmt-surface-sunken) 25%, transparent 25%),
    linear-gradient(45deg, transparent 75%, var(--tmt-surface-sunken) 75%),
    linear-gradient(-45deg, transparent 75%, var(--tmt-surface-sunken) 75%);
  background-size: 16px 16px;
  background-position: 0 0, 0 8px, 8px -8px, -8px 0;
}

.guide-example__stage > * {
  position: relative;
}

.guide-example__stage--plain {
  background-image: none;
  background-color: var(--tmt-surface);
}

.guide-example__stage--dark {
  background-image: none;
  background-color: var(--tmt-black);
  color: var(--tmt-white);
}

.guide-example__bar {
  display: flex;
  align-items: center;
  gap: var(--tmt-space-2);
  padding-inline: var(--tmt-space-4);
  padding-block: var(--tmt-space-2);
  border-block-start: var(--tmt-border-hairline) solid var(--tmt-border);
  background-color: var(--tmt-surface-sunken);
}

.guide-example__label {
  font-size: var(--tmt-size-caption);
  letter-spacing: var(--tmt-tracking-wide);
  text-transform: uppercase;
  color: var(--tmt-text-muted);
  margin-inline-end: auto;
}

.guide-example__code {
  margin: 0;
  padding: var(--tmt-space-4);
  border-block-start: var(--tmt-border-hairline) solid var(--tmt-border);
  background-color: var(--tmt-grey-900);
  color: var(--tmt-grey-100);
  font-family: var(--tmt-font-mono);
  font-size: var(--tmt-size-caption);
  line-height: 1.6;
  overflow-x: auto;
  tab-size: 2;
}

.guide-example__code[hidden] {
  display: none;
}

.guide-example__code code {
  font: inherit;
  white-space: pre;
}

/* Toolbar buttons in the example bar */
.guide-chip {
  appearance: none;
  display: inline-flex;
  align-items: center;
  gap: var(--tmt-space-1);
  padding-inline: var(--tmt-space-3);
  padding-block: 0.25rem;
  border: var(--tmt-border-hairline) solid var(--tmt-border);
  border-radius: var(--tmt-radius-pill);
  background-color: var(--tmt-surface);
  color: var(--tmt-text-secondary);
  font-size: var(--tmt-size-caption);
  font-family: inherit;
  cursor: pointer;
}

.guide-chip:hover {
  border-color: var(--tmt-border-strong);
  color: var(--tmt-text);
}

.guide-chip[aria-pressed="true"] {
  background-color: var(--tmt-interactive);
  border-color: var(--tmt-interactive);
  color: var(--tmt-interactive-text);
}

/* --------------------------------------------------------------------------
   Do / Don't
   -------------------------------------------------------------------------- */
.guide-dos {
  display: grid;
  gap: var(--tmt-space-4);
  grid-template-columns: repeat(auto-fit, minmax(min(20rem, 100%), 1fr));
  margin-block: var(--tmt-space-4) var(--tmt-space-6);
}

.guide-do {
  padding: var(--tmt-space-4);
  border: var(--tmt-border-hairline) solid var(--tmt-border);
  border-block-start: var(--tmt-space-1) solid var(--tmt-success);
  border-radius: var(--tmt-radius-md);
  font-size: var(--tmt-size-small);
  line-height: var(--tmt-leading-small);
}

.guide-dont {
  border-block-start-color: var(--tmt-error);
}

.guide-do__title {
  display: flex;
  align-items: center;
  gap: var(--tmt-space-2);
  font-weight: var(--tmt-weight-semibold);
  color: var(--tmt-success);
  margin-block-end: var(--tmt-space-3);
  font-size: var(--tmt-size-caption);
  letter-spacing: var(--tmt-tracking-wide);
  text-transform: uppercase;
}

.guide-dont .guide-do__title {
  color: var(--tmt-error);
}

.guide-do ul {
  margin: 0;
  padding-inline-start: var(--tmt-space-5);
  max-inline-size: none;
}

/* --------------------------------------------------------------------------
   Colour swatches
   -------------------------------------------------------------------------- */
.guide-swatches {
  display: grid;
  gap: var(--tmt-space-4);
  grid-template-columns: repeat(auto-fit, minmax(min(11rem, 100%), 1fr));
  margin-block: var(--tmt-space-4) var(--tmt-space-6);
}

.guide-swatch {
  border: var(--tmt-border-hairline) solid var(--tmt-border);
  border-radius: var(--tmt-radius-md);
  overflow: hidden;
}

.guide-swatch__chip {
  block-size: 6rem;
  border-block-end: var(--tmt-border-hairline) solid var(--tmt-border);
}

.guide-swatch__meta {
  padding: var(--tmt-space-3);
  font-size: var(--tmt-size-caption);
  line-height: var(--tmt-leading-caption);
}

.guide-swatch__name {
  display: block;
  font-weight: var(--tmt-weight-semibold);
  font-size: var(--tmt-size-small);
  color: var(--tmt-text);
  margin-block-end: var(--tmt-space-1);
}

.guide-swatch__hex {
  display: block;
  font-family: var(--tmt-font-mono);
  color: var(--tmt-text-secondary);
  text-transform: uppercase;
}

.guide-swatch__token {
  display: block;
  font-family: var(--tmt-font-mono);
  color: var(--tmt-text-muted);
  overflow-wrap: anywhere;
}

.guide-swatch__role {
  display: block;
  margin-block-start: var(--tmt-space-2);
  color: var(--tmt-text-muted);
}

/* Ramp strip used for the neutral scale */
.guide-ramp {
  display: flex;
  border-radius: var(--tmt-radius-md);
  overflow: hidden;
  border: var(--tmt-border-hairline) solid var(--tmt-border);
  margin-block: var(--tmt-space-4);
}

.guide-ramp__step {
  flex: 1;
  min-inline-size: 0;
  padding-block: var(--tmt-space-6) var(--tmt-space-2);
  padding-inline: var(--tmt-space-2);
  font-family: var(--tmt-font-mono);
  font-size: 0.625rem;
  text-align: center;
  overflow: hidden;
}

/* --------------------------------------------------------------------------
   Type specimens
   -------------------------------------------------------------------------- */
.guide-specimen {
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: var(--tmt-space-2);
  padding-block: var(--tmt-space-4);
  border-block-end: var(--tmt-border-hairline) solid var(--tmt-border-subtle);
}

@media (min-width: 56rem) {
  .guide-specimen {
    grid-template-columns: minmax(0, 1fr) 16rem;
    align-items: baseline;
    gap: var(--tmt-space-5);
  }
}

.guide-specimen__spec {
  font-family: var(--tmt-font-mono);
  font-size: var(--tmt-size-caption);
  line-height: 1.7;
  color: var(--tmt-text-muted);
}

.guide-specimen__sample {
  min-inline-size: 0;
  overflow-wrap: anywhere;
}

/* --------------------------------------------------------------------------
   Spec / token tables
   -------------------------------------------------------------------------- */
.guide-table {
  inline-size: 100%;
  border-collapse: collapse;
  font-size: var(--tmt-size-small);
  margin-block: var(--tmt-space-4) var(--tmt-space-6);
}

.guide-table :is(th, td) {
  padding-inline: var(--tmt-space-3);
  padding-block: var(--tmt-space-2);
  text-align: start;
  vertical-align: top;
  border-block-end: var(--tmt-border-hairline) solid var(--tmt-border-subtle);
}

.guide-table thead th {
  font-size: var(--tmt-size-caption);
  letter-spacing: var(--tmt-tracking-wide);
  text-transform: uppercase;
  color: var(--tmt-text-muted);
  border-block-end: var(--tmt-border-hairline) solid var(--tmt-border-strong);
  white-space: nowrap;
}

.guide-table code {
  font-family: var(--tmt-font-mono);
  font-size: 0.8125rem;
  overflow-wrap: anywhere;
}

.guide-table__wrap {
  overflow-x: auto;
}

/* --------------------------------------------------------------------------
   Cards on the home page
   -------------------------------------------------------------------------- */
.guide-home-hero {
  padding-block: var(--tmt-space-8);
  padding-inline: var(--tmt-space-6);
  margin-block-end: var(--tmt-space-7);
  border: var(--tmt-border-hairline) solid var(--tmt-border);
  border-radius: var(--tmt-radius-xl);
}

.guide-home-hero__logo {
  block-size: 5rem;
  inline-size: auto;
  margin-block-end: var(--tmt-space-5);
}

[data-tmt-theme="dark"] .guide-home-hero__logo--light { display: none; }
[data-tmt-theme="light"] .guide-home-hero__logo--dark { display: none; }
:root:not([data-tmt-theme="dark"]) .guide-home-hero__logo--dark { display: none; }

.guide-index-grid {
  display: grid;
  gap: var(--tmt-space-4);
  grid-template-columns: repeat(auto-fit, minmax(min(16rem, 100%), 1fr));
  margin-block: var(--tmt-space-4) var(--tmt-space-6);
}

.guide-index-card {
  display: flex;
  flex-direction: column;
  gap: var(--tmt-space-1);
  padding: var(--tmt-space-4);
  border: var(--tmt-border-hairline) solid var(--tmt-border);
  border-radius: var(--tmt-radius-md);
  text-decoration: none;
  color: var(--tmt-text);
  transition: border-color var(--tmt-duration-fast) var(--tmt-ease);
}

.guide-index-card:hover {
  border-color: var(--tmt-border-strong);
  color: var(--tmt-text);
  text-decoration: none;
}

.guide-index-card__title {
  font-weight: var(--tmt-weight-semibold);
}

.guide-index-card__desc {
  font-size: var(--tmt-size-small);
  line-height: var(--tmt-leading-small);
  color: var(--tmt-text-muted);
}

/* --------------------------------------------------------------------------
   Asset / download grids
   -------------------------------------------------------------------------- */
.guide-asset-grid {
  display: grid;
  gap: var(--tmt-space-4);
  grid-template-columns: repeat(auto-fit, minmax(min(14rem, 100%), 1fr));
  margin-block: var(--tmt-space-4) var(--tmt-space-6);
}

.guide-asset {
  border: var(--tmt-border-hairline) solid var(--tmt-border);
  border-radius: var(--tmt-radius-md);
  overflow: hidden;
}

.guide-asset__preview {
  display: grid;
  place-items: center;
  min-block-size: 9rem;
  padding: var(--tmt-space-5);
  background-color: var(--tmt-white);
}

.guide-asset__preview--dark {
  background-color: var(--tmt-black);
}

.guide-asset__preview img {
  max-block-size: 5rem;
  inline-size: auto;
}

.guide-asset__meta {
  padding: var(--tmt-space-3);
  border-block-start: var(--tmt-border-hairline) solid var(--tmt-border);
  font-size: var(--tmt-size-caption);
  line-height: var(--tmt-leading-caption);
}

.guide-asset__name {
  display: block;
  font-size: var(--tmt-size-small);
  font-weight: var(--tmt-weight-medium);
  margin-block-end: var(--tmt-space-1);
}

/* --------------------------------------------------------------------------
   Page footer + next/prev
   -------------------------------------------------------------------------- */
.guide__pager {
  display: flex;
  flex-wrap: wrap;
  gap: var(--tmt-space-4);
  justify-content: space-between;
  margin-block-start: var(--tmt-space-8);
  padding-block-start: var(--tmt-space-5);
  border-block-start: var(--tmt-border-hairline) solid var(--tmt-border);
}

.guide__pager a {
  display: flex;
  flex-direction: column;
  gap: var(--tmt-space-1);
  text-decoration: none;
  font-size: var(--tmt-size-small);
}

.guide__pager a:last-child {
  text-align: end;
  margin-inline-start: auto;
}

.guide__pager-label {
  font-size: var(--tmt-size-caption);
  letter-spacing: var(--tmt-tracking-wide);
  text-transform: uppercase;
  color: var(--tmt-text-muted);
}

.guide__pager-title {
  font-weight: var(--tmt-weight-medium);
  text-decoration: underline;
  text-underline-offset: 0.2em;
}

.guide__footer {
  border-block-start: var(--tmt-border-hairline) solid var(--tmt-border);
  padding-block: var(--tmt-space-5);
  background-color: var(--tmt-surface-sunken);
}

.guide__footer-inner {
  display: flex;
  flex-wrap: wrap;
  gap: var(--tmt-space-4);
  align-items: center;
  justify-content: space-between;
  padding-inline: var(--tmt-space-6);
  font-size: var(--tmt-size-caption);
  color: var(--tmt-text-muted);
}

/* --------------------------------------------------------------------------
   Responsive
   -------------------------------------------------------------------------- */
@media (max-width: 74rem) {
  .guide__toc {
    display: none;
  }
}

@media (max-width: 60rem) {
  .guide__sidebar-toggle {
    display: inline-flex;
  }

  .guide__sidebar {
    position: fixed;
    inset-block: var(--guide-header) 0;
    inset-inline-start: 0;
    z-index: var(--tmt-layer-overlay);
    inline-size: min(20rem, 84vw);
    box-shadow: var(--tmt-shadow-lg);
    transform: translateX(-100%);
    transition: transform var(--tmt-duration-base) var(--tmt-ease);
    block-size: auto;
  }

  [dir="rtl"] .guide__sidebar {
    transform: translateX(100%);
  }

  .guide__sidebar[data-open="true"] {
    transform: translateX(0);
  }

  .guide__main {
    padding-inline: var(--tmt-space-4);
    padding-block-start: var(--tmt-space-6);
  }

  .guide__scrim {
    position: fixed;
    inset-block: var(--guide-header) 0;
    inset-inline: 0;
    z-index: var(--tmt-layer-sticky);
    background-color: var(--tmt-overlay);
    border: 0;
    padding: 0;
  }

  .guide__scrim[hidden] {
    display: none;
  }
}

@media (max-width: 48rem) {
  /* The version chip is reference information, not navigation — it is the
     first thing to go when the bar runs out of room. */
  .guide__version {
    display: none;
  }
}

@media (max-width: 40rem) {
  :root {
    /* The 48px display size is too large for small screens; step it down
       without changing the token contract. */
    --tmt-size-h1: 2.25rem;
    --tmt-leading-h1: 2.75rem;
    --tmt-size-h2: 1.75rem;
    --tmt-leading-h2: 2.25rem;
  }

  .guide-home-hero {
    padding-inline: var(--tmt-space-4);
  }
}

@media print {
  .guide__sidebar,
  .guide__toc,
  .guide__header,
  .guide__pager,
  .guide-example__bar {
    display: none !important;
  }

  .guide__main {
    padding: 0;
  }
}