/* ==========================================================================
   doticca-ui documentation — site chrome
   Built entirely on the suite's own design tokens (--dt-*) so the docs share
   the exact visual language of the components they describe. The library's
   ui-suite.css defines the tokens on .dt-scope (+ data-dt-theme); this file
   only adds documentation-layout concerns (shell, sidebar, prose, code).
   ========================================================================== */

/* A few doc-only tokens, derived from the suite tokens. */
.dt-scope {
  --doc-sidebar-w: 264px;
  --doc-topbar-h: 56px;
  --doc-content-max: 760px;
  --doc-code-bg: var(--dt-hover);
  --doc-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
}

* {
  box-sizing: border-box;
}

html,
body {
  margin: 0;
  padding: 0;
}

body {
  background: var(--dt-bg);
  color: var(--dt-text);
  font-family: var(--dt-font);
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
}

a {
  color: var(--dt-accent);
  text-decoration: none;
}
a:hover {
  text-decoration: underline;
}

/* ---- topbar ------------------------------------------------------------ */

.doc-topbar {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  height: var(--doc-topbar-h);
  display: flex;
  align-items: center;
  gap: 12px;
  padding: 0 16px;
  background: color-mix(in srgb, var(--dt-bg) 88%, transparent);
  backdrop-filter: saturate(180%) blur(12px);
  border-bottom: 1px solid var(--dt-border);
  z-index: 50;
}

.doc-brand {
  display: flex;
  align-items: center;
  gap: 10px;
  font-weight: 600;
  font-size: 15px;
  color: var(--dt-text);
}
.doc-brand:hover {
  text-decoration: none;
}
.doc-brand-mark {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 26px;
  height: 26px;
  border-radius: 8px;
  background: var(--dt-accent);
  color: var(--dt-on-accent);
  font-weight: 700;
  font-size: 14px;
}
.doc-brand-badge {
  font-size: 11px;
  font-weight: 500;
  color: var(--dt-muted);
  border: 1px solid var(--dt-border);
  border-radius: 999px;
  padding: 2px 8px;
}

.doc-topbar-spacer {
  flex: 1;
}

.doc-iconbtn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 36px;
  height: 36px;
  border: 1px solid var(--dt-border);
  border-radius: var(--dt-radius-sm);
  background: var(--dt-surface);
  color: var(--dt-text);
  cursor: pointer;
  transition: background 0.12s ease, border-color 0.12s ease;
}
.doc-iconbtn:hover {
  background: var(--dt-hover);
}
.doc-iconbtn svg {
  width: 18px;
  height: 18px;
}

.doc-menu-toggle {
  display: none;
}

/* ---- layout shell ------------------------------------------------------ */

.doc-shell {
  display: flex;
  padding-top: var(--doc-topbar-h);
  min-height: 100vh;
}

/* ---- sidebar ----------------------------------------------------------- */

.doc-sidebar {
  position: fixed;
  top: var(--doc-topbar-h);
  bottom: 0;
  left: 0;
  width: var(--doc-sidebar-w);
  overflow-y: auto;
  border-right: 1px solid var(--dt-border);
  background: var(--dt-bg);
  padding: 24px 16px 48px;
}

.doc-nav-group {
  margin-bottom: 22px;
}
.doc-nav-group-title {
  font-size: 11px;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--dt-muted);
  padding: 0 10px;
  margin-bottom: 8px;
}
.doc-nav-link {
  display: block;
  padding: 7px 10px;
  border-radius: var(--dt-radius-sm);
  font-size: 14px;
  color: var(--dt-muted);
  transition: background 0.12s ease, color 0.12s ease;
}
.doc-nav-link:hover {
  background: var(--dt-hover);
  color: var(--dt-text);
  text-decoration: none;
}
.doc-nav-link.is-active {
  background: var(--dt-accent-soft);
  color: var(--dt-accent);
  font-weight: 600;
}

/* ---- main content ------------------------------------------------------ */

.doc-main {
  flex: 1;
  margin-left: var(--doc-sidebar-w);
  min-width: 0;
}

.doc-content {
  max-width: var(--doc-content-max);
  margin: 0 auto;
  padding: 48px 32px 96px;
}

.doc-eyebrow {
  font-size: 12px;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--dt-accent);
  margin: 0 0 10px;
}

.doc-content h1 {
  font-size: 34px;
  line-height: 1.2;
  font-weight: 700;
  letter-spacing: -0.02em;
  margin: 0 0 12px;
}
.doc-lead {
  font-size: 17px;
  color: var(--dt-muted);
  margin: 0 0 40px;
  max-width: 60ch;
}

.doc-content h2 {
  font-size: 22px;
  font-weight: 650;
  letter-spacing: -0.01em;
  margin: 48px 0 14px;
  padding-top: 12px;
  scroll-margin-top: calc(var(--doc-topbar-h) + 16px);
}
.doc-content h3 {
  font-size: 16px;
  font-weight: 650;
  margin: 28px 0 10px;
  scroll-margin-top: calc(var(--doc-topbar-h) + 16px);
}
.doc-content p {
  margin: 0 0 16px;
}
.doc-content ul,
.doc-content ol {
  margin: 0 0 16px;
  padding-left: 22px;
}
.doc-content li {
  margin-bottom: 6px;
}
.doc-content strong {
  font-weight: 650;
}

/* inline code */
.doc-content code:not(pre code) {
  font-family: var(--doc-mono);
  font-size: 0.86em;
  background: var(--doc-code-bg);
  border: 1px solid var(--dt-border);
  border-radius: 6px;
  padding: 1px 6px;
  color: var(--dt-text);
}

/* ---- code blocks ------------------------------------------------------- */

.doc-code {
  position: relative;
  margin: 0 0 24px;
  border: 1px solid var(--dt-border);
  border-radius: var(--dt-radius-sm);
  background: var(--dt-surface);
  overflow: hidden;
}
.doc-code-head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 8px 12px;
  border-bottom: 1px solid var(--dt-border);
  font-family: var(--doc-mono);
  font-size: 12px;
  color: var(--dt-muted);
}
.doc-code pre {
  margin: 0;
  padding: 16px;
  overflow-x: auto;
  font-family: var(--doc-mono);
  font-size: 13px;
  line-height: 1.7;
  color: var(--dt-text);
  tab-size: 2;
}
.doc-copy {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  border: 1px solid var(--dt-border);
  border-radius: 6px;
  background: var(--dt-bg);
  color: var(--dt-muted);
  font-size: 12px;
  padding: 4px 8px;
  cursor: pointer;
  transition: background 0.12s ease, color 0.12s ease;
}
.doc-copy:hover {
  background: var(--dt-hover);
  color: var(--dt-text);
}
.doc-copy.is-copied {
  color: var(--dt-accent);
  border-color: var(--dt-accent);
}

/* ---- live demo surface ------------------------------------------------- */

.doc-demo {
  border: 1px solid var(--dt-border);
  border-radius: var(--dt-radius);
  background: var(--dt-surface);
  padding: 28px 24px;
  margin: 0 0 20px;
}
.doc-demo-grid {
  display: grid;
  gap: 22px;
}
@media (min-width: 560px) {
  .doc-demo-grid.cols-2 {
    grid-template-columns: 1fr 1fr;
  }
}
.doc-field label {
  display: block;
  font-size: 13px;
  font-weight: 600;
  margin-bottom: 6px;
  color: var(--dt-text);
}
.doc-field .doc-field-hint {
  font-family: var(--doc-mono);
  font-size: 12px;
  color: var(--dt-muted);
  margin-top: 6px;
}
.doc-field input[type="text"],
.doc-field select {
  width: 100%;
  padding: 11px 13px;
  font-size: 15px;
  font-family: inherit;
  border: 1px solid var(--dt-border);
  border-radius: var(--dt-radius-sm);
  background: var(--dt-bg);
  color: var(--dt-text);
  outline: none;
}
.doc-field input[type="text"]:focus {
  border-color: var(--dt-accent);
  box-shadow: 0 0 0 3px var(--dt-accent-soft);
}

/* ---- callouts ---------------------------------------------------------- */

.doc-callout {
  display: flex;
  gap: 12px;
  border: 1px solid var(--dt-border);
  border-left: 3px solid var(--dt-accent);
  background: var(--dt-accent-soft);
  border-radius: var(--dt-radius-sm);
  padding: 14px 16px;
  margin: 0 0 24px;
  font-size: 14px;
}
.doc-callout.warn {
  border-left-color: #d97706;
  background: color-mix(in srgb, #d97706 12%, transparent);
}
.doc-callout-title {
  font-weight: 650;
  margin: 0 0 4px;
}
.doc-callout p {
  margin: 0;
}

/* ---- tables (API reference) -------------------------------------------- */

.doc-table-wrap {
  overflow-x: auto;
  border: 1px solid var(--dt-border);
  border-radius: var(--dt-radius-sm);
  margin: 0 0 24px;
}
table.doc-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 13.5px;
}
.doc-table th,
.doc-table td {
  text-align: left;
  padding: 10px 14px;
  border-bottom: 1px solid var(--dt-border);
  vertical-align: top;
}
.doc-table th {
  font-weight: 650;
  color: var(--dt-text);
  background: var(--dt-hover);
  white-space: nowrap;
}
.doc-table tr:last-child td {
  border-bottom: none;
}
.doc-table code {
  font-family: var(--doc-mono);
  font-size: 12px;
  color: var(--dt-accent);
  white-space: nowrap;
}
.doc-table td.doc-type code {
  color: var(--dt-muted);
}

/* ---- feature cards ----------------------------------------------------- */

.doc-cards {
  display: grid;
  gap: 16px;
  grid-template-columns: 1fr;
  margin: 0 0 28px;
}
@media (min-width: 560px) {
  .doc-cards.cols-2 {
    grid-template-columns: 1fr 1fr;
  }
}
.doc-card {
  border: 1px solid var(--dt-border);
  border-radius: var(--dt-radius-sm);
  background: var(--dt-surface);
  padding: 18px;
}
.doc-card h3 {
  margin: 0 0 6px;
  font-size: 15px;
}
.doc-card p {
  margin: 0;
  font-size: 14px;
  color: var(--dt-muted);
}

/* ---- next/prev footer -------------------------------------------------- */

.doc-pager {
  display: flex;
  justify-content: space-between;
  gap: 16px;
  margin-top: 56px;
  padding-top: 24px;
  border-top: 1px solid var(--dt-border);
}
.doc-pager a {
  display: flex;
  flex-direction: column;
  gap: 2px;
  border: 1px solid var(--dt-border);
  border-radius: var(--dt-radius-sm);
  padding: 12px 16px;
  min-width: 0;
  flex: 1;
}
.doc-pager a:hover {
  background: var(--dt-hover);
  text-decoration: none;
}
.doc-pager a.next {
  text-align: right;
  align-items: flex-end;
}
.doc-pager .doc-pager-dir {
  font-size: 12px;
  color: var(--dt-muted);
}
.doc-pager .doc-pager-title {
  font-size: 15px;
  font-weight: 600;
  color: var(--dt-text);
}

/* ---- pill row ---------------------------------------------------------- */

.doc-pills {
  display: flex;
  flex-wrap: wrap;
  gap: 8px;
  margin: 0 0 28px;
}
.doc-pill {
  font-size: 12px;
  font-weight: 500;
  color: var(--dt-text);
  border: 1px solid var(--dt-border);
  border-radius: 999px;
  padding: 5px 12px;
  background: var(--dt-surface);
}

/* ---- backdrop for mobile sidebar -------------------------------------- */

.doc-backdrop {
  display: none;
  position: fixed;
  inset: var(--doc-topbar-h) 0 0;
  background: var(--dt-overlay-bg);
  z-index: 40;
}

/* ---- responsive -------------------------------------------------------- */

@media (max-width: 900px) {
  .doc-menu-toggle {
    display: inline-flex;
  }
  .doc-sidebar {
    transform: translateX(-100%);
    transition: transform 0.22s ease;
    z-index: 45;
    width: 280px;
    box-shadow: var(--dt-shadow);
  }
  body.doc-nav-open .doc-sidebar {
    transform: translateX(0);
  }
  body.doc-nav-open .doc-backdrop {
    display: block;
  }
  .doc-main {
    margin-left: 0;
  }
  .doc-content {
    padding: 32px 20px 80px;
  }
  .doc-content h1 {
    font-size: 28px;
  }
}

@media (prefers-reduced-motion: reduce) {
  .doc-sidebar {
    transition: none;
  }
}