/* Field reference page. Builds on ../styles.css. */

.ref-main { padding: 48px 0 90px; }
.ref-intro { max-width: 820px; margin-bottom: 40px; }
.ref-intro .lead { margin-bottom: 8px; }

/* Two columns: a table of contents that stays put, and the fields themselves.
   One column below 980px — the TOC collapses into a disclosure at the top. */
.ref-layout {
  display: grid;
  grid-template-columns: 250px minmax(0, 1fr);
  gap: 56px;
  align-items: start;
}
.ref-body { min-width: 0; max-width: 780px; }

/* ---------- table of contents ---------- */
.ref-side { position: sticky; top: 84px; }
.toc-toggle { display: none; }

.toc-panel {
  max-height: calc(100vh - 120px);
  overflow-y: auto;
  overscroll-behavior: contain;
  padding-right: 8px;
  font-size: .88rem;
  scrollbar-width: thin;
}
.toc-title {
  font: 600 .68rem/1 var(--sans); letter-spacing: .08em; text-transform: uppercase;
  color: var(--ink-faint); margin: 0 0 12px;
}
.toc-group { margin-bottom: 22px; }
.toc-group > a {
  display: block; font-family: var(--mono); font-size: .84rem; font-weight: 650;
  color: var(--ink); padding: 4px 0 6px;
}
.toc-list { list-style: none; margin: 0; padding: 0 0 0 2px; border-left: 1px solid var(--line); }
.toc-list a {
  display: flex; align-items: center; gap: 7px;
  padding: 3px 6px 3px 12px; margin-left: -1px;
  border-left: 2px solid transparent;
  color: var(--ink-soft); font-family: var(--mono); font-size: .8rem;
}
.toc-list a > span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.toc-list a:hover { color: var(--ink); text-decoration: none; background: var(--bg-alt); }
.toc-list a[aria-current="true"] {
  color: var(--accent-ink); font-weight: 650;
  border-left-color: var(--accent); background: var(--accent-soft);
}
/* Nesting mirrors the dotted path: location → geo → lat. */
.toc-list a[data-depth="1"] { padding-left: 24px; }
.toc-list a[data-depth="2"] { padding-left: 36px; }
/* Two dots, the same two levels the badges use: a field a minimal valid document cannot
   leave out (accent), and one it can — but then a checker warns (orange). */
.toc-list a.toc-required::after,
.toc-list a.toc-recommended::after {
  content: ""; flex: none;
  width: 5px; height: 5px; border-radius: 50%; background: var(--accent);
}
.toc-list a.toc-recommended::after { background: var(--warn); }

/* A field with subfields folds: the sidebar reads as the ~20 top-level fields, not as every
   leaf of `location`, `organizers` and `offers` at once. The triangle sits in the indent the
   depth padding already leaves free, so folding changes nothing about where a name starts. */
.toc-item { list-style: none; }
.toc-children { list-style: none; margin: 0; padding: 0; }
.toc-item.is-collapsed > .toc-children { display: none; }
.toc-row { position: relative; }
.toc-branch {
  position: absolute; left: 0; top: 50%; transform: translateY(-50%);
  display: flex; align-items: center; justify-content: center;
  width: 13px; height: 16px; padding: 0; margin-left: -1px;
  background: none; border: 0; cursor: pointer; color: var(--ink-faint);
}
.toc-row[data-depth="1"] .toc-branch { left: 12px; }
.toc-row[data-depth="2"] .toc-branch { left: 24px; }
.toc-branch:hover { color: var(--ink); }
.toc-branch::before {
  content: ""; width: 5px; height: 5px;
  border-right: 1.5px solid currentColor; border-bottom: 1.5px solid currentColor;
  transform: rotate(-45deg) translate(-1px, 1px); transition: transform .12s;
}
.toc-branch[aria-expanded="true"]::before { transform: rotate(45deg) translate(-1px, -1px); }
/* How many fields the fold is hiding — shown only while it hides them. */
.toc-count {
  flex: none; padding: 0 2px;
  font-size: .68rem; color: var(--ink-faint); font-variant-numeric: tabular-nums;
}
.toc-item:not(.is-collapsed) > .toc-row .toc-count { visibility: hidden; }

.toc-legend {
  display: flex; align-items: center; gap: 6px;
  margin: 0 0 4px; font-size: .74rem; color: var(--ink-faint);
}
.toc-legend:last-of-type { margin-bottom: 16px; }
.toc-legend::before {
  content: ""; flex: none; width: 5px; height: 5px; border-radius: 50%; background: var(--accent);
}
.toc-legend-recommended::before { background: var(--warn); }
.toc-empty { color: var(--ink-faint); font-size: .85rem; }

/* ---------- sticky toolbar ---------- */
.ref-toolbar {
  position: sticky; top: 64px; z-index: 20;
  display: flex; align-items: center; gap: 14px; flex-wrap: wrap;
  padding: 12px 0;
  background: rgba(255,255,255,.92);
  backdrop-filter: saturate(180%) blur(12px);
  border-bottom: 1px solid var(--line);
}
/* The current schema, in place of a second sticky heading. */
.toolbar-here code {
  font-family: var(--mono); font-size: .76rem; font-weight: 650;
  background: var(--ink); color: #fff; padding: 4px 9px; border-radius: 6px;
}
.toolbar-here:hover { text-decoration: none; }

.toolbar-search { position: relative; flex: 1 1 200px; min-width: 160px; }
.toolbar-search input {
  width: 100%; font: inherit; font-size: .9rem;
  padding: 8px 34px 8px 12px;
  border: 1px solid var(--line); border-radius: 8px; background: #fff; color: var(--ink);
}
.toolbar-search input:focus-visible { outline: 2px solid var(--accent); outline-offset: 1px; border-color: transparent; }
.search-hint {
  position: absolute; right: 9px; top: 50%; transform: translateY(-50%);
  font: 600 .7rem/1 var(--mono); color: var(--ink-faint);
  border: 1px solid var(--line); border-radius: 5px; padding: 3px 6px; background: var(--bg-alt);
}
.toolbar-search input:focus + .search-hint,
.toolbar-search input:not(:placeholder-shown) + .search-hint { display: none; }

.req-toggle {
  display: inline-flex; align-items: center; gap: 6px;
  font-size: .88rem; color: var(--ink-soft); cursor: pointer; user-select: none;
  white-space: nowrap;
}

.req-short { display: none; }

.ref-count { margin: 10px 0 0; font-size: .82rem; color: var(--ink-faint); min-height: 1.2em; }

/* ---------- schema sections ---------- */
/* html sets scroll-padding-top: 80px; these add the sticky toolbar on top of it. */
.ref-schema { margin-top: 36px; scroll-margin-top: 50px; }
.ref-schema h2 { display: flex; align-items: baseline; gap: 4px; flex-wrap: wrap; }
.ref-schema h2 code {
  font-family: var(--mono); font-size: .8em;
  background: var(--ink); color: #fff; padding: 3px 9px; border-radius: 6px;
}
.ref-schema-desc { color: var(--ink-soft); margin-bottom: 24px; }

.field {
  position: relative;
  border: 1px solid var(--line); border-left: 3px solid var(--line);
  border-radius: 0 var(--radius) var(--radius) 0;
  padding: 18px 20px; margin-bottom: 12px; background: #fff;
  scroll-margin-top: 50px;
}
.field-required { border-left-color: var(--accent); }
.field-recommended { border-left-color: var(--warn); }
/* Children of an object sit inside it, visually. */
.field[data-depth="1"] { margin-left: 22px; }
.field[data-depth="2"] { margin-left: 44px; }
.field:target { border-color: var(--accent); box-shadow: 0 0 0 3px var(--accent-soft); }

.field-head { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; margin-bottom: 8px; }
.field-name { font-family: var(--mono); font-size: .95rem; font-weight: 650; color: var(--ink); }
.field-name .path-parent { color: var(--ink-faint); font-weight: 400; }
.field-type { font-family: var(--mono); font-size: .78rem; color: var(--ink-faint); }
.field-req {
  margin-left: auto; font: 600 .68rem/1 var(--sans); letter-spacing: .04em; text-transform: uppercase;
  padding: 4px 8px; border-radius: 999px; white-space: nowrap;
}
.is-required { background: var(--accent-soft); color: var(--accent-ink); }
.is-recommended { background: #fdf3e3; color: var(--warn); cursor: help; }
.is-optional { background: var(--bg-alt); color: var(--ink-faint); }

/* Deep link, revealed on hover/focus — every field is addressable. */
.field-anchor {
  font-family: var(--mono); font-size: .9rem; color: var(--ink-faint);
  opacity: 0; transition: opacity .12s;
}
.field:hover .field-anchor, .field-anchor:focus-visible { opacity: 1; }

.field-desc { margin: 0; color: var(--ink-soft); font-size: .95rem; }
.field-desc code {
  font-family: var(--mono); font-size: .85em;
  background: var(--accent-soft); color: var(--accent-ink); padding: 1px 5px; border-radius: 4px;
}
.field-desc .ref-link { color: var(--accent-ink); text-decoration: underline; text-underline-offset: 2px; }
.field-desc .ref-link:hover { text-decoration: none; }
.field mark { background: #fdf0a8; color: inherit; border-radius: 3px; padding: 0 1px; }

.field-examples { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; margin-top: 12px; }
.field-examples-label {
  font: 600 .7rem/1 var(--sans); letter-spacing: .04em; text-transform: uppercase; color: var(--ink-faint);
}
.field-examples code {
  font-family: var(--mono); font-size: .78rem;
  background: var(--bg-alt); border: 1px solid var(--line); color: var(--ink-soft);
  padding: 4px 8px; border-radius: 6px;
  max-width: 100%; overflow-x: auto; white-space: nowrap;
}

/* An example value doubles as the way into a real document, so it has to look pressable —
   without turning the schema's own examples into something other than what they are. */
.field-example {
  font-family: var(--mono); font-size: .78rem;
  background: var(--bg-alt); border: 1px solid var(--line); color: var(--ink-soft);
  padding: 4px 8px; border-radius: 6px; cursor: pointer;
  max-width: 100%; overflow-x: auto; white-space: nowrap;
}
.field-example:hover { border-color: var(--accent); background: var(--accent-soft); color: var(--accent-ink); }

.field-docs-bar { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; margin-top: 14px; }
.field-docs-toggle {
  border: 1px solid var(--line); background: #fff; color: var(--accent-ink);
  font: 600 .78rem/1 var(--sans); padding: 7px 12px; border-radius: 999px; cursor: pointer;
}
.field-docs-toggle:hover { border-color: var(--accent); background: var(--accent-soft); }
.field-docs-toggle[aria-expanded="true"] { background: var(--accent-soft); border-color: var(--accent); }
.field-docs-count { font-size: .78rem; color: var(--ink-faint); }

.field-docs { margin-top: 12px; }
.field-docs-picker { display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 10px; }
.field-doc-chip {
  border: 1px solid var(--line); background: #fff; color: var(--ink-soft);
  font: 600 .74rem/1 var(--sans); padding: 6px 10px; border-radius: 999px; cursor: pointer;
}
.field-doc-chip:hover { border-color: var(--ink-faint); color: var(--ink); }
.field-doc-chip.is-active { background: var(--ink); border-color: var(--ink); color: #fff; }

.field-docs .code-block pre { max-height: 340px; overflow: auto; scroll-behavior: auto; }
.field-docs-lines { font-size: .72rem; color: #8892a6; }
.field-docs-full { margin-left: auto; font-size: .72rem; color: #7fb3ff; white-space: nowrap; }

.ref-empty {
  margin-top: 40px; padding: 28px; text-align: center;
  border: 1px dashed var(--line); border-radius: var(--radius); color: var(--ink-faint);
}

@media (max-width: 980px) {
  .ref-layout { grid-template-columns: 1fr; gap: 0; }
  .ref-side { position: static; margin-bottom: 8px; }
  .toc-toggle {
    display: flex; align-items: center; justify-content: space-between; gap: 8px;
    width: 100%; font: inherit; font-size: .9rem; font-weight: 600; color: var(--ink);
    padding: 10px 14px; cursor: pointer;
    background: var(--bg-alt); border: 1px solid var(--line); border-radius: 8px;
  }
  .toc-chevron {
    width: 8px; height: 8px; border-right: 2px solid var(--ink-faint); border-bottom: 2px solid var(--ink-faint);
    transform: rotate(45deg) translate(-2px, -2px); transition: transform .15s;
  }
  .toc-toggle[aria-expanded="true"] .toc-chevron { transform: rotate(-135deg) translate(-2px, -2px); }
  .toc-panel {
    max-height: 55vh; margin-top: 10px; padding: 4px 8px 4px 0;
  }
  .toc-panel .toc-title { display: none; }
  /* Same indent, a taller hit area: a 16px triangle is not a touch target. */
  .toc-branch { height: 26px; }
  .ref-body { max-width: none; }
}

@media (max-width: 620px) {
  .ref-main { padding-top: 32px; }
  /* One row of sticky, not two: the schema chip goes, the toggle gets a short label. */
  .ref-toolbar { flex-wrap: nowrap; gap: 10px; padding: 10px 0; }
  .toolbar-here { flex: none; }
  .req-long { display: none; }
  .req-short { display: inline; }
  .field-req { margin-left: 0; }
  .field[data-depth="1"] { margin-left: 12px; }
  .field[data-depth="2"] { margin-left: 24px; }
  .search-hint { display: none; }
}

/* ---------- extensions (hand-written, after the generated fields) ---------- */
.ref-ext {
  margin-top: 56px; padding-top: 32px; border-top: 1px solid var(--line);
  scroll-margin-top: 50px;
}
.ref-ext-tag {
  font: 600 .68rem/1 var(--sans); letter-spacing: .08em; text-transform: uppercase;
  color: var(--ink-faint); margin: 0 0 10px;
}
.ref-ext h2 { margin: 0 0 10px; }
.ref-ext > p { color: var(--ink-soft); }

.ref-ext-grid {
  display: grid; grid-template-columns: 1fr 1fr; gap: 14px; margin: 24px 0;
}
.ref-ext-card {
  border: 1px solid var(--line); border-radius: var(--radius);
  padding: 18px 20px; background: #fff;
}
.ref-ext-card h3 { margin: 0 0 8px; font-size: 1rem; }
.ref-ext-card p { margin: 0 0 14px; color: var(--ink-soft); font-size: .92rem; }
.ref-ext-card code {
  display: block; font-family: var(--mono); font-size: .78rem;
  background: var(--bg-alt); border: 1px solid var(--line); color: var(--ink-soft);
  padding: 8px 10px; border-radius: 6px; overflow-x: auto; white-space: nowrap;
}
/* The prefixed one is the point of the section: give it the accent. */
.ref-ext-card:last-child { border-left: 3px solid var(--accent); }
.ref-ext-card:last-child code { background: var(--accent-soft); border-color: transparent; color: var(--accent-ink); }

.ref-ext-promise {
  margin: 0 0 24px; padding: 16px 18px;
  background: var(--bg-alt); border-radius: var(--radius);
  font-size: .92rem; color: var(--ink-soft);
}
.ref-ext-promise strong { color: var(--ink); }

@media (max-width: 620px) {
  .ref-ext-grid { grid-template-columns: 1fr; }
}