/* ============================================================================
   Shared reference-table scaffolding
   Used by /references/spectrum/, /references/cmd-cheat-sheet/, and any future
   big-table reference page. Provides the sticky controls strip, scrollable
   wrapper with sticky thead + sticky first column (via `.is-sticky-col`
   hook), generic legend, badge base, and the `.cell-collapse` family.

   Per-page CSS files layer on top of this with column widths, palette
   modifiers, and scoping under `.reference-page--<name>`.

   Uses site-wide CSS variables (--c-bg, --c-surface, --c-text, --c-accent…)
   from assets/css/style.css, so dark/light theme switching is automatic.
   ========================================================================== */

.reference-page {
  padding: var(--space-2xl) 0 var(--space-3xl);
}

.reference-container {
  max-width: 100rem;
  margin: 0 auto;
  padding: 0 var(--space-lg);
}

/* ---- Hero ---- */
.reference-hero { margin-bottom: var(--space-xl); }
.reference-hero__eyebrow {
  text-transform: uppercase;
  letter-spacing: 0.14em;
  font-size: 0.75rem;
  color: var(--c-accent);
  margin: 0 0 var(--space-sm);
  font-weight: 600;
}
.reference-hero__title {
  font-size: clamp(1.75rem, 1.4rem + 1.5vw, 2.75rem);
  margin: 0 0 var(--space-md);
  line-height: 1.15;
  color: var(--c-text);
}
.reference-hero__lede {
  font-size: 1.05rem;
  line-height: 1.65;
  color: var(--c-text);
  margin: 0 0 var(--space-md);
  max-width: 60rem;
}
.reference-hero__howto {
  font-size: 0.95rem;
  color: var(--c-text-muted);
  margin: 0 0 var(--space-lg);
  max-width: 60rem;
}
.reference-hero__howto strong { color: var(--c-text); }
.reference-hero__meta {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-md);
  font-size: 0.85rem;
  color: var(--c-text-muted);
}
.reference-hero__meta-item strong {
  color: var(--c-accent);
  font-variant-numeric: tabular-nums;
}

/* ---- Controls (tabs + search) ---- */
.reference-controls {
  display: flex;
  flex-wrap: nowrap;
  gap: var(--space-md);
  align-items: center;
  margin-bottom: var(--space-md);
  position: sticky;
  top: var(--header-height, 3.75rem);
  z-index: 10;
  background: linear-gradient(to bottom,
    rgba(var(--c-bg-rgb), 0.97) 0%,
    rgba(var(--c-bg-rgb), 0.97) 70%,
    rgba(var(--c-bg-rgb), 0) 100%);
  padding: var(--space-sm) 0 var(--space-md);
  backdrop-filter: blur(6px);
}
.reference-tabs {
  display: flex;
  flex-wrap: nowrap;
  gap: 0.4rem;
  flex: 1 1 auto;
  min-width: 0;
  overflow-x: auto;
  overflow-y: hidden;
  scrollbar-width: thin;
  scrollbar-color: var(--c-border) transparent;
  padding-bottom: 2px;
  -webkit-overflow-scrolling: touch;
}
.reference-tabs::-webkit-scrollbar { height: 4px; }
.reference-tabs::-webkit-scrollbar-thumb {
  background: var(--c-border);
  border-radius: 999px;
}
.reference-tabs::-webkit-scrollbar-track { background: transparent; }
.reference-tab {
  appearance: none;
  border: 1px solid var(--c-border);
  background: var(--c-surface);
  color: var(--c-text-muted);
  padding: 0.4rem 0.8rem;
  border-radius: 999px;
  font: inherit;
  font-size: 0.82rem;
  font-weight: 500;
  cursor: pointer;
  flex-shrink: 0;
  transition: background var(--transition-fast),
              color var(--transition-fast),
              border-color var(--transition-fast),
              transform var(--transition-fast);
  white-space: nowrap;
}
.reference-tab:hover {
  color: var(--c-text);
  border-color: var(--c-accent-border);
  background: var(--c-surface-alt);
}
.reference-tab.is-active {
  background: var(--c-accent-bg);
  color: var(--c-accent);
  border-color: var(--c-accent-border);
}
.reference-tab:focus-visible {
  outline: 2px solid var(--c-accent);
  outline-offset: 2px;
}

.reference-search {
  position: relative;
  display: flex;
  align-items: center;
  gap: var(--space-sm);
  background: var(--c-surface);
  border: 1px solid var(--c-border);
  border-radius: var(--border-radius);
  padding: 0.3rem 0.65rem;
  flex: 0 1 14rem;
  min-width: 0;
  max-width: 18rem;
  transition: border-color var(--transition-fast),
              box-shadow var(--transition-fast);
}
.reference-search:focus-within {
  border-color: var(--c-accent-border);
  box-shadow: 0 0 0 3px var(--c-accent-bg);
}
.reference-search__icon {
  display: inline-flex;
  color: var(--c-text-faint);
  flex-shrink: 0;
}
.reference-search__icon svg { width: 1rem; height: 1rem; }
.reference-search input {
  flex: 1;
  background: transparent;
  border: 0;
  outline: 0;
  color: var(--c-text);
  font: inherit;
  font-size: 0.9rem;
  padding: 0.15rem 0;
  min-width: 0;
}
.reference-search input::placeholder { color: var(--c-text-faint); }
.reference-search__count {
  font-size: 0.75rem;
  color: var(--c-text-faint);
  font-variant-numeric: tabular-nums;
  white-space: nowrap;
}

/* ---- Active-batch blurb ---- */
.reference-batch-blurb {
  background: var(--c-surface);
  border: 1px solid var(--c-border);
  border-left: 3px solid var(--c-accent);
  border-radius: var(--border-radius);
  padding: var(--space-md) var(--space-lg);
  margin-bottom: var(--space-md);
  font-size: 0.9rem;
  color: var(--c-text-muted);
}
.reference-batch-blurb strong {
  display: block;
  color: var(--c-text);
  margin-bottom: 0.25rem;
  font-size: 0.95rem;
}

/* ---- Table ---- */
/* The wrapper is the scroll container for both axes (`overflow: auto` plus
   a `max-height` cap), AND is itself `position: sticky` so it pins to the
   page viewport below the header + controls bar. The thead inside is
   `position: sticky; top: 0` relative to the wrapper, so once the wrapper
   pins, the thead visually pins to the viewport just below the pills. */
.reference-table-wrapper {
  position: sticky;
  top: calc(var(--header-height, 3.75rem) + 3.25rem);
  max-height: calc(100vh - var(--header-height, 3.75rem) - 4.25rem);
  overflow: auto;
  border: 1px solid var(--c-border);
  border-radius: var(--border-radius);
  background: var(--c-surface);
  box-shadow: 0 4px 16px var(--c-card-shadow);
}
.reference-table-wrapper:focus-visible {
  outline: 2px solid var(--c-accent);
  outline-offset: 2px;
}

.reference-table {
  width: 100%;
  border-collapse: separate;
  border-spacing: 0;
  font-size: 0.875rem;
  color: var(--c-text);
}

.reference-table thead th {
  position: sticky;
  top: 0;
  z-index: 2;
  background: var(--c-surface-alt);
  color: var(--c-text);
  text-align: left;
  font-weight: 600;
  font-size: 0.78rem;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  padding: 1.15rem 1rem 0.95rem;
  border-bottom: 2px solid var(--c-border);
  white-space: normal;
  box-shadow: 0 2px 6px var(--c-card-shadow);
}

.reference-table tbody td {
  padding: 0.85rem 1rem;
  vertical-align: top;
  border-bottom: 1px solid var(--c-border-light);
  line-height: 1.5;
}

.reference-table tbody tr:hover td {
  background: var(--c-surface-alt);
}

.reference-table tbody tr:last-child td {
  border-bottom: 0;
}

/* Sticky first column — any column marked `.is-sticky-col` stays pinned
   during horizontal scroll. */
.reference-table td.is-sticky-col,
.reference-table th.is-sticky-col {
  position: sticky;
  left: 0;
  z-index: 1;
  border-right: 1px solid var(--c-border);
  background: var(--c-surface);
}
.reference-table tbody tr:hover td.is-sticky-col {
  background: var(--c-surface-alt);
}
.reference-table thead th.is-sticky-col {
  z-index: 3;
  background: var(--c-surface-alt);
}

/* ---- Monospace cell helper ---- */
.mono {
  font-family: var(--f-mono);
  font-size: 0.825rem;
  color: var(--c-text);
  font-variant-numeric: tabular-nums;
}

/* ---- Collapsible cells (`<details class="cell-collapse">`) ---- */
.cell-collapse {
  font-size: inherit;
}
.cell-collapse > summary {
  list-style: none;
  cursor: pointer;
  display: inline-flex;
  align-items: baseline;
  gap: 0.5rem;
  flex-wrap: wrap;
  color: var(--c-text);
  user-select: none;
}
.cell-collapse > summary::-webkit-details-marker { display: none; }
.cell-collapse > summary::marker { display: none; content: ""; }
.cell-collapse__count {
  font-variant-numeric: tabular-nums;
  font-weight: 600;
  color: var(--c-accent);
}
.cell-collapse__label {
  color: var(--c-text-muted);
}
.cell-collapse__preview {
  color: var(--c-text);
  font-size: 0.85rem;
  line-height: 1.45;
}
.cell-collapse__more {
  font-size: 0.75rem;
  color: var(--c-accent);
  text-decoration: underline;
  text-underline-offset: 2px;
  text-decoration-thickness: 1px;
  flex-shrink: 0;
}
.cell-collapse[open] > summary .cell-collapse__more::after { content: " (collapse)"; }
.cell-collapse[open] > summary .cell-collapse__preview { display: none; }
.cell-collapse[open] > summary .cell-collapse__count,
.cell-collapse[open] > summary .cell-collapse__label { opacity: 0.6; }

.cell-list {
  margin: 0.6rem 0 0;
  padding-left: 1.1rem;
}
.cell-list li {
  margin: 0.15rem 0;
  line-height: 1.5;
}
.cell-prose {
  margin-top: 0.6rem;
  line-height: 1.6;
  color: var(--c-text);
}
.cell-empty {
  color: var(--c-text-faint);
  font-style: italic;
}

/* Empty-state when filters match nothing */
.reference-empty {
  text-align: center;
  padding: var(--space-xl);
  color: var(--c-text-muted);
  font-size: 0.95rem;
}

/* ---- Legend (color-coded swatches) ---- */
.reference-legend__list {
  list-style: none;
  margin: var(--space-md) 0;
  padding: 0;
  display: flex;
  flex-wrap: wrap;
  gap: 0.75rem;
  font-size: 0.95em;
}
.reference-legend__list > li {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  color: var(--c-text);
}
.reference-legend__swatch {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: 0.15rem 0.55rem;
  border-radius: 4px;
  line-height: 1;
  color: #ffffff;
  background: var(--swatch-bg, var(--c-surface-alt));
}

/* ---- Generic badge base (per-page palettes layer modifiers on top) ---- */
.reference-badge {
  display: inline-block;
  padding: 0.15rem 0.55rem;
  border-radius: 4px;
  background: var(--c-surface-alt);
  border: 1px solid var(--c-border);
  font-size: 0.95em;
  white-space: nowrap;
}

/* Small screens — generic responsive stack + opt-in mobile snap behaviour. */
@media (max-width: 640px) {
  .reference-container { padding: 0 var(--space-md); }
  .reference-controls {
    flex-direction: column;
    align-items: stretch;
    gap: 0.4rem;
    padding: 0.4rem 0;
    margin-bottom: 0.4rem;
  }
  .reference-search { max-width: 100%; flex: 1 1 auto; }

  .reference-table-wrapper {
    top: calc(var(--header-height, 3.75rem) + 5.25rem);
    max-height: calc(100vh - var(--header-height, 3.75rem) - 6.25rem);
  }
  .reference-table thead th { padding: 0.95rem 0.6rem 0.7rem; }
  .reference-table tbody td { padding: 0.65rem 0.6rem; overflow-wrap: anywhere; }

  /* Opt-in mobile snap: pages add `.has-snap-cols` on the wrapper to get
     column-by-column scroll snapping. Useful for very wide tables. */
  .reference-table-wrapper.has-snap-cols {
    scroll-snap-type: x mandatory;
  }
  .reference-table-wrapper.has-snap-cols .reference-table thead th:not(.is-sticky-col),
  .reference-table-wrapper.has-snap-cols .reference-table tbody td:not(.is-sticky-col) {
    scroll-snap-align: start;
    scroll-snap-stop: always;
  }
  .reference-table td.is-sticky-col,
  .reference-table th.is-sticky-col {
    box-shadow: 6px 0 6px -4px rgba(0, 0, 0, 0.45);
  }
}

/* Reduced motion */
@media (prefers-reduced-motion: reduce) {
  .reference-tab,
  .reference-search { transition: none; }
}