/* ============================================================
   IoT Parrot documentation site — layout on top of site.css
   Loaded AFTER /css/site.css. Reuses the "Blue & Gold Macaw"
   tokens; adds the docs sidebar, prose content, and code blocks.
   Pure CSS — the marketing CSP forbids JavaScript.
   ============================================================ */

/* Two-column docs shell: sticky sidebar + content */
.docs-layout {
  max-width: var(--max-content);
  margin: 0 auto;
  padding: 0 24px;
  display: grid;
  grid-template-columns: 232px minmax(0, 1fr);
  gap: 48px;
  align-items: start;
}

/* Sidebar */
.docs-sidebar {
  position: sticky;
  top: 92px; /* clears the 68px sticky header + breathing room */
  align-self: start;
  max-height: calc(100vh - 108px);
  overflow-y: auto;
  padding: 24px 0 32px;
  font-size: 0.9rem;
}
.docs-sidebar .docs-nav-group { margin-bottom: 20px; }
.docs-sidebar .docs-nav-label {
  font-family: var(--font-display);
  font-size: 0.75rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--text-subtle);
  margin-bottom: 8px;
  padding-left: 12px;
}
.docs-sidebar ul { list-style: none; margin: 0; padding: 0; }
.docs-sidebar li { margin: 0; }
.docs-sidebar a {
  display: block;
  padding: 6px 12px;
  border-radius: var(--radius-sm);
  color: var(--text-secondary);
  border-left: 2px solid transparent;
}
.docs-sidebar a:hover {
  background: var(--overlay-hover);
  color: var(--text-primary);
  text-decoration: none;
}
.docs-sidebar a.active {
  color: var(--macaw-gold-bright);
  background: var(--tint-primary);
  border-left-color: var(--macaw-gold);
  font-weight: 600;
}

/* Content column */
.docs-content { padding: 40px 0 24px; min-width: 0; }
.docs-content h1 { font-size: 2.25rem; margin-bottom: 12px; }
.docs-content h2 {
  font-size: 1.5rem;
  margin-top: 44px;
  margin-bottom: 12px;
  padding-top: 8px;
  scroll-margin-top: 88px; /* so #anchors clear the sticky header */
}
.docs-content h3 { font-size: 1.15rem; margin-top: 28px; margin-bottom: 8px; }
.docs-content p, .docs-content li { font-size: 1rem; }
.docs-content ul, .docs-content ol { margin-bottom: 16px; }
.docs-content ol { padding-left: 24px; }

/* Lede paragraph under the page title */
.docs-content .lede {
  font-size: 1.15rem;
  color: var(--text-secondary);
  margin-bottom: 8px;
}

/* Breadcrumb above the title */
.docs-breadcrumb {
  font-size: 0.85rem;
  color: var(--text-subtle);
  margin-bottom: 16px;
}
.docs-breadcrumb a { color: var(--text-subtle); }
.docs-breadcrumb a:hover { color: var(--text-primary); }

/* Inline code + fenced code blocks */
.docs-content code {
  background: var(--surface-sunk);
  border: 1px solid var(--border-subtle);
  border-radius: 5px;
  padding: 1px 6px;
  font-size: 0.875em;
  color: var(--macaw-gold-bright);
}
.docs-content pre {
  background: var(--surface-lowest);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-md);
  padding: 16px;
  overflow-x: auto;
  margin-bottom: 20px;
  line-height: 1.5;
}
.docs-content pre code {
  background: none;
  border: none;
  padding: 0;
  color: var(--text-secondary);
  font-size: 0.85rem;
}

/* Callout boxes: .note (blue), .tip (gold), .warn (amber/red) */
.callout {
  border: 1px solid var(--border-default);
  border-left-width: 3px;
  border-radius: var(--radius-md);
  background: var(--surface-card);
  padding: 14px 16px;
  margin: 20px 0;
  font-size: 0.95rem;
}
.callout p:last-child { margin-bottom: 0; }
.callout .callout-title {
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 0.85rem;
  letter-spacing: 0.03em;
  text-transform: uppercase;
  margin-bottom: 6px;
  display: flex;
  align-items: center;
  gap: 8px;
}
.callout.note { border-left-color: var(--macaw-blue-bright); }
.callout.note .callout-title { color: var(--macaw-blue-bright); }
.callout.tip { border-left-color: var(--macaw-gold); }
.callout.tip .callout-title { color: var(--macaw-gold-bright); }
.callout.warn { border-left-color: var(--status-warning); }
.callout.warn .callout-title { color: var(--status-warning); }

/* Tier badge (inline "Maker+" / "Pro" pill) */
.tier-badge {
  display: inline-block;
  font-family: var(--font-display);
  font-size: 0.7rem;
  font-weight: 700;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  padding: 2px 8px;
  border-radius: var(--radius-pill);
  vertical-align: middle;
  background: var(--tint-primary);
  color: var(--macaw-blue-bright);
  border: 1px solid var(--border-default);
}
.tier-badge.pro { color: var(--macaw-gold-bright); background: rgba(245, 166, 35, 0.12); }

/* Data tables inside docs */
.docs-content table {
  width: 100%;
  border-collapse: collapse;
  margin: 16px 0 24px;
  font-size: 0.9rem;
}
.docs-content th, .docs-content td {
  border: 1px solid var(--border-default);
  padding: 8px 12px;
  text-align: left;
  vertical-align: top;
}
.docs-content thead th {
  background: var(--surface-sunk);
  color: var(--text-primary);
  font-family: var(--font-display);
  font-size: 0.85rem;
}
.docs-content td code { white-space: nowrap; }

/* Card grid used on the docs index */
.docs-card-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  gap: 16px;
  margin: 24px 0;
}
.docs-card {
  display: block;
  background: var(--surface-card);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-lg);
  padding: 20px;
  color: var(--text-secondary);
}
.docs-card:hover {
  border-color: var(--macaw-blue);
  text-decoration: none;
  background: var(--surface-raised);
}
.docs-card h3 { margin: 0 0 6px; font-size: 1.05rem; color: var(--text-primary); }
.docs-card p { margin: 0; font-size: 0.9rem; color: var(--text-subtle); }
.docs-card .docs-card-icon {
  width: 40px; height: 40px;
  border-radius: var(--radius-md);
  background: var(--tint-primary);
  color: var(--macaw-blue-bright);
  display: flex; align-items: center; justify-content: center;
  margin-bottom: 14px;
}
.docs-card .docs-card-icon .material-symbols-rounded { font-size: 22px; }

/* Prev/next footer links between pages */
.docs-pager {
  display: flex;
  justify-content: space-between;
  gap: 16px;
  margin-top: 48px;
  padding-top: 24px;
  border-top: 1px solid var(--border-default);
  flex-wrap: wrap;
}
.docs-pager a {
  flex: 1 1 220px;
  padding: 14px 16px;
  border: 1px solid var(--border-default);
  border-radius: var(--radius-md);
  background: var(--surface-card);
}
.docs-pager a:hover { border-color: var(--macaw-blue); text-decoration: none; }
.docs-pager .pager-dir { font-size: 0.78rem; color: var(--text-subtle); display: block; }
.docs-pager .pager-title { color: var(--text-primary); font-weight: 600; }
.docs-pager a.pager-next { text-align: right; }

/* "On this page" mini table of contents (optional, per page) */
.docs-toc {
  background: var(--surface-card);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-md);
  padding: 14px 18px;
  margin: 24px 0;
  font-size: 0.9rem;
}
.docs-toc .docs-toc-label {
  font-family: var(--font-display);
  font-size: 0.72rem;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--text-subtle);
  margin-bottom: 8px;
}
.docs-toc ul { list-style: none; margin: 0; padding: 0; columns: 2; }
.docs-toc li { margin-bottom: 4px; }

/* Definition-style field lists (widget/field references) */
.field-list { margin: 12px 0 24px; }
.field-list dt {
  font-family: var(--font-mono);
  font-size: 0.9rem;
  color: var(--macaw-gold-bright);
  margin-top: 12px;
}
.field-list dd { margin: 2px 0 0; padding-left: 16px; color: var(--text-secondary); }

/* Responsive: collapse sidebar into a wrapped chip row above content */
@media (max-width: 860px) {
  .docs-layout { grid-template-columns: 1fr; gap: 0; }
  .docs-sidebar {
    position: static;
    max-height: none;
    overflow: visible;
    padding: 20px 0 4px;
    border-bottom: 1px solid var(--border-default);
  }
  .docs-sidebar .docs-nav-group { margin-bottom: 12px; }
  .docs-sidebar .docs-nav-label { padding-left: 0; }
  .docs-sidebar ul { display: flex; flex-wrap: wrap; gap: 6px; }
  .docs-sidebar a { border-left: none; padding: 5px 10px; border: 1px solid var(--border-default); }
  .docs-sidebar a.active { border-color: var(--macaw-gold); }
  .docs-content { padding-top: 28px; }
  .docs-toc ul { columns: 1; }
}