/* hifoyer.com/api/: the Foyer API docs (GitHub #311).
   Loaded after home.css, which supplies the base, nav, buttons and footer. Tokens
   only; light and dark follow the OS ([data-theme="auto"] on <html>).
   Code uses the system monospace stack, as the dashboard's code does
   (dash/layout.css): fixed-width text is what makes curl, JSON and keys readable.
   Breakpoints: 1100px (--breakpoint-lg) and 760px (--breakpoint-md), as home.css. */

.docs-page { background: var(--bg-canvas); color: var(--text-primary); }
.docs-page .nav__links a[aria-current="page"] { color: var(--text-primary); font-weight: var(--font-weight-bold); }

/* ---------- preview banner (tools/api-docs/site.json: availability) ---------- */
.rollout { background: var(--bg-subtle); border-bottom: var(--component-card-border-width) solid var(--border-subtle); }
.rollout__in { display: flex; align-items: center; justify-content: space-between; gap: var(--space-5); padding-top: var(--space-4); padding-bottom: var(--space-4); }
.rollout p { max-width: var(--component-layout-reading-max); font-size: var(--type-body-sm-size); line-height: var(--type-body-sm-leading); color: var(--text-secondary); }
.rollout strong { color: var(--text-primary); }
.rollout .btn { flex: none; }

/* ---------- layout: page rail + article ---------- */
.docs {
  display: grid; grid-template-columns: calc(var(--component-layout-sidebar-web) - var(--space-8)) minmax(0, 1fr);
  gap: var(--space-11); align-items: start; padding-top: var(--space-10); padding-bottom: var(--space-12);
}
.rail { position: sticky; top: var(--space-7); max-height: calc(100vh - 2 * var(--space-7)); overflow-y: auto; }
.rail__label {
  margin: var(--space-7) 0 var(--space-3);
  font-size: var(--type-label-md-size); font-weight: var(--type-label-md-weight); line-height: var(--type-label-md-leading);
  letter-spacing: var(--type-label-md-tracking); text-transform: uppercase; color: var(--text-tertiary);
}
.rail__label:first-child { margin-top: 0; }
.rail a {
  display: flex; align-items: center; min-height: calc(var(--target-web) + var(--space-4)); padding: var(--space-2) var(--space-4);
  border-radius: var(--radius-sm); font-size: var(--type-body-sm-size); line-height: var(--type-body-sm-leading);
  color: var(--text-secondary); text-decoration: none;
}
.rail a:hover { color: var(--text-primary); background: var(--bg-subtle); }
.rail a[aria-current="page"] { color: var(--text-primary); background: var(--bg-subtle); font-weight: var(--font-weight-bold); }
.rail-mobile { display: none; }

/* ---------- article ---------- */
.doc { min-width: 0; max-width: calc(var(--component-layout-reading-max) + var(--space-12)); }
.doc--wide { max-width: none; }
.doc--wide > p, .doc--wide .op > p, .doc--wide .ref-general > p { max-width: var(--component-layout-reading-max); }
.doc h1 {
  margin: var(--space-4) 0 var(--space-7);
  font-family: var(--type-display-md-family); font-weight: var(--type-display-md-weight);
  font-size: var(--type-display-md-size); line-height: var(--type-display-md-leading); letter-spacing: var(--type-display-md-tracking);
  text-wrap: balance;
}
.doc h2 {
  margin: var(--space-10) 0 var(--space-5); scroll-margin-top: var(--space-7);
  font-family: var(--type-display-sm-family); font-weight: var(--type-display-sm-weight);
  font-size: var(--type-display-sm-size); line-height: var(--type-display-sm-leading); letter-spacing: var(--type-display-sm-tracking);
}
.doc h3 {
  margin: var(--space-8) 0 var(--space-4); scroll-margin-top: var(--space-7);
  font-family: var(--type-heading-lg-family); font-weight: var(--type-heading-lg-weight);
  font-size: var(--type-heading-lg-size); line-height: var(--type-heading-lg-leading); letter-spacing: var(--type-heading-lg-tracking);
}
.doc h4 {
  margin: var(--space-7) 0 var(--space-3);
  font-family: var(--type-heading-sm-family); font-weight: var(--type-heading-sm-weight);
  font-size: var(--type-heading-sm-size); line-height: var(--type-heading-sm-leading);
}
.doc p, .doc :is(ul, ol):not([class]) { margin-bottom: var(--space-5); }
.doc :is(ul, ol):not([class]) { padding-left: var(--space-7); list-style: disc; }
.doc ol:not([class]) { list-style: decimal; }
.doc li + li { margin-top: var(--space-3); }
.doc .cards-grid li + li { margin-top: 0; }
.doc a { color: var(--text-primary); text-decoration-color: var(--border-strong); text-underline-offset: .2em; }
.doc a:hover { text-decoration-color: var(--text-primary); }
.doc > p:first-of-type { font-size: var(--type-body-lg-size); line-height: var(--type-body-lg-leading); color: var(--text-secondary); }

code, pre { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
code {
  padding: 0 var(--space-2); border-radius: var(--radius-xs); background: var(--bg-subtle);
  font-size: var(--type-body-sm-size); overflow-wrap: anywhere;
}
.code {
  margin: var(--space-5) 0 var(--space-6); overflow: hidden;
  border: var(--component-card-border-width) solid var(--border-subtle); border-radius: var(--radius-md); background: var(--bg-subtle);
}
.code figcaption {
  padding: var(--space-3) var(--space-5); border-bottom: var(--component-card-border-width) solid var(--border-subtle);
  font-size: var(--type-label-lg-size); font-weight: var(--type-label-lg-weight); line-height: var(--type-label-lg-leading); color: var(--text-secondary);
}
.code pre { margin: 0; padding: var(--space-5); overflow-x: auto; font-size: var(--type-body-xs-size); line-height: var(--type-body-sm-leading); }
.code pre code { padding: 0; background: none; font-size: inherit; overflow-wrap: normal; }

.table {
  margin: var(--space-5) 0 var(--space-6); overflow-x: auto;
  border: var(--component-card-border-width) solid var(--border-subtle); border-radius: var(--radius-md);
}
.table table { width: 100%; border-collapse: collapse; font-size: var(--type-body-sm-size); line-height: var(--type-body-sm-leading); }
.table :is(th, td) { padding: var(--space-3) var(--space-4); text-align: left; vertical-align: top; border-bottom: var(--component-card-border-width) solid var(--border-subtle); }
.table th { background: var(--bg-subtle); font-weight: var(--font-weight-bold); }
.table tr:last-child td { border-bottom: 0; }
.table td.type { color: var(--text-secondary); }
.table td code { white-space: nowrap; }
.req {
  display: inline-block; margin-left: var(--space-2);
  font-size: var(--type-label-sm-size); font-weight: var(--type-label-sm-weight); letter-spacing: var(--type-label-sm-tracking);
  text-transform: uppercase; color: var(--text-tertiary);
}

.callout {
  margin: var(--space-6) 0; padding: var(--space-5) var(--space-6);
  border-left: var(--space-2) solid var(--border-strong); border-radius: 0 var(--radius-sm) var(--radius-sm) 0; background: var(--bg-subtle);
}
.callout__title { font-weight: var(--font-weight-bold); margin-bottom: var(--space-3); }
.callout > :last-child { margin-bottom: 0; }
.callout--placeholder, mark.placeholder { outline: var(--component-card-border-width) dashed var(--status-warning); outline-offset: var(--space-1); }
mark.placeholder { padding: 0 var(--space-2); border-radius: var(--radius-xs); background: var(--bg-sunken); color: var(--text-primary); }

.cards-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(calc(var(--space-14) * 2), 1fr)); gap: var(--space-5); margin: var(--space-6) 0 var(--space-7); }
.doc-card {
  display: flex; flex-direction: column; gap: var(--space-3); height: 100%; padding: var(--space-6);
  border: var(--component-card-border-width) solid var(--border-subtle); border-radius: var(--component-card-radius-web);
  background: var(--bg-raised); text-decoration: none;
  transition: border-color var(--motion-duration-fast) var(--motion-easing-standard);
}
.doc a.doc-card { text-decoration: none; }
.doc-card:hover { border-color: var(--border-strong); }
.doc-card strong { font-family: var(--type-heading-md-family); font-weight: var(--type-heading-md-weight); font-size: var(--type-heading-md-size); line-height: var(--type-heading-md-leading); }
.doc-card span { font-size: var(--type-body-sm-size); line-height: var(--type-body-sm-leading); color: var(--text-secondary); }

/* ---------- endpoint reference (generated from the OpenAPI spec) ---------- */
.ref-meta { font-size: var(--type-body-sm-size); color: var(--text-secondary); }
.ref-toc { margin-top: var(--space-10); }
.ref-toc > h2 { margin-bottom: var(--space-6); }
.ref-toc__group { margin-bottom: var(--space-6); }
.ref-toc__group h3 { margin: 0 0 var(--space-3); font-size: var(--type-heading-md-size); }
.ref-toc ul { display: grid; grid-template-columns: repeat(auto-fill, minmax(calc(var(--space-14) * 2.6), 1fr)); gap: var(--space-1) var(--space-5); }
.ref-toc li + li { margin-top: 0; }
.ref-toc a { display: flex; align-items: center; gap: var(--space-3); min-height: calc(var(--target-web) + var(--space-3)); text-decoration: none; }
.ref-toc a code { background: none; padding: 0; font-size: var(--type-body-xs-size); }
.method {
  display: inline-flex; justify-content: center; flex: none; min-width: calc(var(--space-10) + var(--space-4));
  padding: var(--space-1) var(--space-3); border-radius: var(--radius-xs); background: var(--bg-inverse); color: var(--text-inverse);
  font-family: var(--font-family-text); font-size: var(--type-label-sm-size); font-weight: var(--font-weight-black);
  letter-spacing: var(--type-label-sm-tracking); line-height: var(--type-label-lg-leading);
}
.op { margin-top: var(--space-9); padding-top: var(--space-8); border-top: var(--component-card-border-width) solid var(--border-default); scroll-margin-top: var(--space-7); }
.doc .op h3 { display: flex; flex-wrap: wrap; align-items: center; gap: var(--space-3); margin-top: 0; font-size: var(--type-heading-md-size); }
.op h3 code { padding: 0; background: none; font-size: var(--type-heading-sm-size); }
.op__summary { font-size: var(--type-body-lg-size); color: var(--text-secondary); }
.op__meta { display: flex; flex-wrap: wrap; gap: var(--space-3) var(--space-8); margin: var(--space-5) 0; font-size: var(--type-body-sm-size); }
.op__meta dt { font-size: var(--type-label-md-size); font-weight: var(--type-label-md-weight); letter-spacing: var(--type-label-md-tracking); text-transform: uppercase; color: var(--text-tertiary); }
.op__meta dd { margin: var(--space-1) 0 0; }
.errors { display: grid; gap: var(--space-2); font-size: var(--type-body-sm-size); }
.ref-schemas .schema { margin-top: var(--space-8); scroll-margin-top: var(--space-7); }

@media (max-width: 1100px) {
  .docs { grid-template-columns: minmax(0, 1fr); gap: var(--space-6); padding-top: var(--space-7); }
  .rail { display: none; }
  .rail-mobile { display: block; border: var(--component-card-border-width) solid var(--border-default); border-radius: var(--radius-md); }
  .rail-mobile summary { display: flex; align-items: center; min-height: var(--target-ios); padding: 0 var(--space-5); font-weight: var(--font-weight-bold); cursor: pointer; }
  .rail-mobile nav { padding: 0 var(--space-4) var(--space-5); }
  .rail-mobile ul { display: grid; }
  .rail-mobile a {
    display: flex; align-items: center; min-height: var(--target-ios); padding: 0 var(--space-3); border-radius: var(--radius-sm);
    color: var(--text-secondary); text-decoration: none;
  }
  .rail-mobile a[aria-current="page"] { color: var(--text-primary); background: var(--bg-subtle); font-weight: var(--font-weight-bold); }
  .rollout__in { flex-wrap: wrap; }
}

@media (max-width: 760px) {
  .docs { padding-bottom: var(--space-10); }
  .doc h1 { font-size: var(--type-display-sm-size); line-height: var(--type-display-sm-leading); letter-spacing: var(--type-display-sm-tracking); }
  .doc h2 { margin-top: var(--space-9); font-size: var(--type-heading-lg-size); line-height: var(--type-heading-lg-leading); letter-spacing: var(--type-heading-lg-tracking); }
  .doc h3 { font-size: var(--type-heading-md-size); }
  .doc > p:first-of-type { font-size: var(--type-body-md-size); }
  .rollout__in { flex-direction: column; align-items: flex-start; gap: var(--space-3); }
  .op__meta { flex-direction: column; }
}