/* ═══════════════════════════════════════════════════════════════════
   Flexnet Docs Generator — Doc-Specific BEM Components
   ═══════════════════════════════════════════════════════════════════
   STRUCTURE ONLY.  All colours via Token Exchange (theme-default.css).
   This file pairs with bem-starter-base.css — adds doc-layout grid,
   sidebar tree, TOC rail, pager, search modal, and code-block header.
   ═══════════════════════════════════════════════════════════════════ */

/* ── page shell — flat background ─────────────────────────────────── */

.c-doc-layout {
  background: var(--color-bg);
  background-image: none;
}

/* ── 3-column doc layout ─────────────────────────────────────────── */

.c-doc-layout__main--docs {
  display: grid;
  grid-template-columns: 260px 1fr 220px;
  gap: 0;
  max-width: 1400px;
  margin: 0 auto;
  padding-top: var(--header-h, 56px);
  min-height: 100vh;
}

.c-doc-layout__sidebar {
  position: sticky;
  top: var(--header-h, 56px);
  height: calc(100vh - var(--header-h, 56px));
  overflow-y: auto;
  border-right: none;
  padding: var(--sp-4, 1rem) 0;
}

.c-doc-layout__content {
  padding: var(--sp-6, 1.5rem) var(--sp-8, 2rem);
  max-width: 800px;
  min-width: 0;
}

/* ── content — remove card/panel effects ──────────────────────────── */

.c-doc-layout__content.c-doc-content {
  background: none;
  border: none;
  border-radius: 0;
  box-shadow: none;
}

/* ── doc content typography ──────────────────────────────────────── */

.c-doc-content h1 { margin: 0 0 var(--sp-4, 1rem); border-bottom: none; padding-bottom: 0; text-shadow: none; }
.c-doc-content h2 { margin: var(--sp-8, 2rem) 0 var(--sp-3, 0.75rem); border-bottom: none; padding-bottom: 0; text-shadow: none; }
.c-doc-content h3 { margin: var(--sp-6, 1.5rem) 0 var(--sp-2, 0.5rem); border-bottom: none; padding-bottom: 0; text-shadow: none; }
.c-doc-content h4,
.c-doc-content h5,
.c-doc-content h6 { margin: var(--sp-4, 1rem) 0 var(--sp-2, 0.5rem); }

.c-doc-content p {
  margin: 0 0 var(--sp-4, 1rem);
  line-height: 1.7;
}

.c-doc-content ul,
.c-doc-content ol {
  margin: 0 0 var(--sp-4, 1rem);
  padding-left: var(--sp-6, 1.5rem);
}

.c-doc-content li {
  margin-bottom: var(--sp-1, 0.25rem);
  line-height: 1.6;
}

.c-doc-content pre {
  margin: 0 0 var(--sp-4, 1rem);
  padding: var(--sp-4, 1rem);
  overflow-x: auto;
  background: var(--clr-bg);
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-md, 8px);
  border-top-left-radius: 0;
  border-top-right-radius: 0;
  font-size: 0.875rem;
  line-height: 1.5;
}

.c-doc-content code {
  font-family: 'SF Mono', 'Fira Code', 'Cascadia Code', monospace;
}

.c-doc-content p code,
.c-doc-content li code,
.c-doc-content td code {
  padding: 0.15em 0.4em;
  background: color-mix(in srgb, var(--clr-border) 50%, transparent);
  border-radius: var(--radius-sm, 4px);
  font-size: 0.875em;
}

.c-doc-content img {
  max-width: 100%;
  height: auto;
  border-radius: var(--radius-md, 8px);
}

.c-doc-content hr {
  border: none;
  border-top: 1px solid var(--clr-border);
  margin: var(--sp-8, 2rem) 0;
}

.c-doc-content a {
  color: var(--clr-fg);
  text-decoration: underline;
}
.c-doc-content a:hover {
  color: var(--clr-fg);
  text-decoration: underline;
}
.c-doc-content a:focus-visible {
  text-decoration: underline;
  outline: 2px solid var(--clr-brand);
  outline-offset: 2px;
}

/* ── sidebar ─────────────────────────────────────────────────────── */

.c-docs-sidebar {
  padding: var(--sp-2, 0.5rem) var(--sp-4, 1rem);
}

.c-docs-sidebar__group {
  margin-bottom: var(--sp-4, 1rem);
}

.c-docs-sidebar__group-title {
  display: block;
  padding: var(--sp-1, 0.25rem) var(--sp-3, 0.75rem);
  font-size: 0.7rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--clr-fg-muted, #aeb7c7);
  text-decoration: none;
}

a.c-docs-sidebar__group-title:hover {
  color: var(--clr-fg);
}

.c-docs-sidebar__links {
  display: flex;
  flex-direction: column;
}

.c-docs-sidebar__link {
  display: block;
  padding: var(--sp-1, 0.25rem) var(--sp-3, 0.75rem);
  padding-left: var(--sp-5, 1.25rem);
  font-size: 0.85rem;
  color: var(--clr-fg-muted, #aeb7c7);
  text-decoration: none;
  border-radius: var(--radius-sm, 4px);
  transition: color 0.15s, background 0.15s;
}

.c-docs-sidebar__link:hover {
  color: var(--clr-fg);
}
.c-docs-sidebar__link:focus-visible {
  color: var(--clr-fg);
  background: color-mix(in srgb, var(--clr-border) 40%, transparent);
  outline: 2px solid var(--clr-brand);
  outline-offset: -2px;
}

.c-docs-sidebar__link--active {
  color: var(--clr-fg);
  background: none;
  font-weight: 500;
}

/* ── TOC rail ────────────────────────────────────────────────────── */

.c-docs-toc {
  position: sticky;
  top: var(--header-h, 48px);
  height: calc(100vh - var(--header-h, 48px));
  overflow-y: auto;
  padding: var(--sp-6, 1.5rem) var(--sp-4, 1rem);
  border-left: none;
}

.c-docs-toc__title {
  display: none;
}

.c-docs-toc__links {
  display: flex;
  flex-direction: column;
  border-left: none;
  padding-left: 0;
}

.c-docs-toc__link {
  display: block;
  padding: var(--sp-1, 0.25rem) 0;
  font-size: 0.8rem;
  color: var(--clr-fg-muted, #9a9a9a);
  text-decoration: none;
  transition: color 0.15s;
  margin-left: 0;
  padding-left: var(--sp-3, 0.75rem);
  border-left: none;
}

.c-docs-toc__link:hover {
  color: var(--clr-fg);
}

.c-docs-toc__link--active {
  color: var(--clr-fg);
  border-left-color: transparent;
}
.c-docs-toc__link:focus-visible {
  color: var(--clr-fg);
  outline: 2px solid var(--clr-brand);
  outline-offset: 2px;
}

.c-docs-toc__link--h3 {
  padding-left: calc(var(--sp-3, 0.75rem) + var(--sp-3, 0.75rem));
}

/* ── pager (prev/next) ───────────────────────────────────────────── */

.c-docs-pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--sp-4, 1rem);
  margin-top: var(--sp-10, 2.5rem);
  padding-top: var(--sp-6, 1.5rem);
  border-top: 1px solid var(--clr-border);
}

.c-docs-pager__link {
  display: flex;
  flex-direction: column;
  padding: var(--sp-4, 1rem);
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-md, 8px);
  text-decoration: none;
  color: var(--clr-fg);
  transition: border-color 0.15s, background 0.15s;
}

.c-docs-pager__link:hover {
  border-color: var(--clr-fg-muted);
  background: none;
}

.c-docs-pager__link--next {
  text-align: right;
}

.c-docs-pager__label {
  font-size: 0.75rem;
  color: var(--clr-fg-muted);
  margin-bottom: var(--sp-1, 0.25rem);
}

.c-docs-pager__title {
  font-weight: 500;
  color: var(--clr-fg);
}

/* ── search modal ────────────────────────────────────────────────── */

.c-docs-search {
  position: fixed;
  inset: 0;
  z-index: var(--z-overlay, 900);
  display: flex;
  align-items: flex-start;
  justify-content: center;
  padding-top: 15vh;
  background: rgba(0, 0, 0, 0.6);
  backdrop-filter: blur(4px);
  opacity: 0;
  visibility: hidden;
  transition: opacity 0.15s, visibility 0.15s;
}

.c-docs-search[aria-hidden="false"] {
  opacity: 1;
  visibility: visible;
}

.c-docs-search__inner {
  width: min(560px, 90vw);
  max-height: 60vh;
  background: var(--clr-bg-elevated, #111627);
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-lg, 12px);
  box-shadow: var(--shadow-lg);
  display: flex;
  flex-direction: column;
  overflow: hidden;
}

.c-docs-search__input {
  width: 100%;
  padding: var(--sp-4, 1rem) var(--sp-5, 1.25rem);
  background: transparent;
  border: none;
  border-bottom: 1px solid var(--clr-border);
  color: var(--clr-fg);
  font-size: 1rem;
  outline: none;
  font-family: inherit;
}
.c-docs-search__input:focus {
  border-bottom-color: var(--clr-brand);
}

.c-docs-search__input::placeholder {
  color: var(--clr-fg-muted);
}

.c-docs-search__results {
  overflow-y: auto;
  flex: 1;
}

.c-docs-search__result {
  display: block;
  padding: var(--sp-3, 0.75rem) var(--sp-5, 1.25rem);
  color: var(--clr-fg);
  text-decoration: none;
  border-bottom: 1px solid color-mix(in srgb, var(--clr-border) 50%, transparent);
  transition: background 0.1s;
}

.c-docs-search__result:hover,
.c-docs-search__result--active {
  background: color-mix(in srgb, var(--clr-brand) 10%, transparent);
}

.c-docs-search__result-title {
  font-weight: 500;
  margin-bottom: 2px;
}

.c-docs-search__result-preview {
  font-size: 0.8rem;
  color: var(--clr-fg-muted);
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.c-docs-search__footer {
  padding: var(--sp-2, 0.5rem) var(--sp-5, 1.25rem);
  font-size: 0.75rem;
  color: var(--clr-fg-muted);
  border-top: 1px solid var(--clr-border);
  text-align: center;
}

.c-docs-search__footer kbd {
  display: inline-block;
  padding: 0 0.3em;
  border: 1px solid var(--clr-border);
  border-radius: 3px;
  font-size: 0.7rem;
  line-height: 1.4;
}

/* ── code block header ───────────────────────────────────────────── */

.c-docs-code-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--sp-2, 0.5rem) var(--sp-4, 1rem);
  background: var(--clr-bg);
  border: 1px solid var(--clr-border);
  border-bottom: none;
  border-radius: var(--radius-md, 8px) var(--radius-md, 8px) 0 0;
  margin-top: var(--sp-4, 1rem);
}

.c-docs-code-header__lang {
  font-size: 0.75rem;
  font-weight: 500;
  color: var(--clr-fg-muted);
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.c-docs-code-header__copy {
  padding: var(--sp-1, 0.25rem) var(--sp-3, 0.75rem);
  background: transparent;
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-sm, 4px);
  color: var(--clr-fg-muted);
  font-size: 0.75rem;
  cursor: pointer;
  transition: color 0.15s, border-color 0.15s;
  font-family: inherit;
}

.c-docs-code-header__copy:hover {
  color: var(--clr-fg);
  border-color: var(--clr-fg-muted);
}
.c-docs-code-header__copy:focus-visible {
  color: var(--clr-fg);
  border-color: var(--clr-brand);
  outline: none;
}

/* ── mobile nav overlay ──────────────────────────────────────────── */

.c-mobile-nav {
  position: fixed;
  inset: 0;
  z-index: var(--z-mobile-nav, 800);
  visibility: hidden;
  pointer-events: none;
}

.c-mobile-nav[aria-hidden="false"] {
  visibility: visible;
  pointer-events: auto;
}

.c-mobile-nav__backdrop {
  position: absolute;
  inset: 0;
  background: rgba(0, 0, 0, 0.5);
  opacity: 0;
  transition: opacity 0.2s;
}

.c-mobile-nav[aria-hidden="false"] .c-mobile-nav__backdrop {
  opacity: 1;
}

.c-mobile-nav__panel {
  position: absolute;
  top: 0;
  left: 0;
  width: 280px;
  height: 100%;
  background: var(--clr-bg-elevated, #111627);
  padding-top: var(--header-h, 56px);
  overflow-y: auto;
  transform: translateX(-100%);
  transition: transform 0.2s ease;
}

.c-mobile-nav[aria-hidden="false"] .c-mobile-nav__panel {
  transform: translateX(0);
}

/* ── header adjustments for docs ─────────────────────────────────── */

.c-header {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  z-index: var(--z-header, 100);
  height: var(--header-h, 48px);
  background: var(--clr-bg-elevated, #1e1e1e);
  border-bottom: 1px solid var(--clr-border);
  display: flex;
  align-items: center;
  backdrop-filter: none;
}

.c-header__inner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  width: 100%;
  max-width: 1400px;
  margin: 0 auto;
  padding: 0 var(--sp-4, 1rem);
}

.c-header__left {
  display: flex;
  align-items: center;
  gap: var(--sp-3, 0.75rem);
}

.c-header__right {
  display: flex;
  align-items: center;
  gap: var(--sp-2, 0.5rem);
}

.c-header__brand {
  display: flex;
  align-items: baseline;
  gap: var(--sp-2, 0.5rem);
  text-decoration: none;
  color: var(--clr-fg);
}

.c-header__title {
  font-size: 1rem;
  font-weight: 600;
}

.c-header__subtitle {
  font-size: 0.8rem;
  color: var(--clr-fg-muted);
}

.c-header__hamburger {
  display: none;
  flex-direction: column;
  gap: 4px;
  padding: var(--sp-2, 0.5rem);
  background: none;
  border: none;
  cursor: pointer;
}
.c-header__hamburger:focus-visible {
  outline: 2px solid var(--clr-brand);
  outline-offset: 2px;
  border-radius: var(--radius-sm, 4px);
}

.c-header__hamburger-line {
  display: block;
  width: 20px;
  height: 2px;
  background: var(--clr-fg);
  border-radius: 1px;
  transition: transform 0.2s;
}

/* ── button (ghost) ──────────────────────────────────────────────── */

.c-button--ghost {
  display: inline-flex;
  align-items: center;
  gap: var(--sp-2, 0.5rem);
  padding: var(--sp-1, 0.25rem) var(--sp-3, 0.75rem);
  background: transparent;
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-sm, 4px);
  color: var(--clr-fg-muted);
  font-size: 0.8rem;
  cursor: pointer;
  font-family: inherit;
  transition: color 0.15s, border-color 0.15s;
}

.c-button--ghost:hover {
  color: var(--clr-fg);
  border-color: var(--clr-fg-muted);
}
.c-button--ghost:focus-visible {
  color: var(--clr-fg);
  border-color: var(--clr-brand);
  outline: none;
}

.c-button--ghost kbd {
  font-size: 0.7rem;
  padding: 0 0.25em;
  border: 1px solid var(--clr-border);
  border-radius: 3px;
}

/* ── collapsible sidebar sections ─────────────────────────────────── */

.c-docs-sidebar__group-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  cursor: pointer;
}

.c-docs-sidebar__group-header:hover > .c-docs-sidebar__group-title {
  color: var(--clr-fg);
}

.c-docs-sidebar__group-header > .c-docs-sidebar__group-title {
  flex: 1;
  min-width: 0;
}

.c-docs-sidebar__group-toggle {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 24px;
  height: 24px;
  padding: 0;
  background: none;
  border: none;
  color: var(--clr-fg-muted);
  font-size: 0.75rem;
  cursor: pointer;
  flex-shrink: 0;
  transition: color 0.15s;
}

.c-docs-sidebar__group-toggle:hover {
  color: var(--clr-fg);
}

.c-docs-sidebar__group--collapsed > .c-docs-sidebar__links {
  display: none;
}

/* ── breadcrumb ──────────────────────────────────────────────────── */

.c-header__breadcrumb {
  display: flex;
  align-items: center;
  gap: var(--sp-2, 0.5rem);
  font-size: 0.8rem;
  color: var(--clr-fg-muted);
  margin-left: var(--sp-4, 1rem);
}

.c-header__breadcrumb a {
  color: var(--clr-fg-muted);
  text-decoration: none;
}

.c-header__breadcrumb a:hover {
  color: var(--clr-fg);
}

.c-header__breadcrumb-sep {
  color: var(--clr-fg-muted);
  opacity: 0.5;
}

.c-header__breadcrumb-current {
  color: var(--clr-fg);
}

/* ── responsive: TOC rail collapse (<1200px) ─────────────────────── */

@media (max-width: 1199px) {
  .c-doc-layout__main--docs {
    grid-template-columns: 260px 1fr;
  }
  .c-docs-toc {
    display: none;
  }
}

/* ── responsive: sidebar collapse (<980px) ───────────────────────── */

@media (max-width: 979px) {
  .c-doc-layout__main--docs {
    grid-template-columns: 1fr;
  }
  .c-doc-layout__sidebar {
    display: none;
  }
  .c-header__hamburger {
    display: flex;
  }
  .c-doc-layout__content {
    padding: var(--sp-4, 1rem) var(--sp-4, 1rem);
  }
}

/* ── responsive: small screens ───────────────────────────────────── */

@media (max-width: 600px) {
  .c-docs-pager {
    grid-template-columns: 1fr;
  }
  .c-docs-pager__link--next {
    text-align: left;
  }
  .c-doc-layout__content {
    padding: var(--sp-3, 0.75rem);
  }
}

/* ── scrollbar — thin, subtle, docswerx-style ──────────────────────── */

.c-doc-layout__sidebar,
.c-docs-toc,
.c-mobile-nav__panel,
.c-docs-search__results {
  scrollbar-width: thin;
  scrollbar-color: var(--clr-border) transparent;
}

.c-doc-layout__sidebar::-webkit-scrollbar,
.c-docs-toc::-webkit-scrollbar,
.c-mobile-nav__panel::-webkit-scrollbar,
.c-docs-search__results::-webkit-scrollbar {
  width: 6px;
}

.c-doc-layout__sidebar::-webkit-scrollbar-track,
.c-docs-toc::-webkit-scrollbar-track,
.c-mobile-nav__panel::-webkit-scrollbar-track,
.c-docs-search__results::-webkit-scrollbar-track {
  background: transparent;
}

.c-doc-layout__sidebar::-webkit-scrollbar-thumb,
.c-docs-toc::-webkit-scrollbar-thumb,
.c-mobile-nav__panel::-webkit-scrollbar-thumb,
.c-docs-search__results::-webkit-scrollbar-thumb {
  background: var(--clr-border);
  border-radius: 3px;
}

.c-doc-layout__sidebar::-webkit-scrollbar-thumb:hover,
.c-docs-toc::-webkit-scrollbar-thumb:hover,
.c-mobile-nav__panel::-webkit-scrollbar-thumb:hover,
.c-docs-search__results::-webkit-scrollbar-thumb:hover {
  background: var(--clr-fg-muted);
}

/* ── reduced motion ──────────────────────────────────────────────── */

@media (prefers-reduced-motion: reduce) {
  .c-mobile-nav__panel,
  .c-mobile-nav__backdrop,
  .c-docs-search,
  .c-docs-sidebar__link,
  .c-docs-toc__link,
  .c-docs-pager__link,
  .c-docs-code-header__copy,
  .c-header__hamburger-line {
    transition: none;
  }
}
